Skip to content

Commit 878a17b

Browse files
Expand the overview section of the docs
1 parent 06f25a0 commit 878a17b

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

docs/reference/index.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,35 @@ This documentation covers the [official Python client for {{es}}](https://github
1111

1212
API reference documentation is provided on [Read the Docs](https://elasticsearch-py.readthedocs.io).
1313

14+
This client is composed of several modules:
15+
16+
* The actual client, sometimes also called the "low-level" client
17+
18+
This module implements the client support for sending requests to {{es}} servers. The entire surface of the {{es}} API is available through this module.
19+
20+
* [Features](#_features)
21+
* [Reference documentation](https://elasticsearch-py.readthedocs.io/en/stable/es_api.html)
22+
23+
* Bulk helpers
24+
25+
The bulk helpers are a set of functions that use the low-level client's bulk ingest functions, but export a high-level interface based on Python iterables to simplify the ingest of large amounts of data.
26+
27+
* [User guide](https://www.elastic.co/docs/reference/elasticsearch/clients/python/client-helpers#bulk-helpers)
28+
* [Reference documentation](https://elasticsearch-py.readthedocs.io/en/stable/api_helpers.html)
29+
30+
* ES|QL query builder
31+
32+
This module offers an idiomatic interface to construct ES|QL queries based on Python expressions.
33+
34+
* [User guide](https://www.elastic.co/docs/reference/elasticsearch/clients/python/esql-query-builder)
35+
* [Reference documentation](https://elasticsearch-py.readthedocs.io/en/stable/esql.html)
36+
37+
* DSL module
38+
39+
The DSL module could be thought of as a high-level client for {{es}}. It allows applications to manipulate documents and queries using classes and objects instead of primitive types such as dictionaries and lists.
40+
41+
* [User guide](https://www.elastic.co/docs/reference/elasticsearch/clients/python/elasticsearch-dsl)
42+
* [Reference documentation](https://elasticsearch-py.readthedocs.io/en/stable/dsl.html)
1443

1544
The following example shows a simple Python client use case:
1645

@@ -51,13 +80,17 @@ The client also provides a convenient set of [helpers](client-helpers.md) for ta
5180
To get started, try this walkthrough: [Ingest data with Python](docs-content://manage-data/ingest/ingesting-data-from-applications/ingest-data-with-python-on-elasticsearch-service.md)
5281
::::
5382

83+
<<<<<<< Updated upstream
5484
### Elasticsearch Python DSL [_elasticsearch_python_dsl]
5585

5686
The [Python DSL module](../reference/elasticsearch-dsl.md) offers a convenient and idiomatic way to write and manipulate queries.
5787

5888
## {{es}} version compatibility [_compatibility]
5989

6090
Language clients are **forward compatible**: each client version works with equivalent and later minor versions of the **same or next major** version of {{es}}. For full compatibility, the client and {{es}} minor versions should match.
91+
=======
92+
## Compatibility [_compatibility]
93+
>>>>>>> Stashed changes
6194
6295
| Client version | {{es}} `8.x` | {{es}} `9.x` | {{es}} `10.x` |
6396
|----------------|---------------------------------|---------------------------------|----------------------------------|

0 commit comments

Comments
 (0)