Tools/ClickHouse/clickhouse-go

clickhouse-go

Golang driver for ClickHouse

3.3k+2/wkemergingGoApache License 2.0trending

The Lens

By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.

Updated Sep 2026

ClickHouse is the database teams reach for when Postgres analytics queries start taking minutes. This is the official Go client, maintained by the ClickHouse team under Apache 2.0. It offers two ways in: a native interface that encodes columns directly, and a standard database/sql driver that drops into ORMs you already use. The native path is faster.

Nothing to operate, it is a library. What matters is the thing it talks to, and self-hosted ClickHouse is Apache 2.0 and free. The driver handles connection pooling, failover across addresses, and LZ4 or ZSTD compression with no extra config. Bulk and async inserts are first-class, because ClickHouse punishes row-at-a-time writes.

Use it if you write Go and touch ClickHouse. There is nothing to weigh it against: ch-go is the lower-level library this one builds on, not a competitor. Every team size gets the same thing for free. Cost appears only if you choose ClickHouse Cloud over running it yourself.

The catch is version churn. Recent releases test against only the two newest Go versions, so an old toolchain pins you to an old driver. Raw streaming for CSV, JSON and Parquet is still experimental and works over HTTP transport only.

Free vs Self-Hosted vs Paid

fully free

Free tier: The driver itself is Apache 2.0 with no paid edition, no license key, and no feature gates. Everything in it, native protocol, database/sql compatibility, connection pooling, failover, compression, JWT auth and async inserts, is in the open source release.

Self-hosted: ClickHouse server is Apache 2.0 and free to run yourself. The driver connects over native TCP (port 9000) or HTTP with no difference in licensing. Your cost is the infrastructure plus the operator time to keep a ClickHouse cluster healthy, which is not trivial once you pass a single node.

Paid: Only if you choose ClickHouse Cloud instead of self-hosting. Cloud meters compute and storage separately, scales unused compute toward zero, and pauses idle services. New organizations get trial credits that expire after 30 days. The same driver connects to Cloud, so this is a hosting decision, never a client-library one.

Free and Apache 2.0 forever. Costs only appear if you choose ClickHouse Cloud over self-hosting, and the driver is identical either way.

What to do by team size

Solo
free
Small team
free
Medium team
free
Large team
free
Self-hosting ops:trivial
View pricing page →

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Score
78/100 · B+
Adoption17/30
Maintenance25/25
Community11/20
License15/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

Trust Signals

Community discussions enabledOrganization account (376 public repos)Notable author: 2,020 followers

License: Apache License 2.0

Use freely. Patent grant included.

Commercial use: ✓ Yes

About

Owner
ClickHouse (Organization)
Stars
3,345
Forks
682

Explore Further

More tools in the directory