Conexión a 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, puede crear instancias de actividades de Cloud Firestore asociadas con esa conexión para usarlas como orígenes (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:

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 Cloud Firestore 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 Cloud Firestore¶

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

Configuración de la conexión de Cloud Firestore

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 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 la 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: 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 Clave privada.	Reemplace cualquier carácter de nueva línea con un retorno de carro.

Próximos Pasos¶

Después de crear una conexión de Cloud Firestore, coloque un tipo de actividad en el tela de diseño para crear instancias de actividad que se usarán como orígenes (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 obtener más detalles, consulte Menús de acciones en Conceptos básicos del conector.

Están disponibles estos tipos de actividades:

Consulta: Consulta documentos dentro de una colección en Cloud Firestore y está destinado a usarse como fuente en una operación.
Crear: Crea documentos dentro de una colección en Cloud Firestore y está destinado a usarse como destino en una operación.
Actualizar: Actualiza documentos dentro de una colección en Cloud Firestore y está destinado a usarse como objetivo en una operación.
Borrar: Elimina documentos dentro de una colección de Cloud Firestore y está destinado a usarse como objetivo en una operación.