大規模なデータ品質管理を行う場合、各テーブルごとに同じルールロジックを繰り返し記述すると、エラーが発生しやすくなり、保守も困難になります。ルールテンプレートを使用すると、カスタム SQL モニタリングロジックを一度定義しておき、必要に応じて複数のテーブルで再利用できます。テンプレートを更新した場合、そのテンプレートを明示的に参照しているルールのみに影響が及び、以前のバージョンから作成されたモニタリングルールは変更されません。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
DataWorks Enterprise Edition またはそれ以上のエディションが有効化されていること
ルールテンプレートを利用する理由
| 推奨事項 | メリット |
|---|---|
| SQL ロジックをテンプレート内で 1 度だけ定義する | SQL を毎回書き直さずに、同一のモニタリングルールを複数のテーブルに適用できる |
| テンプレートをフォルダで整理する | ドメインやチーム単位で関連するテンプレートをグループ化し、検索・再利用を容易にする |
| テンプレートを一元管理して更新する | テンプレートのロジックを 1 箇所で変更可能。変更されたテンプレートを参照しているルールのみに影響が及ぶ |
ルールテンプレートの作成
DataWorks コンソールにログインします。上部ナビゲーションバーで対象リージョンを選択します。左側ナビゲーションウィンドウで データガバナンス > Data Quality を選択し、ドロップダウンリストからワークスペースを選択して、Data Quality へ移動 をクリックします。
左側ナビゲーションウィンドウで、アセット > ルールテンプレートライブラリ を選択します。
アイコンをクリックし、フォルダの作成 を選択します。フォルダの作成 ダイアログボックスで、名前 および 場所 のパラメーターを設定し、OK をクリックします。
ディレクトリツリーで対象フォルダを右クリックし、ルールテンプレートの作成 を選択します。
注： 右クリックメニューから、フォルダの 名前の変更 や 削除 も行えます。
ルールテンプレートの作成 ダイアログボックスで、パラメーターを設定します。
パラメーター 説明 テンプレート名 ルールテンプレートの名前です。 フィールド モニタリング対象のフィールドです。固定値：カスタム SQL。 サンプリング方法 サンプリング方法です。固定値：カスタム SQL。 SET フラグ モニタリング対象フィールドをクエリする SQL ステートメントの SET句です。複数のステートメントはカンマ (,) で区切ります。各ステートメントの末尾にはセミコロン (;) を付加しないでください。チェックタイプ しきい値の種類です。有効な値： 数値型 および 変動型。 検証方法 チェック結果の比較方法です。チェックタイプ の値によって選択可能なオプションが異なります — 下記の表をご参照ください。 カスタム SQL モニタリング対象フィールドをクエリする SQL ステートメントです。 ${tableName}をテーブル名のプレースホルダーとして使用します。クエリは、しきい値と比較可能な単一の値を返す必要があります。場所 テンプレートを保存するフォルダです。 チェックタイプ別検証方法および必要なしきい値
検証方法 の選択肢およびテンプレート適用時に設定する必要のあるしきい値は、選択した チェックタイプ に依存します。
チェックタイプ 検証方法の選択肢 適用時に設定が必要なしきい値 数値型 指定値との比較 — クエリは単一の COUNT または SUM 値を返す必要があり、固定値と比較されます 通常しきい値 + 重大しきい値 変動 現在値と過去 7 日間の平均値を比較 通常しきい値 + 警告しきい値 + 重大しきい値 変動 現在値と過去 30 日間の平均値を比較 通常しきい値 + 警告しきい値 + 重大しきい値 変動 現在値と 1 日前の値を比較 通常しきい値 + 警告しきい値 + 重大しきい値 変動 現在値と 7 日前の値を比較 通常しきい値 + 警告しきい値 + 重大しきい値 変動 現在値と 30 日前の値を比較 通常しきい値 + 警告しきい値 + 重大しきい値 変動 現在の値と7日前の値の差 通常しきい値 + 警告しきい値 + 重大しきい値 変動 現在の値と 30 日前の値との差異 通常しきい値 + 警告しきい値 + 重大しきい値 変動 現在値と 1 日前、7 日前、30 日前の値をそれぞれ比較 通常しきい値 + 警告しきい値 + 重大しきい値 変動 現在値と前回のサイクルの値を比較 通常しきい値 + 警告しきい値 + 重大しきい値 カスタム SQL と `${tableName}` プレースホルダー
テンプレートを複数のテーブルで再利用可能にするため、SQL 内で
${tableName}を使用します。DataWorks は実行時に実際のテーブル名に置換します。クエリは、単一行で単一の値を返す必要があります。数値型 のチェックでは、その値は COUNT または SUM の出力である必要があります。OK をクリックします。
ルールテンプレートの管理
ルールテンプレートライブラリ からテンプレート名をクリックすると、詳細ページが開きます。このページから、テンプレートの表示、編集、削除、コピーが可能です。
| 操作 | 手順 |
|---|---|
| 表示 | テンプレートのパラメータ設定、参照しているルールの一覧（適用一覧 タブ）、および操作履歴（ログの表示 タブ）を確認できます。ログの表示 タブには、各操作の実行者、タイムスタンプ、および詳細が記録されます。 |
| 編集 | 右上隅の 編集 をクリックし、ルールテンプレートの編集 ダイアログボックスでパラメーターを更新して、OK をクリックします。 |
| 削除 | 右上隅の 削除 をクリックし、テンプレートの削除 メッセージで確認します。 |
| コピー | 右上隅の コピー をクリックします。ルールテンプレートのクローン作成 ダイアログボックスで、新しい テンプレート名 および 場所 を設定し、OK をクリックします。 |
注： カスタムルールへの変更は、変更されたカスタムルールを参照しているタスクにのみ反映されます。元のカスタムルールが適用されている既存のタスクには影響しません。
モニタリングルールへのルールテンプレートの適用
Data Quality ページの左側ナビゲーションウィンドウから、ルールの設定 > テーブル単位での設定 を選択します。
接続 セクションで、ルール設定対象のテーブルが存在するデータベースを選択します。データベースタイプ、データベース名、テーブル名でフィルターをかけて対象テーブルを特定します。テーブル名をクリックするか、操作 列の ルール管理 をクリックして、テーブル品質の詳細 ページを開きます。このページには、そのテーブルに対して設定済みのすべてのルールが一覧表示されます。モニターに関連付けられていないルールについては、このページから直接実行モードを設定できます。
ルール管理 タブでモニターを選択し、ルールの作成 をクリックします。ルールの作成 パネルが開きます。
カスタムルールテンプレートを選択します。FLAG パラメーター および SQL フィールドは、テンプレートから自動的に入力されます。ルール名 を設定し、テンプレートのチェックタイプに基づいてしきい値を構成します。
チェックタイプ 設定するしきい値 数値型 通常しきい値および重大しきい値 変動 通常しきい値、警告しきい値、および重大しきい値 
決定 をクリックします。