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

Dataphin:定期インスタンスの一般操作の概要

最終更新日:Mar 06, 2026

定期インスタンスは、スケジュールに従って実行される定期タスクに基づき、自動的に生成されます。各スケジュールされた定期タスクごとに 1 つのインスタンスが生成されます。これらの生成済みインスタンスは、実行ステータスの確認、再実行、ノードコードの表示などの方法で管理できます。本トピックでは、定期インスタンスの一般的な機能について説明します。

定期インスタンスの生成タイミングと実行ルール

Dataphin は、翌日の定期インスタンスを毎日 23:00 に生成します。デフォルトでは、生成されたインスタンスのステータスは 未実行 です。

  • 定期インスタンスが依存するすべての先祖インスタンスが正常に実行完了した場合、その定期インスタンスのステータスは 未実行 から スケジュール時刻待ち に変更されます。

  • 当該インスタンスのスケジュールされた実行時刻が到来し、Dataphin が十分な利用可能なスケジュールリソースを確保でき、適用されるすべての速度制限ルールを通過した場合、定期インスタンスのステータスは スケジュール時刻待ち から 実行中 に変更されます。

    説明

    定期インスタンスを一時停止すると、現在の定期インスタンスの実行は一時停止されますが、このノードによって生成された他の定期インスタンスの実行には影響しません。複数の定期インスタンスの実行を一時停止するには、このノードのスケジュールプロパティを変更して実行をスキップさせることができます。詳細については、「統合ノードとコンピューティングノードを管理する」をご参照ください。

定期インスタンスページのエントリ

  1. Dataphin のホームページの上部メニューバーで、開発 > タスク O&M を選択します。

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

  3. 左側のナビゲーションウィンドウで、インスタンス O&M > 定期インスタンス を選択します。

定期インスタンスページの概要

定期インスタンスページでは、主に 統合およびコンピュートタスク の一覧と モデリングタスク の一覧が表示されます。このページでは、提出済みの定期インスタンスに対して O&M 操作を実行できます。

image

ブロック

説明

検索およびフィルター領域

  • フィルター自分のインスタンス失敗したインスタンス未完了のインスタンス を選択し、データタイムスタンプおよびプロジェクトを指定して、素早くフィルター処理を行います。以下のフィルター条件もサポートされています:

    • 自分のインスタンス:現在ログイン中のアカウントが担当するすべてのインスタンスです。

    • 失敗したインスタンス:現在ログイン中のユーザーが O&M - アクセスディレクトリ 権限を持つプロジェクト内の、すべての失敗したインスタンスです。

    • 未完了のインスタンス:現在ログイン中のユーザーが O&M - アクセスディレクトリ 権限を持つプロジェクト内の、すべての未完了のインスタンスです。

    • プロジェクト:タスクが存在するプロジェクトでフィルター処理します。現在ログイン中のユーザーが O&M - アクセスディレクトリ 権限を持つ複数のプロジェクトを選択できます。

    • データタイムスタンプ今日昨日すべて、または 特定の日付またはデータタイムスタンプ範囲 を選択します。

    • インスタンスタイプ統合およびコンピュートタスク タイプまたは モデリングタスク タイプを選択します。

    • サブタイプ:選択されたビジネスタイプに応じて、サポートされるサブタイプが異なります。

      • 統合およびコンピュートタスクタイプ: サポートされるサブタイプは、バインドされたコンピュートエンジンの種類に応じて異なります。詳細は画面表示をご確認ください

      • モデリングタスクタイプ: 論理ディメンションテーブル、論理ファクトテーブル、論理集計テーブルをサポートします。

    • 操作所有者:インスタンス O&M の所有者でフィルター処理します。

    • [操作ステータス]: 次の 7 つの操作ステータスをサポートしています。成功失敗実行中スケジュール時刻待機中レート制限中スケジューリングリソース待機中、および未実行。各ステータスの識別子と詳細については、「定期インスタンスの操作ステータスの説明」をご参照ください。

    • 優先度:5 段階のインスタンス実行優先度(最高最低)でフィルター処理します。

      説明

      ベースライン機能が有効化されている場合、タスクの優先度は 中、低、最低 のみをサポートします。

    • 繰り返し周期:複数のスケジュール周期を選択してフィルター処理します。サポートされる周期は 6 種類で、 です。

    • 実行モード:インスタンスの実行モードでフィルター処理します。実行モードには 通常実行ドライラン一時停止実行 があります。

    • 開始実行時刻:定期インスタンスの開始実行時刻でフィルター処理します。直近 1 時間今日昨日、または 特定の日付または業務時間範囲(秒単位) を選択します。

    • 非スケジュール日インスタンス:システムが非スケジュール日に生成したドライランインスタンスです(条件付きスケジュールで設定されたドライランは含みません)。表示 または 非表示 を選択できます。

      説明

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

    • 終了時刻:インスタンスの終了実行時刻でフィルター処理します。直近 1 時間今日昨日、または 特定の日付または業務時間範囲(秒単位) を選択します。

    • スケジュール時刻:定期インスタンスのスケジュール実行時刻でフィルター処理します。0–6 時6–12 時12–18 時、または 特定の時間範囲(秒単位) を選択します。

    • 実行期間:インスタンスの開始から終了までの総時間または範囲でフィルター処理します。

    • リソースグループ:インスタンスの実行時に指定されたスケジュールリソースグループでフィルター処理します。

    • リトライ回数a~b の形式でリトライ回数の範囲を入力します。「a」のデフォルト値は 0、「b」のデフォルト値は空欄です。「b」が空欄の場合、「a」より大きいすべての値が対象となります。「a」と「b」はいずれも 0 以上の整数です。

      説明

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

    • 自動リトライ回数a~b の形式で自動リトライ回数の範囲を入力します。「a」のデフォルト値は 0、「b」のデフォルト値は空欄です。「b」が空欄の場合、「a」より大きいすべての値が対象となります。「a」と「b」はいずれも 0 以上の整数です。

      説明

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

    • タグ:1 つ以上のタスクタグ値を選択してフィルター処理します。

    リセット をクリックすると、すべてのフィルター条件をすばやくクリアし、システムのデフォルト設定に復元できます。

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

    • 一括検索 - 手動入力一括検索 ダイアログボックスで 手動入力 を選択します。最大 5000 個のタスク ID を改行区切りで入力します。入力後、確認 をクリックして検索を実行します。

    • 一括検索 - 文書のアップロード一括検索 ダイアログボックスで ファイル を選択します。アップロード をクリックして Excel ファイルをアップロードします。システムは、Excel ファイルの最初のシートの 最初の列(タスク ID 列)および 2 行目~5001 行目 を自動的に読み取ります。タスク ID リストテンプレートのダウンロード をクリックすると、テンプレートを使用して編集できます。

一覧操作

  • 一覧テーブルヘッダーのカスタマイズimage アイコンをクリックして、一覧表示項目を選択し、表示順序を調整します。

    説明
    • 最初の列および操作列は、表示のキャンセルや順序の調整ができません。

    • ブラウザのキャッシュをクリアした場合や、ブラウザを変更した場合は、テーブルヘッダーがデフォルト設定に復元されます。

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

定期インスタンス一覧

定期インスタンスページでは、現在のユーザーが O&M - アクセスディレクトリ 権限を持つプロジェクト内のすべての定期タスクが、一覧形式で表示されます。これらのタスクは、統合およびコンピュートタスクモデリングタスク の 2 つのカテゴリに分類されます。操作 列には、定期インスタンスでサポートされる O&M 管理操作が表示されます。各定期インスタンスタイプでサポートされる O&M 操作の詳細は、以下のとおりです:

説明

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

バッチ操作

バッチ操作領域を使用すると、定期インスタンスの再実行、停止、成功としてマークしてスケジュールを継続、一時停止、再開、スケジュールリソースグループの変更、優先度の変更などが可能です。これにより、運用効率が向上します。

タイムゾーン変換

テナントのスケジュールタイムゾーンとシステムタイムゾーン(ユーザーセンターに表示)が一致しない場合、タイムゾーン変換機能を使用して、スケジュール実行時刻開始実行時刻終了実行時刻 を、スケジュールタイムゾーン または システムタイムゾーン のいずれかで表示できます。

説明

フィルター内の開始実行時刻、終了時刻、スケジュール時刻は、システムタイムゾーン でのみフィルター処理が可能です。

定期インスタンスのヒントマークの説明

マーク

ヒント

説明

image

データ遅延

データ遅延が有効化された イベント論理ファクトテーブル において、Dataphin が定期インスタンスの正常終了後にデータ遅延を検出した場合に、このマークが表示されます。

image

ドライラン

当該定期インスタンスタスクのスケジュールプロパティがドライランスケジュールに設定されています。

image

一時停止

当該定期インスタンスタスクのスケジュールプロパティが実行スキップに設定されています。

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

ステータスマーク

実行ステータス

説明

test

未実行

実行を開始していないインスタンスです。

test

スケジュールリソース待ち

すべての依存先祖ノードが正常に実行完了し、スケジュールリソースの確保を待っている状態です。

test

速度制限中

現在速度制限が適用されているインスタンスです。

test

スケジュール時刻待ち

すべての依存先祖ノードが正常に実行完了し、スケジュール時刻の到着を待っている状態です。

test

実行中

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

test

失敗

実行に失敗したインスタンスです。

待機中または実行中のインスタンスを停止すると、そのステータスは失敗に変更されます。

test

成功

正常に実行完了したインスタンスです。

システムは、ドライランスケジュールで設定されたインスタンスを直接成功としてマークします。

定期インスタンスの DAG グラフ

定期インスタンス操作一覧内のインスタンスオブジェクト名をクリックすると、右側のページに、当該ノードを中心とした DAG グラフが表示されます。DAG グラフは、ノードの先祖および子孫の依存関係を動的に可視化します。デフォルトでは、メインノード(選択されたノード)およびその第 1 層の先祖・子孫ノードが表示されます。リアルタイムインスタンスに先祖ノードまたは子孫ノードがない場合、DAG グラフには現在のメインノードのみが表示されます。また、先祖および子孫ノードに対する O&M および管理もサポートされます。

DAG グラフの表示範囲は、以下のように調整できます:

  • image アイコンをクリックすると、リアルタイムインスタンス一覧が非表示になり、DAG グラフが拡大表示されます。

  • image アイコンをクリックすると、DAG グラフが非表示になります。

  • image アイコンにマウスポインタを合わせてドラッグすると、DAG グラフの表示範囲を拡大または縮小できます。

モデリングタスクインスタンスの DAG グラフインターフェイス情報は、統合およびコンピュートタスクインスタンスと同一です。以下の図は、統合およびコンピュートタスクインスタンスを例として示しています:

image

セクション

説明

ノード情報

現在選択中のノードの概要情報を表示します。ノード詳細の表示 をクリックすると、インスタンス確率、実行診断、運用ログ、操作ログ、ノードコード、タスクパラメーターなど、さらに詳しいノード情報を確認できます。

  • インスタンス概要:現在のノードの名前、ID、インスタンス ID、テナント、プロジェクトなどの基本情報、実行ステータスおよび実行時間などの実行情報、メモリ/CPU 割り当て量、実際のメモリ/CPU 消費量などのリソース消費情報 を表示します。

    説明
    • SQL タスク(コンピュートエンジン SQL タスクおよびデータベース SQL タスク)を除き、リソース消費情報は、メタデータウェアハウステナントの システム設定 > リソース設定 > スケジュールリソースダッシュボード が有効化されている場合にのみ、定期インスタンスおよびデータバックフィルインスタンスのノード詳細に表示されます。

    • 外部テナントノード(現在のテナントに属さないノード)では、ガントチャートおよび実行診断の表示はサポートされていません。

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

  • 運用ログ:当該インスタンスの成功または失敗時の実行ログを確認できます。

  • 操作ログ:当該インスタンスの操作ログ(操作時刻、オペレーター、具体的な操作内容)を確認できます。

  • ノードコード/マテリアライズコード:当該インスタンスのコードを確認できます。

統合およびコンピュートタスクインスタンス:インスタンス概要、実行診断、運用ログ、操作ログ、ノードコードを含みます。

モデリングタスクインスタンス:インスタンス概要、実行診断、運用ログ、操作ログ、マテリアライズコードを含みます。

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

ノードフィルター領域

メインノードを中心に、上下方向への展開レベルをすばやく設定できます。多くのノードが展開されて表示が困難な場合、ノード名を検索することで、現在の DAG グラフ表示範囲内にある特定のノードを素早く特定できます。

スケジュール依存グラフ

インスタンスのスケジュール依存グラフを表示します。上下方向にさらに多くのノードを展開し、先祖および子孫ノードに対して O&M 操作を実行できます。DAG ノードにマウスポインタを合わせると、そのノードの名前、タイプ、スケジュール周期、O&M 所有者、説明を確認できます。ノードに現在のテナントに属さない先祖または子孫ノードがある場合、外部テナントノードにはクロステナントタグが表示され、親ノードおよび子ノードの展開のみがサポートされます。

キャンバス調整領域

DAG 表示比率をすばやく調整できます。表示比率の設定(デフォルトは 100%)、現在の比率からの拡大(最大 200%)、現在の比率からの縮小(最小 20%)、キャンバスへのフィット、全画面表示が可能です。また、現在の DAG グラフにおけるメインノードのノード ID およびノード名も表示されます。

インスタンスオブジェクト一覧

DAG グラフを表示しているとき、インスタンスオブジェクト一覧には、インスタンスオブジェクトの名前およびデータタイムスタンプが表示されます。インスタンスオブジェクトにマウスポインタを合わせると、ノード名、ノード ID、スケジュール周期、データタイムスタンプ、スケジュール実行時刻を確認できます。以下の図をご参照ください:image.png