Categorias:

Information Schema , Funções de tabela

TAG_REFERENCES

Retorna uma tabela na qual cada linha exibe uma associação entre uma tag e um valor.

A tag e o valor associados são o resultado de uma associação direta a um objeto ou através de uma linhagem de tags.

Sintaxe

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

Argumentos

'object_name'

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

'object_domain'

Domínio do objeto de referência (por exemplo, tabela, visualizaçã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 | INTEGRATION | ROLE | SHARE | USER | WAREHOUSE | DATABASE | SCHEMA | PROCEDURE | STAGE | STREAM | TABLE | TASK | COLUMN

Observe que o valor de domínio de TABLE deve ser usado para todos os objetos semelhantes a tabelas, tais como exibições, exibições materializadas e tabelas externas.

Notas de uso

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

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

LEVEL

TEXT

O domínio do objeto no qual a tag é definida.

OBJECT_DATABASE

TEXT

Nome do banco de dados do objeto referenciado para os objetos do banco de dados e do esquema. Se o objeto não for um objeto de banco de dados ou esquema, ele será vazio.

OBJECT_SCHEMA

TEXT

Nome do esquema do objeto referenciado (para objetos de esquema). Se o objeto referenciado não for um objeto de esquema (por exemplo, warehouse), este valor será vazio.

OBJECT_NAME

TEXT

Nome do objeto de referência se a associação de tags estiver sobre o objeto.

DOMAIN

TEXT

Domínio do objeto de referência (por exemplo, tabela, visualização) se a associação de tags estiver no objeto. Se a associação de tags estiver em uma coluna, o domínio é COLUMN.

COLUMN_NAME

TEXT

Nome da coluna referenciada; não aplicável se a associação de tags não for uma coluna.

Exemplos

Recuperar a lista de tags associadas à tabela my_table:

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

Recuperar a lista de tags associadas na coluna result:

select *
  from table(my_db.information_schema.tag_references('my_table.result', 'COLUMN'));