DATA_QUALITY_MONITORING_RESULTS¶
指定されたオブジェクトに割り当てられた各データメトリック関数の行を返します。この行には、オブジェクトに対するデータメトリック関数の評価結果とその他のメタデータが含まれます。
- こちらもご参照ください。
DATA_QUALITY_MONITORING_RESULTS ビュー (LOCAL ビュー)
構文¶
DATA_QUALITY_MONITORING_RESULTS(
REF_ENTITY_NAME => '<string>' ,
REF_ENTITY_DOMAIN => '<string>'
)
引数¶
REF_ENTITY_NAME => 'string'
データメトリック関数を設定するテーブルオブジェクトの名前。
オブジェクト名全体を一重引用符で囲む必要があります。
オブジェクト名で大文字と小文字が区別されるか、特殊文字やスペースが含まれる場合、大文字と小文字の処理には二重引用符が必要です。二重引用符は、
'"<table_name>"'
のように一重引用符で囲む必要があります。
REF_ENTITY_DOMAIN => 'string'
データメトリック関数を設定するオブジェクト型。
オブジェクトがある種のテーブルの場合は、引数値として
'TABLE'
を使用します。オブジェクトがビューまたはマテリアライズドビューの場合は、引数値として
'VIEW'
を使用します。データメトリック関数を設定できる、サポートされているオブジェクト型のリストについては、 サポートされるテーブルの種類 をご参照ください。
戻り値¶
この関数は、次の列を返します。
列名 |
データ型 |
説明 |
---|---|---|
|
TIMESTAMP_LTZ |
テーブルまたはビューに設定したスケジュールに基づいて、 DMF が実行される時間。 |
|
TIMESTAMP_LTZ |
DMF のトリガー操作が発生した時間。DMF がトリガー操作によって実行されるようにスケジュールされていない場合は トリガー操作に関する情報については、 DMF 実行スケジュール をご参照ください。 |
|
TIMESTAMP_LTZ |
メトリックが評価された時間。 |
|
NUMBER |
DMF が関連付けられているテーブルの内部/システム生成識別子。 |
|
VARCHAR |
DMF が関連付けられているテーブルの名前。 |
|
VARCHAR |
DMF が関連付けられているテーブルを含むスキーマの名前。 |
|
VARCHAR |
DMF が関連付けられているテーブルを含むデータベースの名前。 |
|
NUMBER |
DMF の内部/システム生成識別子。 |
|
VARCHAR |
DMF の名前。 |
|
VARCHAR |
DMF を含むスキーマの名前。 |
|
VARCHAR |
DMF を含むデータベースの名前。 |
|
VARCHAR |
DMF の戻り値の型。 |
|
ARRAY |
DMF 引数の識別子の配列。配列の要素は引数と同じ順番です。 |
|
ARRAY |
各 DMF 引数のドメイン/タイプの配列。配列の要素は引数と同じ順番です。 現在は COLUMN 型の引数のみをサポートしています。 |
|
ARRAY |
DMF 引数の名前の配列。列引数の場合、各要素は列の名前です。配列の要素は引数と同じ順番です。 |
|
VARCHAR |
メトリックエンティティの参照を一意に識別するための ID で、関連付け ID として知られています。 |
|
VARIANT |
DMF 評価の結果。 |
アクセス制御の要件¶
この機能にアクセスするには、最低限、 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'));