{"record":{"id":"8471da3936fe6ca1","repo":"risingwavelabs/risingwave","slug":"external-system-error-0","errorCode":null,"errorMessage":"External system error: {0}","messagePattern":"External system error: (.+?)","errorType":"error_code","errorClass":"BatchError","httpStatus":null,"severity":"error","filePath":"src/batch/src/error.rs","lineNumber":115,"sourceCode":"        #[backtrace]\n        BoxedError,\n    ),\n\n    #[error(\"Failed to read from system table: {0}\")]\n    SystemTable(\n        #[from]\n        #[backtrace]\n        BoxedError,\n    ),\n\n    #[error(transparent)]\n    Dml(\n        #[from]\n        #[backtrace]\n        DmlError,\n    ),\n\n    #[error(\"External system error: {0}\")]\n    ExternalSystemError(\n        #[from]\n        #[backtrace]\n        BatchExternalSystemError,\n    ),\n\n    // Make the ref-counted type to be a variant for easier code structuring.\n    // TODO(error-handling): replace with `thiserror_ext::Arc`\n    #[error(transparent)]\n    Shared(\n        #[from]\n        #[backtrace]\n        Arc<Self>,\n    ),\n\n    #[error(\"Empty workers found\")]\n    EmptyWorkerNodes,\n","sourceCodeStart":97,"sourceCodeEnd":133,"githubUrl":"https://github.com/risingwavelabs/risingwave/blob/6469eb736d691e8e9b8a419a57edd6429ca77417/src/batch/src/error.rs#L97-L133","documentation":"BatchError::ExternalSystemError: an operation against an external system outside the connector path failed — the wrapped BatchExternalSystemError covers things like query-file system access, external sink/source services used by batch tasks. It fires when a batch task delegates to an external component (filesystem, ad-hoc service) and that component reports an error that has no dedicated BatchError variant.","triggerScenarios":"Thrown at src/batch/src/error.rs:115 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Inspect the wrapped BatchExternalSystemError to identify the external component and its native error","Fix the underlying external resource (permissions, reachability, configuration)","Retry if the external system failure is transient"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"6469eb736d691e8e9b8a419a57edd6429ca77417","analyzedAt":"2026-09-11T21:06:21.487Z","contentChangedAt":"2026-09-11T21:06:21.487Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}