{"record":{"id":"c04bacc0d9aea028","repo":"risingwavelabs/risingwave","slug":"system-parameters-error-0","errorCode":null,"errorMessage":"System parameters error: {0}","messagePattern":"System parameters error: (.+?)","errorType":"error_code","errorClass":"MetaError","httpStatus":null,"severity":"error","filePath":"src/meta/src/error.rs","lineNumber":100,"sourceCode":"\n    #[error(\"{0} named {1} already exists{under_creation}\", under_creation = (.2).map(|_| \" and is still being created\").unwrap_or(\"\"))]\n    Duplicated(\n        &'static str,\n        String,\n        // if under creation, take streaming job id, otherwise None\n        Option<JobId>,\n    ),\n\n    #[error(\"Service unavailable: {0}\")]\n    Unavailable(#[message] String),\n\n    #[error(\"Election failed: {0}\")]\n    Election(#[source] BoxedError),\n\n    #[error(\"Cancelled: {0}\")]\n    Cancelled(String),\n\n    #[error(\"System parameters error: {0}\")]\n    SystemParams(String),\n\n    #[error(\"Session parameters error: {0}\")]\n    SessionConfig(\n        #[from]\n        #[backtrace]\n        SessionConfigError,\n    ),\n\n    #[error(transparent)]\n    Connector(\n        #[from]\n        #[backtrace]\n        ConnectorError,\n    ),\n\n    #[error(\"Sink error: {0}\")]\n    Sink(","sourceCodeStart":82,"sourceCodeEnd":118,"githubUrl":"https://github.com/risingwavelabs/risingwave/blob/6469eb736d691e8e9b8a419a57edd6429ca77417/src/meta/src/error.rs#L82-L118","documentation":"A system parameter (cluster-level configuration stored in meta, e.g. barrier_interval_ms, s3 settings) could not be read or applied. The String explains the problem. Raised by the system-params management code paths.","triggerScenarios":"`ALTER SYSTEM SET` with an invalid value, failing to load/persist system params at startup, param value failing deserialization or range validation.","commonSituations":"Typo'd or out-of-range values in ALTER SYSTEM, manually editing meta storage and corrupting a param, version upgrade where a param's allowed type/range changed.","solutions":["Read the message to identify the offending parameter.","Use `SHOW PARAMETERS`/risectl to inspect current valid system params and their ranges.","Reset the parameter to its default (`ALTER SYSTEM RESET`) and reapply a valid value.","If params are corrupted in the meta store, restore or manually fix the param entry, then restart meta."],"exampleFix":"// before\nALTER SYSTEM SET barrier_interval_ms = 'abc'; -- SystemParams error\n// after\nALTER SYSTEM SET barrier_interval_ms = 1000;","handlingStrategy":"validation","validationCode":"fn valid_barrier_interval(v: &str) -> bool {\n    v.parse::<u64>().map(|n| n > 0).unwrap_or(false)\n}","typeGuard":null,"tryCatchPattern":"match meta_result {\n    Err(MetaError::SystemParams(msg)) => { /* show valid params, reset to default */ }\n    other => other?,\n}","preventionTips":["Only set system params via `ALTER SYSTEM` / supported APIs, never by editing meta storage directly.","Consult `SHOW PARAMETERS` for allowed names, types, and ranges.","Test param changes in staging; note ranges can change between RisingWave versions."],"tags":["meta","system-parameters","configuration"],"backgroundTag":"invalid-config-value","analyzedSha":"6469eb736d691e8e9b8a419a57edd6429ca77417","analyzedAt":"2026-09-11T21:06:21.487Z","contentChangedAt":"2026-09-11T21:06:21.487Z","schemaVersion":2},"datasetVersion":"2026-09-14T16:17:12.679Z"}