{"full_name":"ClickHouse/pg_clickhouse","owner":"ClickHouse","name":"pg_clickhouse","shard":"1","url":"https://github.com/ClickHouse/pg_clickhouse","description":"Interfaces to query ClickHouse databases from PostgreSQL","homepage":"","topics":["clickhouse","fdw","postgresql","sql"],"tag_pages":["clickhouse","postgresql","sql"],"language":"C","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/54801242?v=4","created_at":"2025-09-23T22:50:39Z","pushed_at":"2026-11-16T17:58:13Z","metrics":{"stars":300,"forks":23,"watchers":1,"issues":86,"prs":369,"releases":17,"issues_open":30,"issues_closed":56,"prs_open":20,"prs_closed":24,"prs_merged":325,"discussions":0},"growth":{},"history":{"dates":["2026-11-17"],"stars":[300],"forks":[23],"watchers":[1],"issues_open":[30],"prs_open":[20]},"boards":{},"same_owner":[{"full_name":"ClickHouse/ClickHouse","name":"ClickHouse","shard":"1","boards":{}}],"issues":[{"number":276,"title":"ORDER BY pushdown ignores sort-order semantics mismatch (text collation, UUID) — merge joins fail with \"mergejoin input data is out of order\", wrong-results risk","comments":3,"created_at":"2026-06-13T00:32:19Z"},{"number":49,"title":"Support All Data Types","comments":2,"created_at":"2025-11-19T16:17:08Z"},{"number":409,"title":"round(avg(int), n) pushed down rounds ties to even; Postgres rounds them away from zero","comments":1,"created_at":"2026-10-14T10:41:11Z"},{"number":383,"title":"Document how to correlate a foreign scan with `system.query_log`","comments":1,"created_at":"2026-09-27T02:55:47Z"},{"number":294,"title":"Add support for asynchronous fetching, the `async_capable` table option","comments":1,"created_at":"2026-06-24T14:33:59Z"},{"number":248,"title":"Support JSON/JSONB  #> array and  #>> array path operators","comments":1,"created_at":"2026-05-11T20:57:08Z"},{"number":83,"title":"Add Session Settings to `FOREIGN SERVER`s and `USER MAPPING`s","comments":1,"created_at":"2025-12-10T19:21:53Z"},{"number":79,"title":"Improve Subquery Joins","comments":1,"created_at":"2025-12-10T18:49:32Z"}],"discussions":[],"latest_release":{"name":"Release v0.11.1","tag":"v0.11.1","published_at":"2026-11-09T15:30:42Z","body":"This release makes binary-only changes. Once installed, any existing use of pg_clickhouse v0.11 will get its benefits on reload without needing to `ALTER EXTENSION UPDATE`.\r\n\r\n### 🚨 Compatibility\r\n\r\n*   Changed the default driver from \"http\" to \"binary\". Use `OPTIONS(driver 'http')` to restore use of the HTTP driver if needed.\r\n*   Changed `pg_clickhouse.session_settings` to override built-in settings by key rather than replace them. It now defaults to an empty string, and pg_clickhouse always sends `join_use_nulls 1, group_by_use_nulls 1, final 1, transform_null_in 0` unless overridden. Setting it to an empty string no longer drops these settings ([#412]).\r\n\r\n### ⚡ Improvements\r\n\r\n*   Added pushdown for more regression aggregate functions on ClickHouse 26.9+:\r\n    *   [regr_avgx]\r\n    *   [regr_avgy]\r\n    *   [regr_count]\r\n    *   [regr_intercept]\r\n    *   [regr_r2]\r\n    *   [regr_slope]\r\n    *   [regr_sxx]\r\n    *   [regr_sxy]\r\n    *   [regr_syy]\r\n*   Added pushdown support for [pgvector] `vector` columns stored in ClickHouse as `Array(Float32)`, `Array(Float64)`, and `Array(BFloat16)` columns. `vector` constants and parameters push down as `Array(Float32)`, and the pgvector `=` and `<>` operators also push down ([#410]).\r\n*   Added pushdown of the [pgvector] distance operators `<->`, `<=>`, `<#>`, and `<+>`, as well as the `l2_distance`, `cosine_distance`, `inner_product`, `l1_distance`, and `vector_dims` functions, to allow nearest-neighbor queries sort and limit in ClickHouse. `<#>` sorts as `dotProduct(...) DESC`, the form ClickHouse vector similarity indexes serve, and requires ClickHouse 23.8 or later ([#411]).\r\n*   Added the `settings` option for foreign servers and foreign tables to send [ClickHouse settings] with foreign table queries and inserts. Uses [`pg_clickhouse.session_settings` syntax]. Table settings override server settings, and `pg_clickhouse.session_settings` overrides both for matching keys. Includes a warning for certain settings unsupported by older servers (currently vector search settings) ([#412]).\r\n*   Added pushdown the math operators `^`, `|/`, `||/`, `@`, `&`, `|`, `#`, `~`, `<<`, and `>>` ([#443]).\r\n*   Added vector index reporting for pgvector nearest neighbor searches. `EXPLAIN` shows the ClickHouse vector similarity index a search can use, or why ClickHouse will compare every row instead. Planner warnings report `ORDER BY` or `LIMIT` clauses that prevent index use. Set `pg_clickhouse.vector_planner_warnings` to false to silence them ([#414]).\r\n*   Added pushdown of `jsonb` subscripts with constant text keys, such as `data['a']['b']`, as ClickHouse JSON sub-column dot notation. Numeric text subscripts evaluate locally to preserve array indexing ([#456]).\r\n*   Added `UPDATE` and `DELETE` on foreign tables backed by MergeTree family tables, run as a single ClickHouse lightweight `UPDATE` or `DELETE` statement. Statements that cannot run entirely in ClickHouse, such as those with `RETURNING`, joins, or conditions that require Postgres, raise an error. `UPDATE` requires ClickHouse 25.7+ ([#458]).\r\n*   Added support for `TRUNCATE` on foreign tables. Sends one ClickHouse `TRUNCATE TABLE` statement per table ([#463]).\r\n\r\n### 🚀 Distribution\r\n\r\n*   Added Postgres 19rc1 OCI image.\r\n*   Added [CloudNativePG] extension images.\r\n\r\n### 📚 Documentation\r\n\r\n*   Expanded the [Tuple] section of the documentation to describe and provide examples for mapping to arrays of field values, and to link to the section that covers using composite types ([#460]).\r\n*   Added a link to the [Manual Type Mappings] section to the [Map] documentation and clarified support for inserting composite values ([#460]).\r\n*   Updated the [Manual Type Mappings] section of the docs to describe and provide an example of inserting composite types mapped to [Map], [Tuple], and [Nested] columns ([#460]).\r\n\r\n### 🐞 Bug Fixes\r\n\r\n*   Fixed unconstrained numeric casts and parameters to use `Decimal(76, 38)`, widening `Float32` before casting to pr","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-17T10:29:19Z","history_start":"2026-09-06"}