Utilizzare Firestore in modalità Datastore (Datastore)
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Firestore è un database di documenti NoSQL creato per offrire scalabilità automatica,
prestazioni elevate e facilità di sviluppo delle applicazioni. È la versione più recente
di Datastore e introduce diversi miglioramenti rispetto a
Datastore.
Poiché Firestore in modalità Datastore (Datastore) è ottimizzato per i casi d'uso del server e per App Engine, ti consigliamo di utilizzare 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 mobili e in tempo reale. Per ulteriori informazioni sulle modalità di Firestore, consulta la sezione Scegliere tra la modalità Native e la modalità Datastore.
Questo documento descrive come utilizzare le
librerie client Cloud per archiviare e
recuperare dati in un database in modalità Datastore.
Prerequisiti e configurazione
Configura il tuo ambiente e il tuo progetto per capire come sono strutturate le app in App Engine. Annota e salva l'ID progetto, perché ti servirà per eseguire l'applicazione di esempio descritta in questo documento.
Clona il repository
Scarica (clona) l'esempio:
Modifica la configurazione del progetto e imposta le dipendenze
Codice dell'applicazione
Utilizzo di file index.yaml
L'app di esempio esegue query. Le query in modalità Datastore più elaborate richiedono uno o più indici, che devi specificare in un file index.yaml che carichi insieme alla tua app. Questo file può essere creato manualmente o generato automaticamente durante il test dell'app in locale.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eFirestore in Datastore mode is a NoSQL document database optimized for server use cases and App Engine, making it ideal for applications primarily used within App Engine.\u003c/p\u003e\n"],["\u003cp\u003eFirestore in Native mode is better suited for mobile applications and those requiring real-time notifications, offering a different set of functionalities compared to Datastore mode.\u003c/p\u003e\n"],["\u003cp\u003eUsing Datastore mode queries often requires defining indexes in an \u003ccode\u003eindex.yaml\u003c/code\u003e file, which can be created manually or generated automatically during local testing of your application.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the Datastore mode emulator for local development and testing of applications, allowing for a simulated environment before deployment.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive information on Datastore mode, including optimizations and core concepts, can be found in the Firestore in Datastore mode documentation.\u003c/p\u003e\n"]]],[],null,["# Use Firestore in Datastore mode (Datastore)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nGo Java Node.js PHP Python Ruby .NET Custom\n\nFirestore is a NoSQL document database built for automatic scaling,\nhigh performance, and ease of application development. It is the newest version\nof Datastore and introduces several improvements over\nDatastore.\nBecause [Firestore in Datastore mode (Datastore)](/datastore/docs)\nis optimized for server use cases and for App Engine, we recommend using\nDatastore for databases that will be used primarily by\nApp Engine apps. Firestore in Native mode is most useful for\nmobile and real-time notification use cases. For more information about\nFirestore modes, see [Choosing between Native Mode and\nDatastore mode](/datastore/docs/firestore-or-datastore).\n\nThis document describes how to use the\n[Cloud Client Libraries](/datastore/docs/reference/libraries) to store and\nretrieve data in a Datastore mode database.\n\nPrerequisites and setup\n-----------------------\n\n- [Set up your environment and project](/appengine/docs/flexible/setting-up-environment) to understand how apps are structured in App Engine. Write down and save your project ID, because you will need it to run the sample application described in this document.\n\nClone the repository\n--------------------\n\nDownload (clone) the sample:\n\n\u003cbr /\u003e\n\nEdit project configuration and set dependencies\n-----------------------------------------------\n\n\u003cbr /\u003e\n\nApplication code\n----------------\n\n\nUsing `index.yaml` files\n------------------------\n\nThe sample app performs queries. More elaborate Datastore mode queries require one or more [indexes](/datastore/docs/concepts/indexes), which you must specify in an [`index.yaml` file](/appengine/docs/flexible/configuring-datastore-indexes-with-index-yaml) that you upload along with your app. This file may be created manually, or generated automatically while testing your app locally.\n\nLocal testing\n-------------\n\nIf you need to develop and test your application locally, you can [use the\nDatastore mode emulator](/datastore/docs/tools/datastore-emulator).\n\nFor more information\n--------------------\n\nFor complete information on Datastore mode, including\noptimizations and concepts, see the\n[Firestore in Datastore mode documentation](/datastore/docs/overview)."]]