Conexión a Google Pub Sub
Introducción
Una conexión de Google Pub Sub, creada mediante el conector de Google Pub Sub, establece acceso a Google Pub/Sub. Una vez configurada una conexión, puedes crear instancias de actividades de Google Pub Sub asociadas con esa conexión para usarlas 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, debe crear una cuenta de servicio, otorgar roles y obtener ciertas credenciales en Google Cloud Platform como se describe en Requisitos previos de Google Pub Sub.
Crear o Editar una Conexión de Google Pub Sub
Se crea una nueva conexión de Google Pub Sub mediante el conector de Google Pub Sub desde una de estas ubicaciones:
- La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
- La página Conexiones globales (vea Crear un extremo global en Conexiones globales).
Se puede editar una conexión de Google Pub Sub existente desde estas ubicaciones:
- La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
- La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).
- La página Conexiones globales (vea Editar un extremo global en Conexiones globales).
Configurar una Conexión de Google Pub Sub
A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Google Pub Sub.
Sugerencia
Campos con un ícono de variable admite el uso de variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [
en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes para 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.
/
o dos puntos:
Este nombre también se utiliza para identificar el extremo de Google Pub Sub, que hace referencia 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 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
proporcionado 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
) presente en elprivate_key
la cadena debe reemplazarse con 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 usar configuración de proxy del agente privado.
-
Prueba: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante la política de la organización Deshabilitar actualización automática del conector.
-
Guardar cambios: Haga clic para guardar y cerrar la configuración de 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 solicitará 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 te pedirá que confirmes que deseas 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 | 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. | El pubsub.topics.list o pubsublite.topics.list no se ha concedido permiso a la cuenta de servicio 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. | Habilitar la API de Google Pub/Sub para el proyecto. |
Próximos Pasos
Después de crear una conexión de Google Pub Sub, coloca un tipo de actividad en el tela de diseño para crear instancias de actividad que se usarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).
Se puede acceder a las acciones del menú de una conexión y sus tipos de actividad desde el panel de proyecto y la paleta de componentes de diseño. Para obtener más información, consulte Menús de acciones en Conceptos básicos del conector.
Estos tipos de actividades están disponibles:
-
Reconocer mensaje: Reconoce los mensajes de una suscripción en Google Pub/Sub y está destinado a usarse como objetivo en una operación.
-
Crear tema: Crea temas en Google Pub/Sub y está pensado para usarse como objetivo en una operación.
-
Obtener mensaje: Recupera mensajes de una suscripción en Google Pub/Sub y está destinado a ser utilizado como fuente en una operación.
-
Publicar mensaje: Publica mensajes en un tema en Google Pub/Sub y está destinado a ser utilizado como objetivo en una operación.
-
Crear suscripción: Crea suscripciones en Google Pub/Sub y está pensado para usarse como objetivo en una operación.
-
Escuchar mensaje: Consume mensajes de una suscripción de Google Pub/Sub y está destinado a usarse como fuente en una operación.
-
Borrar: Elimina suscripciones o temas de Google Pub/Sub y está destinado a usarse como objetivo en una operación.