Categorias:: Funções de tabela Account Usage , Funções de tabela

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 da herança da tag.

Sintaxe¶

TAG_REFERENCES_WITH_LINEAGE( '<name>' )

Copy

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:

<tag_database>.<tag_schema>.<tag_name>

Notas de uso¶

Os resultados retornam apenas para a função que tem acesso ao objeto especificado.
Essa função não é compatível com tags de sistema usadas por classificação de dados confidenciais.
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 `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.
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 foi automaticamente propagada 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.

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'));

Copy

Nota

O nome da tag deve ser escrito em letras maiúsculas.