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

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

最終更新日:Mar 01, 2026

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

ワンタイムタスクページへの移動

  1. Dataphin ホームページのトップメニューバーで、[開発] > [O&M] を選択します。

  2. 左側のナビゲーションウィンドウで、[O&M] > [ワンタイムタスク] を選択し、[ワンタイムタスク] ページに移動します。

  3. トップメニューバーで、本番環境または開発環境を選択します。

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

ワンタイムタスクページには、フィルターと検索エリア、リスト操作エリア、ワンタイムタスクリスト、バッチ操作エリアが含まれます。このページでは、送信されたワンタイムタスクに対して O&M 操作を実行できます。

image

セクション

説明

フィルターと検索エリア

タスクオブジェクト名または ID でワンタイムタスクをフィルターします。これは、特定のタスクをすばやく見つけるのに役立ちます。[マイタスク] または [本日更新] を選択してタスクをフィルターすることもできます。

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

  • [本日更新]:当日に更新されたワンタイムタスク。

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

  • [フィルター][フィルター] をクリックしてフィルターエリアを展開します。フィルターオプションには以下が含まれます:

    • [タスクタイプ]:Dataphin で作成されたワンタイムタスクのタイプでフィルターします。サポートされるタスクタイプは環境によって異なります。ページに表示されるタスクタイプが優先されます。

    • [運用オーナー]:タスクの O&M オーナーでフィルターします。

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

    • 更新時間[今日] または [カスタム時間範囲] を選択して、タスクを絞り込みます。

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

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

    再選択するには、[リセット] をクリックして、選択したすべてのフィルター条件をクリアします。

リスト操作

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

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

    • ブラウザのキャッシュをクリアしたり、別のブラウザに切り替えたりすると、テーブルヘッダーの設定はデフォルトにリセットされます。

  • リストのリフレッシュimage アイコンをクリックして現在のリストをリフレッシュします。

ワンタイムタスクリスト

ワンタイムタスクページには、オペレーションセンターに送信されたワンタイムタスクが一覧表示されます。リストには、[タスクオブジェクト][優先度][運用オーナー][プロジェクト][HTTP パス][リソースグループ][最終更新日時][タグ]、およびサポートされている [操作] が表示されます。

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

  • [HTTP パス]:選択した環境に基づいて、Databricks SQL タスクの本番環境または開発環境の HTTP パスを表示します。

    説明

    この項目は Databricks SQL タスクのみがサポートします。他のタスクタイプの場合は「-」が表示されます。

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

    タスクに指定されたカスタムリソースグループがアクティブでない場合、代わりにプロジェクトのデフォルトリソースグループが使用されます。プロジェクトのデフォルトリソースグループがアクティブでない場合、テナントのデフォルトリソースグループが使用されます。優先順位は次のとおりです:カスタムリソースグループ > プロジェクトのデフォルトリソースグループ > テナントのデフォルトリソースグループ

    説明

    プロジェクトのデフォルトリソースグループを変更した場合、ここの表示が遅れることがありますが、タスクは変更後のリソースグループを使用して実行されます。

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

  • アクション[アクション] 列には、ワンタイムタスクでサポートされている O&M 操作が一覧表示されます。 詳細については、「ワンタイムタスクリストの操作」をご参照ください。

バッチ操作エリア

バッチ操作エリアを使用して、一度に複数のワンタイムタスクに対して O&M を実行します。これにより、効率が向上します。詳細については、「ワンタイムタスクのバッチ操作」をご参照ください。

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

操作

説明

ノードコードの表示

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

インスタンスの表示

タスクの実行時に生成されたワンタイムインスタンスを表示します。ワンタイムインスタンスに対して O&M を実行することもできます。

実行

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

開発ノードの編集

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

説明

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

[ノードの編集]

タスクのノードを編集します。これは Basic モデルにのみ適用されます。

説明

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

ノードスクリプトの表示

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

説明

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

本番ノードの表示

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

[操作オーナーの変更]

タスクの O&M オーナーを変更します。

説明
  • これは、本番環境タスクである Prod プロジェクトおよび Basic プロジェクトのタスクにのみ適用されます。

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

モニタリングとアラートの設定

タスク実行の監視ルールを設定します。タスク実行中に監視ルールがトリガーされると、システムはアラートメッセージを送信します。これにより、例外を迅速に検出し、正常なデータ出力を確保できます。詳細については、「オフラインタスク監視の概要」をご参照ください。

説明

システムは、本番環境タスクである Prod プロジェクトおよび Basic プロジェクトのタスクの監視設定のみをサポートします。

HTTP パスの変更

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

説明

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

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

タスクインスタンスが実行時に使用するスケジュールリソースグループを変更します。

説明
  • これは Prod プロジェクトおよび Basic プロジェクトのタスクにのみ適用されます。

  • この変更は既存のインスタンスには影響しません。新しいインスタンスにのみ影響します。既存のインスタンスのリソースグループを変更するには、インスタンスリストに移動します。

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

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

image

セクション

説明

O&M 管理エリア

ワンタイムタスクの O&M のためのエントリポイントを提供します。

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

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

    説明

    ワンタイムインスタンスは、実行されたタスクに対してのみ生成されます。

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

    説明

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

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

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

    説明

    この操作は Dev-Prod 開発モデルでのみサポートされます。

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

    説明

    この操作は Basic モデルでのみサポートされます。

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

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

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

ノード情報エリア

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

タスクコードエリア

  • [データ開発] モジュールから送信されたワンタイムタスクの場合、タスクの計算結果を表示できます。

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

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

ワンタイムタスクの実行

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

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

    パラメーター

    説明

    データタイムスタンプ

    [範囲指定]、[期間指定]、または [カスタム] を選択できます。デフォルトでは [範囲指定] が選択されています。デフォルトの範囲は 現在のデータタイムスタンプから現在のデータタイムスタンプまで です。

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

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

      • [週単位]:タスクは、月曜日や火曜日など、各週の選択された曜日に実行されます。

      • [月単位]:タスクは、1 日、5 日、10 日など、各月の選択された日に実行されます。

        説明

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

    • [カスタム]YYYY-MM-DD 形式で複数のデータタイムスタンプを入力します。複数のデータタイムスタンプは改行で区切ります。1900-01-01 から現在まで の範囲のデータタイムスタンプを入力できます。この範囲外の日付は無効です。

    同時実行

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

    [実行順序]

    [データタイムスタンプ昇順] または [データタイムスタンプ降順] を選択します。デフォルトは [データタイムスタンプ昇順] で、タスクはデータタイムスタンプの昇順で 1 つずつ実行されます。

    パラメーター設定

    ワンタイムタスクにローカル変数が含まれている場合、ローカルパラメーターを設定すると、タスクは設定されたパラメーター値で実行されます。[空の値を埋める] を選択できます。パラメーター値は、タスクによって生成されるすべてのインスタンスで同じままです。

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

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

操作

説明

実行

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

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

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

オペレーションオーナーの変更

複数のタスクを選択し、リストの下部にある [運用オーナーの変更] をクリックして、複数のタスクの O&M オーナーを同時に変更します。

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

  • これは Prod プロジェクトおよび Basic プロジェクトにのみ適用されます。

[優先度の変更]

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

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

説明

これは、本番環境タスクである Prod プロジェクトおよび Basic プロジェクトのタスクにのみ適用されます。

HTTP パスの変更

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

説明

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

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

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

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

  • この変更は既存のインスタンスには影響しません。新しいインスタンスにのみ影響します。既存のインスタンスのリソースグループを変更するには、インスタンスリストに移動します。