Consulta los conectores compatibles para la integración de aplicaciones.

Tarea de conectores

La tarea Conectores te permite conectarte de manera rápida y segura a los diversos servicios de Google Cloud y otras aplicaciones empresariales desde tu integración mediante los conectores listos para usar disponibles en Integration Connectors.

Para obtener una lista de todos los conectores compatibles con la integración de aplicaciones, consulta Referencia del conector.

Importante: Los conectores de integración son un componente facturable de Google Cloud. Para obtener información sobre los costos y cargos de usar Integration Connectors, consulta Precios de Integration Connectors.

Antes de comenzar

• Asegúrate de tener la función de administrador de Connectors (roles/connectors.admin) de IAM otorgada en tu proyecto de Google Cloud. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.
• Obtén información sobre los conceptos generales de los conectores de integración.
• Para conectarte a los servicios de Google Cloud y otras aplicaciones empresariales mediante un conector, asegúrate de haber conectado una cuenta de servicio administrada por el usuario a tu integración. Si tu integración no tiene una cuenta de servicio administrada por el usuario configurada, se usa la cuenta de servicio predeterminada ([e-mail]) de forma predeterminada para la autenticación.
• Asegúrate de que tu cuenta de servicio tenga el rol de IAM necesario. Para obtener información sobre cómo otorgar roles a una cuenta de servicio, consulta Administra el acceso a las cuentas de servicio.

Agrega una tarea de Connectors

Para agregar la tarea de conectores a tu integración, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones con una lista de todas las integraciones disponibles en el proyecto de Google Cloud.

3. Selecciona una integración existente o haz clic en Crear integración para crear una nueva.

   Si creas una integración nueva, haz lo siguiente:

   1. Ingresa un nombre y una descripción en el panel Crear integración.
   2. Selecciona una región para la integración.
      Nota: En el menú desplegable Regiones, solo se enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
   3. Selecciona una cuenta de servicio para la integración. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Integration summary de la barra de herramientas de integración.
      Nota: La opción para seleccionar una cuenta de servicio solo se muestra si habilitaste la gobernanza de integración para la región seleccionada.
   4. Haz clic en Crear.

   Esto abrirá la integración en la página del editor de integración.

4. En la barra de navegación del editor de integración, haz clic en Tasks para ver la lista de tareas y conectores disponibles.



5. Si quieres configurar una nueva conexión, haz clic en el elemento Conectores y colócalo en el editor de integración. Luego, haz clic en Configurar conector para configurar la conexión.

   

6. Si tienes una conexión existente, haz clic en la pestaña Conectores para ver las conexiones creadas recientemente. También puedes buscar un conector, una conexión o una tarea ingresando el nombre en el campo Buscar.

   

7. Haz clic y coloca el elemento Conectores configurado en el editor de integración. Para obtener más información sobre cómo configurar una tarea de conector, consulta Configura la tarea de conectores.

Configura la tarea de conectores

Para configurar una tarea de Connectors, haz lo siguiente:

Nota: Los detalles de configuración, como la autenticación, varían según el tipo de conexión

.

1. Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.

   De forma opcional, haz clic en para cambiar el nombre de la tarea.

2. Haz clic en Configurar conector.
3. Puedes seleccionar una conexión existente en la región o crear una nueva. Para configurar una conexión existente, completa los siguientes pasos en la página Editor de tareas de Connectors.

   En la siguiente imagen, se muestra un diseño de muestra de la página Editor de tareas de conectores.

1. En la sección Seleccionar conexión, selecciona la región de la conexión.
2. Elige una conexión existente de la lista de conexiones disponibles en la región seleccionada.
3. Haz clic en Siguiente.
4. En la lista Tipo, selecciona Entidades o Acciones.
   • Si seleccionas Entidades, se mostrará la lista de entidades compatibles para la conexión en la sección Configurar entidades/acciones. Selecciona una entidad seguida de la Operation que deseas realizar en esa entidad.
   • Si seleccionas Acciones, la lista de acciones compatibles para la conexión se muestra en la columna Set entities/actions. Selecciona una acción para la conexión.
   Las entidades y las acciones admitidas se basan en el tipo de conector. Para obtener una lista de todos los conectores compatibles con la integración de aplicaciones, consulta Referencia del conector. Para ver las acciones y entidades que se admiten para un conector, consulta la documentación específica del conector.

   Si el conector admite la consulta de SQL personalizada, puedes seleccionar la opción Ejecutar consulta personalizada de la lista Acciones. Si deseas obtener información sobre cómo agregar una consulta en SQL personalizada para tu conector, lee Acción: Ejecuta una consulta en SQL personalizada.

   Nota: No todos los tipos de conexión admiten Entidades o Acciones. Si un tipo de conexión no admite ninguna acción o entidad, las listas Entidades y Acciones correspondientes estarán vacías. Para obtener más información sobre entidades y acciones, consulta Entidades, operaciones y acciones.
5. Haz clic en Listo para completar la configuración de conexión y cerrar el panel.

Configura las variables de entrada y salida de tareas

En el panel de configuración de tareas de Conectores, se muestran las variables de Entrada de tarea y Salida de tarea que se generan automáticamente según la Entidad y Operación o Acción seleccionada en el cuadro de diálogo Configurar tarea de conector. Estas variables son configurables y se puede acceder a ellas como entradas a la tarea actual o salidas a las tareas o condicionales posteriores en la integración actual.

Para configurar las variables Entrada de tarea o Salida de tarea, haz clic en la variable correspondiente para abrir el panel Configurar variable y realiza los siguientes pasos:

1. Ingresa el valor de la variable en el campo Valor predeterminado.
2. (Opcional) Selecciona Usar como entrada para la integración o Usar como salida para la integración.
3. Haz clic en Guardar.

Para obtener más información sobre los parámetros de entrada y salida de la tarea Conectores, consulta Operaciones de entidades.

Operaciones y acciones de entidades

Puedes realizar operaciones CRUD (crear, leer, actualizar y borrar) en las entidades de un conector. Cada una de estas operaciones de entidad tiene un conjunto diferente de parámetros de entrada y salida. En la siguiente tabla, se enumeran los parámetros de entrada y salida de las diversas operaciones de entidad.

Nombre de la operación	Parámetros de entrada	Los parámetros de resultado
Lista	listEntitiesPageSize listEntitiesPageToken listEntitiesSortByColumns filterClause	connectorOutputPayload listEntitiesNextPageToken
Obtener	entityId	connectorOutputPayload
	Nota: Puedes usar la operación Get solo para recuperar un registro único de una tabla que tenga una clave primaria. Como alternativa, puedes usar la operación List con un filterClause.
Crear	connectorInputPayload	connectorOutputPayload
Actualizar	connectorInputPayload entityId filterClause	connectorOutputPayload
Borrar	entityId filterClause	N/A

Parámetros de entrada

En la siguiente tabla, se describen los parámetros de entrada para las distintas operaciones de entidades.

Nombre del parámetro	Tipo de dato	Descripción
entityId	String	Un identificador único de la fila a la que deseas acceder. Por lo general, entityId es el valor de una clave primaria de una tabla o un conjunto de datos. Si especificas un valor para entityId y la tabla o el conjunto de datos no tienen una columna de clave primaria, la integración informa un error de entorno de ejecución y la tarea Conectores falla. Por ejemplo, para obtener una fila específica de una tabla de MySQL, entityId es el valor de la clave primaria de la tabla. Nota: El entityId no es obligatorio para BigQuery. Este campo está vacío cuando una tabla de BigQuery no tiene una clave primaria.
connectorInputPayload	JSON	Los datos reales que se agregarán o actualizarán en una entidad. En el siguiente ejemplo, se muestra el fragmento JSON de los datos de una fila que se agregarán en una tabla: { "employee_first_name": "John", "employee_emailID": "[e-mail]" } En este ejemplo, employee_first_name y employee_emailID son los nombres de las columnas con los valores correspondientes John y [e-mail].
filterClause	String	Restringe el resultado de las operaciones en función de una condición. Para obtener más información sobre cómo agregar una cláusula de filtro, consulta Agrega un filtro para una operación.
listEntitiesPageSize	Integer	Especifica el número de resultados que se deben mostrar en una página. Una página es una agrupación lógica de los registros en un conjunto de resultados. El concepto de una página es útil cuando esperas una gran cantidad de registros en el conjunto de resultados. Si el conjunto de resultados es grande, la tarea Conectores puede fallar, ya que hay un límite en el tamaño de los datos que la tarea Conectores puede procesar. Si desglosas el conjunto de resultados en fragmentos más pequeños, puedes evitar este problema. Por ejemplo, si esperas 1,000 registros en tu conjunto de resultados, puedes configurar listEntitiesPageSize como 100. Entonces, cuando la tarea Conectores se ejecuta por primera vez, muestra los primeros 100 registros, los siguientes 100 registros en la segunda ejecución, y así sucesivamente. Importante: El tamaño de página predeterminado es de 25 y el número máximo de páginas compatibles con la tarea es de 50,000. A menos que tu tabla o conjunto de datos tenga una clave primaria, debes configurar el parámetro listEntitiesSortByColumns para usar listEntitiesPageToken. Usa el parámetro listEntitiesPageSize junto con el parámetro listEntitiesPageToken para navegar por las páginas.
listEntitiesPageToken	String	Un identificador de página (token) que te permite acceder a una página específica. Puedes obtener el valor de un token de página desde el parámetro de salida listEntitiesNextPageToken. Debido a que cada página tiene un token único, tienes la flexibilidad de acceder a cualquier página que desees en el conjunto de resultados. Para comprender el uso de este parámetro, también lee la descripción del parámetro de salida listEntitiesNextPageToken.
listEntitiesSortByColumns	Arreglo de strings	Nombre de la columna según el que deseas ordenar el conjunto de resultados. Nota: Puedes ordenar el conjunto de resultados solo por una columna.

Los parámetros de resultado

En la siguiente tabla, se describen los parámetros de salida para las distintas operaciones de entidades.

Nombre del parámetro	Tipo de dato	Descripción
connectorOutputPayload	JSON	El resultado de una operación en formato JSON.
listEntitiesNextPageToken	String	Un identificador generado por el sistema para una página. Puedes pensar en el token como un puntero mediante el que puedes acceder a una página en particular del conjunto de resultados. Si dividiste tu conjunto de resultados en varias páginas mediante la configuración del parámetro listEntitiesPageSize, necesitas un mecanismo para navegar por las páginas. El parámetro de salida listEntitiesNextPageToken te permite hacer eso exactamente. Cada vez que se ejecuta la tarea Conectores, el sistema genera un token para la página siguiente y establece el valor de listEntitiesNextPageToken en el token recién generado. Luego, puedes usar este token para acceder a la siguiente página del conjunto de resultados. Para acceder a la página siguiente, debes establecer el parámetro de entrada listEntitiesPageToken en el valor del token de la página siguiente. Por ejemplo, considera que configuraste el parámetro listEntitiesPageSize como 2 y, luego, cuando la tarea Conectores se ejecuta por primera vez, listEntitiesNextPageToken se configura como el valor del token ChoKC2VtcGxveWVlX2lkEgkRAAAAAAAA8D8YDw==. Luego, puedes establecer el parámetro de entrada listEntitiesPageToken en el valor de este token para recuperar la página siguiente en la ejecución posterior de la tarea Conectores. Si tu conjunto de resultados tiene una gran cantidad de páginas, puedes considerar usar Tarea Repetir indefinidamente para ir a la página siguiente y usar la función Asignación de datos asignar automáticamente los valores de token de la página al Parámetro de entrada listEntitiesPageToken después de cada ejecución. Asigna listEntitiesNextPageToken de la última iteración de bucle a listEntitiesPageToken en el LIST Operation de la tarea Conectores de la iteración de bucle actual. La tarea bucle while finaliza cuando listEntitiesNextPageToken es NULL, lo que implica que no hay más páginas.

Cláusula de filtro para las operaciones de entidad

Puedes restringir los registros que procesa la tarea Conectores con la variable Cláusula de filtro que está disponible como Entrada de tarea. Por ejemplo, en el caso de una operación de eliminación, puedes agregar una cláusula de filtro para borrar registros con un orderId específico.

La cláusula de filtro se puede aplicar solo para las siguientes operaciones de entidad:

• Lista
• Borrar
• Actualización

Cuando seleccionas cualquiera de estas operaciones, la sección Entrada de la tarea de la tarea Conectores muestra el campo Cláusula de filtro automáticamente.

Agrega una cláusula de filtro

Para agregar una cláusula de filtro, sigue estos pasos:

1. Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
2. Expande la sección Entrada de tarea y haz clic en la variable de string filterClause(conectores).

   Aparecerá el diálogo Configure Variable.

3. Ingresa la cláusula del filtro (siguiendo la sintaxis de la cláusula) en el campo Valor predeterminado.
4. Haz clic en Guardar.

Sintaxis y ejemplos de cláusulas de filtro

Una cláusula de filtro tiene el siguiente formato:

FIELD_NAME CONDITION FILTER_VALUE

Ejemplos

• OwnerId = '0053t000007941XAAQ'

• PoNumber < 2345

• OrderNumber = 00110 AND StatusCode = 'Draft'

• TotalAmount > 2500

• ShippingPostalCode = 94043 OR ShippingPostalCode = 77002

Importante: En la cláusula de filtro, especifica los valores de string entre comillas simples ( ' ) o dobles ( " ) según la base de datos. que estés usando. Por ejemplo, MySQL acepta comillas simples y dobles, mientras que BigQuery acepta comillas simples.

Uso de variables en la cláusula de filtro

No puedes usar directamente una variable de integración en una cláusula de filtro. Si deseas usar una variable de integración, primero debes configurar una tarea de asignación de datos para crear una asignación entre la variable de integración y la cláusula de filtro.

En la siguiente tabla, se muestra una asignación de ejemplo entre una variable de integración y la variable filterClause(Connectors):

Entrada	Salida
PRIMARY_KEY_ID = ' .CONCAT(INTEGRATION_VARIABLE) .CONCAT(')	filterClause(Connectors)

En el ejemplo anterior, PRIMARY_KEY_ID = ' se ingresa como un Valor en la fila de entrada.

---

Acción: Ejecuta una consulta de SQL personalizada

Para crear una consulta personalizada, sigue estos pasos:

1. Sigue las instrucciones detalladas para agregar una tarea de conectores.
2. Cuando configures la tarea del conector, en el tipo de acción que desees realizar, selecciona Acciones.
3. En la lista Acción, selecciona Ejecutar consulta personalizada y, luego, haz clic en Listo.

   

4. Expande la sección Task input y, luego, haz lo siguiente:
   1. En el campo Tiempo de espera después, ingresa la cantidad de segundos que se debe esperar hasta que se ejecute la consulta.

      Valor predeterminado: 180 segundos.

   2. En el campo Cantidad máxima de filas, ingresa la cantidad máxima de filas que se mostrarán en la base de datos.

      Valor predeterminado: 25.

   3. Para actualizar la consulta personalizada, haz clic en Editar secuencia de comandos personalizada. Se abrirá el diálogo Editor de secuencia de comandos.

      

   4. En el diálogo Editor de secuencia de comandos, ingresa la consulta en SQL y haz clic en Guardar.

      Puedes usar un signo de interrogación (?) en una sentencia SQL para representar un solo parámetro que se debe especificar en la lista de parámetros de consulta. Por ejemplo, la siguiente consulta de SQL selecciona todas las filas de la tabla Employees que coinciden con los valores especificados para la columna LastName:

      SELECT * FROM Employees where LastName=?

      Nota: Se admiten las declaraciones de lenguaje de manipulación de datos (DML) y lenguaje de definición de datos (DDL).
   5. Si usaste signos de interrogación en tu consulta de SQL, debes agregar el parámetro haciendo clic en + Agregar nombre de parámetro para cada signo de interrogación. Mientras se ejecuta la integración, estos parámetros reemplazan los signos de interrogación (?) en la consulta en SQL de manera secuencial. Por ejemplo, si agregaste tres signos de interrogación (?), debes agregar tres parámetros en orden de secuencia.

      

      Para agregar parámetros de consulta, haz lo siguiente:

      1. En la lista Tipo, selecciona el tipo de datos del parámetro.
      2. En el campo Valor, ingresa el valor del parámetro.
      3. Para agregar varios parámetros, haz clic en + Agregar parámetro de consulta.

Actualización del esquema

Todas las entidades y acciones tendrán un esquema asociado. Por ejemplo, un esquema de acción tendrá los detalles de los parámetros, como los nombres de los parámetros y su tipo de datos correspondiente. La conexión recupera el esquema (metadatos) de las entidades y las acciones durante el tiempo de ejecución desde tu backend. Si hay actualizaciones en el esquema, estas no se reflejarán automáticamente en tus conexiones existentes. Debes actualizar el esquema de forma manual. Para ver el esquema actualizado en las tareas del conector existentes, sigue estos pasos:

1. En Conectores de integración, abre la página Detalles de la conexión de la conexión y, luego, haz clic en Actualizar esquema de conexión.
2. En Integración de aplicaciones, debes volver a configurar la tarea de conector existente para la misma conexión.

Creación de conexiones intercaladas

Puedes usar la tarea Conectores para crear directamente una conexión nueva en Conectores de Integration.

Antes de comenzar

• Agrega una tarea de Connector

Crear una nueva conexión

Para crear una conexión nueva desde Application Integration, sigue estos pasos:

1. Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
2. Haz clic en Configurar conector.

   Aparecerá la página Editor de tareas de Connectors.

3. Omite el campo Región.
4. Haz clic en Conexión y selecciona la opción Crear conexión en el menú desplegable.
5. Completa los siguientes pasos en el panel Crear conexión:
   Nota: Las siguientes instrucciones son genéricas para crear una conexión. Si bien la mayoría de los pasos siguen siendo los mismos para todos los tipos de conexión, algunos pasos adicionales o los detalles relacionados con la autenticación pueden variar.

   Recomendamos que también veas la documentación del tipo de conexión correspondiente en Conectores de integración.

   1. En la sección Ubicación, elige la ubicación para la conexión.
      1. Haz clic en Región y selecciona una ubicación de la lista desplegable.
      2. Haz clic en Siguiente.
   2. En el paso Detalles de la conexión, proporciona los detalles sobre la conexión:
      1. Conector: Selecciona el tipo de conector que deseas crear de la lista desplegable. Para obtener más información sobre la lista de conectores compatibles, consulta Todos los conectores de integración.
      2. Versión del conector: elige una versión disponible del tipo de conector seleccionado de la lista desplegable.
      3. Nombre de la conexión: ingresa un nombre para la instancia de conexión nueva.
         Nota: Los nombres de las conexiones deben cumplir con los siguientes criterios:

         • Los nombres de las conexiones pueden usar 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 de las conexiones no pueden superar los 63 caracteres.
      4. De manera opcional, ingresa una Descripción para la instancia de conexión.
      5. Marca Habilitar Cloud Logging para almacenar los datos de registro de la instancia de conexión (opcional).
      6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
      7. Haz clic en Configuración avanzada para establecer la configuración del nodo de conexión (opcional).

         Para obtener más información, consulta la documentación de conexión correspondiente en Conectores de integración.

      8. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
      9. Haz clic en Siguiente.
   3. En el paso Autenticación, proporciona los detalles de autenticación para la conexión.
      1. Los métodos Authentication que se propagan durante este paso se basan en el tipo de conexión que se crea.

         Los diferentes tipos de conexión usan métodos de autenticación distintos. Para obtener más información, consulta la sección Configura la autenticación de la documentación de conexión respectiva en Conectores de integración.

      2. Haz clic en Siguiente.
   4. Revisa: Revisa tus detalles de conexión y autenticación.
   5. Haz clic en Crear.

---

Prácticas recomendadas

• Para obtener más información sobre los límites de uso que se aplican a la tarea Conectores, consulta Límites de uso.
• Para obtener información sobre cómo solucionar problemas en una tarea de conectores con errores, consulta Usa registros para solucionar problemas y realizar un seguimiento de las fallas del conector.

Estrategia de manejo de errores

Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.

Precios

El activador de Cloud Pub/Sub y el activador de Salesforce no requieren que crees un conector. Sin embargo, si usas la tarea Conectores para conectarte a Pub/Sub o Salesforce, se te facturará el uso del conector. Para obtener información sobre los precios, consulta Precios de Application Integration.

Cuotas y límites

Para obtener más información sobre las cuotas y los límites, consulta Cuotas y límites.

¿Qué sigue?

• Obtén información sobre todas las tareas y los activadores.
• Obtén información para probar y publicar una integración.
• Obtén más información sobre el manejo de errores.
• Obtén más información sobre los registros de ejecución de la integración.