Categorias:: Esquema LOCAL, Funções de tabela

DATA_QUALITY_MONITORING_EXPECTATION_STATUS¶

Para um objeto especificado, retorna uma linha para cada vez que uma função de métrica de dados (DMF) com uma expectativa era executada. É possível obter o status da expectativa em cada linha.

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

Sintaxe¶

DATA_QUALITY_MONITORING_EXPECTATION_STATUS(
  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 com uma expectativa é definida. O nome deve ser totalmente qualificado.

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 incluídas dentro das aspas simples, como '"table_name"'.

REF_ENTITY_DOMAIN => 'string'

O tipo de objeto no qual a função de métrica de dados com uma expectativa é 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.

Saída¶

A função retorna linhas com 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 associada ao DMF.
`table_name`	VARCHAR	Nome da tabela associada ao DMF.
`table_schema`	VARCHAR	Nome do esquema que contém a tabela associada ao DMF.
`table_database`	VARCHAR	Nome do banco de dados com a tabela associada ao DMF.
`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. 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.
`expectation_name`	VARCHAR	Nome que foi dado à expectativa quando foi adicionada à associação entre a DMF e o objeto.
`expectation_id`	VARCHAR	Identificador gerado pelo sistema.
`expectation_expression`	VARCHAR	Expressão booleana da expectativa. Consulte Definição do que atende à expectativa.
`expectation_violated`	BOOLEAN	Se for TRUE, a expectativa foi violada. Uma expectativa é violada quando `expectation_expression` é avaliada como FALSE. Um valor NULL indica que a avaliação da expectativa falhou.

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.

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

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 objetos sem suporte especificados no argumento REF_ENTITY_DOMAIN, como 'STREAM', também retornam erros.

Exemplos¶

Retornar uma linha para cada função de métrica de dados com uma expectativa atribuída à tabela chamada my_table:

SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_EXPECTATION_STATUS(
    REF_ENTITY_NAME => 'my_db.sch1.my_table',
    REF_ENTITY_DOMAIN => 'TABLE'));

Copy