Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Retry jobs #4213

Merged
merged 27 commits into from
Oct 9, 2023
Merged
Show file tree
Hide file tree
Changes from 21 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
129ccc1
Retry jobs
nghi-ly Oct 6, 2023
cc04b06
add release note
nghi-ly Oct 6, 2023
4d30360
Add link to Azure
nghi-ly Oct 6, 2023
b004c5f
Merge branch 'current' into ly-docs-rerun
nghi-ly Oct 6, 2023
822a3b9
Add tag
nghi-ly Oct 6, 2023
f994470
Merge branch 'ly-docs-rerun' of github.com:dbt-labs/docs.getdbt.com i…
nghi-ly Oct 6, 2023
56906ea
Nits
nghi-ly Oct 6, 2023
18f9da4
Nits
nghi-ly Oct 6, 2023
a45f9ab
This branch was auto-updated!
github-actions[bot] Oct 6, 2023
9e102b4
This branch was auto-updated!
github-actions[bot] Oct 6, 2023
c2a6397
This branch was auto-updated!
github-actions[bot] Oct 8, 2023
15e9a69
This branch was auto-updated!
github-actions[bot] Oct 8, 2023
b40b842
This branch was auto-updated!
github-actions[bot] Oct 9, 2023
62d4ed6
This branch was auto-updated!
github-actions[bot] Oct 9, 2023
2e33456
This branch was auto-updated!
github-actions[bot] Oct 9, 2023
84fc1d5
This branch was auto-updated!
github-actions[bot] Oct 9, 2023
222caa1
Update website/docs/docs/deploy/retry-jobs.md
nghi-ly Oct 9, 2023
b6d535d
Update website/docs/docs/deploy/retry-jobs.md
nghi-ly Oct 9, 2023
6427204
This branch was auto-updated!
github-actions[bot] Oct 9, 2023
d1cbc1d
Update website/docs/docs/dbt-versions/release-notes/03-Oct-2023/nativ…
nghi-ly Oct 9, 2023
5c3d58d
Fold in feedback
nghi-ly Oct 9, 2023
8db01a9
Update website/docs/docs/dbt-versions/release-notes/03-Oct-2023/nativ…
nghi-ly Oct 9, 2023
af783d5
Fold in feedback
nghi-ly Oct 9, 2023
1e408d3
Merge branch 'ly-docs-rerun' of github.com:dbt-labs/docs.getdbt.com i…
nghi-ly Oct 9, 2023
aec1bc8
Nit
nghi-ly Oct 9, 2023
5f6afa3
Another nit
nghi-ly Oct 9, 2023
e27dd55
This branch was auto-updated!
github-actions[bot] Oct 9, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions website/docs/docs/collaborate/git-version-control.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,4 @@ When you develop in the command line interface (CLI) or Cloud integrated develo
- [Merge conflicts](/docs/collaborate/git/merge-conflicts)
- [Connect to GitHub](/docs/cloud/git/connect-github)
- [Connect to GitLab](/docs/cloud/git/connect-gitlab)
- [Connect to Azure DevOps](/docs/cloud/git/connect-azure-devops)
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
title: "Enhancement: Native support for the dbt retry command"
description: "October 2023: Rerun errored jobs from start or from the failure point"
sidebar_label: "Enhancement: Support for dbt retry"
tags: [Oct-2023, Scheduler]
date: 2023-10-06
sidebar_position: 10
---

Previously in dbt Cloud, you could only rerun an errored job from start but now you can also rerun it from its of failure.
nghi-ly marked this conversation as resolved.
Show resolved Hide resolved

You can view which job failed to complete successully, which command failed in the run step, and choose how to rerun it. To learn more, refer to [Retry jobs](/docs/deploy/retry-jobs).


<Lightbox src="/img/docs/deploy/native-retry.gif" width="70%" title="Example of the Rerun options in dbt Cloud"/>
32 changes: 32 additions & 0 deletions website/docs/docs/deploy/retry-jobs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: "Retry your dbt jobs"
sidebar_label: "Retry jobs"
description: "Rerun your errored jobs from start or the failure point."
---

If your dbt job run completed with a status of `result:error` , you can rerun it from start or from the point of failure in dbt Cloud.

## Prerequisites

- You have a [dbt Cloud account](https://www.getdbt.com/signup).
- You must be using [dbt version](/docs/dbt-versions/upgrade-core-in-cloud) 1.6 or newer.
- The more recent run of the job hasn't completed successfully. The latest status of the run is `error`.
- The job command that failed in the run must be one that supports the [retry command](/reference/commands/retry).

## Rerun an errored job

1. Select **Deploy** from the top navigation bar and choose **Run History.**
2. Choose the job run that has errored.
3. In the **Run Summary** tab on the job’s **Run** page, expand the run step that failed. An :x: denotes the failed step.
4. Examine the error message and determine how to fix it. After you have made your changes, save and commit them to your [Git repo](/docs/collaborate/git-version-control).
5. Return to your job’s **Run** page. In the upper right corner, click **Rerun** and choose **Rerun from start** or **Rerun from failure**.

If you chose to rerun from the failure point, a **Rerun failed steps** modal opens. It lists the run steps it will invoke: the failed step and any skipped steps. To confirm these run steps, click **Rerun from failure**. The job reruns from the failed command in the previously failed run. A banner at the top of the **Run Summary** tab captures this with the message, "This run resumed execution from last failed step".
nghi-ly marked this conversation as resolved.
Show resolved Hide resolved

<Lightbox src="/img/docs/deploy/native-retry.gif" width="70%" title="Example of the Rerun options in dbt Cloud"/>

## Related content

- [Run visibility](/docs/deploy/run-visibility)
- [Jobs](/docs/deploy/jobs)
- [Job commands](/docs/deploy/job-commands)
1 change: 1 addition & 0 deletions website/sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -352,6 +352,7 @@ const sidebarSettings = {
link: { type: "doc", id: "docs/deploy/monitor-jobs" },
items: [
"docs/deploy/run-visibility",
"docs/deploy/retry-jobs",
"docs/deploy/job-notifications",
"docs/deploy/webhooks",
"docs/deploy/artifacts",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading