Teilen über

SET ETIKETT

Gilt für:mit Häkchen markiert ja Databricks SQL mit Häkchen markiert ja Databricks Runtime 16.1 und höher

Legt ein Tag für einen Katalog, ein Schema, eine Tabelle, eine Ansicht, ein Volume oder eine Spalte fest.

Um Tags zu sicherungsfähigen Unity Catalog-Objekten hinzuzufügen, müssen Sie Besitzer des Objekt sein oder über alle folgenden Berechtigungen verfügen:

  • APPLY TAG für das Objekt
  • USE SCHEMA für das übergeordnete Schema des Objekts
  • USE CATALOG für den übergeordneten Katalog des Objekts

Wenn das Tag unterliegt, benötigen ASSIGN Sie auch die Berechtigung für das geregelte Tag.

Syntax

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

Parameter

  • CATALOG catalog_name

    Der Name des zu taggenden Katalogs.

  • COLUMN relation_name . Spaltenname

    Der qualifizierte Name der zu taggenden Spalte. relation_name muss eine Ansicht oder eine Tabelle identifizieren. Der relation_name darf keine Zeitangabe oder Optionsangabe enthalten.

  • SCHEMA schema_name

    Den Namen des zu taggenden Schemas.

  • TABLE relation_name

    Der Name der zu markierenden Tabelle oder Ansicht. Der Name darf keine zeitliche Spezifikation oder Optionsspezifikation enthalten.

  • VIEW relation_name

    Den Namen der zu taggenden Ansicht.

  • VOLUME-volume_name

    Den Namen des zu taggenden Volumes.

  • tag_key

    Ein Bezeichner. Wenn eine Tag-Zuweisung mit demselben Schlüssel bereits existiert, wird eine Ausnahme ausgelöst.

  • tag_value

    Ein optionaler Bezeichner. Wenn nichts angegeben wird, wird die Zuweisung des Tags als „nur Schlüssel“ festgelegt.

Beispiele

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

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