Partilhar via

Aplicar tags a objetos protegíveis do Unity Catalog

  • Artigo

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.

Os dados de tags podem ser replicados globalmente. Não utilize nomes de etiquetas ou valores que possam comprometer a segurança dos seus recursos. Por exemplo, não use nomes de tags que contenham informações pessoais ou confidenciais.

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 50 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.

  • Os seguintes caracteres não são permitidos em chaves ou valores de tag:

    . , - = / :

  • 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 Ícone do catálogo 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 Ícone Editar /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 para adicionar uma etiqueta de coluna ou comentário ícone Adicionar tag .

Adicionar e atualizar tags usando comandos SQL

Nota

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

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:

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