

# Conexión al servicio OpenSearch en AWS Glue Studio
<a name="connecting-to-data-opensearch"></a>

 AWS Glue proporciona soporte integrado para Amazon OpenSearch Service. AWS Glue Studio proporciona una interfaz visual para conectarse a Amazon OpenSearch Service, crear trabajos de integración de datos y ejecutarlos en el tiempo de ejecución de Spark sin servidor de AWS Glue Studio. Esta característica no es compatible con OpenSearch Service sin servidor. 

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

**Topics**
+ [Crear una conexión con OpenSearch Service](creating-opensearch-connection.md)
+ [Crear un nodo fuente de OpenSearch Service](creating-opensearch-source-node.md)
+ [Crear un nodo de destino de OpenSearch Service](creating-opensearch-target-node.md)
+ [Opciones avanzadas](#creating-opensearch-connection-advanced-options)

# Crear una conexión con OpenSearch Service
<a name="creating-opensearch-connection"></a>

**Requisitos previos**:
+ Identifique el punto de conexión del dominio, el *AOSEndpoint* y el puerto, *AOSport* desde el que desea leer o cree el recurso siguiendo las instrucciones de la documentación de Amazon OpenSearch Service. Para obtener más información sobre la creación de un dominio, consulte [Crear y administrar dominios de Amazon OpenSearch Service](https://docs.aws.amazon.com//opensearch-service/latest/developerguide/createupdatedomains.html) en la documentación de Amazon OpenSearch Service.

  Un punto de conexión de dominio de Amazon OpenSearch Service tendrá el siguiente formulario predeterminado: https://search-*domainName*-*unstructuredIdContent*.*region*.es.amazonaws.com. Para obtener más información sobre cómo identificar su punto de conexión de dominio, consulte [Crear y administrar dominios de Amazon OpenSearch Service](https://docs.aws.amazon.com//opensearch-service/latest/developerguide/createupdatedomains.html) en la documentación de Amazon OpenSearch Service. 

  Identifique o genere credenciales de autenticación básica HTTP, *aosUser *y *aosPassword* para su dominio.

**Para configurar una conexión a OpenSearch Service:**

1. En AWS Secrets Manager, cree un secreto con sus credenciales de OpenSearch Service. 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 `USERNAME` con el valor *aosUser*.
   + Al seleccionar **pares clave/valor**, genere un par para la clave `PASSWORD` con el valor *aosPassword*.

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 OpenSearch Service.
   + Al seleccionar un punto de conexión de dominio, proporcione *aosEndpoint*.
   + Al seleccionar un puerto, proporcione *aosPort*.
   + Al seleccionar un **secreto AWS**, proporcione un *secretName*.

# Crear un nodo fuente de OpenSearch Service
<a name="creating-opensearch-source-node"></a>

## Requisitos previos necesarios
<a name="creating-opensearch-source-node-prerequisites"></a>
+ Una conexión AWS Glue de OpenSearch Service, configurada con un AWS Secrets Manager secreto, como se describe en la sección anterior, [Crear una conexión con OpenSearch Service](creating-opensearch-connection.md).
+ Permisos adecuados en el trabajo para leer el secreto utilizado por la conexión.
+ Un índice de OpenSearch Service del que quiera leer, *aosIndex*.

## Agregar un origen de datos de OpenSearch Service
<a name="creating-opensearch-source-node-add"></a>

**Para añadir un nodo de **origen de datos: OpenSearch Service**:**

1.  Elija la conexión para el origen de datos de OpenSearch Service. 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 OpenSearch Service**. Para obtener más información, consulte la sección [Crear una conexión con OpenSearch Service](creating-opensearch-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. Proporcione **Index**, el índice que desea leer.

1. Si lo desea, proporcione **Query**, una consulta de OpenSearch para obtener resultados más específicos. Para obtener más información sobre cómo escribir consultas de OpenSearch, consulte [Lectura de los índices de OpenSearch Service](aws-glue-programming-etl-connect-opensearch-home.md#aws-glue-programming-etl-connect-opensearch-read).

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

# Crear un nodo de destino de OpenSearch Service
<a name="creating-opensearch-target-node"></a>

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

## Agregar un destino de datos de OpenSearch Service
<a name="creating-opensearch-target-node-add"></a>

**Para añadir un nodo de **Destino de datos: OpenSearch Service**:**

1.  Elija la conexión para el origen de datos de OpenSearch Service. 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 OpenSearch Service**. Para obtener más información, consulte la sección [Crear una conexión con OpenSearch Service](creating-opensearch-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. Proporcione **Index**, el índice que desea leer.

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

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

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

Consulte [Conexiones de OpenSearch Service](aws-glue-programming-etl-connect-opensearch-home.md). 