SET TAGG

Gäller för:markerad som ja Databricks SQL markerad som ja Databricks Runtime version 16.1 eller senare

Anger en tagg i en katalog, ett schema, en tabell, en vy, en volym, en kolumn, en funktion eller ett externt metadataobjekt.

Important

Att ange taggar för externa metadataobjekt finns i offentlig förhandsversion och kräver Databricks Runtime 18.2 eller senare.

Om du vill lägga till taggar i skyddsbara objekt i Unity Catalog måste du äga objektet eller ha alla följande behörigheter:

  • APPLY TAG på objektet
  • USE SCHEMA i objektets överordnade schema
  • USE CATALOG i objektets överordnade katalog

Externa metadataobjekt finns inte i en katalog eller ett schema, så USE CATALOG och USE SCHEMA gäller inte.

Om taggen styrs behöver ASSIGN du också behörighet för den reglerade taggen

Syntax

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 ]

Parameterar

Exempel

> 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