Kategorien:: Systemfunktionen, Tabellenfunktionen

SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS¶

Gibt die Erwartungen für Zuordnungen zwischen Datenmetrikfunktionen (DMFs) und einer Tabelle zurück, einschließlich der Angabe, ob derzeit gegen eine Erwartung verstoßen wird.

Syntax¶

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

Copy

Argumente¶

REF_ENTITY_NAME => 'object'

Name der Tabelle oder Ansicht, die mindestens eine DMF mit einer oder mehreren Erwartungen hat. Muss vollqualifiziert sein.

SKIP_SUSPENDED_DMF => { TRUE | FALSE }

Wenn auf TRUE gesetzt, gibt die Funktion keine Erwartungen zurück, die für Zuordnungen zwischen dem object und ausgesetzten DMFs definiert sind. Ein ausgesetztes DMF wird nicht nach dem angegebenen Zeitplan des Objekts ausgeführt.

Standard: TRUE

Rückgabewerte¶

Gibt eine Tabelle mit den folgenden Spalten zurück:

Spalte	Datentyp	Beschreibung
`metric_database`	VARCHAR	Name der Datenbank, die die DMF enthält.
`metric_schema`	VARCHAR	Name des Schemas, das die DMF enthält.
`metric_name`	VARCHAR	Name der DMF.
`expectation_name`	VARCHAR	Name, den der Benutzer die Erwartung zugewiesen hat, als er sie der Zuordnung zwischen dem DMF und der Tabelle hinzugefügt hat.
`expectation_id`	NUMBER	Vom System generierter Bezeichner.
`expectation_expression`	VARCHAR	Boolescher Ausdruck der Erwartung. Siehe Definieren, was die Erwartung erfüllt.
`arguments`	ARRAY	Spalten, mit denen das DMF zugeordnet wird.
`value`	VARIANT	Das Ergebnis der DMF-Bewertung.
`expectation_violated`	BOOLEAN	Wenn TRUE, dann wurde gegen die Erwartung verstoßen. Gegen eine Erwartung wird verstoßen, wenn die `expectation_expression` den Wert FALSE ergibt.

Zugriffssteuerungsrechte¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung	Objekt	Anmerkungen
SELECT	Tabelle oder Ansicht
USAGE	Datenmetrikfunktion (DMF)

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Beispiel¶

Gibt die Erwartungen für die Zuordnungen zwischen DMFs AND Tabelle t1 zurück. Die DMFs werden ausgeführt, um festzustellen, ob derzeit gegen die Erwartungen verstoßen wird.

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

Copy