Skip to content

Commit 0418154

Browse files
committed
Adding image to changelog, minor update.
1 parent 1030840 commit 0418154

File tree

3 files changed

+5
-3
lines changed

3 files changed

+5
-3
lines changed
352 KB
Loading

src/content/changelog/d1/2025-09-11-d1-automatic-read-retries.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ The retry success ratio among read-only retryable errors varies from 5% all the
1515

1616
The retry success ratio among all retryable errors is lower, indicating that there are write-queries that could be retried. Therefore, we recommend D1 users to continue applying [retries in their own code](/d1/best-practices/retry-queries/) for queries that are not read-only but are idempotent according to the business logic of the application.
1717

18-
[D1 automatically query retries success ratio]
18+
![D1 automatically query retries success ratio](~/assets/images/changelog/d1/d1-auto-retry-success-ratio.png)
1919

2020
D1 ensures that any retry attempt does not cause database writes, making the automatic retries safe from side-effects, even if a query slips through the read-only detection. D1 achieves this by checking for modifications after every query execution, and if any write occurred due to a retry attempt, the query is rolled back.
2121

src/content/docs/d1/best-practices/retry-queries.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,11 @@ sidebar:
88

99
import { GitHubCode } from "~/components";
1010

11-
D1 automatically retries read-only queries up to 2 more times when it encounters a retryable error.
11+
It can be useful to retry queries from your application when you encounter an [error](/d1/observability/debug-d1/#error-list). From the list of `D1_ERROR`s, refer to the Recommended action column to determine if a query should be retried.
1212

13-
But it can be useful to retry queries from your application when you encounter an [error](/d1/observability/debug-d1/#error-list).
13+
:::note
14+
D1 automatically retries read-only queries up to 2 more times when it encounters a retryable error.
15+
:::
1416

1517
## Example of retrying queries
1618

0 commit comments

Comments
 (0)