Esquema:

ACCOUNT_USAGE

Exibição TAG_REFERENCES

Esta exibição do Account Usage pode ser usada para identificar as associações entre objetos e tags.

Esta exibição registra apenas a relação direta entre o objeto e a tag. A linhagem de tags não está incluída nesta exibição.

A exibição complementa a função de tabela do Information Schema TAG_REFERENCES.

Colunas

Nome da 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_ID

NUMBER

Identificador interno/gerado pelo sistema para a tag. Observe que para tags de sistema este valor é NULL.

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.

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_ID

NUMBER

Identificador interno do objeto referenciado.

OBJECT_NAME

TEXT

Nome do objeto referenciado, se a associação de tags estiver no objeto. Se a associação de tags estiver em uma coluna, o Snowflake retorna o nome da tabela principal.

OBJECT_DELETED

TIMESTAMP_LTZ

Data e hora em que o objeto associado foi descartado, ou se o objeto pai foi descartado. . Para obter mais informações, consulte a seção Notas de uso (neste tópico).

DOMAIN

TEXT

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. Para obter mais informações, consulte os domínios suportados.

COLUMN_ID

NUMBER

O identificador local da coluna de referência; não se aplica se a associação de tags não for uma coluna.

COLUMN_NAME

TEXT

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

Notas de uso

  • A latência da visualização pode ser de até 120 minutos (2 horas).

  • A visualização exibe apenas objetos para os quais a função atual da sessão tem privilégios de acesso.

  • A coluna TAG_DATABASE_ID não está incluída nesta exibição. Para obter este valor no resultado de sua consulta, realize uma operação JOIN com o Exibição TAGS.

  • Esta coluna não inclui o carimbo de data/hora para uma coluna excluída que tinha uma ou mais tags definidas na coluna excluída.

    Para referência, uma coluna eliminada resulta quando um dos seguintes eventos ocorre:

    • A coluna é removida da tabela (isto é, ALTER TABLE ... DROP COLUMN col_name), ou

    • A tabela pai contendo a coluna é removida (isto é, DROP TABLE name), ou

    • O esquema pai que contém a coluna é removido (isto é, DROP SCHEMA name), ou

    • O banco de dados principal contendo a coluna é removido (isto é, DROP DATABASE name).

Exemplos

Retornar as referências da tag para sua conta Snowflake:

select tag_name, tag_value, domain, object_id
from snowflake.account_usage.tag_references
order by tag_name, domain, object_id;
Copy

Retorna os objetos ativos que possuem associações de tags em sua conta Snowflake. A adição da cláusula WHERE especificada filtra os objetos que são excluídos mas ainda não purgados do sistema:

select tag_name, tag_value, domain, object_id
from snowflake.account_usage.tag_references
where object_deleted is null
order by tag_name, domain, object_id;
Copy