95f93e5f81
* Adds time_zone to query * Adds dateFormatTZ to kuery query Removes comments * Adds defaults for the dateFormatTZ to the function signatures * Adds tests for date match in kuery Modifies test * Adds a test for get_es_query_config * Adds test for get timezone from settings utility method * Adds tests for modified range method Adds config param test to node_types/functions code clean up * resolves initial PR comments * Refactors build_es_query test * Refactors get_time_zone_from_settings test * Uses spys to test that the config is passed down to children in ast toElasticsearchQuery * removes default config nulls * Deletes sinon.spy tests in kuery * removes moment.setDefault from __tests__/get_timezone_from_settings.js |
||
|---|---|---|
| .. | ||
| scripts | ||
| src | ||
| tasks | ||
| babel.config.js | ||
| index.d.ts | ||
| package.json | ||
| README.md | ||
| tsconfig.browser.json | ||
| tsconfig.json | ||
kbn-es-query
This module is responsible for generating Elasticsearch queries for Kibana. See explanations below for each of the subdirectories.
es_query
This folder contains the code that combines Lucene/KQL queries and filters into an Elasticsearch query.
buildEsQuery(indexPattern, queries, filters, config)
Generates the Elasticsearch query DSL from combining the queries and filters provided.
buildQueryFromFilters(filters, indexPattern)
Generates the Elasticsearch query DSL from the given filters.
luceneStringToDsl(query)
Generates the Elasticsearch query DSL from the given Lucene query.
migrateFilter(filter, indexPattern)
Migrates a filter from a previous version of Elasticsearch to the current version.
decorateQuery(query, queryStringOptions)
Decorates an Elasticsearch query_string query with the given options.
filters
This folder contains the code related to Kibana Filter objects, including their definitions, and helper functions to create them. Filters in Kibana always contain a meta property which describes which index the filter corresponds to, as well as additional data about the specific filter.
The object that is created by each of the following functions corresponds to a Filter object in the lib directory (e.g. PhraseFilter, RangeFilter, etc.)
buildExistsFilter(field, indexPattern)
Creates a filter (ExistsFilter) where the given field exists.
buildPhraseFilter(field, value, indexPattern)
Creates an filter (PhraseFilter) where the given field matches the given value.
buildPhrasesFilter(field, params, indexPattern)
Creates a filter (PhrasesFilter) where the given field matches one or more of the given values. params should be an array of values.
buildQueryFilter(query, index)
Creates a filter (CustomFilter) corresponding to a raw Elasticsearch query DSL object.
buildRangeFilter(field, params, indexPattern)
Creates a filter (RangeFilter) where the value for the given field is in the given range. params should contain lt, lte, gt, and/or gte.
kuery
This folder contains the code corresponding to generating Elasticsearch queries using the Kibana query language.
It also contains code corresponding to the original implementation of Kuery (released in 6.0) which should be removed at some point (see legacy_kuery.js, legacy_kuery.peg).
In general, you will only need to worry about the following functions from the ast folder:
fromExpression(expression)
Generates an abstract syntax tree corresponding to the raw Kibana query expression.
toElasticsearchQuery(node, indexPattern)
Takes an abstract syntax tree (generated from the previous method) and generates the Elasticsearch query DSL using the given indexPattern. Note that if no indexPattern is provided, then an Elasticsearch query DSL will still be generated, ignoring things like the index pattern scripted fields, field types, etc.