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.

'obj_domain'

Die Domäne des Objekts (z. B. TABLE, WAREHOUSE) als Zeichenfolge. Wenn ein Tag einer Tabellen- oder Ansichtsspalte zugewiesen ist, dann ist COLUMN die Domäne.

Verwenden Sie einen der folgenden Werte:

ACCOUNT | INTEGRATION | ROLE | SHARE | USER | WAREHOUSE | DATABASE | SCHEMA | PROCEDURE | STAGE | STREAM | TABLE | TASK | COLUMN

Beachten Sie, dass der Domänenwert von TABLE für alle tabellenähnlichen Objekte wie Ansichten, materialisierte Ansichten und externe Tabellen verwendet werden sollte.

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.

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