Grupo de comandos entity-tag-assignments

O entity-tag-assignments grupo de comandos dentro da CLI do Databricks contém comandos para criar, atualizar, excluir e listar atribuições de marca entre entidades do Catálogo do Unity. Marcas são atributos que incluem chaves e valores opcionais que você pode usar para organizar e categorizar entidades no Catálogo do Unity. Veja Aplicar etiquetas a objetos securitizáveis do Unity Catalog.

databricks entity-tag-assignments create

Crie uma atribuição de marca para uma entidade do Catálogo do Unity.

Para adicionar marcas a entidades do Catálogo do Unity, você deve ser proprietário da entidade ou ter os seguintes privilégios:

• APLICAR TAG na entidade
• USE SCHEMA no esquema pai da entidade
• USE CATALOG no catálogo pai da entidade

Para adicionar uma marca governada às entidades do Catálogo do Unity, você também deve ter a permissão ASSIGN ou MANAGE na política de marca. Consulte Gerenciar permissões de política de etiqueta.

databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]

Argumentos

ENTITY_NAME

    O nome totalmente qualificado da entidade à qual a marca é atribuída.

TAG_KEY

    A chave da marca.

ENTITY_TYPE

    O tipo da entidade à qual a marca é atribuída. Os valores permitidos são: catalogs, , schemas, tables, columns, volumes.

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

--tag-value string

    O valor da etiqueta.

Sinalizadores globais

Exemplos

O exemplo a seguir cria uma atribuição de marca para uma tabela:

databricks entity-tag-assignments create my_catalog.my_schema.my_table environment tables --tag-value production

O exemplo a seguir cria uma atribuição de marca usando JSON:

databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'

databricks entity-tag-assignments delete

Exclua uma atribuição de marca para uma entidade do Catálogo do Unity por sua chave.

Para excluir marcas de entidades do Catálogo do Unity, você deve ser proprietário da entidade ou ter os seguintes privilégios:

• APLICAR TAG na entidade
• USE_SCHEMA no esquema pai da entidade
• USE_CATALOG no catálogo pai da entidade

Para excluir uma marca governada de entidades do Catálogo do Unity, você também deve ter a permissão ASSIGN ou MANAGE na política de marca. Consulte Gerenciar permissões de política de etiqueta.

databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]

Argumentos

ENTITY_TYPE

    O tipo da entidade à qual a marca é atribuída. Os valores permitidos são: catalogs, , schemas, tables, columns, volumes.

ENTITY_NAME

    O nome totalmente qualificado da entidade à qual a marca é atribuída.

TAG_KEY

    A chave da marca a ser excluída.

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir exclui uma atribuição de marca de uma tabela:

databricks entity-tag-assignments delete tables my_catalog.my_schema.my_table environment

databricks entity-tag-assignments get

Obtenha uma atribuição de marca para uma entidade do Catálogo do Unity por chave de marca.

databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]

Argumentos

ENTITY_TYPE

    O tipo da entidade à qual a marca é atribuída. Os valores permitidos são: catalogs, , schemas, tables, columns, volumes.

ENTITY_NAME

    O nome totalmente qualificado da entidade à qual a marca é atribuída.

TAG_KEY

    A chave da marca.

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir obtém uma atribuição de marca para uma tabela:

databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment

lista databricks entity-tag-assignments

Listar atribuições de marca para uma entidade do Catálogo do Unity.

databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]

Argumentos

ENTITY_TYPE

    O tipo da entidade à qual a marca é atribuída. Os valores permitidos são: catalogs, , schemas, tables, columns, volumes.

ENTITY_NAME

    O nome totalmente qualificado da entidade à qual a marca é atribuída.

Opções

--max-results int

    Número máximo de resultados a serem retornados.

--page-token string

    Token para recuperar a próxima página de resultados.

Sinalizadores globais

Exemplos

O exemplo a seguir lista todas as atribuições de marca para uma tabela:

databricks entity-tag-assignments list tables my_catalog.my_schema.my_table

O exemplo a seguir lista atribuições de marca com paginação:

databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10

databricks entity-tag-assignments update

Atualize uma atribuição de marca existente para uma entidade do Catálogo do Unity.

Para atualizar marcas para entidades do Catálogo do Unity, você deve ser proprietário da entidade ou ter os seguintes privilégios:

• APLICAR TAG na entidade
• USE SCHEMA no esquema pai da entidade
• USE CATALOG no catálogo pai da entidade

Para atualizar uma marca governada para entidades do Catálogo do Unity, você também deve ter a permissão ASSIGN ou MANAGE na política de marca. Consulte Gerenciar permissões de política de etiqueta.

databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]

Argumentos

ENTITY_TYPE

    O tipo da entidade à qual a marca é atribuída. Os valores permitidos são: catalogs, , schemas, tables, columns, volumes.

ENTITY_NAME

    O nome totalmente qualificado da entidade à qual a marca é atribuída.

TAG_KEY

    A chave da marca.

UPDATE_MASK

    A máscara de campo deve ser uma única cadeia de caracteres, com vários campos separados por vírgulas (sem espaços). O caminho do campo é relativo ao objeto de recurso, usando um ponto (.) para navegar por sub-campos (por exemplo, author.given_name). A especificação de elementos em campos de sequência ou mapa não é permitida, pois somente todo o campo de coleção pode ser especificado. Os nomes de campo devem corresponder exatamente aos nomes de campo de recurso.

    Uma máscara de campo de asterisco (*) indica a substituição completa. É recomendável sempre listar explicitamente os campos que estão sendo atualizados e evitar o uso de curingas, pois isso pode levar a resultados não intencionais se a API for alterada no futuro.

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

--tag-value string

    O valor da etiqueta.

Sinalizadores globais

Exemplos

O exemplo a seguir atualiza uma atribuição de marca para uma tabela:

databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --tag-value staging

O exemplo a seguir atualiza uma atribuição de marca usando JSON:

databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'

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 onde serão gravados os 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 do comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg, que deverá ser usado para 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