- Categorias:
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>' )
Argumentos¶
'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>
Notas de uso¶
Os resultados retornam apenas para a função que tem acesso ao objeto especificado.
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.
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_ID |
NUMBER |
Identificador interno/gerado pelo sistema para a tag. |
TAG_NAME |
TEXT |
O nome da tag. Este é o |
TAG_VALUE |
TEXT |
O valor da tag. Este é o |
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. |
Exemplos¶
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'));