<p align="center"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/350a6a14-19b8-4200-bd7d-9d8c9505c464.svg" width="20%" alt="Elastic 标志" /> </p>

Elasticsearch Python 客户端

<p align="center"> <a href="https://pypi.org/project/elasticsearch"><img alt="PyPI 版本" src="https://img.shields.io/pypi/v/elasticsearch" /></a> <a href="https://pypi.org/project/elasticsearch"><img alt="Python 版本" src="https://img.shields.io/pypi/pyversions/elasticsearch" /></a> <a href="https://anaconda.org/conda-forge/elasticsearch"><img alt="Conda 版本" src="https://img.shields.io/conda/vn/conda-forge/elasticsearch" /></a> <a href="https://pepy.tech/project/elasticsearch?versions=*"><img alt="下载量" src="https://static.pepy.tech/badge/elasticsearch" /></a> <br/> <a href="https://github.com/elastic/elasticsearch-py/actions/workflows/ci.yml?query=workflow%3ACI"><img alt="GitHub 构建状态" src="https://yellow-cdn.veclightyear.com/0a4dffa0/a5757d22-4dda-4d48-84d3-590e2b9b7932.svg" /></a> <a href="https://buildkite.com/elastic/elasticsearch-py-integration-tests"><img alt="Buildkite 构建状态" src="https://yellow-cdn.veclightyear.com/0a4dffa0/b6506632-62e3-480d-b99d-636175ec7326.svg" /></a> <a href="https://elasticsearch-py.readthedocs.io"><img alt="文档状态" src="https://readthedocs.org/projects/elasticsearch-py/badge/?version=latest" /></a><br> </p>

Elasticsearch 的官方 Python 客户端。

特性

• 将基本 Python 数据类型转换为 JSON，反之亦然
• 可配置的集群节点自动发现
• 持久连接
• 可用节点间的负载均衡（具有可插拔的选择策略）
• 失败连接惩罚（基于时间 - 在达到超时之前不会重试失败的连接）
• 支持 TLS 和 HTTP 认证
• 跨请求线程安全
• 可插拔架构
• 用于惯用 API 组合的辅助函数

安装

下载最新版本的 Elasticsearch 或 注册 Elastic Cloud 免费试用。

请参阅入门文档的安装部分。

连接

请参阅入门文档的连接部分。

用法

• 创建索引
• 索引文档
• 获取文档
• 搜索文档
• 更新文档
• 删除文档
• 删除索引

兼容性

语言客户端具有前向兼容性；这意味着客户端支持与更高或相等的 Elasticsearch 次要版本进行通信而不会出现问题。但这并不意味着客户端自动支持新版本 Elasticsearch 的新功能；只有在发布新的客户端版本后才能支持。例如，8.12 版本的客户端不会自动支持 Elasticsearch 8.13 版本的新功能，需要 8.13 版本的客户端才能支持。Elasticsearch 语言客户端仅与默认发行版向后兼容，且不做任何保证。

Elasticsearch 版本	Elasticsearch-Python 分支	支持
main	main
8.x	8.x	8.x
7.x	7.x	7.17

如果您需要同时安装多个版本，旧版本也以 elasticsearch7 和 elasticsearch8 的名称发布。

文档

客户端的文档可在 elastic.co 和 Read the Docs 上查阅。

反馈 🗣️

Elastic 的工程团队正在寻找开发者参与研究和反馈会议，以了解更多关于您如何使用我们的 Python 客户端以及我们可以如何改进其设计和您的工作流程。如果您有兴趣分享您对开发者体验和语言客户端设计的见解，请填写这个简短表单。根据我们收到的回复数量，我们可能会联系您进行一对一的交流或与使用相同客户端的其他开发者进行焦点小组讨论。提前感谢 - 您的反馈对改善所有 Elasticsearch 开发者的用户体验至关重要！

许可证

本软件根据 Apache License 2.0 许可。请参阅 NOTICE。