risingwave_meta/hummock/
error.rs

1// Copyright 2025 RisingWave Labs
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15use risingwave_hummock_sdk::{HummockContextId, HummockSstableObjectId};
16use risingwave_object_store::object::ObjectError;
17use risingwave_rpc_client::error::ToTonicStatus;
18use sea_orm::DbErr;
19use thiserror::Error;
20
21use crate::model::MetadataModelError;
22use crate::storage::MetaStoreError;
23
24pub type Result<T> = std::result::Result<T, Error>;
25
26#[derive(Error, Debug)]
27pub enum Error {
28    #[error("invalid hummock context {0}")]
29    InvalidContext(HummockContextId),
30    #[error("failed to access meta store")]
31    MetaStore(
32        #[source]
33        #[backtrace]
34        anyhow::Error,
35    ),
36    #[error(transparent)]
37    ObjectStore(
38        #[from]
39        #[backtrace]
40        ObjectError,
41    ),
42    #[error("compactor {0} is disconnected")]
43    CompactorUnreachable(HummockContextId),
44    #[error("compaction group error: {0}")]
45    CompactionGroup(String),
46    #[error("SST {0} is invalid")]
47    InvalidSst(HummockSstableObjectId),
48    #[error("time travel")]
49    TimeTravel(
50        #[source]
51        #[backtrace]
52        anyhow::Error,
53    ),
54    #[error(transparent)]
55    Internal(
56        #[from]
57        #[backtrace]
58        anyhow::Error,
59    ),
60}
61
62impl Error {
63    pub fn retryable(&self) -> bool {
64        matches!(self, Error::MetaStore(_))
65    }
66}
67
68impl From<MetaStoreError> for Error {
69    fn from(error: MetaStoreError) -> Self {
70        match error {
71            MetaStoreError::ItemNotFound(err) => anyhow::anyhow!(err).into(),
72            MetaStoreError::TransactionAbort() => {
73                // TODO: need more concrete error from meta store.
74                Error::Internal(anyhow::anyhow!("meta store transaction failed"))
75            }
76            // TODO: Currently MetaStoreError::Internal is equivalent to SqlError, which
77            // includes both retryable and non-retryable. Need to expand MetaStoreError::Internal
78            // to more detail meta_store errors.
79            MetaStoreError::Internal(err) => Error::MetaStore(err),
80        }
81    }
82}
83
84impl From<MetadataModelError> for Error {
85    fn from(err: MetadataModelError) -> Self {
86        match err {
87            MetadataModelError::MetaStoreError(e) => e.into(),
88            e => anyhow::anyhow!(e).into(),
89        }
90    }
91}
92
93impl From<sea_orm::DbErr> for Error {
94    fn from(value: DbErr) -> Self {
95        MetadataModelError::from(value).into()
96    }
97}
98
99impl From<Error> for tonic::Status {
100    fn from(err: Error) -> Self {
101        err.to_status(tonic::Code::Internal, "hummock")
102    }
103}
risingwave_meta/hummock/error.rs

risingwave_meta/hummock/
error.rs
