druid/docs/querying
Gian Merlino fc95c92806
Remove OffheapIncrementalIndex and clarify aggregator thread-safety needs. (#11124)
* Remove OffheapIncrementalIndex and clarify aggregator thread-safety needs.

This patch does the following:

- Removes OffheapIncrementalIndex.
- Clarifies that Aggregators are required to be thread safe.
- Clarifies that BufferAggregators and VectorAggregators are not
  required to be thread safe.
- Removes thread safety code from some DataSketches aggregators that
  had it. (Not all of them did, and that's OK, because it wasn't necessary
  anyway.)
- Makes enabling "useOffheap" with groupBy v1 an error.

Rationale for removing the offheap incremental index:

- It is only used in one rare scenario: groupBy v1 (which is non-default)
  in "useOffheap" mode (also non-default). So you have to go pretty deep
  into the wilderness to get this code to activate in production. It is
  never used during ingestion.
- Its existence complicates developer efforts to reason about how
  aggregators get used, because the way it uses buffer aggregators is so
  different from how every other query engine uses them.
- It doesn't have meaningful testing.

By the way, I do believe that the given way the offheap incremental index
works, it actually didn't require buffer aggregators to be thread-safe.
It synchronizes on "aggregate" and doesn't call "get" until it has
stopped calling "aggregate". Nevertheless, this is a bother to think about,
and for the above reasons I think it makes sense to remove the code anyway.

* Remove things that are now unused.

* Revert removal of getFloat, getLong, getDouble from BufferAggregator.

* OAK-related warnings, suppressions.

* Unused item suppressions.
2021-10-26 08:05:56 -07:00
..
aggregations.md fixes web console introduction and addresses linking issues (#11609) 2021-08-18 08:37:05 -07:00
caching.md add single input string expression dimension vector selector and better expression planning (#11213) 2021-07-06 11:20:49 -07:00
datasource.md add single input string expression dimension vector selector and better expression planning (#11213) 2021-07-06 11:20:49 -07:00
datasourcemetadataquery.md Refresh query docs. (#9704) 2020-04-15 16:12:20 -07:00
dimensionspecs.md cleaning up and fixing links (#10528) 2020-12-17 13:37:43 -08:00
filters.md add minimal documentation for expression filters (#11045) 2021-04-07 16:58:28 -07:00
granularities.md Docs - granularities link back to segmentGranularity (#11672) 2021-09-10 10:40:11 -07:00
groupbyquery.md Remove OffheapIncrementalIndex and clarify aggregator thread-safety needs. (#11124) 2021-10-26 08:05:56 -07:00
having.md cleaning up and fixing links (#10528) 2020-12-17 13:37:43 -08:00
hll-old.md De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
joins.md Refresh query docs. (#9704) 2020-04-15 16:12:20 -07:00
limitspec.md Add "offset" parameter to GroupBy query. (#10235) 2020-08-05 15:39:58 -07:00
lookups.md cleaning up and fixing links (#10528) 2020-12-17 13:37:43 -08:00
multi-value-dimensions.md Docs refactor of ingestion. Carries #11541 (#11576) 2021-08-13 08:42:03 -07:00
multitenancy.md cleaning up and fixing links (#10528) 2020-12-17 13:37:43 -08:00
post-aggregations.md fixes web console introduction and addresses linking issues (#11609) 2021-08-18 08:37:05 -07:00
query-context.md Improve query error logging (#11519) 2021-08-05 22:51:09 +07:00
query-execution.md add clarification for maxSubqueryRows (#11687) 2021-09-13 11:49:30 -07:00
querying.md Eliminate ambiguities of KB/MB/GB in the doc (#11333) 2021-06-30 13:42:45 -07:00
scan-query.md Add "offset" parameter to the Scan query. (#10233) 2020-08-13 14:56:24 -07:00
searchquery.md fix desc of 'required' for granularity property (#10616) 2020-12-01 18:29:51 -08:00
segmentmetadataquery.md Docs: Clarify segmentMetadata cardinality, minmax, and size behavior. (#11549) 2021-08-26 15:39:40 -07:00
select-query.md Add "offset" parameter to the Scan query. (#10233) 2020-08-13 14:56:24 -07:00
sorting-orders.md add single input string expression dimension vector selector and better expression planning (#11213) 2021-07-06 11:20:49 -07:00
sql.md Add druid.sql.approxCountDistinct.function property. (#11181) 2021-10-25 12:16:21 -07:00
timeboundaryquery.md Refresh query docs. (#9704) 2020-04-15 16:12:20 -07:00
timeseriesquery.md Refresh query docs. (#9704) 2020-04-15 16:12:20 -07:00
topnmetricspec.md Refresh query docs. (#9704) 2020-04-15 16:12:20 -07:00
topnquery.md Update topnquery.md (#10944) 2021-03-09 15:19:02 -08:00
using-caching.md fixes web console introduction and addresses linking issues (#11609) 2021-08-18 08:37:05 -07:00
virtual-columns.md Refresh query docs. (#9704) 2020-04-15 16:12:20 -07:00