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 ein Katalog-, Schema-, Tabellen-, Ansichts-, Volume-, Spalten-, Funktions- oder externes Metadatenobjekt fest.

Von Bedeutung

Das Festlegen von Tags für externe Metadatenobjekte befindet sich in der öffentlichen Vorschau und erfordert Databricks Runtime 18.2 oder höher.

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

Externe Metadatenobjekte sind nicht in einem Katalog oder Schema enthalten und USE CATALOGUSE SCHEMA gelten nicht.

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

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.

  • EXTERNE METADATEN external_metadata_name

    Der Name des zu markierenden externen Metadatenobjekts .

  • { FUNCTION | PROCEDURE } function_name

    Der Name der zu markierenden Funktion oder Prozedur. FUNCTION und PROCEDURE können synonym verwendet werden.

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

> 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