Aplicar tags a objetos protegíveis do Unity Catalog

Esta página mostra como aplicar tags a objetos protegíveis do Unity Catalog.

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 de tags também simplifica a pesquisa e a descoberta de tabelas e visualizações usando a funcionalidade de pesquisa do site workspace.

atenção

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

Objetos protegíveis compatíveis

A marcação segura de objetos é atualmente suportada em 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.

Governado tags

info

Visualização

Esse recurso está em Public Preview.

Governados tags são account-level tags com regras aplicadas para consistência e controle. Usando o site governado tags, o senhor define a chave e os valores permitidos e controla quais usuários e grupos podem atribuí-los aos objetos. Isso garante que o tags seja aplicado de forma consistente e esteja em conformidade com os padrões organizacionais, proporcionando controle centralizado sobre a classificação, compliance e operações.

Governado tags:

• Só pode ser atribuído ou modificado por usuários ou grupos com as permissões apropriadas.

• Deve usar os valores definidos na política de tag associada.

• São marcados na interface do usuário com um cadeado .

  

Se uma tag governada for excluída, as tags associadas se tornarão não governadas. As tags permanecem nos objetos, mas qualquer pessoa pode atribuí-las ou modificá-las sem precisar de permissões. Os usuários com os privilégios corretos podem continuar criando e atribuindo tags que não são governadas.

Para obter mais informações, consulte Governed tags.

nota

Se você estiver inscrito nas tags Private Preview do painel, qualquer tag atribuída a um painel que corresponda ao nome de uma tag controlada estará automaticamente sujeita à política dessa tag.

Etiquetas do sistema

As tags de sistema são um tipo especial de tag governada que é predefinida pela Databricks. As tags de sistema têm algumas características distintas:

• As definições de tags do sistema (chave e valores) são predefinidas pelo site Databricks.

• Os usuários não podem modificar ou excluir chaves ou valores de tags do sistema.

• Os usuários podem controlar quem tem permissão para atribuir ou cancelar a atribuição do sistema tags por meio das configurações de permissão tag governadas.

• Uma chave inglesa é exibida ao lado da etiqueta.

  

As tags do sistema são projetadas para oferecer suporte à marcação padronizada em todas as organizações, especialmente para casos de uso como classificação de dados, propriedade ou acompanhamento do ciclo de vida. Ao usar definições de tags predefinidas e governadas, as tags do sistema ajudam a reforçar a consistência sem exigir que os usuários definam ou gerenciem manualmente as estruturas de tags.

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 sobre o objeto
• USE SCHEMA no esquema principal do objeto
• USE CATALOG no catálogo principal do objeto

Para adicionar uma tag governada aos objetos protegíveis do Unity Catalog, o senhor também deve ter a permissão ASSIGN na tag governada. Consulte gerenciar permissões no site tags.

Restrições

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

• A chave da tag diferencia maiúsculas de minúsculas. Por exemplo, Sales e sales são duas tags distintas.

• Você pode atribuir no máximo 50 tags a um único objeto protegível.

• O comprimento máximo de uma tag key é de 255 caracteres.

• O tamanho máximo de um valor de tag é de 1000 caracteres.

• Os seguintes caracteres não são permitidos na chave de tag:

  . , - = / :

• Espaços à direita e à esquerda não são permitidos na chave ou nos valores da tag.

• A pesquisa por tag utilizando a interface de usuário de pesquisa workspace é suportada apenas para tabelas e visualizações.

• A pesquisa de tags exige a correspondência exata de termos.

Adicione e atualize tags usando o Catalog Explorer

Para adicionar e atualizar tags de objetos protegíveis usando o Catalog Explorer:

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:

   • As tags que são governadas estão no cabeçalho da seção Governed e têm um ícone de cadeado.
   • 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.

   É necessária uma chave de identificação. 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 SQL comando

nota

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

O senhor pode usar o comando ALTER <object> SQL para marcar 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 em modelos.

Use tags para pesquisar tabelas

Utilize a barra de pesquisa Databricks workspace para procurar tabelas e visualizá-las utilizando a chave de tag e os valores de tag. Você pode usar as duas tags de tabela para pesquisar. Você não pode usar tags para pesquisar outros objetos marcados, como colunas de tabelas, 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 você 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 informações de tag 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 no 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 informações sobre a tag:

• informação.CATALOG_TAGS
• informação.COLUMN_TAGS
• informação.SCHEMA_TAGS
• informação.TABLE_TAGS
• informação.VOLUME_TAGS

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