# AWS Glue Studio での Teradata Vantage に対する接続
<a name="connecting-to-data-teradata"></a>

 AWS Glue は、Teradata Vantage のための組み込みサポートを提供します。AWS Glue Studio は、Teradata に接続してデータ統合ジョブをオーサリングし、AWS Glue Studio サーバーレス Spark ランタイム上でそれらのジョブを実行するためのビジュアルインターフェイスを提供します。

 AWS Glue Studio は Teradata Vantage の統合接続を作成します。詳細については、「[考慮事項](using-connectors-unified-connections.md#using-connectors-unified-connections-considerations)」を参照してください。

**Topics**
+ [Teradata Vantage 接続の作成](creating-teradata-connection.md)
+ [Teradata ソースノードの作成](creating-teradata-source-node.md)
+ [Teradata ターゲットノードの作成](creating-teradata-target-node.md)
+ [詳細オプション](#creating-teradata-connection-advanced-options)

# Teradata Vantage 接続の作成
<a name="creating-teradata-connection"></a>

AWS Glue から Teradata Vantage に接続するには、Teradata 認証情報を作成して AWS Secrets Manager シークレットに保存し、そのシークレットを AWS Glue Teradata 接続に関連付ける必要があります。

**前提条件**:
+ Amazon VPC を通じて Teradata 環境にアクセスしている場合は、AWS Glue ジョブが Teradata 環境と通信できるように Amazon VPC を設定します。パブリックインターネット経由で Teradata 環境にアクセスすることは推奨されていません。

  Amazon VPC で、AWS Glue がジョブの実行中に使用する **[VPC]**、**[サブネット]**、および **[セキュリティグループ]** を特定または作成します。さらに、Teradata インスタンスとこの場所の間のネットワークトラフィックを許可するように Amazon VPC が設定されているようにする必要があります。ジョブでは、Teradata クライアントポートとの TCP 接続を確立する必要があります。Teradata ポートの詳細については、[Teradata のドキュメント](https://docs.teradata.com/r/Teradata-VantageTM-on-AWS-DIY-Installation-and-Administration-Guide/April-2020/Before-Deploying-Vantage-on-AWS-DIY/Security-Groups-and-Ports)を参照してください。

  ネットワークレイアウトに応じて、安全な VPC 接続を実現するには、Amazon VPC および他のネットワークサービスの変更が必要な場合があります。AWS 接続の詳細については、Teradata ドキュメントの「[AWS 接続オプション](https://docs.teradata.com/r/Teradata-VantageCloud-Enterprise/Get-Started/Connecting-Your-Environment/AWS-Connectivity-Options)」を参照してください。

**AWS Glue Teradata 接続を設定するには:**

1. Teradata 設定で、AWS Glue が接続するユーザーとパスワード (*teradataUser* および *teradataPassword*) を識別または作成します。詳細については、Teradata ドキュメントの「[Vantage セキュリティの概要](https://docs.teradata.com/r/Configuring-Teradata-VantageTM-After-Installation/January-2021/Security-Overview/Vantage-Security-Overview)」を参照してください。

1. AWS Secrets Manager で、Teradata 認証情報を使用してシークレットを作成します。Secrets Manager でシークレットを作成するには、AWS Secrets Manager ドキュメントの [AWS Secrets Manager シークレットを作成する](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html) にあるチュートリアルに従ってください。シークレットを作成したら、次のステップのためにシークレット名 *secretName* を保存しておきます。
   + **[key/value ペア]** を選択する際に、*teradataUsername* という値を持つキー `user` のペアを作成します。
   + **[key/value ペア]** を選択する際に、*teradataPassword* という値を持つキー `password` のペアを作成します。

1. AWS Glue コンソールで、「[AWS Glue 接続の追加](console-connections.md)」にあるステップに従って接続を作成します。接続を作成したら、次のステップのために接続名 *connectionName* を保存しておきます。
   + **[接続タイプ]** を選択する際に、[Teradata] を選択します。
   + **[JDBC URL]** を入力する場合は、インスタンスの URL を入力します。JDBC URL に特定のカンマ区切りの接続パラメータをハードコーディングすることもできます。URL は次の形式に準拠する必要があります: `jdbc:teradata://teradataHostname/ParameterName=ParameterValue,ParameterName=ParameterValue`

     サポートされる URL パラメータには次が含まれます。
     + `DATABASE` – デフォルトでアクセスするホスト上のデータベースの名前。
     + `DBS_PORT` – データベースポート。非標準ポートで実行する場合に使用されます。
   + **[認証情報タイプ]** を選択する場合は、**[AWS Secrets Manager]** を選択し、**[AWS シークレット]** を *secretName* に設定します。

1. 次の状況では、追加の設定が必要になる場合があります。
   + 

     Amazon VPC の AWS でホストされている Teradata インスタンスの場合
     + Teradata セキュリティ認証情報を定義する AWS Glue 接続に、Amazon VPC 接続に関する情報を提供する必要があります。接続を作成または更新する際に、**[ネットワークオプション]** で **[VPC]**、**[サブネット]**、および **[セキュリティグループ]** を設定します。

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

## 必要な前提条件
<a name="creating-teradata-source-node-prerequisites"></a>
+ 前のセクション [Teradata Vantage 接続の作成](creating-teradata-connection.md) で説明したように、AWS Secrets Manager シークレットを使用して設定された AWS Glue Teradata Vantage 接続。
+ 接続で使用されるシークレットを読み取るためのジョブに対する適切なアクセス許可。
+ 読み取り元とする Teradata テーブル、*tableName*、またはクエリ *targetQuery*。

## Teradata データソースの追加
<a name="creating-teradata-source-node-add"></a>

****[データソース — Teradata]** ノードを追加するには:**

1.  Teradata データソース用の接続を選択します。すでに作成したので、ドロップダウンに表示されているはずです。接続を作成する必要がある場合は、**[新しい接続を作成]** を選択します。詳細については、前の「[Teradata Vantage 接続の作成](creating-teradata-connection.md)」セクションを参照してください。

    接続を選択したあとは、**[プロパティを表示]** をクリックすると、接続のプロパティを表示できます。

1.  **[Teradata ソース]** オプションを選択します。
   +  **[単一のテーブルを選択]** – 単一のテーブルからすべてのデータにアクセスします。
   +  **[カスタムクエリを入力]** — カスタムクエリに基づいて、複数のテーブルからデータセットにアクセスします。

1.  単一のテーブルを選択した場合は、*tableName* を入力します。

    **[カスタムクエリを入力]** を選択した場合は、SQL SELECT クエリを入力します。

1.  **[Teradata のカスタムプロパティ]** で、必要に応じてパラメータと値を入力します。

# Teradata ターゲットノードの作成
<a name="creating-teradata-target-node"></a>

## 必要な前提条件
<a name="creating-teradata-target-node-prerequisites"></a>
+ 前のセクション [Teradata Vantage 接続の作成](creating-teradata-connection.md) で説明したように、AWS Secrets Manager シークレットを使用して設定された AWS Glue Teradata Vantage 接続。
+ 接続で使用されるシークレットを読み取るためのジョブに対する適切なアクセス許可。
+ 書き込み先とする Teradata テーブルである *tableName*。

## Teradata データターゲットの追加
<a name="creating-teradata-target-node-add"></a>

****[データターゲット — Teradata]** ノードを追加するには:**

1.  Teradata データソース用の接続を選択します。すでに作成したので、ドロップダウンに表示されているはずです。接続を作成する必要がある場合は、**[Teradata 接続を作成]** を選択します。詳細については、「[コネクタと接続の使用に関する概要](https://docs.aws.amazon.com/glue/latest/ug/connectors-chapter.html#using-connectors-overview)」を参照してください。

    接続を選択したあとは、**[プロパティを表示]** をクリックすると、接続のプロパティを表示できます。

1. *tableName* を指定して **[テーブル名]** を設定します。

1.  **[Teradata のカスタムプロパティ]** で、必要に応じてパラメータと値を入力します。

## 詳細オプション
<a name="creating-teradata-connection-advanced-options"></a>

Teradata ノードを作成する際に、高度なオプションを指定できます。これらのオプションは Spark AWS Glue スクリプトのプログラミング時に使用できるオプションと同じです。

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