Broker gRPC API

Pinot broker gRPC query reference.

Pinot's broker gRPC API is the transport alternative to HTTP query submission. It is primarily useful when client libraries want lower overhead, Arrow encoding, or connection-level compression controls.

Enablement

pinot.broker.grpc.port=8010
pinot.broker.grpc.tls.enabled=true
pinot.broker.grpc.tls.port=8020

Client Options

Option	Default	Notes
blockRowSize	10000	Rows per response block
compression	ZSTD	Wire compression choice
encoding	JSON	Result transport encoding; ARROW is also supported

Client Examples

The gRPC Java and JDBC clients use the pinotgrpc scheme.

GrpcConnection grpcConnection = ConnectionFactory.fromControllerGrpc(properties, "localhost:9000");
ResultSetGroup resultSetGroup = grpcConnection.execute("SELECT * FROM airlineStats limit 1000");

try (Connection connection = DriverManager.getConnection("jdbc:pinotgrpc://localhost:9000?blockRowSize=10000&encoding=JSON&compression=ZSTD")) {
  // execute queries
}

Operational Notes

• Use the same --add-opens JVM flag when running Arrow-based clients.

• Connection establishment performs a lightweight validation query.

• Request headers can be attached with the headers. prefix.

What this page covered

• How to enable broker gRPC.

• The client-side options that matter most.

• The connection and encoding behavior that client authors need to know.

Next step

Use the Java or JDBC client docs when you need integration code, then validate the query path against the broker endpoint you plan to expose.

Related pages

• API Reference

• Query API

• Controller API