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

Copy

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'));

Copy

Recuperar a lista de tags associadas na coluna result:

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

Copy