Elasticsearch Python 客户端
Elasticsearch 的官方 Python 客户端。
功能
- 基本 Python 数据类型与 JSON 之间的相互转换
- 可配置的集群节点自动发现
- 持久连接
- 跨可用节点的负载均衡（支持可插拔的选择策略）
- 失败连接惩罚（基于时间 - 在达到超时之前不会重试失败的连接）
- 支持 TLS 和 HTTP 身份验证
- 跨请求的线程安全
- 可插拔架构
- 用于惯用组合使用 API 的辅助函数
安装
下载 Elasticsearch 的最新版本 或 注册 Elastic Cloud 的免费试用。
请参阅入门文档中的安装部分 。
连接
请参阅入门文档中的连接部分 。
用法
兼容性
语言客户端是_向前兼容的：_每个客户端版本都可以与相同及后续的小版本 Elasticsearch 配合使用，而不会导致破坏。
兼容性并不意味着功能完全对等。新的 Elasticsearch 功能仅在相同版本的客户端中受到支持。例如，8.12 客户端完全支持 Elasticsearch 8.12 的功能，并且可以与 8.13 配合使用而不会导致破坏；但是，它不支持新的 Elasticsearch 8.13 功能。8.13 客户端完全支持 Elasticsearch 8.13 的功能。
| Elasticsearch 版本 | elasticsearch-py 分支 |
|---|---|
| main | main |
| 9.x | 9.x |
| 9.x | 8.x |
| 8.x | 8.x |
Elasticsearch 语言客户端在次要版本之间也是_向后兼容的_ — 针对默认发行版，且不提供保证。
[!TIP] 若要升级到新的主要版本，请先升级 Elasticsearch，然后升级 Python Elasticsearch 客户端。
如果你需要处理多个客户端版本，请注意旧版本也会作为 elasticsearch7 和 elasticsearch8 发布。
文档
客户端的文档[可在 elastic.co 上获取]以及Read the Docs。
在本地试用 Elasticsearch 和 Kibana
如果你想在本地试用 Elasticsearch 和 Kibana，可以运行以下命令：
curl -fsSL https://elastic.co/start-local | sh这将在 http://localhost:9200 运行 Elasticsearch，并在 http://localhost:5601 运行 Kibana。
更多信息请参见 此处。
贡献
许可证
本软件基于 Apache License 2.0 授权。参见 NOTICE。