本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 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 Serverless 不相容。

 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>

**先決條件：**
+ 依照 Amazon OpenSearch Service 文件中的說明，識別您想要讀取的網域端點 *aosEndpoint* 和連接埠 *aosPort* 或建立資源。如需有關建立網域的詳細資訊，請參閱《Amazon OpenSearch Service 文件》中的[建立和管理 Amazon OpenSearch Service 網域](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 文件》中的[建立和管理 Amazon OpenSearch Service 網域](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*，以便進行下一個步驟。
   + 在選取**鍵/值組**時，請使用 *aosUser* 值來建立 `USERNAME` 金鑰對。
   + 在選取**鍵/值組**時，請使用 *aosPassword* 值來建立 `PASSWORD` 金鑰對。

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>
+ A AWS Glue OpenSearch Service 連線，使用 AWS Secrets Manager 秘密設定，如上節所述：[建立 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>
+ A AWS Glue OpenSearch Service 連線，使用 AWS Secrets Manager 秘密設定，如上節所述：[建立 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>

您可以在建立 OpenSearch Service 節點時提供進階選項。這些選項與 AWS Glue Spark 指令碼程式設計時可用的選項相同。

請參閱[OpenSearch Service 連線](aws-glue-programming-etl-connect-opensearch-home.md)。