{"record":{"id":"74dfcb9264d85f76","repo":"hasura/graphql-engine","slug":"the-orderable-relationship-relationship-name-d-74dfcb","errorCode":null,"errorMessage":"The orderable relationship '{relationship_name}' defined for '{orderable_type}' is not supported in ordering because the data connector '{data_connector_name}' does not support relationships","messagePattern":"The orderable relationship '(.+?)' defined for '(.+?)' is not supported in ordering because the data connector '(.+?)' does not support relationships","errorType":"validation","errorClass":"OrderableRelationshipError","httpStatus":null,"severity":"error","filePath":"v3/crates/metadata-resolve/src/stages/order_by_expressions/error.rs","lineNumber":82,"sourceCode":"        field_name: FieldName,\n    },\n    #[error(\"{0}\")]\n    GraphqlConfigError(#[from] graphql_config::GraphqlConfigError),\n    #[error(\"{message}\")]\n    UnsupportedFeature { message: String },\n}\n\n#[derive(Debug, thiserror::Error)]\n#[allow(clippy::enum_variant_names)]\npub enum OrderableRelationshipError {\n    #[error(\n        \"The orderable relationship '{relationship_name}' defined for '{orderable_type}' is a remote relationship and remote relationships are not supported in ordering\"\n    )]\n    RemoteRelationshipsNotSupported {\n        orderable_type: Qualified<CustomTypeName>,\n        relationship_name: RelationshipName,\n    },\n    #[error(\n        \"The orderable relationship '{relationship_name}' defined for '{orderable_type}' is not supported in ordering because the data connector '{data_connector_name}' does not support relationships\"\n    )]\n    RelationshipsNotSupported {\n        orderable_type: Qualified<CustomTypeName>,\n        relationship_name: RelationshipName,\n        data_connector_name: Qualified<open_dds::data_connector::DataConnectorName>,\n    },\n    #[error(\n        \"The orderable relationship '{relationship_name}' defined for '{orderable_type}' is not supported in ordering because the data connector '{data_connector_name}' does not support nested relationships in ordering\"\n    )]\n    NestedRelationshipsNotSupported {\n        orderable_type: Qualified<CustomTypeName>,\n        relationship_name: RelationshipName,\n        data_connector_name: Qualified<open_dds::data_connector::DataConnectorName>,\n    },\n}\n","sourceCodeStart":64,"sourceCodeEnd":99,"githubUrl":"https://github.com/hasura/graphql-engine/blob/724551b9ae87845594ef0408cff0e50eb6c90dc5/v3/crates/metadata-resolve/src/stages/order_by_expressions/error.rs#L64-L99","documentation":"Thrown when an orderable relationship points at a data connector whose capabilities do not include relationship support, so the relationship cannot be used in ORDER BY. The connector name is included in the message.","triggerScenarios":"Declaring an orderable relationship whose target type is backed by a data connector that does not advertise relationship support (missing/False relationship capabilities in the connector's capabilities response or config), during the order_by_expressions metadata stage.","commonSituations":"Using a custom/third-party NDC connector that has not implemented relationship capabilities; toggling off relationships in a connector's capabilities document; version mismatch between connector and metadata expectations.","solutions":["Check the capabilities of the data connector named in the error and confirm it declares relationship support","If you control the connector, enable/declare relationship capabilities in its capabilities response","Otherwise remove the relationship from the type's orderable relationships"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"const caps = await ndcConnector.capabilities();\nif (!caps.relationships) {\n  // skip adding orderable relationships for this connector\n}","typeGuard":"const supportsRelationships = (caps) => Boolean(caps?.relationships);","tryCatchPattern":null,"preventionTips":["Fetch and cache connector capabilities before authoring metadata","Remove orderable relationships when disabling relationship support on a connector"],"tags":["metadata","data-connector","capabilities","order-by","open-dds"],"backgroundTag":"data-connector-capability-missing","analyzedSha":"724551b9ae87845594ef0408cff0e50eb6c90dc5","analyzedAt":"2026-08-28T07:32:55.105Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}