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.

Para visualizar referências para tags do sistema, use uma função com IMPORTED PRIVILEGES no banco de dados SNOWFLAKE compartilhado.
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