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

DataWorks:自動トリガーされたタスクをテストし、タスクに対して生成されたテストインスタンスを表示する

最終更新日:Jan 23, 2025

自動トリガーされたタスクをテストするたびに、テストインスタンスが生成されます。テストインスタンスの詳細は、テストインスタンスのリストまたはテストインスタンスの有向非循環グラフ(DAG)で表示できます。

背景情報

本番環境で自動トリガーされたタスクが期待どおりに実行されるかどうかを確認するために、自動トリガーされたタスクをテストできます。自動トリガーされたタスクをテストするたびに、テストインスタンスが生成されます。テストインスタンスの詳細は、[テストインスタンス] ページで表示できます。

説明

テスト中に自動トリガーされたタスクのコードが実行されます。自動トリガーされたタスクをテストする前に、テストがビジネスに影響を与えないことを確認してください。

制限

  • 機能の使用制限:

    • DataWorks Professional Edition 以降のエディションのユーザーのみが、[インテリジェント診断] 機能を使用できます。他のエディションを使用している場合は、試用版として無料でこの機能を使用できます。ただし、より多くの機能を使用するには、DataWorks サービスを DataWorks Professional Edition にアップグレードすることをお勧めします。詳細については、「インテリジェント診断」をご参照ください。

    • DataWorks Professional Edition 以降のエディションのユーザーのみが、DAG によって提供される集約、上流分析、および下流分析機能を使用できます。詳細については、「DataWorks Advanced Edition の課金」をご参照ください。

    • 一部の機能は、O&M 権限が付与されているユーザーのみが使用できます。機能のエントリポイントが選択不可になっているか、表示されていない場合は、SettingCenter ページに移動し、管理センターの [ワークスペースのメンバーとロール] ページの [ワークスペースのメンバー] タブで必要な O&M 権限が付与されているかどうかを確認できます。詳細については、「ワークスペースレベルのサービスに対する権限の管理」をご参照ください。

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

    • テストインスタンスを手動で削除することはできません。 DataWorks は、テストインスタンスの有効期限が切れてから約 30 日後にテストインスタンスを削除します。テストインスタンスを実行する必要がなくなった場合は、インスタンスをフリーズできます。

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

    • 専用スケジューリングリソースグループで実行されるテストインスタンスは 1 か月(30 日間)保持され、テストインスタンスの操作ログも 1 か月(30 日間)保持されます。

    • 実行が完了したテストインスタンスに対して生成された操作ログのサイズが 3 MB を超えると、システムは毎日定期的に超過分の操作ログをクリアします。

自動トリガーされたタスクをテストする

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

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

  2. 自動トリガーされたタスクをテストします。

    [オペレーションセンター] ページの左側のナビゲーションウィンドウで、[自動トリガーノード操作] > [自動トリガーノード] を選択します。[自動トリガーノード] ページで、次のいずれかの方法を使用して自動トリガーされたタスクをテストします。

    • 方法 1:自動トリガーされたタスクのリストで、目的の自動トリガーされたタスクを見つけ、[アクション] 列の [テスト] をクリックします。現在のページがリストモードで表示されていない場合は、ページ中央の 箭头 アイコンをクリックできます。現在のページがリストモードで表示されます。

    • 方法 2:目的のタスクの DAG で、タスクを右クリックし、[テスト] を選択します。現在のページが DAG モードで表示されていない場合は、目的のタスクの [アクション] 列の [DAG] をクリックして、タスクの DAG を開くことができます。

  3. [テスト] ダイアログボックスでパラメーターを構成します。冒烟测试

    パラメーター

    説明

    [テスト名]

    テストインスタンスの名前。

    [データタイムスタンプ]

    テストインスタンスのデータタイムスタンプ。

    説明
    • 前日より前の日付を選択すると、テストインスタンスはすぐに実行されます。

    • 前日を選択すると、インスタンスのスケジューリング時間が到着したときにテストインスタンスが実行されます。

インスタンスリストでテストインスタンスを管理する

インスタンスリストで、自動トリガーされたタスクに対して生成されたテストインスタンスのステータスを表示し、関連する操作を実行できます。

列表

操作

説明

[フィルター]

前の図の 1 でマークされた領域で、テストインスタンスを検索するための条件を指定できます。

[タスク名] または [タスク ID] でテストインスタンスを検索できます。また、[ノードタイプ][実行日時][データタイムスタンプ][スケジューリングリソースグループ][マイノード][今日テスト済み][フリーズされたノード] などのフィルター条件を指定してテストインスタンスを検索することもできます。

説明

デフォルトでは、データタイムスタンプは現在の日の前日に設定されています。

[テストインスタンスのリスト]

前の図の 2 でマークされた領域で、指定された条件を満たすテストインスタンスを表示できます。

[アクション]

前の図の 3 でマークされた領域で、テストインスタンスに対して操作を実行できます。

  • [DAG]:この操作を実行して、テストインスタンスの依存関係を表示できます。テストインスタンスの DAG で、インスタンスを右クリックして関連する操作を実行できます。詳細については、「付録:DAG で提供される機能を使用する」をご参照ください。

  • [診断対象]:この操作を実行して、テストインスタンスのエンドツーエンド分析を実行できます。テストインスタンスが期待どおりに実行されない場合は、[診断対象] をクリックして問題のトラブルシューティングを行うことができます。詳細については、「インテリジェント診断」をご参照ください。

  • [再実行]:この操作を実行して、[成功] または [失敗] 状態のテストインスタンスを再実行できます。テストインスタンスが正常に実行されると、[保留中(祖先)] 状態の子孫インスタンスが実行されるようにスケジュールできます。この操作は、実行に失敗したテストインスタンス、またはスケジュールどおりに実行されなかったテストインスタンスを処理するために使用されます。

    説明

    [成功] または [失敗] 状態のテストインスタンスのみを再実行できます。

  • [詳細]

    • [子孫ノードを再実行]:この操作を実行して、[成功] または [失敗] 状態のテストインスタンスの子孫インスタンスを再実行できます。再実行する子孫インスタンスを選択できます。選択したインスタンスが正常に実行されると、[保留中(祖先)] 状態の子孫インスタンスが実行されるようにスケジュールできます。この操作は、データを回復するために使用されます。

      説明

      [成功] または [失敗] 状態の子孫インスタンスのみを選択できます。他の状態のインスタンスの [再実行条件を満たす] 列には [いいえ] という値が表示され、インスタンスを選択できません。

    • [ステータスを成功に設定]:この操作を実行して、実行に失敗したテストインスタンスのステータスを [成功] に設定できます。実行に失敗したテストインスタンスが子孫インスタンスの実行をブロックしたくない場合に、この操作を実行できます。この操作は、実行に失敗したテストインスタンスを処理するために使用されます。

    • [停止]:この操作を実行して、実行する必要のないテストインスタンスを停止できます。テストインスタンスでこの操作を実行すると、テストインスタンスは実行に失敗して終了します。

      説明

      [保留中(スケジュール)][保留中(リソース)]、または [実行中] 状態のテストインスタンスのみを停止できます。

    • [フリーズ]:テストインスタンスとその子孫インスタンスを一定期間実行する必要がない場合に、この操作を実行できます。詳細については、「自動トリガーノードの管理」をご参照ください。

      説明

      ワークスペースのルートノードである projectname_root ノードでは、この操作を実行しないでください。自動トリガーされたタスクのすべてのインスタンスはこのノードに依存しています。このノードがフリーズされている場合、自動トリガーされたタスクのインスタンスを実行できません。

    • [フリーズ解除]:この操作を実行して、フリーズされているテストインスタンスのフリーズを解除できます。

      • テストインスタンスが実行されていない場合は、祖先インスタンスが正常に実行された後に自動的に実行されます。

      • テストインスタンスのすべての祖先インスタンスが正常に実行された場合、テストインスタンスの状態は直接 [失敗] に設定されます。テストインスタンスを手動で再実行する必要があります。

      説明

      フリーズ解除操作は、現在のテストインスタンスに対してのみ有効です。テストインスタンスが生成された自動トリガーされたタスクがフリーズされている場合、翌日実行するようにスケジュールされているインスタンスもフリーズされます。

    • [系列を表示]:この操作を実行して、テストインスタンスの系列を表示できます。

    • [ノードの詳細を表示]:この操作を実行して、テストインスタンスの基本情報を表示できます。

    • [ランタイムログを表示]テストインスタンスが生成された自動トリガーされたタスクが開始された後、この操作を実行して、操作ログに基づいて自動トリガーされたタスクの実行の詳細を表示できます。操作ログのコアパラメーターの詳細については、「付録:操作ログのパラメーター」をご参照ください。

[バッチ操作]

複数のテストインスタンスに対して同時に操作を実行できます。前の図の 4 でマークされた領域にある次のボタンをクリックして、複数のテストインスタンスに対して同時に操作を実行できます:[停止][再実行][ステータスを成功に設定][リソースグループの変更][フリーズ][フリーズ解除]

[1 ページあたりのアイテム数]

前の図の 5 でマークされた領域で、1 ページに表示するアイテム数を選択できます。選択できる最大数は 200 です。

インスタンスの DAG でテストインスタンスを管理する

テストインスタンスのリストで、テストインスタンスの名前、またはテストインスタンスの [アクション] 列の [DAG] をクリックして、テストインスタンスの DAG を開くことができます。 DAG で、テストインスタンスを右クリックして関連する操作を実行できます。DAG图

機能

説明

テストインスタンスの DAG で実行できる操作

テストインスタンスの [アクション] 列の [DAG] をクリックして、テストインスタンスの DAG を開くことができます。テストインスタンスの DAG で、次の操作を実行できます。

  • [検索]:前の図の 1 でマークされた領域で、[ノード名][ノード ID][インスタンス ID]、または [インスタンス名] で目的のテストインスタンスを検索できます。

  • [DAG 表示スタイル]:前の図の 2 でマークされた領域で、アイコンをクリックして、ビジネス要件に基づいて DAG の表示スタイルを調整できます。左から右へのアイコンは、[マップを開く/マップを閉じる、アラートステータスを表示/アラートステータスを非表示][ノードステータスを更新][ズームイン][ズームアウト][1:1][画面に合わせる][フルスクリーンビューの切り替え] です。

単一インスタンスに対する操作

DAG で目的のテストインスタンスを右クリックし、インスタンスに対して操作を実行できます。

  • [コードを表示]:この操作を実行して、現在のテストインスタンスが本番環境で生成されたタスクのコードを表示できます。タスクのコードが期待どおりでない場合は、タスクの最新のコードが本番環境に正常にデプロイされているかどうかを確認する必要があります。

  • [ノードの編集]:この操作を実行して、DataStudio ページで現在のテストインスタンスが生成されたタスクの構成タブに移動できます。

説明

その他の操作の詳細については、「インスタンスリストでテストインスタンスを管理する」をご参照ください。

単一インスタンスの詳細

前の図の 4 でマークされた領域で、次の操作を実行できます。

  • [ログを表示]テストインスタンスが生成された自動トリガーされたタスクが開始された後、この操作を実行して、操作ログに基づいて自動トリガーされたタスクの実行の詳細を表示できます。ログのコアパラメーターの詳細については、「付録:操作ログのパラメーター」をご参照ください。

  • [詳細を表示]:この操作を実行して、[全般]、[コンテキスト]、[ランタイムログ]、[操作ログ]、[コード] の各タブでテストインスタンスの詳細情報を表示できます。詳細については、「テストインスタンスの詳細を表示する」をご参照ください。

テストインスタンスの詳細を表示する

テストインスタンスの DAG で、テストインスタンスをクリックし、キャンバスの右下に表示されるウィンドウで [詳細を表示] をクリックします。次に、[全般]、[コンテキスト]、[ランタイムログ]、[操作ログ]、[コード] の各タブでテストインスタンスの詳細を表示できます。

查看实例详情

タブ

説明

[全般]

このタブでは、本番環境におけるテストインスタンスのスケジューリングプロパティを表示できます。基本パラメーターの詳細については、「リソースプロパティを構成する」をご参照ください。

  • インスタンスステータスの解釈:インスタンスが [保留中(祖先)]、[保留中(スケジュール)]、[保留中(リソース)]、または [フリーズ] 状態の場合、「ノードが正常に実行されるために必要な条件は何ですか?」で説明されている手順に従って問題のトラブルシューティングを行うことができます。

  • リソースの待機時間:テストインスタンスが長時間 [保留中(リソース)] 状態になっている場合は、インテリジェント診断 機能を使用して、現在のテストインスタンスがリソースを待機しているときにリソースを占有しているインスタンスを特定できます。次に、例外が発生したインスタンスをすばやく特定し、問題のトラブルシューティングを行うことができます。

  • 実行時間の延長:テストインスタンスの実行時間が過去の平均実行時間よりもはるかに長い場合は、タスクタイプに基づいて問題のトラブルシューティングを行うことができます。

    • 非同期タスク:非同期タスクに対して生成されたテストインスタンスが実行されているコンピューティングエンジンインスタンスの所有者に相談できます。

    • バッチ同期タスク:バッチ同期タスクに対して生成されたテストインスタンスの実行速度が特定のフェーズで遅くなるか、インスタンスが長時間 [保留中(リソース)] 状態になる場合があります。詳細については、「バッチ同期ノードが長時間実行されている場合はどうすればよいですか?」をご参照ください。

  • ルールベースのモニタリング:現在のインスタンスが生成されたタスクに関連付けられているアラートルールに関する情報を表示できます。タスクにアラートルールが関連付けられていない場合は、[ルールモニタリング] パラメーターの右側にある [作成] をクリックして、タスクのステータスを監視するためのアラートルールをすばやく作成できます。詳細については、「カスタムアラートルールを作成する」をご参照ください。

    説明

    このタブには、テストインスタンスが生成されたタスクに関連付けられているアラートルールに関する情報のみを表示できます。テストインスタンスが生成されたタスクのデータ品質を監視するために使用される監視ルールに関する情報は、このタブには表示されません。

  • ベースラインモニタリング:現在のインスタンスを生成するタスクに関連付けられているベースラインに関する情報を表示できます。タスクがベースラインに関連付けられていない場合は、[ベースラインモニタリング] パラメーターの右側にある [作成] をクリックして、ベースラインをすばやく作成できます。詳細については、「ベースラインの管理」をご参照ください。

[ランタイムログ]

このタブでは、テストインスタンスが生成された自動トリガーされたタスクが開始された後、操作ログに基づいて自動トリガーされたタスクの実行の詳細を表示できます。ログのコアパラメーターの詳細については、「付録:操作ログのパラメーター」をご参照ください。

[操作ログ]

このタブでは、操作日時、オペレーター、特定の操作など、タスクまたはインスタンスの操作レコードを表示できます。

[コード]

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

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

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