Pular para o conteúdo principal

model-versions grupo de comando

nota

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

Bandeiras globais

Exemplos

O exemplo a seguir exclui a versão 1 de um modelo:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir obtém a versão 1 de um modelo:

Bash
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:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir obtém uma versão do modelo por alias:

Bash
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:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir lista todas as versões do modelo de um modelo registrado:

Bash
databricks model-versions list main.my_schema.my_model

O exemplo a seguir lista as versões do modelo com paginação:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir atualiza um comentário sobre a versão do modelo:

Bash
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:

Bash
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