Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 17, 2025

What's Changed in this PR

Documents the PARALLELISM option added to COPY DATABASE SQL command and CLI tools in GreptimeTeam/greptimedb#7213.

SQL Documentation Changes:

  • Added PARALLELISM parameter to COPY DATABASE syntax definition
  • Documented behavior: controls concurrent table operations, defaults to CPU cores, minimum 1
  • Added examples for both export and import operations
-- Export all table data using 4 parallel operations
COPY DATABASE public TO '/tmp/export/' WITH (FORMAT='parquet', PARALLELISM=4);

-- Import files using 8 parallel operations
COPY DATABASE public FROM '/tmp/export/' WITH (FORMAT='parquet', PARALLELISM=8);

CLI Documentation Changes:

  • Export tool: Updated --export-jobs to --db-parallelism (with -j and --export-jobs as aliases) and added --table-parallelism option (default: 4)
  • Import tool: Updated --import-jobs to --db-parallelism (with -j and --import-jobs as aliases)
  • Added clear descriptions distinguishing database-level vs table-level parallelism

Chinese Localization:

  • Added Chinese translations for all SQL COPY DATABASE documentation updates
  • Added Chinese translations for all CLI tool documentation updates

Text Polishing:

  • Improved English text for native readability and natural flow
  • Enhanced Chinese text for native fluency and clarity
  • Maintained all technical content, formatting, and structure

Checklist

Original prompt

This section details on the original issue you should resolve

<issue_title>Update docs for feat: support parallel table operations in COPY DATABASE</issue_title>
<issue_description>A document change request is generated from GreptimeTeam/greptimedb#7213</issue_description>

<agent_instructions>update nightly docs</agent_instructions>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Nov 17, 2025

Deploying greptime-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 0935110
Status: ✅  Deploy successful!
Preview URL: https://5279acfc.greptime-docs.pages.dev
Branch Preview URL: https://copilot-update-nightly-docs-tbn6.greptime-docs.pages.dev

View logs

Copilot AI changed the title [WIP] Update docs for parallel table operations in COPY DATABASE docs: add PARALLELISM option for COPY DATABASE Nov 17, 2025
Copilot AI requested a review from WenyXu November 17, 2025 13:21
Copilot finished work on behalf of WenyXu November 17, 2025 13:21
@WenyXu
Copy link
Member

WenyXu commented Nov 17, 2025

@copilot Please update cli doc. BTW, add Chinese version

Copy link
Contributor Author

Copilot AI commented Nov 17, 2025

@copilot Please update cli doc. BTW, add Chinese version

Updated CLI documentation and added Chinese version in commit 75d8c74.

Changes include:

  • CLI export tool: Updated --export-jobs to --db-parallelism and added --table-parallelism option
  • CLI import tool: Updated --import-jobs to --db-parallelism
  • Chinese translations for both SQL COPY DATABASE and CLI documentation

Copilot AI changed the title docs: add PARALLELISM option for COPY DATABASE docs: add PARALLELISM option for COPY DATABASE and CLI tools Nov 17, 2025
Copilot finished work on behalf of WenyXu November 17, 2025 13:35
@WenyXu
Copy link
Member

WenyXu commented Nov 18, 2025

@copilot Polish the text while respecting its original style and tone. Ensure English reads like native English, and Chinese reads like native Chinese. Keep technical content, formatting, and structure intact. Provide the polished version only.

Copy link
Contributor Author

Copilot AI commented Nov 18, 2025

@copilot Polish the text while respecting its original style and tone. Ensure English reads like native English, and Chinese reads like native Chinese. Keep technical content, formatting, and structur...

Could you please specify which text you'd like me to polish? I've updated the following files:

  • docs/reference/sql/copy.md (English SQL docs)
  • docs/reference/command-lines/utilities/data.md (English CLI docs)
  • i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/copy.md (Chinese SQL docs)
  • i18n/zh/docusaurus-plugin-content-docs/current/reference/command-lines/utilities/data.md (Chinese CLI docs)

Please let me know which section(s) need polishing, or if you'd like me to review and polish all the text I added.

@WenyXu
Copy link
Member

WenyXu commented Nov 18, 2025

@copilot Polish all text while respecting its original style and tone. Ensure English reads like native English, and Chinese reads like native Chinese. Keep technical content, formatting, and structure intact. Provide the polished version only.

Copy link
Contributor Author

Copilot AI commented Nov 18, 2025

@copilot Polish all text while respecting its original style and tone. Ensure English reads like native English, and Chinese reads like native Chinese. Keep technical content, formatting, and structur...

Polished all documentation text in commit 0935110.

English improvements:

  • More natural phrasing: "if a database contains 30 tables" instead of "if a database has 30 tables"
  • Clearer syntax: "set to 8" instead of just "is 8"
  • Simplified comments: "using 4 parallel operations" instead of "with 4 parallel table operations"

Chinese improvements:

  • More natural expressions: "数据库包含 30 个表且 PARALLELISM 设置为 8 时" (when database contains... and is set to...)
  • Removed unnecessary conditional words for better flow
  • Simplified action descriptions: "使用 4 个并行操作" instead of "使用 4 个并行表操作"

All technical content, formatting, and structure remain intact.

@WenyXu WenyXu marked this pull request as ready for review November 18, 2025 06:55
Copilot finished work on behalf of WenyXu November 18, 2025 06:56
Copy link
Contributor

@fengjiachun fengjiachun left a comment

Choose a reason for hiding this comment

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

LGTM

@WenyXu WenyXu merged commit 8da53c0 into main Nov 18, 2025
11 checks passed
@WenyXu WenyXu deleted the copilot/update-nightly-docs branch November 18, 2025 07:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update docs for feat: support parallel table operations in COPY DATABASE

4 participants