SELECT (Pull Query)¶
1 2 3 4
Pulls the current value from the materialized table and terminates. The result of this statement isn't persisted in a Kafka topic and is printed out only in the console.
Pull queries enable you to fetch the current state of a materialized view. Because materialized views are incrementally updated as new events arrive, pull queries run with predictably low latency. They're a great match for request/response flows. For asynchronous application flows, see Push Queries.
Execute a pull query by sending an HTTP request to the ksqlDB REST API, and the API responds with a single response.
The WHERE clause must contain a single primary-key to retrieve and may optionally include bounds on WINDOWSTART if the materialized table is windowed.
1 2 3
When writing logical expressions using
WINDOWSTART, you can use ISO-8601
formatted datestrings to represent date times. For example, the previous
query is equivalent to the following:
1 2 3
You can specify time zones within the datestring. For example,
2017-11-17T04:53:45-0330 is in the Newfoundland time zone. If no time zone is
specified within the datestring, then timestamps are interpreted in the UTC
If no bounds are placed on
WINDOWSTART, rows are returned for all windows
in the windowed table.