SET ETIQUETA

se aplica a:marcado como sí Databricks SQL marcado como sí Databricks Runtime 16.1 y versiones posteriores

Establece una etiqueta en un catálogo, esquema, tabla, vista, volumen, columna, función o objeto de metadatos externos.

Importante

Establecer etiquetas en objetos de metadatos externos está en versión preliminar pública y requiere Databricks Runtime 18.2 o superior.

Para agregar etiquetas a objetos protegibles de Unity Catalog, debe poseer el objeto o tener todos los privilegios siguientes:

  • APPLY TAG en el objeto
  • USE SCHEMA en el esquema primario del objeto
  • USE CATALOG en el catálogo primario del objeto

Los objetos de metadatos externos no están incluidos en un catálogo o esquema, por lo que USE CATALOG y USE SCHEMA no se aplican.

Si la etiqueta se rige, también necesita ASSIGN permiso en la etiqueta regulada.

Sintaxis

SET TAG ON
    { CATALOG catalog_name |
      COLUMN relation_name . column_name |
      EXTERNAL METADATA external_metadata_name |
      { FUNCTION | PROCEDURE } function_name |
      { SCHEMA | DATABASE } schema_name |
      TABLE relation_name |
      VIEW  relation_name |
      VOLUME volume_name }
    tag_key [ = tag_value ]

Parámetros

  • CATALOG catalog_name

    Nombre del catálogo a etiquetar.

  • COLUMN relation_name . nombre_de_columna

    Nombre completo de la columna para etiquetar. relation_name debe identificar una vista o una tabla. El relation_name no debe incluir una especificación temporal ni una especificación de opciones.

  • EXTERNAL_METADATA_NAME DE METADATOS EXTERNOS

    Nombre del objeto de metadatos externos que se va a etiquetar.

  • { FUNCTION | PROCEDURE } function_name

    Nombre de la función o procedimiento que se va a etiquetar. FUNCTION y PROCEDURE son intercambiables.

  • SCHEMA schema_name

    Nombre del esquema que se va a etiquetar.

  • TABLE relation_name

    Nombre de la tabla o vista para etiquetar. El nombre no debe incluir una especificación temporal ni una especificación de opciones.

  • VER relation_name

    Nombre de la vista para etiquetar.

  • VOLUMEN volume_name

    Nombre del volumen que se va a etiquetar.

  • tag_key

    Un identificador. Si ya existe una asignación de etiquetas con la misma clave y se produce una excepción.

  • tag_value

    Identificador opcional. Si no se especifica, la asignación de etiquetas se establecerá como solo clave.

Ejemplos

> SET TAG ON CATALOG catalog `cost_center` = `hr`;

> UNSET TAG ON CATALOG catalog cost_center;

> SET TAG ON TABLE catalog.schema.table cost_center = hr;

> UNSET TAG ON TABLE catalog.schema.table cost_center;

> SET TAG ON COLUMN table.ssn pii;

> UNSET TAG ON COLUMN table.ssn pii;

> SET TAG ON FUNCTION catalog.schema.my_func cost_center = hr;

> UNSET TAG ON FUNCTION catalog.schema.my_func cost_center;

> SELECT catalog_name, schema_name, table_name, tag_name, tag_value
    FROM information_schema.column_tags
    WHERE tag_name = 'pii' AND schema_name = 'default';
  table_name column_name
  ---------- -----------
  table      ssn
  • Last updated on