Compartir a través de


CREAR ETIQUETA GOBERNADA

Se aplica a:check marcado yes Comprobación de SQL de Databricks marcada como sí Databricks Runtime 18.1 y versiones posteriores marcadas como sí Catálogo de Unity solo

Crea una etiqueta regulada, que es un recurso de nivel de cuenta.

Para ejecutar esta instrucción, debe tener el CREATE privilegio en el nivel de cuenta. Los administradores de cuentas y los administradores del área de trabajo tienen este privilegio de forma predeterminada.

Sintaxis

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

Parámetros

  • tag_key

    Clave de etiqueta que se va a marcar según se rige. La clave de etiqueta debe ser única dentro de la cuenta y distingue mayúsculas de minúsculas. Si ya existe una etiqueta regulada con esta clave de etiqueta, Azure Databricks devuelve un error ALREADY_EXISTS.

  • Descripción de la descripción

    Un literal STRING opcional. Descripción de la etiqueta regulada.

  • VALUES ( value_name [, ...] )

    Establece los valores permitidos para la etiqueta regulada. Las etiquetas reguladas admiten asignaciones de solo clave o una lista predefinida de valores. Cuando se especifica con una lista vacía o se omite por completo, la etiqueta regulada solo permite asignaciones de etiquetas de solo clave.

    • value_name

      Un literal STRING. Nombre de un valor permitido. Distingue mayúsculas de minúsculas.

Requisitos

Etiquetar claves y valores de etiqueta:

  • Puede tener hasta 256 caracteres.
  • Admite la codificación UTF-8, incluidos caracteres Unicode, como letras internacionales, símbolos y emoji.
  • Distinguen mayúsculas de minúsculas. Por ejemplo, Department y department son dos etiquetas distintas.
  • No se pueden contener los siguientes caracteres: * . / < > % & ? \ = ni caracteres de control (ASCII 0–31)
  • No se puede comenzar ni terminar con espacios en blanco.

Ejemplos

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