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