A newer version is available. For the latest information, see the
current release documentation.
Examples
editExamples
editBelow you can find examples of how to use the most frequently called APIs with the Python client.
Indexing a document
editTo 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 document
editTo get a document, you need to specify its index
and id
:
res = es.get(index="test-index", id=1) print(res['_source'])
Refreshing an index
editYou can perform the refresh operation on an index:
es.indices.refresh(index="test-index")
Searching for a document
editThe search()
method returns results that are matching a query:
res = es.search(index="test-index", query={"match_all": {}}) print("Got %d Hits:" % res['hits']['total']['value']) for hit in res['hits']['hits']: print("%(timestamp)s %(author)s: %(text)s" % hit["_source"])
Updating a document
editTo 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 document
editYou can delete a document by specifying its index
, and id
in the delete()
method:
es.delete(index="test-index", id=1)