目录
Elasticsearch中的index相当于RDBMS(关系型数据库, 比如MySQL)中的DataBase.
本篇文章通过Kibana插件, 演示了ES的基础语法: 对ES中的index进行CRUD(增删改查)以及关闭、开启操作.
阅读须知:
在ES 6.x之前的版本中, 每个index中可以有多个type, 类似于MySQL中每个数据库可以有多张表, 可在ES 6.0开始, 每个index都只能有1个type.
本篇文章写作较早, 用的是ES 5.6版本, 因此有些操作可能出现不支持等问题, 还请读者查阅解决:-)
1 创建index（配置mapping[映射]）
(1) 创建语法:
PUT index{ "settings": { ... some settings ... }, "mappings": { // ES 6.x开始不再支持1个index中同时存在多个type "type1": { ... some mappings ... }, "type2": { ... some mappings ... }, ... }} 如果不指定settings和mappings, 直接插入数据时, ES会根据要插入数据的类型, 自动创建相关配置 —— 功能强大, 但扩展性不够, 后续若有其他原因需要修改mappings, 会很困难.
—— 所以创建index时, 推荐手动指定settings和mappings的相关配置. 可以参考文章: .
(2) 创建示例:
PUT address // 关于地址(address)的索引{ "settings": { "number_of_shards": 1, // 默认分片数为5 "number_of_replicas": 0 // 默认副本数为1 }, "mappings": { "province": { // type是province(省份) "properties": { "name": { "type": "text" // 存储类型是text }, "area": { "type": "float" } } } }} (3) 创建结果:
{ "acknowledged": true, "shards_acknowledged": true, "index": "address"} 2 查看index
(1) 查看示例:
GET address// 也可同时查看多个索引, 类似于删除操作: GET *GET _allGET *index*GET address,shop// 在6.0之前的版本中, 还可以指定返回某些指定项的结果:GET address/_settings,_mappings
- 弃用提示:
查看索引时, 若通过","分隔要返回的结果, Elasticsearch将抛出如下警告:
#! Deprecation: Requesting comma-separated features is deprecated and will be removed in 6.0+, retrieve all features instead.意为: Elasticsearch不推荐使用逗号分隔功能, 将在6.0+中删除. 建议不要使用",", 而是直接检索全部数据, 或检索某一项的结果.
在ES 6.6.0中将直接出现:
{ "error": "Incorrect HTTP method for uri [/address/_settings,_mappings?pretty] and method [GET], allowed: [POST]", "status": 405}换做POST请求时, 必须携带请求体, 仍然不支持.
(2) 查看的结果:
{ "address": { "aliases": {}, "mappings": { "province": { "properties": { "area" : { "type" : "float" }, "name" : { "type" : "text" } } } }, "settings": { "index": { "creation_date": "1542108754899", "number_of_shards": "1", "number_of_replicas": "0", "uuid": "MMpLNHzZR8K1k48rJplWVw", "version": { "created": "6060099" }, "provided_name": "address" } } }} 3 修改index
修改索引的示例:
PUT address/_settings{ "number_of_replicas": 1 // 修改副本数为1} 说明: Elasticsearch中的分片数(number_of_shards)只能在创建索引时设置, 无论是否添加过数据, 都不支持修改.
这与文档的路由有关, 而Solr的
关于修改ES的分片数, 应该有其他思路, 后期了解到再作研究整理.SPLITSHARD可以算作动态修改分片的另一种思路: 只对某一路由范围内的进行拆分, 可以参考 第5节的内容.
4 删除index
删除索引需要指明索引名称、别名或通配符.
Elasticsearch支持同时删除多个索引, 或使用_all或通配符*删除全部索引.
删除示例:
DELETE address // 删除指定索引DELETE index1,index2 // 删除多个索引DELETE index_* // 按通配符删除以'index_'开头的索引DELETE _all // 删除全部索引
为避免_all操作误删除全部索引, 可在配置文件elasticsearch.yml中作如下配置:
# 要求操作索引时必须指定索引的名称action.destructive_requires_name: true
5 打开/关闭index
(1) 操作说明:
① 可以打开一个已经打开/关闭的索引, 以最后一次操作为准;
② 可以关闭一个已经关闭/打开的索引, 以最后一次操作为准; ③ 关闭的索引只能查看index的配置信息, 不能对内部的索引数据进行读写操作.
(2) 操作示例:
// 可以使用_all打开或关闭全部索引, 也可使用通配符(*)配合操作POST address/_closePOST address/_open
说明事项:
① 使用
② 关闭的索引会继续占用磁盘空间, 却又不能使用 —— 造成磁盘空间的浪费. ③ 可以在配置文件中禁止使用关闭索引的功能:_all或通配符操作索引, 都会受到配置文件中action.destructive_requires_name=true的限制.settingscluster.indices.close.enable=false, 默认为true(开启).
6 常见问题及解决方法
(1) 查看不存在的索引时, 将抛出如下错误信息:
如果要查看的索引不存在, 比如GET addre, 就会抛出类似下面的异常信息:
{ "error" : { "root_cause" : [ { "type" : "index_not_found_exception", "reason" : "no such index", "resource.type" : "index_or_alias", "resource.id" : "addre", "index_uuid" : "_na_", "index" : "addre" } ], "type" : "index_not_found_exception", "reason" : "no such index", "resource.type" : "index_or_alias", "resource.id" : "addre", "index_uuid" : "_na_", "index" : "addre" }, "status" : 404} (2) 在6.0之前的版本中, 如果修改已经关闭了的索引, 会抛出类似于下面的错误:
{ "error": { "root_cause": [ { "type": "illegal_argument_exception", "reason": "Can't update [index.number_of_replicas] on closed indices [[address/MMpLNHzZR8K1k48rJplWVw]] - can leave index in an unopenable state" } ], "type": "illegal_argument_exception", "reason": "Can't update [index.number_of_replicas] on closed indices [[address/MMpLNHzZR8K1k48rJplWVw]] - can leave index in an unopenable state" }, "status": 400} 在本篇博客演示所用的Elasticsearch 6.6.0版本中, 并不存在此异常信息.
版权声明
作者:
出处: 博客园
感谢阅读, 如果文章有帮助或启发到你, 点个[好文要顶?] 或 [推荐?] 吧?
本文版权归博主所有, 欢迎转载, 但 [必须在文章页面明显位置标明原文链接], 否则博主保留追究相关人员法律责任的权利.