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

Dataphin:インスタンス実行診断

最終更新日:Jun 06, 2026

定期インスタンス または バックフィルインスタンス の実行は、その 予定時刻 に加えて、上流タスクのステータス、リソースの可用性、スロットリングルールなど、複数の要因に影響されます。これに対処するため、Dataphin は、インスタンスの実行プロセスと依存関係チェーン全体を分析するインスタンス実行診断機能を提供します。インスタンスが期待どおりに実行されない場合、この機能を使用して問題を迅速に特定できます。

制限事項

  • 実行診断は、オフラインの 定期インスタンスバックフィルインスタンス (スクリプト、詳細テーブル、サマリーテーブル、抽出インスタンスを含む) でのみ利用可能です。リアルタイムインスタンス (リアルタイムコンピューティングとリアルタイム統合を含む) や 手動インスタンス はサポートされていません。

  • 詳細テーブルとサマリーテーブルのインスタンスでは、分析はマテリアライズされたノードレベルでのみ利用可能で、フィールドレベルでは利用できません。

概要

運用保守 では、インスタンスの 実行ステータス が異なる色やアイコンで示され、それぞれが実行プロセスの段階を表します。これらのインジケーターを使用して、インスタンスの現在の段階を判断したり、実行されない理由を特定したりできます。インスタンスの実行ステータスと全体的な実行プロセスは次のとおりです。

ステータスアイコン

説明

実行プロセス図

test

未実行

image.png

test

予定時刻待機中

test

スロットリング

test

スケジューリングリソース待機中

test

実行中

test

成功

test

失敗

インスタンスが正常に実行されるかどうかは、上流依存関係、予定時刻、利用可能なリソース、および自身の実行ステータスなど、複数の要因に依存します。インスタンスが失敗した場合や、単一の 実行ステータス に長時間留まっている場合は、実行診断機能を使用して、以下のチェック項目に基づいて問題を分析できます。

項目

説明

上流依存関係

上流インスタンスの 実行ステータス をチェックします。現在のインスタンスは、すべての上流インスタンスが正常に完了し、依存関係ポリシーを満たした後にのみ実行されます。上流インスタンスのステータスがポリシーを満たさない場合、現在のインスタンスはブロックされます。上流依存関係 の診断結果を参照して、失敗の原因を調査できます。

予定時刻

インスタンスの 予定時刻 に達しているかどうかをチェックします。

スロットリングルール

現在のインスタンスによってトリガーされたスロットリングルールと、現在のキューで既にディスパッチされているインスタンスのリストを表示できます。

スケジューリングリソース

インスタンスがスケジューリングリソースを待機している時間と、その リソースグループ 内で現在リソースを使用しているインスタンスの全リストを表示できます。その後、提供された診断の提案に基づいて対応できます。

インスタンス実行

インスタンスの実行結果と実行ログを表示できます。

実行診断へのアクセス

  1. Dataphin ホームページの上部メニューで、[Develop] > [O&M] を選択します。

  2. 左側メニューで、[Instance O&M] > [Recurring Instance][Backfill Instance]、または [Manual Instance] を選択します。

  3. [Recurring Instance][Backfill Instance]、または [Manual Instance] ページで、対象のインスタンスの名前をクリックします。右側の DAG の下にある [View Node Details] をクリックします。

    次の図は [Recurring Instance] ページを例として示しています。image

  4. ノード詳細ページで、[Run Diagnosis] タブをクリックします。

上流依存関係

上流依存関係 の診断では、インスタンスの前回の実行結果と、その上流インスタンスの現在のステータスが表示されます。現在のインスタンスは、すべての上流インスタンスが完了した後にのみ、次のチェックに進みます。診断結果を使用して、失敗の原因を調査できます。前回の実行で 上流依存関係 の診断に合格したインスタンスは、再診断されません。前回の実行結果または上流インスタンスのステータスを更新するには、刷新 更新アイコンをクリックします。

  • インスタンスの前回の実行が成功し、それが 強制再実行 でなかった場合、診断結果は [Passed] となります。

    機能

    説明

    [前回の実行]

    前回の実行の 実行ステータス と完了時刻を表示します。

    説明

    インスタンスは、すべての上流依存関係が満たされた後にのみスケジュールされます。

    [現在の診断結果]

    診断結果を表示します。

    • [スケジューリングタイプ] には、[ドライラン][通常実行]、および [実行中断] があります。現在のインスタンスのスケジューリングタイプが [実行中断] の場合、実行するには [スケジューリングの再開] を行う必要があります。

    • [ルートブロックノード]:依存関係チェーン内で現在のノードの実行を妨げている最上位のノードを表示します。上流診断に合格したインスタンスには ルートブロックノード はありません。

    • [直接アップストリームリスト]: 直接のアップストリーム依存関係のリストを表示します。ノード名、ノード ID、またはインスタンス ID で検索し、[実行ステータス] または [所有者] で絞り込むことができます。

  • インスタンスが実行を開始しておらず、そのスケジューリングが中断されていない場合、診断結果のスケジューリングタイプは 通常実行 となります。プロンプトに従って、[ルートブロッキングノード] に注目してください。ブロッキングノードの問題を解決すると、現在のノードが実行できるようになります。現在のインスタンスは、すべての上流インスタンスが正常に実行された後にのみスケジューリングされます。

  • インスタンスが現在 suspended running 状態の場合、診断は停止し、結果は [suspended running] になります。

  • 強制再実行 は上流依存関係のチェックをバイパスします。インスタンスの前回の実行が 強制再実行 だった場合、診断結果は [Skipped] となります。

予定時刻

このチェックでは、インスタンスが 予定時刻 に達したかどうかを判断します。表示されるのは最新の実行結果です。インスタンスは、その 予定時刻 に達した後にのみ実行がスケジュールされます。それ以外の場合は、予定時刻待機中の状態のままです。診断結果を更新するには、刷新 更新アイコンをクリックします。

  • インスタンスがまだ scheduled time に達しておらず、そのスケジューリングが 中断されていない 場合、診断結果は [スケジュール時刻待ち] になります。インスタンスを早期に実行するには、下流のデータ品質に影響を与えないことを確認した上で、[強制再実行] を実行できます。

  • インスタンスが、スケジューリングが一時停止されているために suspended running 状態の場合、診断結果は一時停止です。実行するには、[スケジューリングの再開] をクリックします。

  • インスタンスが前回の実行で 予定時刻 に達し、それが 強制再実行 でなかった場合、診断結果は Passed となります。

  • 強制再実行予定時刻 のチェックをバイパスし、即座に開始されます。インスタンスの前回の実行が 強制再実行 だった場合、診断結果は [Skipped] となります。

スロットリングルール

インテリジェント O&M アドオン機能を購入している場合は、スロットリングルールを設定できます。手順については、「スロットリング設定」をご参照ください。

すべてのインスタンスは、スロットリングルールに基づいてチェックされます。上流依存関係予定時刻 のチェックに合格した後、インスタンスはリソーススケジューリングシステムにディスパッチされる前に、すべての一致するスロットリングルールも満たす必要があります。診断結果を更新するには、刷新 更新アイコンをクリックします。

  • インスタンスの前回の実行が 上流依存関係と 予定時刻 のチェックに合格し、かつ すべての一致するスロットリングルールも満たしていた 場合、診断結果は [Passed] となります。

  • インスタンスが現在ディスパッチを待機中にスロットリングされており、そのスケジューリングが 中断されていない 場合、診断結果は [スロットリング] となります。待機している時間も表示されます。

    項目

    説明

    [ブロッキングルール]

    現在のインスタンスがトリガーした スロットリングルール の名前を表示します。ルール名をクリックして詳細を表示できます。

    [ディスパッチされたインスタンスのリスト]

    トリガーされた スロットリングルール のキュー内で既にディスパッチされたインスタンスをリスト表示します。ディスパッチされたインスタンスを名前または ID で検索またはフィルタリングできます。

  • インスタンスが スケジューリングが中断されている ために 実行中断 状態にある場合、診断結果は [中断] となります。リソーススケジューリングのためにディスパッチされる前に、インスタンスの実行を再開する必要があります。

スケジューリングリソース

共有の実行リソースを使用するインスタンスは、一般的に スケジューリングリソース の可用性の影響を受けにくいです。しかし、専用リソースを使用するインスタンスは、スケジュールされる前に、割り当てられた リソースグループ に十分なアイドルリソースができるのを待つ必要があります。そうでない場合、そのステータスは スケジューリングリソース待機中 となります。診断結果を更新するには、刷新 更新アイコンをクリックします。

  • 前回の実行時にインスタンスの リソースグループ に割り当て可能なアイドルリソースが十分にあり、そのスケジューリングが 中断されていない 場合、診断結果は Passed となります。

  • 現在のインスタンスに対して利用可能なアイドルスケジューリングリソースが十分にない場合、診断結果は スケジューリングリソース待機中 となります。スケジューリングリソース の診断ページには、[リソース待機時間]、診断の [提案]、および [リソース占有インスタンス] のリストが表示されます。提案に基づいて対応し、リソース占有インスタンス のリストを使用して、現在のインスタンス用にリソースを解放できます。

インスタンス実行

実行段階に達したインスタンスのみが [インスタンス実行] 診断ページに表示されます。このページには、[実行結果] と [実行ログ] が表示されます。[実行結果] が [失敗] の場合、[実行ログ] を使用して問題をトラブルシューティングできます。診断結果を更新するには、刷新 更新アイコンをクリックします。

[Open Run Log] をクリックすると、[Run Log] ページに移動します。実行ログ には、エラーメッセージ、パフォーマンス診断、およびエラーコードが含まれています。パフォーマンス診断の詳細については、「オフライン統合タスクのパフォーマンス診断」をご参照ください。