Consulta los conectores compatibles con Application Integration.

Firestore: tarea de obtención por lotes

Vista previa

Esta función está sujetas a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

La tarea Firestore - Obtener por lote te permite enviar una única solicitud por lote a Cloud Firestore para obtener o recuperar el contenido de varios documentos de Firestore. Es posible que los documentos recuperados no estén en el mismo orden en el que se solicitaron.

Firestore es una base de datos de documentos NoSQL creada para el escalado automático, el alto rendimiento y la facilidad de desarrollo de aplicaciones.

Antes de empezar

Antes de configurar la tarea Firestore - Obtener por lotes, asegúrate de realizar las siguientes tareas en tu proyecto de Google Cloud:

1. Habilita la API Cloud Firestore (firestore.googleapis.com).

   Habilita la API de Cloud Firestore

2. Crea un perfil de autenticación. Integración de aplicaciones usa un perfil de autenticación para conectarse a un endpoint de autenticación de la tarea Firestore - Obtener por lotes.

   Para obtener información sobre cómo conceder roles o permisos adicionales a una cuenta de servicio, consulta Conceder, cambiar y revocar el acceso.

Configurar la tarea Firestore - Obtener por lotes

1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

   Ir a Application Integration

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

   Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

3. Seleccione una integración o haga clic en Crear integración para crear una.

   Si vas a crear una integración:

   1. Escribe 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 muestran las regiones aprovisionadas en tu proyecto de Google Cloud. Para aprovisionar una región, haga clic en Habilitar región. Para obtener más información, consulta Habilitar una región nueva.
   3. Selecciona una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración de la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si ha habilitado la gestión de la integración en la región seleccionada.
   4. Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.

4. En la barra de navegación del editor de integraciones, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
5. Haz clic en el elemento Firestore - Batch Get y colócalo en el editor de integraciones.
6. Haz clic en el elemento Firestore - Batch Get del diseñador para ver el panel de configuración de la tarea Firestore - Batch Get.
7. Ve a Autenticación y selecciona un perfil de autenticación que quieras usar.

   Opcional. Si no has creado un perfil de autenticación antes de configurar la tarea, haz clic en + Nuevo perfil de autenticación y sigue los pasos que se indican en Crear un perfil de autenticación.

8. Ve a Entrada de tarea y configura los campos de entrada que se muestran con la siguiente tabla Parámetros de entrada de tarea.

   Los cambios en los campos de entrada se guardan automáticamente.

Parámetros de entrada de la tarea

En la siguiente tabla se describen los parámetros de entrada de la tarea Firestore - Obtener por lotes:

Propiedad	Tipo de datos	Descripción
Región	Cadena	Ubicación de la base de datos de Firestore. Por ejemplo, us-central1.
ProjectsId	Cadena	El ID de tu proyecto de Google Cloud.
DatabasesId	Cadena	ID de la base de datos de Firestore.
Solicitud	JSON	Consulta la estructura JSON de la solicitud.

Salida de la tarea

La tarea Firestore - Obtener por lotes devuelve los datos del documento en formato codificado en base64. Debes decodificar el valor codificado en Base64 para obtener la cadena de salida.

Nota: Puedes codificar o decodificar datos en Base64 con el comando base64 en Linux o macOS, o con el comando Base64.exe en Windows. Los lenguajes de programación y de secuencias de comandos suelen incluir bibliotecas para la codificación en base64. Para ver ejemplos de líneas de comandos, consulta Decodificar base64 en la documentación de Cloud Text-to-Speech.

Estrategia de gestión de errores

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

Cuotas y límites

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

Siguientes pasos

• Añade bordes y condiciones de borde.
• Pruebe y publique su integración.
• Configura un activador.
• Añade una tarea de asignación de datos.
• Consulta todas las tareas de los servicios de Google Cloud.