Skip to content

i18n(ja): fix TiDB Cloud Lake SQL reference pages (a to d) found in the second full review - #24538

Open
yahonda wants to merge 8 commits into
pingcap:i18n-ja-release-8.5from
yahonda:i18n-ja-lake-review2-sql-a-d
Open

yahonda wants to merge 8 commits into
pingcap:i18n-ja-release-8.5from
yahonda:i18n-ja-lake-review2-sql-a-d

Conversation

@yahonda

@yahonda yahonda commented Oct 22, 2026 •

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

This PR fixes the Japanese TiDB Cloud Lake SQL reference pages from acos.md to drop-task.md (73 files). It also uses one label for Notes in the window function pages.

The fixes come from a second line-by-line review of all 1,122 Japanese TiDB Cloud Lake files against the English source (release-8.5), split into 13 parts. This PR is one of four:

  • guides, tutorials, top pages, and the TOC
  • SQL reference a–d
  • SQL reference d–s
  • SQL reference s–z

Content that lagged behind recent English changes was left to the translation sync (#24522, now merged) and is not hand-fixed here. Anchors ({#...}), code blocks, and EOF newlines are unchanged.

Types of fixes:

  • Mistranslations, omissions, and wording not in the English.
  • Leftover English in prose.
  • Code and markup that differ from the English: backticks the English does not have, broken result boxes, and links.
  • One rendering per term, following these decisions:
    • "connection" → 接続 (prose; the object name Connection stays English)
    • "notification integration" → 通知統合
    • "workload group" → ワークロードグループ
    • "stream" → ストリーム
    • masking/row access/security policy → マスキングポリシー/行アクセスポリシー/セキュリティポリシー
    • "See also" → 関連情報
    • internal/external/user stage → 内部/外部/ユーザー stage
    • "transient table" → トランジェントテーブル
    • "Advanced Configuration" → 詳細設定
    • The 「(load)」 gloss in compounds is removed.
    • Settled terms: スナップショット, セグメント, ブロック, タイムスタンプ, 射影, and the 「注意:」 label for "Notes:".

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.

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

What is the related PR or file 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

🤖 Generated with Claude Code

Summary by CodeRabbit

  • ドキュメント
    • SQLリファレンス全般の日本語表現や専門用語を見直し、関数、データ型、接続、ステージ、ポリシーなどの説明をより自然で一貫した表記に整えました。
    • 見出しや関連情報への案内、表の項目名、注意書き、例の説明を読みやすく調整しました。
    • SQLの構文や例の動作、記載されている要件に変更はありません。

yahonda and others added 3 commits October 22, 2026 17:28
…he second full review

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ti-chi-bot

ti-chi-bot Bot commented Oct 22, 2026

Copy link
Copy Markdown

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@ti-chi-bot ti-chi-bot Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 22, 2026
@coderabbitai

coderabbitai Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
📥 Commits

Reviewing files that changed from the base of the PR and between 10fb60a and 4950783.

📒 Files selected for processing: 1
  • tidb-cloud-lake/sql/at.md

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

📝 Walkthrough

Japanese SQL documentation has terminology, translation, and formatting edits across function references, object-management pages, and connection, data-loading, and stream topics. The supplied summaries report no changes to SQL behavior.

Changes: SQL documentation updates

Layer / File(s) Summary
Function and SQL reference wording
tidb-cloud-lake/sql/{acos,age,array-*,atan,avg,bitmap*,date-*,day-week,decades,dense-rank,...}.md
Updated Japanese terms and descriptions across function and reference pages. Edits also adjust headings, metadata, and inline formatting.
Object and policy documentation
tidb-cloud-lake/sql/{alter-*,create-*,describe-notification-integration,drop-*,create-workload-group}.md
Updated Japanese wording in object, policy, and command documentation. The supplied summaries report no changes to SQL statements or documented requirements.
Connections, data loading, and streams
tidb-cloud-lake/sql/{apache-icebergtm-tables,connection*,copy-into-*,create-stage,create-stream,at,desc-stream,delta-lake-engine}.md
Updated terminology and formatting in connection, stage, copy, and stream documentation. SQL examples and documented conditions remain unchanged according to the summaries.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~12 minutes

Change: Other

Possibly related issues

Merge Risk: 🔵 Low · up to 49507

The PR still contains three localized documentation inconsistencies that can confuse readers, but they do not affect runtime behavior.

Pre-merge checks: Passed 5
Check name Status Explanation
Title check Passed The title clearly identifies Japanese localization fixes for TiDB Cloud Lake SQL reference pages and matches the main changes in the pull request.
Description check Passed The description covers the changes, affected version, reference links, AI involvement, and change classifications. The first-time contributor checklist is omitted, which is permitted when the author i…
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.
Full details: Description check

Explanation

The description covers the changes, affected version, reference links, AI involvement, and change classifications. The first-time contributor checklist is omitted, which is permitted when the author is not a first-time contributor.

Full details: Docstring Coverage

Explanation

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 files. (1 skipped: 1 unsupported.)

✨ Finishing Touches: 💡 1
🛠️ Fix failing CI checks: 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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.

@ti-chi-bot

ti-chi-bot Bot commented Oct 22, 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 qiancai 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 missing-translation-status This PR does not have translation status info. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Oct 22, 2026
yahonda and others added 4 commits October 23, 2026 10:12
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…pages

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@yahonda
yahonda marked this pull request as ready for review October 23, 2026 01:20
@ti-chi-bot ti-chi-bot Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 23, 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: 4

🔇 Additional comments: 1
tidb-cloud-lake/sql/create-task.md-65-65: 1

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

⚠️ Unverified finding
Verification ran but could not confirm this finding. It is shown for review, not as a verified issue.

Format the STREAM_STATUS warning as a standalone callout.

The changed line leaves Warning: in English and places it inside the preceding > **Note:** block. This renders the warning as Note content and leaves untranslated user-facing text. Move the sentence to a standalone warning block using the repository's Japanese warning-label format. This requires changing the unchanged Note wrapper, so a one-line suggestion would be unsafe.


ℹ️ Review info
⚙️ Run configuration
📥 Commits

Reviewing files that changed from the base of the PR and between 4de2d0f and 10fb60a.

📒 Files selected for processing: 74
  • tidb-cloud-lake/sql/acos.md
  • tidb-cloud-lake/sql/add-months.md
  • tidb-cloud-lake/sql/age.md
  • tidb-cloud-lake/sql/aggregate-functions.md
  • tidb-cloud-lake/sql/alter-network-policy.md
  • tidb-cloud-lake/sql/alter-password-policy.md
  • tidb-cloud-lake/sql/alter-table.md
  • tidb-cloud-lake/sql/alter-task.md
  • tidb-cloud-lake/sql/alter-user.md
  • tidb-cloud-lake/sql/alter-warehouse-assign-nodes.md
  • tidb-cloud-lake/sql/apache-icebergtm-tables.md
  • tidb-cloud-lake/sql/approx-count-distinct.md
  • tidb-cloud-lake/sql/arg-max.md
  • tidb-cloud-lake/sql/arg-min.md
  • tidb-cloud-lake/sql/array-agg.md
  • tidb-cloud-lake/sql/array-filter.md
  • tidb-cloud-lake/sql/array-functions.md
  • tidb-cloud-lake/sql/array-reduce.md
  • tidb-cloud-lake/sql/as-array.md
  • tidb-cloud-lake/sql/at.md
  • tidb-cloud-lake/sql/atan.md
  • tidb-cloud-lake/sql/avg.md
  • tidb-cloud-lake/sql/bitmap-has-all.md
  • tidb-cloud-lake/sql/bitmap-not.md
  • tidb-cloud-lake/sql/bitmap.md
  • tidb-cloud-lake/sql/boolean.md
  • tidb-cloud-lake/sql/catalog.md
  • tidb-cloud-lake/sql/char.md
  • tidb-cloud-lake/sql/connection-parameters.md
  • tidb-cloud-lake/sql/connection.md
  • tidb-cloud-lake/sql/copy-into-location.md
  • tidb-cloud-lake/sql/copy-into-table.md
  • tidb-cloud-lake/sql/count-distinct.md
  • tidb-cloud-lake/sql/covar-pop.md
  • tidb-cloud-lake/sql/crc.md
  • tidb-cloud-lake/sql/create-connection.md
  • tidb-cloud-lake/sql/create-database.md
  • tidb-cloud-lake/sql/create-external-table.md
  • tidb-cloud-lake/sql/create-file-format.md
  • tidb-cloud-lake/sql/create-inverted-index.md
  • tidb-cloud-lake/sql/create-ngram-index.md
  • tidb-cloud-lake/sql/create-notification-integration.md
  • tidb-cloud-lake/sql/create-password-policy.md
  • tidb-cloud-lake/sql/create-pipe.md
  • tidb-cloud-lake/sql/create-role.md
  • tidb-cloud-lake/sql/create-snapshot-tag.md
  • tidb-cloud-lake/sql/create-stage.md
  • tidb-cloud-lake/sql/create-stream.md
  • tidb-cloud-lake/sql/create-table.md
  • tidb-cloud-lake/sql/create-task.md
  • tidb-cloud-lake/sql/create-vector-index.md
  • tidb-cloud-lake/sql/create-warehouse.md
  • tidb-cloud-lake/sql/create-worker.md
  • tidb-cloud-lake/sql/create-workload-group.md
  • tidb-cloud-lake/sql/cume-dist.md
  • tidb-cloud-lake/sql/current-user.md
  • tidb-cloud-lake/sql/data-anonymization-functions.md
  • tidb-cloud-lake/sql/date-add.md
  • tidb-cloud-lake/sql/date-time-functions.md
  • tidb-cloud-lake/sql/date-time.md
  • tidb-cloud-lake/sql/date-trunc.md
  • tidb-cloud-lake/sql/day-week.md
  • tidb-cloud-lake/sql/decades.md
  • tidb-cloud-lake/sql/delete.md
  • tidb-cloud-lake/sql/delta-lake-engine.md
  • tidb-cloud-lake/sql/dense-rank.md
  • tidb-cloud-lake/sql/desc-stream.md
  • tidb-cloud-lake/sql/describe-notification-integration.md
  • tidb-cloud-lake/sql/drop-database.md
  • tidb-cloud-lake/sql/drop-dictionary.md
  • tidb-cloud-lake/sql/drop-pipe.md
  • tidb-cloud-lake/sql/drop-snapshot-tag.md
  • tidb-cloud-lake/sql/drop-table.md
  • tidb-cloud-lake/sql/drop-task.md

Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 2 remain after this review.

Comment thread tidb-cloud-lake/sql/at.md Outdated
Comment thread tidb-cloud-lake/sql/copy-into-location.md
```json
1,"U00010","{\"carPriceList\":[{\"carTypeId":10,\"distance":5860},{\"carTypeId":11,\"distance\":5861}]}"
2,"U00011","{\"carPriceList\":[{\"carTypeId":12,\"distance\":5862},{\"carTypeId":13,\"distance\":5863}]}"
2,"U00011","{\"carPriceList\":[{\"carTypeId":12,\"distance":5862},{\"carTypeId":13,\"distance\":5863}]}"

@coderabbitai coderabbitai Bot Oct 23, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Label the example as CSV.

The example contains three comma-separated fields. The third field contains escaped JSON, but the complete record is not JSON. The json fence therefore mislabels the example.

Committable replacement
-```json
+```csv

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Good catch, but the Japanese follows the English source, which also labels this block as json. I am fixing the English in #24523, and the Japanese will follow through the translation sync.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

@yahonda Understood. Fixing the English source in #24523 and applying the translation sync will address this finding. No separate Japanese edit is needed in this PR.

You are interacting with an AI system.

Comment thread tidb-cloud-lake/sql/create-external-table.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

missing-translation-status This PR does not have translation status info. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant