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