honeymoose
/
OpenSearch
mirror of https://github.com/honeymoose/OpenSearch.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
OpenSearch/docs/reference/indices.asciidoc

109 lines
2.0 KiB
Plaintext
Raw Normal View History

Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
[[indices]]
= Indices APIs
[partintro]
--
The indices APIs are used to manage individual indices,
Remove warmers and the warmer API. Warmers are now barely useful and will be removed in 3.0. Note that this only removes the warmer API and query-based warmers. We still have warmers internally for eg. global ordinals. Close #15607
2015-12-22 11:08:35 -05:00
index settings, aliases, mappings, and index templates.
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
[float]
Add more anchor links to documentation Related to #3679
2013-09-25 12:17:40 -04:00
[[index-management]]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
== Index management:
* <<indices-create-index>>
* <<indices-delete-index>>
Indices API: Added GET Index API Returns information about settings, aliases, warmers, and mappings. Basically returns the IndexMetadata. This new endpoint replaces the /{index}/_alias|_aliases|_mapping|_mappings|_settings|_warmer|_warmers and /_alias|_aliases|_mapping|_mappings|_settings|_warmer|_warmers endpoints whilst maintaining the same response formats. The only exception to this is on the /_alias|_aliases|_warmer|_warmers endpoint which will now return a section for 'aliases' or 'warmers' even if no aliases or warmers exist. This backwards compatibility change is documented in the reference docs. Closes #4069
2014-08-12 06:42:12 -04:00
* <<indices-get-index>>
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
* <<indices-exists>>
* <<indices-open-close>>
Add primitive to shrink an index into a single shard (#18270) This adds a low level primitive operations to shrink an existing index into a new index with a single shard. This primitive expects all shards of the source index to allocated on a single node. Once the target index is initializing on the shrink node it takes a snapshot of the source index shards and copies all files into the target indices data folder. An [optimization](https://issues.apache.org/jira/browse/LUCENE-7300) coming in Lucene 6.1 will also allow for optional constant time copy if hard-links are supported by the filesystem. All mappings are merged into the new indexes metadata once the snapshots have been taken on the merge node. To shrink an existing index all shards must be moved to a single node (one instance of each shard) and the index must be read-only: ```BASH $ curl -XPUT 'http://localhost:9200/logs/_settings' -d '{ "settings" : { "index.routing.allocation.require._name" : "shrink_node_name", "index.blocks.write" : true } } ``` once all shards are started on the shrink node. the new index can be created via: ```BASH $ curl -XPUT 'http://localhost:9200/logs/_shrink/logs_single_shard' -d '{ "settings" : { "index.codec" : "best_compression", "index.number_of_replicas" : 1 } }' ``` This API will perform all needed check before the new index is created and selects the shrink node based on the allocation of the source index. This call returns immediately, to monitor shrink progress the recovery API should be used since all copy operations are reflected in the recovery API with byte copy progress etc. The shrink operation does not modify the source index, if a shrink operation should be canceled or if the shrink failed, the target index can simply be deleted and all resources are released.
2016-05-31 04:41:44 -04:00
* <<indices-shrink-index>>
add documentation
2016-06-08 18:32:22 -04:00
* <<indices-rollover-index>>
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
[float]
Add more anchor links to documentation Related to #3679
2013-09-25 12:17:40 -04:00
[[mapping-management]]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
== Mapping management:
* <<indices-put-mapping>>
Add a GetFieldMapping API This new API allows to get the mapping for a specific set of fields rather than get the whole index mapping and traverse it. The fields to be retrieved can be specified by their full path, index name and field name and will be resolved in this order. In case multiple field match, the first one will be returned. Since we are now generating the output (rather then fall back to the stored mapping), you can specify `include_defaults`=true on the request to have default values returned. Closes #3941
2013-10-14 02:53:07 -04:00
* <<indices-get-mapping>>
* <<indices-get-field-mapping>>
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
* <<indices-types-exists>>
[float]
Add more anchor links to documentation Related to #3679
2013-09-25 12:17:40 -04:00
[[alias-management]]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
== Alias management:
* <<indices-aliases>>
[float]
Add more anchor links to documentation Related to #3679
2013-09-25 12:17:40 -04:00
[[index-settings]]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
== Index settings:
* <<indices-update-settings>>
* <<indices-get-settings>>
* <<indices-analyze>>
* <<indices-templates>>
[float]
Add more anchor links to documentation Related to #3679
2013-09-25 12:17:40 -04:00
[[monitoring]]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
== Monitoring:
* <<indices-stats>>
* <<indices-segments>>
Recovery API Adds a new API endpoint at /_recovery as well as to the Java API. The recovery API allows one to see the recovery status of all shards in the cluster. It will report on percent complete, recovery type, and which files are copied. Closes #4637
2014-02-18 17:28:49 -05:00
* <<indices-recovery>>
Docs: Indices shards stores page wasn't included in the indices APIs
2015-07-18 06:03:59 -04:00
* <<indices-shards-stores>>
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
[float]
Add more anchor links to documentation Related to #3679
2013-09-25 12:17:40 -04:00
[[status-management]]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
== Status management:
* <<indices-clearcache>>
* <<indices-refresh>>
* <<indices-flush>>
Add Force Merge API, deprecate Optimize API This adds an API for force merging lucene segments. The `/_optimize` API is now deprecated and replaced by the `/_forcemerge` API, which has all the same flags and action, just a different name.
2015-09-17 16:36:25 -04:00
* <<indices-forcemerge>>
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
--
include::indices/create-index.asciidoc[]
include::indices/delete-index.asciidoc[]
Indices API: Added GET Index API Returns information about settings, aliases, warmers, and mappings. Basically returns the IndexMetadata. This new endpoint replaces the /{index}/_alias|_aliases|_mapping|_mappings|_settings|_warmer|_warmers and /_alias|_aliases|_mapping|_mappings|_settings|_warmer|_warmers endpoints whilst maintaining the same response formats. The only exception to this is on the /_alias|_aliases|_warmer|_warmers endpoint which will now return a section for 'aliases' or 'warmers' even if no aliases or warmers exist. This backwards compatibility change is documented in the reference docs. Closes #4069
2014-08-12 06:42:12 -04:00
include::indices/get-index.asciidoc[]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
include::indices/indices-exists.asciidoc[]
include::indices/open-close.asciidoc[]
Include shrink-index.asciidoc
2016-05-31 05:50:50 -04:00
include::indices/shrink-index.asciidoc[]
[DOCS] fix missing rollover-index link
2016-06-17 12:14:45 -04:00
include::indices/rollover-index.asciidoc[]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
include::indices/put-mapping.asciidoc[]
include::indices/get-mapping.asciidoc[]
Add a GetFieldMapping API This new API allows to get the mapping for a specific set of fields rather than get the whole index mapping and traverse it. The fields to be retrieved can be specified by their full path, index name and field name and will be resolved in this order. In case multiple field match, the first one will be returned. Since we are now generating the output (rather then fall back to the stored mapping), you can specify `include_defaults`=true on the request to have default values returned. Closes #3941
2013-10-14 02:53:07 -04:00
include::indices/get-field-mapping.asciidoc[]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
include::indices/types-exists.asciidoc[]
include::indices/aliases.asciidoc[]
include::indices/update-settings.asciidoc[]
include::indices/get-settings.asciidoc[]
include::indices/analyze.asciidoc[]
include::indices/templates.asciidoc[]
include::indices/stats.asciidoc[]
include::indices/segments.asciidoc[]
Recovery API Adds a new API endpoint at /_recovery as well as to the Java API. The recovery API allows one to see the recovery status of all shards in the cluster. It will report on percent complete, recovery type, and which files are copied. Closes #4637
2014-02-18 17:28:49 -05:00
include::indices/recovery.asciidoc[]
Docs: Incorrect file name for shard stores
2015-07-18 06:08:46 -04:00
include::indices/shard-stores.asciidoc[]
Docs: Indices shards stores page wasn't included in the indices APIs
2015-07-18 06:03:59 -04:00
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00
include::indices/clearcache.asciidoc[]
include::indices/flush.asciidoc[]
include::indices/refresh.asciidoc[]
Add Force Merge API, deprecate Optimize API This adds an API for force merging lucene segments. The `/_optimize` API is now deprecated and replaced by the `/_forcemerge` API, which has all the same flags and action, just a different name.
2015-09-17 16:36:25 -04:00
include::indices/forcemerge.asciidoc[]
Migrated documentation into the main repo
2013-08-28 19:24:34 -04:00