cloud: document Premium manual import mapping by alastori · Pull Request #23504 · pingcap/docs

alastori · 2026-08-12T05:11:33Z

What is changed, added or deleted? (Required)

This PR aligns the TiDB Cloud Premium import documentation with the current console:

Documents manual source-pattern mappings and multiple target-table mappings.
Corrects the pre-check and import-start sequence.
Removes the obsolete "Manual mapping is coming soon" note and guidance for an option that currently has no effect.
Clarifies that manual mapping for Aurora Snapshot Parquet files does not infer a complete snapshot mapping or create target schemas. Users must create target tables and verify the pre-check results.
Scopes the Aurora Snapshot manual-mapping guidance to Premium while preserving the existing restrictions for other service plans.

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

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

Other reference link(s): cloud: clarify IMPORT INTO wildcard path matching #23488

Validation

./scripts/markdownlint tidb-cloud/naming-conventions-for-data-import.md tidb-cloud/premium/import-csv-files-premium.md tidb-cloud/premium/import-from-s3-premium.md
python3 scripts/file-format-lint.py on the updated naming-conventions and Premium CSV import pages
python3 scripts/check-manual-line-breaks.py on the updated naming-conventions and Premium CSV import pages
git diff --check
Reviewed the file history to preserve the existing non-Premium Aurora Snapshot restriction.

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
- Clarified CSV and Parquet file-pattern mapping relative to source URIs.
- Documented automatic and manual source-to-table mappings, including wildcard usage and multiple mappings per import.
- Added plan-specific import limitations and Premium Aurora Snapshot guidance.
- Expanded import workflows with pre-check, review, and troubleshooting instructions for missing files, incorrect URIs, and zero-row results.
- Updated S3 import guidance to require a top-level folder URI and support additional storage providers.

ti-chi-bot · 2026-08-12T05:11:36Z

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 · 2026-08-12T05:11:42Z

[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:

OWNERS

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

coderabbitai · 2026-08-12T05:11:43Z

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

The documentation defines source-file mapping rules, plan-specific limitations, and Premium import workflows for Amazon S3 and Alibaba OSS. It covers folder URIs, automatic and manual mappings, pre-checks, completion verification, and troubleshooting.

Changes

Data import mapping documentation

Layer / File(s)	Summary
Mapping rules and plan limitations `tidb-cloud/naming-conventions-for-data-import.md`, `tidb-cloud/premium/import-from-s3-premium.md`	The documentation defines relative CSV and Parquet source patterns, per-table mappings, plan restrictions, and multiple mappings per S3 import job.
Premium CSV import workflows `tidb-cloud/premium/import-csv-files-premium.md`	The Amazon S3 and Alibaba OSS workflows document top-level folder URIs, automatic and manual mappings, pre-checks, import completion, and troubleshooting.
Premium S3 mapping configuration `tidb-cloud/premium/import-from-s3-premium.md`	The mapping step documents top-level folder URIs, source patterns, destination tables, wildcards, and additional mappings.

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

Suggested labels: area/tidb-cloud, for-cloud-release

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly identifies the main change: documenting Premium manual import mapping.
Description check	✅ Passed	The description covers the required change summary, affected version, reference link, AI involvement, and change-type checklist.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.}

alastori · 2026-08-12T05:37:48Z

@xuanyu66 PTAL

alastori · 2026-08-12T18:51:17Z

@coderabbitai full review

coderabbitai · 2026-08-12T18:51:22Z

✅ Action performed

Full review finished.

coderabbitai

Actionable comments posted: 2

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 3e65ba8f-8d09-485c-9c82-07a997dc8dbe

📥 Commits

Reviewing files that changed from the base of the PR and between a26c149 and a69e4ac.

📒 Files selected for processing (3)

tidb-cloud/naming-conventions-for-data-import.md
tidb-cloud/premium/import-csv-files-premium.md
tidb-cloud/premium/import-from-s3-premium.md

alastori · 2026-08-12T19:26:20Z

@coderabbitai full review

coderabbitai · 2026-08-12T19:26:26Z

✅ Action performed

Full review finished.

coderabbitai

Actionable comments posted: 1

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 3c86eb4a-6cee-459c-ab84-7ec6c5b5fa2c

📥 Commits

Reviewing files that changed from the base of the PR and between a26c149 and 096fcf3.

📒 Files selected for processing (3)

tidb-cloud/naming-conventions-for-data-import.md
tidb-cloud/premium/import-csv-files-premium.md
tidb-cloud/premium/import-from-s3-premium.md

alastori · 2026-08-12T19:34:08Z

@coderabbitai full review

coderabbitai · 2026-08-12T19:34:14Z

✅ Action performed

Full review finished.

coderabbitai

Actionable comments posted: 2

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 37fd6fdb-01f1-4b7e-880f-adbff914e034

📥 Commits

Reviewing files that changed from the base of the PR and between a26c149 and 827aa73.

📒 Files selected for processing (3)

tidb-cloud/naming-conventions-for-data-import.md
tidb-cloud/premium/import-csv-files-premium.md
tidb-cloud/premium/import-from-s3-premium.md

alastori · 2026-08-12T19:40:42Z

@coderabbitai full review

coderabbitai · 2026-08-12T19:40:48Z

✅ Action performed

Full review finished.

coderabbitai

Actionable comments posted: 1

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 80ba5d4d-89f5-45fd-8afb-8878355db144

📥 Commits

Reviewing files that changed from the base of the PR and between a26c149 and 4f7dbfe.

📒 Files selected for processing (3)

tidb-cloud/naming-conventions-for-data-import.md
tidb-cloud/premium/import-csv-files-premium.md
tidb-cloud/premium/import-from-s3-premium.md

docs: update Premium manual import mapping

10cd943

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 Aug 12, 2026

ti-chi-bot Bot added missing-translation-status This PR does not have translation status info. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Aug 12, 2026

docs: scope Premium import mapping guidance

a69e4ac

coderabbitai Bot reviewed Aug 12, 2026

View reviewed changes

Comment thread tidb-cloud/premium/import-csv-files-premium.md

Comment thread tidb-cloud/premium/import-from-s3-premium.md

docs: align Premium import source guidance

096fcf3

ti-chi-bot Bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Aug 12, 2026

coderabbitai Bot reviewed Aug 12, 2026

View reviewed changes

Comment thread tidb-cloud/premium/import-csv-files-premium.md Outdated

docs: match Premium mapping option label

827aa73

coderabbitai Bot reviewed Aug 12, 2026

View reviewed changes

Comment thread tidb-cloud/naming-conventions-for-data-import.md Outdated

Comment thread tidb-cloud/premium/import-csv-files-premium.md Outdated

docs: scope Premium mapping recovery guidance

4f7dbfe

coderabbitai Bot reviewed Aug 12, 2026

View reviewed changes

Comment thread tidb-cloud/premium/import-from-s3-premium.md Outdated

docs: align Premium mapping terminology

840da90

alastori marked this pull request as ready for review August 12, 2026 23:09

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 Aug 12, 2026

Uh oh!

Conversation

alastori commented Aug 12, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What is changed, added or deleted? (Required)

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

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

Validation

AI agent involvement

Do your changes match any of the following descriptions?

Summary by CodeRabbit

Uh oh!

ti-chi-bot Bot commented Aug 12, 2026

Uh oh!

ti-chi-bot Bot commented Aug 12, 2026

Uh oh!

coderabbitai Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

Changes

Uh oh!

alastori commented Aug 12, 2026

Uh oh!

alastori commented Aug 12, 2026

Uh oh!

coderabbitai Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

alastori commented Aug 12, 2026

Uh oh!

coderabbitai Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

alastori commented Aug 12, 2026

Uh oh!

coderabbitai Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

alastori commented Aug 12, 2026

Uh oh!

coderabbitai Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

alastori commented Aug 12, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Aug 12, 2026 •

edited

Loading

coderabbitai Bot commented Aug 12, 2026 •

edited

Loading

coderabbitai Bot commented Aug 12, 2026 •

edited

Loading

coderabbitai Bot commented Aug 12, 2026 •

edited

Loading

coderabbitai Bot commented Aug 12, 2026 •

edited

Loading