Condividi tramite


SET CARTELLINO

Si applica a:selezionato come sì Databricks SQL selezionato come sì Databricks Runtime 16.1 e versioni successive

Imposta un tag su un catalogo, uno schema, una tabella, una vista, un volume o una colonna.

Per aggiungere tag a oggetti a protezione diretta di Unity Catalog, è necessario possedere l'oggetto o disporre di tutti i privilegi seguenti:

  • APPLY TAG sull'oggetto
  • USE SCHEMA nello schema padre dell'oggetto
  • USE CATALOG nel catalogo principale dell'oggetto

Se il tag è regolato, è necessaria ASSIGN anche l'autorizzazione per il tag regolamentato

Sintassi

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 ]

Parametri

  • CATALOG catalog_name

    Nome del catalogo da contrassegnare.

  • COLUMN relation_name . column_name

    Nome completo della colonna da contrassegnare. relation_name deve identificare una vista o una tabella. Il relation_name non deve includere una specifica temporale o una specifica delle opzioni.

  • SCHEMA schema_name

    Nome dello schema da contrassegnare.

  • TABLE relation_name

    Nome della tabella o della vista da contrassegnare. Il nome non deve includere una specifica temporale o una specifica delle opzioni.

  • VIEW relation_name

    Nome della visualizzazione da contrassegnare.

  • VOLUME_NAME VOLUME

    Nome del volume da contrassegnare.

  • tag_key

    Identificatore. Se esiste già un'assegnazione di tag con la stessa chiave e viene generata un'eccezione.

  • tag_value

    Identificatore facoltativo. Se non specificato, l'assegnazione di tag verrà impostata come chiave unica.

Esempi

> 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