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

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

最終更新日:Apr 24, 2026

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

はじめに

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

説明

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

制限事項

  • 機能の制限:

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

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

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

      • Export Query Results:外部レポートやさらなる分析のためにデータを使用できます。

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

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

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

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

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

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

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

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

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

    DataWorks コンソールにログインします。対象のリージョンで、左側のナビゲーションウィンドウにある データ開発と О&М > 操作とメンテナンスセンター をクリックします。ドロップダウンリストからワークスペースを選択し、入力 操作とメンテナンスセンター をクリックします。

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

    Operation Center ページの左側のナビゲーションウィンドウで、Auto Triggered Task O&M > 定期的なタスク をクリックします。定期的なタスク ページでは、次のいずれかの方法で定期タスクのテストを実行できます。

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

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

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

    パラメーター

    説明

    煙テスト名

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

    営業日を選択する

    テストの業務日付を選択します。

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

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

    高度な設定

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

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

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

List icon

操作

説明

Filter

上の図のエリア 1 では、フィルター条件を使用して、クエリしたいインスタンスを絞り込むことができます。

インスタンスは、タスク名タスクidタスクタイプ実行日営業日スケジューリングリソースグループ私のノード今日テストしたノード一時停止 (フリーズ) ノード でフィルターできます。

説明

フィルターのデフォルトの業務日付は、現在の日付の前日です。

Tasks

上の図のエリア 2 では、フィルター条件に一致するテストインスタンスがリストで表示されます。

操作

上の図のエリア 3 では、テストインスタンスに対して以下の操作を実行できます:

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

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

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

    説明

    成功 または Failed 状態のタスクのみ再実行できます。

  • もっと

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

      説明

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

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

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

      説明

      待ち時間リソースを待つ、または Running 状態のインスタンスのみ終了できます。

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

      説明

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

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

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

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

      説明

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

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

    • View cycle task details:現在のインスタンスの基本情報を表示します。

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

一括操作

上の図のエリア 4 では、複数のタスクを一括で選択し、操作の終了再実行成功Change Resource Groupサスペンション (フリーズ)復元 (解凍)Export Query Results などの操作を実行できます。

ページあたりの項目数

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

テストインスタンスの DAG

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

機能

説明

DAG パネルの機能

タスクの横にある Dagダイアグラム をクリックしてその DAG を開きます。DAG で以下の操作を実行できます:

  • Search:上の図のエリア 1 では、Node NameノードidInstance IDインスタンス名 などでインスタンスをフィルターできます。

  • DAG 表示スタイルの選択:上の図のエリア 2 では、DAG ビューの右上隅にある機能アイコンをクリックして、必要に応じて表示スタイルを調整できます。左から右へ:地図を開く/マップを閉じるアラームステータスを有効にする/アラームステータスをオフにするノードステータスの更新ズームイン DAG キャンバスシュリンク DAG キャンバスノードとキャンバス間の 1:1 レイアウト比率現在のウィンドウサイズに基づく自動 適応スクリーン、および フルスクリーン トグル

単一インスタンスの操作

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

  • コードを表示する:本番環境で現在のノードのコードを検証するために使用されます。コードが期待どおりでない場合は、ノードの最新バージョンが正常にデプロイされているか確認してください。

  • 編集ノード:クリックして DataStudio ページに移動し、現在のノードを開きます。

説明

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

単一インスタンスの詳細

上の図のエリア 4 では、以下の操作を実行できます:

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

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

インスタンスの詳細表示

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

View instance details

機能

説明

属性

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

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

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

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

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

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

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

    説明

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

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

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

Runtime Log

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

操作ログ

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

コード

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

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

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