データ測定関数の結果表示

このトピックでは、データ測定関数 (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;
Copy

アカウントロールからシステムアプリケーションロールを取り消すには、 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。