Aplicar marcas

Este artigo mostra como aplicar marcas no Catálogo do Unity.

As marcas são atributos que contêm chaves e valores opcionais que você pode aplicar a diferentes objetos protegíveis no Catálogo do Unity. A marcação é útil para organizar e categorizar objetos protegíveis em um metastore. O uso de marcas também simplifica a pesquisa e a descoberta de seus ativos de dados.

Objetos protegíveis com suporte

Atualmente, a marcação de objetos protegíveis é suportada em catálogos, esquemas, tabelas, volumes, visualizações e modelos registrados. Para obter mais informações sobre objetos protegíveis, consulte Objetos protegíveis no Catálogo do Unity.

Requisitos

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

Restrições

Veja a seguir uma lista de restrições de marca:

• Você pode atribuir no máximo 20 marcas a um único objeto protegível.
• O comprimento máximo de uma chave de marca é de 255 caracteres.
• O comprimento máximo de um valor de marca é de 1000 caracteres.
• Caracteres especiais não podem ser usados em nomes de marca.
• A pesquisa de tabelas do Catálogo do Unity por nome de marca ou valor tem suporte apenas com a correspondência exata.

Gerenciar marcas no Gerenciador de Catálogos

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

1. Clique no Catálogo na barra lateral.
2. Selecione um objeto protegível para exibir as informações da marca.
3. Clique no Adicionar/Editar marcas para gerenciar as marcas do objeto seguro atual. Você pode adicionar e remover várias marcas simultaneamente no modal de gerenciamento de marcas.

Recuperar informações de marca com tabelas de Esquema de Informações

Cada catálogo criado no Catálogo do Unity inclui um INFORMATION_SCHEMA. Esse esquema inclui tabelas que descrevem os objetos conhecidos pelo 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 de marca:

• 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, confira Esquema de informações.

Gerenciar marcas com comandos SQL

Observação

Esse recurso só está disponível para versões do Databricks Runtime da 13.3 e superiores.

O Azure Databricks dá suporte à marcação de comandos SQL com catálogos, esquemas, tabelas (exibições, exibições materializadas, tabelas de streaming), volumes e colunas de tabela. Por exemplo, você pode usar as cláusulas SET TAGS e UNSET TAGS com o comando ALTER TABLE para gerenciar marcas em uma tabela. Confira as instruções DDL para obter uma lista de comandos de linguagem de definição de dados (DDL) disponíveis e sua sintaxe.

Usar marcas para pesquisar e filtrar tabelas

Para pesquisar e filtrar tabelas usando marcas:

1. Clique no campo Pesquisar na barra superior do workspace do Azure Databricks ou use o atalho de teclado Command-P.
2. Insira seus critérios de pesquisa. Pesquise tabelas no Catálogo do Unity inserindo o nome ou o valor da marca atribuído.

Você também pode usar o filtro de marca na guia Pesquisa de tabela para filtrar os resultados da pesquisa com nomes de marca existentes.