risingwave_connector/
error.rs

1// Copyright 2022 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 std::sync::Arc;
16
17use risingwave_common::array::ArrayError;
18use risingwave_common::error::def_anyhow_newtype;
19use risingwave_pb::PbFieldNotFound;
20use risingwave_rpc_client::error::RpcError;
21
22use crate::enforce_secret::EnforceSecretError;
23use crate::parser::AccessError;
24use crate::schema::InvalidOptionError;
25use crate::schema::schema_registry::{
26    ConcurrentRequestError, SchemaRegistryClientError, WireFormatError,
27};
28use crate::sink::SinkError;
29use crate::source::mqtt::MqttError;
30use crate::source::nats::NatsJetStreamError;
31
32def_anyhow_newtype! {
33    pub ConnectorError,
34
35    // Common errors
36    std::io::Error => transparent,
37    Arc<ConnectorError> => transparent,
38
39    // Fine-grained connector errors
40    AccessError => transparent,
41    WireFormatError => transparent,
42    ConcurrentRequestError => transparent,
43    InvalidOptionError => transparent,
44    SinkError => transparent,
45    PbFieldNotFound => transparent,
46
47    // TODO(error-handling): Remove implicit contexts below and specify ad-hoc context for each conversion.
48
49    // Parsing errors
50    url::ParseError => "failed to parse url",
51    serde_json::Error => "failed to parse json",
52    csv::Error => "failed to parse csv",
53
54    uuid::Error => transparent, // believed to be self-explanatory
55
56    // Connector errors
57    opendal::Error => transparent, // believed to be self-explanatory
58    parquet::errors::ParquetError => transparent,
59    ArrayError => "Array error",
60    sqlx::Error => transparent, // believed to be self-explanatory
61    mysql_async::Error => "MySQL error",
62    tokio_postgres::Error => "Postgres error",
63    tiberius::error::Error => "Sql Server error",
64    apache_avro::Error => "Avro error",
65    rdkafka::error::KafkaError => "Kafka error",
66    pulsar::Error => "Pulsar error",
67
68    async_nats::jetstream::consumer::StreamError => "Nats error",
69    async_nats::jetstream::consumer::pull::MessagesError => "Nats error",
70    async_nats::jetstream::context::CreateStreamError => "Nats error",
71    async_nats::jetstream::stream::ConsumerError => "Nats error",
72    async_nats::error::Error<async_nats::jetstream::context::RequestErrorKind> => "Nats error",
73    NatsJetStreamError => "Nats error",
74
75    risingwave_common::error::IcebergError => "IcebergV2 error",
76    redis::RedisError => "Redis error",
77    risingwave_common::array::arrow::arrow_schema_iceberg::ArrowError => "Arrow error",
78    google_cloud_pubsub::client::google_cloud_auth::error::Error => "Google Cloud error",
79    rumqttc::tokio_rustls::rustls::Error => "TLS error",
80    rumqttc::v5::ClientError => "MQTT SDK error",
81    rumqttc::v5::OptionError => "MQTT Option error",
82    rumqttc::v5::ConnectionError => "MQTT Connection error",
83    MqttError => "MQTT Source error",
84    mongodb::error::Error => "Mongodb error",
85
86    openssl::error::ErrorStack => "OpenSSL error",
87    risingwave_common::secret::SecretError => "Secret error",
88    EnforceSecretError => transparent,
89
90    // ADBC errors
91    #[cfg(feature = "source-adbc_snowflake")]
92    adbc_core::error::Error => "ADBC error",
93    SchemaRegistryClientError => "Schema registry client error",
94}
95
96pub type ConnectorResult<T, E = ConnectorError> = std::result::Result<T, E>;
97
98impl From<ConnectorError> for RpcError {
99    fn from(value: ConnectorError) -> Self {
100        RpcError::Internal(value.0)
101    }
102}
103
104#[expect(clippy::disallowed_types)]
105impl From<iceberg::Error> for ConnectorError {
106    fn from(value: iceberg::Error) -> Self {
107        risingwave_common::error::IcebergError::from(value).into()
108    }
109}
risingwave_connector/error.rs

risingwave_connector/
error.rs
