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'

  • 'COLUMN'

  • 'DATABASE'

  • 'DATABASE ROLE'

  • 'FUNCTION'

  • 'INTEGRATION'

  • 'NETWORK POLICY'

  • 'PROCEDURE'

  • 'ROLE'

  • 'SCHEMA'

  • 'SHARE'

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