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

Dataphin:定期インスタンスの運用保守

最終更新日:Aug 01, 2026

定期インスタンスは、定期タスクがスケジューリング設定に基づいて実行される際に生成されるインスタンスです。スケジュール実行ごとに 1 つのインスタンスが生成されます。生成されたインスタンスに対して、実行ステータスの表示、再実行、ノードコードの表示などの運用保守を実行できます。このトピックでは、定期インスタンスの一般的な機能について説明します。

インスタンスの生成と実行ルール

毎日 23:00 に、Dataphin は翌日の定期インスタンスを生成します。デフォルトでは、これらのインスタンスのステータスは [not started] です。

  • インスタンスの上流の依存関係がすべて成功すると、そのステータスは [not started] から [waiting for scheduling time] に変わります。

  • 定期インスタンスのステータスは、スケジュールされた時刻に達し、十分なリソースが利用可能で、すべてのスロットリングルールチェックに合格すると、[waiting for scheduling time] から [running] に変わります。

    説明

    インスタンスを一時停止しても、影響が及ぶのは現在の実行のみで、同じタスクの他のインスタンスには影響しません。複数の定期インスタンスを一時停止するには、タスクのスケジューリングプロパティを [pause scheduling] に変更します。詳細については、「統合タスクとコンピュートタスクの管理」をご参照ください。

定期インスタンスへのアクセス

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

  2. 上部メニューで、本番環境または開発環境を選択します。

  3. 左側メニューで、[Instance O&M] > [Periodic instances] を選択します。

定期インスタンスページ

[Periodic instances] ページには、[Integration and Compute Tasks][Modeling Tasks] のリストが表示されます。このページから、表示されたインスタンスに対して運用保守操作を実行できます。

image

エリア

説明

検索およびフィルターエリア

  • フィルター[my instances][failed instances][unfinished instances] を選択するか、業務日付とプロジェクトを選択することで、すばやくフィルタリングできます。以下のフィルターオプションもサポートされています。

    • [My Instances]:現在ログインしているアカウントのすべてのインスタンス。

    • [Failed Instances]:現在ログインしているユーザーが [Operations - Access Directory] 権限を持つプロジェクト内のすべての失敗したインスタンス。

    • [Unfinished Instances]:現在ログインしているユーザーが [O&M - Access Directory] 権限を持つプロジェクト内のすべての未完了のインスタンス。

    • [Project]:タスクが属するプロジェクトでフィルタリングします。現在のユーザーが [O&M - Access Directory] 権限を持つ複数のプロジェクトを選択できます。

    • [業務日付]:[Today][Yesterday][All]、または 特定の日付や業務日付の範囲 を選択できます。

    • [Instance type][Integration and compute tasks] または [Modeling tasks] を選択できます。

    • [Sub-type]:選択した業務タイプに応じて、サポートされるサブタイプは次のとおりです。

      • [Integration and Compute Tasks]:利用可能なサブタイプは、紐づけられたコンピュートソースタイプによって異なります。詳細については、UI を参照してください。

      • [Modeling tasks]:利用可能なサブタイプは、ディメンション論理テーブル、ファクト論理テーブル、および集計論理テーブルです。

    • [Owner]:インスタンスの所有者でフィルタリングできます。

    • [Run status][Succeeded][Failed][Running][Waiting for Scheduling Time][Throttling][Waiting for Scheduling Resources][Not Started] の 7 つの実行ステータスでフィルタリングできます。各ステータスの詳細については、「定期インスタンスの実行ステータス」をご参照ください。

    • [Priority][Highest][High][Medium][Low][Lowest] の 5 つのインスタンス実行優先度でフィルタリングできます。

      説明

      ベースライン機能が有効になっている場合、Medium、Low、Lowest のタスク優先度のみがサポートされます。

    • [Scheduling Cycle]:複数のスケジューリングサイクルを選択できます。[Minute][Hour][Day][Week][Month][Year] の 6 つのスケジューリングサイクルがサポートされています。

    • [Run Mode]:インスタンスを実行モードでフィルタリングします。オプションは [Normal run][dry run][Paused run] です。

    • [Start Time]:定期インスタンスを開始時刻に基づいてフィルタリングします。オプションには、[Last hour][Today][Yesterday]、または 特定の日または時間範囲 (秒単位まで正確) が含まれます。

    • [Instances on non-scheduling days]:これらは、非スケジューリング日にシステムによって自動的に生成される空実行 (no-op) インスタンスです。これには、条件付きスケジューリング設定によって作成されたインスタンスなど、手動で設定された空実行インスタンスは含まれません。利用可能なアクションは [Show] または [Hide] です。

      説明

      論理テーブルインスタンスの場合、インスタンスが非表示になるのは、そのすべてのフィールドが非スケジューリング日のドライランである場合のみです。

    • [End Time]:インスタンスを終了時刻でフィルタリングします。[Last hour][Today][Yesterday]、または 特定の日付または時間範囲 (秒単位まで正確) を選択できます。

    • [Scheduled Time]:定期インスタンスを予定実行時刻でフィルタリングできます。[00:00-06:00][06:00-12:00][12:00-18:00]、または 特定の時間範囲 (秒単位まで正確) を選択できます。

    • [Runtime Duration]:インスタンスを総実行時間または実行時間範囲でフィルタリングできます。

    • [Scheduling Resource Group]:インスタンスの指定された実行時間のスケジューリングリソースグループでフィルタリングできます。

    • [Retry Count]:再試行回数の範囲は a~b の形式です。a と b には 0 または正の整数を入力できます。a のデフォルト値は 0 です。b が空の場合、a より大きいすべての値を意味します。

      説明

      このフィルターオプションは、モデリングタスクではサポートされていません。

    • [Auto-retry Attempts]:自動再試行回数の範囲は a~b の形式です。a のデフォルト値は 0 です。b が空の場合、範囲には a より大きいすべての値が含まれます。a と b には 0 または正の整数を入力できます。

      説明

      このフィルターオプションは、モデリングタスクではサポートされていません。

    • [Tags]:フィルタリングに使用する 1 つ以上のタスクタグ値を選択します。

    • [Directory]:選択したプロジェクト内の、統合タスク、コンピュートタスク、データ収集、およびワークフローインスタンスを含むディレクトリでフィルタリングします。

      説明

      統合タスクとコンピュートタスクのみが、特定のディレクトリによるフィルタリングをサポートします。

    [Reset] をクリックすると、すべてのフィルターがクリアされ、システムデフォルトの設定に戻ります。

  • 検索:ノード ID またはノード名を入力して、定期インスタンスを検索できます。また、検索ボックスの image アイコンをクリックして [Batch Search] ダイアログボックスを開くこともできます。[Batch Search] ダイアログボックスでは、複数のタスク ID を手動で入力するか、ドキュメントをアップロードして検索できます。一括検索は、他のフィルター条件と組み合わせることもできます。

    • [Batch Search - Manual Input][Batch Search] ダイアログボックスで [Manual Input] を選択し、最大 5,000 個のタスク ID を改行区切りで入力し、[OK] をクリックして検索します。

    • ドキュメントをアップロードして一括検索[Batch Search] ダイアログボックスで [Upload Document] を選択し、[Upload] をクリックして Excel ファイルをアップロードします。システムは、最初のシート最初の列 (タスク ID 列) の 2 行目から 5,001 行目までのデータを自動的に読み取ります。[Download Task ID List Template] をクリックしてテンプレートをダウンロードして使用できます。

リスト操作

  • リスト列のカスタマイズimage アイコンをクリックして、表示する列を選択し、順序を調整します。

    説明
    • 最初の列と [操作] 列は非表示にしたり、順序を変更したりすることはできません。

    • ブラウザのキャッシュをクリアしたり、ブラウザを切り替えたりすると、列の設定はデフォルトに戻ります。

  • リストの更新image アイコンをクリックして、現在のリストを更新します。

定期インスタンスリスト

[Periodic Instance] ページには、[O&M - Access Directory] 権限を持つプロジェクトのすべての定期タスクが一覧表示されます。これらのタスクは [Integration and Compute Tasks][Modeling Tasks] に分かれています。[操作] 列には、各定期インスタンスで実行可能な運用保守操作が表示されます。各列の幅は調整できます。設定はローカルのブラウザに保存され、ブラウザの履歴とクッキーをクリアすると消去されます。各定期インスタンスタイプで実行可能な運用保守操作は次のとおりです。

説明

定期インスタンスリストには、現在のテナントのインスタンスのみが表示されます。

一括操作

一括操作エリアを使用して、複数の定期インスタンスに対して再実行、終了、成功に設定して続行、一時停止、再開、スケジューリングリソースグループの変更、優先度の変更などの操作を実行できます。

タイムゾーン変換

テナントのスケジューリングタイムゾーンとシステムタイムゾーン (ユーザーセンターに表示されるタイムゾーン) が一致しない場合、タイムゾーン変換を使用して [Scheduled Run Time][Start Run Time][End Run Time][scheduling time zone] または [system time zone] のいずれかで表示できます。

説明

[Start Time]、[End Time]、[Scheduled Time] フィルターは、[System Time Zone] に基づくフィルタリングにのみ対応しています。

定期インスタンスのインジケーター

アイコン

ラベル

説明

image

遅延

データ遅延検出が有効になっている イベントファクト論理テーブル の場合、データ遅延が検出されると、成功した定期インスタンスにこのインジケーターが表示されます。

image

ドライラン

この定期インスタンスタスクのスケジューリングプロパティは、ドライランに設定されています。

image

一時停止

この定期インスタンスタスクのスケジューリングプロパティは、スケジューリングの一時停止に設定されています。

定期インスタンスの実行ステータス

ステータスアイコン

実行ステータス

説明

test

未開始

まだ実行が開始されていないインスタンス。

test

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

すべての上流ノードの依存関係が成功し、インスタンスはスケジューリングリソースを待機しています。

test

スロットリング中

インスタンスはスロットリングされています。

test

スケジューリング時刻の待機中

すべての上流ノードの依存関係が成功し、インスタンスはスケジュールされた時刻を待機しています。

test

実行中

インスタンスは現在実行中です。

test

失敗

インスタンスの実行に失敗しました。

待機中または実行中のインスタンスを終了すると、そのステータスは失敗に変わります。

test

成功

インスタンスは正常に実行されました。

ドライランのインスタンスは、システムによって自動的に成功としてマークされます。

定期インスタンスの DAG

定期インスタンスリストでインスタンスオブジェクト名をクリックすると、対応するノードを中心とした DAG が右側に表示されます。DAG は、ノードの上流および下流の依存関係を動的かつ視覚的に表現します。デフォルトでは、メインノード (選択されたノード) とその直接の上流および下流ノードが表示されます。インスタンスに上流または下流ノードがない場合、DAG には現在のメインノードのみが表示されます。上流および下流ノードで運用保守を実行することもできます。

DAG ビューは次のように調整できます。

  • image アイコンをクリックしてインスタンスリストを非表示にし、DAG を拡大します。

  • image アイコンをクリックして DAG を非表示にします。

  • image アイコンにカーソルを合わせてドラッグし、DAG ビューを拡大または縮小します。

モデリングタスクインスタンスの DAG インターフェイスは、統合タスクとコンピュートタスクインスタンスと同じです。次の図では、統合タスクとコンピュートタスクインスタンスを例として使用しています。

image

エリア

説明

ノード情報

現在選択されているノードの概要情報が表示されます。[View Node Details] をクリックすると、インスタンスの概要、実行診断、実行ログ、操作ログ、ノードコード、タスクパラメーターなど、より詳細なノード情報を表示できます。

  • [Instance Overview]:基本情報 (ノード名、ID、インスタンス ID、テナント、プロジェクトなど)、実行情報 (実行ステータスや実行時間など)、およびリソース消費量 (メモリ/CPU 割り当てと実際のメモリ/CPU 使用量) を表示します。

    説明
    • SQL タスク (コンピュートエンジン SQL タスクおよびデータベース SQL タスク) を除き、Lakehouse テナントの [System Settings] > [Resource Settings][Scheduling Resource Dashboard] が有効になっている場合にのみ、定期インスタンスおよびバックフィルインスタンスのノード詳細にリソース消費情報が表示されます。

    • ガントチャートと実行診断機能は、外部テナントノード (現在のテナントにないノード) では利用できません。

  • [Run Diagnosis]:現在のインスタンスの上流の依存関係、予定時刻、スロットリングルール、スケジューリングリソース、およびインスタンスの実行を表示します。詳細については、「インスタンスの実行診断」をご参照ください。

  • [Run Log]:成功または失敗したインスタンスの実行ログを表示します。

  • [Operation Log]:現在のインスタンスの操作ログを表示します。これには、操作時間、操作者、および具体的なアクションが含まれます。

  • [Node Code] / [マテリアライズドコード]:現在のインスタンスのコードを表示します。

統合タスクとコンピュートタスクインスタンス:インスタンスの概要、実行診断、実行ログ、操作ログ、[Node Code] が含まれます。

モデリングタスクインスタンス:インスタンスの概要、実行診断、実行ログ、操作ログ、[マテリアライズドコード] が含まれます。

外部テナントノード (現在のテナントにないノード):インスタンスの概要のみを表示します。

ノードフィルターエリア

ビューが混雑している場合は、ノード名で検索して特定のノードを見つけることができます。

スケジューリング依存関係グラフ

インスタンスのスケジューリング依存関係グラフを表示します。さらに上下流ノードを展開し、これらのノードに対して運用保守操作を実行できます。DAG ノードにカーソルを合わせると、その名前、タイプ、スケジューリングサイクル、所有者、説明が表示されます。他のテナントのノードはクロステナントラベルでマークされ、親ノードと子ノードの展開のみに対応しています。

キャンバスコントロール

スケール (デフォルトは 100%) の設定、ズームイン (最大 200%)、ズームアウト (最小 20%)、DAGをキャンバスにフィットさせる、またはフルスクリーン表示の有効化により、DAG の表示スケールをすばやく調整できます。さらに、現在の DAG のメインノードのノード ID と名前が表示されます。

インスタンスオブジェクトリスト

DAG を表示すると、インスタンスオブジェクトリストにインスタンスオブジェクト名と業務日付が表示されます。インスタンスオブジェクトにカーソルを合わせると、そのノード名、ノード ID、スケジューリングサイクル、業務日付、および予定実行時間が表示されます。次の図をご参照ください:image.png