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

DataWorks:テストの実行とテストインスタンスの表示

最終更新日:Aug 25, 2026

テストインスタンスは、定期タスクでテストを実行すると生成されます。テストインスタンスページでは、インスタンスの詳細をリストまたは DAG で表示できます。

概要

定期タスクでテストを実行して、そのスケジューリングと実行が本番環境での期待を満たしているかを確認できます。これによりテストインスタンスが生成され、テストインスタンスページでその実行ステータスを監視できます。

説明

テストインスタンスを実行すると、実際のコードロジックが実行されます。操作にはご注意ください。

制限事項

  • 機能の制限事項:

    • DataWorks Professional Edition 以降では、開発と O&M の効率を向上させるために、次の高度な機能を提供しています。詳細については、「エディションと課金」をご参照ください。

      • [診断の実行]:タスク実行の問題を迅速に特定するのに役立ちます。この機能は無料トライアルで利用できます。詳細については、「インテリジェント診断」をご参照ください。

      • 高度な DAG 分析:ノード集約、上流分析、下流分析を含み、複雑なタスクリネージに関するインサイトを得るのに役立ちます。

      • [クエリ結果のエクスポート]:外部レポートやさらなる分析のためにデータを使用できます。

    • 一部の機能は O&M 権限を持つユーザーのみが使用できます。機能がグレーアウトしているか利用できない場合は、「管理センターの概要」ページに移動します。左側のナビゲーションペインで スペースのメンバーとロール をクリックし、スペースメンバー タブで、対象ユーザーが O&M 権限を持っていることを確認します。詳細については、「ワークスペースレベルのモジュールの権限管理」をご参照ください。

  • ログとインスタンスの制限事項:

    • テストインスタンスは手動で削除できません。インスタンスは有効期限 (約30日間) が切れると、プラットフォームによって自動的に削除されます。タスクを実行する必要がなくなった場合は、インスタンスを凍結できます。

    • 共有スケジューリングリソースグループでは、インスタンスは1か月 (30日間) 保持され、ログは1週間 (7日間) 保持されます。

    • 専用スケジューリングリソースグループでは、タスクインスタンスとログは1か月 (30日間) 保持されます。

    • 完了したインスタンスの 3 MB を超えるログは、毎日クリーンアップされます。

  • タスクに 最大同時実行インスタンス数 を設定すると、テストインスタンスもこの制限の対象となり、定期インスタンスやバックフィルインスタンスと同時実行クォータを共有します。複数のタイプのインスタンスが同時にキューに入れられた場合、当日以外を対象とするバックフィルインスタンスのみ、優先度が引き下げられます (8から3へ) 。

テストの実行とテストインスタンスの生成

  1. オペレーションセンターに移動します。

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

  2. 定期タスクでテストを実行します。

    オペレーションセンター ページの左側のナビゲーションペインで、定期タスクの運用保守 > 定期タスク をクリックします。定期タスク ページでは、次のいずれかの方法で定期タスクのテストを実行できます。

    • 方法 1: 定期タスクのリストビューで、対象タスクの操作列にあるテストをクリックします。 現在のページがリストビューでない場合は、ページの中央にあるArrow icon アイコンをクリックしてリストビューに戻ります。

    • 方法 2: DAG ビューで、対象インスタンスの DAG を右クリックし、コンテキストメニューから テスト をクリックします。 現在のページが DAG ビューでない場合は、対象インスタンスの 操作 列の DAG グラフ をクリックして、タスクの DAG を開きます。

  3. スモークテスト ダイアログでパラメーターを設定します。

    パラメーター

    説明

    [スモークテスト名]

    スモークテストの名前を入力できます。

    [業務日付の選択]

    テストのビジネス日付を選択します。

    説明
    • 昨日より前のビジネス日付を選択した場合、タスクはすぐに実行されます。

    • 昨日をビジネス日付として選択した場合、タスクはスケジュールされた時刻に実行されます。

    [詳細設定]

    詳細設定を有効にすると、スケジューリングパラメーターに値を割り当てることができます。割り当てられた値は、現在のテストでのみ有効です。

テストインスタンスのリスト表示

テストインスタンスリストには、定期タスクでテストを実行した後に生成されたテストインスタンスが表示されます。テストインスタンスの実行ステータスを表示し、関連する操作を実行できます。

操作

説明

[フィルター]

前の図のエリア 1 で、フィルター条件を使用して照会するインスタンスを絞り込むことができます。

インスタンスは、タスク名、タスク ID、タスクタイプ、実行日、データタイムスタンプ、リソースグループのスケジューリング、マイノード、本日テストしたノード、およびノードの一時停止 (フリーズ)で絞り込むことができます。

説明

フィルタリングのデフォルトのビジネス日付は、現在の日付の前日です。

[タスクリスト]

前の図のエリア 2 では、フィルター条件を満たすテストインスタンスがリストで表示されます。

[操作]

前の図のエリア 3 では、テストインスタンスに対して次の操作を実行できます。

  • [DAG グラフ]:DAG は、テストインスタンスの上流と下流の依存関係を表示します。DAG で関連操作を実行できます。詳細については、「DAGの管理」をご参照ください。

  • 診断 ([診断の実行]):タスクをエンドツーエンドで分析します。タスクが期待どおりに実行されない場合、この機能を使用して問題を特定できます。詳細については、「インテリジェント診断」をご参照ください。

  • [再実行]:成功または失敗したタスクを再実行します。タスクが正常に実行されると、未実行状態の下流タスクのスケジューリングをトリガーできます。これは、失敗したノードや見逃したノードを処理するためによく使用されます。

    説明

    成功 または 失敗した 状態のタスクのみを再実行できます。

  • [詳細]:

    • [ダウンストリームの再実行]:成功または失敗したタスクの下流ノードを再実行します。再実行する下流タスクを選択できます。タスクが正常に実行されると、未実行状態の下流タスクのスケジューリングをトリガーできます。これは、データ修復によく使用されます。

      説明

      成功 または 失敗した の状態にあるタスクのみを再実行できます。他の状態のタスクを選択した場合、ページに [選択したノードに実行条件を満たさないノードが含まれています] というメッセージが表示され、実行の送信がブロックされます。

    • [設定が完了しました。]:失敗したタスクを成功状態に設定します。タスクが失敗しても下流タスクをブロックしたくない場合、この機能を使用できます。これは、失敗したノードを処理するためによく使用されます。

    • [実行の終了]:実行する必要がなくなったタスクを終了します。タスクが終了すると、失敗ステータスで終了します。

      説明

      待機時間、リソース待機中、または 実行中 の状態にあるインスタンスのみを終了できます。

    • [一時停止 (フリーズ)]:タスクとその下流タスクを一定期間実行する必要がない場合、この機能を使用できます。詳細については、「インスタンスの凍結と凍結解除」をご参照ください。

      説明

      projectname_root ノードで操作を実行しないでください。このノードはワークスペースのルートノードです。すべての定期タスクインスタンスはこのノードに依存します。このノードを凍結すると、定期タスクインスタンスは実行できなくなります。

    • [復元 (解凍)]:凍結状態のインスタンスを凍結解除します。

      • インスタンスがまだ実行されていない場合、上流タスクの実行が完了した後に自動的に実行されます。

      • すべての上流タスクの実行が完了している場合、インスタンスは直接失敗状態に設定されます。インスタンスを正常に実行するには、手動で再実行する必要があります。

      説明

      凍結解除操作は特定のインスタンスにのみ適用されます。定期タスクがまだ凍結状態にある場合、翌日に生成されるインスタンスは引き続き凍結状態になります。

    • [データリネージの表示]:現在のインスタンスのリネージ情報を表示します。

    • [定期タスクの詳細]:現在のインスタンスの基本情報を表示します。

    • [運用ログの表示]:タスクの実行が開始された後、ランタイムログで詳細な実行プロセスを確認できます。ログの主要なパラメーターの説明については、「ランタイムログパラメーター」をご参照ください。

一括操作

前の図のエリア 4 では、複数のタスクを一括で選択し、実行の終了、再実行、設定が完了しました。、リソースグループの編集、一時停止 (フリーズ)、復元 (解凍)、クエリ結果のエクスポート などの操作を実行できます。

ページあたりの項目数

前の図のエリア 5 では、ページごとに表示される項目数を変更できます。ページごとに最大200項目を表示できます。

テストインスタンスDAG

リストビューで、インスタンスのテスト 名をクリックするか、操作 列の DAG グラフ をクリックしてインスタンスの DAG を開きます。 DAG 内のインスタンスを右クリックして関連操作を実行できます。

機能

説明

DAGパネルの機能

タスクの横にあるDAG グラフ をクリックして、その DAG を開きます。DAG では、次の操作を実行できます。

  • [検索]:前の図のエリア 1 で、ノード名、ノード ID、インスタンス ID、インスタンス名 などでインスタンスをフィルターできます。

  • [DAG 表示スタイル]:前の図のエリア 2 で、DAG ビューの右上隅にある機能アイコンをクリックすると、必要に応じて表示スタイルを調整できます。 左から右に:マップを開く/マップのシャットダウン、アラートの有効化/アラートの無効化、ノードの状態をリフレッシュ、拡大 DAG キャンバス、縮小 DAG キャンバス、ノードとキャンバス間の 1:1 レイアウト比、自動 画面に合わせる (現在のウィンドウサイズに基づく)、および 全画面 トグル。

単一インスタンスの操作

対象のノードを右クリックして、関連する操作を実行します。

  • [実行の終了]:実行する必要がなくなったタスクを終了します。タスクが終了すると、失敗ステータスで終了します。

  • [再実行]:成功または失敗したタスクを再実行します。

  • [詳細]: 展開すると、設定が完了しました。 や 一時停止 (フリーズ) などの操作が表示されます。

説明

その他の操作については、「テストインスタンスのリスト表示」をご参照ください。

単一インスタンスの詳細

前の図のエリア 4 では、次の操作を実行できます。

  • [ログを表示]:タスクの実行が開始された後、ランタイムログで詳細な実行プロセスを確認できます。ログの主要なパラメーターの説明については、「ランタイムログパラメーター」をご参照ください。

  • [詳細の表示]:プロパティ、コンテキスト、ランタイムログ、操作ログ、コードなど、現在のタスクに関する情報を表示します。詳細については、「インスタンス詳細の表示」をご参照ください。

インスタンス詳細の表示

DAG ビューで、ターゲットインスタンスをクリックします。右下隅に表示されるウィンドウで、詳細の表示 をクリックします。インスタンス詳細ページが表示され、プロパティ、コンテキスト、ランタイムログ、操作ログ、コードなど、現在のインスタンスに関する詳細情報を表示できます。

機能

説明

[プロパティ]

このタブでは、本番環境でのタスクのスケジューリングプロパティを表示できます。ページのパラメーターの説明については、「スケジューリング設定の構成」をご参照ください。

  • タスクステータスの解釈:タスクステータスはタスクの実行に関連しています。タスクが未実行、待機時間、リソース待機中、または凍結状態にある場合は、トラブルシューティングについて「タスクステータスの問題のトラブルシューティング」をご参照ください。

  • リソース待機時間:タスクが長時間リソースを待機している場合は、インテリジェント診断 機能を使用して、現在のタスクの実行時にどのタスクがリソースを占有しているかを特定し、異常なタスクを迅速に見つけてトラブルシューティングできます。

  • 過剰な実行時間:タスクの実行時間が過去の実行と比較して大幅に長い場合は、次のシナリオを参照してトラブルシューティングを行います。

    • 同期以外のタスク:対応するコンピューティングエンジンの担当者にお問い合わせください。

    • バッチ同期タスク:タスクの特定のフェーズの実行が遅いか、タスクが長期間のリソース待機状態でスタックしている可能性があります。詳細については、「バッチ同期タスクのトラブルシューティング」をご参照ください。

  • 監視ルール: 現在のインスタンスに関連付けられている監視ルールを表示できます。右側の作成をクリックすると、タスク実行ステータスの監視ルールをすばやく作成できます。詳細については、「監視ルールを作成する」をご参照ください。

    説明

    ここではタスク実行ステータスの監視ルールのみ表示できます。Data Quality の監視ルールはサポートされていません。

  • ベースライン監視:現在のインスタンスに関連付けられているベースラインを表示できます。右側の作成をクリックすると、ベースラインをすばやく作成できます。詳細については、「ベースラインの管理」をご参照ください。

  • 最大同時実行インスタンス数:タスクに設定された最大同時実行インスタンス数を表示します。値は [無制限] または特定の数値 (1~10000) です。この設定は、同時に実行できる同じタスクのインスタンスの最大数を制限します。この制限は、定期インスタンス、バックフィルインスタンス、テストインスタンスに適用されます。

[運用ログ]

タスクの実行が開始された後、ランタイムログで詳細な実行プロセスを確認できます。ログの主要なパラメーターの説明については、「ランタイムログパラメーター」をご参照ください。

[操作ログ]

タスクまたはインスタンスの操作記録 (時刻、オペレーター、特定の操作など) を表示します。

[コード]

本番環境での現在のタスクの最新コードを表示します。コードが期待どおりでない場合は、タスクの最新バージョンが正常にデプロイされているかどうかを確認してください。詳細については、「ノードのデプロイ」をご参照ください。

タスク実行の問題のトラブルシューティング

タスクが期待どおりに実行されない場合は、インテリジェント診断 機能を使用して、タスクが実行されなかった理由を診断したり、問題を特定したりできます。