Skip to content

Commit 066b81a

Browse files
committed
Minor - Missing OpenSearch in docs
1 parent 781b773 commit 066b81a

File tree

4 files changed

+29
-10
lines changed

4 files changed

+29
-10
lines changed

awswrangler/opensearch/_read.py

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -59,22 +59,22 @@ def search(
5959
A comma-separated list of index names to search.
6060
use `_all` or empty string to perform the operation on all indices.
6161
search_body : Dict[str, Any], optional
62-
The search definition using the [Query DSL](https://opensearch.org/docs/opensearch/query-dsl/full-text/).
62+
The search definition using the `Query DSL <https://opensearch.org/docs/opensearch/query-dsl/full-text/>`_.
6363
doc_type : str, optional
6464
Name of the document type (for Elasticsearch versions 5.x and earlier).
6565
is_scroll : bool, optional
6666
Allows to retrieve a large numbers of results from a single search request using
67-
[scroll](https://opensearch.org/docs/opensearch/rest-api/scroll/)
67+
`scroll <https://opensearch.org/docs/opensearch/rest-api/scroll/>`_
6868
for example, for machine learning jobs.
6969
Because scroll search contexts consume a lot of memory, we suggest you don’t use the scroll operation
7070
for frequent user queries.
7171
filter_path : Union[str, Collection[str]], optional
7272
Use the filter_path parameter to reduce the size of the OpenSearch Service response \
7373
(default: ['hits.hits._id','hits.hits._source'])
7474
**kwargs :
75-
KEYWORD arguments forwarded to [opensearchpy.OpenSearch.search]\
76-
(https://opensearch-py.readthedocs.io/en/latest/api.html#opensearchpy.OpenSearch.search)
77-
and also to [opensearchpy.helpers.scan](https://opensearch-py.readthedocs.io/en/master/helpers.html#scan)
75+
KEYWORD arguments forwarded to `opensearchpy.OpenSearch.search \
76+
<https://opensearch-py.readthedocs.io/en/latest/api.html#opensearchpy.OpenSearch.search>`_
77+
and also to `opensearchpy.helpers.scan <https://opensearch-py.readthedocs.io/en/master/helpers.html#scan>`_
7878
if `is_scroll=True`
7979
8080
Returns
@@ -122,7 +122,7 @@ def search(
122122

123123

124124
def search_by_sql(client: OpenSearch, sql_query: str, **kwargs: Any) -> pd.DataFrame:
125-
"""Return results matching [SQL query](https://opensearch.org/docs/search-plugins/sql/index/) as pandas dataframe.
125+
"""Return results matching `SQL query <https://opensearch.org/docs/search-plugins/sql/index/>`_ as pandas dataframe.
126126
127127
Parameters
128128
----------

awswrangler/opensearch/_utils.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,10 @@ def connect(
4545
4646
Note
4747
----
48-
We use [opensearch-py](https://github.com/opensearch-project/opensearch-py), an OpenSearch low-level python client.
48+
We use `opensearch-py <https://github.com/opensearch-project/opensearch-py>`_, an OpenSearch python client.
4949
50-
The username and password are mandatory if the OS Cluster uses [Fine Grained Access Control]\
51-
(https://docs.aws.amazon.com/opensearch-service/latest/developerguide/fgac.html).
50+
The username and password are mandatory if the OS Cluster uses `Fine Grained Access Control \
51+
<https://docs.aws.amazon.com/opensearch-service/latest/developerguide/fgac.html>`_.
5252
If fine grained access control is disabled, session access key and secret keys are used.
5353
5454
Parameters

awswrangler/opensearch/_write.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -275,7 +275,7 @@ def index_json(
275275
json_path : str, optional
276276
JsonPath expression to specify explicit path to a single name element
277277
in a JSON hierarchical data structure.
278-
Read more about [JsonPath](https://jsonpath.com)
278+
Read more about `JsonPath <https://jsonpath.com>`_
279279
boto3_session : boto3.Session(), optional
280280
Boto3 Session to be used to access s3 if s3 path is provided.
281281
The default boto3 Session will be used if boto3_session receive None.

docs/source/api.rst

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ API Reference
1010
* `Microsoft SQL Server`_
1111
* `Data API Redshift`_
1212
* `Data API RDS`_
13+
* `OpenSearch`_
1314
* `DynamoDB`_
1415
* `Amazon Timestream`_
1516
* `Amazon EMR`_
@@ -199,6 +200,24 @@ Data API RDS
199200
connect
200201
read_sql_query
201202

203+
OpenSearch
204+
----------
205+
206+
.. currentmodule:: awswrangler.opensearch
207+
208+
.. autosummary::
209+
:toctree: stubs
210+
211+
connect
212+
create_index
213+
delete_index
214+
index_csv
215+
index_documents
216+
index_df
217+
index_json
218+
search
219+
search_by_sql
220+
202221
DynamoDB
203222
--------
204223

0 commit comments

Comments
 (0)