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:

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