ElasticSearch之Clone index API

合集 - ElasticSearch(59)

46.ElasticSearch之Clone index API2023-12-02

47.ElasticSearch之Close index API2023-12-02 48.ElasticSearch之Open index API2023-12-02 49.ElasticSearch之Delete index API2023-12-02 50.ElasticSearch之Exists API2023-12-02 51.ElasticSearch之Get index API2023-12-02 52.ElasticSearch之Get index settings API2023-12-02 53.ElasticSearch之Index stats API2023-12-02 54.ElasticSearch之Refresh API2023-12-02 55.ElasticSearch之Shard request cache settings2023-12-09 56.ElasticSearch之Node query cache settings2023-12-11 57.ElasticSearch之Index modules2023-12-17 58.ElasticSearch之集群中的节点2024-10-05 59.ElasticSearch之网络配置2024-10-06

使用已有的索引，复制得到一个索引。

关闭testindex_001的写入操作，命令样例如下：

 curl -X PUT "https://localhost:9200/testindex_001/_settings?pretty" -H 'Content-Type: application/json' -d'
{
  "settings": {
    "index.blocks.write": true
  }
}
' --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"

通过复制testindex_001来创建新的index，命令样例如下：

 curl -X POST "https://localhost:9200/testindex_001/_clone/cloned-testindex_001?pretty" --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"

执行结果的样例，如下：

 {
  "acknowledged" : true
}

或者使用PUT方法，命令样例如下：

 curl -X PUT "https://localhost:9200/testindex_001/_clone/cloned-testindex_002?pretty" --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"

执行结果的样例，如下：

 {
  "acknowledged" : true,
  "shards_acknowledged" : true,
  "index" : "cloned-testindex_002"
}

假如复制前没有关闭写入，复制操作将失败，提示信息，样例如下：

 {
  "error" : {
    "root_cause" : [
      {
        "type" : "illegal_state_exception",
        "reason" : "index testindex_001 must be read-only to resize index. use \"index.blocks.write=true\""
      }
    ],
    "type" : "illegal_state_exception",
    "reason" : "index testindex_001 must be read-only to resize index. use \"index.blocks.write=true\""
  },
  "status" : 500
}

恢复testindex_001的写入操作，命令样例如下：

 curl -X PUT "https://localhost:9200/testindex_001/_settings?pretty" -H 'Content-Type: application/json' -d'
{
  "settings": {
    "index.blocks.write": false
  }
}
' --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"

执行结果的样例，如下：

 {
  "acknowledged" : true
}

实现原理
复制的操作过程：

依据源索引的参数和数据，使用目标索引的名称，创建一个新的索引对象。
将源索引相关的segment的对象和文件，关联至目标索引。
- 假如节点的运行平台的文件系统支持POSIX语义中的硬链接，则使用硬链接方式。
- 假如节点的运行平台的文件系统不支持POSIX语义中的硬链接，则使用复制方式，相对要耗时，同时占用存储空间。
更新目标索引的状态，类似关闭后重新打开的索引。

约束项：

目标索引的名称需要符合命名规范。
目标索引不存在存在，否则复制操作将失败。
目标索引和源索引，主分片的数量需要一致。
参与复制操作的节点，需要有充足的存储空间来容纳新的索引的分片和副本。

方法参数
参考Create index API。
方法的请求消息体
参考Create index API。

方法的响应消息体
参考Create index API。

相关资料

posted @ 2023-12-02 15:37 jackieathome 阅读(65) 评论(0) 编辑收藏举报

刷新页面返回顶部

登录后才能查看或发表评论，立即登录或者逛逛博客园首页

相关博文：

· ElasticSearch之Get index API

· ElasticSearch之Close index API

· elasticsearch 索引复制（含数据）

· ES（Elasticsearch）将一个索引数据复制到另一个新索引中

· ElasticSearch 重建索引 _reindex

公告

昵称： jackieathome
园龄： 1年4个月
粉丝： 6
关注： 2

+加关注

2025年3月

日

一

二

三

四

五

六

jackieathome

ElasticSearch之Clone index API

公告

搜索

常用链接

合集

随笔档案

阅读排行榜

评论排行榜

推荐排行榜

最新评论

	curl -X PUT "https://localhost:9200/testindex_001/_settings?pretty" -H 'Content-Type: application/json' -d'
	{
	"settings": {
	"index.blocks.write": true
	}
	}
	' --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"

	{
	"acknowledged" : true,
	"shards_acknowledged" : true,
	"index" : "cloned-testindex_002"
	}

	{
	"error" : {
	"root_cause" : [
	{
	"type" : "illegal_state_exception",
	"reason" : "index testindex_001 must be read-only to resize index. use \"index.blocks.write=true\""
	}
	],
	"type" : "illegal_state_exception",
	"reason" : "index testindex_001 must be read-only to resize index. use \"index.blocks.write=true\""
	},
	"status" : 500
	}

	curl -X PUT "https://localhost:9200/testindex_001/_settings?pretty" -H 'Content-Type: application/json' -d'
	{
	"settings": {
	"index.blocks.write": false
	}
	}
	' --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"