Skip to content

release-25.2: fix spurious LDR DLQ entries #147350

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

Merged

Conversation

jeffswenson
Copy link
Collaborator

Backport:

Please see individual PRs for details.

Release justification: fixes #145994 which was discovered in customer environments.

/cc @cockroachdb/release

This reworks the crud table handler's exhaustive test so that it runs
against the batch handler interface. That allows it to test all of the
LDR handler implementations.

The test was extended to metamorphically define a unique
index/constraint and swap the primary key column id. This allows the
test to reproduce cockroachdb#145994.

Informs: cockroachdb#145994
Release note: none
DistSender splits requests up in range order and collects errors in the
order requests were dispatched. If there are multiple errors, the
highest priority error is returned and ties are broken by dispatch
order. Now, the merge logic consults the index of the request that
generated the error. This is particularly useful for CPuts as it allows
the caller to observe the first cput in the batch that failed.

The deterministic order allows LDR, `deleteSwap`, and `updateSwap` to
guarantee the cput error is for the primary key. This property is
essential because they are using cput to optimistically guess at the
value of the row in the database. The batches may also contain cput
failures for unique indexes, but those errors should only be raised to
the user if the primary key cput succeeded.

This is still a bit of a hack. In a perfect world, the cput failure
would be treated as a result instead of an error. That would allow the
caller to inspect each cput result independently and would make it clear
that cput failures do not poison any of the other requests in the
batch.

Informs: cockroachdb#146117
Release note: fixes an issue with LDR where the presence of a unique
index may cause spurious DLQ entries if the unique index has a smaller
index id than the primary key index.
@jeffswenson jeffswenson requested review from a team as code owners May 27, 2025 17:45
Copy link

blathers-crl bot commented May 27, 2025

Thanks for opening a backport.

Please check the backport criteria before merging:

  • Backports should only be created for serious
    issues
    or test-only changes.
  • Backports should not break backwards-compatibility.
  • Backports should change as little code as possible.
  • Backports should not change on-disk formats or node communication protocols.
  • Backports should not add new functionality (except as defined
    here).
  • Backports must not add, edit, or otherwise modify cluster versions; or add version gates.
  • All backports must be reviewed by the owning areas TL. For more information as to how that review should be conducted, please consult the backport
    policy
    .
If your backport adds new functionality, please ensure that the following additional criteria are satisfied:
  • There is a high priority need for the functionality that cannot wait until the next release and is difficult to address in another way.
  • The new functionality is additive-only and only runs for clusters which have specifically “opted in” to it (e.g. by a cluster setting).
  • New code is protected by a conditional check that is trivial to verify and ensures that it only runs for opt-in clusters. State changes must be further protected such that nodes running old binaries will not be negatively impacted by the new state (with a mixed version test added).
  • The PM and TL on the team that owns the changed code have signed off that the change obeys the above rules.
  • Your backport must be accompanied by a post to the appropriate Slack
    channel (#db-backports-point-releases or #db-backports-XX-X-release) for awareness and discussion.

Also, please add a brief release justification to the body of your PR to justify this
backport.

@blathers-crl blathers-crl bot added the backport Label PR's that are backports to older release branches label May 27, 2025
@cockroach-teamcity
Copy link
Member

This change is Reviewable

@jeffswenson
Copy link
Collaborator Author

@arulajmani I added you as a TL reviewer because the core fix is a change to the distsender.

Copy link
Collaborator

@arulajmani arulajmani left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:lgtm:

Reviewed 3 of 3 files at r1, 3 of 3 files at r2, all commit messages.
Reviewable status: :shipit: complete! 1 of 0 LGTMs obtained (waiting on @msbutler)


pkg/kv/kvclient/kvcoord/dist_sender.go line 1684 at r2 (raw file):

// priority, the error with the lowest request index is preferred. This allows
// a caller issuing multiple cputs to control which ConditionFailedError is
// returned. Specifically, it allows returning a primary key cput failure

Is this comment incomplete? In particular, doesn't it rely on the primary key CPut being earlier in batch compared to a unique index CPut? It doesn't need to hold this backport, or be backported, but could we improve this comment on master?

@jeffswenson
Copy link
Collaborator Author

Here is a PR on the master branch clarifying the doc comment: #147493

Thanks for the reviews!

@jeffswenson jeffswenson merged commit 18598f0 into cockroachdb:release-25.2 May 29, 2025
15 checks passed
@jeffswenson jeffswenson deleted the backport25.2-147001-147117 branch May 29, 2025 15:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport Label PR's that are backports to older release branches target-release-25.2.2
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants