Categorias:: Funções do sistema, Funções de tabela

SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS¶

Retorna as expectativas de associações entre funções de métricas de dados (DMFs) e uma tabela, incluindo se uma expectativa está sendo violada.

Sintaxe¶

SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS(
  REF_ENTITY_NAME  => '<object>'
  [ , SKIP_SUSPENDED_DMF => { TRUE | FALSE } ] )

Copy

Argumentos¶

REF_ENTITY_NAME => 'object'

Nome da tabela ou exibição que tem pelo menos uma DMF com uma ou mais expectativas. Deve ser totalmente qualificado.

SKIP_SUSPENDED_DMF => { TRUE | FALSE }

Se definido como TRUE, a função não retorna expectativas definidas para associações entre o object e as DMFs suspensas. Uma DMF suspensa não é executada no cronograma especificado do objeto.

Padrão: TRUE

Retornos¶

Retorna uma tabela com as seguintes colunas:

Coluna	Tipo de dados	Descrição
`metric_database`	VARCHAR	Nome do banco de dados que contém a DMF.
`metric_schema`	VARCHAR	Nome do esquema que contém a DMF.
`metric_name`	VARCHAR	Nome do DMF.
`expectation_name`	VARCHAR	Nome que o usuário atribuiu à expectativa ao adicioná-la à associação entre a DMF e a tabela.
`expectation_id`	NUMBER	Identificador gerado pelo sistema.
`expectation_expression`	VARCHAR	Expressão booleana da expectativa. Consulte Definição do que atende à expectativa.
`arguments`	ARRAY	Colunas com as quais a DMF está associada.
`value`	VARIANT	O resultado da avaliação da DMF.
`expectation_violated`	BOOLEAN	Se for TRUE, a expectativa foi violada. Uma expectativa é violada quando `expectation_expression` é avaliada como FALSE.

Privilégios de controle de acesso¶

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio	Objeto	Notas
SELECT	Tabela ou exibição
USAGE	Função de métricas de dados (DMF)

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

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Exemplo¶

Retornar as expectativas das associações entre DMFs AND tabela t1. As DMFs são executadas para determinar se as expectativas estão sendo violadas no momento.

SELECT *
  FROM TABLE(SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS(
      REF_ENTITY_NAME => 'my_db.sch.t1'));

Copy