Skip to content

Update pg_clickhouse docs for v0.1.2 #5175

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.

Sign up for GitHub

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

Merged
Blargian merged 1 commit into from
Jan 9, 2026
Merged

Update pg_clickhouse docs for v0.1.2 #5175

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
99 changes: 51 additions & 48 deletions docs/integrations/tools/data-integration/pg_clickhouse/introduction.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,42 +40,45 @@ queries.

This table compares [TPC-H] query performance between regular PostgreSQL
tables and pg_clickhouse connected to ClickHouse, both loaded at scaling
factor 1; ✅ indicates full pushdown, while a dash indicates a query
factor 1; ✔︎ indicates full pushdown, while a dash indicates a query
cancellation after 1m. All tests run on a MacBook Pro M4 Max with 36 GB of
memory.

| Query | Pushdown | pg_clickhouse | PostgreSQL |
| ---------: | :------: | ------------: | ---------: |
| [Query 1] | ✅ | 73ms | 4478ms |
| [Query 2] | | - | 560ms |
| [Query 3] | ✅ | 74ms | 1454ms |
| [Query 4] | ✅ | 67ms | 650ms |
| [Query 5] | ✅ | 104ms | 452ms |
| [Query 6] | ✅ | 42ms | 740ms |
| [Query 7] | ✅ | 83ms | 633ms |
| [Query 8] | ✅ | 114ms | 320ms |
| [Query 9] | ✅ | 136ms | 3028ms |
| [Query 10] | ✅ | 10ms | 6ms |
| [Query 11] | ✅ | 78ms | 213ms |
| [Query 12] | ✅ | 37ms | 1101ms |
| [Query 13] | | 1242ms | 967ms |
| [Query 14] | ✅ | 51ms | 193ms |
| [Query 15] | | 522ms | 1095ms |
| [Query 16] | | 1797ms | 492ms |
| [Query 17] | | 9ms | 1802ms |
| [Query 18] | | 10ms | 6185ms |
| [Query 19] | | 532ms | 64ms |
| [Query 20] | | 4595ms | 473ms |
| [Query 21] | | 1702ms | 1334ms |
| [Query 22] | | 268ms | 257ms |
<!-- cd dev/tpch && make ch && make pg && make run -->

| Query | PostgreSQL | pg_clickhouse | Pushdown |
| ----------:| ----------:| -------------:|:--------:|
| [Query 1] | 4693 ms | 268 ms | ✔︎ |
| [Query 2] | 458 ms | 3446 ms | |
| [Query 3] | 742 ms | 111 ms | ✔︎ |
| [Query 4] | 270 ms | 130 ms | ✔︎ |
| [Query 5] | 337 ms | 1460 ms | ✔︎ |
| [Query 6] | 764 ms | 53 ms | ✔︎ |
| [Query 7] | 619 ms | 96 ms | ✔︎ |
| [Query 8] | 342 ms | 156 ms | ✔︎ |
| [Query 9] | 3094 ms | 298 ms | ✔︎ |
| [Query 10] | 581 ms | 197 ms | ✔︎ |
| [Query 11] | 212 ms | 24 ms | ✔︎ |
| [Query 12] | 1116 ms | 84 ms | ✔︎ |
| [Query 13] | 958 ms | 1368 ms | |
| [Query 14] | 181 ms | 73 ms | ✔︎ |
| [Query 15] | 1118 ms | 557 ms | |
| [Query 16] | 497 ms | 1714 ms | |
| [Query 17] | 1846 ms | 32709 ms | |
| [Query 18] | 5823 ms | 10649 ms | |
| [Query 19] | 53 ms | 206 ms | ✔︎ |
| [Query 20] | 421 ms | - | |
| [Query 21] | 1349 ms | 4434 ms | |
| [Query 22] | 258 ms | 1415 ms | |

### Compile From Source {#compile-from-source}

#### General Unix {#general-unix}

The PostgreSQL and curl development packages include `pg_config` and
`curl-config` in the path, so you should be able to just run `make` (or
`gmake`), then `make install`, then in your database `CREATE EXTENSION http`.
`gmake`), then `make install`, then in your database
`CREATE EXTENSION pg_clickhouse`.

#### Debian / Ubuntu / APT {#debian--ubuntu--apt}

Expand Down Expand Up @@ -301,25 +304,25 @@ adding DML features. Our road map:
[LibSSL]: https://openssl-library.org "OpenSSL Library"
[TPC-H]: https://www.tpc.org/tpch/

[Query 1]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/1.sql
[Query 2]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/2.sql
[Query 3]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/3.sql
[Query 4]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/4.sql
[Query 5]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/5.sql
[Query 6]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/6.sql
[Query 7]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/7.sql
[Query 8]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/8.sql
[Query 9]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/9.sql
[Query 10]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/10.sql
[Query 11]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/11.sql
[Query 12]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/12.sql
[Query 13]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/13.sql
[Query 14]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/14.sql
[Query 15]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/15.sql
[Query 16]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/16.sql
[Query 17]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/17.sql
[Query 18]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/18.sql
[Query 19]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/19.sql
[Query 20]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/20.sql
[Query 21]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/21.sql
[Query 22]: https://github.com/Vonng/pgtpc/blob/master/tpch/queries/22.sql
[Query 1] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/1.sql
[Query 2] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/2.sql
[Query 3] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/3.sql
[Query 4] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/4.sql
[Query 5] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/5.sql
[Query 6] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/6.sql
[Query 7] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/7.sql
[Query 8] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/8.sql
[Query 9] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/9.sql
[Query 10] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/10.sql
[Query 11] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/11.sql
[Query 12] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/12.sql
[Query 13] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/13.sql
[Query 14] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/14.sql
[Query 15] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/15.sql
[Query 16] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/16.sql
[Query 17] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/17.sql
[Query 18] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/18.sql
[Query 19] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/19.sql
[Query 20] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/20.sql
[Query 21] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/21.sql
[Query 22] https://github.com/ClickHouse/pg_clickhouse/blob/main/dev/tpch/queries/22.sql
Loading