Need help with partiql-lang-kotlin?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

490 Stars 48 Forks Apache License 2.0 215 Commits 150 Opened issues


A implementation of PartiQL written in Kotlin.

Services available


Need anything else?

Contributors list

Maven Central Build Status codecov

PartiQL Lang Kotlin

This is a Kotlin implementation of the PartiQL specification. PartiQL is based on SQL-92 and has added support for working with schemaless hierarchical data. PartiQL’s extensions to SQL are easy to understand, treat nested data as first class citizens and compose seamlessly with each other and SQL.

This repository contains an embeddable reference interpreter, test framework, and tests for PartiQL in Kotlin.

The easiest way to get started with PartiQL is to clone this repository locally, build, then run the REPL.


PartiQL should be considered to be in "preview" status. It has been in use within a number of Amazon internal systems and an AWS product for over one year. The behavior of the language itself is mostly stable however the public API of the interpreter is slated to undergo significant improvements in the near term. (See the GitHub issues list for details.)

Using In Your Project

This project is published to Maven Central.

| Group ID | Artifact ID | Recommended Version | |----------|-------------|---------------------| |


For Maven builds, add this to your


For Gradle 5 and later, add this to your

repositories {

dependencies { implementation "org.partiql:partiql-lang-kotlin:{version}" }

Be sure to replace

with the desired version.


To build this project, clone this repository and from its root directory execute:

$./gradlew build

This will build the reference interpreter and test framework, then run all unit and integration tests.

Building the documentation

Instructions on how to build PartiQL's documentation

Directory Structure

  • docs/user
    documentation for developers embedding the interpreter in an application.
  • docs/dev
    documentation for developers of the interpreter library.
  • lang
    contains the source code of the library containing the interpreter.
  • lang/jmh
    contains the JMH benchmarks for PartiQL.
  • cli
    contains the source code of the command-line interface and interactive prompt. (CLI/REPL)
  • testframework
    contains the source code of the integration test framework.
  • integration-test/test-scripts
    contains the test scripts executed by the test framework as part of the Gradle build.
  • integration-test/test-scripts-ignored
    contains test scripts which cannot be executed during the Gradle build.

Running JMH benchmarks

To run JMH benchmarks located in

, build the entire project first and then run the following command:
$./gradlew jmh


See the examples project in this repository for examples covering use of the PartiQL interpreter in your project.




This the works contained within this repository are licensed under the Apache 2.0 License.

See the LICENSE file.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.