Apache Druid: a high performance real-time analytics database.
Go to file
Victoria Lim ede9903ff4
pip install for Python Druid API (#13938)
Broken test appears unrelated to this PR

* make druidapi pip installable

* include druidapi in prerequisites

* add license to setup.py

* updates from Paul's review

* note about editable install

* Apply suggestions from code review

Co-authored-by: 317brian <53799971+317brian@users.noreply.github.com>

* update install instructions

* found unrelated typos

* standardize install cmd with pip

---------

Co-authored-by: 317brian <53799971+317brian@users.noreply.github.com>
2023-03-21 11:37:39 -07:00
.github Fix error in cron job ITs workflow (#13945) 2023-03-17 17:29:45 +05:30
.idea merge druid-core, extendedset, and druid-hll into druid-processing to simplify everything (#13698) 2023-02-17 14:27:41 -08:00
benchmarks better FrontCodedIndexed (#13854) 2023-03-14 18:14:11 -07:00
cloud merge druid-core, extendedset, and druid-hll into druid-processing to simplify everything (#13698) 2023-02-17 14:27:41 -08:00
codestyle Removing the forbidden check on getOrDefault due to java8 incompatibility. (#13920) 2023-03-11 09:49:32 +05:30
dev Make http options the default configurations (#13092) 2022-10-05 05:35:17 +05:30
distribution Upgrade ZK from 3.5.9 to 3.5.10 to avoid data inconsistency risk (#13715) 2023-03-15 19:21:09 +05:30
docs Correct nested columns JSON example (#13953) 2023-03-21 09:17:26 -07:00
examples pip install for Python Druid API (#13938) 2023-03-21 11:37:39 -07:00
extensions-contrib Avoid creating new RelDataTypeFactory during SQL planning. (#13904) 2023-03-08 21:55:49 -08:00
extensions-core Lower default maxRowsInMemory for realtime ingestion. (#13939) 2023-03-21 10:36:36 -07:00
helm/druid helm: Add serviceAccounts, rbac, and small fixes (#13747) 2023-02-23 11:42:03 +05:30
hooks Git hooks should fail on errors; pass args to git hooks (#12322) 2022-03-10 09:07:50 +09:00
indexing-hadoop Lower default maxRowsInMemory for realtime ingestion. (#13939) 2023-03-21 10:36:36 -07:00
indexing-service Lower default maxRowsInMemory for realtime ingestion. (#13939) 2023-03-21 10:36:36 -07:00
integration-tests add latest version of druid operator to integeration tests (#13883) 2023-03-10 16:11:25 +05:30
integration-tests-ex Update container creation in AzureTestUtil.java (#13911) 2023-03-16 11:04:43 +05:30
licenses Upgrade typescript and other dependencies (#13762) 2023-02-06 23:12:54 -08:00
processing better FrontCodedIndexed (#13854) 2023-03-14 18:14:11 -07:00
publications De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
server Lower default maxRowsInMemory for realtime ingestion. (#13939) 2023-03-21 10:36:36 -07:00
services Improve memory efficiency of WrappedRoaringBitmap. (#13889) 2023-03-09 15:48:02 -08:00
sql Change test name so it triggers in CI (#13844) 2023-03-20 15:55:52 +05:30
web-console Dart sass (#13937) 2023-03-16 12:44:24 -07:00
website Improve memory efficiency of WrappedRoaringBitmap. (#13889) 2023-03-09 15:48:02 -08:00
.asf.yaml Add .asf.yaml. (#9083) 2019-12-20 16:45:38 -08:00
.backportrc.json Add 0.18.0 to .backportrc.json to facilitate backport. (#9661) 2020-04-11 13:49:04 -07:00
.codecov.yml Use Codecov (#8388) 2019-08-28 08:49:30 -07:00
.dockerignore Add docker container for druid (#6896) 2019-02-08 12:12:28 +00:00
.gitignore pip install for Python Druid API (#13938) 2023-03-21 11:37:39 -07:00
.lgtm.yml be consistent about referring to the web console by its name (#13118) 2022-09-19 15:02:17 -07:00
CONTRIBUTING.md Add missing MSQ error code fields to docs (#13308) 2022-11-10 21:03:04 +05:30
LABELS Add plain text README.txt, use relative link from README.md to build.md (#7611) 2019-05-09 21:29:26 -07:00
LICENSE merge druid-core, extendedset, and druid-hll into druid-processing to simplify everything (#13698) 2023-02-17 14:27:41 -08:00
NOTICE Update year in the notice file and the release process instructions (#12622) 2022-08-23 18:17:18 +05:30
README.md be consistent about referring to the web console by its name (#13118) 2022-09-19 15:02:17 -07:00
README.template De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
check_test_suite.py remove Travis CI (#13789) 2023-02-10 01:46:56 -08:00
check_test_suite_test.py remove Travis CI (#13789) 2023-02-10 01:46:56 -08:00
it.sh Bump CycloneDX module to address POM errors (#13878) 2023-03-03 15:39:15 +05:30
licenses.yaml Upgrade ZK from 3.5.9 to 3.5.10 to avoid data inconsistency risk (#13715) 2023-03-15 19:21:09 +05:30
owasp-dependency-check-suppressions.xml Suppress CVEs (#13733) 2023-02-01 04:18:41 -08:00
pom.xml Upgrade ZK from 3.5.9 to 3.5.10 to avoid data inconsistency risk (#13715) 2023-03-15 19:21:09 +05:30
upload.sh Adding licenses and enable apache-rat-plugin. (#6215) 2018-09-18 08:39:26 -07:00

README.md

Build Status Language grade: Java Coverage Status Docker Helm


Website | Twitter | Download | Get Started | Documentation | Community | Build | Contribute | License


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. Consider Druid as an open source alternative to data warehouses for a variety of use cases. The design documentation explains the key concepts.

Getting started

You can get started with Druid with our local or Docker quickstart.

Druid provides a rich set of APIs (via HTTP and JDBC) for loading, managing, and querying your data. You can also interact with Druid via the built-in web console (shown below).

Load data

data loader Kafka

Load streaming and batch data using a point-and-click wizard to guide you through ingestion setup. Monitor one off tasks and ingestion supervisors.

Manage the cluster

management

Manage your cluster with ease. Get a view of your datasources, segments, ingestion tasks, and services from one convenient location. All powered by SQL systems tables, allowing you to see the underlying query for each view.

Issue queries

query view combo

Use the built-in query workbench to prototype DruidSQL and native queries or connect one of the many tools that help you make the most out of Druid.

Documentation

See the latest documentation for the documentation for the current official release. If you need information on a previous release, you can browse previous releases documentation.

Make documentation and tutorials updates in /docs using MarkDown and contribute them using a pull request.

Community

Visit the official project 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 druid-user mailing list on Google Groups, and have more technical conversations in #troubleshooting on Slack.
  • Druid development discussions take place in the druid-dev mailing list (dev@druid.apache.org). Subscribe by emailing dev-subscribe@druid.apache.org. For live conversations, join the #dev channel on Slack.

Check out the official 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 project site - contribute your own events and articles by submitting a PR in the apache/druid-website-src repository.

Building from source

Please note that JDK 8 or JDK 11 is required to build Druid.

See the latest build guide for instructions on building Apache Druid from source.

Contributing

Please follow the community guidelines for contributing.

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

License

Apache License, Version 2.0