ElasticSearch-API-Index
索引创建API允许初始化一个索引。ElasticSearch对多重索引提供了支持,包括跨多个索引执行操作。每个索引在创建时可以让一个特定的设置项与其关联。
-
最简单的方式创建索引
curl -XPUT ‘http://localhost:9200/twitter/‘
-
在创建索引的时候指定分片和副本数量,参数格式采用YAML格式
curl -XPUT ‘http://localhost:9200/twitter/‘ -d ‘ index: number_of_shards:3 number_of_replicas:2 ‘
-
在创建索引的时候指定分片和副本数量参数,参数格式采用JSON格式
curl -XPUT ‘http://localhost:9200/twitter/‘ -d ‘{ “settings”:{ “index”:{ “number_of_shards”:3, “number_of_replicas”:2 } } }’
或者简化为
curl -XPUT ‘http://localhost:9200/twitter’ -d ‘{ “settings”:{ “number_of_shards”:3, “number_of_replicas”:2 } }’
*请注意,你不需要在settings项中显示的指定index。
-
索引创建API可以接受一个或者一组映射选项
curl -XPOST localhost:9200/test -d ‘{ “settings”:{ “number_of_shards”:1 }, “mappings”:{ “type1”:{ “_source”:{“enabled”:false}, “preperties”:{ “field1”:{“type”:”string”, ”index”:”not_analyzed” } } } } }’
-
REST风格的插入方式。
curl -XPOST http://localhost:9200/索引名称/索引类型/id -d JSON格式的参数
比如插入”twitter”的索引,并且索引类型为tweet
curl -XPUT ‘http://localhost:9200/twitter/tweet/1’ -d ‘{ “user”:”kimchy”, “post_date”:”2012-12-12”, “message”:”trying out ElasticSearch!” }’
添加成功后,其会返回操作状态,索引、类型、id等信息如上例中返回信息
{ "ok" : true, "_index" : "twitter", "_type" : "tweet", "_id" : "1" }
-
每一个被索引的文档都会有一个版本号,被关联的版本号会作为index API的请求的响应信息一部分返回回来。因此,我们可以在对索引操作的时候,指定特定的版本号,操作对应版本的文档。例如
curl -XPUT ‘localhost:9200/twitter/tweet/1?version=2’ -d ‘{ “message”:”elasticsearch now has versioning support,double cool!” }’
*注意 1.版本控制完全是实时的,不会影响接近实时方面的查询操作。如果版本已经被提供了,那么操作执行检查所有的版本。 2.默认情况下,版本从1开始,自增因子为1。
-
op_type。索引操作也接受参数op_type,用来强制创建索引的操作。如果索引尚未建立的时候,可以接受这样的行为,但是当文档的缩影已经存在的时候,该操作会将失败。 下面是一个op_type参数的例子
curl -XPUT ‘http://localhost:9200/twitter/tweet/1?op_type=create’ -d ‘{ “user”:”kimchy”, “post_date”:”2014-12-05T14:12:12”, “message”:”trying out Elastic Searche” }’
另外的一种create方式
curl -XPUT ‘http://localhost:9200/twitter/tweet/1/_create’ -d ‘{ “user”:”kimchy”, “post_date”:”2009-11-11T14:12:12”, “message”:”hello,world” }’
-
自动生成Id.在创建一个Index的操作中,如果没有指定id,系统将会自动地为其生成一个id.
curl -XPOST ‘http://localhost:9200/twitter/tweet/‘ -d ‘{ “user”:”kimchy”, “post_date”:”2013-11-12T12:12:12”, “message”:”Hello,world” }’
操作响应的结果如下
{ “ok”:true, “_index”:”twitter”, “_type”:”tweet”, “_id”:”6a8ca01c-7896-48e9-81cc-9f70661fcb32” }
-
路由(Routing)。默认情况下,分片或路由是通过计算文档的hash值来控制的,为了更明确的控制值,送入路由器使用hash函数计算hash值的操作可以通过routing参数来控制。
curl -XPOST ‘http://localhost:9200/twitter/tweet?routing=kimchy’ -d ‘{ “user”:”kimchy”, “post_date”:”2014-12-12T12:12:12” }’
-
TTL。一个文档建立索引的时候,能够为其指定ttl。
curl -XPUT ‘http://localhost:9200/twitter/tweet/1?ttl=86400000‘ -d ‘{ "user": "kimchy", "message": "Trying out elasticsearch, so far so good?" }‘
curl -XPUT ‘http://localhost:9200/twitter/tweet/1?ttl=1d‘ -d ‘{ "user": "kimchy", "message": "Trying out elasticsearch, so far so good?" }‘
curl -XPUT ‘http://localhost:9200/twitter/tweet/1‘ -d ‘{ "_ttl": "1d", "user": "kimchy", "message": "Trying out elasticsearch, so far so good?" }‘
更过信息请浏览_ttl mapping page
想要关注更多不同的,可以在创建索引时设置索引级选项,请看index modules。
本文参考信息来自elasticSearch中文社区