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