Elasticsearch 之 REST API

最新推荐文章于 2023-11-14 21:17:50 发布
最新推荐文章于 2023-11-14 21:17:50 发布
阅读量626 收藏
点赞数
分类专栏： Hadoop Linux 文章标签： elasticsearch 大数据 hadoop linux curl
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_43613793/article/details/116120790
版权
Linux 同时被 2 个专栏收录
35 篇文章 0 订阅
订阅专栏
Hadoop
30 篇文章 0 订阅
订阅专栏

Elasticsearch提供了一个非常全面和强大的REST API，可以使用Linux curl命令发起一个HTTP请求与集群进行交互，也可以使用任何允许进行HTTP/REST调用的工具来发起请求（比如Postman；如果是GET请求也可以直接在浏览器中访问）

一个基于HTTP协议的curl请求的基本格式如下：

curl -X <VERB> '<PROTOCOL>://<HOST>:<PORT>/<PATH>?<QUERY_STRING>' -d '<BODY>'
名称说明
VERBHTTP请求方法，取值为GET、POST、PUT、HEAD或DELETE
PROTOCOL请求协议，取值为http或https
HOSTElasticsearch集群任意一个节点的主机名
PORTElasticsearch HTTP服务端口号，默认为9200
PATH请求路径，也成为API端点
QUERY_STRING查询字符串
BODYJSON格式的请求体

文章目录

集群状态API

了解当前Elasticsearch集群的健康情况

curl -X GET 'centos01:9200/_cat/health?v'

在这里插入图片描述

在这里插入图片描述
在这里插入图片描述

返回字段原文含义
epochseconds since 1970-01-01 00:00:00自标准时间（1970-01-01 00:00:00）以来的秒数
timestamptime in HH:MM:SS时分秒,utc时区
clustercluster name集群名称
statushealth status集群状态
green：所有主分片和副本分片都正常运行
yellow：所有主分片都正常运行，但不是所有副本分片都正常运行
red：存在至少一个主分片没能正常运行
node.totaltotal number of nodes节点总数
node.datanumber of nodes that can store data数据节点总数
shardstotal number of shards分片总数
prinumber of primary shards主分片总数
relonumber of relocating nodes复制节点总数
initnumber of initializing nodes初始化节点总数
unassignnumber of unassigned shards未分配分片总数
pending_tasksnumber of pending tasks待定任务总数
max_task_wait_timewait time of longest task pending等待最长任务的等待时间
active_shards_percentactive number of shards in percent活动分片百分比

我这里status为yellow，unassign等于shards，说明我的集群所有的分片都没有分配…这是因为我的磁盘内存不够了： Elasticsearch的分片默认情况下受控于Elasticsearch集群节点的数据盘磁盘空间，有4个参数进行控制。默认情况下，当数据盘使用超过85%，Elasticsearch不会将分片分配给使用磁盘超过85％的节点。

这四个控制参数分别是：

cluster.routing.allocation.disk.threshold_enabled
默认为true。设置为false禁用磁盘分配决策程序。

cluster.routing.allocation.disk.watermark.low
控制磁盘使用的低水位线。它默认为85%，这意味着Elasticsearch不会将分片分配给使用磁盘超过85％的节点。它也可以设置为绝对字节值（如500mb），以防止Elasticsearch在小于指定的可用空间量时分配分片。此设置不会影响新创建的索引的主分片，或者特别是之前从未分配过的任何分片。

cluster.routing.allocation.disk.watermark.high
控制高水印。它默认为90%，意味着Elasticsearch将尝试从磁盘使用率超过90％的节点重新定位分片。它也可以设置为绝对字节值（类似于低水印），以便在节点小于指定的可用空间量时将其从节点重新定位。此设置会影响所有分片的分配，无论先前是否分配。

cluster.routing.allocation.disk.watermark.flood_stage
控制洪水阶段水印。它默认为95％，这意味着Elasticsearch index.blocks.read_only_allow_delete对每个索引强制执行只读索引块（），该索引在至少有一个磁盘超过泛洪阶段的节点上分配了一个或多个分片。这是防止节点耗尽磁盘空间的最后手段。一旦有足够的可用磁盘空间允许索引操作继续，就必须手动释放索引块。

而我这里已经达到了90%，所以Elasticsearch不会给我分配分片：
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

这也是我把Kibana装在centos03上而不是centos01上的原因…

查看Elasticsearch集群节点信息

curl -X GET 'centos01:9200/_cat/nodes?v'

在这里插入图片描述

返回字段原文含义
idunique node idip
heap.percentused heap堆内存占用百分比
ram.percentused machine memory ratio内存占用百分比
cpurecent cpuCPU占用百分比
load_1m1m load avg1分钟的系统负载
load_5m5m load avg5分钟的系统负载
load_15m15m load avg15分钟的系统负载
node.rolem:master eligible node, d:data node, i:ingest node, -:coordinating node onlynode节点的角色
master*:current master是否是master节点
namenode name节点名称

索引API

创建索引

创建一个名为customer的索引：

curl -X PUT 'centos01:9200/customer?pretty'

在这里插入图片描述

在创建索引时添加设置，例如设置分片数量、副本数量：（默认都是1）

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

在这里插入图片描述

查询索引

curl -X GET 'centos01:9200/customer?pretty'

在这里插入图片描述

查询全部索引：

curl -X GET 'centos01:9200/_all?pretty' 
curl -X GET 'centos01:9200/*?pretty'

打开和关闭索引

关闭索引：

curl -X POST 'centos01:9200/customer/_close?pretty'

在这里插入图片描述

打开索引：

curl -X POST 'centos01:9200/customer/_open?pretty'

在这里插入图片描述

打开/关闭索引：

curl -X POST 'centos01:9200/_all/_open?pretty' 
curl -X POST 'centos01:9200/*/_open?pretty' 

curl -X POST 'centos01:9200/_all/_close?pretty' 
curl -X POST 'centos01:9200/*/_close?pretty'

删除索引

curl -X DELETE 'centos01:9200/customer?pretty'

在这里插入图片描述

文档API

添加文档

在索引customer中添加一个name为Zhang San的文档，该文档的id为1：

curl -H "Content-Type: application/json" -X PUT 'centos01:9200/customer/_doc/1?pretty' -d '{"name":"Zhang San"}'

在这里插入图片描述

查询文档

查询索引customer中id为1的文档：

curl -X GET 'centos01:9200/customer/_doc/1?pretty'

在这里插入图片描述

只查询索引customer中id为1的文档的name和age字段：

curl -HEAD 'centos01:9200/customer/_doc/1?pretty&_source=name,age'

在这里插入图片描述

只要_source的数据：

curl -X GET 'centos01:9200/customer/_doc/1/_source?pretty'

在这里插入图片描述

更新文档

更新customer中id为1的文档的name字段为Li Si：

curl -H "Content-Type: application/json" -X PUT 'centos01:9200/customer/_doc/1?pretty' -d '{"name":"Li Si"}'

在这里插入图片描述

一次性更新整个文档例如将customer中id为1的文档更新为{“name”:“Li Si”,“age”:20}：

curl -H "Content-Type: application/json" -X POST 'centos01:9200/customer/_doc/1/_update?pretty' -d '{"doc":{"name":"Li Si","age":20}}'

在这里插入图片描述

给age字段 +5 ：

curl -H "Content-Type: application/json" -X POST 'centos01:9200/customer/_doc/1/_update?pretty' -d '{"script":"ctx._source.age+=5"}'

在这里插入图片描述

删除文档

删除索引customer中id为1的文档：

curl -H "Content-Type: application/json" -X DELETE 'centos01:9200/customer/_doc/1?pretty'

在这里插入图片描述

批处理

将id为1、name为zhangsan和id为2、name为lisi的两个文档添加到索引customer中：

curl -H "Content-Type: application/json" -X POST 'centos01:9200/customer/_doc/_bulk?pretty' -d '
{"index":{"_id":"1"}}
{"name":"zhangsan"}
{"index":{"_id":"2"}}
{"name":"lisi"}
'

在这里插入图片描述

更新id为1的文档，删除id为2的文档：

curl -H "Content-Type: application/json" -X POST 'centos01:9200/customer/_doc/_bulk?pretty' -d '
{"update":{"_id":"1"}}
{"doc":{"name":"wangwu"}}
{"delete":{"_id":"2"}}
'

在这里插入图片描述
在这里插入图片描述

搜索API

首先向索引customer中添加两条数据：

curl -H "Content-Type: application/json" -X POST 'centos01:9200/customer/_doc/_bulk?pretty' -d '
{"index":{"_id":"1"}}
{"name":"zhangsan","age":20}
{"index":{"_id":"2"}}
{"name":"lisi","age":22}
'

在这里插入图片描述

搜索customer索引中的所有文档并将结果按照age字段降序排列：

URL方式

curl -X GET 'centos01:9200/customer/_search?q=*&sort=age:desc&pretty'

在这里插入图片描述

body体方式

curl -H "Content-Type: application/json" -X GET 'centos01:9200/customer/_search?pretty' -d '{
    "query":{
        "match_all":{ }
    },
    "sort":[
            {
                "age":"desc"
            }
    	]
    }'

在这里插入图片描述

Query DSL

上面的将搜索参数放入body体的请求方式在Elasticsearch中被称为领域特定语言（DSL）

查询（Query）

https://www.elastic.co/guide/en/elasticsearch/reference/1.7/query-dsl-queries.html

过滤（Filter）

https://www.elastic.co/guide/en/elasticsearch/reference/1.7/query-dsl-filters.html

philpy_used
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
elastic：用于Rust的Elasticsearch REST API客户端
02-05
elastic：用于Rust的Elasticsearch REST API客户端
esrest:ElasticSearch REST API 的简单直接的 Java 客户端
07-10
EsREST 有许多优点： 由于方法链，EsREST API 非常直观（参见下面的示例） EsREST 不依赖于 Elasticsearch jar EsREST 将清楚地指示请求是成功还是失败不过也有一些缺点： 这个项目很新，正在积极开发中现在只实现...
elasticsearch 使用 RestAPI 操作索引库
aq_money的博客
05-03 1280
索引库操作有哪些？创建索引库：PUT /索引库名查询索引库：GET /索引库名删除索引库：DELETE /索引库名添加字段：PUT /索引库名/_mapping文档操作有哪些？创建文档：POST /{索引库名}/_doc/文档id { json文档 }查询文档：GET /{索引库名}/_doc/文档id删除文档：DELETE /{索引库名}/_doc/文档id修改文档：全量修改：PUT /{索引库名}/_doc/文档id { json文档 }
Elasticsearch常用的的RESTful API
weixin_34080951的博客
01-30 319
所有其他语言可以使用 RESTful API 通过端口 9200 和 Elasticsearch 进行通信，你可以使用WEB客户端或者curl命令来和ES交互。下面介绍用curl命令来交互的具体用法： 一、格式 curl -X<VERB> '<PROTOCOL>://<HOST>:<PORT>/<PATH>?<QUERY_STRIN...
ElasticSearch RestAPI
sinat_34241861的博客
07-31 779
1、 设置分片数和副本数 ES7默认主分片数和主分片副本数都为1，通过 default_template 指定分片数 PUT http://192.168.8.101:9200/_template/default_template { "index_patterns" : ["*"], "settings": { "number_of_shards": 3, "number_of_replicas" : 1 } } number_of_shards：每个索引的主分片数，默认值
Elasticsearch-02-es的restapi使用
苍煜
06-28 2514
在此大家的前置知识是了解restful风格的接口以及会使用postman工具 Restful接口详解在 Postman 中， 向 ES 服务器发 PUT 请求 ：http://127.0.0.1:9200/索引名 如果重复添加索引， 会返回错误信息在 Postman 中， 向 ES 服务器发 GET 请求 ：http://127.0.0.1:9200/_cat/indices?v 在 Postman 中， 向 ES 服务器发 GET 请求 ：http://127.0.0.1:9200/myindex 4:
【Elasticsearch】RestAPI
专注于Java领域开发 关注我 带你玩转Java
07-11 799
ES官方提供了各种不同语言的客户端，用来操作ES。这些客户端的本质就是组装DSL语句，通过http请求发送给ES。
elasticsearch-rest-client-6.8.3-API文档-中文版.zip
07-13
赠送原API文档：elasticsearch-rest-client-6.8.3-javadoc.jar； 赠送源代码：elasticsearch-rest-client-6.8.3-sources.jar； 赠送Maven依赖信息文件：elasticsearch-rest-client-6.8.3.pom； 包含翻译后的API文档...
elasticsearch-rest-high-level-client-6.8.3-API文档-中文版.zip
07-13
赠送原API文档：elasticsearch-rest-high-level-client-6.8.3-javadoc.jar； 赠送源代码：elasticsearch-rest-high-level-client-6.8.3-sources.jar； 赠送Maven依赖信息文件：elasticsearch-rest-high-level-client...
elasticsearch-rest-high-level-client-6.8.3-API文档-中英对照版.zip
07-13
赠送原API文档：elasticsearch-rest-high-level-client-6.8.3-javadoc.jar； 赠送源代码：elasticsearch-rest-high-level-client-6.8.3-sources.jar； 赠送Maven依赖信息文件：elasticsearch-rest-high-level-client...
ElasticSearch:Rest API操作
小灰狼与大白兔的博客
02-13 6676
method url地址 描述 PUT（创建,修改） localhost:9200/索引名称/类型名称/文档id 创建文档（指定文档id） POST（创建） localhost:9200/索引名称/类型名称 创建文档（随机文档id） POST（修改） localhost:9200/索引名称/类型名称/文档id/_update 修改文档 DELETE（删除） localhost:9200/索引名称/类型名称/文档id 删除文档 GET（查询） localhost:9200/索引名...
Elasticsearch入门详解(API篇)
CC_cc_Re的博客
06-11 683
Elasticsearch提供了Rest风格的API，即http请求接口 2.1基本概念 Elasticsearch也是基于Lucene的全文检索库，本质也是存储数据，很多概念与MySQL类似的。 索引库（indices)：indices是index的复数，代表许多的索引 类型（type）：类型是模拟mysql中的table概念，一个索引库下可以有不同类型的索引，比如商品索引，订单索引，其数据格式不同。不过这会导致索引库混乱，因此未来版本中会移除这个概念 文档（document）：存入索引库原始的数据。比
ElasticSearch （三）ElasticSearch 常见REST API 操作
柏修的专栏
01-10 9626
一、前言ElasticSearch 提供了一套非常强大并且易操作的 REST API 用于我们开发人员进行操作。主要 REST API 能完成以下几项功能： 管理功能 i：检查集群、节点、索引的状态以及相关的统计数据 ii：管理集群、节点、索引数据以及源数据 维护索引i：基本操作。 提供针对索引的CRUD操作（Create【PUT】, Read【GET】, Update, and Dele
Elasticsearch学习笔记系列3——REST API
iqifenxia的博客
11-03 427
从Elasticsearch 5.0开始引入了REST Client，使用HTTP的协议操作ES服务器。ES原生的Transport Client将在8.0后彻底取消，因此官方推荐使用REST API. 这是因为REST Client的初始化构建的线程的安全的，与应用的生命周期相同，但是使用完客户端后要关闭客户端来释放资源。 Elasticsearch Java REST API分为低级(low-level)和高级(high-level)两个接口，其中： Java Low Level REST Clie
Elasticsearch的RESTful API
zyy247796143的博客
05-25 1497
接上一篇搭建文章中，nginx.conf 定义的log格式是： log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"'; 实际的nginx日志实例
Elasticsearch Rest API介绍
neweastsun的专栏
11-21 516
Elasticsearch Rest API介绍 Elasticsearch提供了大量的REST api来集成、查询和管理数据。在这篇博客中讨论一些经常使用的REST api。 1. 概述 Elasticsearch REST APIs 主要实现下列功能: 检查集群、节点、索引的健康状况、状态以及统计信息等. 管理集群、节点、索引数据以及元数据. 执行CRUD操作 (Create, Read, ...
Elasticsearch 索引库操作与 Rest API 使用详解
最新发布
weixin_64822448的博客
11-14 396
通过本文的介绍，你应该对 Elasticsearch 中索引库的基本操作和 Rest API 有了更深入的理解。这些操作是构建强大搜索引擎的基础，同时也是 Java 开发者在实际项目中不可或缺的技能。在实际项目中，我们还可以结合高级搜索和聚合操作，提供更灵活和强大的搜索功能。希望这篇文章对你有所帮助。
elasticSearch-restfulApi(3)
编程是一门实践技术
05-11 137
此章内容比较简单，是官方的一个主要API，精选了一些日常开发中需要使用的，罗列一下。本文档介绍的API分为两类：1、resutful；2、sql。建议大家使用restful方式，因为通用性比较好。
SpringCloud：ElasticSearch之RestAPI
时代各有不同，青春一脉相承。
04-01 293
ES官方提供了各种不同语言的客户端，用来操作ES。这些客户端的本质就是组装DSL语句，通过http请求发送给ES。JavaRestClient操作elasticsearch的流程基本类似。核心是client.indices()方法来获取索引库的操作对象。索引库操作的基本步骤：初始化RestHighLevelClient 创建XxxIndexRequest。XXX是Create、Get、Delete 准备DSL（Create时需要，其它是无参） 发送请求。调用RestHighLevelClient#indic
ElasticSearch ES REST API作用
05-24
ES REST API是ElasticSearch提供的一组基于HTTP协议的API，可以通过访问这些API来操作ElasticSearch的各种功能，包括创建、更新、删除索引，搜索数据，进行聚合分析等等。具体来说，ES REST API可以完成以下功能： ...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值