Las operaciones principales para agregar y consultar datos que se describen en esta página son las mismas que están disponibles en Firestore estándar. Si conoces la edición estándar de Firestore, puedes agregar y consultar datos en Firestore Enterprise de la misma manera.
Nos complace que pruebes las operaciones de canalización, pero, para esta versión preliminar, debes tener en cuenta las operaciones principales:
- Usarás operaciones de adición de Core para propagar datos durante la versión preliminar.
- Puedes usar las operaciones de Core para el soporte sin conexión y en tiempo real, al igual que en la edición Estándar. Las consultas de Pipeline aún no tienen capacidades en tiempo real ni sin conexión.
Agrega datos a Firestore con operaciones de Core
Las operaciones de Core admiten la adición y la consulta de datos. Las operaciones de Pipeline solo se utilizan para consultar datos. Por lo tanto, para las actividades de vista previa, usarás operaciones básicas para completar tu nueva base de datos compatible con canalizaciones.
Como repaso de Core, los dos métodos principales para escribir datos son set() y add(). Comprender la diferencia es clave para administrar tus documentos de manera eficaz.
Puedes pensar en estas operaciones de la siguiente manera:
set(): Usa este parámetro cuando quieras especificar el ID de un documento. Si ya existe un documento con ese ID,set()lo reemplazará por completo, a menos que uses la opción de combinación. Si no existe,set()lo creará.add(): Usa esta opción cuando quieras que Firestore genere automáticamente un ID único para tu documento nuevo. Esto es útil cuando agregas documentos a una colección y no tienes un identificador natural para usar.
Para obtener una guía completa sobre cómo agregar y actualizar documentos, incluido cómo controlar objetos anidados, arrays y marcas de tiempo del servidor, consulta la documentación oficial sobre cómo agregar datos a Cloud Firestore.
Lee datos de Firestore con operaciones básicas
La recuperación de datos de Firestore con las funciones de operaciones básicas funciona exactamente igual que en la edición Estándar de Firestore, lo que incluye la compatibilidad con actualizaciones en tiempo real y capacidades sin conexión.
Existen algunas formas de recuperar tus datos:
- Obtener un documento una vez: La forma más sencilla de leer datos es recuperar un documento o un resultado de la consulta una sola vez.
- Detecta actualizaciones en tiempo real: Puedes configurar un objeto de escucha en un documento o una consulta para recibir actualizaciones en tiempo real a medida que cambian los datos.
- Opciones de fuente: En el caso de las aplicaciones con capacidades sin conexión, puedes especificar si se deben recuperar los datos del servidor, de la caché local o dejar que el SDK decida.
Para obtener más información sobre cómo realizar consultas simples y compuestas, ordenar y limitar datos, y trabajar con objetos personalizados, consulta la documentación detallada sobre cómo obtener datos con Cloud Firestore.