Skip to content

i18n(ja): unify partition-type and pruning-mode naming - #23810

Open
yahonda wants to merge 12 commits into
pingcap:i18n-ja-release-8.5from
yahonda:fix-partition-type-notation
Open

i18n(ja): unify partition-type and pruning-mode naming#23810
yahonda wants to merge 12 commits into
pingcap:i18n-ja-release-8.5from
yahonda:fix-partition-type-notation

Conversation

@yahonda

@yahonda yahonda commented Sep 10, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

A stacked sweep on "partitioning type" and related notation issues found while auditing partitioned-table.md against EN:

  1. Range -> レンジ (katakana): matches Hash/Key/List, none of which have a competing kanji form (previously 範囲/レンジ split, 51 vs 5). 84+ sites across 26+ files verified against release-8.5. releases/release-4.0.9.md's unrelated "range split" (TiDB Lightning ingestion) correctly excluded.

  2. List -> リスト (translate the untranslated English name): "List"/"List COLUMNS" left as literal English in ~20 sites/8 files despite リスト being dominant elsewhere.

  3. 分割 -> パーティショニング (unify the "partitioning" suffix): パーティショニング was already dominant (57 vs 16); unified, excluding the verb-participle "X分割された" construction (e.g. global-indexes.md's "range partitioned by PK" table labels), which is a different, correct grammatical use of 分割.

  4. COLUMNS kept in English for "Range/List COLUMNS partitioning" (reversing an initial translate-to-列 pass): Japanese has no grammatical number, so 列 loses the "supports multiple columns" nuance COLUMNS conveys in EN. Keeping COLUMNS in English preserves that distinction, matching INTERVAL (also kept in English) as a qualifier on the base Range/Hash/Key/List name.

  5. 動的/静的剪定 -> 動的/静的プルーニング: unify to the already-dominant katakana form (43 vs 12), matching partitioned-table.md's own heading. Confirmed a same-paragraph self-contradiction in statistics.md.

  6. Assorted defects found during review: a stray "ショニング" MT-scramble fragment in partitioned-table.md's intro; a scrambled/reordered "User documents" line in releases/release-6.1.0.md; two word-order-scrambled benchmark table rows in global-indexes.md ("PK de partition-ized clustered-table range" instead of "clustered table range-partitioned by PK"); a dropped は particle after `NULL` in partitioned-table.md; missing spaces around INTERVAL in two release notes.

パーティションプルーニング (partition pruning) itself was checked and found fully consistent (109/109 sites) -- not part of this PR. パーティション化 (the verb/participle "partitioned") was checked and confirmed to be a different grammatical category from パーティショニング (the noun), not 表記揺れ -- also not touched.

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

  • i18n-ja-release-8.5 (TiDB Japanese documentation for TiDB 8.5 versions)

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

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

AI agent involvement

  • The changes in this PR were primarily made by an AI agent on behalf of the PR author.

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

Summary by CodeRabbit

  • Documentation
    • Standardized Japanese terminology across partitioning, partition pruning, statistics, and related documentation.
    • Unified terms such as 「レンジ」, 「リスト」, 「リストCOLUMNS」, 「プルーニング」, and 「キーパーティショニング」.
    • Updated corresponding release notes, headings, examples, compatibility descriptions, and system-variable references.
    • Preserved existing technical content, feature behavior, support information, links, anchor IDs, and measured values.

@ti-chi-bot ti-chi-bot Bot added the missing-translation-status This PR does not have translation status info. label Sep 10, 2026
@ti-chi-bot

ti-chi-bot Bot commented Sep 10, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign tangenta for approval. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

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

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@ti-chi-bot ti-chi-bot Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Sep 10, 2026
@coderabbitai

coderabbitai Bot commented Sep 10, 2026

Copy link
Copy Markdown

Review Change StackReview Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

This documentation-only change standardizes Japanese partitioning terminology across reference pages, guides, examples, and release notes. Technical content, links, measurements, and support values remain unchanged.

Changes

Partitioning terminology standardization

Layer / File(s) Summary
Core partition documentation
basic-features.md, partitioned-table.md, mysql-compatibility.md
Core references standardize range, range-column, list, key, and pruning terms.
Guides and examples
best-practices/..., partition-pruning.md, global-indexes.md, sql-statements/...
Guides, headings, performance tables, pruning descriptions, compatibility notes, and SPLIT examples use the updated terms.
Release note terminology
releases/release-*.md, system-variables.md, statistics.md, tiflash-*.md
Release notes and related documentation use the updated Japanese terminology without changing described behavior or links.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested reviewers: qiancai

Merge Risk: 🔵 Low · up to 3c74a

The partitioning documentation contains a few inconsistent or incomplete user-facing descriptions. These localized wording fixes should be addressed to complete the terminology standardization safely.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly describes the main change: standardizing Japanese names for partition types and pruning modes.
Description check ✅ Passed The description is detailed and covers the changes, affected TiDB version, AI involvement, and applicable change categories. It also explains terminology decisions and exclusions. The version selectio…
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@yahonda yahonda changed the title i18n(ja): unify Range partitioning notation to katakana form i18n(ja): unify partition-type name notation (Range, List) Sep 10, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 9744686b-a284-44c8-9f3e-64beda0cb0af

📥 Commits

Reviewing files that changed from the base of the PR and between a2da298 and fe974d4.

📒 Files selected for processing (26)
  • basic-features.md
  • best-practices/tidb-partitioned-tables-best-practices.md
  • global-indexes.md
  • partition-pruning.md
  • partitioned-table.md
  • releases/release-3.0-beta.md
  • releases/release-3.0-ga.md
  • releases/release-3.0.0-rc.2.md
  • releases/release-3.0.15.md
  • releases/release-3.0.5.md
  • releases/release-3.0.8.md
  • releases/release-4.0-ga.md
  • releases/release-4.0.12.md
  • releases/release-4.0.2.md
  • releases/release-4.0.5.md
  • releases/release-5.1.4.md
  • releases/release-5.1.5.md
  • releases/release-6.0.0-dmr.md
  • releases/release-6.1.6.md
  • releases/release-6.3.0.md
  • releases/release-6.5.2.md
  • releases/release-6.5.8.md
  • releases/release-7.1.0.md
  • releases/release-7.1.1.md
  • releases/release-7.1.4.md
  • sql-statements/sql-statement-split-region.md

Included review availability: Your plan provides up to 4 included reviews per hour; 1 remains after this review.

Comment thread partitioned-table.md Outdated
Comment thread partitioned-table.md Outdated
Comment thread releases/release-6.3.0.md Outdated
@yahonda yahonda changed the title i18n(ja): unify partition-type name notation (Range, List) i18n(ja): unify partition-type naming across Range/List/partitioning suffix Sep 10, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
partitioned-table.md (1)

407-407: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Replace the remaining English partitioning term.

Line [407] still says リスト COLUMNSパーティションテーブル, while this section now uses リスト列パーティションテーブル. Replace the sentence with the wording below.

Proposed wording

デフォルトのパーティションのないリストまたはリスト列パーティションテーブルの場合、 INSERT文を使用して挿入する値は、テーブルのPARTITION ... VALUES IN (...)句で定義されている値セットと一致する必要があります。挿入する値がどのパーティションの値セットとも一致しない場合、ステートメントは失敗し、次の例に示すようにエラーが返されます。

As per path instructions, this Markdown issue uses proposed wording because Line [407] is outside the changed range.

Source: Path instructions

releases/release-3.0-beta.md (1)

78-78: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Use レンジパーティショニング at Line 78.

Line 78 still uses レンジパーティション, while the same release note and partitioned-table.md use レンジパーティショニング. Replace the changed line with the exact text below.

Apply this replacement
-    - レンジパーティションをサポート[`#8011`](https://github.com/pingcap/tidb/pull/8011)
+    - レンジパーティショニングをサポート[`#8011`](https://github.com/pingcap/tidb/pull/8011)

As per path instructions, Markdown issues with a contiguous safe fix must include an exact committable replacement block.

Source: Path instructions


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 21574249-fd79-4a33-ba8d-87da07c2592a

📥 Commits

Reviewing files that changed from the base of the PR and between fe974d4 and 452786b.

📒 Files selected for processing (12)
  • basic-features.md
  • best-practices/tidb-partitioned-tables-best-practices.md
  • mysql-compatibility.md
  • partitioned-table.md
  • releases/release-3.0-beta.md
  • releases/release-5.0.0.md
  • releases/release-6.1.0.md
  • releases/release-6.4.0.md
  • releases/release-7.0.0.md
  • releases/release-7.3.0.md
  • releases/release-8.4.0.md
  • system-variables.md

Included review availability: Your plan provides up to 4 included reviews per hour; 0 remain after this review.

Comment thread releases/release-7.3.0.md Outdated
@qiancai qiancai added translation/no-need No need to translate this PR. and removed missing-translation-status This PR does not have translation status info. labels Sep 10, 2026
@yahonda yahonda changed the title i18n(ja): unify partition-type naming across Range/List/partitioning suffix i18n(ja): unify partition-type and pruning-mode naming Sep 10, 2026
@yahonda
yahonda force-pushed the fix-partition-type-notation branch 2 times, most recently from ee06e74 to 2c9aa26 Compare September 10, 2026 04:14

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 5


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: d5503dde-5b8f-437d-b98d-ffe8b0871c9e

📥 Commits

Reviewing files that changed from the base of the PR and between 452786b and 2c9aa26.

📒 Files selected for processing (19)
  • basic-features.md
  • best-practices/tidb-partitioned-tables-best-practices.md
  • global-indexes.md
  • mysql-compatibility.md
  • partitioned-table.md
  • releases/release-3.0.0-rc.2.md
  • releases/release-5.0.0.md
  • releases/release-6.1.0.md
  • releases/release-6.3.0.md
  • releases/release-7.1.0.md
  • releases/release-7.1.1.md
  • releases/release-7.3.0.md
  • releases/release-8.4.0.md
  • releases/release-8.5.0.md
  • releases/release-8.5.1.md
  • statistics.md
  • system-variables.md
  • tiflash-upgrade-guide.md
  • tiflash/use-tiflash-mpp-mode.md

Included review availability: Your plan provides up to 4 included reviews per hour; 1 remains after this review.

Comment thread partitioned-table.md Outdated
Comment thread partitioned-table.md Outdated
Comment thread releases/release-3.0.0-rc.2.md Outdated
Comment thread releases/release-8.5.1.md Outdated
Comment thread statistics.md Outdated
yahonda and others added 10 commits September 11, 2026 09:09
Unify the "Range" partition-type name to the katakana form (matching
Hash/Key/List, which have no competing kanji form) across
partitioned-table.md and its sibling docs/release notes -- 84 sites
across 26 files, each verified against release-8.5.

releases/release-4.0.9.md is intentionally excluded: its one "range
split" mention refers to a TiDB Lightning data-ingestion range split,
not SQL RANGE partitioning.

This does not touch the separate, still-open "partitioning vs
division" suffix inconsistency or the untranslated "List" partition
type name -- those are tracked as follow-up sweeps.
The "List" and "List COLUMNS" partition-type names were left as
literal untranslated English in ~20 sites across 8 files, while body
prose elsewhere already used the katakana form consistently. Translate
List -> リスト and List COLUMNS -> リスト列, matching how "Range
COLUMNS" is already translated (COLUMNS -> 列) and the established
katakana convention for the other partition types (Hash/Key/Range).

Also fixes a stray "ショニング" MT-scramble fragment in
partitioned-table.md's intro sentence, and reconstructs
releases/release-6.1.0.md's "User documents" line, which had dropped a
word and reversed the link order relative to EN.
Unify the noun "partitioning" suffix for Range/Hash/Key/List partition
types to the katakana form (パーティショニング), which was already the
dominant form (57 vs 16 sites), matching EN's consistent "partitioning"
wording. 13 sites across 6 files.

Deliberately does not touch the verb-participle construction "X分割
された" (e.g. global-indexes.md's "range partitioned by PK" table
labels) -- that is a different, correct grammatical use of 分割 as a
verb stem, not the noun compound this sweep targets.
…n docs

global-indexes.md: two benchmark table rows had "range"/"hash" word
order scrambled relative to their correct sibling rows (e.g. "PK de
partition-ized clustered-table range" instead of "clustered table
range-partitioned by PK") -- reconstructed to match EN and the
adjacent, already-correct rows.

releases/release-6.3.0.md, releases/release-7.1.0.md: "Range COLUMNS"
and "Range INTERVAL partitioning" left as literal untranslated English
in a few sites missed by the corpus-wide sweep (the compound had
COLUMNS/INTERVAL wedged between レンジ and パーティショニング, which
the sweep's substring rules did not match).

partitioned-table.md: dropped は particle after `NULL` ("NULL is not
an integer").
Unify 動的剪定/静的剪定 to 動的プルーニング/静的プルーニング, matching
partitioned-table.md's own heading and the already-dominant katakana
form (43 vs 12 sites before this fix). Confirmed a same-paragraph
self-contradiction in statistics.md (動的剪定モード link text next to
動的プルーニングモード body prose for the same referent). 16 sites
across 8 files, each verified against release-8.5.
Reverses the earlier choice to translate COLUMNS -> 列: Japanese has no
grammatical number, so 列 loses the "multiple columns" nuance that
COLUMNS conveys in EN ("Range/List COLUMNS partitioning" supports
partitioning by more than one column, unlike plain Range/List
partitioning). Keeping COLUMNS in English preserves that distinction,
matching the earlier choice to keep INTERVAL in English for the same
reason (a qualifier word on the base Range/Hash/Key/List type name).
38 sites across 9 files.
An independent review of this PR's diff found a handful of sites this
sweep's substring-replace rules missed, all sharing the same pattern:
an English qualifier word (COLUMNS/INTERVAL) wedged between the base
partition-type word and パーティション caused the exact-substring
match to skip the site.

- releases/release-6.3.0.md: 範囲COLUMNS -> レンジCOLUMNS (2 sites)
- partitioned-table.md: heading using the old suffix -> unified to
  match every other mention of this exact concept in the same file
- best-practices/tidb-partitioned-tables-best-practices.md: literal
  untranslated English partition-type name, translated
- releases/release-8.5.1.md: literal untranslated English
  partition-type name, translated (found via a final corpus-wide
  sweep after fixing the above, not part of the original review)
…abbit

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…CodeRabbit

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@yahonda
yahonda force-pushed the fix-partition-type-notation branch from d40006e to 8d8a907 Compare September 11, 2026 00:09
Hash/Range COLUMNS partitioning named as パーティション instead of
the standardized パーティショニング suffix used elsewhere in this PR.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@yahonda

yahonda commented Sep 11, 2026

Copy link
Copy Markdown
Member Author

@coderabbitai full review

@coderabbitai

coderabbitai Bot commented Sep 11, 2026

Copy link
Copy Markdown
✅ Action performed

Full review finished.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
partitioned-table.md (1)

407-407: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Use the standardized リストCOLUMNS spelling.

Line [407] still uses リスト COLUMNSパーティションテーブル, while the same section uses リストCOLUMNSパーティションテーブル. This leaves one visible terminology mismatch.

Proposed wording

デフォルトのパーティションのないリストまたはリストCOLUMNSパーティションテーブルの場合、 `INSERT`文を使用して挿入する値は、テーブルの`PARTITION ... VALUES IN (...)`句で定義されている値セットと一致する必要があります。挿入する値がどのパーティションの値セットとも一致しない場合、ステートメントは失敗し、次の例に示すようにエラーが返されます。

As per path instructions: use a regular review comment when the fix is outside the diff; provide the exact replacement as proposed wording.

Source: Path instructions


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 284917e6-cfcf-422f-b756-19fac1f580a3

📥 Commits

Reviewing files that changed from the base of the PR and between 645c2ff and 3c74ad3.

📒 Files selected for processing (39)
  • basic-features.md
  • best-practices/tidb-partitioned-tables-best-practices.md
  • global-indexes.md
  • mysql-compatibility.md
  • partition-pruning.md
  • partitioned-table.md
  • releases/release-3.0-beta.md
  • releases/release-3.0-ga.md
  • releases/release-3.0.0-rc.2.md
  • releases/release-3.0.15.md
  • releases/release-3.0.5.md
  • releases/release-3.0.8.md
  • releases/release-4.0-ga.md
  • releases/release-4.0.12.md
  • releases/release-4.0.2.md
  • releases/release-4.0.5.md
  • releases/release-5.0.0.md
  • releases/release-5.1.4.md
  • releases/release-5.1.5.md
  • releases/release-6.0.0-dmr.md
  • releases/release-6.1.0.md
  • releases/release-6.1.6.md
  • releases/release-6.3.0.md
  • releases/release-6.4.0.md
  • releases/release-6.5.2.md
  • releases/release-6.5.8.md
  • releases/release-7.0.0.md
  • releases/release-7.1.0.md
  • releases/release-7.1.1.md
  • releases/release-7.1.4.md
  • releases/release-7.3.0.md
  • releases/release-8.4.0.md
  • releases/release-8.5.0.md
  • releases/release-8.5.1.md
  • sql-statements/sql-statement-split-region.md
  • statistics.md
  • system-variables.md
  • tiflash-upgrade-guide.md
  • tiflash/use-tiflash-mpp-mode.md

Included review availability: Your plan provides up to 4 included reviews per hour; 0 remain after this review.

Comment thread partitioned-table.md Outdated
Comment thread releases/release-3.0-beta.md
Comment thread system-variables.md Outdated
- partitioned-table.md: add the missing predicate (データ型を使用できます) to
  the Range COLUMNS partition column description
- system-variables.md: remove the stray leftover パーティション before the
  dynamic pruning mode link
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/L Denotes a PR that changes 100-499 lines, ignoring generated files. translation/no-need No need to translate this PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants