The database purpose-built for stream processing applications
ksqlDB is a database for building stream processing applications on top of Apache Kafka. It is distributed, scalable, reliable, and real-time. ksqlDB combines the power of real-time stream processing with the approachable feel of a relational database through a familiar, lightweight SQL syntax. ksqlDB offers these core primitives:
- Streams and tables - Create relations with schemas over your Apache Kafka topic data
- Materialized views - Define real-time, incrementally updated materialized views over streams using SQL
- Push queries- Continuous queries that push incremental results to clients in real time
- Pull queries - Query materialized views on demand, much like with a traditional database
- Connect - Integrate with any Kafka Connect data source or sink, entirely from within ksqlDB
Composing these powerful primitives enables you to build a complete streaming app with just SQL statements, minimizing complexity and operational overhead. ksqlDB supports a wide range of operations including aggregations, joins, windowing, sessionization, and much more. You can find more ksqlDB tutorials and resources here.
- Follow the ksqlDB quickstart to get started in just a few minutes.
- Read through the ksqlDB documentation.
- Take a look at some ksqlDB tutorials for examples of common patterns.
See the ksqlDB documentation for the latest stable release.
Use Cases and Examples
ksqlDB allows you to define materialized views over your streams and tables. Materialized views are defined by what is known as a "persistent query". These queries are known as persistent because they maintain their incrementally updated results using a table.
CREATE TABLE hourly_metrics AS SELECT url, COUNT(*) FROM page_views WINDOW TUMBLING (SIZE 1 HOUR) GROUP BY url EMIT CHANGES;
Results may be "pulled" from materialized views on demand via
SELECT queries. The following query will return a single row:
SELECT * FROM hourly_metrics WHERE url = 'http://myurl.com' AND WINDOWSTART = '2019-11-20T19:00';
Results may also be continuously "pushed" to clients via streaming
SELECT queries. The following streaming query will push to the client all incremental changes made to the materialized view:
SELECT * FROM hourly_metrics EMIT CHANGES;
Streaming queries will run perpetually until they are explicitly terminated.
Apache Kafka is a popular choice for powering data pipelines. ksqlDB makes it simple to transform data within the pipeline, readying messages to cleanly land in another system.
CREATE STREAM vip_actions AS SELECT userid, page, action FROM clickstream c LEFT JOIN users u ON c.userid = u.user_id WHERE u.level = 'Platinum' EMIT CHANGES;
ksqlDB is a good fit for identifying patterns or anomalies on real-time data. By processing the stream as data arrives you can identify and properly surface out of the ordinary events with millisecond latency.
CREATE TABLE possible_fraud AS SELECT card_number, count(*) FROM authorization_attempts WINDOW TUMBLING (SIZE 5 SECONDS) GROUP BY card_number HAVING count(*) > 3 EMIT CHANGES;
Kafka's ability to provide scalable ordered records with stream processing make it a common solution for log data monitoring and alerting. ksqlDB lends a familiar syntax for tracking, understanding, and managing alerts.
CREATE TABLE error_counts AS SELECT error_code, count(*) FROM monitoring_stream WINDOW TUMBLING (SIZE 1 MINUTE) WHERE type = 'ERROR' GROUP BY error_code EMIT CHANGES;
Integration with External Data Sources and Sinks
The following query is a simple persistent streaming query that will produce all of its output into a topic named
CREATE STREAM clicks_transformed AS SELECT userid, page, action FROM clickstream c LEFT JOIN users u ON c.userid = u.user_id EMIT CHANGES;
Rather than simply send all continuous query output into a Kafka topic, it is often very useful to route the output into another datastore. ksqlDB's Kafka Connect integration makes this pattern very easy.
The following statement will create a Kafka Connect sink connector that continuously sends all output from the above streaming ETL query directly into Elasticsearch:
CREATE SINK CONNECTOR es_sink WITH ( 'connector.class' = 'io.confluent.connect.elasticsearch.ElasticsearchSinkConnector', 'key.converter' = 'org.apache.kafka.connect.storage.StringConverter', 'topics' = 'clicks_transformed', 'key.ignore' = 'true', 'schema.ignore' = 'true', 'type.name' = '', 'connection.url' = 'http://elasticsearch:9200');
Join the Community
You can get help, learn how to contribute to ksqlDB, and find the latest news by connecting with the Confluent community.
For more general questions about the Confluent Platform please post in the Confluent Google group.
Contributing and building from source
Contributions to the code, examples, documentation, etc. are very much appreciated.
- Report issues and bugs directly in this GitHub project.
- Learn how to work with the ksqlDB source code, including building and testing ksqlDB as well as contributing code changes to ksqlDB by reading our Development and Contribution guidelines.
- One good way to get started is by tackling a newbie issue.
The project is licensed under the Confluent Community License.
Apache, Apache Kafka, Kafka, and associated open source project names are trademarks of the Apache Software Foundation.