opensearch-project/OpenSearch - 快速上手

项目介绍快速开始学习路径贡献者 342 增长趋势代码统计生态关系项目时间线项目竞品依赖分析上榜历史

OpenSearch 5分钟快速开始

快速启动OpenSearch分布式搜索引擎，体验基本搜索功能。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Java 11或更高必需

所需工具

终端或命令行工具

执行命令

必需

操作步骤

下载OpenSearch

从官网下载最新版OpenSearch压缩包。

下载Linux版本（其他系统请访问官网选择对应版本）

curl -L -o opensearch.tar.gz https://artifacts.opensearch.org/releases/bundle/opensearch/2.11.0/opensearch-2.11.0-linux-x64.tar.gz

预期结果：：下载完成，文件名为opensearch.tar.gz。

如果使用Windows，可从官网下载.zip文件并解压。

解压并启动OpenSearch

解压文件并运行OpenSearch服务。

解压文件

tar -xzf opensearch.tar.gz

进入目录并启动服务

cd opensearch-2.11.0 && ./bin/opensearch

预期结果：：终端显示日志，包括'started'和'listening on [::]:9200'等消息。

首次启动可能需要几分钟，请等待服务完全启动。

验证服务运行

通过HTTP请求检查OpenSearch是否正常运行。

发送GET请求到本地OpenSearch实例

curl -X GET http://localhost:9200

预期结果：：返回JSON响应，包含'version'和'name'字段，如{'name':'opensearch-node1','version':{'number':'2.11.0'}}。

如果返回错误，请检查服务是否已启动或端口9200是否被占用。

创建索引并添加数据

创建一个索引并插入一条文档进行搜索测试。

创建名为test-index的索引

curl -X PUT http://localhost:9200/test-index

向索引添加一条文档

curl -X POST http://localhost:9200/test-index/_doc/1 -H 'Content-Type: application/json' -d '{"title":"Hello OpenSearch","content":"This is a test document."}'

预期结果：：第一个命令返回{'acknowledged':true}，第二个命令返回{'_id':'1','result':'created'}。

确保JSON数据格式正确，使用单引号包裹JSON字符串以避免转义问题。

执行搜索查询

搜索刚添加的文档以确认功能正常。

搜索包含'Hello'的文档

curl -X GET http://localhost:9200/test-index/_search?q=Hello

预期结果：：返回JSON响应，包含'hits'数组，其中有一条文档匹配，如{'hits':{'total':{'value':1},'hits':[{'_source':{'title':'Hello OpenSearch','content':'This is a test document.'}}]}}。

如果无结果，请检查文档是否成功添加或搜索词是否正确。

验证成功

完成以上步骤后，您已成功运行OpenSearch并进行了基本搜索操作。

服务启动日志显示'started'

GET请求返回版本信息

搜索查询返回匹配的文档

快速提示

扩展

使用-dashboards包可搭配可视化界面

生产建议

生产环境需配置安全设置和集群

学习资源

查看官方文档获取详细API指南

常见问题

启动失败，端口9200被占用

停止占用端口的进程或修改OpenSearch配置文件中的端口

Java版本不兼容

安装Java 11或更高版本并设置JAVA_HOME环境变量

curl命令返回连接拒绝

检查OpenSearch服务是否已启动，或等待几分钟后重试

下一步

探索OpenSearch Dashboards

安装并配置Dashboards进行数据可视化

学习索引和查询API

参考官方文档深入了解搜索和聚合功能

加入社区论坛

访问项目论坛或Slack获取帮助和交流