diff --git a/website/docs/docs/deploy/deploy-jobs.md b/website/docs/docs/deploy/deploy-jobs.md index f304949bc80..a0c04b9a6b8 100644 --- a/website/docs/docs/deploy/deploy-jobs.md +++ b/website/docs/docs/deploy/deploy-jobs.md @@ -37,8 +37,8 @@ You can create a deploy job and configure it to run on [scheduled days and times - **Run source freshness** — Enable this option to invoke the `dbt source freshness` command before running the deploy job. Refer to [Source freshness](/docs/deploy/source-freshness) for more details. 4. Options in the **Triggers** section: - **Run on schedule** — Run the deploy job on a set schedule. - - **Timing** — Specify whether to [schedule](#schedule-days) the deploy job using **Hours of the day** that runs the job at specific times of day, **Exact intervals** that runs the job every specified number of hours, or **Cron schedule** that runs the job specified using [cron syntax](#cron-schedule). - - **Days of the week** — By default, it’s set to every day when **Hours of the day** or **Exact intervals** is chosen for **Timing**. + - **Timing** — Specify whether to [schedule](#schedule-days) the deploy job using **Intervals** that run the job every specified number of hours, **Specific hours** that run the job at specific times of day, or **Cron schedule** that run the job specified using [cron syntax](#cron-schedule). + - **Days of the week** — By default, it’s set to every day when **Intervals** or **Specific hours** is chosen for **Timing**. - **Run when another job finishes** — Run the deploy job when another _upstream_ deploy [job completes](#trigger-on-job-completion). - **Project** — Specify the parent project that has that upstream deploy job. - **Job** — Specify the upstream deploy job. @@ -65,11 +65,12 @@ You can create a deploy job and configure it to run on [scheduled days and times To set your job's schedule, use the **Run on schedule** option to choose specific days of the week, and select customized hours or intervals. -Under **Timing**, you can either use customizable hours for jobs that need to run frequently throughout the day or exact intervals for jobs that need to run at specific times: +Under **Timing**, you can either use regular intervals for jobs that need to run frequently throughout the day or customizable hours for jobs that need to run at specific times: -- **Exact intervals** — Use this option to set how often your job runs, in hours. Enter a number between 1 and 23 to represent the interval between job runs. For example, if you set it to **Every 2 hours**, the job will run every 2 hours from midnight UTC. This option is useful if you need to run jobs multiple times per day at regular intervals. +- **Intervals** — Use this option to set how often your job runs, in hours. For example, if you choose **Every 2 hours**, the job will run every 2 hours from midnight UTC. This doesn't mean that it will run at exactly midnight UTC. However, subsequent runs will always be run with the same amount of time between them. For example, if the previous scheduled pipeline ran at 00:04 UTC, the next run will be at 02:04 UTC. This option is useful if you need to run jobs multiple times per day at regular intervals. + +- **Specific hours** — Use this option to set specific times when your job should run. You can enter a comma-separated list of hours (in UTC) when you want the job to run. For example, if you set it to `0,12,23,` the job will run at midnight, noon, and 11 PM UTC. Job runs will always be consistent between both hours and days, so if your job runs at 00:05, 12:05, and 23:05 UTC, it will run at these same hours each day. This option is useful if you want your jobs to run at specific times of day and don't need them to run more frequently than once a day. -- **Hours of the day** — Use this option to set specific times when your job should run. You can enter a comma-separated list of hours (in UTC) when you want the job to run. For example, if you set it to `0,12,23,` the job will run at midnight, noon, and 11 PM UTC. This option is useful if you want your jobs to run at specific times of day and don't need them to run more frequently than once a day. :::info diff --git a/website/docs/docs/deploy/job-scheduler.md b/website/docs/docs/deploy/job-scheduler.md index 3a4f23ad277..63f8a54652d 100644 --- a/website/docs/docs/deploy/job-scheduler.md +++ b/website/docs/docs/deploy/job-scheduler.md @@ -46,9 +46,7 @@ Before the job starts executing, the scheduler checks these conditions to determ - **Does this same job have a run already in progress?** — The scheduler executes distinct runs of the same dbt Cloud job serially to avoid model build collisions. If there's a job already running, the queued job will wait, and the wait time will be displayed in dbt Cloud. -If there is an available run slot and there isn't an actively running instance of the job, the scheduler will prepare the job to run in your cloud data platform. This prep involves readying a Kubernetes pod with the right version of dbt installed, setting environment variables, loading data platform credentials, and Git provider authorization, amongst other environment-setting tasks. The time it takes to prepare the job is displayed as **prep time** in the UI. - -Together, **wait time** plus **prep time** is the total time a run spends in the queue (or **Time in queue**). +If there is an available run slot and there isn't an actively running instance of the job, the scheduler will prepare the job to run in your cloud data platform. This prep involves readying a Kubernetes pod with the right version of dbt installed, setting environment variables, loading data platform credentials, and Git provider authorization, amongst other environment-setting tasks. The time it takes to prepare the job is displayed as **Prep time** in the UI. diff --git a/website/static/img/docs/dbt-cloud/deployment/deploy-scheduler.jpg b/website/static/img/docs/dbt-cloud/deployment/deploy-scheduler.jpg index cd79bb9b1a2..88b237842b3 100644 Binary files a/website/static/img/docs/dbt-cloud/deployment/deploy-scheduler.jpg and b/website/static/img/docs/dbt-cloud/deployment/deploy-scheduler.jpg differ diff --git a/website/static/img/docs/dbt-cloud/using-dbt-cloud/example-triggers-section.png b/website/static/img/docs/dbt-cloud/using-dbt-cloud/example-triggers-section.png index 168b9ffe7c7..b815fec0513 100644 Binary files a/website/static/img/docs/dbt-cloud/using-dbt-cloud/example-triggers-section.png and b/website/static/img/docs/dbt-cloud/using-dbt-cloud/example-triggers-section.png differ