Partilhar via

SET ETIQUETA

Aplica-se a:marca de verificação sim Databricks SQL marca de verificação sim Databricks Runtime 16.1 e superior

Define uma etiqueta em um catálogo, esquema, tabela, vista, volume ou coluna.

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 principal do objeto

Se a tag for regida por uma política específica da tag, você também precisará de ASSIGN permissão na política de tags

Sintaxe

SET TAG ON
    { CATALOG catalog_name |
      COLUMN relation_name . column_name |
      { SCHEMA | DATABASE } schema_name |
      TABLE relation_name |
      VIEW  relation_name |
      VOLUME volume_name }
    tag_key [ = tag_value ]

Parâmetros

  • CATALOG catalog_name

    O nome do catálogo a ser marcado.

  • COLUMN relation_name . nome_da_coluna

    O nome qualificado da coluna a etiquetar. relation_name deve identificar uma vista ou uma tabela. O relation_name não deve incluir uma especificação temporal ou uma especificação de opções.

  • SCHEMA schema_name

    O nome do esquema a ser marcado.

  • TABLE relation_name

    O nome da tabela ou exibição a ser marcada. O nome não deve incluir uma especificação temporal ou uma especificação de opções.

  • VER relation_name

    O nome do modo de exibição a ser marcado.

  • VOLUME volume_name

    O nome do volume a ser marcado.

  • tag_key

    Um identificador. Se já existir uma atribuição de tag com a mesma chave, uma exceção será gerada.

  • tag_value

    Um identificador opcional. Se não for especificado, a atribuição de tags será definida como somente chave.

Exemplos

> SET TAG ON CATALOG catalog `cost_center` = `hr`;

> UNSET TAG ON CATALOG catalog cost_center;

> SET TAG ON TABLE catalog.schema.table cost_center = hr;

> UNSET TAG ON TABLE catalog.schema.table cost_center;

> SET TAG ON COLUMN table.ssn pii;

> UNSET TAG ON COLUMN table.ssn pii;

> SELECT table_name, column_name FROM information_schema.column_tags
    WHERE tag_name = 'pii' AND schema_name = 'default';
  table_name column_name
  ---------- -----------
  table      ssn