すべてのプロダクト
Search
ドキュメントセンター

DataWorks:カスタムルールテンプレートの作成と管理

最終更新日:Jan 11, 2025

DataWorks Data Qualityでは、一連のカスタムルールを一元的に管理し、自己管理型のルールテンプレートライブラリを作成して、より効率的にルールを設定できます。このトピックでは、カスタムルールテンプレートを作成および設定する方法について説明します。

前提条件

DataWorks Enterprise Edition以上がアクティブ化されていること。

背景情報

[ルールテンプレートライブラリ] ページでルールテンプレートを作成できます。ルールテンプレートを作成した後、テンプレートを管理および使用できます。

注意事項

カスタムルールに加えられた変更は、変更されたカスタムルールを参照するタスクにのみ有効になります。元のカスタムルールが適用されている既存のタスクは影響を受けません。

カスタムルールテンプレートの作成

  1. Data Qualityページに移動します。

    DataWorksコンソールにログオンします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションペインで、[データ開発とガバナンス] > [データ品質] を選択します。表示されるページで、ドロップダウンリストから目的のワークスペースを選択し、[データ品質に移動] をクリックします。

  2. 左側のナビゲーションペインで、[アセット] > [ルールテンプレートライブラリ] を選択します。

  3. 新建 アイコンをクリックし、[フォルダの作成] を選択します。

  4. [フォルダーの作成] ダイアログボックスで、[名前] パラメーターと場所パラメーターを構成し、[OK] をクリックします。

  5. 左側のディレクトリツリーで、作成したフォルダを右クリックし、[ルールテンプレートの作成] を選択します。

    フォルダの [名前変更][削除] もできます。

  6. [ルールテンプレートの作成] ダイアログボックスで、パラメータを設定します。

    image.png

    パラメータ

    説明

    [テンプレート名]

    カスタムルールテンプレートの名前。

    [フィールド]

    監視するフィールド。[カスタム SQL] のみに設定できます。

    [サンプリング方法]

    カスタムルールテンプレートのサンプリング方法。[カスタム SQL] のみに設定できます。

    [フラグの設定]

    SET 句。監視対象のフィールドを照会するために使用する SQL ステートメントの一部です。

    説明

    複数の文はコンマ (,) で区切ります。文の末尾にセミコロン (;) を追加する必要はありません。

    [チェックタイプ]

    カスタムルールテンプレートのしきい値タイプ。有効な値:[数値型] および [変動]

    [検証方法]

    カスタムルールテンプレートの検証方法。選択できる検証方法は、しきい値タイプによって異なります。

    • [チェックタイプ] パラメータを [数値型] に設定した場合、このパラメータは [指定値と比較] のみに設定できます。

      COUNT 関数または SUM 関数によって計算された値のみを返すことができます。戻り値は指定された値と比較されます。

    • [チェックタイプ] パラメータを [変動] に設定した場合、次の検証方法が使用されます。

      • [現在の値を過去 7 日間の平均値と比較]

      • [現在の値を過去 30 日間の平均値と比較]

      • [現在の値を 1 日前の値と比較]

      • [現在の値を 7 日前の値と比較]

      • [現在の値を 30 日前の値と比較]

      • [現在の値と 7 日前の値の分散]

      • [現在の値と 30 日前の値の分散]

      • [1 日前、7 日前、および 30 日前の値と比較]

      • [前のサイクルの値と比較]

    [カスタム SQL]

    監視対象のフィールドを照会するために使用される SQL ステートメントです。${tableName} を使用してテーブル名を指定できます。

    説明

    戻り値が列の行の値であり、指定されたしきい値と比較できることを確認してください。

    [場所]

    カスタムルールテンプレートを保存するフォルダの名前。

  7. [OK] をクリックします。

ルールテンプレートの管理

[テンプレート] ペインで、ルールテンプレートの名前をクリックして、テンプレートの詳細ページに移動できます。表示されるページで、ルールテンプレートの [表示][変更][削除]、または [コピー] を行うことができます。

アクション

説明

[表示]

ルールテンプレートのパラメータ設定と [ログ]、およびルールテンプレートを使用する [ルール] を表示できます。

  • [アプリケーションリスト] タブには、ルールテンプレートを使用するルールが表示されます。

  • [ログの表示] タブには、[各操作を実行したユーザー][各操作が実行された時刻][操作の詳細] など、ルールテンプレートの操作ログが表示されます。

[編集]

右上隅の [編集] をクリックします。[ルールテンプレートの編集] ダイアログボックスで、必要に応じてパラメータを変更し、[OK] をクリックします。

[削除]

右上隅の [削除] をクリックします。[テンプレートの削除] メッセージで、[OK] をクリックします。

[コピー]

右上隅の [コピー] をクリックします。[ルールテンプレートの複製] ダイアログボックスで、[テンプレート名] パラメータと [場所] パラメータを設定し、[OK] をクリックします。

カスタムルールテンプレートの適用

監視ルールを作成するときに、カスタムルールテンプレートを選択して、ルールテンプレートに基づいてルールを作成できます。

  1. Data Qualityページに移動します。

    DataWorksコンソールにログオンします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションペインで、[データ開発とガバナンス] > [データ品質] を選択します。表示されるページで、ドロップダウンリストから目的のワークスペースを選択し、[データ品質に移動] をクリックします。

  2. テーブル品質詳細ページに移動します。

    左側のナビゲーションペインで、[ルールの設定] > [テーブル別に設定] を選択します。[テーブル別に設定] ページが表示されます。

    1. [接続] セクションで、ルールを設定するテーブルが存在するデータベースを選択します。

    2. データベースタイプ、データベース、テーブル名などの条件に基づいて目的のテーブルを検索します。次に、テーブルの名前をクリックするか、テーブルの [アクション] 列の [監視ルールの設定] をクリックして、テーブル品質詳細ページに移動します。

      このページには、テーブルに設定されているすべてのルールが表示されます。ルールがモニターに関連付けられているかどうかによって、ルールをすばやくフィルタリングできます。モニターに関連付けられていないルールについては、ルールのランニングモードを指定できます。

      image

  3. [テーブル品質詳細] ページの [ルール管理] タブで、[ルールの作成] をクリックします。

  4. カスタムルールテンプレートを使用して監視ルールを作成します。

    カスタムルールテンプレートを参照すると、[FLAG パラメータ][SQL] などのテンプレートの基本設定が自動的に表示されます。ビジネス要件に基づいて [ルール名] パラメータを設定し、ルールタイプに基づいて [監視しきい値] パラメータを設定できます。たとえば、数値ルールには通常しきい値とクリティカルしきい値を定義する必要があり、変動タイプのルールには警告しきい値に加えて通常しきい値とクリティカルしきい値を定義する必要があります。

    image

    パラメータの詳細については、「カスタムルールテンプレートの作成」をご参照ください。

  5. [決定] をクリックします。

参考資料

テーブル別に監視ルールを設定する際に、カスタムルールテンプレートを使用できます。詳細については、「単一テーブルの監視ルールの設定」をご参照ください。