Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update tidb_dml_batch_size section #7371

Merged
merged 6 commits into from Apr 14, 2022

Conversation

leowangpingcap
Copy link
Contributor

tidb_dml_batch_size is only effective when another variable is turned on 'tidb_batch_insert',
however it is not documented causing some confusion for customer

What is changed, added or deleted? (Required)

added

'tidb_batch_insert' parameter is required to turn on in order for 'tidb_dml_batch_size' to work, but information is currently missing in the doc

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

  • master (the latest development version)
  • v5.4 (TiDB 5.4 versions)
  • v5.3 (TiDB 5.3 versions)
  • v5.2 (TiDB 5.2 versions)
  • v5.1 (TiDB 5.1 versions)
  • v5.0 (TiDB 5.0 versions)
  • v4.0 (TiDB 4.0 versions)
  • v3.1 (TiDB 3.1 versions)
  • v3.0 (TiDB 3.0 versions)
  • v2.1 (TiDB 2.1 versions)

What is the related PR or file link(s)?

No reference link, internal TSE suggestion

  • This PR is translated from:
  • Other reference link(s):

Do your changes match any of the following descriptions?

  • Delete files
  • Change aliases
  • Need modification after applied to another branch
  • Might cause conflicts after applied to another branch

tidb_dml_batch_size is only effective when another variable is turned on 'tidb_batch_insert', 
however it is not documented causing some confusion for customer
@ti-chi-bot
Copy link
Member

ti-chi-bot commented Jan 7, 2022

[REVIEW NOTIFICATION]

This pull request has been approved by:

  • TomShawn
  • dveeden

To complete the pull request process, please ask the reviewers in the list to review by filling /cc @reviewer in the comment.
After your PR has acquired the required number of LGTMs, you can assign this pull request to the committer in the list by filling /assign @committer in the comment to help you merge this pull request.

The full list of commands accepted by this bot can be found here.

Reviewer can indicate their review by submitting an approval review.
Reviewer can cancel approval by submitting a request changes review.

@ti-chi-bot ti-chi-bot added missing-translation-status This PR does not have translation status info. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Jan 7, 2022
@morgo morgo self-requested a review January 7, 2022 17:21
@morgo
Copy link
Contributor

morgo commented Jan 7, 2022

Can you also add:

### tidb_batch_insert
- Scope: SESSION
- Default value: `OFF`
- This variable permits `tidb_dml_batch_size` to be used in `INSERT` statements.
- Only the value `OFF` provides ACID compliance. Setting this to any other value will break the atomicity and isolation guarantees of TiDB, as an indivudual `INSERT` statements will be split into smaller transactions.

system-variables.md Outdated Show resolved Hide resolved
leowangpingcap and others added 3 commits January 7, 2022 12:43
commit new change according to morgan's suggestion

Co-authored-by: Morgan Tocker <tocker@gmail.com>
@morgo morgo self-requested a review January 7, 2022 19:30
system-variables.md Outdated Show resolved Hide resolved
@TomShawn TomShawn self-assigned this Jan 10, 2022
@TomShawn TomShawn added area/sql-infra Indicates that the Issue or PR belongs to the area of sql-infra and sql-metadata. translation/doing This PR's assignee is translating this PR. type/enhancement This issue/PR improves documentation usability or supplements document content. needs-cherry-pick-release-5.3 Should cherry pick this PR to release-5.3 branch. and removed missing-translation-status This PR does not have translation status info. labels Jan 10, 2022
@ti-chi-bot ti-chi-bot added the status/LGT1 Indicates that a PR has LGTM 1. label Jan 10, 2022
@TomShawn TomShawn added the needs-cherry-pick-release-5.4 Should cherry pick this PR to release-5.4 branch. label Feb 11, 2022
Co-authored-by: TomShawn <41534398+TomShawn@users.noreply.github.com>
system-variables.md Outdated Show resolved Hide resolved
Copy link
Contributor

@TomShawn TomShawn left a comment

Choose a reason for hiding this comment

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

LGTM

@ti-chi-bot ti-chi-bot added status/LGT2 Indicates that a PR has LGTM 2. and removed status/LGT1 Indicates that a PR has LGTM 1. labels Mar 9, 2022
@TomShawn
Copy link
Contributor

TomShawn commented Mar 9, 2022

@morgo PTAL. Thanks~

@TomShawn
Copy link
Contributor

/merge

@ti-chi-bot
Copy link
Member

This pull request has been accepted and is ready to merge.

Commit hash: 03f5bf0

@ti-chi-bot ti-chi-bot added the status/can-merge Indicates a PR has been approved by a committer. label Apr 14, 2022
@ti-chi-bot ti-chi-bot merged commit 96ad458 into master Apr 14, 2022
@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created: #8220.

@TomShawn TomShawn deleted the leowangpingcap-patch-tidb_dml_batch_size branch April 14, 2022 03:47
@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created: #8221.

@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created: #8223.

TomShawn added a commit that referenced this pull request Apr 14, 2022
* Update tidb_dml_batch_size section

tidb_dml_batch_size is only effective when another variable is turned on 'tidb_batch_insert',
however it is not documented causing some confusion for customer

* Update system-variables.md

commit new change according to morgan's suggestion

Co-authored-by: Morgan Tocker <tocker@gmail.com>

* Update system-variables.md

* Update system-variables.md

* Update system-variables.md

Co-authored-by: TomShawn <41534398+TomShawn@users.noreply.github.com>

* Update system-variables.md

Co-authored-by: leowangpingcap <89871841+leowangpingcap@users.noreply.github.com>
Co-authored-by: Morgan Tocker <tocker@gmail.com>
Co-authored-by: TomShawn <41534398+TomShawn@users.noreply.github.com>
@TomShawn TomShawn added translation/done This PR has been translated from English into Chinese and updated to pingcap/docs-cn in a PR. and removed translation/doing This PR's assignee is translating this PR. labels May 10, 2022
@TomShawn TomShawn mentioned this pull request May 10, 2022
13 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/sql-infra Indicates that the Issue or PR belongs to the area of sql-infra and sql-metadata. needs-cherry-pick-release-5.3 Should cherry pick this PR to release-5.3 branch. needs-cherry-pick-release-5.4 Should cherry pick this PR to release-5.4 branch. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. status/can-merge Indicates a PR has been approved by a committer. status/LGT2 Indicates that a PR has LGTM 2. translation/done This PR has been translated from English into Chinese and updated to pingcap/docs-cn in a PR. type/enhancement This issue/PR improves documentation usability or supplements document content.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants