honeymoose
/
OpenSearch
mirror of https://github.com/honeymoose/OpenSearch.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
OpenSearch/docs/java-api/admin/indices/put-mapping.asciidoc

31 lines
1.3 KiB
Plaintext
Raw Normal View History

Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
[[java-admin-indices-put-mapping]]
[Docs] Fix Java Api index administration usage (#28260) The Java API documentation for index administration currenty is wrong because the PutMappingRequestBuilder#setSource(Object... source) an CreateIndexRequestBuilder#addMapping(String type, Object... source) methods delegate to methods that check that the input arguments are valid key/value pairs. This changes the docs so the java api code examples are included from documentation integration tests so we detect compile and runtime issues earlier. Closes #28131
2018-03-14 17:02:06 -04:00
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
==== Put Mapping
Make sure to use the type _doc in the REST documentation. (#34662) * Replace custom type names with _doc in REST examples. * Avoid using two mapping types in the percolator docs. * Rename doc -> _doc in the main repository README. * Also replace some custom type names in the HLRC docs.
2018-10-22 14:54:04 -04:00
You can add mappings at index creation time:
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
[DOCS] fix put_mapping snippet (#28814) Add a java snippet to be run in an integration test in order to guarantee that the snippet is correct Closes #28778
2018-03-01 04:59:52 -05:00
["source","java",subs="attributes,callouts,macros"]
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
--------------------------------------------------
[DOCS] fix put_mapping snippet (#28814) Add a java snippet to be run in an integration test in order to guarantee that the snippet is correct Closes #28778
2018-03-01 04:59:52 -05:00
include-tagged::{client-tests}/IndicesDocumentationIT.java[index-with-mapping]
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
--------------------------------------------------
<1> <<java-admin-indices-create-index,Creates an index>> called `twitter`
Make sure to use the type _doc in the REST documentation. (#34662) * Replace custom type names with _doc in REST examples. * Avoid using two mapping types in the percolator docs. * Rename doc -> _doc in the main repository README. * Also replace some custom type names in the HLRC docs.
2018-10-22 14:54:04 -04:00
<2> Add a `_doc` type with a field called `message` that has the datatype `text`.
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
Fix put mappings java API documentation (#31955) The current docs of the put-mapping Java API is currently broken. It its current form, it creates an index and uses the whole mapping definition given as a JSON string as the type name. Since we didn't check the index created in the IndicesDocumentationIT so far this went unnoticed. This change adds test to catch this error to the documentation test, changes the documentation so it works correctly now and adds an input validation to PutMappingRequest#buildFromSimplifiedDef() which was used internally to reject calls where no mapping definition is given. Closes #31906
2018-07-17 03:09:03 -04:00
There are several variants of the above `addMapping` method, some taking an
`XContentBuilder` or a `Map` with the mapping definition as arguments. Make sure
to check the javadocs to pick the simplest one for your use case.
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
Make sure to use the type _doc in the REST documentation. (#34662) * Replace custom type names with _doc in REST examples. * Avoid using two mapping types in the percolator docs. * Rename doc -> _doc in the main repository README. * Also replace some custom type names in the HLRC docs.
2018-10-22 14:54:04 -04:00
The PUT mapping API also allows for updating the mapping after index
creation. In this case you can provide the mapping as a String similar
to the REST API syntax:
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
[Docs] Fix Java Api index administration usage (#28260) The Java API documentation for index administration currenty is wrong because the PutMappingRequestBuilder#setSource(Object... source) an CreateIndexRequestBuilder#addMapping(String type, Object... source) methods delegate to methods that check that the input arguments are valid key/value pairs. This changes the docs so the java api code examples are included from documentation integration tests so we detect compile and runtime issues earlier. Closes #28131
2018-03-14 17:02:06 -04:00
["source","java",subs="attributes,callouts,macros"]
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
--------------------------------------------------
[Docs] Fix Java Api index administration usage (#28260) The Java API documentation for index administration currenty is wrong because the PutMappingRequestBuilder#setSource(Object... source) an CreateIndexRequestBuilder#addMapping(String type, Object... source) methods delegate to methods that check that the input arguments are valid key/value pairs. This changes the docs so the java api code examples are included from documentation integration tests so we detect compile and runtime issues earlier. Closes #28131
2018-03-14 17:02:06 -04:00
include-tagged::{client-tests}/IndicesDocumentationIT.java[putMapping-request-source]
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
--------------------------------------------------
<1> Puts a mapping on existing index called `twitter`
Make sure to use the type _doc in the REST documentation. (#34662) * Replace custom type names with _doc in REST examples. * Avoid using two mapping types in the percolator docs. * Rename doc -> _doc in the main repository README. * Also replace some custom type names in the HLRC docs.
2018-10-22 14:54:04 -04:00
<2> Adds a new field `name` to the mapping
<3> The type can be also provided within the source
Add documentation for Java API create index and put mapping Starting documentation about the admin client. * Create index with settings * put and update mapping. Closes #10816
2015-12-30 11:50:46 -05:00
[Docs] Fix Java Api index administration usage (#28260) The Java API documentation for index administration currenty is wrong because the PutMappingRequestBuilder#setSource(Object... source) an CreateIndexRequestBuilder#addMapping(String type, Object... source) methods delegate to methods that check that the input arguments are valid key/value pairs. This changes the docs so the java api code examples are included from documentation integration tests so we detect compile and runtime issues earlier. Closes #28131
2018-03-14 17:02:06 -04:00
:base-dir!: