Accuracy
Edit pageNumeric, date and geospatial fields index extra terms at coarser granularities, called accuracies. A range query can then match a handful of coarse “bucket” terms instead of scanning every distinct value, which makes ranges and range based aggregations much faster. The trade-off is a larger index: each accuracy level adds terms.
Accuracies are set per field with the _accuracy option. If it is omitted a
sensible default is used, so you only need to tune it when you know your query
patterns. They apply only to a field that is indexed with terms (_index of field_terms,
field_all and the others that write terms, see Indexing Mode); the option
_accuracy_prefix sets the prefixes the bucket terms carry.
Numeric Accuracy
Section titled “Numeric Accuracy”For numeric fields, _accuracy is an array of step sizes. The field below
buckets its values at multiples of 100, 1000 and 10000:
PUT /test_accuracy/
{ "_schema": { "balance": { "_type": "float", "_accuracy": [100, 1000, 10000] } }}PUT /test_accuracy/1
{ "balance": 1234.56}Ranges over a field that also has values use those buckets transparently, the results are
exactly the same as without accuracies, only faster. On a field indexed with terms only
(field_terms) the range is answered by the buckets alone: a closed range returns the union of
the buckets it covers (wider than the range by less than the finest bucket), and an open-ended or
too wide range answers 400 (see Range Searches):
SEARCH /test_accuracy/
{ "_query": { "balance": { "_in": { "_range": { "_from": 1000, "_to": 2000 } } } }}When _accuracy is omitted, numeric fields default to
[100, 1000, 10000, 100000, 1000000, 100000000].
Date Accuracy
Section titled “Date Accuracy”For date fields, _accuracy is an array of named levels instead of step sizes:
"second", "minute", "hour", "day", "month", "year", "decade",
"century" and "millennium".
See Date Type and Numeric Type for the per-type details.
Geospatial Accuracy
Section titled “Geospatial Accuracy”A geospatial field’s accuracies are HTM levels, from 0 to
25 (a deeper level answers 400). The default is [3, 5, 8, 10, 12, 15].
Sources: src/database/schema.cc:192-203,4684-4694.
Date Accuracy Defaults
Section titled “Date Accuracy Defaults”The default accuracies depend on the type: date has day, month, year, decade and century;
datetime has hour and the same; time and timedelta have minute and hour. The available levels
are second, minute, hour, day, month, year, decade, century and millennium.
Sources: src/database/schema.cc:161-188,208-223.