{"record":{"id":"2217121bc41ba8ba","repo":"hasura/graphql-engine","slug":"0-221712","errorCode":null,"errorMessage":"{0}","messagePattern":"\\{0\\}","errorType":"exception","errorClass":"DataConnectorError::NdcValidationError","httpStatus":null,"severity":"error","filePath":"v3/crates/metadata-resolve/src/stages/data_connectors/error.rs","lineNumber":30,"sourceCode":"\n#[derive(Debug, thiserror::Error)]\n#[error(\"The data connector {data_connector_name} has an error: {error}\")]\npub struct NamedDataConnectorError {\n    pub data_connector_name: Qualified<DataConnectorName>,\n    pub error: DataConnectorError,\n}\n\n#[derive(Debug, thiserror::Error)]\npub enum DataConnectorError {\n    #[error(\"the data connector is defined more than once\")]\n    DuplicateDataConnectorDefinition,\n    #[error(\"The url for the data connector is invalid: {error}\")]\n    InvalidDataConnectorUrl { error: url::ParseError },\n    #[error(\"Invalid header name {header_name} specified\")]\n    InvalidHeaderName { header_name: String },\n    #[error(\"Invalid value specified for header {header_name}\")]\n    InvalidHeaderValue { header_name: String },\n    #[error(\"{0}\")]\n    NdcValidationError(NDCValidationError),\n    #[error(\n        \"The version specified in the capabilities (\\\"{version}\\\") is an invalid version: {error}\"\n    )]\n    InvalidNdcVersion {\n        version: String,\n        error: semver::Error,\n    },\n    #[error(\n        \"The version specified in the capabilities (\\\"{version}\\\") is not compatible with the schema version specified. The version requirement is {requirement}\"\n    )]\n    IncompatibleNdcVersion {\n        version: String,\n        requirement: semver::VersionReq,\n    },\n}\n\n#[derive(Debug, thiserror::Error)]","sourceCodeStart":12,"sourceCodeEnd":48,"githubUrl":"https://github.com/hasura/graphql-engine/blob/724551b9ae87845594ef0408cff0e50eb6c90dc5/v3/crates/metadata-resolve/src/stages/data_connectors/error.rs#L12-L48","documentation":"Transparent wrapper for NDCValidationError at the connector level: the connector's capabilities/schema document failed validation against the NDC specification.","triggerScenarios":"Fetching or supplying capabilities that don't conform to the NDC spec while resolving the connector.","commonSituations":"Connector version mismatch with the spec version expected by this build; hand-written capabilities documents.","solutions":["Inspect inner NDCValidationError details","Upgrade the data connector to a spec-conformant version","Fix the capabilities document"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"// Validate the capabilities document against the NDC spec schema before wiring it in\nndc_spec_validation::validate(&capabilities)?;","typeGuard":null,"tryCatchPattern":"Catch the wrapper and log the inner NDCValidationError's detailed findings.","preventionTips":["Pin connector versions validated in CI","Validate capabilities responses on connector startup"],"tags":["ndc","data-connector","validation"],"backgroundTag":"schema-validation-failed","analyzedSha":"724551b9ae87845594ef0408cff0e50eb6c90dc5","analyzedAt":"2026-08-28T07:32:55.105Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}