Skip to content

Repository files navigation

ClickHouse Fiddle

ClickHouse Fiddle allows running SQL queries from a browser without having a database instance on the user's side. It allows to run any queries in arbitrary ClickHouse version and share the execution results with others.

Try it out: fiddle.clickhouse.com.

You can read about the motivation and more technicalities at the About page.

Architecture overview


architecture overview

There is a coordinator that creates a Docker container with a desired ClickHouse version for every incoming user request. Containers are created on runners, these can be both remote servers and the local system.

When the execution finishes (or force stopped due to timeouts), the result is saved in a query storage and is returned to the user. The saved result can be accessed by the generated ID.

Users communicate with the playground using REST API.

Repository layout


  • cmd/, internal/, pkg/ — Go backend and API.
  • ui/ — React/TypeScript web application. See its README for local UI commands.
  • deploy/ — production and local Docker Compose configurations.

Useful links



Originally created by Igor Baliuk @lodthe.

About

On-demand ClickHouse playground

Topics

Resources

Stars

74 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages