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 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 automaticamente. In questo caso, devi avere l'autorizzazione appengine.applications.create. Il proprietario del progetto può assegnare questa autorizzazione con un ruolo IAM personalizzato.

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à Native o Datastore. Non puoi usare entrambe le modalità nello stesso progetto.

   Seleziona una delle opzioni di database:

   • Firestore in modalità nativa

     Opzione 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 di app con server di backend.

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

3. Seleziona una località del database. La modalità Datastore supporta località a più regioni e a livello di singola regione.

   Una località a più regioni massimizza la disponibilità e la durabilità. Le località a livello di regione offrono una latenza di scrittura inferiore. Per scoprire di più sui tipi di località, consulta Località in modalità Datastore. La località si applica sia ai database in modalità Datastore che alle app App Engine per il tuo progetto Google Cloud.

   Avviso: dopo aver creato il database, non puoi modificare la località.

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

Archiviare dati

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

   Vai alla pagina Entità

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

2. Fai clic su Crea entità.

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

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

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

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

   La pagina di creazione ora dovrebbe avere il seguente aspetto:

   

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

Hai appena archiviato dei dati nel tuo database.

esegui una query

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

Esegui query di tipo tipo

1. Fai clic su Esegui query per tipo.
2. Seleziona Task come tipo.

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

Quindi, aggiungi una clausola di query per limitare i risultati a entità che soddisfano criteri specifici:

1. Fai clic su Aggiungi clausola di query.
2. Negli elenchi a discesa, seleziona WHERE, done, ==, boolean e false.
3. Fai clic su Esegui. I risultati mostrano l'entità Task che hai creato perché il suo valore done è false.
4. Ora cambia 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 suo valore done non è true.

Esecuzione di query GQL

1. Fai clic su Query in base a GQL.
2. Inserisci SELECT * FROM Task come query. Tieni presente che Task fa distinzione tra maiuscole e minuscole.
3. Fai clic su Esegui query.

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

Suggerimento

L'editor di query di GQL supporta il completamento automatico per i tipi: quando devi digitare un nome di 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 migliori corrispondenze dei tipi, digita uno o più caratteri.

Aggiungi un filtro di query per limitare i risultati a entità che soddisfano criteri specifici:

1. Esegui una query, ad esempio SELECT * FROM Task WHERE done=false. Tieni presente che Task e done fanno distinzione tra maiuscole e minuscole. I risultati mostrano l'entità Task che hai creato, poiché il suo valore di 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 suo 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 poi conferma che vuoi eliminare l'entità Task. A seconda delle dimensioni della finestra del browser, l'opzione Elimina potrebbe trovarsi nel menu Altre azioni di . Una volta eliminata, l'entità viene rimossa definitivamente dal database.

È tutto. Hai completato questa guida rapida.

Passaggi successivi

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