entity-tag-assignments grupo de comandos
Esta informação aplica-se às versões 0.205 e acima Databricks CLI . A CLI do Databricks está em versão prévia pública.
O uso CLI Databricks está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer fornecimento de Dados de Uso.
O grupo de comandos entity-tag-assignments dentro da CLIDatabricks contém comandos para criar, atualizar, excluir e listar atribuições tag em entidades Unity Catalog . As tags são atributos que incluem valores-chave e opcionais que você pode usar para organizar e categorizar entidades no Unity Catalog. Consulte Aplicar tags a objetos protegíveis Unity Catalog.
criar atribuiçõestagde entidade do Databricks
Crie uma atribuição tag para uma entidade Unity Catalog .
Para adicionar tags a entidades Unity Catalog , você precisa ser o proprietário da entidade ou ter os seguintes privilégios:
- Etiqueta APPLY na entidade
- USE SCHEMA no esquema pai da entidade
- USE CATALOG no catálogo pai da entidade
Para adicionar uma tag controlada às entidades Unity Catalog , você também precisa ter a permissão ASSIGN ou gerenciar na política tag . Consulte gerenciar permissões de política tag.
databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]
Argumentos
ENTITY_NAME
O nome completo da entidade à qual a tag está atribuída.
TAG_KEY
A key da tag.
ENTITY_TYPE
O tipo da entidade à qual a tag é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
Opções
--json JSON
As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.
--tag-value string
O valor da tag.
Exemplos
O exemplo a seguir cria uma atribuição de tag 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 tag usando JSON:
databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'
excluir atribuiçõestagde entidade do Databricks
Exclua a atribuição de uma tag para uma entidade Unity Catalog pela sua key.
Para excluir tags de entidades do Unity Catalog , você precisa ser o proprietário da entidade ou ter os seguintes privilégios:
- Etiqueta APPLY na entidade
- USE_SCHEMA no esquema pai da entidade
- USE_CATALOG no catálogo pai da entidade
Para excluir uma tag gerenciada das entidades Unity Catalog , você também precisa ter a permissão ASSIGN ou gerenciar na política tag . Consulte gerenciar permissões de política tag.
databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Argumentos
ENTITY_TYPE
O tipo da entidade à qual a tag é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
O nome completo da entidade à qual a tag está atribuída.
TAG_KEY
A key da tag a ser excluída.
Opções
Exemplos
O exemplo a seguir exclui uma atribuição de tag de uma tabela:
databricks entity-tag-assignments delete tables my_catalog.my_schema.my_table environment
atribuiçõestagde entidade do Databricks get
Obtenha a atribuição de uma tag para uma entidade Unity Catalog pela key tag .
databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Argumentos
ENTITY_TYPE
O tipo da entidade à qual a tag é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
O nome completo da entidade à qual a tag está atribuída.
TAG_KEY
A key da tag.
Opções
Exemplos
O exemplo a seguir obtém uma atribuição de tag para uma tabela:
databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment
Lista de atribuiçõestagde entidade do Databricks
Listar atribuições tag para uma entidade Unity Catalog .
A API é paginada por default ; uma página pode não conter resultados, mas ainda assim fornecer um next_page_token. Os clientes devem continuar lendo as páginas até que next_page_token esteja ausente, o que é a única indicação de que o final dos resultados foi alcançado.
databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]
Argumentos
ENTITY_TYPE
O tipo da entidade à qual a tag é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
O nome completo da entidade à qual a tag está atribuída.
Opções
--max-results int
Número máximo de resultados a serem retornados.
--page-token string
Tokens para recuperar a próxima página de resultados.
Exemplos
O exemplo a seguir lista todas as atribuições tag para uma tabela:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table
O exemplo a seguir lista as atribuições tag com paginação:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10
Atualização de atribuiçõestagde entidade do Databricks
Atualizar uma atribuição tag existente para uma entidade Unity Catalog .
Para atualizar tags das entidades Unity Catalog , você precisa ser o proprietário da entidade ou ter os seguintes privilégios:
- Etiqueta APPLY na entidade
- USE SCHEMA no esquema pai da entidade
- USE CATALOG no catálogo pai da entidade
Para atualizar uma tag gerenciada para entidades Unity Catalog , você também precisa ter a permissão ASSIGN ou gerenciar na política tag . Consulte gerenciar permissões de política tag.
databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]
Argumentos
ENTITY_TYPE
O tipo da entidade à qual a tag é atribuída. Os valores permitidos são: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
O nome completo da entidade à qual a tag está atribuída.
TAG_KEY
A key da tag.
UPDATE_MASK
A máscara de campo deve ser uma única string, com múltiplos campos separados por vírgulas (sem espaços). O caminho do campo é relativo ao objeto de recurso, usando um ponto (.) para navegar pelos subcampos (por exemplo, author.given_name). A especificação de elementos em campos de sequência ou mapa não é permitida, pois somente o campo de coleção inteiro pode ser especificado. Os nomes dos campos devem corresponder exatamente aos nomes dos campos de recurso.
Um asterisco (*) no campo indica 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 inesperados caso a API seja alterada no futuro.
Opções
--json JSON
As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.
--tag-value string
O valor da tag.
Exemplos
O exemplo a seguir atualiza a atribuição de uma tag 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 tag usando JSON:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'
Bandeiras globais
--debug
Ativar ou não o registro de depuração.
-h ou --help
Exibir ajuda para a CLI Databricks , o grupo de comandos relacionado ou o comando específico.
--log-file string
Uma sequência de caracteres representando o arquivo no qual logs de saída serão gravados. Se essa opção não for especificada, o default é gravar logs de saída em stderr.
--log-format Formato
O tipo de formato de log, text ou json. O valor default é text.
--log-level string
Uma sequência de caracteres representando o nível de formato log . Caso não seja especificado, o nível de formato log será desativado.
-o, --output Tipo
O tipo de saída do comando, text ou json. O valor default é text.
-p, --profile string
O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se este sinalizador não for especificado, então, se existir, o perfil denominado 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 pacote de destino a ser usado.