Aplicar tags a objetos protegíveis do Unity Catalog

Este artigo mostra como aplicar tags a Unity Catalog objetos seguros.

As tags são atributos que incluem valores-chave e opcionais que o senhor pode usar para organizar e categorizar objetos protegíveis em Unity Catalog. O uso do site tags também simplifica a pesquisa e a descoberta de tabelas e visualizações usando a funcionalidade de pesquisa do site workspace.

Os dados da tag podem ser replicados globalmente. Não use tag nomes ou valores que possam comprometer a segurança de seu recurso. Por exemplo, não use nomes tag que contenham informações pessoais ou confidenciais.

Objetos securizáveis suportados

Atualmente, as tags de objetos seguros são compatíveis com catálogos, esquemas, tabelas, colunas de tabelas, volumes, visualizações, modelos registrados e versões de modelos. Para obter mais informações sobre objetos protegidos, consulte Objetos protegidos em Unity Catalog.

Requisitos

Para adicionar tags a objetos protegíveis do Unity Catalog, o senhor deve ser o proprietário do objeto ou ter todos os privilégios a seguir:

APPLY TAG no objeto
USE SCHEMA no esquema pai do objeto
USE CATALOG no catálogo pai do objeto

Restrições

A seguir, uma lista de restrições do site tag:

O senhor pode atribuir um máximo de 50 tags a um único objeto securizável.
O comprimento máximo de um tag key é de 255 caracteres.
O comprimento máximo de um valor de tag é de 1.000 caracteres.
Os seguintes caracteres não são permitidos na chave ou nos valores do site tag:

. , - = / :
tag A pesquisa usando a UI de pesquisa workspace é compatível apenas com tabelas, exibições e colunas de tabela.
tag requer a correspondência exata de termos.

Adicionar e atualizar tags usando o Catalog Explorer

Para adicionar e atualizar tags de objetos seguros usando o Catalog Explorer:

Clique em Catalog na barra lateral.
Selecione um objeto seguro.
Na página Visão geral do objeto, adicione ou atualize uma tag:
- Se não houver tags, clique no botão Add tags (Adicionar tags ).
- Se houver tags, clique no ícone Add/Edit tags.
O senhor pode usar a caixa de diálogo Add/Edit tags para adicionar e excluir várias tags.

tag são necessários. tag são opcionais.

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

Adicionar e atualizar tags usando SQL comando

Observação

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

O senhor pode usar o comando ALTER <object> SQL para tag catálogos, esquemas, tabelas (inclusive visualização, visualização materializada, tabelas de transmissão), volumes e colunas de tabela. Por exemplo, o senhor pode usar as cláusulas SET TAGS e UNSET TAGS com ALTER TABLE para gerenciar as tags em uma tabela. Consulte Declarações DDL para obter uma lista dos comandos DDL (Data Definition Language) disponíveis e sua sintaxe.

Para modelos registrados, o senhor deve usar o Catalog Explorer ou o MLflow ClientAPI. Consulte Usar etiquetas nos modelos.

Use tags para pesquisar tabelas

O senhor pode usar a barra de pesquisa Databricks workspace para pesquisar tabelas, exibições e colunas de tabela usando a chave tag e os valores tag. O senhor pode usar tags de tabela e tags de coluna de tabela. O senhor não pode usar o site tags para pesquisar outros objetos de tags, como catálogos, esquemas ou volumes.

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

Para obter detalhes, consulte Usar tags para pesquisar tabelas.

Recuperar tag informações das tabelas de esquema de informações

Cada catálogo criado no Unity Catalog inclui um INFORMATION_SCHEMA. Esse esquema inclui tabelas que descrevem os objetos conhecidos pelo catálogo do esquema. O senhor deve ter os privilégios adequados para acessar view as informações do esquema.

O senhor pode consultar o seguinte para obter tag informações:

Para obter mais informações, consulte o esquema de informações.