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 Como agendar suas DMFs para serem executadas.
`measurement_time`	TIMESTAMP_LTZ	A hora em que a métrica é avaliada.
`table_id`	NUMBER	Identificador interno/gerado pelo sistema da tabela onde a regra está associada. As regras podem ser associadas diretamente à tabela ou a qualquer coluna da tabela.
`table_name`	VARCHAR	Nome da tabela.
`table_schema`	VARCHAR	Nome do esquema que contém a tabela.
`table_database`	VARCHAR	Nome do banco de dados que contém a tabela.
`metric_id`	NUMBER	Identificador interno/gerado pelo sistema da métrica.
`metric_name`	VARCHAR	Nome da métrica.
`metric_schema`	VARCHAR	Nome do esquema que contém a métrica.
`metric_database`	VARCHAR	Nome do banco de dados que contém a métrica.
`metric_return_type`	VARCHAR	Tipo de retorno da métrica.
`arguments_ids`	ARRAY	Uma matriz que contém IDs de argumentos de referência usados para avaliar a regra. As entradas da matriz são ordenadas pelas posições dos argumentos.
`arguments_types`	ARRAY	Uma matriz que contém tipos de argumentos de referência usados para avaliar a regra. As entradas da matriz são ordenadas pelas posições dos argumentos. Atualmente só oferece suporte aos argumentos do tipo COLUMN.
`arguments_names`	ARRAY	Uma matriz que contém nomes de argumentos de referência usados para avaliar a regra. As entradas da matriz são ordenadas pelas posições dos 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.

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