Skip to content

docs: add SET BACKFILL_PARALLELISM clause to ALTER command documentation#1022

Draft
Copilot wants to merge 2 commits intomainfrom
copilot/update-documentation-for-backfill
Draft

docs: add SET BACKFILL_PARALLELISM clause to ALTER command documentation#1022
Copilot wants to merge 2 commits intomainfrom
copilot/update-documentation-for-backfill

Conversation

Copy link
Contributor

Copilot AI commented Feb 24, 2026

Documents the new SET BACKFILL_PARALLELISM clause added in risingwavelabs/risingwave#24323, which allows independent tuning of parallelism during the backfill phase of streaming jobs.

Description

Added SET BACKFILL_PARALLELISM sections to all relevant ALTER command pages, following the same pattern as existing SET BACKFILL_RATE_LIMIT and SET PARALLELISM sections:

  • sql-alter-table.mdx — includes a note that Iceberg engine tables are not supported
  • sql-alter-materialized-view.mdx
  • sql-alter-index.mdx
  • sql-alter-sink.mdx
  • sql-alter-source.mdx

Each section covers syntax, parameter semantics (ADAPTIVE/0 or fixed integer), and SQL examples:

-- Fix backfill to 4 parallel workers
ALTER MATERIALIZED VIEW mv1 SET BACKFILL_PARALLELISM = 4;

-- Use all available units during backfill
ALTER TABLE t1 SET BACKFILL_PARALLELISM = ADAPTIVE;

Related code PR

risingwavelabs/risingwave#24323

Related doc issue

https://github.com/risingwavelabs/risingwave-docs/issues/

Checklist

  • I have run the documentation build locally to verify the updates are applied correctly.
  • For new pages, I have updated mint.json to include the page in the table of contents.
  • All links and references have been checked and are not broken.
Original prompt

This section details on the original issue you should resolve

<issue_title>Document: feat: add support to alter backfill parallelism for streaming jobs</issue_title>
<issue_description>This issue tracks the documentation update needed for the merged PR risingwavelabs/risingwave-docs#24323.

Source PR URL: risingwavelabs/risingwave#24323
Source PR Merged At: 2026-02-24T08:37:08Z

If it is a major improvement that deserves a new page or a new section in the documentation, please check if we should label it as an experiment feature.</issue_description>

Comments on the Issue (you are @copilot in this section)


🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

Co-authored-by: kwannoel <47273164+kwannoel@users.noreply.github.com>
Copilot AI changed the title [WIP] Update documentation to support altering backfill parallelism docs: add SET BACKFILL_PARALLELISM clause to ALTER command documentation Feb 24, 2026
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.

Document: feat: add support to alter backfill parallelism for streaming jobs

2 participants