Partilhar via


model-versions grupo de comando

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-Visualização Pública.

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.

O model-versions grupo de comandos dentro da CLI do Databricks contém comandos para gerenciar versões de modelo no registro do modelo no Unity Catalog. Os modelos no Unity Catalog fornecem controle de acesso centralizado, auditoria, linhagem e descoberta de modelos de ML em espaços de trabalho Databricks. Consulte Gerenciar o ciclo de vida do modelo no Catálogo Unity.

Databricks modelo-versões excluir

Exclua uma versão do modelo registado especificado. Todos os aliases atribuídos à versão do modelo também serão excluídos.

O chamador deve ser um administrador de metastore ou o proprietário do modelo pai registrado. Para o último caso, o chamador também deve ser o proprietário ou ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio no esquema pai.

databricks model-versions delete FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    O nome qualificado completo de três níveis da versão do modelo

VERSION

    O número inteiro da versão do modelo

Opções

Bandeiras globais

Examples

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

databricks model-versions delete main.my_schema.my_model 1

Databricks obter versões de modelo

Obtenha uma versão do modelo.

O chamador deve ser um administrador de metastore ou ser proprietário (ou ter o privilégio EXECUTE sobre) o modelo registado pai. Para o último caso, o chamador também deve ser o proprietário ou ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio no esquema pai.

databricks model-versions get FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    O nome qualificado completo de três níveis 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 as versões do modelo devem ser incluídas na resposta para as quais o principal só pode acessar metadados seletivos.

Bandeiras globais

Examples

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

Databricks com a função `model-versions get-by-alias`

Obtenha uma versão do modelo por apelido.

O chamador deve ser um administrador de metastore ou um proprietário (ou ter o EXECUTE privilégio) do modelo registrado. Para o último caso, o chamador também deve ser o proprietário ou ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio no esquema pai.

databricks model-versions get-by-alias FULL_NAME ALIAS [flags]

Arguments

FULL_NAME

    O nome de três níveis (totalmente qualificado) do modelo registado

ALIAS

    O nome do alias

Opções

--include-aliases

    Se deve incluir aliases associados à versão do modelo na resposta.

Bandeiras globais

Examples

O exemplo a seguir obtém uma versão do modelo através de um alias:

databricks model-versions get-by-alias main.my_schema.my_model production

O exemplo a seguir obtém uma versão de 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 de modelo do Databricks

Listar versões de modelos. Você pode listar versões de modelo em um esquema específico ou listar todas as versões de modelo no metastore atual.

Os modelos retornados são filtrados com base nos privilégios do usuário chamador. Por exemplo, o administrador do metastore pode listar todas as versões do modelo. Um utilizador regular precisa ser o proprietário ou ter o EXECUTE privilégio no modelo registado pai para receber as versões do modelo na resposta. Para o último caso, o chamador também deve ser o proprietário ou ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio no esquema pai.

Não há garantia de uma ordenação específica dos elementos na resposta. Os elementos na resposta não conterão aliases ou tags.

databricks model-versions list FULL_NAME [flags]

Arguments

FULL_NAME

    O nome completo de três níveis do modelo registado sob o qual se devem listar as versões do modelo

Opções

--include-browse

    Se as versões do modelo devem ser incluídas na resposta para as quais o principal só pode acessar metadados seletivos.

--max-results int

    Número máximo de versões do modelo a serem retornadas.

--page-token string

    Token de paginação opaco para ir para a próxima página com base na consulta anterior.

Bandeiras globais

Examples

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

databricks model-versions list main.my_schema.my_model

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

databricks model-versions list main.my_schema.my_model --max-results 10 --page-token abc123token

Atualização de versões de modelo do Databricks

Atualize a versão do modelo especificado.

O chamador deve ser um administrador de metastore ou o proprietário do modelo pai registrado. Para o último caso, o chamador também deve ser o proprietário ou ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio no esquema pai.

Atualmente, apenas o comentário da versão do modelo pode ser atualizado.

databricks model-versions update FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    O nome qualificado completo de três níveis 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

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

Bandeiras globais

Examples

O exemplo a seguir atualiza um comentário de 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 usando um arquivo JSON:

databricks model-versions update main.my_schema.my_model 1 --json @model-version-update.json

Bandeiras globais

--debug

  Se o log de depuração deve ser habilitado.

-h ou --help

    Exiba a ajuda para a CLI do Databricks ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

    Uma cadeia de caracteres que representa o arquivo para gravar logs de saída. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

    O tipo text de formato de log ou json. O valor predefinido é text.

--log-level string

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desativado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor predefinido é text.

-p, --profile string

    O nome do perfil no ~/.databrickscfg arquivo a ser usado para executar o comando. Se esse sinalizador não for especificado, se ele existir, o perfil nomeado DEFAULT será usado.

--progress-format Formato

    O formato para exibir logs de progresso: default, append, inplace, ou json

-t, --target string

    Se aplicável, o destino do pacote a ser usado