JNSimba opened a new pull request, #3704:
URL: https://github.com/apache/doris-website/pull/3704

   ## Summary
   
   This PR contains two related doc changes for the **Continuous Load 
(Streaming Job)** feature under Data Loading:
   
   ### 1. Rename the two sync modes to make their real difference visible
   
   The old labels — **Table-Level Sync** vs **Database-Level Sync** (中文:表级同步 vs 
库级同步) — were misleading. Users naturally read them as "scope" (one table vs 
whole DB), but the real distinction is **who owns the target table's schema**:
   
   | Old | New |
   | --- | --- |
   | Table-Level Sync / 表级同步 | **SQL Mapping Sync / SQL 映射同步** |
   | Database-Level Sync / 库级同步 | **Auto Table Creation Sync / 自动建表同步** |
   
   The "database-level" one actually supports syncing a single table via 
`include_tables`, so the old naming caused confusion. The new naming highlights 
the real capability difference:
   
   - **SQL Mapping Sync**: Job + CDC Stream TVF (`INSERT INTO ... SELECT * FROM 
cdc_stream(...)`). Pre-created target table, column mapping / filtering / 
transformation, exactly-once.
   - **Auto Table Creation Sync**: native `FROM ... TO DATABASE ...` DDL. 
Auto-creates downstream tables on first sync, mirror replication, at-least-once.
   
   Page titles updated to `MySQL/PostgreSQL CDC with SQL Mapping` and 
`MySQL/PostgreSQL CDC with Auto Table Creation`; sidebar labels updated to `SQL 
Mapping Sync` and `Auto Table Creation Sync`. Cross-references in 
`continuous-load-overview.md`, `load-manual.md` and `cdc-stream.md` updated 
accordingly.
   
   ### 2. Restore the MySQL / PostgreSQL data source pages
   
   `docs/data-operate/import/data-source/mysql.md` and `postgresql.md` were 
originally added in #3600 but were dropped when `docs/` was rebuilt in a later 
refactor; the sidebar entries for them were also missing. This PR brings them 
back (with the new naming applied) and re-adds the sidebar entries in 
`versioned_sidebars/version-4.x-sidebars.json`.
   
   ## Scope
   
   37 files changed (4 trees × 7 docs renamed + 4 × 2 restored pages + 1 
sidebar):
   
   - `docs/` + `versioned_docs/version-4.x/` (EN)
   - `i18n/zh-CN/.../current/` + `i18n/zh-CN/.../version-4.x/` (ZH)
   
   ## Test plan
   
   - [ ] Build the site locally and confirm the renamed sidebar items appear 
under **Continuous Load → MySQL / PostgreSQL** as **SQL Mapping Sync** and 
**Auto Table Creation Sync** (EN) / **SQL 映射同步** and **自动建表同步** (ZH)
   - [ ] Verify the new **Data Source → MySQL / PostgreSQL** pages are 
accessible from the sidebar
   - [ ] Confirm internal cross-links (overview table, FAQ links, "see also" 
sections) all resolve


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to