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 Ausführung von DMFs planen.
`measurement_time`	TIMESTAMP_LTZ	Zeitpunkt, zu dem die Kennzahl evaluiert wurde.
`table_id`	NUMBER	Interner/systemgenerierter Bezeichner der Tabelle, mit der die Regel verknüpft ist. Die Regeln können entweder direkt mit der Tabelle oder mit einer beliebigen Spalte der Tabelle verknüpft werden.
`table_name`	VARCHAR	Name der Tabelle.
`table_schema`	VARCHAR	Name des Schemas, das die Tabelle enthält.
`table_database`	VARCHAR	Name der Datenbank, die die Tabelle enthält.
`metric_id`	NUMBER	Interner/systemgenerierter Bezeichner der Kennzahl.
`metric_name`	VARCHAR	Name der Kennzahl.
`metric_schema`	VARCHAR	Name des Schemas, das die Kennzahl enthält.
`metric_database`	VARCHAR	Name der Datenbank, die die Kennzahl enthält.
`metric_return_type`	VARCHAR	Rückgabetyp der Kennzahl.
`arguments_ids`	ARRAY	Ein Array, das IDs von Referenzargumenten enthält, die zur Auswertung der Regel verwendet werden. Die Einträge des Arrays sind nach den Positionen der Argumente geordnet.
`arguments_types`	ARRAY	Ein Array, das Typen der Referenzargumente enthält, die zur Auswertung der Regel verwendet werden. Die Einträge des Arrays sind nach den Positionen der Argumente geordnet. Derzeit werden nur Argumente vom Typ COLUMN unterstützt.
`arguments_names`	ARRAY	Ein Array, das die Namen der Referenzargumente enthält, die zur Auswertung der Regel verwendet werden. Die Einträge des Arrays sind nach den Positionen der Argumente geordnet.
`reference_id`	VARCHAR	ID zur eindeutigen Identifizierung der Kennzahl-Entitätsreferenz, bekannt als die Zuordnungs-ID.
`value`	VARIANT	Das Ergebnis der 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