39 lines
946 B
Plaintext
39 lines
946 B
Plaintext
[[mapping-id-field]]
|
|
=== `_id` field
|
|
|
|
Each document indexed is associated with a <<mapping-type-field,`_type`>> (see
|
|
<<mapping-type>>) and an <<mapping-id-field,`_id`>>. The `_id` field is not
|
|
indexed as its value can be derived automatically from the
|
|
<<mapping-uid-field,`_uid`>> field.
|
|
|
|
The value of the `_id` field is accessible in certain queries (`term`,
|
|
`terms`, `match`, `query_string`, `simple_query_string`), but
|
|
_not_ in aggregations, scripts or when sorting, where the <<mapping-uid-field,`_uid`>>
|
|
field should be used instead:
|
|
|
|
[source,js]
|
|
--------------------------
|
|
# Example documents
|
|
PUT my_index/my_type/1
|
|
{
|
|
"text": "Document with ID 1"
|
|
}
|
|
|
|
PUT my_index/my_type/2&refresh=true
|
|
{
|
|
"text": "Document with ID 2"
|
|
}
|
|
|
|
GET my_index/_search
|
|
{
|
|
"query": {
|
|
"terms": {
|
|
"_id": [ "1", "2" ] <1>
|
|
}
|
|
}
|
|
}
|
|
--------------------------
|
|
// CONSOLE
|
|
|
|
<1> Querying on the `_id` field (also see the <<query-dsl-ids-query,`ids` query>>)
|