入门编辑

本页将引导您完成 Node.js 客户端的安装过程,并向您展示如何实例化客户端以及如何使用它执行基本的 Elasticsearch 操作。

要求编辑

  • Node.js 版本 14.x 或更高版本
  • npm,通常与 Node.js 捆绑在一起

安装编辑

要安装最新版本的客户端,请运行以下命令

npm install @elastic/elasticsearch

有关更多信息,请参阅 安装 页面。

连接编辑

您可以使用 API 密钥和 Elasticsearch 端点连接到 Elastic Cloud。

const { Client } = require('@elastic/elasticsearch')
const client = new Client({
  node: 'https://...', // Elasticsearch endpoint
  auth: {
    apiKey: { // API key ID and secret
      id: 'foo',
      api_key: 'bar',
    }
  }
})

您的 Elasticsearch 端点可以在您的部署的 我的部署 页面上找到

Finding Elasticsearch endpoint

您可以在 管理 页面上的安全部分生成 API 密钥。

Create API key

有关其他连接选项,请参阅 连接 部分。

操作编辑

是时候使用 Elasticsearch 了!本节将引导您完成 Elasticsearch 的基本操作和最重要的操作。

创建索引编辑

以下是创建 my_index 索引的方法

await client.indices.create({ index: 'my_index' })

索引文档编辑

这是一种简单的索引文档的方法

await client.index({
  index: 'my_index',
  id: 'my_document_id',
  document: {
    foo: 'foo',
    bar: 'bar',
  },
})

获取文档编辑

您可以使用以下代码获取文档

await client.get({
  index: 'my_index',
  id: 'my_document_id',
})

搜索文档编辑

以下是使用客户端创建单个匹配查询的方法

await client.search({
  query: {
    match: {
      foo: 'foo'
    }
  }
})

更新文档编辑

以下是更新文档的方法,例如添加新字段

await client.update({
  index: 'my_index',
  id: 'my_document_id',
  doc: {
    foo: 'bar',
    new_field: 'new value'
  }
})

删除文档编辑

await client.delete({
  index: 'my_index',
  id: 'my_document_id',
})

删除索引编辑

await client.indices.delete({ index: 'my_index' })

进一步阅读编辑

  • 使用 客户端助手 可以更轻松地使用 API。
  • 有关如何将数据导入 Elastic Cloud 的详细示例,请参阅 此页面