Categorias:: Funções do sistema

SYSTEM$GET_TAG_ON_CURRENT_TABLE¶

Retorna o valor de tag da cadeia de caracteres atribuída à tabela com base na tag especificada, ou NULL se uma tag não for atribuída à tabela especificada.

Use esta função nas condições da política de mascaramento ou nas condições da política de acesso a linhas.

Sintaxe¶

SYSTEM$GET_TAG_ON_CURRENT_TABLE( '<tag_name>' )

Copy

Argumentos¶

'tag_name'

Identificador para a tag como uma cadeia de caracteres.

Por exemplo, se a tag for chamada cost_center, use 'cost_center' como argumento.

Notas de uso¶

Atualmente, esta função só pode ser usada em uma política de mascaramento ou condição de política de acesso a linhas para avaliar dinamicamente o valor da cadeia de caracteres de tags definida em uma tabela.

O Snowflake retorna um erro ao utilizar a função em uma consulta SELECT, exibição, exibição materializada ou uma função definida pelo usuário (UDF).
Note que esta função se aplica a todos os objetos em forma de tabela (por exemplo, exibições).
A tag deve existir ao chamar esta função do sistema; caso contrário, Snowflake retorna a seguinte mensagem de erro:
```
Tag '<tag_name>' does not exist or not authorized.
```
Copy

Exemplos¶

Para obter um exemplo contextual sobre como utilizar esta função, consulte Exemplo 3: proteção de uma tabela com base no valor da cadeia de caracteres da tag da tabela.