TAG_REFERENCES_WITH_LINEAGE¶

Retorna uma tabela na qual cada linha exibe uma associação entre a tag especificada e o objeto Snowflake ao qual a tag está associada.

A tag associada e o objeto Snowflake são o resultado de uma associação direta a um objeto e através de uma linhagem de tags.

Sintaxe¶

TAG_REFERENCES_WITH_LINEAGE( '<name>' )

Copy

'name'

O nome completo e qualificado da tag.

O nome totalmente qualificado deve especificar o banco de dados da tag principal e o esquema da tag no formato a seguir:

<banco_dados_tag>.<esquema_tag>.<nome_tag>

Os resultados retornam apenas para a 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 Account Usage, a sessão deve ter um esquema do Account Usage em uso. Para obter mais detalhes, consulte Account Usage.
Assim como nas exibições do Account Usage, considere a latência ao chamar esta função de tabela. A latência esperada para esta função de tabela é semelhante à latência para a exibição TAG_REFERENCES.

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_ID	NUMBER	Identificador interno/gerado pelo sistema para a tag.
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_ID	NUMBER	Identificador interno/gerado pelo sistema para o objeto.
OBJECT_NAME	TEXT	Nome do objeto referenciado, se a associação de tags estiver no objeto.
OBJECT_DELETED	TIMESTAMP_LTZ	Data e hora em que o objeto ou coluna associada foi descartado, ou se o objeto principal foi descartado.
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_ID	NUMBER	Identificador interno/gerado pelo sistema para a coluna.
COLUMN_NAME	TEXT	Nome da coluna referenciada; não aplicável se a associação de tags não for uma coluna.

Recuperar a lista de associações de tag para a tag cost_center:

select *
  from table(snowflake.account_usage.tag_references_with_lineage('my_db.my_schema.cost_center'));

Copy