KIP-1356 — Introduce IQv2 for headers-aware state stores
Accepted Kafka 4.4 Streams
Introduces IQv2 query types returning a new read-only ReadOnlyRecord interface exposing key, value, timestamp, and headers, and makes the pre-existing key, range, and window query types behave consistently against header-aware state stores regardless of how the store was built. KIP-1271 lets stores persist record headers but exposes no way to read them back: existing queries silently drop headers on adapter-built stores and fail with UNKNOWN_QUERY_TYPE on natively-built ones.
Details
| Author | Jess Jin |
| Status | Accepted |
| Kafka Version | 4.4 |
| JIRA | KAFKA-20682 |
| Wiki | View on Apache Wiki |
| Created | 2026-06-09 |
| Last Modified | 2026-06-26 |
Explore how this KIP affects the Kafka protocol in the Protocol Explorer, or see the full KIP database.