IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Examplesedit
Below you can find examples of how to use the most frequently called APIs with the Python client.
Indexing a documentedit
To index a document, you need to specify three pieces of information: index
,
id
, and a body
:
from datetime import datetime from elasticsearch import Elasticsearch es = Elasticsearch() doc = { 'author': 'author_name', 'text': 'Interesting content...', 'timestamp': datetime.now(), } res = es.index(index="test-index", id=1, body=doc) print(res['result'])
Getting a documentedit
To get a document, you need to specify its index
and id
:
res = es.get(index="test-index", id=1) print(res['_source'])
Refreshing an indexedit
You can perform the refresh operation on an index:
es.indices.refresh(index="test-index")
Searching for a documentedit
The search()
method returns results that are matching a query:
resp = es.search(index="test-index", query={"match_all": {}}) print("Got %d Hits:" % resp['hits']['total']['value']) for hit in resp['hits']['hits']: print("%(timestamp)s %(author)s: %(text)s" % hit["_source"])
Updating a documentedit
To update a document, you need to specify three pieces of information: index
,
id
, and a body
:
from datetime import datetime from elasticsearch import Elasticsearch es = Elasticsearch() doc = { 'author': 'author_name', 'text': 'Interesting modified content...', 'timestamp': datetime.now(), } res = es.update(index="test-index", id=1, body=doc) print(res['result'])
Deleting a documentedit
You can delete a document by specifying its index
, and id
in the delete()
method:
es.delete(index="test-index", id=1)