Firestore è un database di documenti NoSQL creato per la scalabilità automatica, prestazioni elevate e facilità di sviluppo delle applicazioni. Si tratta della versione più recente di Datastore e introduce diversi miglioramenti rispetto a Datastore.
Dato che Firestore in modalità Datastore è ottimizzata per i casi d'uso dei server e per App Engine, ti consigliamo di utilizzare Firestore in modalità Datastore per i database che verranno utilizzati principalmente dalle app App Engine. Firestore in modalità Native è più utile per i casi d'uso delle notifiche su dispositivi mobili e in tempo reale. Per ulteriori informazioni sulle modalità Firestore, consulta Scegliere tra la modalità Native e la modalità Datastore.
Questo documento descrive come utilizzare la libreria client di Google Cloud per archiviare e recuperare i dati in un database in modalità Datastore.
Prerequisiti e configurazione
Segui le istruzioni in "Hello, World!" per Node.js su App Engine per configurare il tuo ambiente e il tuo progetto e per capire come sono strutturate le app Node.js in App Engine. Annota e salva l'ID del progetto, perché ti servirà per eseguire l'applicazione di esempio descritta in questo documento.
Clona il repository
Scarica (clona) l'esempio:
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
cd nodejs-docs-samples/appengine/datastore
Modifica la configurazione del progetto e imposta le dipendenze
In package.json
, imposta @google-cloud/datastore
come dipendenza, che fornisce le funzioni per usare la modalità Datastore.
Codice dell'applicazione
L'applicazione di esempio registra, recupera e mostra gli IP dei visitatori. Come puoi notare, una voce di log è una semplice classe a due campi di tipo visit
, salvata in modalità Datastore con il comando save del set di dati. Quindi, le dieci visite più recenti vengono recuperate in ordine decrescente, utilizzando il comando runQuery del set di dati.
Utilizzo di index.yaml
file in corso...
L'app di esempio esegue query semplici. Le query in modalità Datastore più elaborate richiedono uno o più indici, che devi specificare in un file index.yaml
che carichi insieme all'app. Questo file può essere creato manualmente o generato automaticamente durante il test dell'app a livello locale.
Test locale
Se devi sviluppare e testare la tua applicazione in locale, puoi utilizzare l'emulatore di modalità Datastore.
Per ulteriori informazioni
Per informazioni complete sulla modalità Datastore, inclusi ottimizzazioni e concetti, consulta la documentazione di Firestore in modalità Datastore.