Aggiungere ed eseguire query sui dati con le operazioni di base

Le operazioni di base per l'aggiunta e l'interrogazione dei dati descritte in questa pagina sono le stesse disponibili in Firestore Standard. Se hai familiarità con Firestore Standard, puoi aggiungere ed eseguire query sui dati in Firestore Enterprise nello stesso modo.

Siamo felici che tu voglia provare le operazioni della pipeline, ma per questa anteprima devi conoscere le operazioni di base:

  • Utilizzerai le operazioni di aggiunta di Core per compilare i dati durante l'anteprima.
  • Puoi utilizzare le operazioni di base per l'assistenza in tempo reale e offline proprio come in Standard edition. Le query di pipeline non dispongono ancora di funzionalità in tempo reale e offline.

Aggiungi dati a Firestore con le operazioni di base

Le operazioni principali supportano l'aggiunta e l'interrogazione dei dati. Le operazioni della pipeline sono solo per l'esecuzione di query sui dati. Pertanto, per le attività di anteprima, utilizzerai le operazioni di base per compilare il nuovo database compatibile con le pipeline.

Per ripassare Core, i due metodi principali per scrivere i dati sono set() e add(). Comprendere la differenza è fondamentale per gestire i documenti in modo efficace.

Puoi pensare a queste operazioni nel seguente modo:

  • set(): utilizza questo campo quando vuoi specificare personalmente l'ID di un documento. Se esiste già un documento con questo ID, set() lo sovrascriverà completamente a meno che tu non utilizzi l'opzione di unione. Se non esiste, set() lo creerà.
  • add(): utilizza questa opzione quando vuoi che Firestore generi automaticamente un ID univoco per il nuovo documento. Questa funzionalità è utile quando aggiungi documenti a una raccolta e non hai un identificatore naturale da utilizzare.

Per una guida completa sull'aggiunta e l'aggiornamento dei documenti, inclusa la gestione di oggetti nidificati, array e timestamp del server, consulta la documentazione ufficiale sull'aggiunta di dati a Cloud Firestore.

Leggi i dati da Firestore con le operazioni di base

Il recupero dei dati da Firestore con le funzioni delle operazioni di base funziona esattamente come in Firestore Standard, incluso il supporto per gli aggiornamenti in tempo reale e le funzionalità offline.

Esistono diversi modi per recuperare i dati:

  • Recupera un documento una sola volta: il modo più semplice per leggere i dati è recuperare un documento o un risultato di query una sola volta.
  • Ascolta gli aggiornamenti in tempo reale: puoi impostare un listener su un documento o una query per ricevere aggiornamenti in tempo reale man mano che i dati cambiano.
  • Opzioni di origine: per le applicazioni con funzionalità offline, puoi specificare se recuperare i dati dal server, dalla cache locale o lasciare che sia l'SDK a decidere.

Per saperne di più su come eseguire query semplici e composte, ordinare e limitare i dati e lavorare con oggetti personalizzati, consulta la documentazione dettagliata su Recuperare i dati con Cloud Firestore.