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

Dataphin:モデリングタスクインスタンスの管理

最終更新日:Nov 19, 2025

定期的なモデリングタスクインスタンスは、自動トリガータスクがスケジュール構成に従って実行されるたびに自動的に生成されます。これらのインスタンスに対して、実行ステータスの表示、再実行、ノードコードの表示などの運用保守 (O&M) を実行できます。このトピックでは、モデリングタスクインスタンスを表示および管理する方法について説明します。

背景情報

定期的なモデリングタスクインスタンスには、論理ディメンションテーブルインスタンス、論理ファクトテーブルインスタンス、および論理集計テーブルインスタンスが含まれます。論理テーブルタスクがスケジュールされると、対応する論理テーブルタスクインスタンスが生成されます。テーブルまたはフィールドの観点から、論理テーブルタスクインスタンスに対して操作を実行できます。

使用上の注意

標準化モデリングでは、動的マテリアライズロジックが使用されます。次の 2 つの観点から O&M を実行できます。

  • 物理的な O&M の観点からは、最新のマテリアライズされたノードコードまたは実行ログを表示して、マテリアライズされたノードに対する各操作によってどのフィールドまたは論理テーブルタスクノードが影響を受けるかを理解できます。たとえば、論理テーブルタスクノードのデータをバックフィルするには、まず論理テーブルタスクノードが属するマテリアライズノードを特定する必要があります。次に、各マテリアライズノードのデータを個別にバックフィルする必要があります。このプロセスは複雑であり、データ整合性を保証できません。

  • 論理的な O&M の観点からは、操作が必要なフィールドまたは論理テーブルタスクインスタンスを選択するだけで済みます。システムは、現在のマテリアライズメソッドに基づいて、対応するマテリアライズノードを自動的に計算します。また、データ整合性と正確性を確保するために、一緒に操作する必要がある関連フィールドも提案します。物理的な実装について心配する必要はありません。これにより、操作パスが短縮され、O&M コストが削減され、O&M 効率が向上します。

モデリングタスクインスタンスページに移動

  1. Dataphin のホームページの上部のナビゲーションバーで、[開発] > [O&M] を選択します。

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

  3. 上部ナビゲーションバーで、本番環境または開発環境を選択します。

  4. [定期インスタンス] ページで、[モデリングタスク] タブをクリックします。

モデリングタスクインスタンスリストでの操作

自動トリガーモデリングタスクがモデリングタスクインスタンスを生成すると、そのインスタンスは [定期インスタンス] > [モデリングタスク] リストに表示されます。モデリングタスクインスタンスリストには、現在のインスタンスオブジェクトの名前、実行ステータス、スケジューリングサイクル、データタイムスタンプ、スケジュール実行時間、開始時刻、終了時刻、期間、優先度、オーナー、プロジェクト、関連ベースラインインスタンス、およびサポートされている操作が表示されます。

  • インスタンスオブジェクト: 自動トリガータスクが実行されると、定期インスタンスオブジェクトが生成されます。オブジェクトにはテーブル名とテーブル ID が含まれ、タスクのスケジューリングメソッドを識別します。列名の横にある image.png アイコンをクリックして、オブジェクトを名前の昇順または降順でソートします。詳細については、「定期インスタンスインジケーターマークの説明」をご参照ください。

  • 実行ステータス: モデリングの実行ステータスには、フィールドとノードの実行ステータスが含まれます。フィールドの横にある image アイコンをクリックして、各実行ステータスの詳細を表示します。

    フィールドの実行ステータスは、論理テーブル内のすべてのフィールドの実行ステータスを表します。たとえば、test アイコンは、論理テーブル内のフィールドに [成功][未実行] の 2 つのステータスがあることを示します。フィールド実行ステータスアイコンの横の数字は、現在の論理テーブルノード内のフィールド数を示します。ノードの横の数字は、現在の論理テーブルノード内のマテリアライズノードの数を示します。また、fagag アイコンをクリックして、各フィールドの正規化された実行ステータスを表示することもできます。実行ステータスインジケーターの説明については、「定期インスタンスの実行ステータスの説明」をご参照ください。

    フィールドの実行ステータスは、それが属するすべてのマテリアライズノードの実行ステータスによって決まります。最終的に表示されるステータスは、フィールドの正規化された実行ステータスです。ルールは次のとおりです。

    • フィールドが属する materialized ノードの少なくとも 1 つの実行状況が 成功の場合、フィールドの正規化されたステータスは 成功です。

    • フィールドが属するすべてのマテリアライズノードの実行ステータスが [失敗] の場合にのみ、フィールドの正規化されたステータスは [失敗] になります。

    • フィールドが属する materialized ノードの少なくとも 1 つの実行状況が 実行中の場合、フィールドの正規化されたステータスは 実行中です。

    • フィールドが属する materialized ノードの一部の実行状況が 待機中で、一部の実行状況が 未実行または 失敗の場合、フィールドの正規化されたステータスは 待機中です。

    • フィールドが属するすべての materialized ノードの実行状況が 未実行の場合、フィールドの正規化されたステータスは 未実行です。

  • 実行開始時刻: インスタンスが実行を開始した時刻。列名の横にある image.png アイコンをクリックして、開始時刻の昇順または降順でソートします。

    説明

    論理テーブルノードの開始時刻は、インスタンスオブジェクトの最も早い内部マテリアライズノードの開始時刻です。

  • 実行終了時刻: インスタンスの実行が終了した時刻。列名の横にある image.png アイコンをクリックして、終了時刻の昇順または降順でソートします。

    説明

    論理テーブルノードの終了時刻は、インスタンスオブジェクトの最も遅い内部マテリアライズノードの終了時刻です。

  • 実行期間: インスタンスの実行開始から終了までの合計時間。列名の横にある image.png アイコンをクリックして、期間の昇順または降順でソートします。

    説明

    論理テーブルノードの期間は、インスタンスオブジェクトの最も早い内部マテリアライズノードの開始時刻と最も遅い内部マテリアライズノードの終了時刻の差です。

  • 優先度: インスタンスの優先度レベル。

    説明

    ベースライン機能が有効になっている場合、ベースラインタスクはすべてのベースラインの中で最も高い優先度を持ちます。これは、元々構成されていたタスクの優先度をオーバーライドします。

  • プロジェクト: タスクが属するプロジェクト。フォーマットは プロジェクト英語名 (プロジェクト中国語名) です。

  • 関連ベースラインインスタンス: ノードが終了ノードとして属するベースラインを表示します。また、保護範囲にノードを先祖ノードとして含む関連ベースラインも表示します。

    説明

    ベースライン機能が有効になっていない場合、このフィールドは表示されません。

モデリングタスクインスタンスリストでは、次の操作がサポートされています。

操作

説明

DAG

image アイコンをクリックして、定期インスタンスの DAG を表示します。詳細については、「定期インスタンスの DAG」をご参照ください。

実行ログの表示

image アイコンをクリックして、定期インスタンスの実行ログを表示します。

再実行

image アイコンをクリックして、定期インスタンスを再実行します。実行ステータスが [成功] または [失敗] のスクリプトインスタンスのみを再実行できます。インスタンスを再実行すると、システムは現在のインスタンスノードのすべての先祖ノードの実行ステータスが [成功] であるかどうかを確認します。チェックが失敗した場合、現在のインスタンスの実行ステータスは [未実行] に設定されます。

ビジネスシナリオで再実行が必要な場合は、強制再実行を実行します。詳細については、「現在のインスタンスを強制的に再実行する」をご参照ください。

ガントチャートの表示

説明

ガントチャートを表示するには、IT 運用向け人工知能付加価値サービスを購入し、現在のテナントで IT 運用向け人工知能モジュールを有効にする必要があります。

image アイコンをクリックし、[ガントチャートの表示] を選択して [ガントチャートの表示] ダイアログボックスを開きます。次に、次のパラメーターを構成します。

  • 選択したノードを次のように設定: 現在のノードを [開始ノード] または [終了ノード] として設定します。開始ノードを選択した場合、現在のノードがデフォルトで開始ノードとして選択され、変更できません。終了ノードを選択した場合も同様です。

  • 開始ノード: ガントチャートの開始ノードを選択します。ノードのキーワードで検索できます。リスト内のノードは {ノード名}({ノード ID, {インスタンススケジュール実行時間}}) のフォーマットで表示されます。選択したノードが終了ノードとして設定されている場合、開始ノードはデフォルトでテナントルートノードになります。

    説明

    時間単位および分単位のタスクには複数のノードがあります。各インスタンスはノードです。ノードは、インスタンスのスケジュール実行時間によって区別されます。

  • 終了ノード: ガントチャートの終了ノードを選択します。ノードのキーワードで検索できます。リスト内のノードは {ノード名}({ノード ID, {インスタンススケジュール実行時間}}) のフォーマットで表示されます。

    説明

    論理テーブルが終了ノードとして選択されている場合、論理テーブルは全体として扱われるため、フィールドを選択することはできません。

ガントチャートの詳細については、「クリティカルパスのガントチャートを表示する」をご参照ください。

フィールドおよびバッチ操作

image アイコンをクリックし、[フィールドとバッチ操作] を選択して、モデリングタスクインスタンス内のフィールドに対してバッチ O&M 操作を実行します。詳細については、「論理テーブルのフィールドおよびバッチ操作」をご参照ください。

本番リネージの表示

image アイコンをクリックし、[本番リネージの表示] を選択して、論理テーブルインスタンス内のフィールドのマテリアライズリネージとマテリアライズノードのフィールドグループを表示します。詳細については、「論理テーブルのフィールドおよびバッチ操作」をご参照ください。

消費リネージの表示

image アイコンをクリックし、[消費リネージの表示] を選択して、論理テーブルタスクインスタンス内のフィールドの依存関係を表示します。これにより、フィールドを管理する際に子孫ノードへの影響を分析できます。詳細については、「論理テーブルのフィールドおよびバッチ操作」をご参照ください。

マテリアライゼーションコードの表示

image アイコンをクリックし、[マテリアライゼーションコードの表示] を選択して、論理テーブルインスタンスのマテリアライゼーションコードを表示します。

定期タスク

image アイコンをクリックし、[定期タスク] を選択して、論理テーブルインスタンスに対応する論理テーブルタスクを表示します。

[開発ノードの編集]

image アイコンをクリックし、[開発ノードの編集] を選択します。開発環境で、クリックしてインスタンスの開発ページに移動します。このページでインスタンスを変更できます。

説明

Dev-Prod モードを使用するプロジェクトのスクリプトインスタンスに対してのみ、開発ノードを編集できます。

[本番ノードの表示]

image アイコンをクリックし、[本番ノードの表示] を選択します。本番環境で、クリックしてインスタンスの本番ページに移動します。

説明

Dev-Prod モードを使用するプロジェクトのスクリプトインスタンスに対してのみ、開発ノードを編集できます。

[ノードの編集]

image アイコンをクリックし、[ノードの編集] を選択します。基本プロジェクトで、クリックしてスクリプトインスタンスを生成するスクリプトタスクを編集できるページに移動します。

説明

基本モードを使用するプロジェクトのスクリプトインスタンスに対してのみ、開発ノードを編集できます。

[ダウンストリームの再実行]

image アイコンをクリックし、[下流の再実行] を選択して、インスタンスの子孫ノードを再実行します。実行ステータスが [成功] または [失敗] のスクリプトインスタンスの子孫ノードのみを再実行できます。実行ステータスが [待機中] または [実行中] のインスタンスは再実行できません。詳細については、「下流ノードの再実行」をご参照ください。

リネージ全体を再実行するには、下流インスタンスの強制再実行機能を使用します。詳細については、「下流インスタンスの強制再実行」をご参照ください。

下流の再実行操作は、次のシナリオでよく使用されます。

  • 現在のインスタンスノードのデータが更新された後、子孫ノードのデータを同期する必要があります。

  • インスタンスの子孫ノードの実行に失敗した後、子孫ノードを再実行する必要があります。

[成功に設定 & 再開]

image アイコンをクリックし、[成功に設定して再開] を選択して、[失敗] または [未実行] のスクリプトインスタンスノードの実行ステータスを手動で [成功] に設定します。その後、ノードは引き続きスケジュールされます。詳細については、「ステータスを [成功] に設定してスケジューリングを続行する」をご参照ください。

停止

image アイコンをクリックし、[停止] を選択して、現在実行中のインスタンスを停止します。停止後、インスタンスのノードステータスは [失敗] に変わります。現在のインスタンスノードの実行が停止すると、その子孫ノードは実行されません。

説明

ノードステータス[成功][失敗]、または [未実行] のインスタンスは停止できません。他のノードステータスのインスタンスは停止できます。

停止操作は、次のシナリオでよく使用されます。

  • Dataphin の例外または操作エラーにより、インスタンスを停止する必要があります。

  • スクリプトは実行中と表示されますが、データは生成されていません。実行を手動で停止し、実行ログで例外を確認できます。

[強制再実行]

image アイコンをクリックし、[強制再実行] を選択します。次に、[現在のインスタンスを強制的に再実行] または [下流インスタンスを強制的に再実行] を選択します。

  • 現在のインスタンスを強制的に再実行: 強制的に再実行する場合、システムは先祖ノードの実行ステータスをチェックしません。すべての先祖ノードが正常に実行されていない場合、現在のインスタンスの再実行に失敗したり、誤ったデータが生成されたりする可能性があります。注意して進めてください。現在のスクリプトインスタンスを強制的に再実行すると、そのデータが更新されます。詳細については、「現在のインスタンスを強制的に再実行する」をご参照ください。

  • 下流インスタンスを強制的に再実行: 下流インスタンスを強制的に再実行すると、すべてのインスタンスが [未実行] に設定されます。これにより、上流インスタンスが再実行されている間に下流インスタンスが実行されることによって引き起こされる可能性のあるデータの混乱を防ぎます。上流の依存関係とスケジュールされた実行時間のチェックは、開始点に対してのみスキップされます。子孫ノードは、引き続き依存関係とインスタンストリガー条件に従う必要があります。下流インスタンスの強制再実行

    インスタンストリガー条件の詳細については、「依存関係と実行ルール」をご参照ください。

重要

強制再実行では、すべての先祖ノードが正常に実行されたかどうか、または現在のインスタンスのスケジュールされた実行時間に達したかどうかはチェックされません。これにより、実行の失敗やデータ品質の問題のリスクが生じます。続行する前に、下流データに影響がないことを確認してください。

アップストリーム依存関係の削除

image アイコンをクリックし、[上流依存関係の削除] を選択して、実行ステータスに関係なくスクリプトインスタンスの上流依存関係を削除します。

重要

少なくとも 1 つの上流インスタンスを保持する必要があります。

[一時停止]

image アイコンをクリックし、[一時停止] を選択します。ステータスが [未実行][スケジューリング時間待機中]、または [スロットリング] のインスタンスのみを一時停止できます。これは、スクリプトタスクに対応する他のインスタンスの実行には影響しません。インスタンスを一時停止すると、現在のスクリプトインスタンスノードとその依存する子孫インスタンスノードはスケジュールされません。

説明

一時停止操作は、リソースが限られている場合によく使用されます。優先度の低いインスタンスを一時停止して、優先度の高いタスクが最初に実行されるようにすることができます。

再開

image アイコンをクリックし、[再開] を選択して、[一時停止] されたスクリプトインスタンスノードを再開します。再開後、現在のスクリプトインスタンスノードとその子孫インスタンスノードは通常どおりスケジュールされます。

[優先度の変更]

image アイコンをクリックし、[優先度の変更] を選択します。[優先度の変更] ダイアログボックスで、現在のタスクの優先度を変更します。[最高][高][中][低]、または [最低] を選択できます。

説明

論理集計テーブルには複数の優先度を設定できます。

モデリングタスクインスタンス DAG ノードの操作

有向非巡回グラフ (DAG) は、インスタンスノードの上流および下流の依存関係を明確に示します。システムは、上流および下流のインスタンスノードの O&M もサポートしています。デフォルトでは、DAG はメインノード (選択されたノード) とその第 1 レベルの先祖ノードおよび子孫ノードを表示します。モデリングタスクインスタンスノードを選択して、インスタンスに対して O&M 操作を実行できます。

Dataphin は、プロジェクト間のインスタンスノードの O&M をサポートしています。プロジェクト間のモデリングタスクインスタンスノードに対して O&M 操作を実行するには、インスタンスが属するプロジェクトの表示権限と操作権限が必要です。集計テーブルインスタンスの場合、権限を持つメトリックに対してのみ操作を実行できます。

  • DAG でサポートされる操作

    操作

    説明

    [親ノードの展開]

    DAG 内のメインノードの異なるレベルの依存ノードを展開します。

    [子ノードの展開]

    [タスクの表示]

    現在のインスタンスノードを生成したタスクノードの DAG に移動します。タスクノードの詳細と、その先祖ノードおよび子孫ノードに関する情報を表示できます。タスクノードに対して O&M を実行することもできます。詳細については、「モデリングタスクの管理」をご参照ください。

    [マテリアライズノードの展開]

    論理テーブルに対応する内部マテリアライズノードを展開します。

    マウスポインターをマテリアライズノードボックスの上に置きます。次に、右クリックするかアイコンをクリックして、ノードコード、マテリアライズノードフィールド、およびマテリアライズノードの実行ログを表示します。image

    操作ログの表示

    インスタンスに対して実行された操作のログ情報を表示します。

  • DAG ノードでサポートされる操作

    マウスポインターを DAG ノードの上に置くと、その名前、タイプ、スケジューリングサイクル、オーナー、および説明を表示できます。モデリングタスクインスタンスの DAG ノードでサポートされる操作は、モデリングタスクインスタンスリストでサポートされる操作と同じです。詳細については、「モデリングタスクインスタンスリストでの操作」をご参照ください。

モデリングタスクインスタンスのバッチ操作

操作

説明

[すべての失敗したインスタンスを再実行]

複数のモデリングタスクインスタンスを選択します。次に、リストの下部で [失敗したすべてのインスタンスを再実行][望ましい状態のすべてのインスタンスを再実行]、または [すべてのインスタンスを強制的に再実行] を選択します。

  • 失敗したすべてのインスタンスを再実行: 失敗したすべてのインスタンスノードをバッチで再実行します。

  • 望ましい状態のすべてのインスタンスを再実行: 望ましい状態にあるすべてのインスタンスノードをバッチで再実行します。

  • すべてのインスタンスを強制的に再実行: 現在のインスタンスノードと、まだ実行されていないその子孫インスタンスノードをバッチで強制的に再実行します。

停止

ノードステータス[成功][失敗]、または [未実行] のインスタンスは停止できません。他のノードステータスのインスタンスは停止できます。ノードステータス[成功][失敗]、または [未実行] のインスタンスのみを選択した場合、バッチ停止操作はサポートされません。

[成功に設定 & 再開]

バッチで、[失敗] または [未実行] のインスタンスノードの実行ステータスを [成功] に設定します。その後、ノードは引き続きスケジュールされます。

[一時停止]

ステータスが [未実行][スケジューリング時間待機中]、または [スロットリング] のインスタンスのみを一時停止できます。これらのステータスのいずれかを持つインスタンスを選択しない場合、バッチ一時停止操作はサポートされません。

再開

一時停止されている定期インスタンスを再開します。

優先度の変更

バッチで、選択したインスタンスの優先度を変更します。[最高][高][中][低]、または [最低] を選択できます。

説明

論理集計テーブルには複数の優先度を設定できます。

すべてダウンロード

すべての定期インスタンスデータをローカルファイルにダウンロードします。これには、統合、コンピューティング、およびモデリングタスクインスタンスのデータが含まれます。ファイルは .xlsx 形式で、名前は Dataphin_recurring_instance_{timestamp}.xlsx です。

ファイルには次の情報が含まれます: インスタンスオブジェクト、インスタンス ID、実行ステータス、スケジューリングサイクル、データタイムスタンプ、優先度、オーナー、プロジェクト (複数のプロジェクトを持つ論理集計テーブルの場合、プロジェクト名はカンマで区切られます)、スケジュール実行時間、開始時刻、終了時刻、期間、リトライ回数/自動リトライ回数、関連ベースラインインスタンス (複数のベースラインを持つインスタンスの場合、ベースライン名はカンマで区切られます)、およびスケジューリングリソースグループ (このパラメーターはモデリングタスクインスタンスでは空です)。

下流ノードの再実行

  1. [ダウンストリームの再実行] ダイアログボックスで、パラメーターを構成します。

    説明
    • モデリングタスクの再実行は、正規化ステータスが「成功」または「失敗」であるフィールドの子孫ノードに対してのみサポートされています。モデリングタスクインスタンス自体も、実行ステータスが[成功]または[失敗]である必要があります。論理テーブルの実行ステータスとフィールドの正規化ステータスの詳細については、「モデリングタスクインスタンスリストでの操作」をご参照ください。

    • ステータスの制限により子孫ノードを再実行できないが、ビジネスシナリオで必要な場合は、強制再実行を実行できます。詳細については、「現在のインスタンスを強制的に再実行する」をご参照ください。

    • 基本情報

      フィールドの実行ステータスでフィルタリングしたり、名前でターゲットフィールドを検索したりできます。

      [必須フィールドを優先] オプションは、Dataphin が再実行範囲に含める必要があると判断したフィールドを表示します。この判断は、フィールドロジックと先祖ノードのデータ変更に基づいて、データ品質を確保するために行われます。

      説明

      データ整合性と正確性を確保するために、選択したフィールドのマテリアライズノード内のすべてのフィールド、および関連フィールドの他のマテリアライズノード内のすべてのフィールドも再実行されます。

      パラメーター

      説明

      [開始ノード]

      下流ノードを再実行するための開始ノードを選択します。テーブル全体または特定のフィールドを選択できます。

      • テーブル全体: 論理テーブルインスタンス内のすべてのフィールドの下流インスタンスを再実行します。

      • 特定のフィールド: 必要に応じて、子孫ノードを再実行する必要があるフィールドを指定します。

        フィールドの実行ステータスでフィルタリングしたり、名前でターゲットフィールドを検索したりできます。

      [開始ノードの実行モード]

      開始ノードの実行モードを定義します。ドライランまたは通常実行を選択できます。

      • ドライラン: インスタンスのステータスは成功 (通常スケジューリング) と表示されますが、実行ログは空で、実行期間はなく、データは実際には処理されません。

      • [通常実行]: 通常のスケジュール。

    • 下流構成

      下流の再実行範囲

      説明

      [すべての失敗したインスタンス]

      現在のインスタンスに依存し、実行に失敗したフィールドとその関連フィールドのみを再実行します。

      カスタム設定

      再実行する下流ノードをカスタマイズするには、このオプションを選択します。ノード名または ID で検索したり、実行ステータス、オーナー、プロジェクトでフィルタリングしたりできます。

      実行失敗、子孫ノードレベル、必須フィールドの優先順位付けによって下流インスタンスノードをフィルタリングできます。また、ノード名または ID を入力して下流ノードをすばやくフィルタリングすることもできます。

  2. [送信] をクリックします。

    下流ノードが再実行されると、そのデータが更新されます。

現在のインスタンスを強制的に再実行する

  1. [現在のインスタンスを強制的に再実行 - 論理テーブル] ダイアログボックスで、再実行パラメーターを設定します。

    強制再実行範囲

    説明

    テーブル全体

    論理テーブル内のすべてのフィールドを強制的に再実行します。

    特定のフィールド

    必要に応じて、再実行するフィールドを指定します。正規化された実行ステータスに関係なく、現在の論理テーブルインスタンス内の任意のフィールドを強制的に再実行できます。

    フィールドの実行ステータスでフィルタリングしたり、名前でターゲットフィールドを検索したりできます。

  2. [OK] をクリックします。関連する必須フィールドを示すダイアログボックスが表示されます。フィールドを確認し、[OK] をクリックします。

    データ整合性と正確性を確保するために、選択したフィールドのマテリアライズノード内のすべてのフィールド、および関連フィールドの他のマテリアライズノード内のすべてのフィールドも強制的に再実行されます。

ダウンストリームインスタンスの強制再実行

  1. [下流インスタンスの強制再実行 - 論理テーブル] ダイアログボックスで、構成方法を選択し、パラメーターを構成します。

  2. 下流インスタンスの強制再実行は、[クイック構成][カスタム構成] をサポートしています。詳細は次のとおりです。

    • クイック構成

      a. テーブル全体を開始ノードとして選択し、開始点の実行モードを指定します。

      パラメーター

      説明

      開始ノード

      クイック構成の場合、開始ノードはデフォルトでテーブル全体に設定されます。これは、論理テーブルインスタンス内のすべてのフィールドが開始ノードであることを意味します。

      開始ノードの実行モード

      開始ノードの実行モードを定義します。ドライランまたは通常実行を選択できます。

      • ドライラン: インスタンスのステータスは成功 (通常スケジューリング) と表示されますが、実行ログは空で、実行期間はなく、データは実際には処理されません。

      • 通常実行: 通常のスケジュールです。

      b. 強制的な下流の再実行の範囲を選択します。

      クイック構成の場合、下流の強制再実行範囲は、現在の論理テーブルインスタンスに依存するすべての下流インスタンスにデフォルト設定されます。

    • カスタム構成

      • 基本情報

        パラメーター

        説明

        開始ノード

        下流ノードを再実行するための開始ノードを選択します。Dataphin は、テーブル全体または特定のフィールドの選択をサポートしています。

        • テーブル全体: 論理テーブルインスタンス内のすべてのフィールドの下流インスタンスを強制的に再実行します。

        • 特定のフィールド: 必要に応じて、子孫ノードを強制的に再実行する必要があるフィールドを指定します。

          フィールドの実行ステータスでフィルタリングしたり、名前でターゲットフィールドを検索したりできます。

        開始ノードの実行モード

        開始ノードの実行モードを定義します。Dataphin は、ドライランまたは通常実行の選択をサポートしています。

        • ドライラン: インスタンスのステータスは成功 (通常スケジューリング) と表示されますが、実行ログは空で、実行期間はなく、データは実際には処理されません。

        • 通常実行: 通常のスケジュールです。

      • 下流構成

        パラメーター

        説明

        下流の強制再実行範囲

        強制的な下流の再実行の範囲を選択します。すべてのインスタンスまたはカスタム構成を選択できます。

        • すべてのインスタンス: 選択したフィールドのすべての子孫インスタンスノード。

        • カスタム構成: 強制的な下流の再実行のノードをカスタマイズするには、このオプションを選択します。フィールド名で検索したり、実行ステータスでフィルタリングしたりできます。

        フィールドリスト

        必須フィールドを優先してフィールドをフィルタリングできます。また、フィールド名を入力してフィールドをすばやくフィルタリングすることもできます。

        必須フィールドを優先すると、Dataphin が強制再実行範囲に含める必要があると判断したフィールドが表示されます。この判断は、フィールドロジックと先祖ノードのデータ変更に基づいて、データ品質を確保するために行われます。

  3. [送信] をクリックします。関連する必須フィールドを示すダイアログボックスが表示されます。フィールドを確認し、[OK] をクリックします。

    データ整合性と正確性を確保するために、選択したフィールドのマテリアライズノード内のすべてのフィールド、および関連フィールドの他のマテリアライズノード内のすべてのフィールドも強制的に再実行されます。

論理テーブルのフィールドおよびバッチ操作

[フィールドとバッチ操作] リストページには、現在の論理テーブルのフィールドが表示されます。情報には、フィールド名、実行ステータス、フィールドタイプ、開始時刻、終了時刻、期間、およびサポートされている操作が含まれます。

操作

説明

本番リネージの表示

モデリングタスクインスタンス内のフィールドのマテリアライズリネージとマテリアライズノードのフィールドグループを表示します。

image

① 現在のモデリングタスクインスタンスノードのフィールドとその実行ステータスを表示します。クリックして異なるフィールドを選択できます。選択したフィールドの本番リネージが右側に表示されます。

② 選択したフィールドのマテリアライズリネージを表示します。

③ マテリアライズノードのすべてのフィールドを表示します。

④ 現在のモデリングノードのマテリアライズノードを表示します。論理テーブルノードに複数のマテリアライズノードがある場合、エリア ④ をクリックしてそれらを切り替え、情報を表示します。

実行ログ表示

現在のインスタンス実行のログを表示します。

[マテリアライズコードの表示]

モデリングタスクインスタンス内のすべてのマテリアライズノードのマテリアライズコードを表示します。

image

[マテリアライズコードの表示] ページで、エリア ① のすべてのマテリアライズノードを切り替えて、そのコードを表示できます。また、エリア ② の test アイコンにマウスポインターを合わせると、そのマテリアライズノードに属するフィールドを表示できます。

消費リネージの表示

モデリングタスクインスタンスノード内のフィールドの依存関係を表示します。これにより、フィールドを管理する際に子孫ノードへの影響を分析できます。

image

① 現在のモデリングタスクインスタンスノードのフィールドを表示します。異なるフィールドを選択できます。選択したフィールドの消費リネージが右側に表示されます。

② 選択したフィールドの子孫ノードを表示します。これにより、フィールドを管理する際に子孫ノードへの影響を分析できます。

再実行

Dataphin は、実行ステータスが [成功] または [失敗] の論理テーブルインスタンスと、正規化されたステータスが [成功] または [失敗] のフィールドのみの再実行をサポートしています。再実行後、現在のインスタンスの再実行されたフィールドとその子孫インスタンスノードのデータが更新されます。

論理テーブルインスタンスの実行ステータスとフィールドの正規化されたステータスの制限により再実行操作を実行できないが、ビジネスシナリオで必要な場合は、強制再実行を実行できます。詳細については、「現在のインスタンスを強制的に再実行する」をご参照ください。

[ダウンストリームの再実行]

Dataphin は、実行ステータスが [成功] または [失敗] のモデリングタスクインスタンスで、正規化されたステータスが [成功] または [失敗] のフィールドの子孫ノードのみの再実行をサポートしています。

モデリングタスクインスタンスの実行ステータスとフィールドの正規化されたステータスの制限により下流ノードを再実行できないが、ビジネスシナリオで必要な場合は、強制再実行を実行できます。「現在のインスタンスを強制的に再実行する」をご参照ください。

下流の再実行操作は、次のシナリオでよく使用されます。

  • 現在のインスタンスノードのデータが更新された後、子孫ノードのデータを同期する必要があります。

  • インスタンスの子孫ノードの実行に失敗した後、子孫ノードを再実行できます。

[停止]

ノードステータス[成功][失敗]、または [未実行] のインスタンスは停止できません。他のノードステータスのインスタンスは停止できます。インスタンスが停止されると、そのノードステータスは [失敗] に変わります。現在のインスタンスノードの実行が停止すると、その子孫ノードは実行されません。

停止操作は、次のシナリオでよく使用されます。

  • Dataphin の例外または操作エラーにより、インスタンスを停止する必要があります。

  • スクリプトは実行中と表示されますが、データは生成されていません。実行を手動で停止し、実行ログで例外を確認できます。

強制再実行

強制再実行では、すべての先祖ノードが正常に実行されたかどうか、または現在のインスタンスのスケジュールされた実行時間に達したかどうかはチェックされません。これにより、実行の失敗やデータ品質の問題のリスクが生じます。続行する前に、下流データに影響がないことを確認してください。詳細については、「現在のインスタンスを強制的に再実行する」をご参照ください。

下流インスタンスの強制再実行の詳細は次のとおりです。

  • 下流インスタンスを強制的に再実行すると、すべてのインスタンスが [未実行] に設定されます。これにより、上流インスタンスが再実行されている間に下流インスタンスが実行されることによって引き起こされる可能性のあるデータの混乱を防ぎます。

  • 上流の依存関係とスケジュールされた実行時間のチェックは、開始点に対してのみスキップされます。子孫ノードは、引き続き依存関係とインスタンストリガー条件に従う必要があります。詳細については、「下流インスタンスの強制再実行」をご参照ください。

[一時停止]

フィールドの現在のスケジューリングサイクルを一時停止状態に設定します。フィールドを一時停止すると、その現在のスケジューリングサイクルは一時停止されますが、他のスケジューリングサイクルには影響しません。

[成功に設定 & 再開]

[失敗] または [未実行] のフィールドの実行ステータスを手動で [成功] に設定します。その後、フィールドは引き続きスケジュールされます。詳細については、「ステータスを [成功] に設定してスケジューリングを続行する」をご参照ください。

再開

Dataphin は、[一時停止] されたフィールドのみの再開をサポートしています。一時停止されたフィールドが再開されると、システムは現在のノードが実行条件を満たしているかどうかを確認します。

  • すべての先祖ノードが正常に実行されました。

  • 現在のフィールドがスケジュールされた実行時間に達しました。

これらの条件が満たされると、フィールドは自動的に実行を開始します。条件が満たされない場合、フィールドの凍結状態のみがキャンセルされます。フィールドは、条件が満たされたときに実行を開始します。

ステータスを成功に設定してスケジューリングを続行

  1. [成功に設定してスケジューリングを続行 - 論理テーブル] ダイアログボックスで、操作の範囲を選択します。

    • 失敗したフィールド: 正規化された実行ステータスが [失敗] のすべてのフィールドが [成功] に設定されます。

    • 未実行のフィールド: 正規化された実行ステータスが [未実行] のすべてのフィールドが [成功] に設定されます。

    • 失敗したフィールドと未実行のフィールド: 正規化された実行ステータスが [失敗] または [未実行] のすべてのフィールドが [成功] に設定されます。

    • カスタム構成: フィールドリストで、正規化された実行ステータスが [失敗] または [未実行] の論理テーブルインスタンス内のフィールドを選択して、そのステータスを [成功] に設定します。

  2. [OK] をクリックして設定を完了します。