If you autogen doc IDs, you cannot use the `{{_id}}` value in an ingest processor. This adds a related admonition to the ingest processor docs.
This commit is contained in:
parent
f1f275c91b
commit
1178f5c6db
|
@ -229,6 +229,7 @@ the index operation fails if a document with the specified ID
|
||||||
already exists in the index.
|
already exists in the index.
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
|
[[create-document-ids-automatically]]
|
||||||
===== Create document IDs automatically
|
===== Create document IDs automatically
|
||||||
|
|
||||||
When using the `POST /<target>/_doc/` request format, the `op_type` is
|
When using the `POST /<target>/_doc/` request format, the `op_type` is
|
||||||
|
|
|
@ -63,6 +63,13 @@ You can access metadata fields in the same way that you access fields in the sou
|
||||||
is possible because Elasticsearch doesn't allow fields in the source that have the
|
is possible because Elasticsearch doesn't allow fields in the source that have the
|
||||||
same name as metadata fields.
|
same name as metadata fields.
|
||||||
|
|
||||||
|
The following metadata fields are accessible by a processor:
|
||||||
|
|
||||||
|
* `_index`
|
||||||
|
* `_type`
|
||||||
|
* `_id`
|
||||||
|
* `_routing`
|
||||||
|
|
||||||
The following example sets the `_id` metadata field of a document to `1`:
|
The following example sets the `_id` metadata field of a document to `1`:
|
||||||
|
|
||||||
[source,js]
|
[source,js]
|
||||||
|
@ -76,7 +83,13 @@ The following example sets the `_id` metadata field of a document to `1`:
|
||||||
--------------------------------------------------
|
--------------------------------------------------
|
||||||
// NOTCONSOLE
|
// NOTCONSOLE
|
||||||
|
|
||||||
The following metadata fields are accessible by a processor: `_index`, `_type`, `_id`, `_routing`.
|
You can access a metadata field's value by surrounding it in double
|
||||||
|
curly brackets `"{{ }}"`. For example, `{{_index}}` retrieves the name of a
|
||||||
|
document's index.
|
||||||
|
|
||||||
|
WARNING: If you <<create-document-ids-automatically,automatically generate>>
|
||||||
|
document IDs, you cannot use the `{{_id}}` value in an ingest processor. {es}
|
||||||
|
assigns auto-generated `_id` values after ingest.
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
[[accessing-ingest-metadata]]
|
[[accessing-ingest-metadata]]
|
||||||
|
|
Loading…
Reference in New Issue