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 Un saluto da Google, World! per Go su App Engine per configurare l'ambiente e il progetto, nonché per comprendere la struttura delle app Go 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:
go get -d -v github.com/GoogleCloudPlatform/golang-samples/datastore
cd $GOPATH/src/github.com/GoogleCloudPlatform/golang-samples/appengine_flexible/datastore
Modifica la configurazione del progetto e imposta le dipendenze
In app.yaml
, imposta GCLOUD_DATASET_ID
per il tuo progetto. Questo valore è
l'ID progetto.
Codice dell'applicazione
L'applicazione di esempio registra, recupera e visualizza gli indirizzi IP dei visitatori. Puoi notare
che una voce di log è una semplice classe a due campi che riceve il tipo visit
,
e viene salvata in modalità Datastore utilizzando il comando
put
del client di Datastore. Quindi, le dieci visite più recenti vengono recuperate in ordine decrescente in base ai comandi
NewQuery
e
GetAll
del client Datastore.
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.