Esquema:: ORGANIZATION_USAGE

Exibição TAG_REFERENCES¶

Importante

Essa exibição só está disponível na conta da organização. Para obter mais informações, consulte Exibições premium na conta da organização.

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

Essa exibição registra apenas o relacionamento direto entre o objeto e a tag. A herança da tag não está incluída nessa exibição.

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

Colunas¶

Colunas em nível de organização

Nome da coluna	Tipo de dados	Descrição
ORGANIZATION_NAME	VARCHAR	Nome da organização.
ACCOUNT_LOCATOR	VARCHAR	Identificador gerado pelo sistema para a conta.
ACCOUNT_NAME	VARCHAR	Identificador definido pelo usuário para a conta.

Colunas adicionais

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 as Notas de uso.
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.
APPLY_METHOD	TEXT	Especifica como a tag foi atribuída ao objeto. Os valores possíveis incluem o seguinte: `CLASSIFIED`: a tag foi aplicada automaticamente a uma coluna que foi classificada como contendo dados confidenciais. Consulte Sobre o mapeamento de tags. `INHERITED`: o objeto herdou a tag de um objeto mais acima na hierarquia de objetos securizáveis do Snowflake. Consulte Herança de tag. `MANUAL`: alguém definiu manualmente a tag no objeto usando um comando CREATE <objeto> ou ALTER <objeto>. Consulte Defina uma tag. `PROPAGATED`: a tag estava se propagando automaticamente de um objeto para outro. Consulte Propagação automática de tags com tags definidas pelo usuário. `NULL`: registro de legado. `NONE`: registro de legado.

Notas de uso¶

A latência da exibição pode ser de até 24 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 account_name, tag_name, tag_value, domain, object_id
from snowflake.organization_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 account_name, tag_name, tag_value, domain, object_id
from snowflake.organization_usage.tag_references
where object_deleted is null
order by tag_name, domain, object_id;

Copy