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

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

最終更新日:Oct 30, 2026

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

概要

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

説明

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

制限事項

  • 機能の制限事項:

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

      • AI 診断:タスク実行の問題を迅速に特定するのに役立ちます。詳細については、「データ運用保守エージェント」をご参照ください。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    パラメーター

    説明

    スモークテスト名

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

    業務日付の選択

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

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

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

    詳細設定

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

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

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

操作

説明

フィルター

タスク名、タスク ID、タスクタイプ、実行日、データタイムスタンプ、リソースグループのスケジューリング、マイノード、本日テストしたノード、ノードの一時停止 (フリーズ) でクエリするインスタンスをフィルターできます。

説明

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

タスクリスト

フィルター条件に一致するテストインスタンスがリストに表示されます。

操作

テストインスタンスに対して次の操作を実行できます:

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

  • AI 診断:ページの右側にデータ運用保守エージェントパネルを開き、現在のインスタンスの診断命令を自動的に送信してタスクを分析します。タスクが期待どおりに実行されない場合、この機能を使用して問題を特定できます。詳細については、「データ運用保守エージェント」をご参照ください。

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

    説明

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

  • 詳細:

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

      説明

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

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

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

      説明

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

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

      説明

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

    • 復元 (解凍):フリーズ状態のインスタンスをフリーズ解除するために使用します。

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

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

      説明

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

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

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

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

一括操作

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

ページあたりの項目数

ページごとに表示される項目数を変更できます。ページごとに最大 200 項目を表示できます。

テストインスタンスの DAG

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

機能

説明

DAG パネルの機能

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

  • 検索:ノード名、ノード ID、インスタンス ID、インスタンス名 などでインスタンスをフィルターできます。

  • DAG 表示スタイルの選択:DAG ビューの右上隅にある機能アイコンをクリックして、必要に応じて表示スタイルを調整できます。左から順に、マップを開く/マップのシャットダウン、アラートの有効化/アラートの無効化、ノードの状態をリフレッシュ、DAG キャンバスの 拡大、DAG キャンバスの 縮小、ノードとキャンバスの 1:1 レイアウト、現在のウィンドウサイズに合わせた 画面に合わせる、全画面 です。

単一インスタンスの操作

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

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

  • 再実行:成功または失敗したタスクを再実行するために使用します。

    確認ダイアログボックスでは、[最新設定で再実行] スイッチはデフォルトでオフになっています。このスイッチをオンにすると、テストインスタンスの次のプロパティが最新のタスク構成に更新されます:コンピューティングリソース、リソースグループ、CU、優先度、イメージ、スケジューリングタイプ、再実行ポリシー、タイムアウト定義、所有者、タグ、および DQC 構成。テストインスタンスが生成された後にノードの構成を変更した場合は、このスイッチをオンにして最新の構成でインスタンスを再実行してください。このスイッチがオンになっているかどうかに関係なく、ノードコードは再実行のたびに常に最新バージョンを使用します。

    重要

    インスタンスのプロパティを手動で変更した場合は、このスイッチをオンにしないでください。インスタンスプロパティへの変更がリセットされる可能性があります。

  • 詳細:設定が完了しました。 や 一時停止 (フリーズ) などの操作が含まれます。

説明

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

単一インスタンスの詳細

次の操作を実行できます:

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

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

インスタンス詳細の表示

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

機能

説明

プロパティ

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

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

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

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

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

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

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

    説明

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

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

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

運用ログ

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

操作ログ

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

コード

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

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

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