{"record":{"id":"725df19dded112fb","repo":"hasura/graphql-engine","slug":"the-data-connector-data-connector-name-has-an-is","errorCode":null,"errorMessage":"The data connector {data_connector_name} has an issue: {issue}","messagePattern":"The data connector (.+?) has an issue: (.+?)","errorType":"validation","errorClass":"NamedDataConnectorIssue","httpStatus":null,"severity":"warning","filePath":"v3/crates/metadata-resolve/src/stages/data_connectors/error.rs","lineNumber":49,"sourceCode":"    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)]\n#[error(\"The data connector {data_connector_name} has an issue: {issue}\")]\npub struct NamedDataConnectorIssue {\n    pub data_connector_name: Qualified<DataConnectorName>,\n    pub issue: DataConnectorIssue,\n}\n\nimpl ShouldBeAnError for NamedDataConnectorIssue {\n    fn should_be_an_error(&self, flags: &flags::OpenDdFlags) -> bool {\n        self.issue.should_be_an_error(flags)\n    }\n}\n\n#[derive(Debug, thiserror::Error)]\npub enum DataConnectorIssue {\n    #[error(\n        \"The version specified in the capabilities (\\\"{version}\\\") is an invalid version: {error}. Consider upgrading the data connector to the latest version to fix this.\"\n    )]\n    InvalidNdcV01Version {\n        version: String,","sourceCodeStart":31,"sourceCodeEnd":67,"githubUrl":"https://github.com/hasura/graphql-engine/blob/724551b9ae87845594ef0408cff0e50eb6c90dc5/v3/crates/metadata-resolve/src/stages/data_connectors/error.rs#L31-L67","documentation":"Non-fatal issue wrapper for a named data connector: a DataConnectorIssue (config problem that may only be a warning depending on feature flags) is reported with the connector's qualified name.","triggerScenarios":"Resolving a connector that has a known issue, currently invalid NDC v0.1 versions, which is escalated to an error only under certain flags.","commonSituations":"Running with strict/compatibility flags that turn connector issues into errors.","solutions":["Read the inner issue detail","Address it (usually upgrade the connector)","Or relax the feature flag that escalates it to an error"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"Catch NamedDataConnectorIssue, consult ShouldBeAnError against your flags to decide warning vs failure, then handle the inner DataConnectorIssue.","preventionTips":["Decide upfront whether connector issues should fail builds in your flags","Monitor deprecation warnings for legacy connectors"],"tags":["data-connector","issue","wrapper","metadata"],"backgroundTag":"data-connector-misconfigured","analyzedSha":"724551b9ae87845594ef0408cff0e50eb6c90dc5","analyzedAt":"2026-08-28T07:32:55.105Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}