OpenSearch/docs/reference
Boaz Leskes 9f10547f4b Allow 0 as a valid external version
Until now all version types have officially required the version to be a positive long number. Despite of this has being documented, ES versions <=1.0 did not enforce it when using the `external` version type. As a result people have succesfully indexed documents with 0 as a version. In 1.1. we introduced validation checks on incoming version values and causing indexing request to fail if the version was set to 0. While this is strictly speaking OK, we effectively have a situation where data already indexed does not match the version invariant.

To be lenient and adhere to spirit of our data backward compatibility policy, we have decided to allow 0 as a valid external version type. This is somewhat complicated as 0 is also the internal value of `MATCH_ANY`, which indicates requests should succeed regardles off the current doc version. To keep things simple, this commit changes the internal value of `MATCH_ANY` to `-3` for all version types.

Since we're doing this in a minor release (and because versions are stored in the transaction log), the default `internal` version type still accepts 0 as a `MATCH_ANY` value. This is not a problem for other version types as `MATCH_ANY` doesn't make sense in that context.

Closes #5662
2014-05-16 22:10:16 +02:00
..
analysis Update keyword-tokenizer.asciidoc 2014-05-07 15:04:07 +02:00
cat [DOCS] Renamed the "cat" chapters to be more searchable 2014-05-16 21:43:35 +02:00
cluster fix field data stats doc 2014-05-06 15:57:00 +02:00
docs Allow 0 as a valid external version 2014-05-16 22:10:16 +02:00
images [Doc] Add a chart about the relative error of the percentiles aggregation. 2014-03-14 12:23:23 +01:00
index-modules #6081: set IO throttling back to 20 MB/sec now that #6018 is fixed 2014-05-12 14:42:26 -04:00
indices [DOCS] Updated the mapping and field mapping docs to use the new format 2014-05-06 17:21:09 +02:00
mapping Removed mention of Spatial4J and JTS requirement 2014-05-06 14:49:48 +02:00
migration [DOCS] Included the `_percolator` index breaking change to migration docs. 2014-02-20 16:43:06 +01:00
modules Check that a plugin is Lucene compatible with the current running node using `lucene` property in `es-plugin.properties` file. 2014-05-16 13:41:20 +02:00
query-dsl Update match-query.asciidoc 2014-05-14 11:59:12 +02:00
search use shard_min_doc_count also in TermsAggregation 2014-05-14 14:10:04 +02:00
setup added install instruction with apt 2014-05-16 19:07:05 +02:00
testing [TEST] Randomized number of shards used for indices created during tests 2014-03-10 13:01:52 +01:00
analysis.asciidoc Add more anchor links to documentation 2013-09-30 13:13:16 -06:00
api-conventions.asciidoc [DOCS] rewrite -> fuzzy_rewrite in match query 2014-04-23 21:05:14 +02:00
cat.asciidoc Add /_cat/fielddata to display fielddata usage 2014-05-09 13:18:02 +02:00
cluster.asciidoc [DOCS] Fix HTTP endpoints after stats API changes 2014-01-09 11:30:28 +01:00
docs.asciidoc [DOCS] Moved termvector and mtermvectors from search to docs 2014-01-22 14:10:26 +01:00
getting-started.asciidoc Fixed typo in getting-started.asciidoc 2014-05-14 12:03:12 +02:00
glossary.asciidoc Migrated documentation into the main repo 2013-08-29 01:24:34 +02:00
index-modules.asciidoc Removed 0.90.* deprecation and addition notifications 2014-02-07 20:52:49 +01:00
index.asciidoc [DOCS] getting started tutorial 2014-04-22 13:33:03 -04:00
indices.asciidoc [DOCS] Removed leftover indices status link 2014-04-28 11:39:12 +02:00
mapping.asciidoc [DOCS] Moved multi fields documentation into the core-types page 2014-01-22 10:05:58 +01:00
modules.asciidoc [DOCS] Fixed link to tribe.asciidoc 2014-01-13 22:01:12 +01:00
query-dsl.asciidoc Migrated documentation into the main repo 2013-08-29 01:24:34 +02:00
search.asciidoc Benchmark documentation 2014-04-14 14:08:41 -07:00
setup.asciidoc Author: Sean Gallagher 2014-04-07 14:43:35 -04:00
testing.asciidoc [DOCS] Test framework documentation 2013-12-02 18:01:45 +01:00