Skip to main content

Proton

Proton – An open-source, fast and lightweight streaming SQL engine, 🚀 powered by ClickHouse

A streaming SQL engine, fast and lightweight

📄 Documentation   🚀 Live Demo   🌎 Timeplus

    Release  YouTube  Slack  follow on LinkedIn  Twitter(X)  License 

Why Use Proton · Demo Video · Deployment · What's Next · Integrations · Contributing · Need help?

Proton is a streaming SQL engine, a fast and lightweight alternative to Apache Flink, 🚀 powered by ClickHouse. It enables developers to solve streaming data processing, routing and analytics challenges from Apache Kafka, Redpanda and more sources, and send aggregated data to the downstream systems. Proton is the core engine of Timeplus, which is a cloud native streaming analytics platform.

💪 Why use Proton?​

  1. Apache Flink or ksqlDB alternative. Proton provides powerful streaming SQL functionalities, such as streaming ETL, tumble/hop/session windows, watermarks, materialized views, CDC and data revision processing, etc.
  2. Fast. Proton is written in C++, with optimized performance through SIMD. For example, on an Apple MacBookPro with M2 Max, Proton can deliver 90 million EPS, 4 millisecond end-to-end latency, and high cardinality aggregation with 1 million unique keys.
  3. Lightweight. Proton is a single binary (<500MB). No JVM or any other dependencies. You can also run it with Docker, or on an AWS t2.nano instance (1 vCPU and 0.5 GiB memory).
  4. Powered by the fast, resource efficient and mature ClickHouse. Proton extends the historical data, storage, and computing functionality of ClickHouse with stream processing. Thousands of SQL functions are available in Proton. Billions of rows are queried in milliseconds.
  5. Best streaming SQL engine for Kafka or Redpanda. Query the live data in Kafka or other compatible streaming data platforms, with external streams.

Proton Architecture See our architecture doc for technical details and our FAQ for more information.

🎬 Demo Video​

⚡ Deployment​

A single binary:​

curl https://install.timeplus.com | sh

For Mac users, you can also use Homebrew to manage the install/upgrade/uninstall:

brew tap timeplus-io/timeplus
brew install proton

Docker:​

docker run -d --pull always --name proton ghcr.io/timeplus-io/proton:latest

In case you cannot access ghcr, you can pull the image from public.ecr.aws/timeplus/proton

Docker Compose:​

The Docker Compose stack demonstrates how to read/write data in Kafka/Redpanda with external streams.

Timeplus Cloud:​

One step to try Proton in Timeplus Cloud

🔎 Usage​

From proton client, run the following SQL to create a stream of random data:

-- Create a stream with random data
CREATE RANDOM STREAM devices(
  device string default 'device'||to_string(rand()%4), 
  temperature float default rand()%1000/10)
-- Run the streaming SQL
SELECT device, count(*), min(temperature), max(temperature) 
FROM devices GROUP BY device

You should see data like the following:

┌─device──┬─count()─┬─min(temperature)─┬─max(temperature)─┐
│ device0 │    2256 │                0 │             99.6 │
│ device1 │    2260 │              0.1 │             99.7 │
│ device3 │    2259 │              0.3 │             99.9 │
│ device2 │    2225 │              0.2 │             99.8 │
└─────────┴─────────┴──────────────────┴──────────────────┘

⏩ What's next?​

To see more examples of using Proton, check out the examples folder.

To access more features, such as sources, sinks, dashboards, alerts, data lineage, create a workspace on Timeplus Cloud or try the live demo with pre-built live data and dashboards.

🧩 Integrations​

The following drivers are available:

Integrations with other systems:

Contributing​

We welcome your contributions! If you are looking for issues to work on, try looking at the issue list.

Please see the wiki for more details, and BUILD.md to compile Proton in different platforms.

We also encourage you to join our Timeplus Community Slack to ask questions and meet other active contributors from Timeplus and beyond.

Need help?​

Join our Timeplus Community Slack to connect with Timeplus engineers and other Proton users.

For filing bugs, suggesting improvements, or requesting new features, see the open issues here on GitHub.

Licensing​

Proton uses Apache License 2.0. See details in the LICENSE.