Are you sure you want to delete this task? Once this task is deleted, it cannot be recovered.
This is a development branch that is actively being worked on. DO NOT USE IN PRODUCTION! If you want to use stable versions of Elastic, please use Go modules for the 7.x release (or later) or a dependency manager like dep for earlier releases.
Elastic is an Elasticsearch client for the
Go programming language.
See the wiki for additional information about Elastic.
The release branches (e.g. release-branch.v7
)
are actively being worked on and can break at any time.
If you want to use stable versions of Elastic, please use Go modules.
Here's the version matrix:
Elasticsearch version | Elastic version | Package URL | Remarks |
---|---|---|---|
7.x | 7.0 | github.com/olivere/elastic/v7 (source doc) |
Use Go modules. |
6.x | 6.0 | github.com/olivere/elastic (source doc) |
Use a dependency manager (see below). |
5.x | 5.0 | gopkg.in/olivere/elastic.v5 (source doc) |
Actively maintained. |
2.x | 3.0 | gopkg.in/olivere/elastic.v3 (source doc) |
Deprecated. Please update. |
1.x | 2.0 | gopkg.in/olivere/elastic.v2 (source doc) |
Deprecated. Please update. |
0.9-1.3 | 1.0 | gopkg.in/olivere/elastic.v1 (source doc) |
Deprecated. Please update. |
Example:
You have installed Elasticsearch 7.0.0 and want to use Elastic.
As listed above, you should use Elastic 7.0 (code is in release-branch.v7
).
To use the required version of Elastic in your application, you
should use Go modules
to manage dependencies. Make sure to use a version such as 7.0.0
or later.
To use Elastic, import:
import "github.com/olivere/elastic/v7"
Elastic 7.0 targets Elasticsearch 7.x which was released on April 10th 2019.
As always with major version, there are a lot of breaking changes.
We will use this as an opportunity to clean up and refactor Elastic,
as we already did in earlier (major) releases.
Elastic 6.0 targets Elasticsearch 6.x which was released on 14th November 2017.
Notice that there are a lot of breaking changes in Elasticsearch 6.0
and we used this as an opportunity to clean up and refactor Elastic
as we did in the transition from earlier versions of Elastic.
Elastic 5.0 targets Elasticsearch 5.0.0 and later. Elasticsearch 5.0.0 was
released on 26th October 2016.
Notice that there are will be a lot of breaking changes in Elasticsearch 5.0
and we used this as an opportunity to clean up and refactor Elastic
as we did in the transition from Elastic 2.0 (for Elasticsearch 1.x) to Elastic 3.0 (for Elasticsearch 2.x).
Furthermore, the jump in version numbers will give us a chance to be in sync with the Elastic Stack.
Elastic 3.0 targets Elasticsearch 2.x and is published via gopkg.in/olivere/elastic.v3
.
Elastic 3.0 will only get critical bug fixes. You should update to a recent version.
Elastic 2.0 targets Elasticsearch 1.x and is published via gopkg.in/olivere/elastic.v2
.
Elastic 2.0 will only get critical bug fixes. You should update to a recent version.
Elastic 1.0 is deprecated. You should really update Elasticsearch and Elastic
to a recent version.
However, if you cannot update for some reason, don't worry. Version 1.0 is
still available. All you need to do is go-get it and change your import path
as described above.
We use Elastic in production since 2012. Elastic is stable but the API changes
now and then. We strive for API compatibility.
However, Elasticsearch sometimes introduces breaking changes
and we sometimes have to adapt.
Having said that, there have been no big API changes that required you
to rewrite your application big time. More often than not it's renaming APIs
and adding/removing features so that Elastic is in sync with Elasticsearch.
Elastic has been used in production starting with Elasticsearch 0.90 up to recent 7.x
versions. Furthermore, we use Travis CI
to test Elastic with the most recent versions of Elasticsearch and Go.
See the .travis.yml
file for the exact matrix and Travis
for the results.
Elasticsearch has quite a few features. Most of them are implemented
by Elastic. I add features and APIs as required. It's straightforward
to implement missing pieces. I'm accepting pull requests :-)
Having said that, I hope you find the project useful.
The first thing you do is to create a Client.
The client connects to Elasticsearch on http://127.0.0.1:9200
by default.
You typically create one client for your app. Here's a complete example of
creating a client, creating an index, adding a document, executing a search etc.
An example is available here.
Here's a link to a complete working example for v6.
Here are a few tips on how to get used to Elastic:
_test.go
files).Scrolling is supported via a ScrollService
. It supports an iterator-like interface.
The ClearScroll
API is implemented as well.
A pattern for efficiently scrolling in parallel
is described in the Wiki.
Read the contribution guidelines.
Thanks a lot for the great folks working hard on
Elasticsearch
and
Go.
Elastic uses portions of the
uritemplates library
by Joshua Tacoma,
backoff by Cenk Altı and
leaktest by Ian Chiles.
MIT-LICENSE. See LICENSE
or the LICENSE file provided in the repository for details.
本项目是群体化方法与技术的开源实现案例,在基于Gitea的基础上,进一步支持社交化的协同开发、协同学习、协同研究等群体创新实践服务,特别是针对新一代人工智能技术特点,重点支持项目管理、git代码管理、大数据集存储管理与智能计算平台接入。
Go SVG JavaScript Vue HTML other
Dear OpenI User
Thank you for your continuous support to the Openl Qizhi Community AI Collaboration Platform. In order to protect your usage rights and ensure network security, we updated the Openl Qizhi Community AI Collaboration Platform Usage Agreement in January 2024. The updated agreement specifies that users are prohibited from using intranet penetration tools. After you click "Agree and continue", you can continue to use our services. Thank you for your cooperation and understanding.
For more agreement content, please refer to the《Openl Qizhi Community AI Collaboration Platform Usage Agreement》