Commit graph

605 commits

Author SHA1 Message Date
Adam Locke
3185363400
[DOCS] Add beta admonition for runtime fields. (#67847) (#67849)
* Add beta admonition for runtime fields.

* Add beta admonition to search your data page.
2021-01-21 18:03:45 -05:00
Adam Locke
be307cfad1
[DOCS] [7.x] Add runtime fields to Painless Guide (#67781) (#67844)
* Adding runtime fields page for Painless context.

* Adds beta admonition to runtime fields and Painless docs.

* Fixing test errors and improving content sections.

* Adding refresh to fix test cases.

* Simplifying the ingest request to include refresh.

* Removing beta (will add in another PR) and updating examples.
2021-01-21 16:26:07 -05:00
Adam Locke
95e3810d15
[DOCS] [7.x] Updates to the runtime fields docs for 7.11+ (#67484) (#67711)
* [DOCS] [7.x] Updates to the runtime fields docs for 7.11+ (#67484)

* Moving examples to the page for retrieving runtime fields.

* Adding runtime_mappings to request body of search API.

* Updating runtime_mappings properties and adding runtime fields to search your data.

* Updating examples and hopefully fixing build failure.

* Fixing snippet formatting that was causing test failure.

* Adding page in Painless guide for runtime fields.

* Fixing typo.

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>

* Fixing testresponse to include _type.

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-01-19 12:50:19 -05:00
James Rodewig
24f8a798f8
[DOCS] Add doc values restriction for wildcard fields (#67503) (#67513)
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>

Co-authored-by: AndyHunt66 <andrew.hunt@elastic.co>
2021-01-14 09:39:43 -05:00
Adam Locke
33caf15832
[DOCS] [7.x] Updating dynamic mappings for runtime fields (#67301) (#67368)
* [DOCS] [7.x] Updating dynamic mappings for runtime fields (#67301)

* Updating dynamic mappings for runtime fields.

* Updating example to fix test case and be more accurate.

* Changing header level for dynamic runtime.

* Clarifying language around ip fields in dynamic template.

* Adding test warning to fix snippet test.
2021-01-12 12:59:55 -05:00
James Rodewig
3872f08b33
[DOCS] Clean up index template xrefs (#67264) (#67272) 2021-01-11 12:58:00 -05:00
Adam Locke
2cc6da9f5a
[DOCS] [7.x] Runtime fields improvements (#66530) (#67271)
* Changes for dynamic templates.

* Clarifying language around dynamic:true and dynamic:runtime.

* Clarifying edits and some restructuring.

* Overhauling the Mapping page.

* Incorporating changes from #66911.

* Reworking mapping page to focus on dynamic vs. explicit mapping.

* Reordering to fix test failure.

* Further clarifying mapping page.

* Reordering sections, adding headings to examples, and other clarifications.

* Incorporating review feedback.

* Adding description of  for Painless script.

* Minor revisions.
2021-01-11 12:55:05 -05:00
James Rodewig
b1b79adff6
[DOCS] Fix formatting for fieldata docs (#67017) (#67023) 2021-01-05 12:36:07 -05:00
James Rodewig
ba1b6e3bc9 [DOCS] Fix formatting 2020-12-16 20:47:29 -05:00
Christos Soulios
f4c92aef79
[7.x] [DOCS] Added docs for aggregate_metric_double field (#66306) (#66388)
Added documentation for the aggregate_metric_double field that was merged in #56745

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2020-12-15 21:24:57 +02:00
Adam Locke
18ebcbb8a9
Incorporating changes from review. (#66346) 2020-12-15 10:06:17 -05:00
Gilad Gal
82cd8b5d16
Update runtime.asciidoc 2020-12-15 10:24:36 +02:00
Adam Locke
9830222aaf
[DOCS] Add dynamic runtime fields to docs (#66194) (#66304)
* [DOCS] Add dynamic runtime fields to docs.

* Clarifying edits and example changes.

* Creating better table and incorporating review comments.

* Change numeral to superscript.
2020-12-14 16:56:11 -05:00
Adam Locke
68539f95a5
[DOCS] [7.x] Add docs for runtime fields (#62653) (#66140)
* [DOCS] Add docs for runtime fields (#62653)

* First steps in docs for runtime fields.

* Adding new page for runtime fields.

* Adding page for runtime fields.

* Adding more to the runtime fields topic.

* Adding parameters and retrieval options for runtime fields.

* Adding TESTSETUP for index creation.

* Incorporating review feedback.

* Incorporating reviewer feedback.

* Adding examples for runtime fields.

* Adding more context and simplifying the example.

* Changing timestamp to @timestamp throughout.

* Removing duplicate @timestamp field.

* Expanding example to hopefully fix CI builds.

* Adding skip test for result.

* Adding missing callout.

* Adding TESTRESPONSEs, which are currently broken.

* Fixing TESTRESPONSEs.

* Incorporating review feedback.

* Several clarifications, better test cases, and other changes.

* Adding missing callout in example.

* Adding substitutions to TESTRESPONSE for shorter results shown.

* Shuffling some information and adding link to script-fields.

* Fixing typo.

* Updates for API redesign -- will break builds.

* Updating examples and including info about overriding fields.

* Updating examples.

* Adding info for using runtime fields in the search request.

* Adding that queries against runtime fields are expensive.

* Incorporating feedback from reviewers.

* Minor changes from reviews.

* Adding alias for test case.

* Adding aliases to PUT example.

* Fixing test cases, for real this time.

* Updating use cases and introducing overlay throughout.

* Edits, adding 'shadowing', and explaining shadowing better.

* Streamlining tests and other changes.

* Fix formatting in example for test.

* Apply suggestions from code review

* Incorporating reviewer feedback 7 Dec

* Shifting structure of mapping page to fix cross links.

* Revisions for shadowing, overview, and other sections.

* Removing dot notation section and incorporating review changes.

* Adding updated example for shadowing.

* Streamlining shadowing example and TESTRESPONSEs.

* Adding type field in responses for 7.x to fix test cases.
2020-12-09 19:32:15 -05:00
James Rodewig
9e00530942
[DOCS] Fix _doc_count field title (#65704) (#65738) 2020-12-02 08:27:38 -05:00
James Rodewig
ead04bfd0b
[DOCS] Fix _doc_count example typo (#65686) (#65702)
Co-authored-by: Gil Raphaelli <gil@elastic.co>
2020-12-01 14:56:59 -05:00
Julie Tibshirani
c7738e0a19 Remove note on marking copy_to fields as stored. (#65459)
During highlighting, we now load all values that were copied into the field
through copy_to. So there's no longer a reason to set 'store: true' to account
for fields not available in _source.
2020-11-25 09:08:13 -08:00
Wylie Conlon
4d9f5b1867 Clarify field data cache behavior in docs (#64375)
* Clarify that field data cache includes global ordinals
* Describe that the cache should be cleared once the limit is reached
* Clarify that the `_id` field does not supported aggregations anymore
* Fold the `fielddata` mapping parameter page into the `text field docs
* Improve cross-linking
2020-11-20 13:56:02 -08:00
Martijn van Groningen
ce91f27df8
Improve error message in case of invalid dynamic templates. (#65001)
Backporting #60870 to 7.x branch.

Include the attempted 'match_mapping_type' into the message,
so that it is clearer that multiple validation attempts have occurred.

Dynamic template validation was recently added via #51233 and
there was some confusion over the deprecation message itself.
(in 7.x only deprecation warning will be omitted and from 8.0
 an error will be returned)
2020-11-12 16:58:18 +01:00
James Rodewig
66e449bf17
[DOCS] Clarify args for geoshape orientation (#64649) (#64697) 2020-11-06 07:57:11 -05:00
Christos Soulios
e1d7b4ff54
[7.x] Add doc_count field mapper (#64594)
Bucket aggregations compute bucket doc_count values by incrementing the doc_count by 1 for every document collected in the bucket.

When using summary fields (such as aggregate_metric_double) one field may represent more than one document. To provide this functionality we have implemented a new field mapper (named doc_count field mapper). This field is a positive integer representing the number of documents aggregated in a single summary field.

Bucket aggregations will check if a field of type doc_count exists in a document and will take this value into consideration when computing doc counts.
2020-11-06 11:54:29 +02:00
Alex Chan
fc268a4d47 [Docs] Note that wildcard field supports null_value 2020-11-05 19:06:59 +01:00
Mayya Sharipova
21c1b40dca
Disable using unsigned_long in scripts (#64552)
Backport for #64523
Relates to #64361
2020-11-03 15:16:22 -05:00
James Rodewig
aea83909d9
[DOCS] Fix case for 'Boolean' (#64299) (#64341) 2020-10-29 10:04:20 -04:00
James Rodewig
0a48276357
[DOCS] Re-add sparse vector xref (#64307) 2020-10-29 08:55:26 -04:00
James Rodewig
f1b632afdb
[DOCS] Sort field data types in docs (#64288) (#64304)
Co-authored-by: Andrew Kroh <andrew.kroh@elastic.co>
2020-10-28 13:53:39 -04:00
Adrien Grand
1066280be5
Document standard metadata entries. (#61941) (#63538)
We standardize on some metadata entries that we plan to later leverage
in Kibana in order to provide a better out-of-the-box experience, e.g.
different visualizations make sense on gauges and counters.
2020-10-13 14:46:34 +02:00
Alan Woodward
88b45dfa61
Convert TextFieldMapper to parametrized form (#63269) (#63392)
As a result of this, we can remove a chunk of code from TypeParsers as well. Tests
for search/index mode analyzers have moved into their own file. This commit also
rationalises the serialization checks for parameters into a single SerializerCheck
interface that takes the values includeDefaults, isConfigured and the value
itself.

Relates to #62988
2020-10-07 13:26:25 +01:00
Mayya Sharipova
bea0ead08a
Fix fields retrieval on unsinged_long field (#63310)
This fixes fields retrieval on unsigned_long field

1) For docvalue_fields a custom UnsignedLongLeafFieldData::getLeafValueFetcher
is implemented that correctly retrieves doc values.

2) For stored fields, an error was fixed in UnsignedLongFieldMapper
 how stored values were stored. Before they were incorrectly
stored in the shifted format, now they are stored as original
values in String format.

Relates to #60050
Backport for #63119
2020-10-06 06:37:31 -04:00
Mayya Sharipova
54064a1eec
Unsigned long 64bits(#62892)
Introduce 64-bit unsigned long field type

This field type supports
- indexing of integer values from [0, 18446744073709551615]
- precise queries (term, range)
- precise sort and terms aggregations
- other aggregations are based on conversion of long values
  to double and can be imprecise for large values.

Backport for #60050
Closes #32434
2020-09-24 16:51:47 -04:00
James Rodewig
76da348f7a
[DOCS] Change index name from index to my-index-000001 (#62678) (#62704)
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>

Co-authored-by: Subhendu Sethi <cs13b1027@iith.ac.in>
2020-09-21 10:11:15 -04:00
Christoph Büscher
803f78ef05
Add field type for version strings (#59773) (#62692)
This PR adds a new 'version' field type that allows indexing string values
representing software versions similar to the ones defined in the Semantic
Versioning definition (semver.org). The field behaves very similar to a
'keyword' field but allows efficient sorting and range queries that take into
accound the special ordering needed for version strings. For example, the main
version parts are sorted numerically (ie 2.0.0 < 11.0.0) whereas this wouldn't
be possible with 'keyword' fields today.

Valid version values are similar to the Semantic Versioning definition, with the
notable exception that in addition to the "main" version consiting of
major.minor.patch, we allow less or more than three numeric identifiers, i.e.
"1.2" or "1.4.6.123.12" are treated as valid too.

Relates to #48878
2020-09-21 14:25:42 +02:00
Christos Soulios
ad79a2b6a1
[7.x] Histogram field type support for min/max aggregations (#62689)
Implement min/max aggregations for histogram fields.

Backports #62532
2020-09-21 12:53:56 +03:00
Alan Woodward
17aabaed15 Fix warning on boost docs and warning message on non-implementing fieldmappers 2020-09-18 16:45:08 +01:00
James Rodewig
484e74ccaa
[DOCS] Update range field type docs (#62112) (#62454)
Co-authored-by: Wylie Conlon <william.conlon@elastic.co>
2020-09-16 09:33:04 -04:00
James Rodewig
6eacb6dd89 [DOCS] Fix keyword xref 2020-09-02 11:47:17 -04:00
Julie Tibshirani
9ee5f20ebc Link to the keyword family page from the field types docs. (#61819)
We now link to the top-level keyword type family page instead of its individual
subsections. This better fits the page format, where each type name is a link.
2020-09-01 16:23:49 -07:00
James Rodewig
8613bde780
[DOCS] Combine keyword family docs (#61662) (#61813) 2020-09-01 15:32:56 -04:00
James Rodewig
0407f1d19b
[DOCS] Change 'data type' to 'field type' (#61633) (#61635) 2020-08-27 12:47:28 -04:00
James Rodewig
462754e4e6
[DOCS] Reorg field data types page (#61117) (#61599) 2020-08-26 14:24:09 -04:00
James Rodewig
2b852388c5
[DOCS] Fix hyphenation for "time series" (#61472) (#61481) 2020-08-24 11:18:07 -04:00
James Rodewig
e92c62bdf8
[7.x] [DOCS] Fix query example for wildcard datatype (#61398) (#61431)
Co-authored-by: jessepeixoto <jessepeixoto@gmail.com>
2020-08-21 12:43:41 -04:00
Ryan Ernst
00b56bf007
Add note about negative epoch times (#61379)
This commit adds a reminder to date type documentation that negative
epoch times are not supported.

relates #40983
2020-08-20 13:54:14 -07:00
James Rodewig
1182248994 [DOCS] Document empty string boolean value as false (#61341) 2020-08-19 12:57:57 -04:00
James Rodewig
60876a0e32
[DOCS] Replace Wikipedia links with attribute (#61171) (#61209) 2020-08-17 11:27:04 -04:00
Alan Woodward
54279212cf
Make MetadataFieldMapper extend ParametrizedFieldMapper (#59847) (#60924)
This commit cuts over all metadata field mappers to parametrized format.
2020-08-11 09:02:28 +01:00
James Rodewig
1b2a015734
[DOCS] Cross-link copy_to and search speed docs (#60926) (#60928) 2020-08-10 15:35:10 -04:00
Alan Woodward
e8d9185045 Cut over IPFieldMapper to parametrized form (#60602)
This commit makes IpFieldMapper extend ParametrizedFieldMapper. It also
updates the IpFieldMapper docs to add the ignore_malformed parameter,
which was not previously documented.
2020-08-10 11:01:10 +01:00
James Rodewig
a761985fab
[DOCS] Move script and stored fields content to search fields page (#60826) (#60835)
Changes:

* Moves `Retrieve selected fields` to its own page and adds a title abbreviation.
* Adds existing script and stored fields content to `Retrieve selected fields`
* Adds a xref for `Retrieve selected fields` to `Search your data`
* Adds related redirects and updates existing xrefs
2020-08-06 13:06:06 -04:00
James Rodewig
3a9bf33993
[DOCS] Remove metrics sidebar in _source docs (#60777) (#60786) 2020-08-05 16:19:47 -04:00