Skip to content

Commit cfaadea

Browse files
Revise Amazon S3 data source (#8109) (#8129)
1 parent 1efd3ae commit cfaadea

File tree

1 file changed

+18
-28
lines changed

1 file changed

+18
-28
lines changed

_dashboards/management/S3-data-source.md

Lines changed: 18 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -10,51 +10,41 @@ has_children: true
1010
Introduced 2.11
1111
{: .label .label-purple }
1212

13-
Starting with OpenSearch 2.11, you can connect OpenSearch to your Amazon Simple Storage Service (Amazon S3) data source using the OpenSearch Dashboards UI. You can then query that data, optimize query performance, define tables, and integrate your S3 data within a single UI.
13+
You can connect OpenSearch to your Amazon Simple Storage Service (Amazon S3) data source using the OpenSearch Dashboards interface and then query that data, optimize query performance, define tables, and integrate your S3 data.
1414

1515
## Prerequisites
1616

17-
To connect data from Amazon S3 to OpenSearch using OpenSearch Dashboards, you must have:
17+
Before connecting a data source, verify that the following requirements are met:
1818

19-
- Access to Amazon S3 and the [AWS Glue Data Catalog](https://github.com/opensearch-project/sql/blob/main/docs/user/ppl/admin/connectors/s3glue_connector.rst#id2).
20-
- Access to OpenSearch and OpenSearch Dashboards.
21-
- An understanding of OpenSearch data source and connector concepts. See the [developer documentation](https://github.com/opensearch-project/sql/blob/main/docs/user/ppl/admin/datasources.rst#introduction) for information about these concepts.
19+
- You have access to Amazon S3 and the [AWS Glue Data Catalog](https://github.com/opensearch-project/sql/blob/main/docs/user/ppl/admin/connectors/s3glue_connector.rst#id2).
20+
- You have access to OpenSearch and OpenSearch Dashboards.
21+
- You have an understanding of OpenSearch data source and connector concepts. See the [developer documentation](https://github.com/opensearch-project/sql/blob/main/docs/user/ppl/admin/datasources.rst#introduction) for more information.
2222

23-
## Connect your Amazon S3 data source
23+
## Connect your data source
2424

25-
To connect your Amazon S3 data source, follow these steps:
25+
To connect your data source, follow these steps:
2626

27-
1. From the OpenSearch Dashboards main menu, select **Management** > **Data sources**.
28-
2. On the **Data sources** page, select **New data source** > **S3**. An example UI is shown in the following image.
27+
1. From the OpenSearch Dashboards main menu, go to **Management** > **Dashboards Management** > **Data sources**.
28+
2. On the **Data sources** page, select **Create data source connection** > **Amazon S3**.
29+
3. On the **Configure Amazon S3 data source** page, enter the data source, authentication details, and permissions.
30+
4. Select the **Review Configuration** button to verify the connection details.
31+
5. Select the **Connect to Amazon S3** button to establish a connection.
2932

30-
<img src="{{site.url}}{{site.baseurl}}/images/dashboards/data-sources-UI.png" alt="Amazon S3 data sources UI" width="700"/>
33+
## Manage your data source
3134

32-
3. On the **Configure Amazon S3 data source** page, enter the required **Data source details**, **AWS Glue authentication details**, **AWS Glue index store details**, and **Query permissions**. An example UI is shown in the following image.
33-
34-
<img src="{{site.url}}{{site.baseurl}}/images/dashboards/S3-config-UI.png" alt="Amazon S3 configuration UI" width="700"/>
35-
36-
4. Select the **Review Configuration** button and verify the details.
37-
5. Select the **Connect to Amazon S3** button.
38-
39-
## Manage your Amazon S3 data source
40-
41-
Once you've connected your Amazon S3 data source, you can explore your data through the **Manage data sources** tab. The following steps guide you through using this functionality:
35+
To manage your data source, follow these steps:
4236

4337
1. On the **Manage data sources** tab, choose a date source from the list.
44-
2. On that data source's page, you can manage the data source, choose a use case, and manage access controls and configurations. An example UI is shown in the following image.
45-
46-
<img src="{{site.url}}{{site.baseurl}}/images/dashboards/manage-data-source-UI.png" alt="Manage data sources UI" width="700"/>
47-
48-
3. (Optional) Explore the Amazon S3 use cases, including querying your data and optimizing query performance. Go to **Next steps** to learn more about each use case.
38+
2. On the page for the data source, you can manage the data source, choose a use case, and configure access controls.
39+
3. (Optional) Explore the Amazon S3 use cases, including querying your data and optimizing query performance. Refer to the [**Next steps**](#next-steps) section to learn more about each use case.
4940

5041
## Limitations
5142

52-
This feature is still under development, including the data integration functionality. For real-time updates, see the [developer documentation on GitHub](https://github.com/opensearch-project/opensearch-spark/blob/main/docs/index.md#limitations).
43+
This feature is currently under development, including the data integration functionality. For up-to-date information, refer to the [developer documentation on GitHub](https://github.com/opensearch-project/opensearch-spark/blob/main/docs/index.md#limitations).
5344

5445
## Next steps
5546

5647
- Learn about [querying your data in Data Explorer]({{site.url}}{{site.baseurl}}/dashboards/management/query-data-source/) through OpenSearch Dashboards.
57-
- Learn about ways to [optimize the query performance of your external data sources]({{site.url}}{{site.baseurl}}/dashboards/management/accelerate-external-data/), such as Amazon S3, through Query Workbench.
48+
- Learn about [optimizing the query performance of your external data sources]({{site.url}}{{site.baseurl}}/dashboards/management/accelerate-external-data/), such as Amazon S3, through Query Workbench.
5849
- Learn about [Amazon S3 and AWS Glue Data Catalog](https://github.com/opensearch-project/sql/blob/main/docs/user/ppl/admin/connectors/s3glue_connector.rst) and the APIS used with Amazon S3 data sources, including configuration settings and query examples.
5950
- Learn about [managing your indexes]({{site.url}}{{site.baseurl}}/dashboards/im-dashboards/index/) through OpenSearch Dashboards.
60-

0 commit comments

Comments
 (0)