Saltar al contenido

Conexión de Google Pub Sub

Introducción

Una conexión de Google Pub Sub, creada utilizando el conector de Google Pub Sub, establece acceso a Google Pub/Sub. Una vez que se configura una conexión, se pueden crear instancias de actividades de Google Pub Sub asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Nota

Para usar el conector de Google Pub Sub, debes crear una cuenta de servicio, otorgar roles y obtener ciertas credenciales en Google Cloud Platform como se describe en prerrequisitos de Google Pub Sub.

Crear o editar una conexión de Google Pub Sub

Se crea una nueva conexión de Google Pub Sub utilizando el conector de Google Pub Sub desde una de estas ubicaciones:

Una conexión de Google Pub Sub existente se puede editar desde estas ubicaciones:

Configurar una conexión de Google Pub Sub

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Google Pub Sub se describe a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes de las que elegir.

  • Nombre de la Conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Google Pub Sub y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Google Pub Sub, que se refiere tanto a una conexión específica como a sus actividades.

  • ID del Proyecto: Ingrese el project_id proporcionado por el archivo JSON de credenciales como se describe en requisitos previos de Google Pub Sub.

  • Correo Electrónico del Cliente: Ingrese el client_email proporcionado por el archivo JSON de credenciales como se describe en requisitos previos de Google Pub Sub.

  • Cadena de Clave Privada: Ingrese la private_key proporcionada por el archivo JSON de credenciales como se describe en requisitos previos de Google Pub Sub. La clave privada debe ingresarse en este formato:

    -----BEGIN PRIVATE KEY-----<private_key>-----END PRIVATE KEY-----

    Nota

    Todos los caracteres de nueva línea (\n) presentes en la cadena private_key deben ser reemplazados por un retorno de carro en el campo Cadena de Clave Privada. De lo contrario, se producirá un error al probar la conexión.

  • Usar Configuración de Proxy (Solo Agente Privado): Al usar un agente privado, se puede seleccionar esta configuración para utilizar configuraciones de proxy de agente privado.

  • Probar: Haga clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por los agentes en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar Actualización Automática del Conector.

  • Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.

  • Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Posibles errores de conexión

Estos son posibles errores de conexión y sus soluciones:

Error Causa Solución
An error occurred: com.google.common.base.Preconditions.checkArgument(ZLjava/lang/String;CLjava/lang/Object;)V La versión del agente es demasiado antigua. Asegúrese de que la versión del agente que se está utilizando sea la versión 10.60 o posterior.
An error occurred: java.io.IOException: Invalid PKCS#8 data Los caracteres de nueva línea (\n) están presentes en la Cadena de clave privada. Reemplace cualquier carácter de nueva línea con un retorno de carro.
An error occurred: io.grpc.StatusRuntimeException: PERMISSION_DENIED: User not authorized to perform this action. No se ha concedido el permiso pubsub.topics.list o pubsublite.topics.list a la cuenta de servicio de Google Pub/Sub. Consulte Requisitos previos de Google Pub Sub para obtener información sobre la asignación de roles y permisos.
An error occurred: io.grpc.StatusRuntimeException: PERMISSION_DENIED: Cloud Pub/Sub API has not been used in project 730922392691 before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/pubsub.googleapis.com/overview?project=730922392691 then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry. La API de Google Pub/Sub no se ha habilitado para el proyecto. Habilite la API de Google Pub/Sub para el proyecto.

Próximos pasos

Después de que se ha creado una conexión de Google Pub Sub, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta los menús de acciones en Conceptos básicos de conectores.

Estos tipos de actividad están disponibles:

  • Reconocer Mensaje: Reconoce mensajes de una suscripción en Google Pub/Sub y está destinado a ser utilizado como un destino en una operación.

  • Crear Tema: Crea temas en Google Pub/Sub y está destinado a ser utilizado como un destino en una operación.

  • Obtener Mensaje: Recupera mensajes de una suscripción en Google Pub/Sub y está destinado a ser utilizado como una fuente en una operación.

  • Publicar Mensaje: Publica mensajes en un tema en Google Pub/Sub y está destinado a ser utilizado como un destino en una operación.

  • Crear Suscripción: Crea suscripciones en Google Pub/Sub y está destinado a ser utilizado como un destino en una operación.

  • Escuchar Mensaje: Consume mensajes de una suscripción de Google Pub/Sub y está destinado a ser utilizado como una fuente en una operación.

  • Eliminar: Elimina suscripciones o temas de Google Pub/Sub y está destinado a ser utilizado como un destino en una operación.