Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: fix pull queries in https://docs/concepts/queries.md (#7597) #7598

Merged
merged 1 commit into from
May 26, 2021
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 2 additions & 23 deletions docs/concepts/queries.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,32 +68,11 @@ 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 Query](/developer-guide/ksqldb-reference/select-push-query/).
Pull queries are expressed using a strict subset of ANSI SQL.

Execute a pull query by sending an HTTP request to the ksqlDB REST API, and
the API responds with a single response.

### Pull query features and limitations
If you want to learn more about Pull Queries, see [Pull Queries](select-pull-query.md).

- Pull queries are expressed using a strict subset of ANSI SQL.
- You can execute pull queries on any derived table created by using the
CREATE TABLE AS SELECT statement.
- For non-windowed aggregations, pull queries only support looking up events
by key.
- WHERE clauses must have constraints that encompass all key column(s) for non-windowed tables.

- In addition, windowed tables support bounds on `WINDOWSTART` and `WINDOWEND` using operators
`<=`, `<`, `=`, `>`, `>=`.
- JOIN, PARTITION BY, GROUP BY and WINDOW clauses aren't supported.
- SELECT statements can contain column arithmetic and function calls.
- The result of a pull query isn't persisted anywhere.

### Example pull query

The following pull query gets all events for the specified user that have a
timestamp within the specified time window.

```sql
SELECT * FROM user_location
WHERE userId = 'user19r7t33'
AND '2019-10-02T21:31:16' <= WINDOWSTART AND WINDOWEND <= '2019-10-03T21:31:16';
```