registered-models grupo de comando

O registered-models grupo de comandos dentro da CLI do Databricks contém comandos para gerenciar modelos no registro do modelo no Unity Catalog. Os modelos registrados 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 criar modelos registados

Crie um novo modelo registrado no Catálogo 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 seja bem-sucedida, o usuário deve satisfazer as seguintes condições:

• O chamador deve ser um administrador de metastore, ou 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.
• O chamador deve ter o privilégio CREATE MODEL ou CREATE FUNCTION no esquema pai.

databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]

Arguments

CATALOG_NAME

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

SCHEMA_NAME

    O nome do esquema onde reside o modelo registrado.

NAME

    O nome do modelo registado.

Opções

--comment string

    O comentário anexado ao modelo registado.

--json JSON

    A cadeia de caracteres JSON embutida ou o @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

Examples

O exemplo a seguir cria um modelo registrado no catálogo e 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"

databricks modelos registados excluir

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

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

Arguments

FULL_NAME

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

Opções

Bandeiras globais

Examples

O exemplo a seguir exclui um modelo registrado:

databricks registered-models delete main.my_schema.my_model

Databricks modelos registados apagar alias

Exclua um alias de modelo registrado.

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

Bandeiras globais

Examples

O exemplo a seguir exclui um alias de modelo registrado:

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

databricks registered-models obter

Obtenha um modelo registado.

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

Arguments

FULL_NAME

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

Opções

--include-aliases

    Se os aliases de modelo registrados devem ser incluídos na resposta.

--include-browse

    Se deve incluir ou não modelos registados na resposta para a qual o principal apenas pode aceder a metadados seletivos.

Bandeiras 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

Listar 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 chamador. Por exemplo, o administrador da metastore pode listar todos os modelos registrados. Um usuário regular precisa ser o proprietário ou ter o EXECUTE privilégio no modelo registrado para receber os modelos registrados 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.

databricks registered-models list [flags]

Opções

--catalog-name string

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

--include-browse

    Se deve incluir ou não modelos registados na resposta para a qual o principal apenas pode aceder a metadados seletivos.

--max-results int

    Número máximo de modelos registados a devolver.

--page-token string

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

--schema-name string

    O identificador do esquema sob o qual listar modelos registrados.

Bandeiras 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 set-alias

Defina um alias no modelo registrado especificado.

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

Arguments

FULL_NAME

    Nome completo do modelo registado.

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 embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras 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 registados do Databricks

Atualize o modelo registrado especificado.

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

Atualmente, apenas 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 de três níveis (totalmente qualificado) do modelo registado.

Opções

--comment string

    O comentário anexado ao modelo registado.

--json JSON

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

''--new-name string'**

    Novo nome para o modelo registado.

--owner string

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

Bandeiras 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

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 ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

    O tipo de formato de log, text 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 arquivo ~/.databrickscfg 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