Archivia ed esegui query sui dati in Firestore in modalità Datastore

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.

  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.

  Go to project selector

• In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

  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.

  Go to project selector

• Se non sei il proprietario del progetto, il tuo account richiede le seguenti autorizzazioni per completare questa guida introduttiva:

  • Il tuo account richiede il ruolo Proprietario di 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 introduttiva ne crea una per te. In questo caso, devi disporre dell'autorizzazione appengine.applications.create. Il proprietario del progetto può assegnare questa autorizzazione con un ruolo personalizzato IAM.

Crea un database

1. Per creare una nuova istanza di database, apri la sezione Datastore nella console Google Cloud:
   Vai alla pagina Datastore

2. Seleziona una modalità di database.

   Quando crei un nuovo database Firestore, hai la possibilità di utilizzare Firestore in modalità nativa o in modalità Datastore. Non puoi utilizzare entrambe le modalità nello stesso progetto.

   Seleziona una delle opzioni di database:

   • Firestore in modalità nativa

     Consigliata per app mobile e web. Per iniziare a utilizzare Firestore, continua con la guida rapida di Firestore.

   • Firestore in modalità Datastore

     Consigliata per le architetture di app con server di backend.

   Per ulteriori indicazioni sulla selezione di una modalità di database e per un confronto dettagliato delle funzionalità, consulta la sezione Scegliere tra la modalità Native e la modalità Datastore.

3. Seleziona una posizione del database. La modalità Datastore supporta località regionali e multiregionali.

   Una località con più regioni 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à in modalità Datastore. La posizione si applica sia ai database in modalità Datastore sia alle app App Engine per il tuo progetto Google Cloud.

   Avviso: una volta creato il database, non puoi modificarne la posizione.

   Fai clic su Crea database. Al termine dell'inizializzazione del database, la console Google Cloud ti reindirizza alla pagina Entità Datastore.

Archiviare dati

1. Vai alla pagina Entità Datastore nella console Google Cloud.

   Vai alla pagina Entità

   Questa pagina ti consente di archiviare, eseguire query, aggiornare ed eliminare i dati.

2. Fai clic su Crea entità.

3. Nella pagina Crea un'entità, utilizza [default] per Spazio dei nomi.

4. Digita Task nel campo Tipo. Lascia Identificatore chiave impostato sul valore predefinito Numeric ID (auto-generated).

5. In Proprietà, utilizza il pulsante Aggiungi proprietà per aggiungere le seguenti proprietà:

   Nome	Tipo	Valore	Indicizzato
   description	Stringa	Scopri di più su Datastore.
   creato	Data e ora	(data odierna)	✓
   fine	Booleano	Falso	✓

   La pagina della creazione dovrebbe avere il seguente aspetto:

   

6. Fai clic su Crea. Nella console viene visualizzata l'entità Task che hai appena creato.

Hai appena archiviato i dati nel tuo database.

esegui una query

I database in modalità Datastore supportano l'esecuzione di query sui dati per tipo o per linguaggio Google Query Language (GQL). Le istruzioni riportate di seguito illustrano come utilizzare entrambi per eseguire query sul database.

Esegui query sui tipi

1. Fai clic su Query per tipo.
2. Seleziona Task come tipo.

I risultati della query mostrano l'entità Task che hai creato.

Aggiungi una clausola di query per limitare i risultati alle entità che soddisfano criteri specifici:

1. Fai clic su Aggiungi clausola di query.
2. Negli elenchi a discesa, seleziona WHERE, done, ==, booleano e false.
3. Fai clic su Esegui. I risultati mostrano l'entità Task che hai creato poiché il suo valore done è false.
4. Ora modifica la clausola di query in WHERE, done, ==, boolean e true. Fai clic su Esegui. I risultati non includono l'entità Task che hai creato, perché il relativo valore done non è true.

Esegui query GQL

1. Fai clic su Query per GQL.
2. Inserisci SELECT * FROM Task come query. Tieni presente che Task è sensibile alle maiuscole.
3. Fai clic su Esegui query.

I risultati della query mostrano l'entità Task che hai creato.

Suggerimento

L'editor di query GQL supporta il completamento automatico per i tipi: quando devi digitare il nome di un tipo, premi Ctrl+Barra spaziatrice per visualizzare un elenco dei tipi disponibili. Nell'elenco possono essere visualizzati fino a 300 tipi in ordine alfabetico. Per una migliore corrispondenza dei tipi, digita uno o più caratteri.

Aggiungi un filtro della query per limitare i risultati alle entità che soddisfano criteri specifici:

1. 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 valore done è false.
2. Ora esegui una query come SELECT * FROM Task WHERE done=true. I risultati non includono l'entità Task che hai creato, perché il valore done non è true.

Esegui la pulizia

1. Fai clic su Esegui query per tipo e assicurati che Task sia il tipo selezionato.
2. Fai clic su Cancella per rimuovere eventuali clausole di query.
3. Seleziona l'entità Task che hai creato.
4. Fai clic su Elimina e conferma di voler eliminare l'entità Task. A seconda delle dimensioni della finestra del browser, l'opzione Elimina potrebbe trovarsi nel menu Altre azioni. Una volta eliminata, l'entità viene rimossa definitivamente dal database.

È tutto, hai completato questa guida rapida.

Passaggi successivi

• Scopri di più sulle query Datastore.
• Scopri di più sui database in modalità Datastore.