Freigeben über

CREATE GOVERNED TAG

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 18.1 and above check marked yes Unity Catalog only

Erstellt ein gesteuertes Tag, bei dem es sich um eine Ressource auf Kontoebene handelt.

Um diese Anweisung auszuführen, müssen Sie über die CREATE Berechtigung auf Kontoebene verfügen. Kontoadministratoren und Arbeitsbereichsadministratoren verfügen standardmäßig über diese Berechtigung.

Syntax

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

Parameter

  • tag_key

    Die Tagtaste, die als geregelt markiert werden soll. Der Tagschlüssel muss innerhalb des Kontos eindeutig sein und die Groß-/Kleinschreibung wird beachtet. Wenn bereits ein geregeltes Tag mit diesem Tagschlüssel vorhanden ist, gibt Azure Databricks einen Fehler vom Typ ALREADY_EXISTS zurück.

  • BESCHREIBUNG

    Ein optionales STRING-Literal. Die Beschreibung für das geregelte Tag.

  • VALUES ( value_name [, ...] )

    Legt die zulässigen Werte für das geregelte Tag fest. Gesteuerte Tags unterstützen nur Schlüsselzuweisungen oder eine vordefinierte Liste von Werten. Wenn sie mit einer leeren Liste angegeben oder vollständig weggelassen wird, lässt das gesteuerte Tag nur Schlüsseltagzuweisungen zu.

    • value_name

      Ein STRING-Literal. Der Name für einen zulässigen Wert. Groß-/Kleinschreibung beachten.

Anforderungen

Tagschlüssel und Tagwerte:

  • Kann bis zu 256 Zeichen lang sein.
  • Unterstützt UTF-8-Codierung, einschließlich Unicode-Zeichen wie internationale Buchstaben, Symbole und Emojis.
  • Beachten die Groß- und Kleinschreibung. Beispielsweise sind Department und department zwei unterschiedliche Tags.
  • Die folgenden Zeichen können nicht enthalten sein: * . / < > % & ? \ = oder Steuerzeichen (ASCII 0-31)
  • Kann nicht mit einem Leerzeichen beginnen oder enden.

Beispiele

-- 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');
  • Last updated on