Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Archivia ed esegui query sui dati in Firestore in modalità Datastore
Questa pagina mostra come archiviare ed eseguire query sui dati in Firestore in modalità Datastore utilizzando la console Google Cloud .
Prima di iniziare
Sign in to your Google Cloud account. If you're new to
Google Cloud,
create an account to evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Se non sei il proprietario del progetto, il tuo account richiede le seguenti autorizzazioni per completare questa guida rapida:
Il tuo account richiede il
ruolo Proprietario Datastore
che contiene l'autorizzazione datastore.databases.create
necessaria per creare un'istanza in modalità Datastore.
La modalità Datastore richiede un'applicazione App Engine attiva.
Se il progetto non ha un'applicazione, questa guida rapida ne crea una per te. In questo caso, devi avere l'autorizzazione
appengine.applications.create. Il proprietario del progetto
può assegnare questa autorizzazione con un
ruolo personalizzato IAM.
Crea un database
Per creare una nuova istanza di database, apri la sezione Datastore
nella console Google Cloud : Vai alla pagina Datastore
Seleziona una modalità di database.
Quando crei un nuovo database Firestore, hai la possibilità di utilizzare
Firestore in modalità nativa o modalità Datastore. Non puoi utilizzare entrambi
i modi nello stesso progetto.
Seleziona una delle opzioni del database:
Firestore in modalità Native
Consigliata per app web e mobile. Per iniziare a utilizzare Firestore, continua con la guida rapida di Firestore.
Firestore in modalità Datastore
Opzione consigliata per le architetture delle app con server di backend.
Seleziona una posizione del database. La modalità Datastore supporta località
multiregionali e regionali.
Una località multiregionale massimizza la disponibilità e la durabilità. Le località
regionali offrono una latenza di scrittura inferiore. Per scoprire di più sui tipi di località,
consulta Località della modalità Datastore.
La località si applica sia ai database in modalità Datastore sia alle app App Engine per il tuo Google Cloud progetto.
Fai clic su Crea database. Al termine dell'inizializzazione del database, la
consoleGoogle Cloud ti indirizza alla pagina Entità Datastore.
Archiviare dati
Vai alla pagina Entità Datastore nella console Google Cloud .
Questa pagina ti consente di archiviare, interrogare, aggiornare ed eliminare i dati.
Fai clic su Crea entità.
Nella pagina Crea un'entità, utilizza [default] per Spazio dei nomi.
Digita Task nel campo Tipo. Lascia il campo Identificatore chiave impostato sul valore predefinito di Numeric ID (auto-generated).
Nella sezione Proprietà, utilizza il pulsante Aggiungi proprietà per aggiungere queste proprietà:
Nome
Tipo
Valore
Indicizzato
descrizione
Stringa
Scopri di più su Datastore.
creato
Data e ora
(data odierna)
✓
fine
Booleano
Falso
✓
La pagina della creazione dovrebbe ora avere il seguente aspetto:
Fai clic su Crea. Nella console viene visualizzata l'entità Task che hai appena creato.
Hai appena archiviato i dati nel database.
Esegui una query
I database in modalità Datastore supportano l'esecuzione di query sui dati per tipo o tramite
Google Query Language (GQL). Le istruzioni riportate di seguito ti guidano nell'utilizzo di entrambi
per eseguire query sul database.
Esegui query per tipo
Fai clic su Query per tipo.
Seleziona Task come tipo.
I risultati della query mostrano l'entità Task che hai creato.
Successivamente, aggiungi una clausola di query per limitare i risultati alle entità che soddisfano criteri specifici:
Fai clic su Aggiungi clausola di query.
Negli elenchi a discesa, seleziona WHERE, done, ==, booleano e
false.
Fai clic su Esegui. I risultati mostrano l'entità Task che hai
creato perché il suo valore done è false.
Ora modifica la clausola di query in WHERE, done, ==, booleano e
true. Fai clic su Esegui. I risultati non includono l'entità Task che hai
creato, perché il suo valore done non è true.
Esegui query GQL
Fai clic su Query per GQL.
Inserisci SELECT * FROM Task come query. Tieni presente che Task è sensibile alle maiuscole.
Fai clic su Esegui query.
I risultati della query mostrano l'entità Task che hai creato.
Aggiungi un filtro query per limitare i risultati alle entità che soddisfano
criteri specifici:
Esegui una query come SELECT * FROM Task WHERE done=false. Tieni presente che Task
e done sono sensibili alle maiuscole.
I risultati mostrano l'entità Task che hai creato, poiché il suo valore done è false.
Ora esegui una query come SELECT * FROM Task WHERE done=true. I risultati non includono l'entità Task che hai creato, perché il suo valore done non è true.
Esegui la pulizia
Fai clic su Query per tipo e assicurati che Task sia il tipo selezionato.
Fai clic su Cancella per rimuovere eventuali clausole di query.
Seleziona l'entità Task che hai creato.
Fai clic su Elimina e poi conferma che vuoi eliminare l'entità Task.
A seconda delle dimensioni della finestra del browser, l'opzione Elimina potrebbe trovarsi nel menu Altre azionimore_vert. Una volta
eliminata, l'entità viene rimossa definitivamente dal database.
[[["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-05 UTC."],[[["\u003cp\u003eThis guide demonstrates how to use the Google Cloud console to store and query data in Firestore's Datastore mode.\u003c/p\u003e\n"],["\u003cp\u003eCreating a Datastore mode instance requires the Datastore Owner role and an active App Engine application, or the \u003ccode\u003eappengine.applications.create\u003c/code\u003e permission.\u003c/p\u003e\n"],["\u003cp\u003eDatastore mode offers multi-region or regional locations, and once set, the database location cannot be changed.\u003c/p\u003e\n"],["\u003cp\u003eData can be stored as entities with properties (name, type, value), and the guide uses a \u003ccode\u003eTask\u003c/code\u003e entity example.\u003c/p\u003e\n"],["\u003cp\u003eData in Datastore can be queried by kind or using Google Query Language (GQL), with support for filtering results based on specific criteria.\u003c/p\u003e\n"]]],[],null,["# Quickstart: Store and query data in Firestore in Datastore mode\n\nStore and query data in Firestore in Datastore mode\n===================================================\n\nThis page shows you how to store and query data in Firestore in Datastore mode using the Google Cloud console.\n\nBefore you begin\n----------------\n\n- Sign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n\n If you are **not** the project owner, your account requires the\n following permissions to complete this quickstart:\n\n\n - Your account requires the [**Datastore Owner** role](/iam/docs/understanding-roles#cloud_datastore_roles) which contains the `datastore.databases.create` permission needed to create a Datastore mode instance.\n - Datastore mode requires an active App Engine application. If the project doesn't have an application, this quickstart creates one for you. In that case, you require the `appengine.applications.create` permission. The project owner can assign this permission with an [IAM custom role](/iam/docs/creating-custom-roles).\n\nCreate a database\n-----------------\n\n1. To create a new database instance, open the Datastore section\n in the Google Cloud console: \n\n [Go to the Datastore page](https://console.cloud.google.com/datastore/welcome)\n\n2. Select a database mode.\n\n When you create a new Firestore database, you have the option to use\n Firestore in either Native Mode or Datastore mode. You can't use both\n modes in the same project.\n\n Select from one of the database options:\n - **Firestore in Native Mode**\n\n Recommended for mobile and web apps. To get started with Firestore, continue in the [Firestore Quickstart](/firestore/docs/quickstart).\n - **Firestore in Datastore Mode**\n\n Recommended for app architectures with backend servers.\n\n For more guidance on selecting a database mode and for a feature-by-feature\n comparison, see\n [choosing between Native Mode and Datastore Mode](/datastore/docs/firestore-or-datastore).\n3. Select a database location. Datastore mode supports multi-region\n and regional locations.\n\n A multi-region location maximizes availability and durability. Regional\n locations offer lower write latency. To learn more about location types,\n see [Datastore mode locations](/datastore/docs/locations).\n The location applies to both Datastore mode databases and App Engine apps for\n your Google Cloud project.\n | **Warning:** Once you create your database, you cannot change the location.\n\n Click **Create database**. After your database finishes initializing, the\n Google Cloud console directs you to the Datastore Entities page.\n\nStore data\n----------\n\n1. Go to the Datastore Entities page in the Google Cloud console.\n\n [Go to the Entities page](https://console.cloud.google.com/datastore/entities/query)\n\n This page lets you store, query, update, and delete data.\n2. Click **Create entity**.\n\n3. On the **Create an entity** page, use `[default]` for **Namespace**.\n\n4. Type `Task` in the **Kind** field. Leave **Key identifier** set to the\n default value of `Numeric ID (auto-generated)`.\n\n5. Under **Properties** , use the **Add property** button to add these properties:\n\n Your creation page should now look like this:\n\n \u003cbr /\u003e\n\n6. Click **Create** . The console displays the `Task` entity that you just created.\n\nYou just stored data in your database!\n\nRun a query\n-----------\n\nDatastore mode databases support querying data by kind or by\nGoogle Query Language (GQL). The instructions below walk you through using both\nto query your database.\n\n### Run kind queries\n\n1. Click **Query by kind**.\n2. Select `Task` as the kind.\n\nThe query results show the `Task` entity that you created.\n\nNext, add a query clause to restrict the results to entities that meet specific\ncriteria:\n\n1. Click **Add query clause**.\n2. In the dropdown lists, select `WHERE`, `done`, `==`, **boolean** , and **false**.\n3. Click **Run** . The results show the `Task` entity that you created since its `done` value is `false`.\n4. Now change the query clause to `WHERE`, `done`, `==`, **boolean** , and **true** . Click **Run** . The results do not include the `Task` entity that you created, because its `done` value is not `true`.\n\n### Run GQL queries\n\n1. Click **Query by GQL**.\n2. Enter `SELECT * FROM Task` as the query. Note that `Task` is case sensitive.\n3. Click **Run query**.\n\nThe query results show the `Task` entity that you created.\n| **Tip**\n|\n| The GQL query editor supports autocompletion for kinds: When you\n| need to type a kind name, press Ctrl+Space to see a list of the available\n| kinds. Up to 300 alphabetically sorted kinds can appear in the list. For\n| better matches of kinds, type one or more characters.\n\nAdd a query filter to restrict the results to entities that meet\nspecific criteria:\n\n1. Run a query such as `SELECT * FROM Task WHERE done=false`. Note that `Task` and `done` are case sensitive. The results show the `Task` entity that you created, since its `done` value is `false`.\n2. Now run a query such as `SELECT * FROM Task WHERE done=true`. The results do not include the `Task` entity that you created, because its `done` value is not `true`.\n\nClean up\n--------\n\n1. Click **Query by kind** and ensure `Task` is the selected kind.\n2. Click **Clear** to remove any query clauses.\n3. Select the `Task` entity that you created.\n4. Click **Delete** , and then confirm you want to delete the `Task` entity. Depending on the size of the browser window, **Delete** might be under the more_vert **More actions** menu. Once deleted, the entity is permanently removed from your database.\n\nThat's it, you completed this quickstart!\n\nWhat's next\n-----------\n\n- Learn more about [Datastore Queries](/datastore/docs/concepts/queries).\n- Learn more about [Datastore mode](/datastore/docs) databases.\n\n\u003cbr /\u003e"]]
