{"record":{"id":"a6464ed91f9c1fd7","repo":"influxdata/influxdb","slug":"node-node-id-cannot-clear-its-connection-address-conn-info-e","errorCode":null,"errorMessage":"node '{node_id}' cannot clear its connection address (conn info e.g. 8181) while it is a member of query group '{query_group_name}' (id {query_group_id})","messagePattern":"node '(.+?)' cannot clear its connection address \\(conn info e\\.g\\. 8181\\) while it is a member of query group '(.+?)' \\(id (.+?)\\)","errorType":"error_code","errorClass":"CatalogError","httpStatus":null,"severity":"error","filePath":"influxdb3_catalog/src/error.rs","lineNumber":394,"sourceCode":"        query_group_name: Arc<str>,\n        query_group_id: QueryGroupId,\n    },\n\n    #[error(\n        \"cannot place node '{node_id}' in this query group because it already belongs to query group '{query_group_name}' (id {query_group_id})\"\n    )]\n    NodeAlreadyInQueryGroup {\n        node_id: Arc<str>,\n        query_group_name: Arc<str>,\n        query_group_id: QueryGroupId,\n    },\n\n    #[error(\n        \"node '{node_id}' advertises no connection address (conn info e.g. 8181), so other query group members cannot reach it\"\n    )]\n    QueryGroupMemberNotConnectable { node_id: Arc<str> },\n\n    #[error(\n        \"node '{node_id}' cannot clear its connection address (conn info e.g. 8181) while it is a member of query group '{query_group_name}' (id {query_group_id})\"\n    )]\n    NodeConnInfoRequiredInQueryGroup {\n        node_id: Arc<str>,\n        query_group_name: Arc<str>,\n        query_group_id: QueryGroupId,\n    },\n}\n\nimpl CatalogError {\n    pub fn invalid_configuration(message: impl AsRef<str>) -> Self {\n        Self::InvalidConfiguration {\n            message: Box::from(message.as_ref()),\n        }\n    }\n\n    pub fn unexpected(message: impl Into<String>) -> Self {\n        Self::Other(anyhow!(message.into()))","sourceCodeStart":376,"sourceCodeEnd":412,"githubUrl":"https://github.com/influxdata/influxdb/blob/06200ef96ba82c5f6727e5038a83af8e722c6875/influxdb3_catalog/src/error.rs#L376-L412","documentation":"This error is raised when a node attempts to clear/remove its advertised connection address (conn info such as port 8181) while it is still a member of a query group. Because query group peers rely on that address to reach the node, the catalog forbids clearing it until the node leaves the group.","triggerScenarios":"Calling the catalog API to clear a node's connection info while the node's id is present in a query group's member list (query_group_name/query_group_id in the error).","commonSituations":"Operators resetting node connection settings during reconfiguration without draining the node from its query group; automation that wipes conn info as part of re-provisioning.","solutions":["Remove the node from its query group first, then clear the connection address","Update the connection address to a new value instead of clearing it","If the group is being decommissioned, dissolve the query group, then clear conn info"],"exampleFix":"// before\ncatalog.clear_node_conn_info(node_id)?; // fails: node in query group\n// after\ncatalog.remove_node_from_query_group(query_group_id, node_id)?;\ncatalog.clear_node_conn_info(node_id)?;","handlingStrategy":"try-catch","validationCode":"if catalog.query_group_for_node(node_id).is_some() {\n    // leave the group before clearing conn info\n}","typeGuard":null,"tryCatchPattern":"match catalog.clear_node_conn_info(node_id) {\n    Err(CatalogError::NodeConnInfoRequiredInQueryGroup { query_group_id, .. }) => {\n        catalog.remove_node_from_query_group(query_group_id, node_id)?;\n        catalog.clear_node_conn_info(node_id)?;\n    }\n    r => r?,\n}","preventionTips":["Drain query-group membership before reconfiguring node addresses","Update conn info in place rather than clearing it when possible","Document conn-info dependencies in cluster reconfiguration runbooks"],"tags":["catalog","query-group","network","state-conflict"],"backgroundTag":"invalid-state-transition","analyzedSha":"06200ef96ba82c5f6727e5038a83af8e722c6875","analyzedAt":"2026-09-19T12:55:30.003Z","contentChangedAt":"2026-09-19T12:55:30.003Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}