model-versions
grupo de comando
Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.
Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.
O grupo de comandos model-versions
dentro do Databricks CLI contém comando para gerenciar versões de modelos no registro de modelo em Unity Catalog. Os modelos no Unity Catalog fornecem controle de acesso centralizado, auditoria, linhagem e descoberta de modelos do ML em todo o espaço de trabalho do Databricks. Consulte gerenciar ciclo de vida do modelo em Unity Catalog.
excluir versões do modelo databricks
Exclua uma versão do modelo registrado especificado. Todos os aliases atribuídos à versão do modelo também serão excluídos.
O chamador deve ser administrador da metastore ou proprietário do modelo principal registrado. No último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG
no catálogo principal e o privilégio USE_SCHEMA
no esquema principal.
databricks model-versions delete FULL_NAME VERSION [flags]
Argumentos
FULL_NAME
O nome de três níveis (totalmente qualificado) da versão do modelo
VERSION
O número inteiro da versão do modelo
Opções
Exemplos
O exemplo a seguir exclui a versão 1 de um modelo:
databricks model-versions delete main.my_schema.my_model 1
versões do modelo databricks obtêm
Obtenha uma versão modelo.
O chamador deve ser administrador da metastore ou proprietário (ou ter o privilégio EXECUTE
) do modelo registrado principal. No último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG
no catálogo principal e o privilégio USE_SCHEMA
no esquema principal.
databricks model-versions get FULL_NAME VERSION [flags]
Argumentos
FULL_NAME
O nome de três níveis (totalmente qualificado) da versão do modelo
VERSION
O número inteiro da versão do modelo
Opções
--include-aliases
Se deve incluir aliases associados à versão do modelo na resposta.
--include-browse
Se deve incluir versões de modelo na resposta para as quais o diretor só pode acessar metadados seletivos.
Exemplos
O exemplo a seguir obtém a versão 1 de um modelo:
databricks model-versions get main.my_schema.my_model 1
O exemplo a seguir obtém a versão 1 de um modelo com aliases incluídos:
databricks model-versions get main.my_schema.my_model 1 --include-aliases
versões do modelo databricks get-by-alias
Obtenha uma versão do modelo por alias.
O chamador deve ser administrador da metastore ou proprietário (ou ter o privilégio EXECUTE
) do modelo registrado. No último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG
no catálogo principal e o privilégio USE_SCHEMA
no esquema principal.
databricks model-versions get-by-alias FULL_NAME ALIAS [flags]
Argumentos
FULL_NAME
O nome de três níveis (totalmente qualificado) do modelo registrado
ALIAS
O nome do alias
Opções
--include-aliases
Se deve incluir aliases associados à versão do modelo na resposta.
Exemplos
O exemplo a seguir obtém uma versão do modelo por alias:
databricks model-versions get-by-alias main.my_schema.my_model production
O exemplo a seguir obtém uma versão do modelo por alias com aliases incluídos:
databricks model-versions get-by-alias main.my_schema.my_model production --include-aliases
lista de versões do modelo databricks
Liste as versões do modelo. Você pode listar as versões do modelo em um esquema específico ou listar todas as versões do modelo no metastore atual.
Os modelos retornados são filtrados com base nos privilégios do usuário chamador. Por exemplo, o administrador da metastore pode listar todas as versões do modelo. Um usuário comum precisa ser o proprietário ou ter o privilégio EXECUTE
no modelo principal registrado para receber as versões do modelo na resposta. No último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG
no catálogo principal e o privilégio USE_SCHEMA
no esquema principal.
Não há garantia de uma ordem específica dos elementos na resposta. Os elementos na resposta não conterão aliases ou tags.
databricks model-versions list FULL_NAME [flags]
Argumentos
FULL_NAME
O nome completo de três níveis do modelo registrado sob o qual listar as versões do modelo
Opções
--include-browse
Se deve incluir versões de modelo na resposta para as quais o diretor só pode acessar metadados seletivos.
--max-results int
Número máximo de versões do modelo a serem devolvidas.
--page-token string
Tokens de paginação opacos para avançar para a próxima página com base na consulta anterior.
Exemplos
O exemplo a seguir lista todas as versões do modelo de um modelo registrado:
databricks model-versions list main.my_schema.my_model
O exemplo a seguir lista as versões do modelo com paginação:
databricks model-versions list main.my_schema.my_model --max-results 10 --page-token abc123token
atualização de versões do modelo databricks
Atualize a versão especificada do modelo.
O chamador deve ser administrador da metastore ou proprietário do modelo principal registrado. No último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG
no catálogo principal e o privilégio USE_SCHEMA
no esquema principal.
Atualmente, somente o comentário da versão do modelo pode ser atualizado.
databricks model-versions update FULL_NAME VERSION [flags]
Argumentos
FULL_NAME
O nome de três níveis (totalmente qualificado) da versão do modelo
VERSION
O número inteiro da versão do modelo
Opções
--comment string
O comentário anexado à versão do modelo.
--json JSON
As strings JSON em linha ou o @path para o arquivo JSON com o corpo da solicitação
Exemplos
O exemplo a seguir atualiza um comentário sobre a versão do modelo:
databricks model-versions update main.my_schema.my_model 1 --comment "Updated model with improved accuracy"
O exemplo a seguir atualiza uma versão do modelo utilizando um arquivo JSON:
databricks model-versions update main.my_schema.my_model 1 --json @model-version-update.json
Bandeiras globais
--debug
Se deve habilitar o registro de depuração.
-h
ou --help
Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.
--log-file
string
Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.
--log-format
Formato
O tipo de formato do log, text
ou json
. O valor de default é text
.
--log-level
string
Uma string que representa o nível de formato do log. Se não for especificado, o nível de formato do log será desativado.
-o, --output
Tipo
O tipo de saída do comando, text
ou json
. O valor de default é text
.
-p, --profile
string
O nome do perfil no arquivo ~/.databrickscfg
a ser utilizado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil chamado DEFAULT
será usado.
--progress-format
Formato
O formato para exibir o progresso logs: default
, append
, inplace
ou json
-t, --target
string
Se aplicável, o destino do pacote a ser usado