Create Index /創建索引 · my-elasticsearch-cn

# Create Index /創建索引注意：涉及翻譯內容： Index-索引；types-類型；mapping-映射；aliases-別名；shards-分片；replicas-副本創建索引（index API）允許實例化一個索引。Elasticsearch提供支持多種索引,包括跨多個索引執行操作。 # Index Settings/索引設置每個索引創建的時候可以包含與之關聯的特定設置。 | `curl -XPUT?``'localhost:9200/twitter?pretty'`?`-d'` `{` `"settings"`?`: {` `"index"`?`: {` `"number_of_shards"`?`:?``3``,` `"number_of_replicas"`?`:?``2` `}` `}` `}'` | | [![](https://www.elastic.co/guide/en/elasticsearch/reference/current/images/icons/callouts/1.png)](https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html#CO119-1) | ?默認?`number_of_shards`?為 5 | | [![](https://www.elastic.co/guide/en/elasticsearch/reference/current/images/icons/callouts/2.png)](https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html#CO119-2) | 默認?`number_of_replicas`?為 1 (對于主 shard 只有一個副本) | 上述 curl 命令創建了一個 twitter 索引，可以通過?[YAML](http://www.yaml.org/)?或者?[JSON](http://www.json.org/)?設定其分片和副本，下述創建了3個分片，2個副本的索引： | `curl -XPUT?``'localhost:9200/twitter?pretty'`?`-d'` `{` `"settings"`?`: {` `"index"`?`: {` `"number_of_shards"`?`:?``3``,` `"number_of_replicas"`?`:?``2` `}` `}` `}'` | ?或者簡化為： ? | `curl -XPUT?``'localhost:9200/twitter?pretty'`?`-d'` `{` `"settings"`?`: {` `"number_of_shards"`?`:?``3``,` `"number_of_replicas"`?`:?``2` `}` `}'` | 注意：你不需要顯式的在?`settings`?中指定?`index`?。關于在創建索引時所有不同的索引級別設置,請看?[index modules](https://www.elastic.co/guide/en/elasticsearch/reference/current/index-modules.html "Index Modules")?部分。 # Mappings/映射創建索引允許提供包含一個或多個映射的設置： | `curl -XPUT?``'localhost:9200/test?pretty'`?`-d'` `{` `"settings"`?`: {` `"number_of_shards"`?`:?``1` `},` `"mappings"`?`: {` `"type1"`?`: {` `"properties"`?`: {` `"field1"`?`: {?``"type"`?`:?``"text"`?`}` `}` `}` `}` `}'` | # Aliases/別名創建索引可以設置其別名： | `curl -XPUT?``'localhost:9200/test?pretty'`?`-d'` `{` `"aliases"`?`: {` `"alias_1"`?`: {},` `"alias_2"`?`: {` `"filter"`?`: {` `"term"`?`: {``"user"`?`:?``"kimchy"`?`}` `},` `"routing"`?`:?``"kimchy"` `}` `}` `}'` | # Wait For Active Shards/等待激活分片數量默認情況下,創建索引會在必要主分片已經創建成功并運行或請求超時后返回HTTP響應。創建索引的返回的響應: | `{` `"acknowledged"``:?``true``,` `"shards_acknowledged"``:?``true` `}` | `acknowledged`?表示是否在集群成功創建索引, 同時?`shards_acknowledged`?表示是否在超時之前成功創建運行必要的分片。?注意?`acknowledged`?和?`shards_acknowledged`?可能返回?`false`, 但是索引創建成功。這些值只是表明是否操作在超時之前完成。如果?`acknowledged`?是?`false`, 表示我們對集群更新新創建的索引操作超時，但它可能很快將被創建。如果?`shards_acknowledged`?是?`false`,表示我們必要的分片啟動?操作超時（默認只為主分片），即使集群成功更新新創建的索引?(i.e.?`acknowledged=true`). 我們可以通過設置?`index.write.wait_for_active_shards`?來改變默認的設置（注意：更改此設置也會影響 ?`wait_for_active_shards`??值在所有隨后的寫操作） | `curl -XPUT?``'localhost:9200/test?pretty'`?`-d'` `{` `"settings"``: {` `"index.write.wait_for_active_shards"``:?``"2"` `}` `}'` | 或者通過請求參數?`wait_for_active_shards`: ? | `curl -XPUT?``'localhost:9200/test?wait_for_active_shards=2&pretty'` | 有關 wait_for_active_shards 及其可能的值可以在?[here](https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-index_.html#index-wait-for-active-shards "Wait For Active Shardsedit")?找到。