Skip to content

docs: port "achieving atomic inserts" knowledgebase page#105

Merged
Blargian merged 1 commit into
mainfrom
mintlify/fc33a9ed
Jun 2, 2026
Merged

docs: port "achieving atomic inserts" knowledgebase page#105
Blargian merged 1 commit into
mainfrom
mintlify/fc33a9ed

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Jun 2, 2026

Summary

Port the new knowledgebase/achieving-atomic-inserts.mdx page from ClickHouse/clickhouse-docs#6325 (and its precursor PR #6306) into the Mintlify site, including the latest wording adjustment.

Changes

  • Created resources/support-center/knowledge-base/data-import-export/achieving-atomic-inserts.mdx with Mintlify-compatible transforms:
    • <VerticalStepper headerLevel="h3"><Steps> / <Step> blocks
    • \{#anchor\} (escaped Docusaurus anchors) → {#anchor}
    • Adjusted internal links from /sql-reference/statements/alter/partition* to /core/reference/statements/alter/partition* to satisfy the broken-link checker (the target page has a slug: alias to the legacy path, but cross-links elsewhere in the repo use the /core/reference/... form).
  • Wired the new page into resources/support-center/navigation.json under data-import-export.
  • Applied the upstream wording change: "You can try it at [fiddle]" → "You can run the example below interactively using [fiddle]".

Context

The source page is brand-new upstream (added in ClickHouse/clickhouse-docs#6306, edited in #6325) and had no entry in _migration/slug-map.csv.

Ambiguity to flag

  • Category placement: I placed the page under data-import-export based on its Data Ingestion tag. Other plausible categories include data-management or performance-optimization — please reassign if a different bucket is preferred.
  • Slug-map entry: Since this is a new page, no slug-map row exists yet. The Docusaurus URL /knowledgebase/achieving-atomic-inserts will need a mapping/alias added in a follow-up if URL parity matters.

Note

Low Risk
Documentation-only addition with navigation wiring; no application or data-path changes.

Overview
Adds a new Support Center knowledge base article on atomic bulk loads and multi-table consistency in ClickHouse Cloud when multi-statement transactions are not available.

The page documents a staging-table + partition swap workflow (MOVE PARTITION, ATTACH PARTITION, REPLACE PARTITION), including Mintlify <Steps> formatting, links to /core/reference/statements/alter/partition, constraints, a fiddle example, and the updated fiddle intro wording from upstream.

Registers the page at the top of the Data Import & Export section in navigation.json.

Reviewed by Cursor Bugbot for commit a8a9cd6. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify mintlify Bot mentioned this pull request Jun 2, 2026
3 tasks
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Jun 2, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
ClickHouse-docs 🟢 Ready View Preview Jun 2, 2026, 9:00 AM

@Blargian Blargian merged commit 4e6c7a4 into main Jun 2, 2026
2 checks passed
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.

1 participant