Kategorien:: LOCAL-Schema, Tabellenfunktionen

DATA_QUALITY_MONITORING_EXPECTATION_STATUS¶

Gibt für ein bestimmtes Objekt immer dann eine Zeile zurück, wenn eine Datenmetrikfunktion (DMF) mit einer Erwartung ausgeführt wurde. Sie können den Status der Erwartung in jeder Zeile einholen.

Siehe auch:: Ansicht DATA_QUALITY_MONITORING_EXPECTATION_STATUS (LOCAL Ansicht)

Syntax¶

DATA_QUALITY_MONITORING_EXPECTATION_STATUS(
  REF_ENTITY_NAME => '<string>' ,
  REF_ENTITY_DOMAIN => '<string>'
  )

Copy

Argumente¶

REF_ENTITY_NAME => 'string'

Der Name des Tabellenobjekts, auf das die Datenmetrikfunktion mit einer Erwartung eingestellt ist. Der Name muss vollqualifiziert sein.

Der gesamte Objektname muss in einfache Anführungszeichen gesetzt werden.
Wenn der Objektname zwischen Groß- und Kleinschreibung unterscheidet bzw. Sonderzeichen oder Leerzeichen enthält, sind doppelte Anführungszeichen erforderlich, damit sich Groß-/Kleinschreibung und Zeichen korrekt verarbeiten lassen. Die doppelten Anführungszeichen müssen in einfache Anführungszeichen eingeschlossen werden, d. h. '"table_name"'.

REF_ENTITY_DOMAIN => 'string'

Der Objekttyp, auf den die Datenmetrikfunktion mit einer Erwartung festgelegt ist.

Wenn das Objekt um eine Art Tabelle ist, verwenden Sie 'TABLE' als Argumentwert.

Wenn das Objekt um eine Ansicht oder materialisierte Ansicht ist, verwenden Sie 'VIEW' als Argumentwert.

Eine Liste der unterstützten Objekttypen, für die eine Datenmetrikfunktion eingestellt werden können, finden Sie unter Unterstützte Tabellenarten.

Ausgabe¶

Die Funktion gibt Zeilen mit den folgenden Spalten zurück:

Spaltenname	Datentyp	Beschreibung
`scheduled_time`	TIMESTAMP_LTZ	Geplanter Ausführungszeitpunkt der DMF basierend auf dem Zeitplan, den Sie für die Tabelle oder Ansicht festgelegt haben.
`change_commit_time`	TIMESTAMP_LTZ	Zeitpunkt, zu dem die DMF-Trigger-Operation stattgefunden hat, oder `None`, wenn die Ausführung der DMF nicht durch eine Trigger-Operation geplant ist. Weitere Informationen zur Trigger-Operation finden Sie unter Die Ausführung der DMF planen.
`measurement_time`	TIMESTAMP_LTZ	Der Zeitpunkt, zu dem die Metrik ausgewertet wurde.
`table_id`	NUMBER	Interner/systemgenerierter Bezeichner der Tabelle, die mit der DMF verknüpft ist.
`table_name`	VARCHAR	Name der Tabelle, die mit der DMF verknüpft ist.
`table_schema`	VARCHAR	Name des Schemas, das die Tabelle enthält, die mit der DMF verknüpft ist.
`table_database`	VARCHAR	Name der Datenbank, die die Tabelle enthält, die mit der DMF verknüpft ist.
`metric_id`	NUMBER	Interner/systemgenerierter Bezeichner der DMF.
`metric_name`	VARCHAR	Name der DMF.
`metric_schema`	VARCHAR	Name des Schemas, das die DMF enthält.
`metric_database`	VARCHAR	Name der Datenbank, die die DMF enthält.
`metric_return_type`	VARCHAR	Rückgabetyp der DMF.
`arguments_ids`	ARRAY	Array mit den Bezeichnern der DMF-Argumente. Die Array-Elemente haben die gleiche Reihenfolge wie die Argumente.
`arguments_types`	ARRAY	Array der Domäne/des Typs eines jeden Arguments. Array-Elemente sind in derselben Reihenfolge angegeben wie die Argumente. Derzeit werden nur Argumente vom Typ COLUMN unterstützt.
`arguments_names`	ARRAY	Array mit den Namen der DMF-Argumente. Bei Spaltenargumenten ist jedes Element der Name einer Spalte. Die Array-Elemente haben die gleiche Reihenfolge wie die Argumente.
`reference_id`	VARCHAR	ID zur eindeutigen Identifizierung der Kennzahl-Entitätsreferenz, bekannt als die Zuordnungs-ID.
`value`	VARIANT	Das Ergebnis der DMF-Bewertung.
`expectation_name`	VARCHAR	Name, der der Erwartung gegeben wurde, als sie der Zuordnung zwischen der DMF und dem Objekt hinzugefügt wurde.
`expectation_id`	VARCHAR	Vom System generierter Bezeichner.
`expectation_expression`	VARCHAR	Boolescher Ausdruck der Erwartung. Siehe Definieren, was die Erwartung erfüllt.
`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. Ein NULL-Wert zeigt an, dass die Evaluation der Erwartung fehlgeschlagen ist.

Anforderungen an die Zugriffssteuerung¶

Um auf diese Funktion zugreifen zu können, muss die verwendete Rolle mindestens über die Anwendungsrolle SNOWFLAKE.DATA_QUALITY_MONITORING_LOOKUP verfügen. Weitere Optionen für Anwendungsrollen finden Sie unter Zugriffs auf die DMF-Ergebnisse verwalten. Verwenden Sie den Befehl GRANT APPLICATION ROLE, um die Anwendungsrolle einer Rolle zuzuweisen.

Um Ergebnisse anzuzeigen, muss die verwendete Rolle außerdem über die folgenden Berechtigungen verfügen:

Die SELECT oder OWNERSHIP-Berechtigungen für das Objekt (Tabelle oder Ansicht), dem die Datenmetrik-funktion zugewiesen ist.
Die USAGE- oder OWNERSHIP-Berechtigungen für die Datenmetrikfunktion

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

Nutzungshinweise¶

Es treten Fehler auf, wenn der angegebene Objektname nicht existiert oder wenn der Abfrageoperator nicht berechtigt ist, eine Datenmetrikfunktion für das Objekt anzuzeigen. Nicht unterstützte Objekttypen, die im REF_ENTITY_DOMAIN -Argument angegeben sind , z. B. 'STREAM', geben ebenfalls Fehler zurück.

Beispiele¶

Rückgabe einer Zeile für jede Datenmetrikfunktion mit einer Erwartung, die der Tabelle my_table zugewiesen ist:

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

Copy