Comienza con la integración de Apigee y la conexión de MySQL

En este instructivo, se muestra cómo conectarse a una instancia de base de datos de MySQL desde una integración de muestra y realizar las operaciones list, get, create, update y delete en una tabla de base de datos de MySQL.

Antes de comenzar

Asegúrate de tener acceso a Application Integration.
Selecciona el proyecto de Google Cloud y realiza las siguientes tareas:
- Otorga los siguientes roles a la cuenta de servicio que deseas usar para crear la conexión:
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
- Habilita los siguientes servicios:
  - secretmanager.googleapis.com (API de Secret Manager)
  - connectors.googleapis.com (API de conectores)
  Si estos servicios no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando crees la conexión.
Asegúrate de tener acceso a un servidor MySQL que puedas usar para crear una base de datos. Para obtener una lista de todos los conectores y las versiones compatibles, consulta Referencia del conector.

Crea una base de datos y una tabla en MySQL

Ejecuta los siguientes comandos desde un sistema que tenga instalado un cliente MySQL:

Conéctate a tu servidor MySQL:
```
mysql --host=MYSQL_HOSTNAME_OR_IP_ADDRESS --port=PORT_NUMBER -uUSERNAME -pPASSWORD
```
Reemplaza lo siguiente:
- MYSQL_HOSTNAME_OR_IP_ADDRESS: el nombre o la dirección IP de tu servidor de MySQL.
- PORT_NUMBER: el número de puerto para tu servidor de MySQL.
- USERNAME: el nombre de usuario de tu servidor MySQL.
- PASSWORD: la contraseña del usuario para tu servidor MySQL.
Crea una base de datos de MySQL:
```
CREATE DATABASE tutorialDB;
```

Crear una tabla:

CREATE TABLE EMPLOYEE
  (
  employee_id int auto_increment primary key,
  employee_first_name varchar(500) NOT null,
  employee_last_name varchar(500) NOT null,
  employee_emailID varchar(500)
  );

Agrega filas a la tabla EMPLOYEE que creaste:

INSERT INTO EMPLOYEE (employee_first_name,employee_last_name,employee_emailID) values ("Peter","Dilliard","test-01@test.com");
INSERT INTO EMPLOYEE (employee_first_name,employee_last_name,employee_emailID) values ("Meaghan","Webb","test-02@test.com");

Verifica que se haya creado la tabla y que se hayan agregado filas:

SELECT * FROM EMPLOYEE;

Se muestran las siguientes filas de la tabla:

+-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
+-------------+---------------------+--------------------+------------------+

Crea una conexión de MySQL

Para permitir una integración y conectarte a la base de datos MySQL, crea una conexión nueva a la base de datos MySQL:

Haz clic en + Crear nuevo para abrir la página Crear conexión.
En la sección Ubicación, elige la ubicación para la conexión.
1. En la lista Región, selecciona la región en la que deseas crear la conexión.
  Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.
2. Haz clic en Siguiente.
En la sección Detalles de conexión, ingresa los siguientes detalles:
1. En la lista Conector, selecciona MySQL (Vista previa).
2. En la lista Versión del conector, selecciona la versión del conector.
3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.
  Los nombres de las conexiones deben cumplir con los siguientes criterios:
  - Usa letras, números o guiones.
  - Las letras deben estar en minúsculas.
  - Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
  - Los nombres no pueden superar los 63 caracteres.
4. Opcional: En el campo Descripción, agrega una descripción de la instancia de conexión.
5. Opcional: Habilita Cloud Logging.
6. En la lista Cuenta de servicio, selecciona una cuenta de servicio que tenga los roles necesarios.
7. En el campo Nombre de la base de datos, ingresa el nombre de la base de datos de MySQL.
8. De manera opcional, configura los parámetros de nodo de conexión:
  - Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
  - Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.
  Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.
9. Usar proxy: selecciona esta casilla de verificación a fin de configurar un servidor proxy para la conexión y configurar los siguientes valores:
10. Opcional: Para agregar una etiqueta a la conexión, haz clic en +Agregar etiqueta.
11. Haz clic en Siguiente.
12. En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas conectarte.
  - En la lista Tipo de destino, selecciona una dirección de host.
    1. En el campo Dirección de host, especifica el nombre de host o la dirección IP del destino.
      1. Si deseas establecer una conexión privada a tus sistemas de backend, sigue estos pasos:
        
        Crea un adjunto de servicio de PSC.
        
        Crea un adjunto de extremo y, luego, ingresa los detalles del adjunto del extremo en el campo Dirección del host.
      2. Si deseas establecer una conexión pública a tus sistemas de backend con seguridad adicional, puedes considerar configurar direcciones IP salientes estáticas para tus conexiones y, luego, configurar tus reglas de firewall para incluir solo las direcciones IP estáticas específicas.
    Para ingresar destinos adicionales, haz clic en +Agregar destino.
  - Haz clic en Siguiente.
13. En la sección Autenticación, puedes proporcionar credenciales:
  - En el campo Nombre de usuario, ingresa el nombre de usuario de MySQL para la conexión.
  - En el campo Contraseña, ingresa el Secret de Secret Manager que contiene la contraseña asociada con el nombre de usuario de MySQL.
    - Si ya creaste un Secret y no está disponible en la lista, selecciona Ingresar Secret manualmente. En el cuadro de diálogo Agregar un Secret por ID de recurso, copia y pega el ID de recurso de Secret Manager.
      - Para usar la versión más reciente, copia y pega el ID de recurso del Secret superior, en el siguiente formato: "projects/project-number/secrets/secret-name"
      - A fin de seleccionar una versión específica, copia y pega el ID del recurso para esa versión específica, en el formato "projects/project-number/secrets/secret-name/versions/1".
      Para agregar el Secret, haz clic en Agregar Secret.
    - Si no creaste un Secret para usar con MySQL, haz clic en Crear Secret nuevo. En el diálogo Crear Secret, ingresa los siguientes detalles:
      - En el campo Nombre, ingresa el nombre del Secret.
      - En el campo Valor del Secret, ingresa el contenido del Secret o sube un archivo que contenga el Secret.
      - Haz clic en Crear Secret.
  - En la lista Versión del Secret, selecciona la versión del Secret de Contraseña de la lista de versiones disponibles en el menú desplegable.
  - Haz clic en Siguiente.
En la sección Revisar, revisa los detalles de conexión y autenticación.
Haz clic en Crear.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

Nombre de usuario y contraseña
- Nombre de usuario: El nombre de usuario de MySQL que se usará para la conexión.
- Contraseña: El Secret de Secret Manager que contiene la contraseña asociada con el nombre de usuario de MySQL.

Configura una integración para usar la conexión de MySQL

Para usar la conexión de MySQL que creaste en una integración, debes realizar las siguientes tareas:

Cómo crear una integración nueva.
Agrega y configura un activador de API.
Agrega y configura una tarea Conectores.
Conecta el elemento del activador de APIs al elemento de la tarea Conectores

Cómo crear una integración nueva

En la IU de Apigee, selecciona tu organización de Apigee.
Haz clic en Desarrollar > Integraciones.
Haz clic en Crear integración.
En el campo Nombre de la integración, ingresa un nombre para tu integración.

Opcional: en el campo Descripción, ingresa una descripción.
En la lista Región, selecciona una región para la integración. En la lista Regiones, solo se enumeran las regiones aprovisionadas en tu proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Para obtener información sobre cómo aprovisionar regiones nuevas, consulta Habilita regiones nuevas.
Para abrir el editor de integración, haz clic en Crear.

Agrega y configura un activador de API

Después de crear una integración nueva, puedes agregar y configurar un activador de APIs para tu integración. Para hacerlo, sigue estos pasos:

En la barra de herramientas del editor de integración, haz clic en Activadores para ver una lista de los activadores disponibles.
Arrastra el elemento API al editor de integración.

Agrega y configura una tarea Conectores

Para configurar una tarea de Conectores a fin de enumerar todas las entidades en la tabla employee, sigue estos pasos:

En la barra de herramientas del editor de integración, haz clic en Tareas para ver la lista de tareas disponibles.
Arrastra el elemento Conectores al editor de integración.
Haz clic en el elemento de tarea Conectores en el diseñador para abrir el panel Conectores.
En el panel Conectores, haz clic en Configurar conector.
En el cuadro de diálogo Editor de tareas del conector que aparece, sigue estos pasos:
1. En la lista Región, selecciona la región de conexión en la que creaste la conexión de MySQL.
2. En la lista Conexión, selecciona la Conexión de MySQL que creaste y, luego, en Siguiente.
3. En la sección Tipo, selecciona Entidades y, luego, haz clic en Siguiente.
4. En la lista Entidad, selecciona empleado.
5. En la lista Operación, selecciona Lista y, luego, haz clic en Siguiente.
6. Para completar la configuración de la conexión y cerrar el cuadro de diálogo, haz clic en Listo.

Conecta el elemento del activador de API al elemento de la tarea Conectores

A continuación, agrega una conexión perimetral para conectar el activador de API a la tarea Conectores. Un perímetro es una conexión entre dos elementos en una integración. Para obtener información sobre los perímetros y las condiciones perimetrales, consulta Perímetros.

Para agregar la conexión perimetral, sigue estos pasos:

En la parte inferior del elemento Activador de la API, haz clic en el punto de control Bifurcar.
Arrastra y suelta la conexión perimetral en el punto de control Unión en la parte superior del elemento Conectores.

Prueba la integración

Sigue estos pasos para probar la app:

En la barra de herramientas del editor de integración, haz clic en Test.
Opcional: Cambia el valor Plazo de ejecución (en minutos) y, luego, haz clic en Probar integración.
Una vez que la integración se complete correctamente, el cuadro de diálogo Probar integración mostrará el mensaje Ejecución de integración correcta. Para ver los registros, haz clic en Ver registros.

Expande la sección Parámetros de respuesta. En la carga útil de salida del conector, se muestra el siguiente resultado:

[ {
    "employee_id": 1.0,
    "employee_first_name": "Peter",
    "employee_last_name": "Dilliard",
    "employee_emailID": "test-01@test.com"
  },
  {
    "employee_id": 2.0,
    "employee_first_name": "Meaghan",
    "employee_last_name": "Webb",
    "employee_emailID": "test-02@test.com"
  } ]

Ejecuta otras operaciones en tu tabla de base de datos de MySQL

Cuando configuras una tarea Conectores en tu integración, puedes seleccionar cualquiera de las siguientes operaciones:

Lista
Get
Crear
Actualizar
Borrar

Ya usaste la operación de lista para ver todas las filas de la tabla employee. En las siguientes secciones de este instructivo, usarás las operaciones Get, Create, Update y Delete para agregar, modificar o quitar filas de la tabla employee.

Obtén una fila de una tabla

Si conoces el ID de la entidad (o clave primaria) de la fila que deseas recuperar, proporciona ese valor como entrada para una operación Get en tu integración. Los detalles que muestra la operación Get son similares a los que muestra la operación de lista. Sin embargo, mientras que la operación de lista recupera detalles de todas las filas de la tabla que coinciden con la consulta especificada, la operación de obtención recupera solo los detalles de la fila de la tabla que coincide con el ID de entidad especificado.

Recuerda que, aunque la operación de lista muestra de forma predeterminada todas las filas de la tabla, la operación Get requiere un ID de entidad como parámetro de búsqueda. Por lo tanto, para usar la operación Get, debes conocer el ID de entidad de la fila que deseas recuperar o proporcionar un valor predeterminado para el ID de entidad.

Si deseas obtener detalles de una fila específica, realiza los siguientes pasos para configurar la tarea Conectores que creaste antes:

En el editor de integración, haz clic en el elemento de tarea de conectores para ver el panel de configuración de Conectores.
En el panel de configuración de Conectores, haz clic en Configurar conector. En el cuadro de diálogo Editor de tareas del conector que aparece, sigue estos pasos:
1. En la sección Configurar entidades/action, en la lista Operaciones, selecciona Obtener.
2. Haz clic en Listo.
En el panel de configuración Conectores, expande la sección Entrada de tarea. A continuación, sigue estos pasos:
1. Haz clic en el ID de la entidad.
2. En el cuadro de diálogo Editar variable que aparece, selecciona Entrada a la integración.
3. Haz clic en Guardar.
En la barra de herramientas del editor de integración, haz clic en Test.
Opcional: Cambia el valor de Plazo de ejecución (en minutos).
Ingresa el ID de la entidad de la que deseas recuperar los detalles. Por ejemplo, 2.
Haz clic en Probar integración.
Una vez que la integración se complete correctamente, el cuadro de diálogo Probar integración mostrará el mensaje Ejecución de integración correcta. Para ver los registros, haz clic en Ver registros.

Expande la sección Parámetros de respuesta. En la carga útil de salida del conector, se muestra el siguiente resultado:

[ {
    "employee_id": 2.0,
    "employee_first_name": "Meaghan",
    "employee_last_name": "Webb",
    "employee_emailID": "test-02@test.com"
  } ]

Puedes verificar que la información que se muestra aquí coincida con la información de la fila correspondiente en tu tabla de MySQL. Para ver esta información en su tabla de MySQL, ejecuta el siguiente comando desde su cliente MySQL:

SELECT * FROM employee WHERE employee_id=2;

Se muestra la siguiente fila de la tabla:

+-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           2 | Meaghan             | Webb               | test-02@test.com |
+-------------+---------------------+--------------------+------------------+

Agrega una fila a una tabla

La operación Crear te permite agregar una fila en una tabla. Cuando usas la operación de creación, debes proporcionar todos los valores para la entidad en la carga útil de entrada del conector.

Para agregar una fila con la operación de creación, realiza los siguientes pasos a fin de configurar la tarea Conectores que creaste antes:

En el editor de integración, haz clic en el elemento de tarea de conectores para ver el panel de configuración de Conectores.
En el panel de configuración de Conectores, haz clic en Configurar conector. En el cuadro de diálogo Editor de tareas del conector que aparece, sigue estos pasos:
1. En la sección Configurar entidades/action, en la lista Operaciones, selecciona Crear.
2. Haz clic en Listo.
En el panel de configuración Conectores, expande la sección Entrada de tarea. A continuación, sigue estos pasos:
1. Haz clic en el ID de la entidad.
2. En el cuadro de diálogo Editar variable que aparece, selecciona Entrada a la integración
3. Haz clic en Guardar.
En la barra de herramientas del editor de integración, haz clic en Test.
Opcional: Cambia el valor de Plazo de ejecución (en minutos).
Ingresa los detalles de la entidad que deseas crear. Por ejemplo, para agregar un empleado nuevo en la tabla employee, ingresa el siguiente código JSON:
```
{
  "employee_first_name": "Mary",
  "employee_last_name": "Smith",
  "employee_emailID": "test-03@test.com"
}
```
Nota: No especifiques la clave primaria, employee_id, ya que es un valor de solo lectura que se genera cuando se agrega la fila a la tabla.
Haz clic en Probar integración.
Una vez que la integración se complete correctamente, el cuadro de diálogo Probar integración mostrará el mensaje Ejecución de integración correcta. Para ver los registros, haz clic en Ver registros.
Expande la sección Parámetros de respuesta. En la carga útil de salida del conector, se muestra el siguiente resultado:
```
{
  "employee_first_name": "Mary",
  "employee_last_name": "Smith",
  "employee_emailID": "test-03@test.com"
}
```
En Carga útil de salida del conector, el ID de entidad se muestra como resultado:
```
{
  "employee_id": 3.0
}
```

Puedes verificar que la fila se agregue en la tabla de MySQL. Para ver esta información en su tabla de MySQL, ejecuta el siguiente comando desde su cliente MySQL:

SELECT * FROM employee;

Se muestran las siguientes filas de la tabla:

+-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
|           3 | Mary                | Smith              | test-03@test.com |
+-------------+---------------------+--------------------+------------------+

Actualiza una fila en una tabla

Usa la operación Update para realizar cambios en los valores de una fila de la tabla. Por ejemplo, puedes usar esta operación para actualizar el ID de correo electrónico de un empleado en la tabla employee. Para especificar la entidad que deseas actualizar, puedes proporcionar el ID de entidad como lo hiciste con la operación Get. Como alternativa, puedes usar el parámetro Cláusula de filtro para pasar los valores en los que se filtrarán las filas de la tabla. Esto resulta útil si deseas realizar el mismo cambio en varias filas según criterios de búsqueda específicos.

Si deseas actualizar una fila de la tabla, sigue estos pasos para configurar la tarea Conectores que creaste antes:

En el editor de integración, haz clic en el elemento de tarea de conectores para ver el panel de configuración de Conectores.
En el panel de configuración de Conectores, haz clic en Configurar conector. En el cuadro de diálogo Editor de tareas del conector que aparece, sigue estos pasos:
1. En la sección Configurar entidades/acción, en la lista Operaciones, selecciona Actualizar.
2. Haz clic en Listo.
En el panel de configuración Conectores, expande la sección Entrada de tarea. A continuación, haz lo siguiente
1. Haz clic en Cláusula de filtro.
2. En el cuadro de diálogo Editar variable que aparece, selecciona Entrada a la integración
3. Haz clic en Guardar.
En la barra de herramientas del editor de integración, haz clic en Test.
Opcional: Cambia el valor de Plazo de ejecución (en minutos).
Ingresa los criterios que deseas filtrar. Por ejemplo, para buscar un empleado con el ID de correo electrónico test-03@test.com, ingresa lo siguiente:
```
employee_emailID="test-03@test.com"
```
Nota: Si tienes varias filas de la tabla que coinciden con los criterios del filtro, la actualización que especifiques en el siguiente paso se realizará en todas las filas coincidentes.
Ingresa los valores que deseas actualizar. Por ejemplo, para actualizar el ID de correo electrónico de todos los empleados de la tabla employee cuyo ID de correo electrónico actual coincide con la cláusula de filtro test-03@test.com, ingresa el siguiente JSON:
```
{
  "employee_emailID": "msmith@test.com"
}
```
Nota: No es necesario que especifiques valores para todas las columnas de la tabla. Ingresa los valores que deseas actualizar. Los demás valores no se modifican.
Haz clic en Probar integración.
Una vez que la integración se complete correctamente, el cuadro de diálogo Probar integración mostrará el mensaje Ejecución de integración correcta.
Para validar que se actualizó la entidad, usa la operación Get a los detalles de la entidad especificada.

Puedes verificar que la fila esté actualizada en tu tabla de MySQL. Para ver esta información en su tabla de MySQL, ejecuta el siguiente comando desde su cliente MySQL:

SELECT * FROM employee;

Se muestran las siguientes filas de la tabla:

+-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
|           3 | Mary                | Smith              | msmith@test.com  |
+-------------+---------------------+--------------------+------------------+

Borra una fila en una tabla

Puedes usar la operación Delete para borrar una o más filas de la tabla. Proporciona el ID de la entidad o usa la cláusula de filtro para especificar las filas que deseas borrar. Recuerda que, si usas la cláusula de filtro a fin de especificar criterios para las filas que deseas borrar, es posible borrar varias filas que coincidan con el filtro determinado. Si solo deseas borrar una fila específica, usa el ID de entidad.

Para borrar una fila de la tabla con el ID de entidad, realiza los siguientes pasos para configurar la tarea Conectores que creaste antes:

En el editor de integración, haz clic en el elemento de tarea de conectores para ver el panel de configuración de Conectores.
En el panel de configuración de Conectores, haz clic en Configurar conector. En el cuadro de diálogo Editor de tareas del conector que aparece, sigue estos pasos:
1. En la sección Configurar entidades/action, en la lista Operaciones, selecciona Obtener.
2. Haz clic en Listo.
En el panel de configuración Conectores, expande la sección Entrada de tarea. A continuación, sigue estos pasos:
1. Haz clic en el ID de la entidad.
2. En el cuadro de diálogo Editar variable que aparece, selecciona Entrada a la integración
3. Haz clic en Guardar.
En la barra de herramientas del editor de integración, haz clic en Test.
Opcional: Cambia el valor de Plazo de ejecución (en minutos).
Ingresa el ID de la entidad de la que deseas recuperar los detalles. Por ejemplo, 2.
Haz clic en Probar integración.
Una vez que la integración se complete correctamente, el cuadro de diálogo Probar integración mostrará el mensaje Ejecución de integración correcta.
Para validar que se borró la fila de la tabla, usa la operación Get a los detalles de la fila que borraste. Se debería mostrar un error para el ID de la entidad especificado.

También puedes usar la operación de lista y, de manera opcional, proporcionar una cláusula de filtro para la fila (o filas) de la tabla que borraste. Esto muestra la lista de filas restantes, que puede ser una lista vacía.

Por ejemplo, si borraste la fila de la tabla con el ID de entidad 3, si especificas la cláusula de filtro employee_emailID="msmith@test.com" o el ID de entidad 3 para la operación de lista, los parámetros de respuesta en los registros muestran [].

Puedes verificar que la fila se borre en tu tabla de MySQL. Para verificar esto en tu tabla de MySQL, ejecuta el siguiente comando desde su cliente MySQL:

SELECT * FROM employee;

Se muestran las siguientes filas de la tabla:

+-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
+-------------+---------------------+--------------------+------------------+

¿Qué sigue?

Intenta crear integraciones con otros conectores. Para obtener la lista de todos los conectores compatibles, consulta la referencia del conector.