Back
ClickHouse Wrapper

ClickHouse Wrapper

Overview

ClickHouse is an open-source column-oriented database built for real-time analytics at scale. It delivers sub-second query performance over billions of rows, supports full read/write SQL, and is used by companies like Tesla, GitLab, and Cloudflare for observability, analytics, and AI workloads.

The ClickHouse Wrapper brings your ClickHouse tables into Postgres as queryable foreign tables. Read and write ClickHouse data with plain SQL and join it against your application data. Supports aggregate pushdown so queries run on ClickHouse rather than locally, and works with Supabase Vault for secure connection string management.

Supported Operations

ObjectSelectInsertUpdateDelete
Tables

Supported Data Types

Postgres TypeClickHouse Type
booleanBool
"char"Int8
smallintUInt8, Int16
integerUInt16, Int32
bigintUInt32, Int64, UInt64
realFloat32
double precisionFloat64
numericDecimal, UInt128, Int128
textString, FixedString(N), UInt256, Int256
dateDate
timestampDateTime
uuidUUID
boolean[]Array(Boolean)
smallint[]Array(Int16)
integer[]Array(Int32)
bigint[]Array(Int64)
real[]Array(Float32)
double precision[]Array(Float64)
text[]Array(String)
anyNullable(T)

Resources

Details

DeveloperSupabase
DocumentationLearn

Third-party integrations and docs are managed by Supabase partners.

Get started with ClickHouse Wrapper and Supabase.