Elasticsearch-js 实战：使用 search API 进行数据检索

Elasticsearch-js 实战：使用 search API 进行数据检索

elasticsearch-js 项目地址: https://gitcode.com/gh_mirrors/ela/elasticsearch-js

前言

Elasticsearch-js 是 Elasticsearch 官方提供的 JavaScript 客户端库，它允许开发者通过 JavaScript 与 Elasticsearch 集群进行交互。本文将重点介绍如何使用 search API 进行数据检索操作，这是 Elasticsearch 最核心的功能之一。

环境准备

在开始之前，我们需要确保已经正确设置了 Elasticsearch-js 客户端。示例中展示了两种常见的连接方式：

1. 云服务连接（通过 cloud.id 和 apiKey）
2. 本地集群连接（未展示，但通常使用 node 配置）

const { Client } = require('@elastic/elasticsearch')
const client = new Client({
  cloud: { id: '<cloud-id>' },
  auth: { apiKey: 'base64EncodedKey' }
})

数据索引

在执行搜索之前，我们需要先向 Elasticsearch 索引一些数据。示例中创建了一个名为 "game-of-thrones" 的索引，并添加了三条包含角色和名言的文档：

await client.index({
  index: 'game-of-thrones',
  document: {
    character: 'Ned Stark',
    quote: 'Winter is coming.'
  }
})

关键点说明：

• index 操作是异步的，默认情况下新索引的文档不会立即可搜索
• 可以通过设置 refresh: true 强制刷新索引，使文档立即可搜索（如第三个文档所示）

执行搜索

搜索是 Elasticsearch 的核心功能，示例展示了最基本的 match 查询：

const result = await client.search({
  index: 'game-of-thrones',
  query: {
    match: {
      quote: 'winter'
    }
  }
})

搜索参数解析：

• index: 指定要搜索的索引名称
• query: 定义搜索条件，这里使用了 match 查询
• match: 对指定字段（quote）进行全文搜索，查找包含 "winter" 的文档

结果处理

搜索返回的结果包含在 hits.hits 数组中：

console.log(result.hits.hits)

每个命中结果包含以下信息：

• _index: 文档所在的索引
• _id: 文档的唯一标识
• _score: 相关性评分
• _source: 文档的原始内容

最佳实践建议

1. 索引刷新策略：生产环境中应避免频繁使用 refresh: true，这会严重影响性能。可以考虑使用 ?refresh=wait_for 参数。

2. 查询性能：对于大型索引，应该添加适当的过滤条件缩小搜索范围。

3. 分页处理：实际应用中应该使用 from 和 size 参数实现分页。

4. 错误处理：示例中使用了简单的 catch(console.log)，实际应用中应该实现更完善的错误处理机制。

扩展知识

除了基本的 match 查询，Elasticsearch 还支持多种查询类型：

• term: 精确值查询
• range: 范围查询
• bool: 组合多个查询条件
• match_phrase: 短语匹配查询

总结

本文通过一个简单的示例演示了如何使用 Elasticsearch-js 的 search API 进行数据检索。实际应用中，搜索功能可能会更加复杂，需要结合具体业务场景设计合适的查询条件和结果处理逻辑。理解这些基础操作是构建强大搜索功能的第一步。

elasticsearch-js 项目地址: https://gitcode.com/gh_mirrors/ela/elasticsearch-js