From e4110ad28a5eb7458ccd328a3f7fa34fcce75197 Mon Sep 17 00:00:00 2001 From: luoyuxia Date: Sun, 20 Sep 2026 15:34:35 +0800 Subject: [PATCH] [docs] Improve historical partition restart warning Place the restart requirement next to the configuration example and clarify that it applies when the option is enabled or disabled. Co-Authored-By: Codex AI-Model: gpt-5 (cherry picked from commit 8b61e8bc78f4c586bfb665344506697ed45e4570) AI-Contributed/Feature: 12/12 AI-Contributed/UT: 0/0 --- .../table-design/data-distribution/partitioning.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/website/docs/table-design/data-distribution/partitioning.md b/website/docs/table-design/data-distribution/partitioning.md index 3b591e2f8f..7a362b8d45 100644 --- a/website/docs/table-design/data-distribution/partitioning.md +++ b/website/docs/table-design/data-distribution/partitioning.md @@ -73,12 +73,6 @@ In this case, when automatic partitioning occurs (Fluss will periodically operat Before using historical partition access, make sure the [Paimon server-side setup](../../streaming-lakehouse/datalake-formats/paimon.md#historical-partition-access-setup) is completed. -:::warning -**After changing `table.datalake.historical-partition.enabled`, restart existing writer and lookup -jobs that need historical partition access so that their clients load the updated table -configuration.** -::: - Auto partitioning eventually removes partitions that fall outside the configured retention window. After an original Fluss partition is removed, late records cannot be written to it and primary-key lookups cannot find its rows in Fluss, even when the existing data has already been tiered to @@ -94,6 +88,12 @@ ALTER TABLE my_partitioned_table SET ( ); ``` +:::warning +After enabling or disabling `table.datalake.historical-partition.enabled`, restart any existing +writer and lookup jobs that require historical partition access so that their clients reload the +updated table configuration. +::: + When enabled, the Coordinator creates and retains an internal `__historical__` system partition: - **Writes:** Log tables and primary-key tables route records for expired partitions through the