カテゴリ：: システム関数、テーブル関数

SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS¶

データメトリック関数（DMFs）とテーブル間の関連付けに対する期待値を返します。これには、期待値が現在違反されているかどうかも含まれます。

構文¶

SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS(
  REF_ENTITY_NAME  => '<object>'
  [ , SKIP_SUSPENDED_DMF => { TRUE | FALSE } ] )

Copy

引数¶

REF_ENTITY_NAME => 'object'

1つ以上の期待値を持つ1つ以上の DMF を持つテーブルまたはビューの名前。完全修飾されている必要があります。

SKIP_SUSPENDED_DMF => { TRUE | FALSE }

TRUE に設定されている場合、この関数は object と一時停止された DMFs 間の関連付けに定義されている期待値を返しません。一時停止された DMF は、オブジェクトの指定されたスケジュールでは実行されません。

デフォルト: TRUE

戻り値¶

以下の列を持つテーブルを返します。

列	データ型	説明
`metric_database`	VARCHAR	DMF を含むデータベースの名前。
`metric_schema`	VARCHAR	DMF を含むスキーマの名前。
`metric_name`	VARCHAR	DMF の名前。
`expectation_name`	VARCHAR	ユーザーが、DMF とテーブルとの関連付けに期待値を追加する際に期待値に割り当てた名前。
`expectation_id`	NUMBER	システムで生成された識別子。
`expectation_expression`	VARCHAR	期待値のブール式。期待値を満たすものを定義するをご参照ください。
`arguments`	ARRAY	DMF が関連付けられている列。
`value`	VARIANT	DMF 評価の結果。
`expectation_violated`	BOOLEAN	TRUE の場合、期待値に違反しています。`expectation_expression` が FALSE と評価された場合、期待値に違反しています。

アクセス制御権限¶

この操作の実行に使用されるロールには、少なくとも次の権限が必要です。

権限	オブジェクト	メモ
SELECT	テーブルまたはビュー
USAGE	データメトリック関数（DMF）

スキーマ内のオブジェクトに対して操作を実行するには、親データベースとスキーマに対する USAGE 権限が必要です。スキーマに対する任意の権限を付与されたロールは、そのロールがスキーマを解決できることに注意してください。たとえば、スキーマに対するCREATE権限を付与されたロールは、そのスキーマにオブジェクトを作成できますが、そのスキーマに対するUSAGE*も*付与されている必要はありません。

指定された権限のセットを使用してカスタムロールを作成する手順については、カスタムロールの作成をご参照ください。

セキュリティ保護可能なオブジェクトに対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、アクセス制御の概要をご参照ください。

例¶

DMFs AND テーブル t1 間の関連付けの期待値を返します。その DMFs は、期待が現在違反であるかどうかを判断するために実行されます。

SELECT *
  FROM TABLE(SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS(
      REF_ENTITY_NAME => 'my_db.sch.t1'));

Copy