prestodb/presto · error · ParseError

{parse_error} ConnectorDistributedProcedureHandle Connector

Error message

{parse_error} ConnectorDistributedProcedureHandle  ConnectorDistributedProcedureHandle

What it means

Velox protocol deserialization error: the JSON for a ConnectorDistributedProcedureHandle could not be parsed — getSubclassKey failed with a parse error. Raised while translating a distributed-procedure (e.g. compaction) plan into the native engine; signals malformed payload or protocol version mismatch.

Source

Thrown at presto-native-execution/presto_cpp/presto_protocol/core/presto_protocol_core.cpp:4044

namespace facebook::presto::protocol {
void to_json(
    json& j,
    const std::shared_ptr<ConnectorDistributedProcedureHandle>& p) {
  if (p == nullptr) {
    return;
  }
  String type = p->_type;
  getConnectorProtocol(type).to_json(j, p);
}

void from_json(
    const json& j,
    std::shared_ptr<ConnectorDistributedProcedureHandle>& p) {
  String type;
  try {
    type = p->getSubclassKey(j);
  } catch (json::parse_error& e) {
    throw ParseError(
        std::string(e.what()) +
        " ConnectorDistributedProcedureHandle  ConnectorDistributedProcedureHandle");
  }

  if (j.contains("customSerializedValue")) {
    VELOX_CHECK(
        !type.empty() && type[0] != '$',
        "Internal handle type '{}' should not have customSerializedValue",
        type);
    std::string binaryData = velox::encoding::Base64::decode(
        j["customSerializedValue"].get<std::string>());
    getConnectorProtocol(type).deserialize(binaryData, p);
    return;
  }

  getConnectorProtocol(type).from_json(j, p);
}
} // namespace facebook::presto::protocol

View on GitHub (pinned to 55bb57d202)

Solutions

1. Keep Java and Velox protocol jars/binaries in sync
2. Verify the connector's distributed-procedure handle serialization includes its type key
3. Inspect the plan JSON for corruption

When it happens

Trigger: Thrown at presto-native-execution/presto_cpp/presto_protocol/core/presto_protocol_core.cpp:4044 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of prestodb/presto@55bb57d202 (2026-09-04). Data as JSON: /api/errors/4a02ab76e704e0db. Report an issue: GitHub.