SKAPA STYRD TAGG

Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime 18.1 och ovan markerad ja Endast Unity Catalog

Skapar en styrd tagg, som är en resurs på kontonivå.

Om du vill köra den här instruktionen CREATE måste du ha behörigheten på kontonivå. Kontoadministratörer och arbetsyteadministratörer har den här behörigheten som standard.

Syntax

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

Parameters

  • tag_key

    Taggnyckeln som ska markeras som styrd. Taggnyckeln måste vara unik i kontot och är skiftlägeskänslig. Om det redan finns en styrd tagg med den här taggnyckeln returnerar Azure Databricks ett ALREADY_EXISTS-fel.

  • BESKRIVNING

    En valfri STRING-literal. Beskrivningen för den reglerade taggen.

  • VALUES ( value_name [, ...] )

    Anger de tillåtna värdena för den reglerade taggen. Reglerade taggar stöder nyckeltilldelningar eller en fördefinierad lista med värden. När den har angetts med en tom lista eller utelämnats helt tillåter den reglerade taggen endast taggtilldelningar med endast nyckel.

    • value_name

      En STRÄNGliteral. Namnet på ett tillåtet värde. Skiftlägeskänslig.

Requirements

Tagga nycklar och taggvärden:

  • Kan vara upp till 256 tecken.
  • Stöd för UTF-8-kodning, inklusive Unicode-tecken som internationella bokstäver, symboler och emojis.
  • Är skiftlägeskänsliga. Till exempel Department och department är två distinkta taggar.
  • Får inte innehålla följande tecken: * . / < > % & ? \ = eller kontrolltecken (ASCII 0–31)
  • Det går inte att börja eller avsluta med tomt utrymme.

Exempel

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