Kategorien:: Information Schema, Tabellenfunktionen

TAG_REFERENCES¶

Gibt eine Tabelle zurück, in der jede Zeile eine Zuordnung zwischen einem Tag und einem Wert anzeigt.

Die Zuordnung von Tag und Wert ist das Ergebnis einer direkten Zuordnung zu einem Objekt oder einer Zuordnung über die Tag-Herkunft.

Syntax¶

TAG_REFERENCES( '<object_name>' , '<object_domain>' )

Copy

Argumente¶

'object_name'

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

'object_domain'

Domäne des Referenzobjekts, wie eine Tabelle oder Ansicht, wenn sich die Tag-Zuordnung auf das Objekt bezieht. Bei Spalten ist die Domäne COLUMN, wenn sich die Tag-Zuordnung auf eine Spalte bezieht.

Verwenden Sie einen der folgenden Werte:

'ACCOUNT'

'ALERT'

'COLUMN'

'DATABASE'

'DATABASE ROLE'

'FUNCTION'

'INTEGRATION'

'NETWORK POLICY'

'PROCEDURE'

'ROLE'

'SCHEMA'

'SHARE'

'STAGE'

'STREAM'

'TABLE': Verwenden Sie dies für alle tabellenähnlichen Objekte wie Ansichten, materialisierte Ansichten und externe Tabellen.

'TASK'

'USER'

'WAREHOUSE'

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.
LEVEL	TEXT	Die Objektdomäne, in der das Tag gesetzt wird.
OBJECT_DATABASE	TEXT	Datenbankname des referenzierten Objekts für Datenbank- und Schemaobjekte. Wenn das Objekt kein Datenbank- oder Schemaobjekt ist, ist der Wert leer.
OBJECT_SCHEMA	TEXT	Schemaname des referenzierten Objekts (für Schemaobjekte). Wenn es sich bei dem referenzierten Objekt nicht um ein Schemaobjekt (z. B. ein Warehouse) handelt, ist dieser Wert leer.
OBJECT_NAME	TEXT	Name des Referenzobjekts, wenn sich die Tag-Zuordnung auf das Objekt bezieht.
DOMAIN	TEXT	Domäne des Referenzobjekts (z. B. Tabelle, Ansicht), wenn sich die Tag-Zuordnung auf das Objekt bezieht. Wenn sich die Tag-Zuordnung auf eine Spalte bezieht, ist die Domäne COLUMN.
COLUMN_NAME	TEXT	Name der referenzierten Spalte; nicht anwendbar, wenn die Tag-Zuordnung keine Spalte ist.

Beispiele¶

Abrufen der Liste der mit der Tabelle my_table verbundenen Tags:

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

Copy

Abrufen der Liste der mit der Spalte result verbundenen Tags:

select *
  from table(my_db.information_schema.tag_references('my_table.result', 'COLUMN'));

Copy