mz_adapter_types/
dyncfgs.rs

1// Copyright Materialize, Inc. and contributors. All rights reserved.
2//
3// Use of this software is governed by the Business Source License
4// included in the LICENSE file.
5//
6// As of the Change Date specified in that file, in accordance with
7// the Business Source License, use of this software will be governed
8// by the Apache License, Version 2.0.
9
10//! Dyncfgs used by the adapter layer.
11
12use std::time::Duration;
13
14use mz_dyncfg::{Config, ConfigSet};
15
16use crate::timestamp_selection::ConstraintBasedTimestampSelection;
17
18pub const ALLOW_USER_SESSIONS: Config<bool> = Config::new(
19    "allow_user_sessions",
20    true,
21    "Whether to allow user roles to create new sessions. When false, only system roles will be permitted to create new sessions.",
22);
23
24// Slightly awkward with the WITH prefix, but we can't start with a 0.
25pub const WITH_0DT_DEPLOYMENT_MAX_WAIT: Config<Duration> = Config::new(
26    "with_0dt_deployment_max_wait",
27    Duration::from_secs(60 * 60),
28    "How long to wait at most for clusters to be hydrated, when doing a zero-downtime deployment.",
29);
30
31pub const WITH_0DT_DEPLOYMENT_DDL_CHECK_INTERVAL: Config<Duration> = Config::new(
32    "with_0dt_deployment_ddl_check_interval",
33    Duration::from_secs(5 * 60),
34    "How often to check for DDL changes during zero-downtime deployment.",
35);
36
37pub const ENABLE_0DT_DEPLOYMENT_PANIC_AFTER_TIMEOUT: Config<bool> = Config::new(
38    "enable_0dt_deployment_panic_after_timeout",
39    false,
40    "Whether to panic if the maximum wait time is reached but preflight checks have not succeeded.",
41);
42
43pub const WITH_0DT_DEPLOYMENT_CAUGHT_UP_CHECK_INTERVAL: Config<Duration> = Config::new(
44    // The feature flag name is historical.
45    "0dt_deployment_hydration_check_interval",
46    Duration::from_secs(10),
47    "Interval at which to check whether clusters are caught up, when doing zero-downtime deployment.",
48);
49
50pub const WITH_0DT_CAUGHT_UP_CHECK_ALLOWED_LAG: Config<Duration> = Config::new(
51    "with_0dt_caught_up_check_allowed_lag",
52    Duration::from_secs(60),
53    "Maximum allowed lag when determining whether collections are caught up for 0dt deployments.",
54);
55
56pub const WITH_0DT_CAUGHT_UP_CHECK_CUTOFF: Config<Duration> = Config::new(
57    "with_0dt_caught_up_check_cutoff",
58    Duration::from_secs(10 * 60), // 10 minutes
59    "During a 0dt deployment, if a cluster has only 'problematic' (crash-looping) replicas _and_ any collection that is behind by more than this cutoff, the cluster will be ignored in caught-up checks.",
60);
61
62pub const ENABLE_0DT_CAUGHT_UP_REPLICA_STATUS_CHECK: Config<bool> = Config::new(
63    "enable_0dt_caught_up_replica_status_check",
64    true,
65    "Enable checking for crash/OOM-looping replicas during 0dt caught-up checks. Emergency break-glass flag to disable this feature if needed.",
66);
67
68/// Enable logging of statement lifecycle events in mz_internal.mz_statement_lifecycle_history.
69pub const ENABLE_STATEMENT_LIFECYCLE_LOGGING: Config<bool> = Config::new(
70    "enable_statement_lifecycle_logging",
71    true,
72    "Enable logging of statement lifecycle events in mz_internal.mz_statement_lifecycle_history.",
73);
74
75/// Enable installation of introspection subscribes.
76pub const ENABLE_INTROSPECTION_SUBSCRIBES: Config<bool> = Config::new(
77    "enable_introspection_subscribes",
78    true,
79    "Enable installation of introspection subscribes.",
80);
81
82/// The plan insights notice will not investigate fast path clusters if plan optimization took longer than this.
83pub const PLAN_INSIGHTS_NOTICE_FAST_PATH_CLUSTERS_OPTIMIZE_DURATION: Config<Duration> = Config::new(
84    "plan_insights_notice_fast_path_clusters_optimize_duration",
85    // Looking at production values of the mz_optimizer_e2e_optimization_time_seconds metric, most
86    // optimizations run faster than 10ms, so this should still work well for most queries. We want
87    // to avoid the case where an optimization took just under this value and there are lots of
88    // clusters, so the extra delay to produce the plan insights notice will take the optimization
89    // time * the number of clusters longer.
90    Duration::from_millis(10),
91    "Enable plan insights fast path clusters calculation if the optimize step took less than this duration.",
92);
93
94/// Whether to create system builtin continual tasks on boot.
95pub const ENABLE_CONTINUAL_TASK_BUILTINS: Config<bool> = Config::new(
96    "enable_continual_task_builtins",
97    false,
98    "Create system builtin continual tasks on boot.",
99);
100
101/// Whether to use an expression cache on boot.
102pub const ENABLE_EXPRESSION_CACHE: Config<bool> = Config::new(
103    "enable_expression_cache",
104    true,
105    "Use a cache to store optimized expressions to help speed up start times.",
106);
107
108/// Whether we allow sources in multi-replica clusters.
109pub const ENABLE_MULTI_REPLICA_SOURCES: Config<bool> = Config::new(
110    "enable_multi_replica_sources",
111    true,
112    "Enable multi-replica sources.",
113);
114
115/// Whether to enable password authentication.
116pub const ENABLE_PASSWORD_AUTH: Config<bool> = Config::new(
117    "enable_password_auth",
118    false,
119    "Enable password authentication.",
120);
121
122pub const CONSTRAINT_BASED_TIMESTAMP_SELECTION: Config<&'static str> = Config::new(
123    "constraint_based_timestamp_selection",
124    ConstraintBasedTimestampSelection::const_default().as_str(),
125    "Whether to use the constraint-based timestamp selection, one of: enabled, disabled, verify",
126);
127
128pub const PERSIST_FAST_PATH_ORDER: Config<bool> = Config::new(
129    "persist_fast_path_order",
130    false,
131    "If set, send queries with a compatible literal constraint or ordering clause down the Persist fast path.",
132);
133
134/// Adds the full set of all compute `Config`s.
135pub fn all_dyncfgs(configs: ConfigSet) -> ConfigSet {
136    configs
137        .add(&ALLOW_USER_SESSIONS)
138        .add(&WITH_0DT_DEPLOYMENT_MAX_WAIT)
139        .add(&WITH_0DT_DEPLOYMENT_DDL_CHECK_INTERVAL)
140        .add(&ENABLE_0DT_DEPLOYMENT_PANIC_AFTER_TIMEOUT)
141        .add(&WITH_0DT_DEPLOYMENT_CAUGHT_UP_CHECK_INTERVAL)
142        .add(&WITH_0DT_CAUGHT_UP_CHECK_ALLOWED_LAG)
143        .add(&WITH_0DT_CAUGHT_UP_CHECK_CUTOFF)
144        .add(&ENABLE_0DT_CAUGHT_UP_REPLICA_STATUS_CHECK)
145        .add(&ENABLE_STATEMENT_LIFECYCLE_LOGGING)
146        .add(&ENABLE_INTROSPECTION_SUBSCRIBES)
147        .add(&PLAN_INSIGHTS_NOTICE_FAST_PATH_CLUSTERS_OPTIMIZE_DURATION)
148        .add(&ENABLE_CONTINUAL_TASK_BUILTINS)
149        .add(&ENABLE_EXPRESSION_CACHE)
150        .add(&ENABLE_MULTI_REPLICA_SOURCES)
151        .add(&ENABLE_PASSWORD_AUTH)
152        .add(&CONSTRAINT_BASED_TIMESTAMP_SELECTION)
153        .add(&PERSIST_FAST_PATH_ORDER)
154}