Categorias:: Funções do sistema

SYSTEM$GET_TAG¶

Retorna o valor da tag associada ao objeto ou coluna Snowflake especificado. Retorna NULL se uma tag não estiver definida no objeto ou coluna Snowflake especificado.

Sintaxe¶

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

Copy

Argumentos¶

'tag_name'

O nome da tag como uma cadeia de caracteres.

O nome é o key no par chave-valor da tag. Por exemplo, na tag cost_center = 'sales', cost_center é o nome-chave da tag. Para este argumento, use 'cost_center'.

'obj_name'

O nome do objeto como uma cadeia de caracteres.

Por exemplo, se um nome de tabela for my_table, use 'my_table' como o nome do objeto.

Para especificar uma coluna, utilize o formato <nome_da_tabela>.<nome_da_coluna>. Por exemplo, my_table.revenue.

Para obter mais informações, consulte Identificadores de objetos.

'object_domain'

Domínio do objeto de referência, como uma tabela ou exibição, se a associação de tags estiver no objeto. Para colunas, o domínio é COLUMN se a associação de tags estiver em uma coluna.

Use um dos seguintes valores:

'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' (obsoleto; prefira 'BACKUP POLICY')

'SNAPSHOT SET' (obsoleto; prefira 'BACKUP SET')

'SNOWFLAKE INTELLIGENCE'

'STAGE'

'STREAM'

'TABLE': use isto para todos os objetos semelhantes a tabelas, tais como exibições, exibições materializadas e tabelas externas.

'TASK'

'USER'

'WAREHOUSE'

Notas de uso¶

O uso desta função exige o seguinte:
- Os privilégios de executar uma operação DESCRIBE <objeto> no nome do objeto especificado.
- USAGE no banco de dados e no esquema em que a tag existe.
  
  Para obter mais informações, consulte Privilégios de tag e resumo de DDL.
- IMPORTED PRIVILEGES no banco de dados SNOWFLAKE compartilhado, se você especificar uma tag de classificação do sistema.

Exemplos¶

Retorna NULL se uma tag não estiver associada ao objeto especificado:

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

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

Copy

Retorna o valor da tag para a tabela especificada. O valor da tag é o componente de cadeia de caracteres do par key = 'value' na tag:

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

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

Copy

Retorna o valor da tag para a coluna especificada:

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

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

Copy