›

入门指南

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

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

python -m pip install elasticsearch

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

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

from elasticsearch import Elasticsearch

client = Elasticsearch(
    "https://...",  # Elasticsearch endpoint
    api_key="api_key",
)

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

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

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

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

这是创建 my_index 索引的方法

client.indices.create(index="my_index")

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

client.index(
    index="my_index",
    id="my_document_id",
    document={
        "foo": "foo",
        "bar": "bar",
    }
)

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

client.get(index="my_index", id="my_document_id")

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

client.search(index="my_index", query={
    "match": {
        "foo": "foo"
    }
})

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

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

client.delete(index="my_index", id="my_document_id")

client.indices.delete(index="my_index")

进一步阅读