Kategorien:: LOCAL , Tabellenfunktionen

DATA_QUALITY_MONITORING_RESULTS¶

Gibt eine Zeile für jede dem angegebenen Objekt zugewiesene Datenmetrikfunktion zurück, die das Auswertungsergebnis und andere Metadaten der Datenmetrikfunktion für das Objekt enthält.

Siehe auch:: Ansicht DATA_QUALITY_MONITORING_RESULTS (LOCAL Ansicht)

Syntax¶

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

Copy

Argumente¶

REF_ENTITY_NAME => 'string'

Der Name des Tabellenobjekts, auf das die Datenmetrikfunktion eingestellt ist.

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, z B. '"<table_name>"'.

REF_ENTITY_DOMAIN => 'string'

Der Objekttyp, auf den die Datenmetrikfunktion 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.

Rückgabewerte¶

Die Funktion gibt die 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, mit der die DMF verknüpft ist.
`table_name`	VARCHAR	Name der Tabelle, mit der die DMF verknüpft ist.
`table_schema`	VARCHAR	Name des Schemas, das die Tabelle enthält, mit der die DMF verknüpft ist.
`table_database`	VARCHAR	Name der Datenbank, die die Tabelle enthält, mit der die 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 mit dem Bereich/Typ jedes DMF-Arguments. Die Array-Elemente haben die gleiche Reihenfolge 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.

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

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 als REF_ENTITY_DOMAIN aufgeführt sind, wie z. B. 'stream', geben ebenfalls Fehler zurück.

Beispiele¶

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

USE DATABASE SNOWFLAKE;
USE SCHEMA LOCAL;
SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_RESULTS(
    REF_ENTITY_NAME => 'my_db.my_schema.my_table',
    REF_ENTITY_DOMAIN => 'table'));

Copy