Skip to content

Commit

Permalink
docs: add master branch changes to select ref topics (DOCS-5631) (#6431)
Browse files Browse the repository at this point in the history
  • Loading branch information
JimGalasyn authored Oct 13, 2020
1 parent 7ad25bd commit 56f9712
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 1 deletion.
2 changes: 1 addition & 1 deletion docs/developer-guide/ksqldb-reference/select-pull-query.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ 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.
optionally include bounds on `WINDOWSTART` and `WINDOWEND` if the materialized table is windowed.
For more information, see
[Time and Windows in ksqlDB](../../concepts/time-and-windows-in-ksqldb-queries.md).

Expand Down
18 changes: 18 additions & 0 deletions docs/developer-guide/ksqldb-reference/select-push-query.md
Original file line number Diff line number Diff line change
Expand Up @@ -198,3 +198,21 @@ SELECT orderzip_code, TOPK(order_total, 5) FROM orders
GROUP BY order_zipcode
EMIT CHANGES;
```

#### EMIT

The EMIT clause lets you control the output refinement of your push query. The output refinement is
how you would like to *emit* your results.

ksqlDB supports the following output refinement types.

#### CHANGES

This is the standard output refinement for push queries, for when we would like to see all changes
happening.

#### FINAL

This is for when we want to emit only the final result of a windowed aggregation, and suppress the
intermediate results until the window closes. Note that this output refinement is supported only
for windowed aggregations.

0 comments on commit 56f9712

Please sign in to comment.