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

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

最終更新日:Mar 06, 2026

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

背景情報

定期実行タスクでスモークテストを実行して、本番環境で期待どおりに実行されることを確認できます。このプロセスによりテストインスタンスが生成され、そのステータスをテストインスタンスページで追跡できます。

説明

テストインスタンスは実際のコードロジックを実行します。慎重に操作してください。

制限事項

  • 機能の制限事項:

    • インテリジェント診断機能は、DataWorks Professional Edition 以降で利用できます。無料トライアルも利用可能ですが、すべての機能にアクセスするには Professional Edition へのアップグレードを推奨します。詳細については、「インテリジェント診断」をご参照ください。

    • DAG におけるノードの集約、上流分析、下流分析機能は、DataWorks Professional Edition 以降でのみ利用できます。詳細については、「エディションと課金」をご参照ください。

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

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

    • テストインスタンスは手動で削除できません。有効期限が切れると自動的に削除されます。通常は 30 日後です。タスクを実行する必要がなくなった場合は、インスタンスを凍結できます。

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

    • スケジューリング用の専用リソースグループの場合、タスクインスタンスとログの両方が 30 日間保持されます。

    • 完了したインスタンスの実行ログが 3 MB を超える場合、毎日クリアされます。

  • テストインスタンスは、タスクの 最大並列インスタンス数 の制限にも従い、定期実行インスタンスおよびデータ補完インスタンスと同時実行クォータを共有します。複数のタイプのインスタンスがキューに入れられた場合、前日までのデータ補完インスタンスの優先度のみが 8 から 3 に引き下げられます。

スモークテストの実行

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

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

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

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

    • 方法 1:リストビューで、目的のタスクを見つけ、操作 列の スモークテスト をクリックします。リストビューでない場合は、箭头 アイコンをクリックしてリストビューに切り替えます。

    • 方法 2:DAG ビューで、対象のノードを右クリックし、スモークテスト を選択します。DAG ビューでない場合は、対象タスクの 操作 列にある DAG をクリックして DAG を開きます。

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

    パラメーター

    説明

    スモークテスト名

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

    データタイムスタンプ

    テストのデータタイムスタンプを選択します。

    説明
    • 昨日より前のデータタイムスタンプを選択した場合、タスクはすぐに実行されます。

    • 昨日のデータタイムスタンプを選択した場合、タスクはスケジュールされた時刻に実行されます。

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

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

列表

操作

説明

フィルター

前の図のセクション 1 では、フィルターを使用して特定のインスタンスを検索できます。

タスク名タスク IDノードタイプ実行時刻データタイムスタンプスケジューリングリソースグループマイノード本日私がスモークテストしたタスク、および 凍結されたノード でフィルターできます。

説明

デフォルトでは、インスタンスは前日のデータタイムスタンプでフィルターされます。

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

前の図のセクション 2 には、フィルター条件に一致するテストインスタンスのリストが表示されます。

操作

前の図のセクション 3 では、テストインスタンスに対して次の操作を実行できます。

  • DAG:DAG は、テストインスタンスの上流および下流の依存関係を示します。DAG 内でインスタンスに対する操作を実行できます。詳細については、「付録:DAG 機能の概要」をご参照ください。

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

  • 再実行:成功または失敗したタスクを再実行します。再実行が成功すると、その下流タスクがトリガーされます。これは、失敗したノードや実行漏れを処理するためによく使用されます。

    説明

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

  • その他

    • 下流ノードを再実行:成功または失敗したタスクの下流ノードを再実行します。再実行する下流ノードを選択できます。再実行が成功すると、その下流タスクがトリガーされます。これは、データ修正のためによく使用されます。

      説明

      この操作は、成功 または 失敗 ステータスのタスクでのみ利用できます。他のステータスのノードを選択すると、選択範囲に実行できないノードが含まれています というメッセージが表示され、続行できません。

    • 成功に設定:失敗したタスクのステータスを成功に設定し、その下流タスクを実行できるようにします。これは、失敗したノードを処理するためによく使用されます。

    • 停止:実行する必要がなくなったタスクを停止します。タスクのステータスは停止後に失敗に変わります。

      説明

      待機中 (スケジュール)待機中 (リソース)、または 実行中 ステータスのインスタンスのみを停止できます。

    • 凍結:タスクとその下流タスクを一定期間実行する必要がない場合に使用します。詳細については、「定期実行タスクの管理」をご参照ください。

      説明

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

    • 凍結解除:凍結されたインスタンスを再開します。

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

      • すべての上流タスクがすでに完了している場合、このインスタンスは失敗します。正しく実行されるようにするには、手動で再実行する必要があります。

      説明

      凍結解除操作は、この特定のインスタンスにのみ影響します。対応する定期実行タスクがまだ凍結されている場合、翌日に生成される新しいインスタンスも凍結ステータスになります。

    • 系列を表示:現在のインスタンスの系列情報を表示します。

    • ノード詳細を表示:現在のインスタンスの基本情報を表示します。

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

一括操作

前の図のセクション 4 では、複数のタスクを選択して、停止再実行成功に設定リソースグループの変更凍結凍結解除 などの一括操作を実行できます。

ページあたりの項目数

前の図のセクション 5 では、ページごとに表示される項目数を変更できます。1 ページあたり最大 200 項目まで表示できます。

テストインスタンスの DAG

テストインスタンス の DAG を開くには、リストビューでインスタンス名をクリックするか、操作 列の DAG をクリックします。DAG 内のインスタンスを右クリックして、さまざまな操作を実行できます。DAG图

機能

説明

DAG パネルの機能

タスクの DAG をクリックして、その DAG を開きます。DAG ビューでは、次の操作を実行できます。

  • 検索:前の図のセクション 1 では、ノード名ノード IDインスタンス ID、または インスタンス名 でインスタンスをフィルターできます。

  • DAG の表示スタイルを変更:前の図に示されているモジュールのエリア 2 では、DAG インターフェイスの右上隅にある機能アイコンをクリックして、表示スタイルを変更できます。左から右へ、アイコンは マップを開く/マップを閉じるアラートステータスを有効化/アラートステータスを無効化ノードステータスを更新DAG キャンバスを拡大DAG キャンバスを縮小キャンバス上のすべてのノードを 1:1 の比率で配置ウィンドウサイズに基づいて自動的に 画面に合わせる、および フルスクリーン切り替え です。

単一インスタンスの操作

対象のノードを右クリックして、次の操作を実行できます。

  • コードを表示:本番環境のノードの現在のコードを表示します。コードが期待どおりでない場合は、ノードの最新バージョンが公開されていることを確認してください。

  • ノードを編集:データ開発ページで現在のノードを開きます。

説明

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

単一インスタンスの詳細

前の図のセクション 4 では、次の操作を実行できます。

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

  • 詳細を表示:現在のタスクのプロパティ、コンテキスト、実行ログ、操作ログ、およびコードを表示します。詳細については、「インスタンス詳細の表示」をご参照ください。

インスタンス詳細の表示

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

查看实例详情

タブ

説明

全般

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

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

  • リソース待機時間:タスクがリソースを待機する時間が長すぎる場合は、インテリジェント診断 機能を使用して、どのタスクがリソースを消費しているかを特定し、問題のあるタスクを見つけます。

  • 過剰な実行時間:タスクの実行時間が過去の平均よりも大幅に長い場合は、次のシナリオに基づいて対処します。

    • 非同期タスクの場合は、対応するエンジンの担当者に連絡してください。

    • オフラインデータ同期タスクの場合、特定のステージが遅いか、リソースを長時間待機している可能性があります。詳細については、「オフラインデータ同期の一般的な問題」をご参照ください。

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

    説明

    タスク実行ステータスを監視するルールの詳細のみを表示でき、データ品質監視ルールは表示できません。

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

  • 最大並列インスタンス数:タスクで同時に実行できるインスタンスの最大数を示します。値は 無制限 または 1 から 10,000 までの数値です。この設定は、単一タスクの同時実行を制限し、定期実行インスタンス、データ補完インスタンス、およびテストインスタンスに影響します。

実行ログ

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

操作ログ

タスクまたはインスタンスの操作レコードを表示します。これには、時間、オペレーター、および特定の操作が含まれます。

コード

本番環境の現在のタスクの最新コードを表示します。コードが正しくないと思われる場合は、最新バージョンが公開されていることを確認してください。詳細については、「タスクの公開」をご参照ください。

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

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