Condividi tramite


CREATE GOVERNED TAG

Si applica a:check contrassegnato con il segno di spunta sì di Databricks SQL contrassegnato come sì Databricks Runtime 18.1 e versioni successive , il segno di spunta contrassegnato come Solo catalogo Unity

Crea un tag regolamentato, ovvero una risorsa a livello di account.

Per eseguire questa istruzione, è necessario disporre del CREATE privilegio a livello di account. Gli amministratori account e gli amministratori dell'area di lavoro hanno questo privilegio per impostazione predefinita.

Sintassi

CREATE GOVERNED TAG tag_key [ DESCRIPTION description ] [ VALUES ( value_name [, ...] ) ]

Parametri

  • tag_key

    Chiave del tag da contrassegnare come disciplinata. La chiave del tag deve essere univoca all'interno dell'account e fa distinzione tra maiuscole e minuscole. Se esiste già un tag regolato con questa chiave di tag, Azure Databricks restituisce un errore ALREADY_EXISTS.

  • Descrizione DESCRIZIONE

    Valore letterale STRING facoltativo. Descrizione del tag regolamentato.

  • VALUES ( value_name [, ...] )

    Imposta i valori consentiti per il tag regolato. I tag regolati supportano assegnazioni di sola chiave o un elenco predefinito di valori. Se specificato con un elenco vuoto o completamente omesso, il tag regolamentato consente solo assegnazioni di tag di sola chiave.

    • value_name

      Valore letterale STRING. Nome di un valore consentito. Distinzione tra maiuscole e minuscole.

Requisiti

Contrassegna le chiavi e i valori dei tag:

  • Può contenere fino a 256 caratteri.
  • Supportare la codifica UTF-8, inclusi caratteri Unicode, ad esempio lettere internazionali, simboli ed emoji.
  • Fanno distinzione tra maiuscole e minuscole. Ad esempio, Department e department sono due tag distinti.
  • Impossibile contenere i caratteri seguenti: * . / < > % & ? \ = o caratteri di controllo (ASCII 0-31)
  • Impossibile iniziare o terminare con spazi vuoti.

Examples

-- Create a key-only governed tag.
> CREATE GOVERNED TAG isPii;

-- Create a governed tag with an empty values list.
> CREATE GOVERNED TAG sensitivity_level VALUES ();

-- Create a governed tag with allowed values.
> CREATE GOVERNED TAG sensitivity_level VALUES ('low', 'medium', 'high');

-- Create a governed tag with a description and allowed values.
> CREATE GOVERNED TAG pii
  DESCRIPTION 'Indicates what kind of personal identifiable information the asset contains'
  VALUES ('ssn', 'ccn', 'dob');