Aplicar tags a objetos protegíveis do Unity Catalog

Artigo
05/17/2024

Este artigo mostra como aplicar tags no Unity Catalog.

As tags são atributos que contêm chaves e valores opcionais que você pode aplicar a objetos protegíveis no Unity Catalog. A marcação é útil para organizar e categorizar objetos protegíveis em um metastore. O uso de tags também simplifica a pesquisa e a descoberta de tabelas e exibições usando a funcionalidade de pesquisa do espaço de trabalho.

Objetos protegíveis suportados

Atualmente, a marcação de objeto protegível é suportada em catálogos, esquemas, tabelas, colunas de tabela, volumes, exibições e modelos registrados. Para obter mais informações sobre objetos protegíveis, consulte Objetos protegíveis no Unity Catalog.

Requisitos

Para adicionar tags a objetos protegíveis do Unity Catalog, você deve ter o APPLY TAG privilégio no objeto, bem como o USE SCHEMA privilégio no esquema pai do objeto e o USE CATALOG privilégio no catálogo pai do objeto.

Restrições

A seguir está uma lista de restrições de tag:

Você pode atribuir um máximo de 20 tags a um único objeto protegível.
O comprimento máximo de uma chave de tag é de 255 caracteres.
O comprimento máximo de um valor de tag é de 1000 caracteres.
Caracteres especiais não podem ser usados em nomes de tags.
A pesquisa de tags usando a interface do usuário de pesquisa do espaço de trabalho é suportada apenas para tabelas, exibições e colunas de tabela.
A pesquisa de tags requer correspondência exata de termos.

Gerir etiquetas no Explorador de Catálogos

Para gerenciar marcas de objeto protegíveis usando a interface do usuário do Catalog Explorer, você deve ter pelo menos o BROWSE privilégio no objeto.

Clique em Catálogo na barra lateral.
Selecione um objeto protegível para exibir as informações da tag.
Clique em Adicionar/Editar tags para gerenciar tags para o objeto protegível atual. Você pode adicionar e remover várias tags simultaneamente no modal de gerenciamento de tags.

Para adicionar ou editar etiquetas de coluna da tabela, clique no ícone Adicionar etiqueta.

Recuperar informações de tags em tabelas de esquema de informações

Cada catálogo criado no Unity Catalog inclui um INFORMATION_SCHEMAarquivo . Este esquema inclui tabelas que descrevem os objetos conhecidos no catálogo do esquema. Você deve ter os privilégios apropriados para exibir as informações do esquema.

Você pode consultar o seguinte para recuperar informações da tag:

Para obter mais informações, consulte Esquema de informações.

Gerenciar tags usando comandos SQL

Nota

Esse recurso está disponível somente nas versões 13.3 e superiores do Databricks Runtime.

Você pode usar comandos SQL para marcar catálogos, esquemas, tabelas (exibições, exibições materializadas, tabelas de streaming), volumes e colunas de tabela. Por exemplo, você pode usar as SET TAGS cláusulas e UNSET TAGS com o ALTER TABLE comando para gerenciar tags em uma tabela. Consulte instruções DDL para obter uma lista de comandos DDL (Data Definition Language) disponíveis e sua sintaxe.

Utilizar etiquetas para procurar tabelas

Você pode usar a barra de pesquisa do espaço de trabalho do Azure Databricks para pesquisar tabelas, exibições e colunas de tabela usando chaves de tag e valores de tag. Você pode usar tags de tabela e tags de coluna de tabela. Não é possível usar tags para pesquisar outros objetos marcados, como catálogos, esquemas ou volumes.

Para obter detalhes, consulte Usar tags para pesquisar tabelas.

Share via