Get Started Today: StarTree Free Tier
Segment Threshold

Segment Threshold

The segment threshold determines when a segment is committed in real-time tables.

When data is first ingested from a streaming provider like Kafka, it gets stored in a consuming segment. The data in the consuming segment is stored on the disk of the server(s) that are processing a particular partition from the streaming provider.

However, it's not until a segment is committed that the segment is written to the deep store (opens in a new tab). The segment threshold decides when that should happen.


If you want to learn how to configure the segment threshold, see the configuring segment threshold guide.

Why should we care about it?

We care about the segment threshold because we want to make sure that our segments are a reasonable size.

  • Queries are processed at the segment level, so if segments are too small it may result in higher query latencies as there is increased overhead when processing queries (in terms of number of threads spawned, meta data processing, etc).

  • If they're too big, this may result in servers running out of memory. If a server is restarted the consuming segment will need to start consuming from the first row again, which will cause lag between Pinot and the streaming provider.

Mark Needham explains the segment threshold