カテゴリ：

LOCAL、 テーブル関数

DATA_QUALITY_MONITORING_RESULTS

指定されたオブジェクトに割り当てられた各データメトリック関数の行を返します。この行には、オブジェクトに対するデータメトリック関数の評価結果とその他のメタデータが含まれます。

こちらもご参照ください。

DATA_QUALITY_MONITORING_RESULTS ビュー （LOCAL ビュー）

構文

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

引数

REF_ENTITY_NAME => 'string'

データメトリック関数を設定するテーブルオブジェクトの名前。

  • オブジェクト名全体を一重引用符で囲む必要があります。

  • オブジェクト名で大文字と小文字が区別されるか、特殊文字やスペースが含まれる場合、大文字と小文字の処理には二重引用符が必要です。二重引用符は、 '"<table_name>"' のように一重引用符で囲む必要があります。

REF_ENTITY_DOMAIN => 'string'

データメトリック関数を設定するオブジェクト型。

オブジェクトがある種のテーブルの場合は、引数値として 'TABLE' を使用します。

オブジェクトがビューまたはマテリアライズドビューの場合は、引数値として 'VIEW' を使用します。

データメトリック関数を設定できる、サポートされているオブジェクト型のリストについては、 サポートされるテーブルの種類 をご参照ください。

戻り値

この関数は、次の列を返します。

列名

データ型

説明

scheduled_time

TIMESTAMP_LTZ

テーブルまたはビューに設定したスケジュールに基づいて、 DMF が実行される時間。

change_commit_time

TIMESTAMP_LTZ

DMF のトリガー操作が発生した時間。DMF がトリガー操作によって実行されるようにスケジュールされていない場合は None。

トリガー操作に関する情報については、 実行するDMFsをスケジュールする をご参照ください。

measurement_time

TIMESTAMP_LTZ

メトリックが評価される時間。

table_id

NUMBER

ルールが関連付けられているテーブルの内部/システム生成識別子。ルールは、テーブルに直接関連付けることも、テーブルの任意の列に関連付けることもできます。

table_name

VARCHAR

テーブルの名前。

table_schema

VARCHAR

テーブルを含むスキーマの名前。

table_database

VARCHAR

テーブルを含むデータベースの名前。

metric_id

NUMBER

メトリックの内部/システム生成識別子。

metric_name

VARCHAR

メトリックの名前。

metric_schema

VARCHAR

メトリックを含むスキーマの名前。

metric_database

VARCHAR

シークレットを含むデータベースの名前。

metric_return_type

VARCHAR

メトリックの戻り値の型。

arguments_ids

ARRAY

ルールの評価に使用する参照引数の IDs を含む配列。配列のエントリは、引数の位置順に並びます。

arguments_types

ARRAY

ルールの評価に使用する参照引数の型を含む配列。配列のエントリは、引数の位置順に並びます。

現在は COLUMN 型の引数のみをサポートしています。

arguments_names

ARRAY

ルールの評価に使用する参照引数の名前を含む配列。配列のエントリは、引数の位置順に並びます。

reference_id

VARCHAR

メトリックエンティティの参照を一意に識別するための ID で、関連付け ID として知られています。

value

VARIANT

評価の結果。

アクセス制御の要件

この機能にアクセスするには、最低限、 SNOWFLAKE.DATA_QUALITY_MONITORING_LOOKUP アプリケーションロールが必要です。その他のアプリケーションロールのオプションについては、 DMF 結果へのアクセスを管理する をご参照ください。ロールにアプリケーションロールを付与するには、 GRANT APPLICATION ROLE コマンドを使用します。

結果を表示するには、使用するロールに以下の権限も必要です。

  • データメトリック関数が割り当てられているオブジェクト（テーブルまたはビュー）の SELECT または OWNERSHIP 権限。

  • データメトリック関数への USAGE または OWNERSHIP 権限。

使用上の注意

指定されたオブジェクト名が存在しない場合、またはクエリ演算子がオブジェクトでデータメトリック関数を表示する権限を持っていない場合、エラーが発生します。 'stream' など、 REF_ENTITY_DOMAIN としてリストされているサポートされていないオブジェクト型はエラーを返します。

例

my_table という名前のテーブルに割り当てられた各データメトリック関数の行を返します。

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
言語: 日本語