THPDFSpillStatistics Record
Reports logical and physical sizes, block compression mix, and async writer behavior of a compressed spill stream
Declaration
THPDFSpillStatistics= record
LogicalBytes: Int64;
PhysicalBytes: Int64;
BlockCount: Integer;
CompressedBlockCount: Integer;
RawBlockCount: Integer;
AsyncWriteBatchCount: Int64;
AsyncWriteBlockCount: Int64;
ProducerWaitCount: Int64;
PeakQueuedBytes: Int64;
end;Unit
HPDFObjs
Fields
| Field | Purpose |
|---|---|
LogicalBytes | Uncompressed data size the stream presents to readers |
PhysicalBytes | Current size of the backing spill file on disk |
BlockCount | Total number of blocks tracked in the block offset table |
CompressedBlockCount | Blocks stored compressed |
RawBlockCount | Blocks stored as-is because compression did not pay off |
AsyncWriteBatchCount | Write batches handed to the background writer thread |
AsyncWriteBlockCount | Blocks actually written by the background writer |
ProducerWaitCount | Times the producing thread had to wait because the write queue was full |
PeakQueuedBytes | High-water mark of bytes queued for asynchronous writing |
Usage notes
- Returned by
THPDFCompressedSpillStream.GetStatisticsafter pending writes are flushed, and byTHPDFLazyFileStream.GetSpillStatisticsfor streams materialized to disk - The loaded stream cache report aggregates these values into the spill fields of
THPDFLoadedStreamCacheInfo ProducerWaitCountandPeakQueuedBytesexpose backpressure of the asynchronous writer under memory pressure