From dcb5316306663d2e8781daa0c7af4fa4bae781fd Mon Sep 17 00:00:00 2001 From: Jim Galasyn Date: Thu, 12 May 2022 13:31:40 -0700 Subject: [PATCH] docs: update grace period description in join topic (DOCS-13438) (#9113) --- .../joins/join-streams-and-tables.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/docs/developer-guide/joins/join-streams-and-tables.md b/docs/developer-guide/joins/join-streams-and-tables.md index 85cf7036998a..cc1dae11a26e 100644 --- a/docs/developer-guide/joins/join-streams-and-tables.md +++ b/docs/developer-guide/joins/join-streams-and-tables.md @@ -67,12 +67,16 @@ the order was placed, and shipped within 2 hours of the payment being received. Joins and Windows ----------------- -ksqlDB enables grouping records that have the same key for stateful -operations, like joins, into *windows*. At the moment, ksqlDB uses a fixed grace period of 24 hours, -which means that a record can arrive out-of-order for up to 24 hours, and it's still joined correctly -based on its timestamp. -If a record arrives after the window's grace period has passed, the record is discarded and -isn't processed. +ksqlDB enables grouping records that have the same key for stateful operations, +like joins, into *windows*. A window has a _grace period_, which means that a +record can arrive out-of-order for a specified period of time, and it's still +joined correctly based on its timestamp. + +If a record arrives after the window's grace period has passed, the record is +discarded and isn't processed. + +For more information on grace periods, see +[Out-of-order events](../../concepts/time-and-windows-in-ksqldb-queries.md#out-of-order-events). !!! note Only stream-stream joins are windowed.