OpenSearch快速入门指南 – wiki大全

作者： /

OpenSearch快速入门指南

引言

OpenSearch 是一个功能强大、开源的搜索和分析套件，源于 Elasticsearch，为搜索和分析数据提供了可扩展且灵活的解决方案。它旨在处理各种数据类型，包括日志数据、全文搜索和复杂分析。无论您是需要构建一个强大的搜索引擎，还是对大量数据进行实时分析，OpenSearch 都能提供所需的工具和性能。

核心概念

在深入了解 OpenSearch 之前，理解其核心概念至关重要：

  • 文档 (Documents)：OpenSearch 中数据的基本单元。每个文档都是一个 JSON 对象，包含了一个或多个字段及其对应的值。
  • 索引 (Index)：文档的逻辑集合，类似于关系数据库中的“表”。索引是存储和组织文档的方式，通过索引可以对文档进行搜索。
  • 分片 (Shards)：索引被划分为分片，每个分片都是一个独立的 Apache Lucene 索引。分片在节点之间分布式存储，以实现并行处理、可伸缩性和容错性。
  • 副本 (Replicas)：分片的主副本。副本提供高可用性和弹性，即使某个主分片发生故障，副本也能接替工作。
  • 集群 (Cluster)：由一个或多个 OpenSearch 节点组成的集合，这些节点协同工作来管理数据和执行任务。
  • 节点 (Nodes)：集群中的单个 OpenSearch 实例。节点可以扮演不同的角色，例如主节点（管理集群状态）和数据节点（存储和处理数据）。

快速入门：本地 Docker Compose 部署

对于本地开发和测试，使用 Docker Compose 是最便捷的部署方式：

  1. 前提条件：确保您的系统已安装 Docker 和 Docker Compose。
  2. 下载 Docker Compose 文件：从 OpenSearch 项目的官方仓库获取 docker-compose.yml 文件。您可以访问 OpenSearch 的 GitHub 仓库或官方文档来获取最新的文件。
  3. 启动 OpenSearch：
    • 导航到您保存 docker-compose.yml 文件的目录。
    • 运行以下命令启动 OpenSearch 和 OpenSearch Dashboards 容器：
      bash
      docker-compose up -d
      -d 参数表示在后台运行容器。
  4. 验证服务：
    • 等待几分钟，让服务完全启动。
    • 通过查询 OpenSearch REST API 来验证服务是否正在运行。在新的终端中执行：
      bash
      curl -XGET "https://localhost:9200" -u 'admin:admin' --insecure
      默认用户名和密码通常是 admin:admin。--insecure 选项用于跳过 SSL 证书验证。如果返回 OpenSearch 版本信息等 JSON 响应，则表示 OpenSearch 已成功运行。

基本操作

OpenSearch 提供了 RESTful API，可以通过 cURL、Postman 或 OpenSearch Dashboards 的开发控制台与服务进行交互。

索引数据 (添加文档)

在 OpenSearch 中，数据作为 JSON 文档存储在索引中。如果索引不存在，OpenSearch 会在您添加第一个文档时自动创建它。

以下是一个使用 cURL 添加文档的示例：

bash
curl -XPUT "https://localhost:9200/my-first-index/_doc/1" -u 'admin:admin' -H 'Content-Type: application/json' --insecure -d'
{
"title": "OpenSearch 快速入门",
"author": "AI 助手",
"content": "这是一个 OpenSearch 的快速入门指南。"
}'

解释：
* -XPUT：指定 HTTP PUT 方法，用于创建或更新文档。
* https://localhost:9200/my-first-index/_doc/1：指定目标 URL。my-first-index 是索引名称，_doc 表示文档类型，1 是文档的 ID。
* -u 'admin:admin'：认证凭据。
* -H 'Content-Type: application/json'：指定请求体的内容类型。
* -d：后面是 JSON 格式的文档数据。

基本搜索

数据索引完成后，您可以执行搜索操作。最基本的搜索是通过 GET 请求完成的：

bash
curl -XGET "https://localhost:9200/my-first-index/_search?q=快速" -u 'admin:admin' --insecure

解释：
* -XGET：指定 HTTP GET 方法。
* https://localhost:9200/my-first-index/_search?q=快速：指定搜索 URL。_search 是搜索端点，?q=快速 是查询字符串，表示搜索包含“快速”一词的文档。

OpenSearch Dashboards 简介

OpenSearch Dashboards 是 OpenSearch 的可视化用户界面，它提供了一个强大的平台，用于探索、可视化和分析您的数据。

  • 功能：

    • 创建可视化：您可以构建各种图表、地图和数据表，将您的数据转化为直观的视觉信息。
    • 构建仪表板：将多个可视化组合成交互式仪表板，用于数据监控、分析和报告。
    • 添加示例数据：OpenSearch Dashboards 通常附带示例数据集（如航班数据），您可以导入这些数据来探索其功能并学习如何使用。

  • 访问方式：

    • 如果您使用 Docker Compose 在本地部署，可以通过浏览器访问 https://localhost:5601。
    • 使用之前设置的 admin:admin 凭据登录。

总结

本快速入门指南旨在为您提供 OpenSearch 的基础知识和启动步骤。从核心概念到本地部署，再到基本的数据操作和可视化工具，您现在应该对 OpenSearch 有了初步的了解。随着您对 OpenSearch 的熟悉，可以进一步探索其高级特性，如聚合、安全配置、插件开发以及在生产环境中的部署和优化。

滚动至顶部