TAG NON IMPOSTATO

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

Rimuove un tag in un catalogo, uno schema, una tabella, una vista, un volume, una colonna, una funzione o un oggetto metadati esterno.

Importante

La rimozione di tag da oggetti metadati esterni è disponibile in anteprima pubblica e richiede Databricks Runtime 18.2 o versione successiva.

Per rimuovere i tag dagli 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

Gli oggetti metadati esterni non sono contenuti in un catalogo o in uno schema, USE CATALOG quindi USE SCHEMA non si applicano.

Sintassi

UNSET TAG ON
    { CATALOG catalog_name |
      COLUMN relation_name . column_name |
      EXTERNAL METADATA external_metadata_name |
      { FUNCTION | PROCEDURE } function_name |
      { SCHEMA | DATABASE } schema_name |
      TABLE relation_name |
      VIEW  relation_name |
      VOLUME volume_name }
    tag_key

Parametri

  • CATALOG catalog_name

    Nome del catalogo da cui rimuovere il tag.

  • COLUMN relation_name . column_name

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

  • EXTERNAL_METADATA_NAME DI METADATI ESTERNI

    Nome dell'oggetto metadati esterno da cui rimuovere il tag.

  • { FUNCTION | PROCEDURE } function_name

    Nome della funzione o della routine da cui rimuovere il tag.

    Annotazioni

    L'assegnazione di tag a funzioni e procedure richiede Databricks Runtime 18.1 o versione successiva.

  • SCHEMA Schema_name

    Nome dello schema da cui rimuovere il tag.

  • TABLE relation_name

    Nome della tabella o vista da cui rimuovere il tag. Il nome non deve includere una specifica temporale o una specifica delle opzioni.

  • VIEW relation_name

    Nome della visualizzazione da cui rimuovere il tag.

  • VOLUME_NAME VOLUME

    Nome del volume da cui rimuovere il tag.

  • tag_key

    Identificatore. Se il tag non può essere trovato, viene generata un'eccezione.

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;

> SET TAG ON FUNCTION catalog.schema.my_func cost_center = hr;

> UNSET TAG ON FUNCTION catalog.schema.my_func cost_center;