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

Dataphin:ワンタイムタスクの管理

最終更新日:May 31, 2025

ワンタイムタスクとは、オペレーションセンターに送信され、スケジュールタイプが手動ノードであるタスクです。 ワンタイムタスクは自動的に実行されません。 インスタンスは、タスクを手動でトリガーして実行した場合にのみ生成されます。 このトピックでは、ワンタイムタスクの運用および保守機能について説明します。

ワンタイムタスクページへのアクセス

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

  2. 左側のナビゲーションウィンドウで、[タスク操作] > [ワンタイムタスク] を選択して、[ワンタイムタスク] ページを開きます。

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

ワンタイムタスクページの概要

ワンタイムタスクページは、フィルタリングおよび検索エリア、フィルタリングエリア、ワンタイムタスクリスト、およびバッチ操作エリアで構成されています ワンタイムタスクページで、送信されたワンタイムタスクに対して運用および保守操作を実行できます。

image

セクション

説明

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

タスクオブジェクト名または ID を入力してワンタイムタスクをフィルタリングできます。これは、タスクオブジェクト名または ID がわかっている場合に、必要なワンタイムタスクをすばやくフィルタリングするのに役立ちます。 フィルタリングのために [マイタスク] または [今日更新] を選択することもできます。

  • [マイタスク]: 現在のアカウントが所有者であるワンタイムタスク。

  • [今日更新]: 現在の日に更新されたワンタイムタスク。

  • [フィルター:] [フィルター] をクリックして、フィルタリングエリアを展開します。 フィルタリングオプションには、次のものがあります。

    • [タスクタイプ]: Dataphin で作成された手動タスクタイプでフィルタリングします。 サポートされているタスクタイプは、環境によって異なります。 詳細については、実際のページ表示を参照してください。

    • [操作所有者]: タスクの運用および保守所有者でフィルタリングします。

    • [優先度]: タスク実行の優先度でフィルタリングします。 [最高][高][中][低][最低] など、複数の優先度を選択できます。

    • [更新時間]: フィルタリングのために [今日] または [カスタム時間範囲] を選択できます。

    • [プロジェクト]: タスクが属するプロジェクトでフィルタリングします。 現在ログインしているユーザーに [操作 - ディレクトリへのアクセス] 権限がある複数のプロジェクトを選択できます。

    • [リソースグループ]: ワンタイムタスクに構成されているスケジュールリソースグループでフィルタリングします。 複数のリソースグループを選択できます。

    再選択する必要がある場合は、[リセット] をクリックして、選択したすべてのフィルター条件をすばやくクリアします。

ワンタイムタスクリストエリア

ワンタイムタスクページには、オペレーションセンターにサブミットされたワンタイムタスクがリスト形式で表示されます。 リストには、現在の [タスクオブジェクト][優先度][操作所有者][プロジェクト][HTTP パス][リソースグループ][最終更新日時]、およびサポートされている [アクション] が表示されます。

  • [プロジェクト]: タスクが属するプロジェクト。 プロジェクトの英語名(プロジェクトの中国語名) の形式で表示されます。

  • [HTTP パス]: 選択した本番環境または開発環境に応じて、DATABRICKS_SQL タイプタスクの本番環境 HTTP パスまたは開発環境 HTTP パスが表示されます。

    説明

    この項目の表示は、DATABRICKS_SQL タイプのタスクのみでサポートされています。 他のタスクタイプでは - が表示されます。

  • [リソースグループ]: タスクインスタンスの実行時に使用されるスケジュールリソースグループの名前。

    タスクに指定されたカスタムリソースグループがアクティブな状態ではない場合、プロジェクトのデフォルトリソースグループに自動的に置き換えられます。 プロジェクトのデフォルトリソースグループがアクティブな状態ではない場合、テナントのデフォルトリソースグループに自動的に置き換えられます。 優先度は [カスタムリソースグループ > プロジェクトのデフォルトリソースグループ > テナントのデフォルトリソースグループ] です。

    説明

    プロジェクトのデフォルトリソースグループを変更すると、ここに表示される更新に遅延が生じる場合があります。 ただし、実際の実行では、変更されたリソースグループが使用されます。

    テナントのデフォルトリソースグループ: いずれのプロジェクトにも属していません。 テナント には、デフォルトリソースグループが 1 つだけあります。 タスクで個別のカスタムリソースグループが指定されていない場合、またはプロジェクトでプロジェクトのデフォルトリソースグループが指定されていない場合、テナントのデフォルトリソースグループがスケジューリングに使用されます。これは、排他的リソースタスク(SQL タスク、仮想タスクなどを除く)の場合のみです。

  • [アクション]: リストの [アクション] 列には、ワンタイムタスクでサポートされている運用および保守管理操作が表示されます。 詳細については、「ワンタイムタスクリストでサポートされている操作」をご参照ください。

バッチ操作エリア

バッチ操作エリアで提供される運用・保守機能を使用して、ワンタイムタスクをバッチで処理し、運用効率を向上させることができます。操作の詳細については、「ワンタイムタスクのバッチ操作」をご参照ください。

ワンタイムタスクリストでサポートされている操作

操作

説明

[ノードコードの表示]

コード詳細ページに移動して、ワンタイムタスクのノードコードを表示できます。

インスタンスの表示

タスク実行によって生成されたワンタイムインスタンスを表示します。 ワンタイムインスタンスで運用および保守管理を実行することもできます。

[実行]

タスクを手動でトリガーして実行します。 詳細については、「ワンタイムタスクを実行する」をご参照ください。

[開発ノードの編集]

開発プロジェクトのタスクの編集ページに移動して、タスクを編集します。 これは、開発 - 本番開発モードにのみ適用されます。

説明

開発ノードを編集した後、本番ノードデータを更新するために、送信または公開する必要があります。

[ノードの編集]

タスクのノードを編集します。 これは、基本モードにのみ適用されます。

説明

ノードを編集した後、本番ノードデータを更新するために、送信または公開する必要があります。

[ノードスクリプトの表示]

パイプラインタスクの関連する依存関係グラフを表示します。

説明

Data Integration モジュールから送信されたワンタイムタスクのみが、ノードスクリプトの表示をサポートしています。

[本番ノードの表示]

本番プロジェクトに移動して、タスクノードデータを表示します。

[操作オーナーの変更]

タスクの運用および保守所有者を変更します。

説明
  • これは、本番および基本プロジェクトのタスク(つまり、本番環境タスク)にのみ適用されます。

  • テナント内のメンバーのみを選択できます。

監視とアラートの構成

タスク実行の監視ルールを構成します。 タスク実行中に監視ルールがトリガーされると、システムからアラートメッセージが送信され、異常を迅速に検出してビジネスデータの正常な生成を確保できます。 具体的な操作については、「オフラインタスク監視の概要」をご参照ください。

説明

システムは、本番および基本プロジェクトのタスク(つまり、本番環境タスク)の監視の構成のみをサポートしています。

[HTTP パスの変更]

対応するタスクの本番環境 HTTP パスを変更します。 本番プロジェクトの対応するクラスタ用に構成されたすべての HTTP パスから選択できます。

説明

この操作は、本番環境で DATABRICKS_SQL タスクを選択した場合にのみサポートされます。

[スケジュールリソースグループの変更]

タスクインスタンスの実行時に使用されるスケジュールリソースグループを変更できます。

説明
  • 本番および基本プロジェクトのタスクのみ、スケジュールリソースグループを変更できます。

  • 変更は、すでに生成されたインスタンスには影響せず、新しく生成されたインスタンスにのみ影響します。 すでに生成されたインスタンスで使用されているリソースグループを変更する必要がある場合は、インスタンスリストで行うことができます。

ノードコードの詳細の表示

列の [アクション] trta アイコンをクリックするか、タスクオブジェクト名をクリックすると、ページの右側に現在のタスクの詳細が表示されます。 image アイコンをクリックすると、左側のワンタイムタスクリストを非表示にして、ワンタイムタスク詳細ページを拡大できます。

image

セクション

説明

運用および保守管理エリア

ワンタイムタスクの運用および保守管理のエントリポイントを提供します。

  • [操作ログの表示]: 現在のタスクの操作ログを表示します。これには、操作時間、オペレーター、および具体的な操作が含まれます。

  • [ワンタイムインスタンスの表示]: ワンタイムインスタンスページに移動して、現在のタスク実行によって生成されたワンタイムインスタンスを表示します。

    説明

    実行されたワンタイムタスクのみが、ワンタイムインスタンスを生成します。

  • [ノードコードの表示]: パイプラインタスクのノードコードを表示します。

    説明

    パイプラインタスクのみが、ノードコードの表示をサポートしています。

    ノードコードを表示した後、[ノードスクリプトの表示] をクリックして、パイプラインタスクの上流および下流コンポーネントを視覚的に表示するページに戻ります。image

  • [開発ノードの編集]: 開発プロジェクトの現在のタスクの編集ページに移動して、タスクを編集します。

    説明

    開発 - 本番 開発モードのみがこの操作をサポートしています。

  • [ノードの編集]: 現在のタスクの編集ページに移動して、タスクを編集します。

    説明

    基本 モードのみがこの操作をサポートしています。

  • [本番ノードの表示]: 本番プロジェクトに移動して、現在のタスク構成を表示します。

  • [更新]: 現在のワンタイムタスクを更新します。

  • [実行]: [実行] をクリックし、[実行] ダイアログボックスで、データタイムスタンプ、同時実行グループ数、実行順序、およびパラメーター構成を構成します。 詳細な構成手順については、「ワンタイムタスクを実行する」をご参照ください。

ノード情報エリア

ワンタイムタスクのノード情報と実行情報を表示します。

タスクコードエリア

  • データ開発 モジュールから送信されたワンタイムタスクは、タスク計算結果の表示をサポートしています。

  • Data Integration モジュールから送信されたワンタイムタスクは、デフォルトでパイプラインタスクの上流および下流コンポーネントを表示します。

    ページ上部の [ノードコードの表示] をクリックして、パイプラインタスクのノードスクリプトを表示することもできます。

ワンタイムタスクの実行

  1. [実行] をクリックして、[実行] ダイアログボックスを開きます。

  2. [実行] ダイアログボックスで、次のパラメーターを構成します。

    パラメーター

    説明

    データタイムスタンプ

    範囲別、サイクル別、またはカスタムを選択できます。 デフォルトでは範囲別が選択されており、デフォルトの範囲値は 現在のデータタイムスタンプ~現在のデータタイムスタンプ です。

    • [範囲別]: 範囲別を選択した後、間隔の時間範囲を選択する必要があります。 時間範囲のスパンは 1 年を超えることはできませんこれは、現在のタスクを複数のデータタイムスタンプで連続して実行する必要があるシナリオに適しています。

    • [サイクル別]: サイクル別を選択した後、サイクルの時間範囲を選択し、毎月または毎週の日付を指定する必要があります。 時間範囲は 1 年を超えることはできません。デフォルトは 現在のデータタイムスタンプ~現在のデータタイムスタンプ です。 これは、現在のタスクを複数連続するデータタイムスタンプ内の特定の曜日または特定の日に実行する必要があるシナリオに適しています。

      • [毎週]: 毎週選択した曜日に実行します(毎週月曜日と火曜日など)。

      • [毎月]: 毎月選択した日に実行します(毎月の 1 日、5 日、10 日など)。

        説明

        月末とは、各月の最終日を指します。

    • [カスタム]: YYYY-MM-DD 形式で複数のデータタイムスタンプを入力できます。複数のデータタイムスタンプは改行で区切ります。 入力できるデータタイムスタンプの範囲は、1900-01-01~現在 です。 この範囲外の日付は有効になりません。

    同時実行数

    デフォルトは 1 です。 1~12 の整数を入力できます。

    実行順序

    [データタイムスタンプの昇順] または [データタイムスタンプの降順] を選択できます。 デフォルトは [データタイムスタンプの昇順] です。これは、データタイムスタンプの昇順で実行が進むことを意味します。

    パラメーターチェック

    現在のワンタイムタスクにローカル変数が含まれている場合、ローカルパラメーターの構成が完了した後、ワンタイムタスクは構成されたパラメーター値に従って実行されます。 [空の値を入力] を選択できます。 また、パラメーター値は、現在のタスクによって生成されたすべてのインスタンスで一貫性を保ちます。

  3. 構成が完了したら、[送信] をクリックします。

ワンタイムタスクのバッチ操作

操作

説明

[実行]

複数のタスクを選択した後、リストの下部にある [実行] をクリックして、データタイムスタンプ、同時実行グループ数、およびバッチ実行の実行順序を設定します。パラメーターの説明については、「ワンタイムタスクを実行する」をご参照ください。

説明
  • 1 回限りのタスクを 1 つだけ選択した場合、パラメーターも構成できます。

  • 1 回のバッチ操作で最大 100 件のワンタイムタスクを選択できます。

[操作オーナーの変更]

複数のタスクを選択した後、リストの下部にある [操作担当者の変更] をクリックすると、複数のタスクの運用・保守担当者を同時に変更できます。

説明
  • 現在のプロジェクト内のメンバーのみを選択できます。

  • これは、本番環境プロジェクトと基本プロジェクトにのみ適用されます。

[優先度の変更]

複数のタスクを選択した後、リストの下部にある [優先度の変更] をクリックすると、複数のタスクの優先度を同時に変更できます。同時に、スケジューリング条件を満たすすべてのタスクの中で、優先度の高いタスクが最初に実行されます。タスクの優先度を変更した後、次のスケジューリングは最新の優先度に基づいて行われます。

タスクの優先度の変更は、タスクを送信または公開する必要なく、すぐに有効になります。

説明

これは、Prod プロジェクトと Basic プロジェクト(つまり、本番環境タスク)にのみ適用されます。

HTTP パスの変更

複数の DATABRICKS_SQL タスクの本番環境 HTTP パスを変更できます。選択した DATABRICKS_SQL タスクが異なる Databricks クラスターに属している場合は、クラスターごとに HTTP パスを個別に指定できます。対応するクラスターに設定されているすべての HTTP パスから選択できます。

説明

この操作は、本番環境で DATABRICKS_SQL タスクを選択した場合にのみサポートされます。

[スケジュールリソースグループの変更]

複数のタスクを選択した後、リストの下部にある [スケジュールリソースグループの変更] をクリックすると、複数のタスクによって生成されたインスタンスの実行時に使用されるスケジュールリソースグループを一括で変更できます。

説明
  • 複数のプロジェクトからタスクを選択する場合、ターゲットスケジュールリソースグループには、これらすべてのプロジェクトに共通して承認されているスケジュールリソースグループのみが表示されます。最初に単一のプロジェクトをフィルタリングしてから、バッチ設定を実行することをお勧めします。

  • 変更は、すでに生成されたインスタンスには影響せず、新しく生成されたインスタンスにのみ影響します。すでに生成されたインスタンスで使用されているリソースグループを変更する必要がある場合は、インスタンスリストで行うことができます。