- Kategorien:
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 Tagcost_center = 'sales'
zum Beispiel istcost_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 | +-----------------------------------------------------+
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 | +----------------------------------------------------------------+