Firestore è un database di documenti NoSQL creato per offrire scalabilità automatica, prestazioni elevate e facilità dello sviluppo di applicazioni. Si tratta della versione più recente di Datastore e introduce diversi miglioramenti rispetto a Datastore.
Poiché Firestore in modalità Datastore è ottimizzato per casi d'uso del server e per App Engine, consigliamo di utilizzare Firestore in modalità Datastore per database che verranno utilizzati principalmente dalle app di App Engine. Firestore in modalità nativa è più utile per i casi d'uso delle notifiche su dispositivi mobili e in tempo reale. Per ulteriori informazioni sulle modalità Firestore, consulta la pagina relativa alla scelta tra la modalità nativa 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 Ruby su App Engine per configurare il tuo ambiente e il tuo progetto e per comprendere come sono strutturate le app Ruby in App Engine. Annota e salva l'ID progetto, perché ti servirà per eseguire l'applicazione di esempio descritta in questo documento.
Clonare il repository
Scarica (clona) il campione:
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
cd ruby-docs-samples/appengine/datastore
Modifica la configurazione del progetto e imposta le dipendenze
In Gemfile
, includi la libreria google-cloud
, che ha le funzioni
per la modalità Datastore.
Codice dell'applicazione
L'applicazione di esempio registra, recupera e visualizza gli indirizzi IP dei visitatori. Come puoi notare, una voce di log è una semplice classe a due campi che riceve il tipo visit
e viene salvata in modalità Datastore utilizzando il comando save. Successivamente, le dieci visite più recenti vengono recuperate in ordine decrescente utilizzando il comando run del set di dati.
index.yaml
file in uso
L'app di esempio esegue semplici query. Le query più elaborate in modalità Datastore richiedono
uno o più indici, che devono essere specificati
in un file index.yaml
che si carica insieme all'app. Questo file può essere creato manualmente o
generato automaticamente durante il test dell'app in 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, tra cui ottimizzazioni e concetti, consulta la documentazione di Cloud Firestore in modalità Datastore.