Kategorien:

Information Schema, Tabellenfunktionen

TAG_REFERENCES_ALL_COLUMNS

Gibt eine Tabelle zurück, in der jede Zeile den Tag-Namen und den Tag-Wert anzeigt, die einer bestimmten Spalte zugewiesen sind.

Diese Funktion gibt jedes Tag zurück, das für jede Spalte einer bestimmten Tabelle oder Ansicht festgelegt wurde, unabhängig davon, ob das Tag einer Spalte direkt oder durch Tag-Vererbung zugewiesen ist.

Syntax

TAG_REFERENCES_ALL_COLUMNS( '<object_name>' , '<object_domain>' )
Copy

Argumente

'object_name'

Name des referenzierten Objekts, wenn sich die Tag-Zuordnung auf das Objekt bezieht.

Dieses Argument unterstützt die Namen für Tabellen und Ansichten.

'object_domain'

Domäne des referenzierten Objekts.

Snowflake unterstützt eine Domäne für diese Funktion: TABLE.

Beachten Sie, dass die Domäne TABLE für alle Objekte verwendet werden muss, die Spalten enthalten, auch wenn der Objektname eine Ansicht ist (d. h. Ansicht, materialisierte Ansicht).

Nutzungshinweise

  • Es werden nur Ergebnisse für eine Rolle zurückgegeben, die Zugriff auf das angegebene Objekt hat.

    Um Referenzen für System-Tags anzuzeigen, verwenden Sie eine Rolle mit IMPORTED PRIVILEGES-Berechtigungen für die freigegebene SNOWFLAKE-Datenbank.

  • Beim Aufrufen einer Tabellenfunktion des Information Schema muss die Sitzung über ein aktives INFORMATION_SCHEMA-Schema verfügen oder die Funktion muss vollqualifizierte Objektnamen verwenden. Weitere Details dazu finden Sie unter Snowflake Information Schema.

Ausgabe

Die Funktion gibt die folgenden Spalten zurück:

Spalte

Datentyp

Beschreibung

TAG_DATABASE

TEXT

Die Datenbank, in der das Tag festgelegt ist.

TAG_SCHEMA

TEXT

Das Schema, in dem das Tag festgelegt ist.

TAG_NAME

TEXT

Der Name des Tags. Dies ist der Wert für key im key = 'value'-Paar des Tags.

TAG_VALUE

TEXT

Der Wert des Tags. Dies ist der Wert für 'value' im key = 'value'-Paar des Tags.

APPLY_METHOD

TEXT

Gibt an, wie das Tag dem Objekt zugewiesen wurde. Mögliche Werte sind die folgenden:

  • CLASSIFIED: Das Tag wurde automatisch auf eine Spalte angewendet, die als sensibel eingestuft wurde. Siehe Über die Zuordnung von Tags.

  • INHERITED: Das Objekt hat das Tag von einem Objekt weiter oben in der Snowflake-Hierarchie der sicherbaren Objekte geerbt. Siehe Tag-Vererbung.

  • MANUAL: Jemand hat die Markierung des Objekts manuell mit dem Befehl CREATE <object> oder ALTER <object> gesetzt. Siehe Ein Tag setzen.

  • PROPAGATED: Das Tag wurde automatisch von einem Objekt auf ein anderes übertragen. Siehe Automatische Tag-Weitergabe mit benutzerdefinierten Tags.

  • NULL: Legacy-Datensatz.

  • NONE: Legacy-Datensatz.

LEVEL

TEXT

Die Objektdomäne, in der das Tag gesetzt wird.

OBJECT_DATABASE

TEXT

Der Datenbankname, der die Tabelle oder die Ansicht enthält.

OBJECT_SCHEMA

TEXT

Der Schemaname, der die Tabelle oder die Ansicht enthält.

OBJECT_NAME

TEXT

Der Name der Tabelle oder der Ansicht.

DOMAIN

TEXT

Dieser Wert muss COLUMN sein, da diese Funktion alle Tags zurückgibt, die in allen Spalten der Tabelle bzw. Ansicht festgelegt sind.

COLUMN_NAME

TEXT

Der Name der Spalte, auf die das Tag gesetzt ist.

Beispiele

Abrufen der Liste der Tags, die jeder Spalte in der Tabelle my_table zugeordnet sind:

select *
  from table(my_db.information_schema.tag_references_all_columns('my_table', 'table'));
Copy