说明
Elastic 官方鼓励在项目中尝试用这个包,但请记住以下几点:
- 这个项目的工作还在进行中,并非所有计划的功能和 Elasticsearch 官方客户端中的标准(故障重试,节点自动发现等)都实现了。
- API 稳定性无法保证。 尽管公共 API 的设计非常谨慎,但它们可以根据进一步的探索和用户反馈以不兼容的方式进行更改。
- 客户端的目标是 Elasticsearch 7.x 版本。后续将添加对 6.x 和 5.x 版本 API 的支持。
安装
用go get安装这个包:
复制代码
go get -u github.com/elastic/go-elasticsearch
或者将这个包添加到go.mod文件:
复制代码
require github.com/elastic/go-elasticsearch v0.0.0
或者克隆这个仓库:
复制代码
git clone https://github.com/elastic/go-elasticsearch.git && cd go-elasticsearch
一个完整的示例:
复制代码
mkdir my-elasticsearch-app && cd my-elasticsearch-app cat > go.mod < main.go <
用法
elasticsearch包与另外两个包绑定在一起,esapi用于调用 Elasticsearch 的 API,estransport通过 HTTP 传输数据。
使用elasticsearch.NewDefaultClient()函数创建带有以下默认设置的客户端:
复制代码
es, err := elasticsearch.NewDefaultClient()if err != nil { log.Fatalf("Error creating the client: %s