Questa pagina fornisce un breve esercizio sulla creazione di un'applicazione TasksList a riga di comando con l'API Firestore in modalità Datastore. L'applicazione TaskList archivia, elenca, aggiorna e rimuove le attività.
Prerequisiti
- Capacità di scrivere ed eseguire un'applicazione a riga di comando nei linguaggi di programmazione utilizzati in questo argomento
Oltre a una conoscenza di base su come sviluppare applicazioni, dovresti essere in grado di scaricare e installare librerie aggiuntive prima di provare questo tutorial. - Un progetto Google Cloud con l'API in modalità Datastore abilitata
Le applicazioni che utilizzano la modalità Datastore sono associate a un progetto Google Cloud con l'API in modalità Datastore abilitata. Questo progetto fornisce le credenziali di autenticazione che utilizzi nell'applicazione per identificarlo a Google e autorizzarne l'utilizzo dell'API in modalità Datastore.
Segui queste istruzioni per creare un progetto, abilitare la relativa API in modalità Datastore e configurare l'ambiente di sviluppo locale con le credenziali di autenticazione utilizzando il comandogcloud auth login
. Prendi nota dell'ID del progetto, che utilizzerai più avanti.
Installazione e configurazione
Installare le librerie client e configurare eventuali impostazioni aggiuntive per l'ambiente di sviluppo.
C#
- Assicurati di aver installato Visual Studio (versione 2013 o successive).
- Scarica l'applicazione di esempio TaskList dal repository di esempi.
- Estrai i file dallo zip e spostali in una directory all'interno della cartella Documenti.
- In Visual Studio, apri il file
dotnet-docs-samples-master\datastore\api\Datastore.sln
. - Nella finestra Esplora soluzioni di Visual Studio, fai clic con il pulsante destro del mouse sul progetto TaskList e scegli Imposta come progetto di avvio.
- Fai di nuovo clic con il pulsante destro del mouse sul progetto TaskList e scegli Proprietà.
Nella finestra Proprietà, fai clic su Debug e digita l'ID del progetto Google Cloud nella casella Argomenti della riga di comando:.
Fai clic su File e poi su Salva per salvare le modifiche.
Esegui l'applicazione. Premi F5 sulla tastiera.
Go
Clona l'applicazione di esempio TaskList.
go get github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
Cambia la directory in cui hai clonato l'esempio:
cd $GOPATH/src/github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
A un prompt dei comandi, esegui quanto segue, dove
<project-id>
è l'ID del tuo progetto Google Cloud.export DATASTORE_PROJECT_ID=<project-id>
(Utenti di Windows: utilizza
set
anzichéexport
.)Esegui l'applicazione.
go run tasks.go
Java
Assicurati di avere installato Maven e Java (versione 8 o successive).
Scarica l'applicazione di esempio TaskList dal repository di esempi.
A un prompt dei comandi, estrai il download:
unzip main.zip
Cambia directory nell'applicazione TaskList:
cd java-datastore-main/samples/snippets
Esegui il comando riportato di seguito, dove
<project-id>
è l'ID del tuo progetto Google Cloud.gcloud config set project <project-id>
Compila ed esegui l'applicazione.
mvn clean compile mvn exec:java -Dexec.mainClass="com.google.datastore.snippets.TaskList"
Node.js
Scarica l'applicazione di esempio TaskList dal repository di esempi.
Estrai il download:
unzip master.zip
Cambia directory nell'applicazione TaskList:
cd nodejs-datastore-master/samples
Installa le dipendenze e collega l'applicazione:
npm install
A un prompt dei comandi, esegui quanto segue, dove
<project-id>
è l'ID del tuo progetto Google Cloud.export GCLOUD_PROJECT=<project-id>
(Utenti di Windows: utilizza
set
anzichéexport
.)Esegui l'applicazione.
node tasks.js
PHP
- Assicurati di avere installato PHP (versione 5.6 o successive) e Composer.
- Scarica l'applicazione di esempio TaskList dal repository di esempi.
Estrai il download:
unzip master.zip
Cambia directory nell'applicazione TaskList:
cd php-docs-samples-master/datastore/tutorial
Installare le dipendenze.
composer install
Esegui l'applicazione.
php src/list_tasks.php
Python
- Assicurati di avere installato Python (versione 2.7.9 o successive), pip e virtualenv.
Attiva una sessione
virtualenv
.virtualenv venv source venv/bin/activate
Scarica l'applicazione di esempio TaskList dal repository di esempi.
Estrai il download:
unzip master.zip
Cambia directory nell'applicazione TaskList:
cd python-docs-samples-master/datastore/cloud-client
Installa le dipendenze:
pip install -r requirements.txt
Esegui l'applicazione. Utilizza l'ID del tuo progetto Google Cloud per
<project-id>
.python tasks.py new project-id
Ruby
Scarica l'applicazione di esempio TaskList dal repository di esempi.
Estrai il download:
unzip master.zip
Cambia directory nell'applicazione TaskList:
cd google-cloud-ruby-master/google-cloud-datastore/samples
Installa le dipendenze:
bundle install
A un prompt dei comandi, esegui quanto segue, dove
<project-id>
è l'ID del tuo progetto Google Cloud.export GOOGLE_CLOUD_PROJECT=<project-id>
(Utenti di Windows: utilizza
set
anzichéexport
.)Esegui l'applicazione.
bundle exec ruby tasks.rb
Creazione di un oggetto di servizio autorizzato
Per effettuare richieste autenticate alle API di Google Cloud utilizzando le librerie client delle API di Google, devi:
- Recupera la credenziale da utilizzare per le richieste.
- Creare un oggetto di servizio che utilizzi questa credenziale.
Quindi puoi effettuare chiamate API richiamando metodi sull'oggetto di servizio in modalità Datastore.
Per questo esempio, recupererai le credenziali predefinite dell'applicazione dall'ambiente e le passerai come argomento per creare l'oggetto di servizio.
Ecco la chiamata per creare l'oggetto di servizio autorizzato in modalità Datastore:
C#
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Archiviazione dei dati
Gli oggetti in modalità Datastore sono noti come entità e ogni entità è di un
determinato tipo. L'applicazione TaskList memorizzerà entità di tipo Task
, con le seguenti proprietà:
description
: una stringa specificata dall'utente come descrizione dell'attivitàcreated
: una data che mostra la data di creazione iniziale dell'attivitàdone
: un valore booleano che indica se l'attività è stata completata
Quando l'utente aggiunge una nuova attività, l'applicazione TaskList crea un'entità Task
con i valori per le proprietà elencate in precedenza:
C#
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per questa applicazione, forniamo anche un metodo per aggiornare la proprietà done
, per indicare che l'attività è stata completata:
C#
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ecco il metodo per eliminare un'entità Task
, utilizzando la chiave dell'entità Task
:
C#
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Esecuzione di una query
Oltre a recuperare le entità dalla modalità Datastore direttamente tramite le rispettive chiavi, un'applicazione può eseguire una query per recuperarle in base ai valori delle relative proprietà. Una query tipica include quanto segue:
- Un tipo di entità a cui si applica la query
- Zero o più filtri, ad esempio per selezionare tipi con proprietà corrispondenti a un valore
- Zero o più ordinamenti per sequenziare i risultati
Per questa applicazione, eseguiremo una query in modalità Datastore per Task
entità ordinate in base alla data di creazione:
C#
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Datastore.
Per eseguire l'autenticazione su Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Passaggi successivi
Questo tutorial illustra solo i passaggi di base necessari per effettuare chiamate all'API in modalità Datastore da un'applicazione a riga di comando. La modalità Datastore supporta transazioni ACID rapide e altamente scalabili, query di tipo SQL, indici e altro ancora.
- Per una panoramica più approfondita delle funzionalità della modalità Datastore, consulta Che cos'è Firestore in modalità Datastore?.
- Per informazioni sull'utilizzo dell'emulatore di modalità Datastore durante lo sviluppo dell'applicazione, consulta Emulatore di modalità Datastore.