Skip to content

Commit

Permalink
[DOCS] Clarifying docs around multi-resource reads and writes
Browse files Browse the repository at this point in the history
fixes #990
  • Loading branch information
jbaiera committed Jun 13, 2017
1 parent 0986a78 commit 4d36e16
Showing 1 changed file with 6 additions and 3 deletions.
9 changes: 6 additions & 3 deletions docs/src/reference/asciidoc/core/configuration.adoc
Expand Up @@ -26,9 +26,12 @@ es.resource = twitter/tweet # index 'twitter', type 'tweet'
`es.resource.write`(defaults to `es.resource`)::
{es} resource used for writing (but not reading) data. Used typically for __dynamic resource__ writes or when writing and reading data to different {es} indices within the _same_ job. Typically set automatically (except for the {mr} module which requires manual configuration).

Note that https://www.elastic.co/guide/en/elasticsearch/guide/current/multi-index-multi-type.html[multiple] indices and/or types are allowed *only* for reading. Use `_all/types` to search `types` in all indices or `index/` to search
all types within `index`.
Do note that reading multiple indices/types typically works only when they have the same structure and only with some libraries. Integrations that require a strongly typed mapping (such as a table like Hive or SparkSQL) are likely to fail.
Note that specifying https://www.elastic.co/guide/en/elasticsearch/guide/current/multi-index-multi-type.html[multiple]
indices and/or types in the above resource settings are allowed *only* for reading. Specifying multiple indices for
writes is only supported through the use of dynamic resource (described <<cfg-multi-writes, below>>). Use `_all/types`
to search `types` in all indices or `index/` to search all types within `index`. Do note that reading multiple
indices/types typically works only when they have the same structure and only with some libraries. Integrations that
require a strongly typed mapping (such as a table like Hive or SparkSQL) are likely to fail.

[[cfg-multi-writes]]
[float]
Expand Down

0 comments on commit 4d36e16

Please sign in to comment.