add doc for group_commit_mode table property#3465
Open
mymeiyi wants to merge 1 commit intoapache:masterfrom
Open
add doc for group_commit_mode table property#3465mymeiyi wants to merge 1 commit intoapache:masterfrom
mymeiyi wants to merge 1 commit intoapache:masterfrom
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the Group Commit manual documentation (English + Chinese, current + v4.x) to explain the new group_commit_mode table property and how it interacts with existing Stream Load / INSERT INTO configuration.
Changes:
- Add a new “Table Property Configuration / 表属性配置” section describing
group_commit_mode, including create/alter/view examples and precedence rules. - Clarify precedence in the
INSERT INTO VALUESsection (session variable vs table property). - Clarify Stream Load behavior when the
group_commitheader is omitted and a table property is set.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 6 comments.
| File | Description |
|---|---|
docs/data-operate/import/group-commit-manual.md |
Adds English current docs for group_commit_mode table property and precedence notes. |
versioned_docs/version-4.x/data-operate/import/group-commit-manual.md |
Adds the same English content for v4.x versioned docs. |
i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/group-commit-manual.md |
Adds Chinese current docs for group_commit_mode table property and precedence notes. |
i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/data-operate/import/group-commit-manual.md |
Adds the same Chinese content for v4.x versioned docs. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
You can also share your feedback on Copilot code review. Take the survey.
versioned_docs/version-4.x/data-operate/import/group-commit-manual.md
Outdated
Show resolved
Hide resolved
i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/group-commit-manual.md
Show resolved
Hide resolved
.../zh-CN/docusaurus-plugin-content-docs/version-4.x/data-operate/import/group-commit-manual.md
Show resolved
Hide resolved
mymeiyi
force-pushed
the
add-group-commit-doc
branch
from
d6998b9 to
9d54c68
Compare
16 tasks
dataroaring
pushed a commit
to apache/doris
that referenced
this pull request
Mar 16, 2026
### What problem does this PR solve?
Issue Number: close #xxx
Related PR: #xxx
Problem Summary:
1. Create table support set `group_commit_mode` table property
```
CREATE TABLE ... PROPERTIES(
"group_commit_mode" = "async_mode"
);
```
2. Support alter this property
```
ALTER TABLE ... SET ("group_commit_mode" = "off_mode");
```
3. Show create table shows this property if its value is not `off_mode`
4. For stream load, if it not set `group_commit` header, use the table
property as the group commit mode; if it set `group_commit` header, use
the header value.
5. doc: apache/doris-website#3465
### Release note
None
### Check List (For Author)
- Test <!-- At least one of them must be included. -->
- [ ] Regression test
- [ ] Unit Test
- [ ] Manual test (add detailed scripts or steps below)
- [ ] No need to test or manual test. Explain why:
- [ ] This is a refactor/code format and no logic has been changed.
- [ ] Previous test can cover this change.
- [ ] No code files have been changed.
- [ ] Other reason <!-- Add your reason? -->
- Behavior changed:
- [ ] No.
- [ ] Yes. <!-- Explain the behavior change -->
- Does this need documentation?
- [ ] No.
- [ ] Yes. <!-- Add document PR link here. eg:
apache/doris-website#1214 -->
### Check List (For Reviewer who merge this PR)
- [ ] Confirm the release note
- [ ] Confirm test cases
- [ ] Confirm document
- [ ] Add branch pick label <!-- Add branch pick label that this PR
should merge into -->
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
add doc for pr: apache/doris#61242
Versions
Languages
Docs Checklist