Home

Awesome

ksqlDB JDBC Driver Build StatusCoverage Status

ksql-jdbc-driver is a Type 4 Java Database Connectivity (JDBC) driver that provides standard access to Apache Kafka via JDBC API.

The driver connects to the ksqlDB engine then, the engine translates those requests to Kafka requests.

Getting started

Building from source

Just clone the ksql-jdbc-driver repo and package it:

git clone https://github.com/mmolimar/ksql-jdbc-driver.git && cd ksql-jdbc-driver

sbt clean package

If you want to build a fat jar containing both classes and dependencies -for instance, to use it in a JDBC client such as SQuirrel SQL or whichever-, type the following:

sbt clean assembly

Running tests

To run unit and integration tests, execute the following:

sbt test it:test

Coverage

To know the test coverage of the driver:

sbt clean coverage test it:test coverageReport

Usage

As expected, the driver can be used as we are used to. So, in your application, register the driver (depending on your JVM), for example:

or

Connection URL

The URL has the form jdbc:ksql://[<username>:<password>@]<ksql-engine>:<port>[?<property1>=<value>&<property2>=<value>...]

where:

TODO's

Contribute

License

Released under the Apache License, version 2.0.