Skip to content

Commit

Permalink
Document that _index is a virtual field and only supports term queries
Browse files Browse the repository at this point in the history
Closes #15070
Closes #15081
  • Loading branch information
clintongormley committed Nov 30, 2015
1 parent 1685126 commit 72be42d
Showing 1 changed file with 11 additions and 4 deletions.
15 changes: 11 additions & 4 deletions docs/reference/mapping/fields/index-field.asciidoc
Original file line number Diff line number Diff line change
@@ -1,10 +1,17 @@
[[mapping-index-field]]
=== `_index` field

When performing queries across multiple indexes, it is sometimes desirable
to add query clauses that are associated with documents of only certain
indexes. The `_index` field allows matching on the index a document was
indexed into. Its value is accessible in queries, aggregations, scripts, and when sorting:
When performing queries across multiple indexes, it is sometimes desirable to
add query clauses that are associated with documents of only certain indexes.
The `_index` field allows matching on the index a document was indexed into.
Its value is accessible in `term`, or `terms` queries, aggregations,
scripts, and when sorting:

NOTE: The `_index` is exposed as a virtual field -- it is not added to the
Lucene index as a real field. This means that you can use the `_index` field
in a `term` or `terms` query (or any query that is rewritten to a `term`
query, such as the `match`, `query_string` or `simple_query_string` query),
but it does not support `prefix`, `wildcard`, `regexp`, or `fuzzy` queries.

[source,js]
--------------------------
Expand Down

0 comments on commit 72be42d

Please sign in to comment.