Update Estuary integration docs with new connector

[aeluce]

Summary

Estuary now offers a materialization connector to ClickHouse that uses the native protocol and format. This PR updates docs to include the alternate option and provides an overview page to collect both options under a new sub-section.

Checklist

• Delete items not relevant to your PR
• URL changes should add a redirect to the old URL via https://github.com/ClickHouse/clickhouse-docs/blob/main/docusaurus.config.js
• If adding a new integration page, also add an entry to the integrations list here: https://github.com/ClickHouse/clickhouse-docs/blob/main/docs/integrations/index.mdx

---

Note

Low Risk
Documentation-only restructuring and new setup content; no application or infrastructure code changes in the diff.

Overview
Estuary integration docs are reorganized from one page into a small section: an overview at /integrations/estuary, a new direct native-protocol materialization guide at /integrations/estuary/native, and the existing Kafka ClickPipes flow moved to /integrations/estuary/clickpipes.

The overview explains when to use direct materialization vs ClickPipes and links to both paths. The native guide adds setup for ClickHouse permissions (including optional row policies), Estuary ClickHouse connector configuration, and collection/table options. The ClickPipes page is retitled and reframed around ClickHouse Kafka API (not generic “ClickHouse” connector), with cross-links to the native option; some ancillary resource bullets were trimmed.

sidebars.js replaces the single Estuary doc entry with a collapsible Estuary category listing index, native-protocol, and clickpipes.

^{Reviewed by Cursor Bugbot for commit 66e3989. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

@aeluce is attempting to deploy a commit to the ClickHouse Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clickhouse-docs	Ready	Preview	May 27, 2026 6:48pm