Skip to content

Refresh Aurora DSQL SELECT FOR UPDATE sample guidance - #1821

Open
mchenjh wants to merge 1 commit into
aws-samples:mainfrom
mchenjh:fix/dsql-select-for-update
Open

mchenjh wants to merge 1 commit into
aws-samples:mainfrom
mchenjh:fix/dsql-select-for-update

Conversation

@mchenjh

@mchenjh mchenjh commented Sep 9, 2026

Copy link
Copy Markdown

Summary

Refresh Aurora DSQL samples for the GA SELECT FOR UPDATE behavior. Part of a coordinated rollout; sibling PR links will be added after all PRs are opened.

Changes

  • Update Sequelize guidance for non-key predicates, joined queries, supported lock modes, commit-time OCC behavior, and the 10 MiB locked-primary-key accounting rule.
  • Add a bounded whole-transaction SQLSTATE 40001 retry helper.
  • Clarify the Deno booking sample's write-skew behavior and SELECT FOR UPDATE mitigation.
  • Replace generic locked-row-count wording in adjacent sample guidance.

Validation

  • Sequelize: npm run build passed.
  • Sequelize live tests require CLUSTER_ENDPOINT and were not run locally.
  • Deno is not installed in the local environment, so Deno formatting and live tests were not run.

By submitting this pull request, I confirm that my contribution is made under the terms of the MIT-0 license.

Related rollout PRs

anwesham-lab pushed a commit to awslabs/aurora-dsql-orms that referenced this pull request Sep 14, 2026
## Summary

Update Aurora DSQL ORM adapters and guidance for the GA SELECT FOR
UPDATE behavior. Part of a coordinated rollout; sibling PR links will be
added after all PRs are opened.

## Changes

- Update Hibernate guidance and add coverage for non-key predicates with
an inner join.
- Preserve Hibernate's outer-join limitation.
- Enable Tortoise `select_for_update()` while disabling unsupported `FOR
NO KEY UPDATE`.
- Add Tortoise coverage for non-key filters and both
`update_or_create()` paths.
- Document commit-time OCC behavior, SQLSTATE 40001 retries, and 10 MiB
locked-primary-key accounting.
- Document Tortoise's outer-join query-builder limitation for joined
locking queries.

## Validation

- Hibernate: `./gradlew test` passed.
- Tortoise: Ruff format/lint passed; 124 unit tests and 6 subtests
passed.
- Live Aurora DSQL integration tests were not run locally.

## Related rollout PRs

- Canonical agent guidance: awslabs/agent-plugins#271
- Kiro Power mirror: awslabs/mcp#4607
- Flyway compatibility cleanup: flyway/flyway-community-db-support#149
- ORM adapters: #626
- Samples: aws-samples/aurora-dsql-samples#1821
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants