TriggerRun
Trigger a dbt cloud job to run.
Trigger a dbt cloud job to run.
Trigger a dbt cloud job to run.
Use this task to kick off a run for a job. When this endpoint returns a successful response, a new run will be enqueued for the account. If you activate the wait option, it will wait for the job to be ended and will display all the log and dynamic tasks.
type: "io.kestra.plugin.dbt.cloud.TriggerRun"Examples
id: dbt_trigger_job_run
namespace: company.team
tasks:
- id: trigger_run
type: io.kestra.plugin.dbt.cloud.TriggerRun
accountId: "dbt_account"
token: "{{ secret('DBT_TOKEN') }}"
jobId: "job_id"
Properties
accountId*Requiredstring
Numeric ID of the account.
jobId*Requiredstring
Numeric ID of the job.
token*Requiredstring
API key.
baseUrlstring
https://cloud.getdbt.comBase URL to select the tenant.
causestring
Triggered by Kestra.A text description of the reason for running this job.
dbtVersionOverridestring
Override the version of dbt used to run this job.
generateDocsOverridebooleanstring
Override whether or not this job generates docs.
gitBranchstring
The git branch to check out before running this job.
gitShastring
The git SHA to check out before running this job.
initialDelayMsintegerstring
1000Initial delay in milliseconds before retrying
Default: 1000 ms (1 second)
maxDurationstring
PT1HdurationThe maximum total wait duration.
maxRetriesintegerstring
3Maximum number of retries in case of transient errors
Default: 3
optionsNon-dynamic
The HTTP client configuration.
io.kestra.core.http.client.configurations.HttpConfiguration
falseIf true, allow a failed response code (response code >= 400)
List of response code allowed for this request
The authentification to use.
io.kestra.core.http.client.configurations.BasicAuthConfiguration
The password for HTTP basic authentication.
The username for HTTP basic authentication.
io.kestra.core.http.client.configurations.BearerAuthConfiguration
The token for bearer token authentication.
The password for HTTP basic authentication. Deprecated, use auth property with a BasicAuthConfiguration instance instead.
The username for HTTP basic authentication. Deprecated, use auth property with a BasicAuthConfiguration instance instead.
durationdurationThe time an idle connection can remain in the client's connection pool before being closed.
UTF-8The default charset for the request.
java.nio.charset.Charset
trueWhether redirects should be followed automatically.
ALLTRACEDEBUGINFOWARNERROROFFNOT_SPECIFIEDThe log level for the HTTP client.
REQUEST_HEADERSREQUEST_BODYRESPONSE_HEADERSRESPONSE_BODYThe enabled log.
The maximum content length of the response.
The proxy configuration.
io.kestra.core.http.client.configurations.ProxyConfiguration
DIRECTDIRECTHTTPSOCKSThe address of the proxy server.
The password for proxy authentication.
The port of the proxy server.
DIRECTHTTPSOCKSThe type of proxy to use.
The username for proxy authentication.
durationdurationThe maximum time allowed for reading data from the server before failing.
The SSL request options
io.kestra.core.http.client.configurations.SslOptions
Whether to disable checking of the remote SSL certificate.
Only applies if no trust store is configured. Note: This makes the SSL connection insecure and should only be used for testing. If you are using a self-signed certificate, set up a trust store instead.
The timeout configuration.
io.kestra.core.http.client.configurations.TimeoutConfiguration
durationThe time allowed to establish a connection to the server before failing.
PT5MdurationThe time allowed for a read connection to remain idle before closing it.
parseRunResultsbooleanstring
trueParse run result.
Parsing run result to display duration of each task inside dbt.
pollFrequencystring
PT5SdurationSpecify frequency for job state check API calls.
schemaOverridestring
Override the destination schema in the configured target for this job.
stepsOverridearray
Override the list of steps for this job.
targetNameOverridestring
Override the target.name context variable used when running this job.
threadsOverridestring
Override the number of threads used to run this job.
timeoutSecondsOverrideintegerstring
Override the timeout in seconds for this job.
waitbooleanstring
trueWait for the end of the run.
Allowing to capture job status & logs.
Outputs
manifeststring
uriURI of a manifest.
runIdinteger
The run ID.
runResultsstring
uriURI of a run result.
