Pular para o conteúdo principal

registered-models 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 registered-models dentro do Databricks CLI contém comandos para gerenciar modelos no registro de modelos em Unity Catalog. Os modelos registrados fornecem controle de acesso centralizado, auditoria, linhagem e descoberta de modelos ML em toda a área de trabalho do Databricks. Consulte gerenciar ciclo de vida do modelo em Unity Catalog.

databricks registred-models create

Crie um novo modelo registrado em Unity Catalog.

O armazenamento de arquivos para versões do modelo no modelo registrado estará localizado no local default, especificado pelo esquema pai, pelo catálogo pai ou pelo Metastore.

Para que a criação do modelo registrado seja bem-sucedida, o usuário deve satisfazer as seguintes condições:

  • O chamador deve ser administrador da metastore, proprietário do catálogo e do esquema principal ou ter o privilégio USE_CATALOG no catálogo principal e o privilégio USE_SCHEMA no esquema principal.
  • O chamador deve ter o privilégio CREATE MODEL ou CREATE FUNCTION no esquema principal.
databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]

Argumentos

CATALOG_NAME

O nome do catálogo em que o esquema e o modelo registrado residem.

SCHEMA_NAME

O nome do esquema em que o modelo registrado reside.

NAME

O nome do modelo registrado.

Opções

--comment string

O comentário anexado ao modelo registrado.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--storage-location string

O local de armazenamento na nuvem sob o qual os arquivos de dados da versão do modelo são armazenados.

Bandeiras globais

Exemplos

O exemplo a seguir cria um modelo registrado no catálogo e no esquema especificados:

Bash
databricks registered-models create main my_schema my_model

O exemplo a seguir cria um modelo registrado com um comentário:

Bash
databricks registered-models create main my_schema my_model --comment "My model description"

deletar modelos registrados do databricks

Exclua um modelo registrado e todas as suas versões do modelo do catálogo principal e do esquema especificados.

O chamador deve ser administrador da metastore ou proprietário 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 registered-models delete FULL_NAME [flags]

Argumentos

FULL_NAME

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

Opções

Bandeiras globais

Exemplos

O exemplo a seguir exclui um modelo registrado:

Bash
databricks registered-models delete main.my_schema.my_model

apelido de exclusão de modelos registrados do databricks

Exclua um alias de modelo registrado.

O chamador deve ser administrador da metastore ou proprietário 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 registered-models delete-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

Bandeiras globais

Exemplos

O exemplo a seguir exclui um alias de modelo registrado:

Bash
databricks registered-models delete-alias main.my_schema.my_model production

modelos registrados do databricks get

Obtenha um modelo registrado.

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 registered-models get FULL_NAME [flags]

Argumentos

FULL_NAME

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

Opções

--include-aliases

Se deve incluir aliases de modelo registrados na resposta.

--include-browse

Se deve incluir modelos registrados na resposta para os quais o diretor só pode acessar metadados seletivos.

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações sobre um modelo registrado:

Bash
databricks registered-models get main.my_schema.my_model

O exemplo a seguir obtém informações sobre um modelo registrado, incluindo aliases:

Bash
databricks registered-models get main.my_schema.my_model --include-aliases

lista de modelos registrados do databricks

Liste os modelos registrados. Você pode listar os modelos registrados em um esquema específico ou listar todos os modelos registrados 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 todos os modelos registrados. Um usuário comum precisa ser o proprietário ou ter o privilégio EXECUTE no modelo registrado para receber os modelos registrados 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.

databricks registered-models list [flags]

Opções

--catalog-name string

O identificador do catálogo sob o qual listar os modelos registrados.

--include-browse

Se deve incluir modelos registrados na resposta para os quais o diretor só pode acessar metadados seletivos.

--max-results int

Número máximo de modelos cadastrados para devolução.

--page-token string

Tokens opacos a serem enviados para a próxima página de resultados (paginação).

--schema-name string

O identificador do esquema sob o qual listar os modelos registrados.

Bandeiras globais

Exemplos

O exemplo a seguir lista todos os modelos registrados no metastore atual:

Bash
databricks registered-models list

O exemplo a seguir lista os modelos registrados em um catálogo específico:

Bash
databricks registered-models list --catalog-name main

O exemplo a seguir lista os modelos registrados em um esquema específico:

Bash
databricks registered-models list --catalog-name main --schema-name my_schema

alias do conjunto de modelos registrados do databricks

Defina um alias no modelo registrado especificado.

O chamador deve ser administrador da metastore ou proprietário 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 registered-models set-alias FULL_NAME ALIAS VERSION_NUM [flags]

Argumentos

FULL_NAME

Nome completo do modelo registrado.

ALIAS

O nome do alias.

VERSION_NUM

O número da versão do modelo para a qual o alias aponta.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Exemplos

O exemplo a seguir define um alias em um modelo registrado:

Bash
databricks registered-models set-alias main.my_schema.my_model production 1

atualização de modelos registrados do databricks

Atualize o modelo registrado especificado.

O chamador deve ser administrador da metastore ou proprietário 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.

Atualmente, somente o nome, o proprietário ou o comentário do modelo registrado podem ser atualizados.

databricks registered-models update FULL_NAME [flags]

Argumentos

FULL_NAME

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

Opções

--comment string

O comentário anexado ao modelo registrado.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

``--novo-nome strings`**

Novo nome para o modelo registrado.

--owner string

O identificador do usuário que possui o modelo registrado.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza o comentário de um modelo registrado:

Bash
databricks registered-models update main.my_schema.my_model --comment "Updated model description"

O exemplo a seguir atualiza o nome de um modelo registrado:

Bash
databricks registered-models update main.my_schema.my_model --new-name my_new_model

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