Aplicar marcas a objetos protegíveis do Catálogo do Unity

Artigo
10/07/2024

Este artigo mostra como aplicar marcas a objetos protegíveis do Catálogo do Unity.

As marcas são atributos que incluem chaves e valores opcionais que você pode usar para organizar e categorizar diferentes objetos protegíveis no Catálogo do Unity. O uso de marcas também simplifica a pesquisa e a descoberta de tabelas e exibições usando a funcionalidade de pesquisa do workspace.

Objetos protegíveis com suporte

Atualmente, há suporte para marcação de objeto protegível 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, confira Objetos protegíveis no Catálogo do Unity.

Requisitos

Para adicionar marcas a objetos protegíveis do Catálogo do Unity, você deve ser proprietário do objeto ou ter todos os seguintes privilégios:

APPLY TAG no objeto
USE SCHEMA no esquema pai do objeto
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 marcas usando a interface do usuário de pesquisa do workspace tem suporte apenas para tabelas, exibições e colunas de tabela.
A pesquisa de marcas requer correspondência exata de termos.

Adicionar e atualizar marcas usando o Explorador de Catálogo

Para adicionar e atualizar as marcas de objeto protegíveis usando o Explorador de Catálogo:

Clique em Catálogo na barra lateral.
Selecione um objeto protegível.
Na página Visão geral do objeto, adicione ou atualize uma marca:
- Se não houver marcas, clique no botão Adicionar marcas.
- Se houver marcas, clique no ícone Adicionar/Editar marcas.
Você pode usar a caixa de diálogo Adicionar/Editar marcas para adicionar e excluir várias marcas.

As chaves de marcas são obrigatórias. Os valores de marcas são opcionais.

Para adicionar ou excluir marcas de coluna de tabela, clique no ícone Adicionar marca.

Adicionar e atualizar marcas usando comandos SQL

Observação

Este recurso está disponível no Databricks Runtime 13.3 e versões superiores.

Você pode usar o comando SQL ALTER <object> 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 cláusulas SET TAGS e UNSET TAGS com 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.

Em modelos registrados, você deve usar o Gerenciador de Catálogos ou a ClientAPI do MLflow. Consulte Usar tags em modelos.

Usar marcas para pesquisar tabelas

Você pode usar a barra de pesquisa do workspace do Azure Databricks para pesquisar tabelas, exibições e colunas de tabela usando chaves de marca e valores de marca. Você pode usar marcas de tabela e marcas de coluna de tabela. Você não pode usar marcas para pesquisar outros objetos marcados, como catálogos, esquemas ou volumes.

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

Para obter detalhes, confira Usar marcas para pesquisar tabelas.

Recuperar informações de marca de tabelas de esquema de informações

Cada catálogo criado no Catálogo do Unity inclui um INFORMATION_SCHEMA. Este 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:

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

Compartilhar via