Utilizzo di Cloud Firestore in modalità Datastore

Firestore è un database di documenti NoSQL creato per la scalabilità automatica. elevate prestazioni e facilità di sviluppo delle applicazioni. È la versione più recente di Datastore e introduce diversi miglioramenti rispetto a Datastore.

Poiché Firestore in modalità Datastore è ottimizzato per i casi d'uso dei server e per App Engine, 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 di notifiche mobile e in tempo reale. Per ulteriori informazioni Per le modalità di Firestore, consulta Scegliere tra la modalità Native e modalità Datastore.

Utilizzo della modalità Datastore con App Engine

Per utilizzare la modalità Datastore con App Engine:

  1. Se non l'hai ancora fatto, crea un database e scegli Firestore in modalità Datastore.

    Puoi utilizzare i database Datastore esistenti con le app App Engine. Per questi database esistenti verrà eseguito automaticamente l'upgrade a Firestore in modalità Datastore.

    1. Nell'app, dichiara Datastore come dipendenza utilizzando il comando go get cloud.google.com/go/datastore. In alternativa, puoi dichiarare le dipendenze nel file go.mod dell'app. Scopri di più sulla specifica delle dipendenze.

    2. Utilizza la libreria client Google Cloud per leggere e scrivere entità e per eseguire query sui dati.

    Configurazione degli indici

    La modalità Datastore utilizza indici per ogni query eseguita dalla tua applicazione. Gli indici vengono aggiornati ogni volta che cambia l'entità, in modo che i risultati possano essere restituiti rapidamente quando l'app query.

    La modalità Datastore crea automaticamente indici a proprietà singola da utilizzare con tipi di query semplici. Per query complesse che includono più proprietà, devi configurare gli indici composti nel file index.yaml dell'app.

    Il server di sviluppo App Engine aggiornerà il file index.yaml con gli indici composti necessari per eseguire i test. Analogamente, L'emulatore di modalità Datastore può generare indici quando esegui i test.

    Puoi anche aggiungere gli indici al file index.yaml della tua app manualmente se non esegui test locali o se i tuoi test non includono query complesse.

    Impostazione delle autorizzazioni del database

    Per impostazione predefinita, l'app dispone di tutte le autorizzazioni necessarie per leggere e scrivere su modalità Datastore e database Firestore progetto Google Cloud.

    Per gestire queste autorizzazioni, ogni app di App Engine utilizza un servizio predefinito account. che fornisce accesso completo in lettura e scrittura alla modalità Datastore e Firestore nello stesso progetto dell'app. Puoi modifica le autorizzazioni del servizio predefinito , ma la tua app potrebbe perdere l'accesso se non assegni un ruolo IAM con autorizzazioni richieste.

    Per informazioni su come consentire ad altri utenti, app o progetti di accedere a un database, consulta Accesso al database.

    Utilizzo dell'emulatore in modalità Datastore per i test locali

    Google Cloud CLI include un emulatore locale dell'ambiente di produzione con modalità Datastore. Puoi utilizzare l'emulatore per sviluppare e testare l'applicazione localmente. Inoltre, l'emulatore può aiutarti a generare indici per l'istanza in produzione in modalità Datastore ed eliminare gli indici non necessari.

    Se utilizzi il server di sviluppo locale di App Engine per testare la tua app, puoi assicurarti che il server utilizzi l'emulatore della modalità Datastore impostando il flag --support_datastore_emulator=true all'avvio del server.

    Se utilizzi l'emulatore in modalità Datastore, dev_appserver mostrerà:

    ... Using Cloud Datastore Emulator.
    

    Prezzi, quote e limiti

    La modalità Datastore offre una quota gratuita con limiti giornalieri. A pagamento offrono spazio di archiviazione illimitato, operazioni di lettura e scrittura. Ulteriori informazioni è disponibile nella pagina Quote di Datastore.