Apache Druid: a high performance real-time analytics database.
Go to file
Gian Merlino 6c5a43106a
SQL: Morph QueryMakerFactory into SqlEngine. (#12897)
* SQL: Morph QueryMakerFactory into SqlEngine.

Groundwork for introducing an indexing-service-task-based SQL engine
under the umbrella of #12262. Also includes some other changes related
to improving error behavior.

Main changes:

1) Elevate the QueryMakerFactory interface (an extension point that allows
   customization of how queries are made) into SqlEngine. SQL engines
   can influence planner behavior through EngineFeatures, and can fully
   control the mechanics of query execution using QueryMakers.

2) Remove the server-wide QueryMakerFactory choice, in favor of the choice
   being made by the SQL entrypoint. The indexing-service-task-based
   SQL engine would be associated with its own entrypoint, like
   /druid/v2/sql/task.

Other changes:

1) Adjust DruidPlanner to try either DRUID or BINDABLE convention based
   on analysis of the planned rels; never try both. In particular, we
   no longer try BINDABLE when DRUID fails. This simplifies the logic
   and improves error messages.

2) Adjust error message "Cannot build plan for query" to omit the SQL
   query text. Useful because the text can be quite long, which makes it
   easy to miss the text about the problem.

3) Add a feature to block context parameters used internally by the SQL
   planner from being supplied by end users.

4) Add a feature to enable adding row signature to the context for
   Scan queries. This is useful in building the task-based engine.

5) Add saffron.properties file that turns off sets and graphviz dumps
   in "cannot plan" errors. Significantly reduces log spam on the Broker.

* Fixes from CI.

* Changes from review.

* Can vectorize, now that join-to-filter is on by default.

* Checkstyle! And variable renames!

* Remove throws from test.
2022-08-14 23:31:19 -07:00
.github Lock hadoop dependencies to 2.8.5 (#11583) 2021-08-12 15:16:47 +05:30
.idea Poison stupid pool (#12646) 2022-07-03 14:36:22 -07:00
benchmarks SQL: Morph QueryMakerFactory into SqlEngine. (#12897) 2022-08-14 23:31:19 -07:00
cloud Tidy up construction of the Guice Injectors (#12816) 2022-08-04 00:05:07 -07:00
codestyle Frame processing and channels. (#12848) 2022-08-04 21:29:04 -07:00
core Error handling improvements for frame channels. (#12895) 2022-08-15 11:31:55 +05:30
dev Add some debug tips for debugging peons (#12697) 2022-07-09 01:47:25 -07:00
distribution Improved Java 17 support and Java runtime docs. (#12839) 2022-08-03 23:16:05 -07:00
docs Enable conversion of join to filter by default (#12868) 2022-08-13 20:37:43 +05:30
examples changes to run examples when CDPATH environment variable is set where cd command returns current dir… (#12877) 2022-08-14 13:15:24 +08:00
extendedset Bump up the versions (#12480) 2022-04-27 14:28:20 +05:30
extensions-contrib Refactor SqlLifecycle into statement classes (#12845) 2022-08-14 00:44:08 -07:00
extensions-core Refactor SqlLifecycle into statement classes (#12845) 2022-08-14 00:44:08 -07:00
helm/druid replaces hard-coded probe delays with helm values (#12805) 2022-07-26 14:04:06 +05:30
hll Free ByteBuffers in tests and fix some bugs. (#12521) 2022-05-19 07:42:29 -07:00
hooks Git hooks should fail on errors; pass args to git hooks (#12322) 2022-03-10 09:07:50 +09:00
indexing-hadoop Add authentication call before cleaning up intermediate files in hadoop ingestions (#12030) 2022-05-02 08:40:44 -05:00
indexing-service fix(druid-indexing): failed to get shardSpec for interval issue (#12573) 2022-08-05 17:57:36 -07:00
integration-tests Refactor SqlLifecycle into statement classes (#12845) 2022-08-14 00:44:08 -07:00
integration-tests-ex Docker build for the revised ITs (#12707) 2022-08-10 14:17:33 +05:30
licenses Blueprint 4 (#12391) 2022-04-04 10:34:22 -07:00
processing Error handling improvements for frame channels. (#12895) 2022-08-15 11:31:55 +05:30
publications De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
server Refactor SqlLifecycle into statement classes (#12845) 2022-08-14 00:44:08 -07:00
services Refactor DruidSchema & DruidTable (#12835) 2022-08-10 10:24:04 +05:30
sql SQL: Morph QueryMakerFactory into SqlEngine. (#12897) 2022-08-14 23:31:19 -07:00
web-console Kinesis ingestion with empty shards (#12792) 2022-08-05 22:38:58 +05:30
website Enable conversion of join to filter by default (#12868) 2022-08-13 20:37:43 +05:30
.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 Frame processing and channels. (#12848) 2022-08-04 21:29:04 -07:00
.lgtm.yml Suppress LGTM warnings about stack trace exposure (#9631) 2020-04-09 17:31:03 -07:00
.travis.yml Docker build for the revised ITs (#12707) 2022-08-10 14:17:33 +05:30
CONTRIBUTING.md Fix numbered list formatting in markdown. (#9664) 2020-04-21 20:18:12 -07:00
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 support Aliyun OSS service as deep storage (#9898) 2020-07-01 22:20:53 -07:00
NOTICE license.yaml fixes for code introduced related to AWS RDS token based password provider in PR #9518 (#10885) 2021-03-10 12:59:25 -08:00
README.md Readme - link fix to build guide (#12849) 2022-08-03 19:32:37 +08:00
README.template De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
check_test_suite.py run web-console e2e tests for java changes too (#12776) 2022-07-13 16:12:57 -07:00
check_test_suite_test.py run web-console e2e tests for java changes too (#12776) 2022-07-13 16:12:57 -07:00
licenses.yaml Improved Java 17 support and Java runtime docs. (#12839) 2022-08-03 23:16:05 -07:00
owasp-dependency-check-suppressions.xml Suppress CVEs - Avatica, Postgres (#12884) 2022-08-10 14:18:19 +05:30
pom.xml Docker build for the revised ITs (#12707) 2022-08-10 14:17:33 +05:30
upload.sh Adding licenses and enable apache-rat-plugin. (#6215) 2018-09-18 08:39:26 -07:00

README.md

Slack Build Status Language grade: Java Coverage Status Docker Helm


Website | Documentation | Developer Mailing List | User Mailing List | Slack | Twitter | Download


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 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

You can find the documentation for the latest Druid release on the project website.

If you would like to contribute documentation, please do so under /docs in this repository and submit a pull request.

Community

Community support is available on the druid-user mailing list, which is hosted at Google Groups.

Development discussions occur on dev@druid.apache.org, which you can subscribe to by emailing dev-subscribe@druid.apache.org.

Chat with Druid committers and users in real-time on the Apache Druid Slack channel. Please use this invitation link to join and invite others.

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