Skip to content

docs: add Pub/Sub to ClickHouse Dataflow template docs#87

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/bd738d80
Open

docs: add Pub/Sub to ClickHouse Dataflow template docs#87
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/bd738d80

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 27, 2026

Summary

Ports ClickHouse/clickhouse-docs#6295, adding documentation for the new Pub/Sub to ClickHouse Google Dataflow template.

Changes

  • New page: integrations/connectors/data-ingestion/GCP/google-dataflow/templates/pubsub-to-clickhouse.mdx (slug preserved: /integrations/google-dataflow/templates/pubsub-to-clickhouse)
  • Added pubsub-inqueue-job.png image
  • Updated templates.mdx to link to the new template and remove the "coming soon" Pub/Sub entry
  • Updated dataflow.mdx to mention streaming ingestion from Pub/Sub
  • Updated bigquery-to-clickhouse.mdx template source code section to list both the upstream GCP repo and the ClickHouse fork
  • Added the new page to integrations/connectors/navigation.json

Notes / ambiguities

  • The source MDX used Docusaurus :::important and :::note admonitions plus a <TOCInline> import; these were converted to Mintlify <Warning> / <Note> components, and the TOC import was dropped (Mintlify renders the page TOC automatically).
  • Image imports (@theme/IdealImage) were replaced with the local <Image> snippet used elsewhere in this section.
  • HTML comment placeholders for missing screenshots were converted to MDX comments ({/* ... */}) and left in place — the source PR also leaves these as TODOs.
  • Relative links to ../../../sql-reference/data-types/* were rewritten to absolute Mintlify slugs under /core/reference/data-types/* to match the convention used in the sibling BigQuery template page.

Note

Low Risk
Documentation-only changes with no application, auth, or data-plane code.

Overview
Adds a full Pub/Sub to ClickHouse Dataflow template guide and wires it into the connectors docs so streaming ingestion is documented alongside the existing BigQuery template.

The new page documents JSON-to-table mapping (case-sensitive column names, type coercion, startup schema fetch), batching/windowing (windowSeconds / batchRowCount), dead-letter handling (ClickHouse table schema or Pub/Sub topic attributes), console run steps (with screenshot placeholders), PubSubToClickHouse metrics, and troubleshooting (memory 241, DLQ-only traffic, no rows). The overview and templates index now mention streaming from Pub/Sub; the templates list links the new page and drops the “coming soon” Pub/Sub entry. BigQuery template source links now point to both upstream GoogleCloudPlatform/DataflowTemplates and the ClickHouse fork. navigation.json registers the new page under Dataflow templates.

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

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 27, 2026

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

Project Status Preview Updated (UTC)
ClickHouse-docs 🟢 Ready View Preview May 27, 2026, 6:58 PM

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.

0 participants