Grupo de comandos model-versions

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

Remover versões de modelos no 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 um administrador do metastore ou proprietário do modelo pai registrado. Para o último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai.

databricks model-versions delete FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    O nome totalmente qualificado em três níveis da versão do modelo

VERSION

    O número de versão inteiro do modelo

Opções

Sinalizadores globais

Examples

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

databricks model-versions delete main.my_schema.my_model 1

obter versões de modelo do databricks

Obtenha uma versão do modelo.

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

databricks model-versions get FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    O nome totalmente qualificado em três níveis da versão do modelo

VERSION

    O número de versão inteiro do modelo

Opções

--include-aliases

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

--include-browse

    Indica se deve incluir na resposta as versões de modelo para as quais a entidade de segurança tem acesso apenas a metadados seletivos.

Sinalizadores 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 model-versions get-by-alias

Obtenha uma versão do modelo pelo alias.

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

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

Arguments

FULL_NAME

    O nome totalmente qualificado em três níveis do modelo registrado

ALIAS

    O nome do pseudônimo (alias)

Opções

--include-aliases

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

Sinalizadores globais

Examples

O exemplo a seguir obtém uma versão do modelo usando 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 modelo. 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 de chamada. Por exemplo, o administrador do metastore é capaz de listar todas as versões do modelo. Para receber na resposta as versões do modelo, um usuário regular precisa ser o proprietário ou ter o privilégio EXECUTE no modelo registrado pai. Para o último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA 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 nenhuma apelidos ou etiquetas.

databricks model-versions list FULL_NAME [flags]

Arguments

FULL_NAME

    O nome completo de três níveis do modelo registrado no qual listar versões de modelo

Opções

--include-browse

    Indica se deve incluir na resposta as versões de modelo para as quais a entidade de segurança tem acesso apenas a metadados seletivos.

--max-results int

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

--page-token string

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

Sinalizadores 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 do modelo do Databricks

Atualize a versão do modelo especificada.

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

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

databricks model-versions update FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    O nome totalmente qualificado em três níveis da versão do modelo

VERSION

    O número de versão inteiro do modelo

Opções

--comment string

    O comentário anexado à versão do modelo.

--json JSON

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

Sinalizadores 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 de modelo usando um arquivo JSON:

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

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

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

--log-file corda

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

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    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á desabilitado.

-o, --output tipo

    O tipo de saída de comando, text ou json. O valor padrão é text.

-p, --profile corda

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

--progress-format formato

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

-t, --target corda

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