Kategorien:: Account Usage-Tabellenfunktionen, Tabellenfunktionen

TAG_REFERENCES_WITH_LINEAGE¶

Gibt eine Tabelle zurück, in der jede Zeile eine Zuordnung zwischen dem angegebenen Tag und dem Snowflake-Objekt anzeigt, dem das Tag zugeordnet ist.

Die Zuordnung von Tag und Snowflake-Objekt kann sich sowohl aus einer direkten Verknüpfung mit einem Objekt als auch aus der Tag-Herkunft ergeben.

Syntax¶

TAG_REFERENCES_WITH_LINEAGE( '<name>' )

Copy

Argumente¶

'name'

Der vollqualifizierte Name des Tags.

Der vollqualifizierte Name muss die übergeordnete Tag-Datenbank und das Tag-Schema des Tags im folgenden Format angeben:

<Tag-Datenbank>.<Tag-Schema>.<Tag-Name>

Nutzungshinweise¶

Es werden nur Ergebnisse für die 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.
Wenn Sie eine Account Usage-Tabellenfunktion aufrufen, muss in der Sitzung ein aktives Account Usage-Schema verwendet werden. Weitere Details dazu finden Sie unter Account Usage.
Ähnlich wie bei den Account Usage-Ansichten müssen Sie auch beim Aufruf dieser Tabellenfunktion die Latenz berücksichtigen. Die erwartete Latenz für diese Tabellenfunktion ist ähnlich der Latenz für die Ansicht TAG_REFERENCES.

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_ID	NUMBER	Interner/vom System generierter Bezeichner für das Tag.
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_ID	NUMBER	Interner/vom System generierter Bezeichner für das Objekt.
OBJECT_NAME	TEXT	Name des referenzierten Objekts, wenn sich die Tag-Zuordnung auf das Objekt bezieht.
OBJECT_DELETED	TIMESTAMP_LTZ	Datum und Uhrzeit der Löschung des zugeordneten Objekts oder der zugeordneten Spalte, falls das übergeordnete Objekt gelöscht wurde.
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_ID	NUMBER	Interner/vom System generierter Bezeichner für die Spalte.
COLUMN_NAME	TEXT	Name der referenzierten Spalte; nicht anwendbar, wenn die Tag-Zuordnung keine Spalte ist.

Beispiele¶

Rufen Sie die Liste der Tag-Zuordnungen für das cost_center-Tag ab:

select *
  from table(snowflake.account_usage.tag_references_with_lineage('my_db.my_schema.cost_center'));

Copy