Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add postgres cdc guide to doc #3557

Open
wants to merge 8 commits into
base: main
Choose a base branch
from
Open

Add postgres cdc guide to doc #3557

wants to merge 8 commits into from

Conversation

lio-p
Copy link
Contributor

@lio-p lio-p commented Mar 26, 2025

Summary

Port the Postgres CDC blog to documentation

Checklist

@lio-p lio-p requested review from a team as code owners March 26, 2025 17:48
@lio-p lio-p requested a review from genzgd March 26, 2025 17:48
Copy link

vercel bot commented Mar 27, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
clickhouse-docs ✅ Ready (Inspect) Visit Preview Apr 8, 2025 1:01pm
2 Skipped Deployments
Name Status Preview Comments Updated (UTC)
clickhouse-docs-ru ⬜️ Ignored (Inspect) Visit Preview Apr 8, 2025 1:01pm
clickhouse-docs-zh ⬜️ Ignored (Inspect) Visit Preview Apr 8, 2025 1:01pm

Copy link
Member

@Blargian Blargian left a comment

Choose a reason for hiding this comment

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

LGTM, left some comments

@gingerwizard
Copy link
Contributor

@lio-p i thought the plan was to update https://clickhouse.com/docs/migrations/postgres/migrations/postgresql

@@ -944,3 +944,15 @@ kinesis
--docs/cloud/security/aws-privatelink.md--
GWLBs
NLBs
--docs/integrations/data-ingestion/clickpipes/postgres/joins_and_denormalization.md--
Clickpipes
Copy link
Contributor

Choose a reason for hiding this comment

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

this is an invalid spelling


The illustration below walks through a basic example of synchronization of a table `users` between PostgreSQL and ClickHouse using ClickPipes.

<Image img={clickpipes_initial_load} alt="Clickpipes initial load" size="lg" border/>
Copy link
Contributor

Choose a reason for hiding this comment

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

dont need border


Since Postgres is a relational database, its data model is heavily [normalized](https://en.wikipedia.org/wiki/Database_normalization), often involving hundreds of tables. In ClickHouse, denormalization can be beneficial at times to optimize JOIN performance. This page covers common JOINs tips and best practices to denormalize data.

### Optimizing JOINs {#optimizing-joins}
Copy link
Contributor

Choose a reason for hiding this comment

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

We have a guide here thats already dedicated. Ok with a little duplicatiom but point to the guide as well.

Peak memory usage: 5.44 GiB.
```

### Denormalization {#denormalization}
Copy link
Contributor

Choose a reason for hiding this comment

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

Again we have a dedicated guide @lio-p lets enhance the guide and link vs repeat

Copy link
Contributor

@gingerwizard gingerwizard left a comment

Choose a reason for hiding this comment

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

see both mine and @Blargian


Let’s look at what’s happening in ClickHouse when using a Materialized view with Postgres CDC.

<Image img={clickpipes_joins_mv} alt="Clickpipes Postgres JOINs MV" size="lg" border/>
Copy link
Contributor

Choose a reason for hiding this comment

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

no border

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.

3 participants