在Elasticsearch所有的API中,对应的是一个或者多个索引。Elasticsearch可以对一个或者多个索引指定别名,通过别名可以查询到一个或者多个索引的内容。在内部,Elasticsearch会自动把别名映射到相应的索引上。可以对别名编写过滤器或者路由,在系统中别名不能重复,也不能和索引名重复。其实Elasticsearch的别名机制有点像数据库中的视图。例如:为索引test1增加一个别名alias1。
请求:POST http://127.0.0.1:9200/_aliases
参数:{"actions": [{"add": {"index": "secisland", "alias": "alias1"}}]}
删除别名,与请求是一样的,参数不一样。
参数:{"actions": [{"remove": {"index": "test1", "alias": "alias1"}}]}
注意,别名没有修改的语法,当需要修改别名的时候,可以先删除别名,然后再增加别名,例如:
参数:{"actions": [{"remove": {"index": "test1", "alias": "alias1"}}, "add": {"index": "test1", "alias": "alias2"}]}
一个别名关联多个索引。
参数:{"actions": {"add": {"indices": ["test1", "test2"], "alias": "alias1"}}}
或者使用通配符。
参数:{"actions": [{"add": {"index": "test*", "alias": "all_test_indices"}}]}
注:通配符指定的索引只是在当前生效,后面添加的索引不会被自动添加到别名上。对某一别名做索引的时候,如果该别名关联多个索引会报错。
1、过滤索引别名
通过过滤索引来指定别名提供了对索引查看的不同视图,该过滤器可以使用查询DSL来定义适用于所有的搜索,计算,查询删除等,以及更多类似这样的与此别名的操作。
要创建一个带过滤的别名,首先我们需要确保映射中已经存在需要过滤的字段:
创建一个索引,请求:PUT http://127.0.0.1:9200/test1
参数:{"mappings": {"type1": {"properties": {"user": {"type": "string", "index": "not_analyzed"}}}}}
创建过滤别名,请求:POST http://127.0.0.1:9200/_aliases
参数:{"actions": [{"add": {"index": "test1", "alias": "alias2", "filter": {"term": {"user": "kimchy"}}}}]}
通过别名也可以和路由关联,此功能可以和过滤别名命令一起使用,以避免不必要的碎片操作。
请求:POST http://127.0.0.1:9200/_aliases
参数:{"actions": [{"add": {"index": "test", "alias": "alias1", "routing": "1"}}]}
同时可以指定搜索路由或者查询路由。
参数:{"actions": [{"add": {"index": "test", "alias": "alias2", "search_routing": "1,2", "index_routing": "2"}}]}
注意,搜索路由可以指定多个值,索引路由只能指定一个值。如果使用路由别名操作的同时还有路由参数,则结果是别名路由和路由的交集。例如以下命令将使用“2”作为路由值:
请求 GET http://127.0.0.1:9200/alias2/_search?q=user:kimchy&routing=2,3
通过参数添加别名。
语法:PUT /{index}/_alias/{name}
参数:{"routing": "1", "filter": {}}
条件解释:
1) index:参照的索引,可以使用“*”,_all,正则表达式或者逗号分开的多个name1,name2,...
2) name:别名的名称。
3) routing:别名对应的路由。
4) filter:指定别名时候的过滤条件。
例如:PUT http://127.0.0.1:9200/secisland/_alias/2013
例如一个索引。
请求:PUT http://127.0.0.1:9200/secisland
参数:{"mappings": {"secilog": {"properties": {"user_id": {"type": "integer"}}}}}
指定别名。
请求:PUT http://127.0.0.1:9200/secisland/_alias/user_12
参数:{"routing": 12, "filter": {"term": {"user_id": 12}}}
创建索引的时候同时指定别名。
请求:PUT http://127.0.0.1:9200/secisland
参数:{"mappings": {"type": {"properties": {"year": {"type": "integer"}}}}, "aliases": {"current_day": {}, "2014": {"filter": {"term": {"year": 2014}}}}}
2、删除别名
语法:DELETE http://{host}:{port}/{index}/_alias/{name}
例如:DELETE http://127.0.0.1:9200/secisland/_alias/user_12
3、查询现有的别名
可以通过索引名或者别名进行查询。参数如下:
1) index:索引别名的名称。部分名称支持通配符,用逗号分割也可以指定多个索引名称,还可以使用索引的别名名称。
2) alias:在响应中返回的别名名称。该参数支持通配符和用逗号分隔的多个别名。
3) ignore_unavailable:如果一个指定的索引名称不存在该怎么办。如果设置为true,那么这些索引将被忽略。
语法:GET http://{host}:{port}/{index}/_alias/{alias}
例如:GET http://127.0.0.1:9200/secisland/_alias/*
返回值:{"secisland": {"aliases": {"user_13": {"filter": {"term": {"user_id": 13}}, "index_routing": "13", "search_routing": "13"}, "user_14": {"filter": {"term": {"user_id": 14}}, "index_routing": "14", "search_routing": 14"}}}}
下面的例子中包括所有别名为2013的。
请求:GET http://127.0.0.1:9200/_alias/2013
返回值:{"logs_201304": {"aliases": {"2013": {}}}, "logs_201305": {"aliases": {"2013": {}}}}
请求:GET http://127.0.0.1:9200/_alias/2013_01*
返回值:{"logs_20130101": {"aliases": {"2013_01": {}}}}
用HEAD也可以检查别名是否存在,语法和GET类型,例如:
HEAD http://127.0.0.1:9200/_alias/2013
HEAD http://127.0.0.1:9200/_alias/2013_01*
HEAD http://127.0.0.1:9200/users/_alias/*
网友评论