{"record":{"id":"a90eb204db17528e","repo":"hasura/graphql-engine","slug":"unknown-data-connector-data-connector-reference","errorCode":null,"errorMessage":"unknown data connector {data_connector:} referenced in object boolean expression type {object_boolean_expression_type:}","messagePattern":"unknown data connector (.+?) referenced in object boolean expression type (.+?)","errorType":"validation","errorClass":"BooleanExpressionError::UnknownDataConnectorInObjectBooleanExpressionType","httpStatus":null,"severity":"error","filePath":"v3/crates/metadata-resolve/src/stages/boolean_expressions/error.rs","lineNumber":32,"sourceCode":"};\n\n#[derive(Debug, thiserror::Error)]\npub enum BooleanExpressionError {\n    #[error(\n        \"unknown type '{type_name}' used in object boolean expression '{boolean_expression_type_name}'\"\n    )]\n    UnknownTypeInObjectBooleanExpressionType {\n        boolean_expression_type_name: Qualified<CustomTypeName>,\n        type_name: Qualified<CustomTypeName>,\n    },\n    #[error(\n        \"unsupported type '{type_name}' used in object boolean expression. '{boolean_expression_type_name}'; only object types are supported\"\n    )]\n    UnsupportedTypeInObjectBooleanExpressionType {\n        boolean_expression_type_name: Qualified<CustomTypeName>,\n        type_name: Qualified<CustomTypeName>,\n    },\n    #[error(\n        \"unknown data connector {data_connector:} referenced in object boolean expression type {object_boolean_expression_type:}\"\n    )]\n    UnknownDataConnectorInObjectBooleanExpressionType {\n        data_connector: Qualified<DataConnectorName>,\n        object_boolean_expression_type: Qualified<CustomTypeName>,\n    },\n    #[error(\n        \"unknown data connector object type {data_connector_object_type:} (in data connector {data_connector:}) referenced in object boolean expression type {object_boolean_expression_type:}\"\n    )]\n    UnknownDataConnectorTypeInObjectBooleanExpressionType {\n        data_connector: Qualified<DataConnectorName>,\n        data_connector_object_type: DataConnectorObjectType,\n        object_boolean_expression_type: Qualified<CustomTypeName>,\n    },\n    #[error(\n        \"unknown field '{field_name:}' used in object boolean expression type {object_boolean_expression_type:}\"\n    )]\n    UnknownFieldInObjectBooleanExpressionType {","sourceCodeStart":14,"sourceCodeEnd":50,"githubUrl":"https://github.com/hasura/graphql-engine/blob/724551b9ae87845594ef0408cff0e50eb6c90dc5/v3/crates/metadata-resolve/src/stages/boolean_expressions/error.rs#L14-L50","documentation":"An object boolean expression type's backing object type is mapped to a data connector object type for a specific data connector; this error occurs when that data connector (Qualified<DataConnectorName><subtype, name>) is not registered in the resolved metadata. The resolver looks up connectors by qualified name during boolean expression resolution and fails on a miss.","triggerScenarios":"The object type backing the boolean expression has a data connector mapping referencing a connector that was never declared, was renamed, or lives in a different subtype; or the data connector definition file failed to load in an earlier stage.","commonSituations":"Renaming a data connector without updating type mappings, missing data connector YAML in the build, wrong subtype qualification (e.g. default vs custom prefix), or moving connectors between projects.","solutions":["Check the data connector name/subtype in the error and fix the reference in the object type's data connector mappings","Ensure the data connector is actually declared in the included metadata (not missing or misspelled)","Align subtypes between the connector definition and its usages","Rebuild metadata"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"// Verify every data connector referenced by type mappings is declared\nfor (dc, _) in object_type.data_connector_mappings() {\n    if !declared_connectors.contains(&dc.to_qualified_string()) {\n        return Err(format!(\"undeclared data connector {dc}\"));\n    }\n}","typeGuard":null,"tryCatchPattern":"match resolve(metadata) {\n    Err(BooleanExpressionError::UnknownDataConnectorInObjectBooleanExpressionType { data_connector, .. }) => {\n        // fix or declare the connector, then rebuild\n    }\n    other => other,\n}","preventionTips":["Single source of truth for connector names; avoid hand-typing qualified connector references","When renaming a data connector, grep all type mappings for the old name"],"tags":["hasura","ddn","metadata","boolean-expressions","data-connector","rust"],"backgroundTag":"data-connector-not-found","analyzedSha":"724551b9ae87845594ef0408cff0e50eb6c90dc5","analyzedAt":"2026-08-28T07:32:55.105Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}