Schema:

ACCOUNT_USAGE

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 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 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;
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, aber noch nicht aus dem System bereinigt 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;
Copy