apache/druid

Apache Druid

Druid is a high performance real-time analytics database. Druid's main value add is to reduce time to insight and action.

Druid is designed for workflows where fast queries and ingest really matter. Druid excels at powering UIs, running operational (ad-hoc) queries, or handling high concurrency. *** Druid as an open source alternative to data warehouses for a variety of use cases. The https://druid.apache.org/docs/latest/design/architecture.html explains the key concepts.

Getting started

You can get started with Druid with our https://druid.apache.org/docs/latest/tutorials/quickstart.html or http://druid.apache.org/docs/latest/tutorials/docker.html quickstart. For Kubernetes deployments, the https://github.com/apache/druid-operator is maintained in a separate repository.

Druid provides a rich set of APIs (via HTTP and https://druid.apache.org/docs/latest/querying/sql.html#jdbc) for loading, managing, and querying your data. You can also interact with Druid via the built-in https://druid.apache.org/docs/latest/operations/web-console.html (shown below).

Load data

Load https://druid.apache.org/docs/latest/ingestion/index.html#streaming and https://druid.apache.org/docs/latest/ingestion/index.html#batch data using a point-and-click wizard to guide you through ingestion setup. Monitor one off tasks and ingestion supervisors.

Manage the cluster

Manage your cluster with ease. Get a view of your https://druid.apache.org/docs/latest/design/architecture.html, https://druid.apache.org/docs/latest/design/segments.html, https://druid.apache.org/docs/latest/ingestion/tasks.html, and https://druid.apache.org/docs/latest/design/processes.html from one convenient location. All powered by https://druid.apache.org/docs/latest/querying/sql.html#metadata-tables, allowing you to see the underlying query for each view.

Issue queries

Use the built-in query workbench to prototype https://druid.apache.org/docs/latest/querying/sql.html and https://druid.apache.org/docs/latest/querying/querying.html queries or connect one of the https://druid.apache.org/libraries.html that help you make the most out of Druid.

Documentation

See the https://druid.apache.org/docs/latest/ for the documentation for the current official release. If you need information on a previous release, you can browse https://druid.apache.org/docs/.

Make documentation and tutorials updates in https://github.com/apache/druid/tree/master/docs using https://www.markdownguide.org/ or extended Markdown (MDX). Then, open a pull request.

To build the site locally, you need Node 18 or higher and to install Docusaurus 3 with npm|yarn install in the website directory. Then you can run npm|yarn start to launch a local build of the docs.

If you're looking to update non-doc pages like Use Cases, those files are in the https://github.com/apache/druid-website-src/tree/master repo.

For more information, see the README in the ./website directory.

Community

Visit the official project https://druid.apache.org/community/ page to read about getting involved in contributing to Apache Druid, and how we help one another use and operate Druid.

• Druid users can find help in the https://groups.google.com/forum/#!forum/druid-user mailing list on Google Groups, and have more technical conversations in #troubleshooting on Slack.
• Druid development discussions take place in the https://lists.apache.org/list.html?*** mailing list (https://lists.apache.org/list.html?***). Subscribe by emailing ***. For live conversations, join the #dev channel on Slack.

Check out the official https://druid.apache.org/community/ page for details of how to join the community Slack channels.

Find articles written by community members and a calendar of upcoming events on the https://druid.apache.org/ - contribute your own events and articles by submitting a PR in the https://github.com/apache/druid-website-src/tree/master/_data repository.

Building from source

Please note that JDK 17 or JDK 21 is required to build Druid.

See the latest https://druid.apache.org/docs/latest/development/build.html for instructions on building Apache Druid from source.

Contributing

Please follow the https://druid.apache.org/community/ for contributing.

For instructions on setting up IntelliJ dev/intellij-setup.md

License

http://www.apache.org/licenses/LICENSE-2.0