Categorias:: LOCAL, Funções de tabela

DATA_QUALITY_MONITORING_RESULTS¶

Retorna uma linha para cada função de métrica de dados atribuída ao objeto especificado, que inclui o resultado da avaliação e outros metadados da função de métrica de dados no objeto.

Consulte também:: Exibição DATA_QUALITY_MONITORING_RESULTS (exibição LOCAL)

Sintaxe¶

DATA_QUALITY_MONITORING_RESULTS(
  REF_ENTITY_NAME => '<string>' ,
  REF_ENTITY_DOMAIN => '<string>'
  )

Copy

Argumentos¶

REF_ENTITY_NAME => 'string'

O nome do objeto de tabela no qual a função de métrica de dados é definida.

O nome completo do objeto deve ser delimitado por aspas simples.
Se o nome da objeto diferenciar letras maiúsculas e minúsculas ou incluir quaisquer caracteres ou espaços especiais, as aspas duplas são necessárias para processar o caso/caracteres. As aspas duplas devem ser colocadas dentro de aspas simples, como '"<table_name>"'.

REF_ENTITY_DOMAIN => 'string'

O tipo de objeto no qual a função de métrica de dados é definida.

Se o objeto for um tipo de tabela, use 'TABLE' como valor do argumento.

Se o objeto for uma exibição ou exibição materializada, use 'VIEW' como valor do argumento.

Para obter uma lista de tipos de objeto compatíveis nos quais uma função de métrica de dados pode ser definida, consulte Tipos de tabela aceitos.

Retornos¶

A função retorna as seguintes colunas:

Nome da coluna	Tipo de dados	Descrição
`scheduled_time`	TIMESTAMP_LTZ	A hora do agendamento da execução da DMF com base no cronograma que você definiu para a tabela ou exibição.
`change_commit_time`	TIMESTAMP_LTZ	A hora em que a operação de acionamento da DMF ocorreu, ou `None` se a DMF não estiver programada para ser executada por uma operação de acionamento. Para obter informações sobre a operação do acionador, consulte Programe a execução da DMF.
`measurement_time`	TIMESTAMP_LTZ	O horário em que a métrica foi avaliada.
`table_id`	NUMBER	Identificador interno/gerado pelo sistema da tabela à qual a DMF está associada.
`table_name`	VARCHAR	Nome da tabela à qual a DMF está associada.
`table_schema`	VARCHAR	Nome do esquema que contém a tabela à qual a DMF está associada.
`table_database`	VARCHAR	Nome do banco de dados que contém a tabela à qual a DMF está associada.
`metric_id`	NUMBER	Identificador interno/gerado pelo sistema da DMF.
`metric_name`	VARCHAR	Nome do DMF.
`metric_schema`	VARCHAR	Nome do esquema que contém a DMF.
`metric_database`	VARCHAR	Nome do banco de dados que contém a DMF.
`metric_return_type`	VARCHAR	Tipo de retorno da DMF.
`arguments_ids`	ARRAY	Matriz dos identificadores dos argumentos da DMF. Os elementos da matriz estão na mesma ordem que os argumentos.
`arguments_types`	ARRAY	Matriz do domínio/tipo de cada argumento da DMF. Os elementos da matriz estão na mesma ordem que os argumentos. Atualmente só oferece suporte aos argumentos do tipo COLUMN.
`arguments_names`	ARRAY	Matriz dos nomes dos argumentos da DMF. Para argumentos de coluna, cada elemento é o nome de uma coluna. Os elementos da matriz estão na mesma ordem que os argumentos.
`reference_id`	VARCHAR	O ID para identificar exclusivamente a referência da entidade métrica, conhecida como ID de associação.
`value`	VARIANT	O resultado da avaliação da DMF.

Requisitos de controle de acesso¶

Para acessar esta função, a função em uso deve ter a função de aplicativo SNOWFLAKE.DATA_QUALITY_MONITORING_LOOKUP, no mínimo. Para outras opções de função de aplicativo, consulte Gerenciar o acesso aos resultados de DMF. Use o comando GRANT APPLICATION ROLE para conceder a função de aplicativo a uma função.

Para exibir os resultados, a função em uso também deve ter os seguintes privilégios:

Os privilégios SELECT ou OWNERSHIP no objeto (tabela ou exibição) ao qual a função de métrica de dados é atribuída.
Os privilégios USAGE ou OWNERSHIP na função de métrica de dados.

Notas de uso¶

Ocorrerão erros se o nome do objeto especificado não existir ou se o operador de consulta não estiver autorizado a exibir nenhuma função de métrica de dados no objeto. Tipos de objeto não compatíveis listados como REF_ENTITY_DOMAIN, como 'stream', também retornam erros.

Exemplos¶

Retorna uma linha para cada função de métrica de dados atribuída à tabela nomeada my_table:

USE DATABASE SNOWFLAKE;
USE SCHEMA LOCAL;
SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_RESULTS(
    REF_ENTITY_NAME => 'my_db.my_schema.my_table',
    REF_ENTITY_DOMAIN => 'table'));

Copy