Apache Druid: a high performance real-time analytics database.
Go to file
Clint Wylie d0c9c37e35
make query context changes backwards compatible (#12564)
Adds a default implementation of getQueryContext, which was added to the Query interface in #12396. Query is marked with @ExtensionPoint, and lately we have been trying to be less volatile on these interfaces by providing default implementations to be more chill for extension writers.

The way this default implementation is done in this PR is a bit strange due to the way that getQueryContext is used (mutated with system default and system generated keys); the default implementation has a specific object that it returns, and I added another temporary default method isLegacyContext that checks if the getQueryContext returns that object or not. If not, callers fall back to using getContext and withOverriddenContext to set these default and system values.

I am open to other ideas as well, but this way should work at least without exploding, and added some tests to ensure that it is wired up correctly for QueryLifecycle, including the context authorization stuff.

The added test shows the strange behavior if query context authorization is enabled, mainly that the system default and system generated query context keys also need to be granted as permissions for things to function correctly. This is not great, so I mentioned it in the javadocs as well. Not sure if it needs to be called out anywhere else.
2022-05-25 15:24:41 +05:30
.github Lock hadoop dependencies to 2.8.5 (#11583) 2021-08-12 15:16:47 +05:30
.idea Use ExecutorService variables to assign ExecutorService Instances (#11373) 2021-06-25 16:56:34 -07:00
benchmarks Direct UTF-8 access for "in" filters. (#12517) 2022-05-20 01:51:28 -07:00
cloud add aws-java-sdk-sts to aws-common classpath (#12482) 2022-05-03 12:25:51 -07:00
codestyle GroupBy: Reduce allocations by reusing entry and key holders. (#12474) 2022-04-28 23:21:13 -07:00
core Direct UTF-8 access for "in" filters. (#12517) 2022-05-20 01:51:28 -07:00
dev Add git hooks that can run multiple scripts (#12300) 2022-03-09 07:16:47 +09:00
distribution Bump up the versions (#12480) 2022-04-27 14:28:20 +05:30
docs Emit state of replace and append for native batch tasks (#12488) 2022-05-23 12:32:47 -07:00
examples Fix zulu8 set-up Dockerfile for hadoop and hadoop3 in hadoop ingestion tutorial (#12248) 2022-04-11 20:28:09 +05:30
extendedset Bump up the versions (#12480) 2022-04-27 14:28:20 +05:30
extensions-contrib Free ByteBuffers in tests and fix some bugs. (#12521) 2022-05-19 07:42:29 -07:00
extensions-core Free ByteBuffers in tests and fix some bugs. (#12521) 2022-05-19 07:42:29 -07:00
helm/druid Bump up the versions (#12480) 2022-04-27 14:28:20 +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 Emit state of replace and append for native batch tasks (#12488) 2022-05-23 12:32:47 -07:00
integration-tests Fix usage of maxColumnsToMerge in auto-compaction tuning config (#12551) 2022-05-20 22:23:08 +05:30
licenses Blueprint 4 (#12391) 2022-04-04 10:34:22 -07:00
processing make query context changes backwards compatible (#12564) 2022-05-25 15:24:41 +05:30
publications De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
server make query context changes backwards compatible (#12564) 2022-05-25 15:24:41 +05:30
services remake column indexes and query processing of filters (#12388) 2022-05-11 11:57:08 +05:30
sql object[] handling for DimensionHandlers for arrays (#12552) 2022-05-25 15:24:18 +05:30
web-console Web console: fix go to segments not working (#12541) 2022-05-19 14:34:03 -07:00
website Emit state of replace and append for native batch tasks (#12488) 2022-05-23 12:32:47 -07: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 Refactor ResponseContext (#11828) 2021-12-06 17:03:12 -08:00
.lgtm.yml Suppress LGTM warnings about stack trace exposure (#9631) 2020-04-09 17:31:03 -07:00
.travis.yml Free ByteBuffers in tests and fix some bugs. (#12521) 2022-05-19 07:42:29 -07:00
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 Add JDK 11 (#12333) 2022-03-16 15:03:04 -07:00
README.template De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
check_test_suite.py suppress false positive cve (#11699) 2021-09-13 20:45:38 -07:00
check_test_suite_test.py suppress false positive cve (#11699) 2021-09-13 20:45:38 -07:00
licenses.yaml update to latest lz4 1.8.0 (#12557) 2022-05-21 16:02:20 +08:00
owasp-dependency-check-suppressions.xml Suppress false CVE on druid-indexing-hadoop artifact (#12562) 2022-05-24 16:00:58 +05:30
pom.xml Use a different repository to download sigar artifacts. (#12561) 2022-05-24 14:42:51 +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.

For instructions on building Druid from source, see docs/development/build.md

Contributing

Please follow the community guidelines for contributing.

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

License

Apache License, Version 2.0