Realiza operaciones CRUD en una base de datos MySQL

En este instructivo, se muestra cómo conectarte a una instancia de base de datos de MySQL desde una integración de muestra y cómo realizar operaciones de List, Get, Create, Update y Delete en una tabla de base de datos de MySQL.

Para completar este instructivo, realiza las siguientes tareas:

Configura una base de datos y una tabla en tu servidor MySQL
Crea una conexión de MySQL
Configura una integración para usar la conexión de MySQL
Prueba la integración
Realiza otras operaciones en la tabla de la base de datos de MySQL

Antes de comenzar

Asegúrate de tener acceso a las integraciones.
Haz lo siguiente en tu proyecto de Google Cloud:
- 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 en la página Crear conexión.
Asegúrate de tener acceso a un servidor MySQL que puedas usar para crear una base de datos.

Configura una base de datos y una tabla en tu servidor MySQL

Conéctate a tu servidor MySQL y crea una base de datos y una tabla para usar en este instructivo.

Para conectarte a tu servidor MySQL, ejecuta el siguiente comando desde un sistema que tenga instalado un cliente MySQL:
```
mysql --host=MySQL server host name or IP address --port=MySQL server port number -uusername -ppassword
```
En este ejemplo, reemplaza lo siguiente:
- MySQL server host name or IP address por el nombre o la dirección IP de tu servidor MySQL
- MySQL server port number por el número de puerto para tu servidor MySQL
- username por el nombre de usuario de tu servidor MySQL
- password por la contraseña de tu servidor MySQL
Si deseas crear una base de datos de MySQL para usarla en este instructivo, ejecuta el siguiente comando desde tu cliente MySQL:
```
CREATE DATABASE tutorialDB;
```

Si deseas crear una tabla para usarla en este instructivo, ejecuta el siguiente comando desde tu cliente MySQL:

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)
  );

Para agregar filas a la tabla employee que creaste, ejecuta el siguiente comando desde tu cliente MySQL:

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");

Ejecuta el siguiente comando para verificar que se creó la tabla y que se agregaron 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, establece la Configuración del 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 utilizar la conexión de MySQL que creaste en una integración, agrega la tarea Conectores en una integración junto con un activador de API. El activador de API se conecta a la tarea Conectores mediante una conexión Edge.

Cómo crear una integración nueva

En la consola de Google Cloud, ve a la página Integration Connectors.
Ir a Integration Connectors
En el menú de navegación, haz clic en Integraciones.
Aparecerá la página Integrations List.
Selecciona una integración existente o crea una nueva haciendo clic en CREAR INTEGRACIÓN.
Se abrirá la integración en la página del editor de integraciones.
En el editor de integración, haz clic en +Agregar una tarea o activador > Tasks para ver la lista de tareas disponibles.
Haz clic en Create new (Crear nueva).
Ingresa un nombre y, de manera opcional, una descripción en el diálogo Crear integración.
Nota: Los nombres de la integración deben cumplir con los siguientes requisitos:
- Los nombres deben comenzar y terminar con letras o números.
- Los nombres no pueden contener espacios o más de un guion o guion bajo en una fila.
Haz clic en Crear para abrir el editor de integración.

Agrega y configura un activador de API

Para agregar y configurar un activador de API a la integración, haz lo siguiente:

En el editor de integración, selecciona Agregar una tarea/activador > Activadores para ver una lista de los activadores disponibles.
Arrastra el elemento Activador de API al editor de integración.

Agrega y configura una tarea Conectores

Sigue estos pasos para configurar una tarea de Conectores para enumerar todas las entidades de la tabla employee:

Selecciona Add a task/trigger > Tasks en el editor de integración 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 ver el panel de configuración de tareas.
Haz clic en Configurar tarea.
Aparecerá el cuadro de diálogo Configurar tarea de conector.
En el cuadro de diálogo Configurar tarea de conector, haz lo siguiente:
1. Selecciona la región de conexión en la que creaste tu conexión de MySQL.
2. Una vez que eliges una región, aparece la columna Conexión. Selecciona la conexión MySQL que creaste de la lista de conexiones disponibles.
3. Una vez que se elige una conexión, aparece la columna Tipo. Selecciona Entidades y, luego, OPERACIONES en la lista de entidades disponibles.
4. Una vez que se elige un tipo, aparece la columna Operación. Selecciona Lista.
5. Haz clic en Listo para completar la configuración de conexión y cerrar el cuadro de diálogo.

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 más información sobre los perímetros y las condiciones perimetrales, consulta Perímetros.

Para agregar la conexión perimetral, haz clic en el punto de control Bifurcar en la parte inferior del elemento activador de API. Arrastra y suelta la conexión perimetral en el punto de control Join que se encuentra en la parte superior del elemento de tarea Conectores.

Prueba la integración

Para probar la integración, haz lo siguiente:

Haz clic en el botón Probar en la barra de herramientas del editor de integración.
Cambia el valor de Plazo de ejecución (en minutos), si lo deseas, y 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.

En Parámetros de respuesta, en 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:

Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tareas.
Haz clic en Configurar tarea.
Aparecerá el cuadro de diálogo Configurar tarea de conector.
En el diálogo Configurar la tarea del conector, en la columna Operación, selecciona Obtener y, luego, haz clic en Listo.
En el panel de configuración de tareas, en Entrada de tarea, haz clic en ID de entidad.
En el diálogo Configure Variable, selecciona Use as an input to integration y haz clic en Guardar.
Haz clic en el botón Probar en la barra de herramientas del editor de integración.
Si lo deseas, cambia el valor de Plazo de ejecución (en minutos).
Ingresa el ID de la entidad de la que deseas recuperar los detalles. Ingresa 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.

En Parámetros de respuesta, en 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:

Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tareas.
Haz clic en Configurar tarea.
Aparecerá el cuadro de diálogo Configurar tarea de conector.
En el diálogo Configurar la tarea del conector, en la columna Operación, selecciona Crear y, luego, haz clic en Listo.
En el panel de configuración de la tarea, en Entrada de la tarea, haz clic en Carga útil de la entrada del conector.
En el diálogo Configure Variable, selecciona Use as an input to integration y haz clic en Guardar.
Haz clic en el botón Probar en la barra de herramientas del editor de integración.
Si lo deseas, 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.
En Parámetros de respuesta, en Carga útil de entrada del conector, se muestra la carga útil que proporcionaste:
```
{
  "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:

Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tareas.
Haz clic en Configurar tarea.
Aparecerá el cuadro de diálogo Configurar tarea de conector.
En el diálogo Configurar la tarea del conector, en la columna Operación, selecciona Actualizar y, luego, haz clic en Listo.
En el panel de configuración de la tarea, en Entrada de la tarea, haz clic en Carga útil de la entrada del conector.
En el diálogo Configure Variable, selecciona Use as an input to integration y haz clic en Guardar.
A continuación, en el panel de configuración de tareas, en Entrada de tarea, haz clic en Cláusula de filtro.
En el diálogo Configure Variable, selecciona Use as an input to integration y haz clic en Guardar.
Haz clic en el botón Probar en la barra de herramientas del editor de integración.
Si lo deseas, 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:

Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tareas.
Haz clic en Configurar tarea.
Aparecerá el cuadro de diálogo Configurar tarea de conector.
En el diálogo Configurar la tarea del conector, en la columna Operación, selecciona Borrar y, luego, haz clic en Listo.
En el panel de configuración de tareas, en Entrada de tarea, haz clic en ID de entidad.
En el diálogo Configure Variable, selecciona Use as an input to integration y haz clic en Guardar.
Haz clic en el botón Probar en la barra de herramientas del editor de integración.
Si lo deseas, cambia el valor de Plazo de ejecución (en minutos).
Ingresa el ID de entidad de la fila de la tabla que deseas borrar. Ingresa 3.
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 |
+-------------+---------------------+--------------------+------------------+

Realiza operaciones CRUD en una base de datos MySQL

Antes de comenzar

Configura una base de datos y una tabla en tu servidor MySQL

Crea una conexión de MySQL

Configura la autenticación

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

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 API al elemento de la tarea Conectores

Prueba la integración

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

Obtén una fila de una tabla

Agrega una fila a una tabla

Actualiza una fila en una tabla

Borra una fila en una tabla

¿Qué sigue?