Aplicar tags a objetos protegíveis do Unity Catalog

Este artigo mostra como aplicar tags a objetos protegíveis do Unity Catalog.

As tags são atributos que incluem chaves e valores opcionais que você pode usar para organizar e categorizar objetos protegíveis no Unity Catalog. 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, modelos registrados e versões de modelos. 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 possuir o objeto ou ter todos os seguintes privilégios:

• APPLY TAG sobre o objeto
• USE SCHEMA no esquema pai do objeto
• USE CATALOG 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.

Adicionar e atualizar tags usando o Catalog Explorer

Para adicionar e atualizar tags de objeto protegíveis usando o Gerenciador de Catálogos:

1. Clique em Catálogo na barra lateral.

2. Selecione um objeto protegível.

3. Na página Visão geral do objeto, adicione ou atualize uma tag:

   • Se não houver tags, clique no botão Adicionar tags .
   • Se houver tags, clique no ícone Adicionar /Editar tags.

   Você pode usar a caixa de diálogo Adicionar/Editar tags para adicionar e excluir várias tags.

   As chaves de tag são necessárias. Os valores das tags são opcionais.

   Para adicionar ou excluir tags de coluna da tabela, clique no ícone Adicionar tag .

Adicionar e atualizar tags usando comandos SQL

Você pode usar o ALTER <object> comando SQL para marcar catálogos, esquemas, tabelas (incluindo 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 ALTER TABLE 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.

Para modelos registrados, você deve usar o Catalog Explorer ou o MLflow ClientAPI. Consulte Usar tags em modelos.

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.

Apenas as tabelas e vistas que tem permissão para ver aparecem nos resultados da pesquisa. Isso significa que você deve ter pelo menos o BROWSE privilégio no objeto (ou no catálogo pai e no esquema do objeto) para retornar o objeto nos resultados da pesquisa.

Para obter detalhes, consulte Usar tags para pesquisar tabelas.

Recuperar informações de tags de 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:

• INFORMATION_SCHEMA. CATALOG_TAGS
• INFORMATION_SCHEMA. COLUMN_TAGS
• INFORMATION_SCHEMA. SCHEMA_TAGS
• INFORMATION_SCHEMA. TABLE_TAGS
• INFORMATION_SCHEMA. VOLUME_TAGS

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