入门

入门编辑

本页将指导您完成 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")