Databricks · Arazzo Workflow

Databricks Find Job by Name and Run It

Version 1.0.0

Look up a job by exact name, then trigger an immediate run of it.

1 workflow 1 source API 1 provider
View Spec View on GitHub AIAnalyticsApache SparkBig DataClean RoomsCloud ComputingDataData AnalyticsData EngineeringData GovernanceDelta LakeDelta SharingETLIdentity ManagementLakehouseMachine LearningMLflowModel ServingSecuritySQLUnity CatalogVector SearchVisualizeArazzoWorkflows

Provider

databricks

Workflows

find-job-and-run
Resolve a job by name and trigger a run.
Lists jobs filtered by exact name, confirms a match exists, and triggers a run-now for the first matched job.
2 steps inputs: name, notebook_params outputs: jobId, runId
1
findJob
listJobs
List jobs filtered by exact name and capture the job_id of the first match.
2
runJobNow
runJobNow
Trigger an immediate run of the matched job, optionally passing notebook parameters.

Source API Descriptions

Arazzo Workflow Specification

databricks-find-job-and-run-workflow.yml Raw ↑
arazzo: 1.0.1
info:
  title: Databricks Find Job by Name and Run It
  summary: Look up a job by exact name, then trigger an immediate run of it.
  description: >-
    Resolves a Databricks job by its exact (case-insensitive) name using the
    list endpoint's name filter, then triggers an immediate run of the matched
    job. The job_id extracted from the first matched job is reused for the
    run-now request. Every step spells out its request inline so the flow can be
    read and executed without opening the underlying OpenAPI description.
  version: 1.0.0
sourceDescriptions:
- name: databricksApi
  url: ../openapi/databricks-openapi.yml
  type: openapi
workflows:
- workflowId: find-job-and-run
  summary: Resolve a job by name and trigger a run.
  description: >-
    Lists jobs filtered by exact name, confirms a match exists, and triggers a
    run-now for the first matched job.
  inputs:
    type: object
    required:
    - name
    properties:
      name:
        type: string
        description: The exact (case-insensitive) job name to resolve.
      notebook_params:
        type: object
        description: Optional notebook parameters for the triggered run.
  steps:
  - stepId: findJob
    description: >-
      List jobs filtered by exact name and capture the job_id of the first
      match.
    operationId: listJobs
    parameters:
    - name: name
      in: query
      value: $inputs.name
    - name: limit
      in: query
      value: 1
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      jobId: $response.body#/jobs/0/job_id
    onSuccess:
    - name: jobFound
      type: goto
      stepId: runJobNow
      criteria:
      - context: $response.body
        condition: $.jobs.length > 0
        type: jsonpath
  - stepId: runJobNow
    description: >-
      Trigger an immediate run of the matched job, optionally passing notebook
      parameters.
    operationId: runJobNow
    requestBody:
      contentType: application/json
      payload:
        job_id: $steps.findJob.outputs.jobId
        notebook_params: $inputs.notebook_params
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      runId: $response.body#/run_id
  outputs:
    jobId: $steps.findJob.outputs.jobId
    runId: $steps.runJobNow.outputs.runId