# Conexión a Azure SQL en AWS Glue Studio
<a name="connecting-to-data-azuresql"></a>

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

**Topics**
+ [Creación de una conexión de Azure SQL](creating-azuresql-connection.md)
+ [Creación de un nodo de origen de Azure SQL](creating-azuresql-source-node.md)
+ [Creación de un nodo de destino de Azure SQL](creating-azuresql-target-node.md)
+ [Opciones avanzadas](#creating-azuresql-connection-advanced-options)

# Creación de una conexión de Azure SQL
<a name="creating-azuresql-connection"></a>

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

**Para configurar una conexión a Azure SQL:**

1. En AWS Secrets Manager, cree un secreto con sus credenciales de Azure SQL. 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 *azuresqlUsername*.
   + Al seleccionar **pares clave/valor**, genere un par para la clave `password` con el valor *azuresqlPassword*.

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 uso futuro en AWS Glue. 
   + Al seleccionar un **tipo de conexión**, seleccione Azure SQL.
   + Al proporcionar una **URL de Azure SQL**, proporcione una URL de punto de conexión de JDBC.

      La lista de URL debe tener el siguiente formato: `jdbc:sqlserver://databaseServerName:databasePort;databaseName=azuresqlDBname;`.

     AWS Glue requiere las siguientes propiedades de URL: 
     + `databaseName`: una base de datos predeterminada en Azure SQL a la que conectarse.

     Para obtener más información sobre las direcciones URL de JDBC para instancias administradas de Azure SQL, consulte la [documentación de Microsoft](https://learn.microsoft.com/en-us/sql/connect/jdbc/building-the-connection-url?view=azuresqldb-mi-current).
   + Al seleccionar un **secreto AWS**, proporcione un *secretName*.

# Creación de un nodo de origen de Azure SQL
<a name="creating-azuresql-source-node"></a>

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

  Una tabla de Azure SQL se identifica por su base de datos, esquema y nombre de tabla. Debe proporcionar el nombre de la base de datos y el nombre de la tabla al conectarse a Azure SQL. También debe proporcionar el esquema si no es el predeterminado, "público". La base de datos se proporciona a través de una propiedad URL en *connectionName*, y el nombre de la tabla y el esquema a través de `dbtable`.

## Agregar un origen de datos de Azure SQL
<a name="creating-azuresql-source-node-add"></a>

**Para agregar un nodo de **Origen de datos - Azure SQL**:**

1.  Elija la conexión para el origen de datos de Azure SQL. 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 Azure SQL**. Para obtener más información, consulte la sección [Creación de una conexión de Azure SQL](creating-azuresql-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 Azure SQL**: 
   +  **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 SELECT de TransactSQL. 

1.  En **Propiedades personalizadas de Azure SQL**, ingrese los parámetros y valores según sea necesario. 

# Creación de un nodo de destino de Azure SQL
<a name="creating-azuresql-target-node"></a>

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

  Una tabla de Azure SQL se identifica por su base de datos, esquema y nombre de tabla. Debe proporcionar el nombre de la base de datos y el nombre de la tabla al conectarse a Azure SQL. También debe proporcionar el esquema si no es el predeterminado, "público". La base de datos se proporciona a través de una propiedad URL en *connectionName*, y el nombre de la tabla y el esquema a través de `dbtable`.

## Agregar un destino de datos de Azure SQL
<a name="creating-azuresql-target-node-add"></a>

**Para agregar un nodo de **Destino de datos - Azure SQL**:**

1.  Elija la conexión para el origen de datos de Azure SQL. 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 Azure SQL**. Para obtener más información, consulte la sección [Creación de una conexión de Azure SQL](creating-azuresql-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. Configure el **nombre de la tabla** proporcionando *tableName*.

1.  En **Propiedades personalizadas de Azure SQL**, ingrese los parámetros y valores según sea necesario. 

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

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

Consulte [Conexiones SQL Azure](aws-glue-programming-etl-connect-azuresql-home.md).