« 概述 安装 »
Elastic 文档 ›Elasticsearch Ruby 客户端 [8.17]

入门

编辑

入门

编辑

本页面将引导您完成 Ruby 客户端的安装过程，展示如何实例化客户端，以及如何使用它执行基本的 Elasticsearch 操作。

要求

编辑

一个当前维护的 Ruby 版本 (3.0+) 或 JRuby 版本 (9.3+)。

安装

编辑

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

gem install elasticsearch

请参考安装页面了解更多信息。

连接

编辑

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

client = Elasticsearch::Client.new(
  cloud_id: '<CloudID>',
  api_key: '<ApiKey>'
)

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

Finding Elasticsearch endpoint

您可以在管理页面的“安全”下生成 API 密钥。

Create API key

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

操作

编辑

是时候使用 Elasticsearch 了！本节将引导您完成 Elasticsearch 的基本且最重要的操作。有关更多操作和更高级的示例，请参阅示例页面。

创建索引

编辑

这是您如何创建 my_index 索引的方法

client.indices.create(index: 'my_index')

索引文档

编辑

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

document = { name: 'elasticsearch-ruby' }
response = client.index(index: 'my_index', body: document)
# You can get the indexed document id with:
response['_id']
=> "PlgIDYkBWS9Ngdx5IMy-"
id = response['_id']

获取文档

编辑

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

client.get(index: 'my_index', id: id)

搜索文档

编辑

这是您如何使用 Ruby 客户端创建单个匹配查询的方法

client.search(index: 'my_index', body: { query: { match_all: {} } })

更新文档

编辑

这是您如何更新文档的方法，例如添加一个新字段

client.update(index: 'my_index', id: id, body: { doc: { language: 'Ruby' } })

删除文档

编辑
client.delete(index: 'my_index', id: id)

删除索引

编辑
client.indices.delete(index: 'my_index')

进一步阅读

编辑
« 概述 安装 »