registered-models
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 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égioUSE_SCHEMA
no esquema principal. - O chamador deve ter o privilégio
CREATE MODEL
ouCREATE 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.
Exemplos
O exemplo a seguir cria um modelo registrado no catálogo e no esquema especificados:
databricks registered-models create main my_schema my_model
O exemplo a seguir cria um modelo registrado com um comentário:
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
Exemplos
O exemplo a seguir exclui um modelo registrado:
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
Exemplos
O exemplo a seguir exclui um alias de modelo registrado:
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.
Exemplos
O exemplo a seguir obtém informações sobre um modelo registrado:
databricks registered-models get main.my_schema.my_model
O exemplo a seguir obtém informações sobre um modelo registrado, incluindo aliases:
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.
Exemplos
O exemplo a seguir lista todos os modelos registrados no metastore atual:
databricks registered-models list
O exemplo a seguir lista os modelos registrados em um catálogo específico:
databricks registered-models list --catalog-name main
O exemplo a seguir lista os modelos registrados em um esquema específico:
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.
Exemplos
O exemplo a seguir define um alias em um modelo registrado:
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.
Exemplos
O exemplo a seguir atualiza o comentário de um modelo registrado:
databricks registered-models update main.my_schema.my_model --comment "Updated model description"
O exemplo a seguir atualiza o nome de um modelo registrado:
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