データ測定関数の結果表示¶
このトピックでは、データ測定関数 (DMF) の結果にアクセスするさまざまな方法について説明します。
注釈
データ品質チェックに失敗した行を見つけたい場合は、 データ品質問題の修復 を参照してください。
DMF 結果へのアクセスを管理する¶
スケジュールされた DMF の結果にアクセスするには、3つのオプションがあります:
オプション1: 専用イベントテーブルをクエリする
オプション2: イベントテーブルのフラット化されたバージョンである DATA_QUALITY_MONITORING_RESULTS ビューをクエリする。
オプション3: DATA_QUALITY_MONITORING_RESULTS テーブル関数を呼び出す。
DMF 結果へのアクセスをどのように管理したいかによって、以下のシステムアプリケーションロールを別のアカウントレベルのロールに付与します:
アプリケーションロール |
注意 |
---|---|
DATA_QUALITY_MONITORING_ADMIN |
オプション1、2、3が使えます。 このアプリケーションロールを付与されたロールは、 DATA_QUALITY_MONITORING_VIEWER および DATA_QUALITY_MONITORING_LOOKUP アプリケーションロールを他のロールに付与することができます。 ACCOUNTADMIN ロールを付与されたユーザーは、 DATA_QUALITY_MONITORING_ADMIN アプリケーションロールを他のロールに付与することができます。 |
DATA_QUALITY_MONITORING_VIEWER |
オプション2と3。 |
DATA_QUALITY_MONITORING_LOOKUP |
オプション3のみ。 |
例えば、DATA_QUALITY_MONITORING_VIEWER システムアプリケーションロールを analyst
カスタムロールに付与するには、 GRANT APPLICATION ROLE コマンドを使用します。
USE ROLE ACCOUNTADMIN; GRANT APPLICATION ROLE SNOWFLAKE.DATA_QUALITY_MONITORING_VIEWER TO ROLE analyst;
アカウントロールからシステムアプリケーションロールを取り消すには、 REVOKE APPLICATION ROLE コマンドを使用します。
Tip
さらに、 システム DMFs の結果へのアクセスを管理したい場合は、 SNOWFLAKE.DATA_METRIC_USER データベースロールを、結果にアクセスできるアカウントロールに付与します。詳細については、 GRANT DATABASE ROLE をご参照ください。
オプション1: 専用イベントテーブルをクエリする¶
このオプションを使用すると、生データにアクセスできるようになり、結果の分析方法に応じて表示、テーブル関数、ストアドプロシージャを作成するなど、派生オブジェクトを使用してデータを後処理する自由度が増します。さらに、このような派生オブジェクトを作成した場合、これらのオブジェクトへのアクセスをさまざまなロールに選択的に付与することができます。例えば、データエンジニアはストアドプロシージャにアクセスして結果を得るためのアプローチを維持し、データアナリストはビューにアクセスして結果を分析することができます。
イベントテーブルの名前は SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_RESULTS_RAW
です。
イベントテーブル列については、 イベントテーブル列 をご参照ください。
イベントテーブルをクエリする代表的な例については、 ログおよびトレースに関するチュートリアル をご参照ください。
オプション2: DATA_QUALITY_MONITORING_RESULTS ビューをクエリする¶
このオプションを使用すると、 DATA_QUALITY_MONITORING_RESULTS ビューをクエリでき、イベントテーブルの生データをフラット化して、 DMF の結果に簡単にアクセスできるようにします。また、このオプションは、データの後処理が不要な場合や、生データへのアクセスを許可したくない場合に最適です。
共有 SNOWFLAKE データベースにある LOCAL スキーマのビューが存在します: SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_RESULTS
。
詳細については、 DATA_QUALITY_MONITORING_RESULTS ビューをご参照ください。
注釈
SNOWFLAKE.GOVERNANCE_VIEWERデータベースロールには、DATA_QUALITY_MONITORING_RESULTSビューをクエリするアクセス権がありません。
オプション3: DATA_QUALITY_MONITORING_RESULTS テーブル関数を呼び出す¶
このオプションにより、 DATA_QUALITY_MONITORING_RESULTS テーブル関数を呼び出して、 DMF の結果を表示することができます。この関数は、 DATA_QUALITY_MONITORING_RESULTS ビューと同じ列を返します。ただし、関数を呼び出す際に指定できるテーブルは1つだけです。このオプションは、データメトリック関数の結果を1つのテーブルに限定し、他のテーブルやイベントテーブルの測定値へのアクセスを提供しない場合に最適です。
SNOWFLAKE.DATA_QUALITY_MONITORING_LOOKUP アプリケーションロールに加えて、 DATA_QUALITY_MONITORING_RESULTS テーブル関数を呼び出すために使用されるロールも、以下の権限を必要とします:
テーブルに対する OWNERSHIP または SELECT。
DMF に対する OWNERSHIP または USAGE。