As operações principais para adicionar e consultar dados descritas nesta página são as mesmas disponíveis no Firestore Standard. Se você conhece a edição Standard do Firestore, pode adicionar e consultar dados no Firestore Enterprise da mesma forma.
Estamos animados para que você teste as operações de pipeline, mas, para esta prévia, é importante conhecer as operações principais:
- Você vai usar operações de adição do Core para preencher dados durante a prévia.
- Você pode usar as operações principais para suporte em tempo real e off-line, assim como na edição Standard. As consultas de pipeline ainda não têm recursos em tempo real e off-line.
Adicionar dados ao Firestore com operações principais
As operações principais permitem adicionar e consultar dados. As operações de pipeline são apenas para consultar dados. Portanto, para atividades de prévia, você vai usar operações principais para preencher seu novo banco de dados compatível com pipelines.
Para relembrar, os dois métodos principais para gravar dados no Core são set() e add(). Entender a diferença é fundamental para gerenciar seus documentos com eficiência.
Você pode pensar nessas operações da seguinte maneira:
set(): use quando quiser especificar o ID de um documento. Se um documento com esse ID já existir, oset()vai substituir completamente, a menos que você use a opção de mesclagem. Se ele não existir,set()vai criar.add(): use isso quando quiser que o Firestore gere automaticamente um ID exclusivo para o novo documento. Isso é útil quando você está adicionando documentos a uma coleção e não tem um identificador natural para usar.
Para um guia completo sobre como adicionar e atualizar documentos, incluindo como processar objetos aninhados, matrizes e carimbos de data/hora do servidor, consulte a documentação oficial sobre Como adicionar dados ao Cloud Firestore.
Ler dados do Firestore com operações principais
A recuperação de dados do Firestore com funções de operações principais funciona exatamente como na edição Standard do Firestore, incluindo suporte para atualizações em tempo real e recursos off-line.
Há algumas maneiras de recuperar seus dados:
- Receber um documento uma vez: a maneira mais simples de ler dados é buscar um documento ou um resultado de consulta uma única vez.
- Detecte atualizações em tempo real: é possível definir um listener em um documento ou consulta para receber atualizações em tempo real conforme os dados mudam.
- Opções de origem: para aplicativos com recursos off-line, é possível especificar se os dados serão recuperados do servidor, do cache local ou se o SDK vai decidir.
Para saber mais sobre como realizar consultas simples e compostas, ordenar e limitar dados e trabalhar com objetos personalizados, consulte a documentação detalhada sobre Como receber dados com o Cloud Firestore.