- Categorias:
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 |
TAG_VALUE |
TEXT |
O valor da tag. Este é o |
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'));