Partager via


CRÉER UNE BALISE RÉGIE

S’applique à :check marqué oui Databricks SQL coche marqué oui Databricks Runtime 18.1 et versions ultérieures , cochez oui catalogue Unity uniquement

Crée une balise régie, qui est une ressource au niveau du compte.

Pour exécuter cette instruction, vous devez disposer du CREATE privilège au niveau du compte. Les administrateurs de compte et les administrateurs d’espace de travail ont ce privilège par défaut.

Syntaxe

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

Paramètres

  • tag_key

    Clé de balise à marquer comme régie. La clé d’étiquette doit être unique dans le compte et respecte la casse. Si une balise régie avec cette clé de balise existe déjà, Azure Databricks retourne une erreur ALREADY_EXISTS.

  • Description de la description

    Littéral STRING facultatif. Description de la balise régie.

  • VALUES ( value_name [, ...] )

    Définit les valeurs autorisées pour la balise régie. Les balises régies prennent en charge les affectations de clés uniquement ou une liste prédéfinie de valeurs. Lorsqu’elle est spécifiée avec une liste vide ou omise entièrement, la balise régie autorise uniquement les attributions de balises de clé uniquement.

    • value_name

      Littéral STRING. Nom d’une valeur autorisée. Respect de la casse.

Exigences

Clés de balise et valeurs d’étiquette :

  • Peut comporter jusqu’à 256 caractères.
  • Prise en charge de l’encodage UTF-8, y compris les caractères Unicode tels que les lettres internationales, les symboles et les emojis.
  • Sensibles à la casse. Par exemple, Department et department sont deux balises distinctes.
  • Impossible de contenir les caractères suivants : * . / < > % & ? \ = ou les caractères de contrôle (ASCII 0-31)
  • Impossible de commencer ou de se terminer par un espace blanc.

Exemples

-- 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');