risingwave_common/system_param/
reader.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 std::borrow::Borrow;
16use std::str::FromStr;
17
18use risingwave_license::LicenseKeyRef;
19use risingwave_pb::meta::PbSystemParams;
20
21use super::{AdaptiveParallelismStrategy, ParamValue, default};
22use crate::for_all_params;
23
24/// Information about a system parameter.
25///
26/// Used to display to users through `pg_settings` system table and `SHOW PARAMETERS` command.
27pub struct ParameterInfo {
28    pub name: &'static str,
29    pub mutable: bool,
30    /// The [`ToString`] representation of the parameter value.
31    ///
32    /// Certain parameters, such as `license_key`, may be sensitive, and redaction is applied to them in their newtypes.
33    /// As a result, we get the redacted value here for display.
34    pub value: String,
35    pub description: &'static str,
36}
37
38macro_rules! define_system_params_read_trait {
39    ($({ $field:ident, $type:ty, $default:expr, $is_mutable:expr, $doc:literal, $($rest:tt)* },)*) => {
40        /// The trait delegating reads on [`risingwave_pb::meta::SystemParams`].
41        ///
42        /// Purposes:
43        /// - Avoid misuse of deprecated fields by hiding their getters.
44        /// - Abstract fallback logic for fields that might not be provided by meta service due to backward
45        ///   compatibility.
46        /// - Redact sensitive fields by returning a newtype around the original value.
47        pub trait SystemParamsRead {
48            $(
49                #[doc = $doc]
50                fn $field(&self) -> <$type as ParamValue>::Borrowed<'_>;
51            )*
52
53            /// Return the information of all parameters.
54            fn get_all(&self) -> Vec<ParameterInfo> {
55                vec![
56                    $(
57                        ParameterInfo {
58                            name: stringify!($field),
59                            mutable: $is_mutable,
60                            value: self.$field().to_string(), // use `to_string` to get displayable (maybe redacted) value
61                            description: $doc,
62                        },
63                    )*
64                ]
65            }
66        }
67    };
68}
69
70for_all_params!(define_system_params_read_trait);
71
72/// The wrapper delegating reads on [`risingwave_pb::meta::SystemParams`].
73///
74/// See [`SystemParamsRead`] for more details.
75// TODO: should we manually impl `PartialEq` by comparing each field with read functions?
76#[derive(Clone, PartialEq)]
77pub struct SystemParamsReader<I = PbSystemParams> {
78    inner: I,
79}
80
81// TODO: should ban `Debug` for inner `SystemParams`.
82// https://github.com/risingwavelabs/risingwave/pull/17906#discussion_r1705056943
83macro_rules! impl_system_params_reader_debug {
84    ($({ $field:ident, $($rest:tt)* },)*) => {
85        impl<I> std::fmt::Debug for SystemParamsReader<I>
86        where
87            I: Borrow<PbSystemParams>,
88        {
89            fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
90                f.debug_struct("SystemParamsReader")
91                    $(
92                        .field(stringify!($field), &self.$field())
93                    )*
94                    .finish()
95            }
96        }
97    };
98}
99
100for_all_params!(impl_system_params_reader_debug);
101
102impl<I> From<I> for SystemParamsReader<I>
103where
104    I: Borrow<PbSystemParams>,
105{
106    fn from(inner: I) -> Self {
107        Self { inner }
108    }
109}
110
111impl<I> SystemParamsReader<I>
112where
113    I: Borrow<PbSystemParams>,
114{
115    pub fn new(inner: I) -> Self {
116        Self { inner }
117    }
118
119    /// Return a new reader with the reference to the inner system params.
120    pub fn as_ref(&self) -> SystemParamsReader<&PbSystemParams> {
121        SystemParamsReader {
122            inner: self.inner(),
123        }
124    }
125
126    fn inner(&self) -> &PbSystemParams {
127        self.inner.borrow()
128    }
129}
130
131/// - Unwrap the field if it always exists.
132///   For example, if a parameter is introduced before the initial public release.
133///
134/// - Otherwise, specify the fallback logic when the field is missing.
135impl<I> SystemParamsRead for SystemParamsReader<I>
136where
137    I: Borrow<PbSystemParams>,
138{
139    fn barrier_interval_ms(&self) -> u32 {
140        self.inner().barrier_interval_ms.unwrap()
141    }
142
143    fn enforce_secret(&self) -> bool {
144        self.inner()
145            .enforce_secret
146            .unwrap_or_else(default::enforce_secret)
147    }
148
149    fn checkpoint_frequency(&self) -> u64 {
150        self.inner().checkpoint_frequency.unwrap()
151    }
152
153    fn parallel_compact_size_mb(&self) -> u32 {
154        self.inner().parallel_compact_size_mb.unwrap()
155    }
156
157    fn sstable_size_mb(&self) -> u32 {
158        self.inner().sstable_size_mb.unwrap()
159    }
160
161    fn block_size_kb(&self) -> u32 {
162        self.inner().block_size_kb.unwrap()
163    }
164
165    fn bloom_false_positive(&self) -> f64 {
166        self.inner().bloom_false_positive.unwrap()
167    }
168
169    fn state_store(&self) -> &str {
170        self.inner().state_store.as_ref().unwrap()
171    }
172
173    fn data_directory(&self) -> &str {
174        self.inner().data_directory.as_ref().unwrap()
175    }
176
177    fn use_new_object_prefix_strategy(&self) -> bool {
178        *self
179            .inner()
180            .use_new_object_prefix_strategy
181            .as_ref()
182            .unwrap()
183    }
184
185    fn backup_storage_url(&self) -> &str {
186        self.inner().backup_storage_url.as_ref().unwrap()
187    }
188
189    fn backup_storage_directory(&self) -> &str {
190        self.inner().backup_storage_directory.as_ref().unwrap()
191    }
192
193    fn max_concurrent_creating_streaming_jobs(&self) -> u32 {
194        self.inner().max_concurrent_creating_streaming_jobs.unwrap()
195    }
196
197    fn pause_on_next_bootstrap(&self) -> bool {
198        self.inner()
199            .pause_on_next_bootstrap
200            .unwrap_or_else(default::pause_on_next_bootstrap)
201    }
202
203    fn enable_tracing(&self) -> bool {
204        self.inner()
205            .enable_tracing
206            .unwrap_or_else(default::enable_tracing)
207    }
208
209    fn license_key(&self) -> LicenseKeyRef<'_> {
210        self.inner()
211            .license_key
212            .as_deref()
213            .unwrap_or_default()
214            .into()
215    }
216
217    fn time_travel_retention_ms(&self) -> u64 {
218        self.inner()
219            .time_travel_retention_ms
220            .unwrap_or_else(default::time_travel_retention_ms)
221    }
222
223    fn adaptive_parallelism_strategy(&self) -> AdaptiveParallelismStrategy {
224        self.inner()
225            .adaptive_parallelism_strategy
226            .as_deref()
227            .and_then(|s| AdaptiveParallelismStrategy::from_str(s).ok())
228            .unwrap_or(AdaptiveParallelismStrategy::Auto)
229    }
230
231    fn per_database_isolation(&self) -> <bool as ParamValue>::Borrowed<'_> {
232        self.inner()
233            .per_database_isolation
234            .unwrap_or_else(default::per_database_isolation)
235    }
236}
risingwave_common/system_param/reader.rs

risingwave_common/system_param/
reader.rs
