ElasticSearch中有哪些常用的curl 命令

发布时间：2021-06-21 16:35:54 作者：Leah
来源：亿速云阅读：397

# ElasticSearch中有哪些常用的curl命令

ElasticSearch作为一款流行的分布式搜索和分析引擎，提供了丰富的RESTful API接口。通过curl命令可以方便地与ElasticSearch集群进行交互。本文将详细介绍ElasticSearch中常用的curl命令，涵盖集群管理、索引操作、文档CRUD、搜索查询等场景。

## 一、集群管理命令

### 1. 检查集群健康状态

```bash
curl -X GET "localhost:9200/_cat/health?v"

该命令返回集群的健康状态（green/yellow/red）、节点数、分片数等关键信息。

2. 获取节点信息

curl -X GET "localhost:9200/_cat/nodes?v"

显示集群中所有节点的详细信息，包括IP地址、堆内存使用情况等。

3. 查看集群统计信息

curl -X GET "localhost:9200/_cluster/stats?human&pretty"

返回包括索引计数、存储大小、CPU使用率等综合统计信息。

二、索引操作命令

1. 创建索引

curl -X PUT "localhost:9200/my_index?pretty" -H 'Content-Type: application/json' -d'
{
  "settings": {
    "number_of_shards": 3,
    "number_of_replicas": 2
  }
}
'

创建名为my_index的索引，指定3个主分片和每个主分片2个副本。

2. 查看所有索引

curl -X GET "localhost:9200/_cat/indices?v"

列出集群中所有索引，显示健康状态、文档数、存储大小等信息。

3. 删除索引

curl -X DELETE "localhost:9200/my_index?pretty"

永久删除指定索引及其所有数据。

4. 获取索引映射

curl -X GET "localhost:9200/my_index/_mapping?pretty"

查看索引的字段映射关系（mapping）。

三、文档CRUD操作

1. 创建/更新文档

curl -X POST "localhost:9200/my_index/_doc/1?pretty" -H 'Content-Type: application/json' -d'
{
  "title": "ElasticSearch Guide",
  "author": "John Doe",
  "publish_date": "2023-01-15"
}
'

创建ID为1的文档，如果已存在则更新。

2. 获取文档

curl -X GET "localhost:9200/my_index/_doc/1?pretty"

根据文档ID检索特定文档。

3. 批量操作

curl -X POST "localhost:9200/_bulk?pretty" -H 'Content-Type: application/json' -d'
{ "index" : { "_index" : "my_index", "_id" : "2" } }
{ "title": "Bulk API Tutorial", "author": "Jane Smith" }
{ "delete" : { "_index" : "my_index", "_id" : "1" } }
'

批量执行索引/删除操作，提高大批量数据处理的效率。

4. 更新部分字段

curl -X POST "localhost:9200/my_index/_update/1?pretty" -H 'Content-Type: application/json' -d'
{
  "doc": {
    "author": "Updated Author Name"
  }
}
'

仅更新文档的指定字段而非替换整个文档。

四、搜索查询命令

1. 简单搜索

curl -X GET "localhost:9200/my_index/_search?q=title:Guide&pretty"

使用URI搜索参数进行简单查询。

2. DSL查询

curl -X GET "localhost:9200/my_index/_search?pretty" -H 'Content-Type: application/json' -d'
{
  "query": {
    "bool": {
      "must": [
        { "match": { "title": "ElasticSearch" }},
        { "range": { "publish_date": { "gte": "2023-01-01" }}}
      ]
    }
  },
  "sort": [
    { "publish_date": { "order": "desc" }}
  ],
  "from": 0,
  "size": 10
}
'

使用ElasticSearch强大的DSL（Domain Specific Language）进行复杂查询。

3. 聚合分析

curl -X GET "localhost:9200/my_index/_search?pretty" -H 'Content-Type: application/json' -d'
{
  "aggs": {
    "authors": {
      "terms": { "field": "author.keyword" }
    },
    "avg_word_count": {
      "avg": { "field": "word_count" }
    }
  },
  "size": 0
}
'

执行聚合操作，统计作者分布和平均字数。

五、高级功能命令

1. 重建索引

curl -X POST "localhost:9200/_reindex?pretty" -H 'Content-Type: application/json' -d'
{
  "source": {
    "index": "old_index"
  },
  "dest": {
    "index": "new_index"
  }
}
'

将数据从一个索引复制到另一个索引，常用于映射变更或索引迁移。

2. 执行Explain

curl -X GET "localhost:9200/my_index/_explain/1?pretty" -H 'Content-Type: application/json' -d'
{
  "query": {
    "match": { "title": "ElasticSearch" }
  }
}
'

查看特定文档为何匹配或不匹配给定查询的详细解释。

3. 使用Painless脚本

curl -X POST "localhost:9200/my_index/_update/1?pretty" -H 'Content-Type: application/json' -d'
{
  "script": {
    "source": "ctx._source.word_count = params.new_count",
    "params": {
      "new_count": 1500
    }
  }
}
'

通过Painless脚本语言执行复杂的文档更新操作。

六、安全相关命令

1. 启用安全认证后访问

curl -u username:password -X GET "localhost:9200/_cluster/health?pretty"

在启用安全认证的集群中，使用-u参数提供凭据。

2. 创建API密钥

curl -X POST "localhost:9200/_security/api_key?pretty" -H 'Content-Type: application/json' -u elastic:password -d'
{
  "name": "my-api-key",
  "role_descriptors": {
    "read-only-role": {
      "cluster": ["monitor"],
      "indices": [
        {
          "names": ["*"],
          "privileges": ["read"]
        }
      ]
    }
  }
}
'

生成具有特定权限的API密钥用于程序访问。

七、性能调优命令

1. 清除缓存

curl -X POST "localhost:9200/my_index/_cache/clear?pretty"

清除索引缓存以进行性能测试。

2. 强制合并段

curl -X POST "localhost:9200/my_index/_forcemerge?max_num_segments=1&pretty"

合并索引段以减少段数量和提高查询性能。

总结

本文介绍了ElasticSearch中最常用的curl命令，涵盖从基础集群管理到高级搜索功能的各个方面。掌握这些命令可以帮助您：

高效管理ElasticSearch集群
灵活操作索引和文档
执行复杂的搜索和分析查询
进行系统维护和性能优化

实际使用时，建议结合pretty参数使JSON输出更易读，并通过-H 'Content-Type: application/json'确保正确的请求头设置。对于生产环境，还应考虑使用Kibana Dev Tools或ElasticSearch客户端库等更高级的工具。 “`