Skip to content

i18n(ja): fix TiDB Cloud Lake guides, tutorials, and TOC found in the second full review - #24537

Merged
qiancai merged 8 commits into
pingcap:i18n-ja-release-8.5from
yahonda:i18n-ja-lake-review2-guides
Oct 27, 2026
Merged

qiancai merged 8 commits into
pingcap:i18n-ja-release-8.5from
yahonda:i18n-ja-lake-review2-guides

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 guides, tutorials, top pages, and TOC-tidb-cloud-lake.md (86 files).

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

  • Documentation
    • Updated Japanese documentation across guides, tutorials, tables of contents, and navigation with more consistent terminology and clearer headings.
    • Clarified Warehouse requirements for SQL tasks, NDJSON schema inference, and aggregation UDF behavior.
    • Added information about sharing and reusing FeiShuBot configurations and the approximate size of the SF1000 dataset.
    • Existing procedures, SQL examples, settings, and product behavior remain unchanged.

yahonda and others added 2 commits October 22, 2026 17:17
… second full review

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…p in the Lake guides and TOC

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
@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 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

@coderabbitai

coderabbitai Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

📝 Walkthrough

Japanese wording and terminology were updated across TiDB Cloud Lake navigation, guides, and tutorials. Most edits preserve existing links, procedures, SQL examples, configuration values, and described behavior. A few descriptions were clarified or expanded.

Changes: TiDB Cloud Lake documentation

Layer / File(s) Summary
Navigation and product concepts
tidb-cloud-lake/TOC-tidb-cloud-lake.md, tidb-cloud-lake/guides/{data-lifecycle,data-protection-policies,data-purge-and-recycle,editions,ownership,privileges,roles,row-access-policy,masking-policy,warehouse}.md, tidb-cloud-lake/lake-overview.md
Navigation labels and product, governance, and access-control terms were updated. The Warehouse overview now lists SQL tasks that require a Warehouse.
Connections and integrations
tidb-cloud-lake/guides/{amazon-sqs-s3-iam-role,audit-trail,authenticate-with-aws-iam-role,compliance-security,connect-*,data-sources,deepnote,feishubot,integrate-with-*,jupyter-notebook,kafka-credentials,mcp-*,network-policy,tidb-data-source}.md, tidb-cloud-lake/tutorials/migrate-from-snowflake.md
Connection and integration terminology was updated across setup guides and tutorials. The FeiShuBot guide adds a use case for reusing bot settings and templates across tasks.
Stage, loading, and file-query guides
tidb-cloud-lake/guides/{load-*,query-*,stage-overview,unload-*,upload-to-stage}.md
Stage terminology was standardized across file-loading, querying, uploading, and unloading documentation. The load-from-stage overview also links to related references.
Tasks, streams, and data workflows
tidb-cloud-lake/guides/{automate-data-loading-with-tasks,continuous-data-pipelines,how-data-sharing-works,lakehouse-etl,task-flow,task-management,track-and-transform-data-via-streams,transform-data-on-load}.md
Task, stream, data-sharing, and transformation terminology was revised. SQL examples and described execution conditions remain unchanged.
Analytics and technical reference guides
tidb-cloud-lake/guides/{aggregating-index,benchmark-*,choose-a-udf-type,cluster-key-performance,dashboards,full-text-index,geo-analytics,how-fuse-engine-works,how-json-variant-works,how-optimizer-works,ngram-index,performance-optimization,recovery-from-operational-errors,schema-evolution,sql-analytics,tidb-cloud-lake-architecture,troubleshooting,vector-search-guide,virtual-column}.md
Analytics and technical terminology was updated. The UDF guidance identifies the merge associativity requirement, and the SF1000 description states that the dataset is approximately 1 TB.

Priority: ➖ Normal

Estimated code review effort: 3 (Moderate) | ~25 minutes

Change: Other

Merge Risk: 🔵 Low · up to 34a9e

This is a documentation-only change with no behavioral impact. Before merging, fix the 404 console link that fails the link check, and adjust the dash spacing flagged by Vale on two bullets. The rest is wording alignment with the English source.

Pre-merge checks: Passed 5
Check name Status Explanation
Description check Passed The description clearly explains the scope, review basis, change categories, affected branch, reference links, and AI involvement. Required sections are present and sufficiently complete.
Title check Passed The title clearly identifies Japanese TiDB Cloud Lake documentation fixes found during a second review. It is concise and directly related to the changes, although it does not mention top pages.
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: 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. (85 skipped: 85 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 added missing-translation-status This PR does not have translation status info. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Oct 22, 2026
yahonda and others added 6 commits October 23, 2026 09:22
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>
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>
@yahonda
yahonda marked this pull request as ready for review October 23, 2026 00:46
@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


ℹ️ Review info
⚙️ Run configuration
📥 Commits

Reviewing files that changed from the base of the PR and between 4de2d0f and 34a9e84.

📒 Files selected for processing: 85
  • TOC-tidb-cloud-lake.md
  • tidb-cloud-lake/guides/aggregating-index.md
  • tidb-cloud-lake/guides/amazon-sqs-s3-iam-role.md
  • tidb-cloud-lake/guides/audit-trail.md
  • tidb-cloud-lake/guides/authenticate-with-aws-iam-role.md
  • tidb-cloud-lake/guides/automate-data-loading-with-tasks.md
  • tidb-cloud-lake/guides/benchmark-data-ingestion.md
  • tidb-cloud-lake/guides/benchmark-tpch-sf100.md
  • tidb-cloud-lake/guides/benchmark-tpch-sf1000.md
  • tidb-cloud-lake/guides/choose-a-udf-type.md
  • tidb-cloud-lake/guides/cluster-key-performance.md
  • tidb-cloud-lake/guides/compliance-security.md
  • tidb-cloud-lake/guides/connect-using-lakesql.md
  • tidb-cloud-lake/guides/connect-with-alibaba-cloud-privatelink.md
  • tidb-cloud-lake/guides/connect-with-aws-privatelink.md
  • tidb-cloud-lake/guides/continuous-data-pipelines.md
  • tidb-cloud-lake/guides/dashboards.md
  • tidb-cloud-lake/guides/data-lifecycle.md
  • tidb-cloud-lake/guides/data-protection-policies.md
  • tidb-cloud-lake/guides/data-purge-and-recycle.md
  • tidb-cloud-lake/guides/data-sources.md
  • tidb-cloud-lake/guides/deepnote.md
  • tidb-cloud-lake/guides/editions.md
  • tidb-cloud-lake/guides/feishubot.md
  • tidb-cloud-lake/guides/full-text-index.md
  • tidb-cloud-lake/guides/geo-analytics.md
  • tidb-cloud-lake/guides/how-data-sharing-works.md
  • tidb-cloud-lake/guides/how-fuse-engine-works.md
  • tidb-cloud-lake/guides/how-json-variant-works.md
  • tidb-cloud-lake/guides/how-optimizer-works.md
  • tidb-cloud-lake/guides/integrate-with-amazon-s3.md
  • tidb-cloud-lake/guides/integrate-with-amazon-sqs-s3.md
  • tidb-cloud-lake/guides/integrate-with-kafka.md
  • tidb-cloud-lake/guides/integrate-with-mysql.md
  • tidb-cloud-lake/guides/integrate-with-postgresql.md
  • tidb-cloud-lake/guides/integrate-with-tidb.md
  • tidb-cloud-lake/guides/json-search.md
  • tidb-cloud-lake/guides/jupyter-notebook.md
  • tidb-cloud-lake/guides/kafka-credentials.md
  • tidb-cloud-lake/guides/lake-poc.md
  • tidb-cloud-lake/guides/lakehouse-etl.md
  • tidb-cloud-lake/guides/load-from-files.md
  • tidb-cloud-lake/guides/load-from-local-file.md
  • tidb-cloud-lake/guides/load-from-stage.md
  • tidb-cloud-lake/guides/load-ndjson.md
  • tidb-cloud-lake/guides/load-parquet.md
  • tidb-cloud-lake/guides/load-semi-structured-data.md
  • tidb-cloud-lake/guides/load-tsv.md
  • tidb-cloud-lake/guides/load-with-dbt.md
  • tidb-cloud-lake/guides/masking-policy.md
  • tidb-cloud-lake/guides/mcp-client-integration.md
  • tidb-cloud-lake/guides/mcp-server.md
  • tidb-cloud-lake/guides/network-policy.md
  • tidb-cloud-lake/guides/ngram-index.md
  • tidb-cloud-lake/guides/ownership.md
  • tidb-cloud-lake/guides/performance-optimization.md
  • tidb-cloud-lake/guides/privileges.md
  • tidb-cloud-lake/guides/query-csv-files-in-stage.md
  • tidb-cloud-lake/guides/query-ndjson-files-in-stage.md
  • tidb-cloud-lake/guides/query-parquet-files-in-stage.md
  • tidb-cloud-lake/guides/query-stage.md
  • tidb-cloud-lake/guides/query-staged-orc-files-in-stage.md
  • tidb-cloud-lake/guides/query-tsv-files-in-stage.md
  • tidb-cloud-lake/guides/recovery-from-operational-errors.md
  • tidb-cloud-lake/guides/roles.md
  • tidb-cloud-lake/guides/row-access-policy.md
  • tidb-cloud-lake/guides/schema-evolution.md
  • tidb-cloud-lake/guides/sql-analytics.md
  • tidb-cloud-lake/guides/stage-overview.md
  • tidb-cloud-lake/guides/task-flow.md
  • tidb-cloud-lake/guides/task-management.md
  • tidb-cloud-lake/guides/tidb-cloud-lake-architecture.md
  • tidb-cloud-lake/guides/tidb-data-source.md
  • tidb-cloud-lake/guides/track-and-transform-data-via-streams.md
  • tidb-cloud-lake/guides/transform-data-on-load.md
  • tidb-cloud-lake/guides/troubleshooting.md
  • tidb-cloud-lake/guides/unload-csv-file.md
  • tidb-cloud-lake/guides/unload-data.md
  • tidb-cloud-lake/guides/upload-to-stage.md
  • tidb-cloud-lake/guides/vector-search-guide.md
  • tidb-cloud-lake/guides/virtual-column.md
  • tidb-cloud-lake/guides/warehouse.md
  • tidb-cloud-lake/lake-overview.md
  • tidb-cloud-lake/tutorials/ingest-json-logs-with-vector-cloud.md
  • tidb-cloud-lake/tutorials/migrate-from-snowflake.md

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

Comment thread tidb-cloud-lake/guides/automate-data-loading-with-tasks.md
Comment thread tidb-cloud-lake/guides/connect-using-lakesql.md
Comment thread tidb-cloud-lake/guides/continuous-data-pipelines.md
Comment thread tidb-cloud-lake/guides/warehouse.md
@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 Oct 27, 2026

@qiancai qiancai left a comment

Copy link
Copy Markdown
Collaborator

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 Bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Oct 27, 2026
@ti-chi-bot

ti-chi-bot Bot commented Oct 27, 2026

Copy link
Copy Markdown

[LGTM Timeline notifier]

Timeline:

  • 2026-10-27 12:09:50.30199311 +0000 UTC m=+463327.793705379: ☑️ agreed by qiancai.

@qiancai
qiancai merged commit 011b85e into pingcap:i18n-ja-release-8.5 Oct 27, 2026
5 of 10 checks passed
@yahonda
yahonda deleted the i18n-ja-lake-review2-guides branch October 28, 2026 00:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-1-more-lgtm Indicates a PR needs 1 more LGTM. size/XXL Denotes a PR that changes 1000+ 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