Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Observação
Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-Visualização Pública.
O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.
O entity-tag-assignments grupo de comandos dentro da CLI Databricks contém comandos para criar, atualizar, eliminar e listar atribuições de etiquetas entre entidades do Catálogo Unity. As etiquetas são atributos que incluem chaves e valores opcionais que pode usar para organizar e categorizar entidades no Unity Catalog. Consulte Aplicar tags a objetos securizáveis do Unity Catalog.
databricks entidades-tags-atribuições criar
Crie uma atribuição de etiquetas para uma entidade do Unity Catalog.
Para adicionar etiquetas às entidades do Catálogo Unity, deve possuir a entidade ou possuir os seguintes privilégios:
- APLICAR TAG na entidade
- USE SCHEMA no esquema pai da entidade
- USE CATALOG no catálogo-mãe da entidade
Para adicionar uma etiqueta governada às entidades do Catálogo Unity, deve também ter a permissão ASSIGN ou MANAGE na política de etiquetas. Consulte Gerenciar permissões de política de tags.
databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]
Arguments
ENTITY_NAME
O nome totalmente qualificado da entidade a que a etiqueta é atribuída.
TAG_KEY
A chave da tag.
ENTITY_TYPE
O tipo de entidade a que a etiqueta é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
Opções
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação
--tag-value string
O valor da etiqueta.
Exemplos
O exemplo seguinte cria uma atribuição de etiquetas para uma tabela:
databricks entity-tag-assignments create my_catalog.my_schema.my_table environment tables --tag-value production
O exemplo seguinte cria uma atribuição de etiquetas usando JSON:
databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'
Databricks atribuições-etiquetas de entidade eliminar
Eliminar uma atribuição de etiquetas para uma entidade do Catálogo Unity pela sua chave.
Para eliminar etiquetas das entidades do Catálogo Unity, 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-mãe da entidade
Para eliminar uma etiqueta governada das entidades do Catálogo Unity, deve também ter a permissão ASSIGN ou MANAGE na política de etiquetas. Consulte Gerenciar permissões de política de tags.
databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Arguments
ENTITY_TYPE
O tipo de entidade a que a etiqueta é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
O nome totalmente qualificado da entidade a que a etiqueta é atribuída.
TAG_KEY
A chave da etiqueta para apagar.
Opções
Exemplos
O exemplo seguinte elimina uma atribuição de etiquetas 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 etiqueta para uma entidade do Catálogo Unity por chave de etiqueta.
databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Arguments
ENTITY_TYPE
O tipo de entidade a que a etiqueta é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
O nome totalmente qualificado da entidade a que a etiqueta é atribuída.
TAG_KEY
A chave da tag.
Opções
Exemplos
O exemplo seguinte recebe uma atribuição de etiquetas para uma tabela:
databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment
Lista de atribuições de etiquetas de entidade databricks
Lista as atribuições de etiquetas para uma entidade do Catálogo Unity.
Importante
A API é paginada por defeito, uma página pode conter zero resultados enquanto ainda fornece um next_page_token. Os clientes devem continuar a ler páginas até next_page_token ausente, o que é o único indício de que o final dos resultados foi alcançado.
databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]
Arguments
ENTITY_TYPE
O tipo de entidade a que a etiqueta é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
O nome totalmente qualificado da entidade a que a etiqueta é atribuída.
Opções
--max-results int
Número máximo de resultados a devolver.
--page-token string
Token para recuperar a próxima página de resultados.
Exemplos
O exemplo seguinte lista todas as atribuições de etiquetas para uma tabela:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table
O exemplo seguinte lista atribuições de etiquetas com paginação:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10
databricks atualização de atribuições de etiquetas de entidade
Atualize uma atribuição de etiquetas existente para uma entidade do Catálogo Unity.
Para atualizar etiquetas para entidades do Catálogo Unity, 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-mãe da entidade
Para atualizar uma etiqueta governada para entidades do Unity Catalog, deve também ter a permissão ASSIGN ou MANAGE na política de etiquetas. Consulte Gerenciar permissões de política de tags.
databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]
Arguments
ENTITY_TYPE
O tipo de entidade a que a etiqueta é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
O nome totalmente qualificado da entidade a que a etiqueta é atribuída.
TAG_KEY
A chave da tag.
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 em subcampos (por exemplo, author.given_name). A especificação de elementos em campos de sequência ou mapa não é permitida, pois apenas todo o campo de coleta pode ser especificado. Os nomes de campo devem corresponder exatamente aos nomes de campo de recurso.
Uma máscara de campo de asterisco (*) indica substituição completa. Recomenda-se 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 mudar no futuro.
Opções
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação
--tag-value string
O valor da etiqueta.
Exemplos
O exemplo seguinte atualiza uma atribuição de etiquetas para uma tabela:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --tag-value staging
O exemplo seguinte atualiza uma atribuição de etiquetas usando JSON:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'
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 usar 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