Elasticsearch Rest API介绍

Elasticsearch Rest API介绍

Elasticsearch提供了大量的REST api来集成、查询和管理数据。在这篇博客中讨论一些经常使用的REST api。

1. 概述

Elasticsearch REST APIs 主要实现下列功能:

• 检查集群、节点、索引的健康状况、状态以及统计信息等.
• 管理集群、节点、索引数据以及元数据.
• 执行CRUD操作 (Create, Read, Update, and Delete) ，基于索引进行检索.
• 执行高级搜素功能，如分页、排序、过滤、脚本、聚集等.

2. 常用 API 解释

_cat API

使用下列API获得集群健康状况：

GET  /_cat/health?v

获取集群的节点信息：

GET /_cat/nodes?v

列出集群中索引：

GET /_cat/indices?v

创建索引

创建索引，举例下面创建blogs索引：

PUT /blogs?pretty

这里提供格式化参数，用于使用输出信息更可读。

删除索引

删除索引：

DELETE /customer?pretty

创建文档
我们已经创建了索引，下面在索引创建文档：

PUT /blogs/technical/1?pretty
{
  "topic": "introduction to Elasticsearch"
}

替换文档
使用相同的文档ID及不同topic内容实现替换文档：

PUT /blogs/technical/1?pretty
{
  "topic": "Elasticsearch Installation"
}

更新文档

下面表达式实现更新文档：

POST /blogs/technical/1/_update?pretty
{
  "doc": { "topic": "introduction to Elasticsearch", "category": "ELK" }
}

我们使用相同的文档ID，不同的topic内容以及额外的字段信息。

删除文档

删除索引中的文档：

DELETE /blogs/technical/1?pretty

通过文档ID删除指定文档。

加载数据

也可以批量加载外部文件，举例可以直接加载json文件至elasticsearch集群中：

curl -H "Content-Type: application/json" -XPOST 'localhost:9200/bank/account/_bulk?pretty&refresh' --data-binary "@blogs.json"

这里blogs.json数据文件在当前目录下。当然也可以通过 _bluk API进行批量插入，可以参考批量插入文档。

3. 总结

本文简要介绍了Elasticsearch常用的Rest API，主要包括对索引、文档的操作，更多内容可阅读elasticsearch系列内容。