ジョブ パラメーターの構成
Databricks ワークスペース UI でジョブパラメーターを設定するか、REST API、CLI、および宣言型自動化バンドルで使用される JSON および YAML 定義に追加します。ジョブ API、Databricks CLI、およびDeclarative Automation Bundles とはを参照してください。
ジョブ パラメーターとは
ジョブ パラメーターは、デフォルトの静的または動的な値でジョブをパラメーター化できるキーと値のペアです。 オプションで、新しい実行をトリガーするときに、ジョブで設定されたパラメーターを上書きできます。 異なるパラメーターを使用したジョブの実行を参照してください。
ジョブ・パラメーター・キーには、 _ - . 文字または英数字のみを含めることができます。パラメーター値は、文字列または動的な値参照として設定されます。動的な値参照を参照してください。
ジョブのパラメーター値は、配列を含む、有効なJSONであればどのようなものでも構いません。タスクがJSON配列パラメーターを消費する方法については、「タスクパラメーターの構成」を参照してください。
ジョブ パラメーターの追加または編集
ジョブ パラメーター ダイアログを使用して、新しいパラメーターの追加、既存のパラメーターのキーと値の編集、またはパラメーターの削除を行います。
ワークスペース UI でパラメーターを編集するには、次の手順を使用して既存のジョブを選択します。
- Databricks ワークスペースのサイドバーで、 ジョブとパイプライン をクリックします。
- 必要に応じて、 ジョブ と 自分が所有 フィルターを選択します。
- ジョブの 名前 リンクをクリックします。
- ジョブの詳細 サイドバーで、 パラメーターの編集 をクリックします。 ジョブ・パラメーター ダイアログが表示されます。
- キー フィールドと 値 フィールドを使用してパラメーターを追加または編集します。
をクリックして、パラメーターを削除します。- 保存 をクリックして、変更を適用します。
{ } をクリックして、使用可能な動的値参照をリストします。リストからオプションを選択して、そのオプションを 値 フィールドに挿入します。
ジョブ・パラメーターのプッシュダウン
ジョブはさまざまな方法でさまざまなタイプのタスクにプッシュされます。 これらがどのように渡されるか、およびタスク内でそれらにアクセスする方法については、 「タスクからパラメーター値にアクセスする」を参照してください。
キーと値のパラメーターを受け入れるタスクの場合、ジョブパラメーターは自動的にプッシュダウンされ、ジョブパラメーターとタスクパラメーターがキーを共有する場合、ジョブパラメーターが優先されます。JSON配列パラメーターを受け入れるタスクは、ジョブパラメーターを自動的に受け取りません。それらを{{job.parameters.<name>}}で明示的に参照してください。タスクパラメーターの設定を参照してください。
異なるパラメーターでジョブを実行する
構成されたジョブ・パラメーターをオーバーライドしたり、異なるパラメーターを使用してジョブを実行するときに新しいジョブ・パラメーターを追加したりできます。異なる設定でのジョブの実行を参照してください。
また、ジョブ実行を修復するときに、ジョブ・パラメーターをオーバーライドすることもできます。 失敗したタスクとスキップされたタスクの再実行を参照してください。