Grupo de comandos registered-models

O grupo de registered-models dentro da CLI do Databricks contém comandos para gerenciar modelos no Model Registry do Unity Catalog. Os modelos registrados oferecem controle de acesso centralizado, auditoria, linhagem e descoberta de modelos de ML em vários workspaces do Databricks. Consulte Gerenciar o ciclo de vida do modelo no Catálogo Unity.

criar modelos registrados no Databricks

Crie um novo modelo registrado no Catálogo do Unity.

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

Para que a criação do modelo registrado tenha êxito, o usuário deve atender às seguintes condições:

• O chamador deve ser um administrador do metastore, ser o proprietário do catálogo pai e do esquema, ou ter o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai.
• É necessário que o chamador tenha o privilégio CREATE MODEL ou o privilégio CREATE FUNCTION no esquema pai.

databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]

Arguments

CATALOG_NAME

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

SCHEMA_NAME

    O nome do esquema no qual o modelo registrado reside.

NAME

    O nome do modelo registrado.

Opções

--comment string

    O comentário anexado ao modelo registrado.

--json JSON

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

--storage-location string

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

Sinalizadores globais

Examples

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"

exclusão de modelos registrados do databricks

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

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

Arguments

FULL_NAME

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

Opções

Sinalizadores globais

Examples

O exemplo a seguir exclui um modelo registrado:

databricks registered-models delete main.my_schema.my_model

databricks registered-models delete-alias

Exclua um alias de modelo registrado.

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

Arguments

FULL_NAME

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

ALIAS

    O nome do alias.

Opções

Sinalizadores globais

Examples

O exemplo a seguir exclui um alias de modelo registrado:

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

O comando `databricks registered-models get` é usado para obter modelos registrados no Databricks.

Obtenha um modelo registrado.

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

Arguments

FULL_NAME

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

Opções

--include-aliases

    Se deve incluir nomes alternativos de modelos registrados na resposta.

--include-browse

    Indica se deve incluir na resposta os modelos registrados para os quais a entidade de segurança tem acesso apenas a metadados seletivos.

Sinalizadores globais

Examples

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 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 de chamada. Por exemplo, o administrador do metastore pode listar todos os modelos registrados. Um usuário regular precisa ser o proprietário ou ter o privilégio EXECUTE no modelo registrado para obter os modelos registrados na resposta. 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.

databricks registered-models list [flags]

Opções

--catalog-name string

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

--include-browse

    Indica se deve incluir na resposta os modelos registrados para os quais a entidade de segurança tem acesso apenas a metadados seletivos.

--max-results int

    Número máximo de modelos registrados a serem retornados.

--page-token string

    Token opaco para enviar à próxima página de resultados (paginação).

--schema-name string

    O identificador do esquema no qual listar modelos registrados.

Sinalizadores globais

Examples

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

databricks registered-models list

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

databricks registered-models list --catalog-name main

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

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

databricks modelos-registrados definir-alias

Defina um alias no modelo registrado especificado.

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

Arguments

FULL_NAME

    Nome completo do modelo registrado.

ALIAS

    O nome do alias.

VERSION_NUM

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

Opções

--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 define um alias em um modelo registrado:

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

Atualização de modelos registrados no Databricks

Atualize o modelo registrado especificado.

O chamador deve ser um administrador metastore ou um proprietário do modelo 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 nome, o proprietário ou o comentário do modelo registrado podem ser atualizados.

databricks registered-models update FULL_NAME [flags]

Arguments

FULL_NAME

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

Opções

--comment string

    O comentário anexado ao modelo registrado.

--json JSON

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

''--cadeia de caracteres de novo nome'**

    Novo nome para o modelo registrado.

--owner string

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

Sinalizadores globais

Examples

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

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