Skip to content

Commit eea6f06

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

File tree

1 file changed

+31
-8
lines changed

1 file changed

+31
-8
lines changed

docs/reference/index.md

Lines changed: 31 additions & 8 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,7 @@ 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

54-
### Elasticsearch Python DSL [_elasticsearch_python_dsl]
55-
56-
The [Python DSL module](../reference/elasticsearch-dsl.md) offers a convenient and idiomatic way to write and manipulate queries.
57-
58-
## {{es}} version compatibility [_compatibility]
59-
60-
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.
83+
## Compatibility [_compatibility]
6184

6285
| Client version | {{es}} `8.x` | {{es}} `9.x` | {{es}} `10.x` |
6386
|----------------|---------------------------------|---------------------------------|----------------------------------|
@@ -82,4 +105,4 @@ In the Python client, compatibility mode is always enabled.
82105

83106
:::{tip}
84107
To support working with multiple client versions, the Python client is also released under the package names `elasticsearch8` and `elasticsearch9` (to prevent name collisions).
85-
:::
108+
:::

0 commit comments

Comments
 (0)