dbt Cloud - Trigger Job
Overview
Execute a single job on dbt Cloud, creating a new run. The job must be set up within the dbt Cloud interface. Workflows does not support sending override commands to the job at this time. This Blueprint will create and store the generated run ID to _shipyard-artifacts/dbtcloud-blueprints/variables/run_id.pickle_ The "cause" for an execution triggered via Workflows will always contain the following details: - Fleet ID - Vessel ID - Vessel Log ID The response for this request will always be stored at _shipyard-artifacts/dbtcloud-blueprints/responses/job_JOBID_response.json_
Variables
Name | Reference | Type | Required | Default | Options | Description |
---|---|---|---|---|---|---|
Service Token | DBT_API_KEY | Password | ✅ | None | - | Your unique service token for dbt Cloud. Instructions for how to get this token can be found in the authorization documentation. |
Account ID | DBT_ACCOUNT_ID | Alphanumeric | ✅ | None | - | Your unique Account ID, found in the URL of dbt Cloud. https://cloud.getdbt.com/#/accounts/ACCOUNT_ID/projects/PROJECT_ID/dashboard/ |
Job ID | DBT_JOB_ID | Alphanumeric | ✅ | None | - | The ID of a specific job you want to run, found in the URL of dbt Cloud. https://cloud.getdbt.com/#/accounts/ACCOUNT_ID/projects/PROJECT_ID/jobs/JOB_ID/ |
Wait For Completion | DBT_WAIT | Boolean | ✅ | TRUE | - | Enable if you want the vessel to wait until the sync job is successfully completed. Otherwise, the vessel will only initiate the sync job without waiting |
YAML
Below is the YAML template
source:
template: dbt Cloud - Trigger Job
inputs:
DBT_API_KEY:
DBT_ACCOUNT_ID:
DBT_JOB_ID:
DBT_WAIT: 'TRUE'
type: TEMPLATE
guardrails:
retry_count: 1
retry_wait: 0h0m0s
runtime_cutoff: 1h0m0s
exclude_exit_code_ranges:
- 200
- 201
- 211
- 212