# 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 サービスのサーバーレスとは互換性がありません。　 

 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 ドキュメントの「[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* を保存しておきます。
   + **[key/value ペア]** を選択する際に、*aosUser* という値を持つキー `USERNAME` のペアを作成します。
   + **[key/value ペア]** を選択する際に、*aosPassword* という値を持つキー `PASSWORD` のペアを作成します。

1. AWS Glue コンソールで、「[AWS Glue 接続の追加](console-connections.md)」にあるステップに従って接続を作成します。接続を作成したら、将来的に AWS Glue で使用するために、接続名 *connectionName* を維持します。
   + **[接続タイプ]** を選択する場合は、[OpenSearch Service] を選択します。
   + ドメインエンドポイントを選択する場合は、*aosEndpoint* を入力します。
   + ポートを選択する場合は、*aosPort* を入力します。
   + **[AWS Secret]** をクリックして、*secretName* を入力します。

# OpenSearch Service のソースノードの作成
<a name="creating-opensearch-source-node"></a>

## 必要な前提条件
<a name="creating-opensearch-source-node-prerequisites"></a>
+ 前のセクション [OpenSearch Service 接続の作成](creating-opensearch-connection.md) で説明したような、AWS Secrets Manager シークレットを使用して設定された AWS Glue OpenSearch Service 接続。
+ 接続で使用されるシークレットを読み取るためのジョブに対する適切なアクセス許可。
+ 読み取り元とする 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>
+ 前のセクション [OpenSearch Service 接続の作成](creating-opensearch-connection.md) で説明したような、AWS Secrets Manager シークレットを使用して設定された AWS Glue OpenSearch Service 接続。
+ 接続で使用されるシークレットを読み取るためのジョブに対する適切なアクセス許可。
+ 書き込み先とする 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 ノードを作成する際に、高度なオプションを指定できます。これらのオプションは Spark AWS Glue スクリプトのプログラミング時に使用できるオプションと同じです。

「[OpenSearch Service 接続](aws-glue-programming-etl-connect-opensearch-home.md)」を参照してください。