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, como uma tabela ou exibiçã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'

  • 'ALERT'

  • 'COLUMN'

  • 'DATABASE'

  • 'DATABASE ROLE'

  • 'FUNCTION'

  • 'INTEGRATION'

  • 'NETWORK POLICY'

  • 'PROCEDURE'

  • 'ROLE'

  • 'SCHEMA'

  • 'SHARE'

  • 'STAGE'

  • 'STREAM'

  • 'TABLE': use isto para todos os objetos semelhantes a tabelas, tais como exibições, exibições materializadas e tabelas externas.

  • 'TASK'

  • 'USER'

  • 'WAREHOUSE'

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