Skip to content

enhance:[2.6] classify packed extend status codes into segcore error codes (#575) - #578

Open
jiaqizho wants to merge 1 commit into
milvus-io:2.6from
jiaqizho:2.6-cherry-pick-v2-errorcode
Open

enhance:[2.6] classify packed extend status codes into segcore error codes (#575)#578
jiaqizho wants to merge 1 commit into
milvus-io:2.6from
jiaqizho:2.6-cherry-pick-v2-errorcode

Conversation

@jiaqizho

@jiaqizho jiaqizho commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Add the producer-owned mapping ToSegcoreErrorCode / ToSegcoreError so milvus-storage classifies its own packed failures once, at the source, and milvus can consume a typed segcore ErrorCode instead of a generic Arrow status text.

Note: this builds on #572 (jiaqizho — packed ExtendStatusCode +
WrapExtendError), which is not yet merged, so this branch currently includes those commits. Once #572 lands this PR should be rebased onto it so it only carries the mapping delta. Happy to coordinate.

ExtendStatusCode segcore ErrorCode retry
PackedInvalidArgs InvalidParameter (2042) non-retriable (input)
PackedArrowError / PackedUnexpected / AWS / Txn StorageError (2044) permanent

The retriable verdict is load-bearing: a transient storage IO failure maps to the retriable StorageTransientError(2045) and must never collapse into the non-retriable StorageError(2044). The switch has no default + a post-switch fallback under -Werror=switch, so a new ExtendStatusCode breaks the build until classified. The no-detail path keeps a coarse arrow mapping (IO→transient, OOM→mem-allocate, Invalid/Type/Key→corruption).

Depends on milvus-common StorageTransientError(2045): zilliztech/milvus-common#102. Bump the milvus-common conan pin to the published 2045 revision before merge (the pin here points at a local build for verification).

Design + tracking: milvus-io/milvus#50903. Consumed by milvus-io/milvus#50768.


(cherry picked from commit 9c28242)

@sre-ci-robot
sre-ci-robot requested review from sunby and tedxu July 7, 2026 03:51
@sre-ci-robot

Copy link
Copy Markdown
Collaborator

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: jiaqizho
To complete the pull request process, please assign sunby after the PR has been reviewed.
You can assign the PR to them by writing /assign @sunby in a comment when ready.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@jiaqizho
jiaqizho force-pushed the 2.6-cherry-pick-v2-errorcode branch from 1f9ae8c to 0da436d Compare July 7, 2026 03:56
…milvus-io#575)

Add the producer-owned mapping `ToSegcoreErrorCode` / `ToSegcoreError`
so milvus-storage classifies its own packed failures once, at the
source, and milvus can consume a typed segcore `ErrorCode` instead of a
generic Arrow status text.

> Note: this **builds on milvus-io#572** (jiaqizho — packed `ExtendStatusCode` +
`WrapExtendError`), which is not yet merged, so this branch currently
includes those commits. Once milvus-io#572 lands this PR should be rebased onto
it so it only carries the mapping delta. Happy to coordinate.

| ExtendStatusCode | segcore ErrorCode | retry |
|---|---|---|
| PackedInvalidArgs | InvalidParameter (2042) | non-retriable (input) |
| PackedStorageIO | **StorageTransientError (2045)** | **retriable** |
| PackedMetadataCorrupted / PackedFileCorrupted | DataFormatBroken
(2024) | permanent |
| PackedArrowError / PackedUnexpected / AWS / Txn | StorageError (2044)
| permanent |

The retriable verdict is load-bearing: a transient storage IO failure
maps to the retriable `StorageTransientError(2045)` and must never
collapse into the non-retriable `StorageError(2044)`. The switch has no
`default` + a post-switch fallback under `-Werror=switch`, so a new
`ExtendStatusCode` breaks the build until classified. The no-detail path
keeps a coarse arrow mapping (IO→transient, OOM→mem-allocate,
Invalid/Type/Key→corruption).

Depends on `milvus-common` `StorageTransientError(2045)`:
zilliztech/milvus-common#102. Bump the `milvus-common` conan pin to the
published 2045 revision before merge (the pin here points at a local
build for verification).

Design + tracking: milvus-io/milvus#50903. Consumed by
milvus-io/milvus#50768.

---------

Signed-off-by: zhenshan.cao <zhenshan.cao@zilliz.com>
Signed-off-by: jiaqizho <jiaqi.zhou@zilliz.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: jiaqizho <jiaqi.zhou@zilliz.com>
(cherry picked from commit 9c28242)
Signed-off-by: jiaqizho <jiaqi.zhou@zilliz.com>
@jiaqizho
jiaqizho force-pushed the 2.6-cherry-pick-v2-errorcode branch from 0da436d to a0a7c16 Compare July 7, 2026 08:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants