Nicht gesetztes Tag

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

Entfernt ein Tag für einen Katalog, ein Schema, eine Tabelle, eine Ansicht, ein Volume, eine Spalte, eine Funktion oder ein externes Metadatenobjekt.

Von Bedeutung

Das Entfernen von Tags aus externen Metadatenobjekten befindet sich in der öffentlichen Vorschau und erfordert Databricks Runtime 18.2 oder höher.

Um Tags aus Sicherungsobjekten aus Unity Catalog zu entfernen, müssen Sie über das Objekt verfügen 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.

Syntax

UNSET 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

Parameter

  • CATALOG Catalog_name

    Der Name des Katalogs, aus dem das Tag entfernt werden soll.

  • COLUMN relation_name . Spaltenname

    Der qualifizierte Name der Spalte, aus der das Tag entfernt werden soll. 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 externen Metadatenobjekts , aus dem das Tag entfernt werden soll.

  • { FUNCTION | PROCEDURE } function_name

    Der Name der Funktion oder Prozedur, aus der das Tag entfernt werden soll.

  • SCHEMA Schema_name

    Der Name des Schemas, aus dem das Tag entfernt werden soll.

  • TABLE relation_name

    Der Name der Tabelle oder Ansicht, aus der das Tag entfernt werden soll. Der Name darf keine zeitliche Spezifikation oder Optionsspezifikation enthalten.

  • VIEW relation_name

    Der Name der Ansicht, aus der der Tag entfernt werden soll.

  • VOLUME-volume_name

    Der Name des Volumes, aus dem der Tag entfernt werden soll.

  • tag_key

    Ein Bezeichner. Wenn das Tag nicht gefunden wird, wird eine Ausnahme ausgelöst.

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;