Skip to content

docs: report SYNC replication failure as a notification - #1745

Open
as51340 wants to merge 1 commit into
release/3.13from
feat/sync-notification
Open

docs: report SYNC replication failure as a notification#1745
as51340 wants to merge 1 commit into
release/3.13from
feat/sync-notification

Conversation

@as51340

@as51340 as51340 commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Release note

A transaction that cannot reach every SYNC replica is still committed on the main instance and on every reachable replica, so it no longer fails the query. The failure is now reported as a WARNING notification with the code SyncReplicationFailure, delivered in the summary of the last query of an implicit transaction or of the explicit COMMIT. ReplicationException is kept only for the case where the transaction was actually rolled back everywhere (STRICT_SYNC two-phase commit abort). This is a client-visible breaking change for applications that caught the replication exception around writes.

Related product PRs

Checklist:

  • Add appropriate milestone (current release cycle)
  • Add bugfix or feature label, based on the product PR type you're documenting
  • Make sure all relevant tech details are documented
    • Update reference pages
    • Search for the feature you are working on (mentions) and make updates if needed
    • Provide a basic example of usage
    • In case your feature is an Enterprise one, list it under ME page — n/a
  • Check all content with Grammarly
  • Perform a self-review of my code
  • The build passes locally — not verified, node_modules is not installed in this worktree
  • My changes generate no new warnings or errors

A transaction that cannot reach every SYNC replica is still committed on
the main and on every reachable replica, so memgraph/memgraph#4601 stopped
failing the query and reports the failure as a WARNING notification with
the code SyncReplicationFailure instead. ReplicationException is kept only
for the case where the transaction was rolled back everywhere (STRICT_SYNC
two-phase commit abort).

- query-metadata: add the SyncReplicationFailure code and a section on
  commit-time notifications, which reach the client in the summary of the
  last query of an implicit transaction or of the explicit COMMIT
- how-replication-works: SYNC failures now succeed with a notification;
  name ReplicationException explicitly in the STRICT_SYNC section
- help-center errors: split notification from exception by transaction
  outcome rather than by replica mode
- setup-ha-cluster-k8s: rolling upgrades no longer require applications to
  catch a replication exception on SYNC writes
- release-notes: v3.13.0 breaking change entry
@as51340 as51340 added the feature Documentation related to a new product feature of feature update label Sep 2, 2026
@vercel

vercel Bot commented Sep 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
documentation Ready Ready Preview Sep 2, 2026 5:48am UTC

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature Documentation related to a new product feature of feature update

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant