# 在 AWS Glue Studio 中连接到 OpenSearch Service
<a name="connecting-to-data-opensearch"></a>

 AWS Glue 提供了对 Amazon OpenSearch Service 的内置支持。AWS Glue Studio 提供了直观的界面，以用于连接到 Amazon OpenSearch Service、编写数据集成作业以及在 AWS Glue Studio 无服务器 Spark 运行时系统上运行这些作业。此功能与 OpenSearch Service 无服务器不兼容。

 AWS Glue Studio 为 Amazon OpenSearch Service 创建统一连接。有关更多信息，请参阅 [注意事项](using-connectors-unified-connections.md#using-connectors-unified-connections-considerations)。

**Topics**
+ [创建 OpenSearch Service 连接](creating-opensearch-connection.md)
+ [创建 OpenSearch Service 源节点](creating-opensearch-source-node.md)
+ [创建 OpenSearch Service 目标节点](creating-opensearch-target-node.md)
+ [高级选项](#creating-opensearch-connection-advanced-options)

# 创建 OpenSearch Service 连接
<a name="creating-opensearch-connection"></a>

**先决条件**
+ 确定您要从中读取的域端点 *aosEndpoint* 和端口 *aosPort*，或者按照 Amazon OpenSearch Service 文档中的说明创建资源。有关更多信息，请参阅《Amazon OpenSearch Service 开发人员指南》中的 [Creating and managing Amazon OpenSearch Service domains](https://docs.aws.amazon.com//opensearch-service/latest/developerguide/createupdatedomains.html)。

  Amazon OpenSearch Service 域端点的默认格式为 https://search-*domainName*-*unstructuredIdContent*.*region*.es.amazonaws.com。有关如何确定域端点的更多信息，请参阅《Amazon OpenSearch Service 开发人员指南》中的 [Creating and managing Amazon OpenSearch Service domains](https://docs.aws.amazon.com//opensearch-service/latest/developerguide/createupdatedomains.html)。

  确定或生成域的 HTTP 基本身份验证凭证（*aosUser* 和 *aosPassword*）。

**配置 OpenSearch Service 连接：**

1. 在 AWS Secrets Manager 中，使用您的 OpenSearch Service 凭证创建一个密钥。要在 Secrets Manager 中创建密钥，请按照 AWS Secrets Manager 文档中[创建 AWS Secrets Manager 密钥](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html)中的教程进行操作。创建密钥后，保留密钥名称 *secretName*，以供下一步使用。
   + 在选择**键/值对**时，请使用键 `USERNAME` 和值 *aosUser* 创建一个键值对。
   + 在选择**键/值对**时，请使用键 `PASSWORD` 和值 *aosPassword* 创建一个键值对。

1. 在 AWS Glue 控制台中，按照 [添加 AWS Glue 连接](console-connections.md) 中的步骤创建一个连接。创建连接后，保留连接名为 *connectionName*，以供未来在 AWS Glue 中使用。
   + 选择**连接类型**时，请选择 OpenSearch Service。
   + 选择域端点时，请提供 *aosEndpoint*。
   + 选择端口时，请提供 *aosPort*。
   + 选择 **AWS 密钥**时，请提供 *secretName*。

# 创建 OpenSearch Service 源节点
<a name="creating-opensearch-source-node"></a>

## 所需的先决条件
<a name="creating-opensearch-source-node-prerequisites"></a>
+ 使用 AWS Secrets Manager 密钥配置的 AWS Glue OpenSearch Service 连接，如上一节“[创建 OpenSearch Service 连接](creating-opensearch-connection.md)”中所述。
+ 对您的作业具有读取连接使用的密钥的相应权限。
+ 您要读取的 OpenSearch Service 索引 *aosIndex*。

## 添加 OpenSearch Service 数据来源
<a name="creating-opensearch-source-node-add"></a>

**添加**数据来源 – OpenSearch Service** 节点：**

1.  选择 OpenSearch Service 数据来源的连接。由于您已经创建了它，它应该提供在下拉列表中。如果需要创建连接，请选择**创建 OpenSearch Service 连接**。有关更多信息，请参阅之前的 [创建 OpenSearch Service 连接](creating-opensearch-connection.md) 部分。

    选择连接后，您可以通过单击**查看属性**来查看连接属性。

1. 提供**索引**，即您要读取的索引。

1. （可选）提供**查询**，即用于提供更多具体结果的 OpenSearch 查询。有关编写 OpenSearch 查询的更多信息，请参阅 [读取 OpenSearch Service 索引](aws-glue-programming-etl-connect-opensearch-home.md#aws-glue-programming-etl-connect-opensearch-read)。

1.  在**自定义 OpenSearch Service 属性**中，根据需要输入相关参数和值。

# 创建 OpenSearch Service 目标节点
<a name="creating-opensearch-target-node"></a>

## 所需的先决条件
<a name="creating-opensearch-target-node-prerequisites"></a>
+ 使用 AWS Secrets Manager 密钥配置的 AWS Glue OpenSearch Service 连接，如上一节“[创建 OpenSearch Service 连接](creating-opensearch-connection.md)”中所述。
+ 对您的作业具有读取连接使用的密钥的相应权限。
+ 您要写入的 OpenSearch Service 索引 *aosIndex*。

## 添加 OpenSearch Service 数据目标
<a name="creating-opensearch-target-node-add"></a>

**添加**数据目标 – OpenSearch Service** 节点：**

1.  选择 OpenSearch Service 数据来源的连接。由于您已经创建了它，它应该提供在下拉列表中。如果需要创建连接，请选择**创建 OpenSearch Service 连接**。有关更多信息，请参阅之前的 [创建 OpenSearch Service 连接](creating-opensearch-connection.md) 部分。

    选择连接后，您可以通过单击**查看属性**来查看连接属性。

1. 提供**索引**，即您要读取的索引。

1.  在**自定义 OpenSearch Service 属性**中，根据需要输入相关参数和值。

## 高级选项
<a name="creating-opensearch-connection-advanced-options"></a>

您可以在创建 Amazon OpenSearch Service 节点时提供高级选项。这些选项与编程 Spark 脚本的 AWS Glue 时可用的选项相同。

请参阅[OpenSearch Service 连接](aws-glue-programming-etl-connect-opensearch-home.md)。