cockroachdb / cockroachdb/docs

update read committed docs around handling retries

Open
#18,375 6 comments 0 reactions 1 assignee Assigned to @taroface View on GitHub
Dominant language
HTML
Stars
212
Forks
476
Avg merge
40m
Merged PRs (30d)
3

Description

Michael Erickson (michae2) commented:

In 23.2, under read committed isolation, applications could still encounter spurious 40001 errors in rare cases, such as lease transfers. In 24.1, under read committed isolation, we expect applications to encounter ***no*** spurious 40001 errors. (The only 40001 errors applications might encounter are all avoidable through workload changes, such as avoiding deadlocks or increasing `results_buffer_size`.)

This lack of 40001 errors is a special property of read committed isolation, and is definitely worth documenting.

I'm not sure exactly which pages should be updated, but from a quick glance maybe the following:
- https://www.cockroachlabs.com/docs/v24.1/transactions
- https://www.cockroachlabs.com/docs/v24.1/transaction-retry-error-reference
- https://www.cockroachlabs.com/docs/v24.1/read-committed

Jira Issue: DOC-9869

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.