Schema:: ORGANIZATION_USAGE

Ansicht TAG_REFERENCES¶

Wichtig

Diese Ansicht ist nur im Organisationskonto verfügbar. Weitere Informationen dazu finden Sie unter Premium-Ansichten im Organisationskonto.

Diese Organization 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-Vererbung ist in dieser Ansicht nicht enthalten.

Die Ansicht ist komplementär zur Information Schema-Tabellenfunktion TAG_REFERENCES.

Spalten¶

Spalten auf Organisationsebene

Spaltenname	Datentyp	Beschreibung
ORGANIZATION_NAME	VARCHAR	Name der Organisation.
ACCOUNT_LOCATOR	VARCHAR	Vom System generierter Bezeichner für das Konto.
ACCOUNT_NAME	VARCHAR	Benutzerdefinierter Bezeichner für das Konto.

Zusätzliche 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 `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.
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 finden Sie in den Nutzungshinweisen.
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.
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.

Nutzungshinweise¶

Die Latenzzeit der Ansicht kann bis zu 24 Stunden betragen.

In der Ansicht werden nur Objekte angezeigt, für die der aktuellen Rolle in der Sitzung Zugriffsrechte gewährt 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 Ansicht TAGS 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 account_name, tag_name, tag_value, domain, object_id
from snowflake.organization_usage.tag_references
order by tag_name, domain, object_id;

Copy

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 account_name, tag_name, tag_value, domain, object_id
from snowflake.organization_usage.tag_references
where object_deleted is null
order by tag_name, domain, object_id;

Copy