Catégories :: Fonctions système, Fonctions de table

SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS¶

Renvoie les conditions pour les associations entre les fonctions de métrique des données (DMFs) et un tableau, y compris si une condition n’est pas actuellement respectée.

Syntaxe¶

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

Copy

Arguments¶

REF_ENTITY_NAME => 'object'

Nom de la table ou de la vue qui comporte au moins une DMF avec une ou plusieurs conditions. Doit être entièrement qualifié.

SKIP_SUSPENDED_DMF => { TRUE | FALSE }

Si défini sur TRUE, la fonction ne renvoie pas les attentes qui sont définies pour les associations entre l”object et les DMFs suspendues. Une DMF suspendue ne s’exécute pas selon la planification spécifiée de l’objet.

Par défaut : TRUE

Renvoie¶

Renvoie une table avec les colonnes suivantes :

Colonne	Type de données	Description
`metric_database`	VARCHAR	Nom de la base de données qui contient la DMF.
`metric_schema`	VARCHAR	Nom du schéma qui contient la DMF.
`metric_name`	VARCHAR	Nom de l’DMF.
`expectation_name`	VARCHAR	Nom que l’utilisateur a attribué à la condition lors de son ajout à l’association entre la DMF et la table.
`expectation_id`	NUMBER	Identificateur généré par le système.
`expectation_expression`	VARCHAR	Expression booléenne de la condition. Voir Définir ce qui répond à l’attente.
`arguments`	ARRAY	Colonnes avec lesquelles la DMF est associée.
`value`	VARIANT	Le résultat de l’évaluation de la DMF.
`expectation_violated`	BOOLEAN	Si TRUE, la condition n’a pas été respectée. Une condition est considérée comme non respectée lorsque l”`expectation_expression` renvoie la valeur FALSE.

Privilèges de contrôle d’accès¶

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège	Objet	Remarques
SELECT	Table ou vue
USAGE	Fonction de métrique des données (DMF)

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Exemple¶

Renvoyer les conditions pour les associations entre les DMFs AND la table t1. Les DMFs sont exécutées pour déterminer si les conditions ne sont pas actuellement respectées.

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

Copy