# Conexión a Teradata Vantage en AWS Glue Studio
<a name="connecting-to-data-teradata"></a>

 AWS Glue proporciona soporte integrado para Teradata Vantage. AWS Glue Studio proporciona una interfaz visual para conectarse a Teradata, crear trabajos de integración de datos y ejecutarlos en el tiempo de ejecución de Spark sin servidor de AWS Glue Studio. 

 AWS Glue Studio crea una conexión unificada para Teradata Vantage. Para obtener más información, consulte [Consideraciones](using-connectors-unified-connections.md#using-connectors-unified-connections-considerations). 

**Topics**
+ [Crear una conexión Teradata Vantage](creating-teradata-connection.md)
+ [Crear un nodo de origen de Teradata](creating-teradata-source-node.md)
+ [Crear un nodo de destino de Teradata](creating-teradata-target-node.md)
+ [Opciones avanzadas](#creating-teradata-connection-advanced-options)

# Crear una conexión Teradata Vantage
<a name="creating-teradata-connection"></a>

Para conectarse a Teradata Vantage desde AWS Glue, tendrá que crear y almacenar sus credenciales de Teradata en un AWS Secrets Manager secreto y, a continuación, asociar ese secreto a una conexión de Teradata de AWS Glue.

**Requisitos previos**:
+ Si accede a su entorno de Teradata a través de Amazon VPC, configure Amazon VPC para permitir que su trabajo de AWS Glue se comunique con el entorno de Teradata. No recomendamos acceder al entorno de Teradata a través de la Internet pública.

  En Amazon VPC, identifique o cree una **VPC**, una **subred** y un **grupo de seguridad** que AWS Glue utilizará al ejecutar el trabajo. Además, debe asegurarse de que Amazon VPC esté configurada para permitir el tráfico de red entre su instancia de Teradata y esta ubicación. Su trabajo deberá establecer una conexión TCP con su puerto de cliente de Teradata. Para obtener más información sobre los puertos de Teradata, consulte la [documentación de 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).

  Según el diseño de la red, la conectividad segura de la VPC puede requerir cambios en Amazon VPC y otros servicios de red. Para obtener más información sobre la conectividad de AWS, consulte las [Opciones de conectividad de AWS](https://docs.teradata.com/r/Teradata-VantageCloud-Enterprise/Get-Started/Connecting-Your-Environment/AWS-Connectivity-Options) en la documentación de Teradata.

**Para configurar una conexión de AWS Glue Teradata:**

1. En la configuración de Teradata, identifique o cree un usuario y la contraseña con la que AWS Glue se conectará, *teradataUser* y *teradataPassword*. Para obtener más información, consulte la [Información general de seguridad de Vantage](https://docs.teradata.com/r/Configuring-Teradata-VantageTM-After-Installation/January-2021/Security-Overview/Vantage-Security-Overview) en la documentación de Teradata.

1. En AWS Secrets Manager, cree un secreto con sus credenciales de Teradata. Para crear un secreto en Secrets Manager, siga el tutorial disponible en [Crear un secreto AWS Secrets Manager](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html) en la documentación AWS Secrets Manager. Después de crear el secreto, conserve el nombre secreto, *secretName*, para el siguiente paso. 
   + Al seleccionar **pares clave/valor**, genere un par para la clave `user` con el valor *teradataUsername*.
   + Al seleccionar **pares clave/valor**, genere un par para la clave `password` con el valor *teradataPassword*.

1. En la consola de AWS Glue, genere una conexión mediante los pasos que se indican en [Adición de una conexión de AWS Glue](console-connections.md). Tras crear la conexión, conserve el nombre de la conexión, *connectionName*, para el siguiente paso. 
   + Al seleccionar un **tipo de conexión**, seleccione Teradata.
   + Al proporcionar la **URL de JDBC**, proporcione la URL de su instancia. También puede codificar determinados parámetros de conexión separados por comas en la URL de JDBC. La URL debe tener el siguiente formato: `jdbc:teradata://teradataHostname/ParameterName=ParameterValue,ParameterName=ParameterValue`

     Los parámetros de URL admitidos incluyen:
     + `DATABASE`— nombre de la base de datos del host a la que se accede de forma predeterminada.
     + `DBS_PORT`— el puerto de la base de datos, que se utiliza cuando se ejecuta en un puerto no estándar.
   + Al seleccionar un **Tipo de credencial**, seleccione **AWS Secrets Manager** y, a continuación, establezca **AWS Secret** en *secretName*.

1. En las siguientes situaciones, es posible que necesite una configuración adicional:
   + 

     Para las instancias de Teradata alojadas AWS en una VPC de Amazon
     + Deberá proporcionar la información de conexión de Amazon VPC a la conexión de AWS Glue que define sus credenciales de seguridad de Teradata. Al crear o actualizar la conexión, configure los **VPC**, **Subred** y los **grupos de seguridad** en **Opciones de red**.

# Crear un nodo de origen de Teradata
<a name="creating-teradata-source-node"></a>

## Requisitos previos necesarios
<a name="creating-teradata-source-node-prerequisites"></a>
+ Una conexión AWS Glue Teradata Vantage, configurada con un AWS Secrets Manager secreto, como se describe en la sección anterior, [Crear una conexión Teradata Vantage](creating-teradata-connection.md).
+ Permisos adecuados en el trabajo para leer el secreto utilizado por la conexión.
+ Una tabla de Teradata de la que desee leer, *tableName* o consultar *targetQuery*.

## Agregar un origen de datos de Teradata
<a name="creating-teradata-source-node-add"></a>

**Para agregar un nodo de **Origen de datos: Teradata**:**

1.  Elija la conexión para el origen de datos de Teradata. Dado que lo ha creado, debería estar disponible en el menú desplegable. Si es necesario crear una conexión, elija **Crear una nueva conexión**. Para obtener más información, consulte la sección [Crear una conexión Teradata Vantage](creating-teradata-connection.md) anterior. 

    Una vez que haya elegido una conexión, puede ver las propiedades de la conexión mediante un clic en **Ver propiedades**. 

1.  Elija una opción de **origen de Teradata**: 
   +  **Elija una sola tabla**: acceda a todos los datos de una sola tabla. 
   +  **Ingresar una consulta personalizada**: permite acceder a un conjunto de datos de varias tablas en función del consulta personalizada. 

1.  Si eligió una sola tabla, ingrese *tableName*. 

    Si eligió **Introducir una consulta personalizada**, introduzca una consulta SQL SELECT. 

1.  En las **propiedades personalizadas de Teradata**, ingrese los parámetros y valores según sea necesario. 

# Crear un nodo de destino de Teradata
<a name="creating-teradata-target-node"></a>

## Requisitos previos necesarios
<a name="creating-teradata-target-node-prerequisites"></a>
+ Una conexión AWS Glue Teradata Vantage, configurada con un AWS Secrets Manager secreto, como se describe en la sección anterior, [Crear una conexión Teradata Vantage](creating-teradata-connection.md).
+ Permisos adecuados en el trabajo para leer el secreto utilizado por la conexión.
+ Una tabla de Teradata a la que desearía escribir, *tableName*.

## Agregar un destino de datos de Teradata
<a name="creating-teradata-target-node-add"></a>

**Para añadir un **destino de datos: nodo de Teradata:****

1.  Elija la conexión para el origen de datos de Teradata. Dado que lo ha creado, debería estar disponible en el menú desplegable. Si es necesario crear una conexión, elija **Crear conexión de Teradata**. Para más información, consulte [Información general sobre el uso de conectores y conexiones](https://docs.aws.amazon.com/glue/latest/ug/connectors-chapter.html#using-connectors-overview). 

    Una vez que haya elegido una conexión, puede ver las propiedades de la conexión mediante un clic en **Ver propiedades**. 

1. Configure el **nombre de la tabla** proporcionando *tableName*.

1.  En las **propiedades personalizadas de Teradata**, ingrese los parámetros y valores según sea necesario. 

## Opciones avanzadas
<a name="creating-teradata-connection-advanced-options"></a>

Puede brindar opciones avanzadas al crear un nodo de Teradata. Estas opciones son las mismas que las disponibles cuando se programa AWS Glue para scripts de Spark.

Consulte [Conexiones Teradata Vantage](aws-glue-programming-etl-connect-teradata-home.md).