- Schema:
Ansicht TAG_REFERENCES¶
Diese Account Usage-Ansicht kann verwendet werden, um die Zuordnungen zwischen Objekten und Tags zu ermitteln.
Diese Ansicht erfasst nur die direkte Beziehung zwischen dem Objekt und dem Tag. Die Tag-Herkunft ist in dieser Ansicht nicht enthalten.
Die Ansicht ist komplementär zur Information Schema-Tabellenfunktion TAG_REFERENCES.
Spalten¶
Spaltenname |
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. Beachten Sie, dass für System-Tags dieser Wert NULL ist. |
TAG_NAME |
TEXT |
Der Name des Tags. Dies ist der Wert für |
TAG_VALUE |
TEXT |
Der Wert des Tags. Dies ist der Wert für |
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 Bezeichner des referenzierten Objekts. |
OBJECT_NAME |
TEXT |
Name des referenzierten Objekts, wenn sich die Tag-Zuordnung auf das Objekt bezieht. Wenn sich die Tag-Zuordnung auf eine Spalte bezieht, gibt Snowflake den Namen der übergeordneten Tabelle zurück. |
OBJECT_DELETED |
TIMESTAMP_LTZ |
Datum und Uhrzeit der Löschung des zugeordneten Objekts oder des übergeordneten Objekts. . Weitere Informationen dazu finden Sie im Abschnitt Nutzungshinweise (unter diesem Thema). |
DOMAIN |
TEXT |
Domäne des Referenzobjekts (z. B. Tabelle, 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. Weitere Informationen dazu finden Sie unter unterstützte Domains. |
COLUMN_ID |
NUMBER |
Der lokale Bezeichner der Referenzspalte; nicht anwendbar, wenn die Tag-Zuordnung keine Spalte ist. |
COLUMN_NAME |
TEXT |
Name der referenzierten Spalte; nicht anwendbar, wenn die Tag-Zuordnung keine Spalte ist. |
Nutzungshinweise¶
Die Latenz der Ansicht kann bis zu 120 Minuten (2 Stunden) betragen.
In der Ansicht werden nur Objekte angezeigt, für die der aktuellen Rolle in der Sitzung Zugriffsrechte erteilt wurden.
Die Spalte TAG_DATABASE_ID ist in dieser Ansicht nicht enthalten. Um diesen Wert in Ihrem Abfrageergebnis zu erhalten, führen Sie eine JOIN-Operation mit dem TAGS-Ansicht durch.
Diese Spalte enthält nicht den Zeitstempel einer gelöschten Spalte, für die ein oder mehrere Tags gesetzt waren.
Eine gelöschte Spalte entsteht, wenn eines der folgenden Ereignisse eintritt:
Die Spalte wird aus der Tabelle gelöscht (d. h.
ALTER TABLE ... DROP COLUMN col_name
).Die übergeordnete Tabelle, die die Spalte enthält, wird gelöscht (d. h.
DROP TABLE name
).Das übergeordnete Schema, das die Spalte enthält, wird gelöscht (d. h.
DROP SCHEMA name
).Die übergeordnete Datenbank, die die Spalte enthält, wird gelöscht (d. h.
DROP DATABASE name
).
Beispiele¶
Geben Sie die Tag-Referenzen für Ihr Snowflake-Konto zurück:
select tag_name, tag_value, domain, object_id from snowflake.account_usage.tag_references order by tag_name, domain, object_id;
Gibt die aktiven Objekte zurück, die Tag-Zuordnungen in Ihrem Snowflake-Konto haben. Durch Hinzufügen der angegebenen WHERE-Klausel werden die Objekte gefiltert, die gelöscht wurden:
select tag_name, tag_value, domain, object_id from snowflake.account_usage.tag_references where object_deleted is null order by tag_name, domain, object_id;