Kategorien:: Systemfunktionen

SYSTEM$GET_TAG¶

Gibt den Tag-Wert zurück, der mit dem angegebenen Snowflake-Objekt oder der Spalte verbunden ist. Gibt NULL zurück, wenn für das angegebene Snowflake-Objekt oder die angegebene Spalte kein Tag gesetzt ist.

Syntax¶

SYSTEM$GET_TAG( '<tag_name>' , '<obj_name>' , '<obj_domain>' )

Argumente¶

'tag_name'

Der Name des Tags in Form einer Zeichenfolge.

Der Name ist der Wert für key im Schlüssel-Wert-Paar des Tags. Im Tag cost_center = 'sales' zum Beispiel ist cost_center der Schlüsselname des Tags. Für dieses Argument ist 'cost_center' zu verwenden.

'obj_name'

Der Name des Objekts in Form einer Zeichenfolge.

Wenn ein Tabellenname zum Beispiel my_table lautet, verwenden Sie 'my_table' als Namen des Objekts.

Um eine Spalte anzugeben, verwenden Sie das Format <Tabellenname>.<Spaltenname>. Beispiel: my_table.revenue.

Weitere Informationen dazu finden Sie unter Objektbezeichner.

'object_domain'

Domäne des Referenzobjekts, wie eine Tabelle oder 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.

Verwenden Sie einen der folgenden Werte:

'ACCOUNT'

'ALERT'

'BACKUP POLICY'

'BACKUP SET'

'COLUMN'

'COMPUTE POOL'

'CORTEX AGENT'

'DATABASE'

'DATABASE ROLE'

'FAILOVER GROUP'

'FUNCTION'

'INTEGRATION'

'INSTANCE'

'NETWORK POLICY'

'PROCEDURE'

'REPLICATION GROUP'

'ROLE'

'SCHEMA'

'SHARE'

'SNAPSHOT POLICY' (veraltet; besser 'BACKUP POLICY')

'SNAPSHOT SET' (veraltet; besser 'BACKUP SET')

'SNOWFLAKE INTELLIGENCE'

'STAGE'

'STREAM'

'TABLE': Verwenden Sie dies für alle tabellenähnlichen Objekte wie Ansichten, materialisierte Ansichten und externe Tabellen.

'TASK'

'USER'

'WAREHOUSE'

Nutzungshinweise¶

Die Verwendung dieser Funktion erfordert:
- Die Berechtigung zum Ausführen einer DESCRIBE <Objekt>-Operation auf dem angegebenen Objektnamen.
- USAGE über die Datenbank und das Schema, in denen sich das Tag befindet.
  
  Weitere Informationen dazu finden Sie unter Tag-Berechtigung & DDL-Übersicht.
- IMPORTED PRIVILEGES für die freigegebene SNOWFLAKE-Datenbank, wenn Sie ein Systemklassifizierungs-Tag angeben.

Beispiele¶

Gibt NULL zurück, wenn für das angegebene Objekt kein Tag gesetzt ist:

select system$get_tag('cost_center', 'my_table', 'table');

+-----------------------------------------------------+
| SYSTEM$GET_TAG('COST_CENTER', 'MY_TABLE', 'TABLE')  |
+-----------------------------------------------------+
| NULL                                                |
+-----------------------------------------------------+

Gibt den Tag-Wert für die angegebene Tabelle zurück. Der Tag-Wert ist die Zeichenfolgenkomponente des key = 'value'-Paares im Tag:

select system$get_tag('cost_center', 'my_table', 'table');

-----------------------------------------------------+
| SYSTEM$GET_TAG('COST_CENTER', 'MY_TABLE', 'TABLE') |
+----------------------------------------------------+
| sales                                              |
+----------------------------------------------------+

Gibt den Tag-Wert für die angegebene Spalte zurück:

select system$get_tag('fiscal_quarter', 'my_table.revenue', 'column');

+----------------------------------------------------------------+
| SYSTEM$GET_TAG('FISCAL_QUARTER', 'MY_TABLE.REVENUE', 'COLUMN') |
+----------------------------------------------------------------+
| Q1                                                             |
+----------------------------------------------------------------+