Saltar al contenido

Conexión de Cloud Firestore

Introducción

Una conexión de Cloud Firestore, creada mediante el conector de Cloud Firestore, establece acceso a Google Cloud Firestore. Una vez configurada una conexión, puedes crear instancias de actividades de Cloud Firestore 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).

Crear o Editar una Conexión de Cloud Firestore

Se crea una nueva conexión de Cloud Firestore mediante el conector de Cloud Firestore desde una de estas ubicaciones:

Una conexión existente de Cloud Firestore se puede editar desde estas ubicaciones:

Configurar una Conexión a Cloud Firestore

Cada elemento de la interfaz de usuario de la pantalla de configuración de conexión de Cloud Firestore se describe a continuación.

Configuración de conexión de Cloud Firestore

Consejo

Campos con un ícono de variable Ícono de variable admite el uso de variables globales, variables del proyecto, y variables de Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el icono de variable para mostrar una lista de las variables existentes para elegir.

  • Nombre de la conexión: Introduzca un nombre que se utilizará para identificar la conexión. El nombre debe ser único para cada conexión de Cloud Firestore y no debe contener barras diagonales. / o dos puntos :. Este nombre también se utiliza para identificar el extremo de Cloud Firestore, 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 Cloud Firestore.

  • Correo del cliente: Ingrese el client_email proporcionado por el archivo JSON de credenciales, como se describe en Requisitos previos de Cloud Firestore.

  • ID de cliente: Ingrese el client_id proporcionado por el archivo JSON de credenciales, como se describe en Requisitos previos de Cloud Firestore.

  • ID de clave privada: Ingrese el private_key_id proporcionado por el archivo JSON de credenciales, como se describe en Requisitos previos de Cloud Firestore.

  • Clave Privada: Ingrese la private_key proporcionado por el archivo JSON de credenciales, como se describe en Requisitos previos de Cloud Firestore. La clave privada debe ingresarse en este formato:

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

    Nota

    Cualquier carácter de nueva línea (\n) presente en el private_key La cadena debe reemplazarse con un retorno de carro en el campo Clave privada. De lo contrario, se producirá un error al probar la conexión.

  • Prueba: Haga 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 Desactivar actualización automática del conector política de la organización.

  • 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 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 eliminación). Un mensaje le pide que confirme que desea eliminar la conexión.

Posibles Errores de Conexión

Estos son los 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 utiliza 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 Clave privada. Reemplace los caracteres de nueva línea con un retorno de carro.

Próximos Pasos

Después de crear una conexión de Cloud Firestore, 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 de menú para una conexión y sus tipos de actividad desde el panel del 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:

  • Consulta: Consulta documentos dentro de una colección en Cloud Firestore y está diseñado para usarse como fuente en una operación.

  • Crear: Crea documentos dentro de una colección en Cloud Firestore y está diseñado para usarse como destino en una operación.

  • Actualizar: Actualiza documentos dentro de una colección en Cloud Firestore y está diseñado para usarse como destino en una operación.

  • Borrar: Elimina documentos dentro de una colección de Cloud Firestore y está diseñado para usarse como destino en una operación.