Categorias:: Information Schema , Funções de tabela

TAG_REFERENCES_ALL_COLUMNS¶

Retorna uma tabela na qual cada linha exibe o nome e o valor da tag atribuídos a uma coluna específica.

Esta função retorna cada conjunto de tags em cada coluna de uma determinada tabela ou exibição, quer a tag seja atribuída diretamente a uma coluna ou por meio de uma herança de tag.

Sintaxe¶

TAG_REFERENCES_ALL_COLUMNS( '<object_name>' , '<object_domain>' )

Copy

Argumentos¶

'object_name'

Nome do objeto referenciado, se a associação de tags estiver no objeto.

Este argumento oferece suporte aos nomes das tabelas e exibições.

'object_domain'

Domínio do objeto referenciado.

O Snowflake oferece suporte a um domínio para esta função: TABLE.

Observe que o domínio TABLE precisa ser usado para todos os objetos que contêm colunas, mesmo que o nome do objeto seja uma exibição (ou seja, exibição, exibição materializada).

Notas de uso¶

Os resultados retornam apenas para uma função que tem acesso ao objeto especificado.

To view references for system tags associated with sensitive data classification, use a role with IMPORTED PRIVILEGES on the shared SNOWFLAKE database.
Ao chamar uma função de tabela do Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou a função deve usar o nome do objeto totalmente qualificado. Para obter mais detalhes, consulte Snowflake Information Schema.

Saída¶

A função retorna as seguintes colunas:

Coluna	Tipo de dados	Descrição
TAG_DATABASE	TEXT	O banco de dados no qual a tag é definida.
TAG_SCHEMA	TEXT	O esquema no qual a tag é definida.
TAG_NAME	TEXT	O nome da tag. Este é o `key` no par `key = 'value'` da tag.
TAG_VALUE	TEXT	O valor da tag. Este é o `'value'` no par `key = 'value'` da tag.
APPLY_METHOD	TEXT	Especifica como a tag foi atribuída ao objeto. Os valores possíveis incluem o seguinte: `CLASSIFIED`: a tag foi aplicada automaticamente a uma coluna que foi classificada como contendo dados confidenciais. Consulte Sobre o mapeamento de tags. `INHERITED`: o objeto herdou a tag de um objeto mais acima na hierarquia de objetos securizáveis do Snowflake. Consulte Herança de tag. `MANUAL`: alguém definiu manualmente a tag no objeto usando um comando CREATE <objeto> ou ALTER <objeto>. Consulte Defina uma tag. `PROPAGATED`: a tag foi automaticamente propagada de um objeto para outro. Consulte Propagação automática de tags com tags definidas pelo usuário. `NULL`: registro de legado. `NONE`: registro de legado.
LEVEL	TEXT	O domínio do objeto no qual a tag é definida.
OBJECT_DATABASE	TEXT	O nome do banco de dados que contém a tabela ou exibição.
OBJECT_SCHEMA	TEXT	O nome do esquema que contém a tabela ou exibição.
OBJECT_NAME	TEXT	O nome da tabela ou exibição.
DOMAIN	TEXT	Este valor deve ser `COLUMN` já que esta função retorna todas as tags definidas em todas as colunas da tabela ou exibição.
COLUMN_NAME	TEXT	O nome da coluna em que a tag está colocada.

Exemplos¶

Recuperar a lista de tags que são atribuídas a cada coluna da tabela my_table:

select *
  from table(my_db.information_schema.tag_references_all_columns('my_table', 'table'));

Copy