Skip to content

docs: add manual compaction time range - #2666

Open
v0y4g3r wants to merge 2 commits into
mainfrom
docs/manual-compaction-time-range
Open

docs: add manual compaction time range#2666
v0y4g3r wants to merge 2 commits into
mainfrom
docs/manual-compaction-time-range

Conversation

@v0y4g3r

@v0y4g3r v0y4g3r commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

What's changed

  • Document the start_time and end_time options for ranged manual compaction.
  • Explain the half-open range, timestamp time zone handling, and regular TWCS trigger behavior.
  • Document the SWCS dependency-window expansion required to retain data from cross-window SST files.
  • Add regular and SWCS examples to the ADMIN SQL reference.
  • Update both English and Chinese nightly documentation.

Related

Verification

  • pnpm exec eslint docs/reference/sql/admin.md docs/user-guide/deployments-administration/manage-data/compaction.md i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/admin.md i18n/zh/docusaurus-plugin-content-docs/current/user-guide/deployments-administration/manage-data/compaction.md
  • pnpm test
  • pnpm build
  • git diff --check

Signed-off-by: Lei, HUANG <ratuthomm@gmail.com>
@v0y4g3r
v0y4g3r requested a review from fengjiachun as a code owner July 29, 2026 15:04
Copilot AI review requested due to automatic review settings July 29, 2026 15:04
@v0y4g3r
v0y4g3r requested a review from killme2008 as a code owner July 29, 2026 15:04

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the GreptimeDB documentation to describe the newly supported start_time/end_time options for manual compaction, including range semantics and strategy-specific behavior, and mirrors the content in both English and Chinese nightly docs.

Changes:

  • Document start_time/end_time for limiting manual compaction to a half-open time range ([start_time, end_time)), including time zone handling.
  • Clarify regular (TWCS-triggered) vs SWCS (forced) behavior when a time range is specified, including SWCS dependency-window expansion.
  • Add corresponding examples to the ADMIN SQL reference in both English and Chinese docs.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
docs/user-guide/deployments-administration/manage-data/compaction.md Adds an English section explaining time-ranged manual compaction behavior for regular and SWCS.
docs/reference/sql/admin.md Adds English ADMIN SQL examples showing time-ranged regular and SWCS compaction invocations.
i18n/zh/docusaurus-plugin-content-docs/current/user-guide/deployments-administration/manage-data/compaction.md Adds the Chinese equivalent section describing time range rules/behavior and examples.
i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/admin.md Adds Chinese ADMIN SQL examples for time-ranged regular and SWCS compaction.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/user-guide/deployments-administration/manage-data/compaction.md Outdated
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 29, 2026

Copy link
Copy Markdown

Deploying greptime-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 5d42d6f
Status: ✅  Deploy successful!
Preview URL: https://f630cbf7.greptime-docs.pages.dev
Branch Preview URL: https://docs-manual-compaction-time.greptime-docs.pages.dev

View logs

Signed-off-by: Lei, HUANG <ratuthomm@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update docs for feat: support time range in manual compaction

2 participants