From 0dd58646c940471fcf65d4e376034e4b0f942e12 Mon Sep 17 00:00:00 2001 From: Quentin Pradet Date: Fri, 14 Mar 2025 17:46:57 +0400 Subject: [PATCH 1/5] Add querying docs It's not always obvious to go from an API to a function call, and this page contains the details. --- docs/images/python-example.png | Bin 0 -> 109584 bytes docs/reference/querying.md | 108 +++++++++++++++++++++++++++++++++ docs/reference/toc.yml | 3 +- 3 files changed, 110 insertions(+), 1 deletion(-) create mode 100644 docs/images/python-example.png create mode 100644 docs/reference/querying.md diff --git a/docs/images/python-example.png b/docs/images/python-example.png new file mode 100644 index 0000000000000000000000000000000000000000..3eaee6d0224f549152ed9fc0b7063f67822b462e GIT binary patch literal 109584 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/_doc/<_id>` and related endpoints). + * Then there are all the other namespaces, such as: + * Indices with APIs like the Create index API (`PUT /my-index`), + * ES|QL with the Run an ES|QL query API (`POST /_async`), + * and so on. + +As a result, when you know which namespace and function you need, you can call the function. Assuming that `client` is an Elasticsearch instance, here is how you would call the examples from above: + +* Global namespace: `client.search(...)` and `client.index(...)` +* Other namespaces: + * Indices: `client.indices.create(...)` + * ES|QL: `client.esql.query(...)` + +How can you figure out the namespace? + +* The [Elasticsearch API docs](https://www.elastic.co/docs/api/doc/elasticsearch/) can help, even though the tags it uses do not fully map to namespaces. +* You can also use the client docs, by: + * browing the [Elasticsearch API Reference](https://elasticsearch-py.readthedocs.io/en/stable/api.html) page, or + * search for your endpoint using [Read the Docs](https://elasticsearch-py.readthedocs.io/) search, which is powered by Elasticsearch! +* Finally, most examples in the [Elasticsearch guide](https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html) are also available in Python. In the example below, `client.ingest.put_pipeline(...)` is the function that calls the "Create or update a pipeline" API. + + +:::{image} ../images/python-example.png +:alt: Python code example in the Elasticsearch guide +::: + +## Parameters + +Now that you know which functions to call, the next step is parameters. To avoid ambiguity, the Python Elasticsearch client mandates keyword arguments. To give an example, let's look at the ["Create an index" API](https://elasticsearch-py.readthedocs.io/en/stable/api/indices.html#elasticsearch.client.IndicesClient.create). There's only one required parameter, `index`, so the minimal form looks like this: + +```python +from elasticsearch import Elasticsearch + +client = Elasticsearch("http://localhost:9200", api_key="...") + +client.indices.create(index="my-index") +``` + +You can also use other parameters, including the first level of body parameters, such as: + +```python +resp = client.indices.create( + index="logs", + aliases={"logs-alias": {}}, + mappings={"name": {"type": "text"}}, +) +print(resp) +``` + +(In a real query, don't use `...` but real mappings.) + +In this case, the client will send to Elasticsearch the following JSON body: + +```json +PUT /logs +{ + "aliases": {"logs-alias": {}}, + "mappings": {"name": {"type": "text"}} +} +``` + +## Unknown parameters or APIs + +Like other clients, the Python Elasticsearch client is generated from the [Elasticsearch specification](https://github.com/elastic/elasticsearch-specification). While we strive to keep it up to date, it is not (yet!) perfect, and sometimes body parameters are missing. In this case, you can specify the body directly, as follows: + +```python +resp = client.indices.create( + index="logs", + body={ + "aliases": {"logs-alias": {}}, + "mappings": {"name": {"type": "text"}}, + "missing_parameter": "foo", + } +) +print(resp) +``` + +In the event where an API is missing, you need to call the low-level `perform_request` function: + +```python +resp = client.perform_request( + "PUT", + "/logs" + index="logs", + headers={"content-type": "application/json", "accept": "application/json"}, + body={ + "aliases": {"logs-alias": {}}, + "mappings": {"name": {"type": "text"}}, + "missing_parameter": "foo", + } +) +print(resp) +``` + +One benefit of this function is that it lets you use arbitrary headers, such as the `es-security-runas-user` header used to [impersonate users](https://www.elastic.co/guide/en/elasticsearch/reference/current/run-as-privilege.html). + + +## Options + +You can specify options such as request timeouts or retries using the `.options()` API, see the [Configuration](./configuration.md) page for details. \ No newline at end of file diff --git a/docs/reference/toc.yml b/docs/reference/toc.yml index 8de284050..a77bc4c91 100644 --- a/docs/reference/toc.yml +++ b/docs/reference/toc.yml @@ -1,6 +1,7 @@ toc: - file: index.md - file: getting-started.md + - file: querying.md - file: installation.md - file: connecting.md - file: configuration.md @@ -16,4 +17,4 @@ toc: - file: _tutorials.md - file: _how_to_guides.md - file: _examples.md - - file: client-helpers.md \ No newline at end of file + - file: client-helpers.md From 4107f6d3358dcc6a6676ae3eafacd9efccd31670 Mon Sep 17 00:00:00 2001 From: Quentin Pradet Date: Mon, 17 Mar 2025 16:52:21 +0400 Subject: [PATCH 2/5] Apply suggestions from code review Co-authored-by: Miguel Grinberg --- docs/reference/querying.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/reference/querying.md b/docs/reference/querying.md index 2b2fcbed0..eeea3b457 100644 --- a/docs/reference/querying.md +++ b/docs/reference/querying.md @@ -22,9 +22,9 @@ As a result, when you know which namespace and function you need, you can call t How can you figure out the namespace? * The [Elasticsearch API docs](https://www.elastic.co/docs/api/doc/elasticsearch/) can help, even though the tags it uses do not fully map to namespaces. -* You can also use the client docs, by: - * browing the [Elasticsearch API Reference](https://elasticsearch-py.readthedocs.io/en/stable/api.html) page, or - * search for your endpoint using [Read the Docs](https://elasticsearch-py.readthedocs.io/) search, which is powered by Elasticsearch! +* You can also use the client documentation, by: + * browsing the [Elasticsearch API Reference](https://elasticsearch-py.readthedocs.io/en/stable/api.html) page, or + * searching for your endpoint using [Read the Docs](https://elasticsearch-py.readthedocs.io/) search, which is powered by Elasticsearch! * Finally, most examples in the [Elasticsearch guide](https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html) are also available in Python. In the example below, `client.ingest.put_pipeline(...)` is the function that calls the "Create or update a pipeline" API. @@ -59,7 +59,7 @@ print(resp) In this case, the client will send to Elasticsearch the following JSON body: -```json +```console PUT /logs { "aliases": {"logs-alias": {}}, @@ -83,7 +83,7 @@ resp = client.indices.create( print(resp) ``` -In the event where an API is missing, you need to call the low-level `perform_request` function: +In the event where an API is missing, you need to use the low-level `perform_request` function: ```python resp = client.perform_request( From 1d3a2d7dcffa754f5c33c6d53e3b4f1b861e9a58 Mon Sep 17 00:00:00 2001 From: Quentin Pradet Date: Mon, 17 Mar 2025 16:52:55 +0400 Subject: [PATCH 3/5] Address more comments --- docs/reference/querying.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/reference/querying.md b/docs/reference/querying.md index eeea3b457..549076aa9 100644 --- a/docs/reference/querying.md +++ b/docs/reference/querying.md @@ -1,6 +1,6 @@ # Sending queries to Elasticsearch -The Python Elasticsearch client provides several ways to send queries to Elasticsearch. This document explains the details of how to construct and execute queries using the client. This document does not cover the DSL client. +The Python Elasticsearch client provides several ways to send queries to Elasticsearch. This document explains the details of how to construct and execute queries using the client. This document does not cover the DSL module. ## From API URLs to function calls @@ -55,8 +55,6 @@ resp = client.indices.create( print(resp) ``` -(In a real query, don't use `...` but real mappings.) - In this case, the client will send to Elasticsearch the following JSON body: ```console From 2f5db7476bba359e4fe1ca91cd7bb30b50e4f8ab Mon Sep 17 00:00:00 2001 From: Quentin Pradet Date: Mon, 17 Mar 2025 16:55:50 +0400 Subject: [PATCH 4/5] Rename to Querying for consistency --- docs/reference/querying.md | 2 +- docs/reference/toc.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/querying.md b/docs/reference/querying.md index 549076aa9..2487276e1 100644 --- a/docs/reference/querying.md +++ b/docs/reference/querying.md @@ -1,4 +1,4 @@ -# Sending queries to Elasticsearch +# Querying The Python Elasticsearch client provides several ways to send queries to Elasticsearch. This document explains the details of how to construct and execute queries using the client. This document does not cover the DSL module. diff --git a/docs/reference/toc.yml b/docs/reference/toc.yml index a77bc4c91..5d63e27e9 100644 --- a/docs/reference/toc.yml +++ b/docs/reference/toc.yml @@ -1,10 +1,10 @@ toc: - file: index.md - file: getting-started.md - - file: querying.md - file: installation.md - file: connecting.md - file: configuration.md + - file: querying.md - file: async.md - file: integrations.md children: From 42bd4005f981f877baeec0d1f09fd3e8a778d438 Mon Sep 17 00:00:00 2001 From: Quentin Pradet Date: Wed, 2 Apr 2025 16:25:41 +0400 Subject: [PATCH 5/5] Clarify that examples in guide depend on version --- docs/reference/querying.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/querying.md b/docs/reference/querying.md index 2487276e1..5d701280d 100644 --- a/docs/reference/querying.md +++ b/docs/reference/querying.md @@ -25,7 +25,7 @@ How can you figure out the namespace? * You can also use the client documentation, by: * browsing the [Elasticsearch API Reference](https://elasticsearch-py.readthedocs.io/en/stable/api.html) page, or * searching for your endpoint using [Read the Docs](https://elasticsearch-py.readthedocs.io/) search, which is powered by Elasticsearch! -* Finally, most examples in the [Elasticsearch guide](https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html) are also available in Python. In the example below, `client.ingest.put_pipeline(...)` is the function that calls the "Create or update a pipeline" API. +* Finally, for Elasticsearch 8.x, most examples in the [Elasticsearch guide](https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html) are also available in Python. (This is still a work in progress for Elasticsearch 9.x.) In the example below, `client.ingest.put_pipeline(...)` is the function that calls the "Create or update a pipeline" API. :::{image} ../images/python-example.png