High Level REST Client

Elasticsearch BES

  • 邀测版存储计算分离套餐介绍
  • 功能发布记录
  • 产品描述
    • 基本概念
    • 关键特性
    • 产品介绍
    • 产品性能
      • 4核16GB512GB通用型的3个数据节点实例基准性能指标
      • 8核16GB512GB计算型的3个数据节点实例基准性能测试
      • 16核32GB512GB计算型的3个数据节点实例基准性能指标
      • 4核8GB512GB计算型的3个数据节点实例基准性能测试
      • 8核32GB512GB通用型的3个数据节点实例基准性能指标
      • 16核64GB512GB通用型的3个数据节点实例基准性能指标
      • 概述
  • Python-SDK
    • 实例
    • 异常
    • 日志
    • 节点配置类型
    • 版本更新记录
    • 快速入门
    • 集群
    • BesClient
    • 安装SDK工具包
    • 概述
  • Kibana
    • Kibana使用指南
  • Logstash
    • Logstash使用指南
    • 实例管理
      • 实例详情信息
      • 实例扩缩容
      • 管道管理
      • 创建实例
      • 实例列表
      • 删除实例
  • 开发指南
    • Elasticsearch Restful API
    • 通过其他客户端访问Elasticsearch
    • Elasticsearch Java客户端
      • Low Level REST Client
      • Rest Client操作向量索引示例
      • Java REST Client
      • High Level REST Client
  • Java-SDK
    • 实例
    • 异常
    • 日志
    • 节点配置类型
    • 版本更新记录
    • 快速入门
    • 集群
    • BesClient
    • 安装SDK工具包
    • 概述
  • 向量检索特性
    • 资源规划
    • 关键概念
    • 应用场景
    • 快速入门
    • 算法介绍
    • 能力简介
    • 向量数据库
    • 操作指南
      • 写入和查询数据
      • 训练模型
      • 向量索引缓存管理
      • 创建索引
      • 基于Reciprocal Rank Fusion的融合查询
      • 参数优化
      • 7.4版本兼容说明
    • 最佳实践
      • 调优建议
      • BES RAG 最佳实践:基于LangChain+BES的私域知识的QA问答系统
    • 迁移方案
      • ES dense vector 切换为BES方案
  • ELK
    • 基于ELK构建日志分析系统
  • 增强特性
    • 慢查询隔离
    • 百度NLP中文分词词典动态更新
    • 百度NLP中文分词插件
    • 基于段文件的主从复制
    • 基于BOS的冷热数据分离
  • 快速入门
    • 访问Elasticsearch服务
    • 导入数据并搜索
    • 创建集群
    • 集群资源评估
  • 典型实践
    • 使用BSC将BOS中的数据导入Es
    • 使用BSC将Kafka中的数据导入Es
    • 基于CCR实现多集群跨地域高可用
    • 基于节点磁盘介质的冷热数据分离
  • 服务等级协议SLA
    • 数据迁移服务协议
    • BES服务等级协议SLA(V1.0)
  • 常见问题
    • Spark访问Es常见问题
    • Elasticsearch系统常见问题
    • 常见问题总览
  • 产品定价
    • 预付费
    • 计费说明
    • 配置变更费用说明
    • 后付费
  • API文档
    • 概述
    • 自动续费相关接口
      • 续费列表
      • 查看自动续费
      • 查看自动续费规则列表
      • 续费操作
      • 更新自动续费规则
      • 删除自动续费规则
      • 创建自动续费规则
    • 插件配置接口
      • 上传自定义插件
      • 卸载系统默认插件
      • 上传nlp词典
      • 安装系统默认插件
      • 获取默认和自定义插件列表
      • 卸载自定义插件
      • 安装自定义插件
      • 删除自定义插件
      • 查看nlp词典
    • 日志管理相关接口
      • 查看日志导出任务记录
      • 创建日志导出任务
      • 日志设置
      • 日志查询
    • 标签接口
      • 查询标签列表
      • 批量新增标签
      • 单个集群更新标签
    • 智能巡检接口
      • 查看近7天已完成的巡检任务列表
      • 近七天巡检概况
      • 查看手动巡检任务的配置
      • 集群巡检授权
      • 列举所有可选巡检项
      • 查询是否可以提交巡检任务
      • 最新一次巡检概况
      • 查看集群是否开启自动巡检
      • 修改手动巡检任务的配置
      • 开启或关闭自动巡检
      • 提交手动巡检任务
      • 查询今日已执行完成的手动巡检次数
      • 查看某巡检任务的执行状态和结果
    • 集群相关接口
      • 获取操作历史信息
      • 删除集群
      • 新增节点类型
      • 开启和关闭https
      • 查看集群详情信息
      • 重置密码
      • EIP绑定
      • EIP解绑
      • 是否开启Grafana监控
      • 获取数据量观测数据
      • 查看集群列表
      • 上传NLP分词词典
      • 创建集群
      • 智能评估
      • 集群blb信息
      • 用户可用代金券列表
      • 停止集群
      • 扩容集群
      • 启动集群
      • 重启集群
    • 实例相关接口
      • 批量停止实例
      • 启动实例
      • 查看缩容节点列表
      • 数据迁移
      • 数据迁移系统建议
      • 批量启动实例
      • 数据迁移回滚
      • 停止实例
      • 数据迁移节点列表
      • 删除实例
    • 配置修改相关接口
      • 获取同义词文件列表
      • 查看集群配置
      • 删除同义词配置文件
      • 上传同义词配置文件
      • 配置修改
    • 定时调度
      • 更新定时调度任务
      • 删除定时调度任务
      • 创建和更新定时调度任务
      • 查看定时调度任务
  • API3.0
    • 集群相关接口
      • 删除集群
  • Elasticsearch
    • 用户手册
      • YML参数配置
      • 权限管理
      • 智能巡检
      • 数据迁移
      • 基于BOS的快照与恢复
      • 集群列表
      • 账号使用说明
      • 多可用区部署
      • 定时调度
      • 数据量观测
      • 日志查询
        • 日志查询(旧)
        • 日志查询(新)
        • 日志导出
        • 查询语法
      • 集群配置
        • 配置同义词
      • 插件管理
        • 上传与安装自定义插件
        • Elasticsearch插件列表
        • 系统默认插件
          • analysis-pinyin拼音分词插件
          • IK中文分词插件与动态更新词典
          • compression-zstd插件
          • CCR插件
          • 限流插件
          • 动态同义词插件
          • 简繁体转换插件
          • ingest attachment插件
          • SQL插件
      • 配置变更
        • 节点数据迁移
        • 集群变配说明与建议
        • 集群扩缩容
      • 版本升级
        • 升级版本
        • 内核版本说明
        • 升级检查
      • 集群监控报警
        • 监控查看及指标说明
        • 配置报警
      • 集群管理
        • 集群重启
        • 变更HTTPS协议用户指南
        • 节点启停
        • 查看集群信息
        • 集群创建
        • 公网绑定
        • 修改集群名称
        • 跨可用区迁移集群
        • 集群删除
        • 集群列表
        • 自动续费
        • 密码重置
        • ES服务区域代码
      • 账户管理
        • 多用户访问控制
所有文档
menu
没有找到结果,请重新输入

Elasticsearch BES

  • 邀测版存储计算分离套餐介绍
  • 功能发布记录
  • 产品描述
    • 基本概念
    • 关键特性
    • 产品介绍
    • 产品性能
      • 4核16GB512GB通用型的3个数据节点实例基准性能指标
      • 8核16GB512GB计算型的3个数据节点实例基准性能测试
      • 16核32GB512GB计算型的3个数据节点实例基准性能指标
      • 4核8GB512GB计算型的3个数据节点实例基准性能测试
      • 8核32GB512GB通用型的3个数据节点实例基准性能指标
      • 16核64GB512GB通用型的3个数据节点实例基准性能指标
      • 概述
  • Python-SDK
    • 实例
    • 异常
    • 日志
    • 节点配置类型
    • 版本更新记录
    • 快速入门
    • 集群
    • BesClient
    • 安装SDK工具包
    • 概述
  • Kibana
    • Kibana使用指南
  • Logstash
    • Logstash使用指南
    • 实例管理
      • 实例详情信息
      • 实例扩缩容
      • 管道管理
      • 创建实例
      • 实例列表
      • 删除实例
  • 开发指南
    • Elasticsearch Restful API
    • 通过其他客户端访问Elasticsearch
    • Elasticsearch Java客户端
      • Low Level REST Client
      • Rest Client操作向量索引示例
      • Java REST Client
      • High Level REST Client
  • Java-SDK
    • 实例
    • 异常
    • 日志
    • 节点配置类型
    • 版本更新记录
    • 快速入门
    • 集群
    • BesClient
    • 安装SDK工具包
    • 概述
  • 向量检索特性
    • 资源规划
    • 关键概念
    • 应用场景
    • 快速入门
    • 算法介绍
    • 能力简介
    • 向量数据库
    • 操作指南
      • 写入和查询数据
      • 训练模型
      • 向量索引缓存管理
      • 创建索引
      • 基于Reciprocal Rank Fusion的融合查询
      • 参数优化
      • 7.4版本兼容说明
    • 最佳实践
      • 调优建议
      • BES RAG 最佳实践:基于LangChain+BES的私域知识的QA问答系统
    • 迁移方案
      • ES dense vector 切换为BES方案
  • ELK
    • 基于ELK构建日志分析系统
  • 增强特性
    • 慢查询隔离
    • 百度NLP中文分词词典动态更新
    • 百度NLP中文分词插件
    • 基于段文件的主从复制
    • 基于BOS的冷热数据分离
  • 快速入门
    • 访问Elasticsearch服务
    • 导入数据并搜索
    • 创建集群
    • 集群资源评估
  • 典型实践
    • 使用BSC将BOS中的数据导入Es
    • 使用BSC将Kafka中的数据导入Es
    • 基于CCR实现多集群跨地域高可用
    • 基于节点磁盘介质的冷热数据分离
  • 服务等级协议SLA
    • 数据迁移服务协议
    • BES服务等级协议SLA(V1.0)
  • 常见问题
    • Spark访问Es常见问题
    • Elasticsearch系统常见问题
    • 常见问题总览
  • 产品定价
    • 预付费
    • 计费说明
    • 配置变更费用说明
    • 后付费
  • API文档
    • 概述
    • 自动续费相关接口
      • 续费列表
      • 查看自动续费
      • 查看自动续费规则列表
      • 续费操作
      • 更新自动续费规则
      • 删除自动续费规则
      • 创建自动续费规则
    • 插件配置接口
      • 上传自定义插件
      • 卸载系统默认插件
      • 上传nlp词典
      • 安装系统默认插件
      • 获取默认和自定义插件列表
      • 卸载自定义插件
      • 安装自定义插件
      • 删除自定义插件
      • 查看nlp词典
    • 日志管理相关接口
      • 查看日志导出任务记录
      • 创建日志导出任务
      • 日志设置
      • 日志查询
    • 标签接口
      • 查询标签列表
      • 批量新增标签
      • 单个集群更新标签
    • 智能巡检接口
      • 查看近7天已完成的巡检任务列表
      • 近七天巡检概况
      • 查看手动巡检任务的配置
      • 集群巡检授权
      • 列举所有可选巡检项
      • 查询是否可以提交巡检任务
      • 最新一次巡检概况
      • 查看集群是否开启自动巡检
      • 修改手动巡检任务的配置
      • 开启或关闭自动巡检
      • 提交手动巡检任务
      • 查询今日已执行完成的手动巡检次数
      • 查看某巡检任务的执行状态和结果
    • 集群相关接口
      • 获取操作历史信息
      • 删除集群
      • 新增节点类型
      • 开启和关闭https
      • 查看集群详情信息
      • 重置密码
      • EIP绑定
      • EIP解绑
      • 是否开启Grafana监控
      • 获取数据量观测数据
      • 查看集群列表
      • 上传NLP分词词典
      • 创建集群
      • 智能评估
      • 集群blb信息
      • 用户可用代金券列表
      • 停止集群
      • 扩容集群
      • 启动集群
      • 重启集群
    • 实例相关接口
      • 批量停止实例
      • 启动实例
      • 查看缩容节点列表
      • 数据迁移
      • 数据迁移系统建议
      • 批量启动实例
      • 数据迁移回滚
      • 停止实例
      • 数据迁移节点列表
      • 删除实例
    • 配置修改相关接口
      • 获取同义词文件列表
      • 查看集群配置
      • 删除同义词配置文件
      • 上传同义词配置文件
      • 配置修改
    • 定时调度
      • 更新定时调度任务
      • 删除定时调度任务
      • 创建和更新定时调度任务
      • 查看定时调度任务
  • API3.0
    • 集群相关接口
      • 删除集群
  • Elasticsearch
    • 用户手册
      • YML参数配置
      • 权限管理
      • 智能巡检
      • 数据迁移
      • 基于BOS的快照与恢复
      • 集群列表
      • 账号使用说明
      • 多可用区部署
      • 定时调度
      • 数据量观测
      • 日志查询
        • 日志查询(旧)
        • 日志查询(新)
        • 日志导出
        • 查询语法
      • 集群配置
        • 配置同义词
      • 插件管理
        • 上传与安装自定义插件
        • Elasticsearch插件列表
        • 系统默认插件
          • analysis-pinyin拼音分词插件
          • IK中文分词插件与动态更新词典
          • compression-zstd插件
          • CCR插件
          • 限流插件
          • 动态同义词插件
          • 简繁体转换插件
          • ingest attachment插件
          • SQL插件
      • 配置变更
        • 节点数据迁移
        • 集群变配说明与建议
        • 集群扩缩容
      • 版本升级
        • 升级版本
        • 内核版本说明
        • 升级检查
      • 集群监控报警
        • 监控查看及指标说明
        • 配置报警
      • 集群管理
        • 集群重启
        • 变更HTTPS协议用户指南
        • 节点启停
        • 查看集群信息
        • 集群创建
        • 公网绑定
        • 修改集群名称
        • 跨可用区迁移集群
        • 集群删除
        • 集群列表
        • 自动续费
        • 密码重置
        • ES服务区域代码
      • 账户管理
        • 多用户访问控制
  • 文档中心
  • arrow
  • ElasticsearchBES
  • arrow
  • 开发指南
  • arrow
  • Elasticsearch Java客户端
  • arrow
  • High Level REST Client
本页目录
  • 准备工作
  • pom依赖
  • 示例

High Level REST Client

更新时间:2025-08-20

本文基于Java High Level REST Client 7.x版本,为您介绍Elasticsearch Java API的用法。

准备工作

  • 安装Java,要求JDK版本为1.8及以上。
  • 创建Baidu Elasticsearch实例,版本7.4.2。

    注意 High Level Client能够向上兼容,但为了保证最大程度地使用最新版客户端的特性,推荐High Level Client版本与集群版本一致。

  • 创建Java Maven工程,并将如下的pom依赖添加到Java工程的pom.xml文件中。

pom依赖

XML
1<dependency>
2    <groupId>org.elasticsearch.client</groupId>
3    <artifactId>elasticsearch-rest-high-level-client</artifactId>
4    <version>7.4.2</version>
5</dependency>
6<dependency>
7    <groupId>org.apache.logging.log4j</groupId>
8    <artifactId>log4j-core</artifactId>
9    <version>2.7</version>
10</dependency>
11<dependency>
12    <groupId>org.apache.logging.log4j</groupId>
13    <artifactId>log4j-api</artifactId>
14    <version>2.7</version>
15</dependency>

示例

以下代码为使用Create Index API创建索引,使用异步调用的方式写入文档,删除文档,使用Delete API删除该索引等操作的示例,可供参考。

Java
1import java.io.IOException;
2import org.apache.http.HttpHost;
3import org.apache.http.auth.AuthScope;
4import org.apache.http.auth.UsernamePasswordCredentials;
5import org.apache.http.client.CredentialsProvider;
6import org.apache.http.impl.client.BasicCredentialsProvider;
7import org.apache.http.impl.nio.client.HttpAsyncClientBuilder;
8import org.elasticsearch.action.ActionListener;
9import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
10import org.elasticsearch.action.delete.DeleteRequest;
11import org.elasticsearch.action.delete.DeleteResponse;
12import org.elasticsearch.action.index.IndexRequest;
13import org.elasticsearch.action.index.IndexResponse;
14import org.elasticsearch.action.support.master.AcknowledgedResponse;
15import org.elasticsearch.client.RequestOptions;
16import org.elasticsearch.client.RestClient;
17import org.elasticsearch.client.RestClientBuilder;
18import org.elasticsearch.client.RestHighLevelClient;
19import org.elasticsearch.client.indices.CreateIndexRequest;
20import org.elasticsearch.client.indices.CreateIndexResponse;
21import org.elasticsearch.common.settings.Settings;
22import org.elasticsearch.common.xcontent.XContentBuilder;
23import org.elasticsearch.common.xcontent.XContentFactory;
24import org.elasticsearch.common.xcontent.XContentType;
25
26public class RestClientTest742 {
27
28    public static void main(String[] args) {
29        final CredentialsProvider credentialsProvider = new BasicCredentialsProvider();
30        //访问用户名和密码为您创建Elasticsearch实例时设置的用户名和密码。
31        credentialsProvider.setCredentials(AuthScope.ANY, new UsernamePasswordCredentials("{访问用户名}", "{访问密码}"));
32        // 通过builder创建rest client,配置http client的HttpClientConfigCallback。
33        // ES HTTP URL 在Baidu Elasticsearch界面中可以查询
34        RestClientBuilder builder = RestClient.builder(new HttpHost("{ES HTTP URL}", 8200))
35                .setHttpClientConfigCallback(new RestClientBuilder.HttpClientConfigCallback() {
36                    @Override
37                    public HttpAsyncClientBuilder customizeHttpClient(HttpAsyncClientBuilder httpClientBuilder) {
38                        return httpClientBuilder.setDefaultCredentialsProvider(credentialsProvider);
39                    }
40                });
41
42        // RestHighLevelClient实例通过REST low-level client builder进行构造。
43        RestHighLevelClient client = new RestHighLevelClient(builder);
44
45        try {
46            //创建索引
47            CreateIndexRequest createRequest = new CreateIndexRequest("my_index");
48
49            //创建的每个索引都可以有与之关联的特定设置。
50            createRequest.settings(Settings.builder()
51                    .put("index.number_of_shards", 3)
52                    .put("index.number_of_replicas", 1)
53                    .put("index. refresh_interval", "10s")
54            );
55            // 创建索引时创建文档类型映射
56            createRequest.mapping("{\n" +
57                            "    \"message\": {\n" +
58                            "      \"properties\": {\n" +
59                            "        \"message\": {\n" +
60                            "          \"type\": \"text\"\n" +
61                            "        }\n" +
62                            "      }\n" +
63                            "    }\n" +
64                            "  }",
65                    XContentType.JSON);
66            // 同步执行创建索引操作
67            CreateIndexResponse createIndexResponse = client.indices().create(createRequest, RequestOptions.DEFAULT);
68            System.out.println("create index successfully! response : " + createIndexResponse.toString());
69
70            // 写入文档
71            // 以XContentBuilder对象的形式提供,Elasticsearch 内部会帮我们生成JSON内容
72            XContentBuilder jsonBuilder = XContentFactory.jsonBuilder();
73            jsonBuilder.startObject();
74            {
75                jsonBuilder.field("user", "Kobe Bryant");
76                jsonBuilder.field("number", 24);
77                jsonBuilder.field("message", "One of the greatest basketball players since the 21st century");
78            }
79            jsonBuilder.endObject();
80            IndexRequest indexRequest = new IndexRequest("my_index").id("1").source(jsonBuilder);
81            //异步执行写入文档操作,方法不会阻塞并立即返回。
82            ActionListener<IndexResponse> listener = new ActionListener<IndexResponse>() {
83                @Override
84                public void onResponse(IndexResponse indexResponse) {
85                    //执行成功时调用。 Response以参数方式提供
86                    System.out.println("Index doc successfully! response : " + indexResponse.toString());
87                }
88
89                @Override
90                public void onFailure(Exception e) {
91                    //在失败的情况下调用。 引发的异常以参数方式提供
92                    System.out.println("Index doc fail!");
93                    e.printStackTrace();
94                }
95            };
96            //异步执行索引请求需要将IndexRequest实例和ActionListener实例传递给异步方法:
97            client.indexAsync(indexRequest, RequestOptions.DEFAULT, listener);
98
99            // 删除文档
100            DeleteRequest deleteRequest = new DeleteRequest("my_index").id("1");
101            // 执行删除文档操作
102            DeleteResponse deleteResponse = client.delete(deleteRequest, RequestOptions.DEFAULT);
103            System.out.println("Delete doc successfully! \n" + deleteResponse.toString() + "\n" + deleteResponse.status());
104
105            // 指定要删除的索引名称
106            DeleteIndexRequest deleteIndexRequest = new DeleteIndexRequest("my_index");
107            // 执行删除索引操作
108            AcknowledgedResponse deleteIndexResponse = client.indices().delete(deleteIndexRequest, RequestOptions.DEFAULT);
109            System.out.println("delete index successfully! response : " + deleteIndexResponse.toString());
110        } catch (IOException ioException) {
111            // 异常处理。
112            ioException.printStackTrace();
113        } finally {
114            // 在不需要使用client后,将client关闭。
115            try {
116                client.close();
117            } catch (IOException e) {
118                e.printStackTrace();
119            }
120        }
121    }
122}

以上示例代码中带{}的参数需要替换为您具体业务的参数,详情请参见代码注释。

更多Java High Level REST Client的使用特性,请参见Java High Level REST Client官方文档。

上一篇
Java REST Client
下一篇
Java-SDK