aliehsaeedii commented on code in PR #21367: URL: https://github.com/apache/kafka/pull/21367#discussion_r2745761768
########## docs/streams/developer-guide/interactive-queries.md: ########## @@ -486,9 +486,106 @@ At this point the full state of the application is interactively queryable: * Collectively, this allows us to query the full state of the entire application. +## Interactive Queries APIs +Kafka Streams currently provides two APIs for querying state: + +- **Interactive Queries v2 (IQv2)** – the newer, query-based API +- **Interactive Queries v1 (IQv1)** – the original, store-access-based API + +This documentation introduces **Interactive Queries v2** as the **new API**, while retaining IQv1 for backward compatibility. + + +**Interactive Queries v2 (IQv2)** introduces a **query-based API** for accessing Kafka Streams application state. +Instead of directly interacting with state store objects, applications **define structured queries** that are executed by Kafka Streams. + +IQv2 improves API safety, extensibility, and error handling by: + +- Decoupling query definition from store internals +- Returning structured query results instead of throwing exceptions Review Comment: Could we add `returns metadata (aprtitions) beside query results?` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
