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>' )
Copy

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'

  • 'COLUMN'

  • 'DATABASE'

  • 'DATABASE ROLE'

  • 'FUNCTION'

  • 'INTEGRATION'

  • 'NETWORK POLICY'

  • 'PROCEDURE'

  • 'ROLE'

  • 'SCHEMA'

  • 'SHARE'

  • '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:

    • Berechtigungen zum Ausführen einer DESCRIBE <Objekt>-Operation auf dem angegebenen Objektnamen.

    • USAGE für 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 System-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                                                |
+-----------------------------------------------------+
Copy

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                                              |
+----------------------------------------------------+
Copy

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                                                             |
+----------------------------------------------------------------+
Copy