Questa pagina fornisce un breve esercizio per creare una riga di comando Applicazione TaskList con l'API Firestore in modalità Datastore. L'ApplicationList archivia, elenca, aggiorna e rimuove le attività.
Prerequisiti
- Capacità di scrivere ed eseguire un'applicazione a riga di comando nei linguaggi di programmazione usati in questo argomento
Oltre ad avere una conoscenza di base su come sviluppare applicazioni, dovresti essere in grado di scaricare e installare altre librerie prima durante 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 API Datastore abilitata. Questo progetto fornisce le credenziali di autenticazione utilizzare nella tua applicazione per identificarla a Google e autorizzarne l'uso l'API in modalità Datastore.
Segui queste istruzioni per creare un progetto e attivare la modalità Datastore e configurare l'ambiente di sviluppo locale con l'autenticazione le credenziali utilizzando il comandogcloud auth login
. Prendi nota delle l'ID progetto, che utilizzerai più avanti.
Installazione e configurazione
Installa le librerie client e configura eventuali impostazioni aggiuntive per il tuo di sviluppo software.
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 tasto destro del mouse su TaskList. progetto 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 tuo del progetto Google Cloud nella casella Argomenti riga di comando:.
Fai clic su File e poi su Salva per salvare le modifiche.
Esegui l'applicazione. Premi F5 sulla tastiera.
Vai
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
Al fine di effettuare richieste autenticate alle API di Google Cloud utilizzando il client delle API di Google. librerie, 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 API Cloud Datastore C# documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Go documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Java documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Node.js documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore PHP documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Python documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Ruby documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Archiviazione dei dati
Gli oggetti in modalità Datastore sono noti come entità e ogni entità fa parte di un
kind specifico. L'applicazione TaskList archivierà 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'Task
con valori per le proprietà precedentemente elencate:
C#
Per informazioni su come installare e utilizzare la libreria client per Cloud Datastore, consulta Librerie client di Cloud Datastore. Per ulteriori informazioni, consulta API Cloud Datastore C# documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Go documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Java documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Node.js documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore PHP documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Python documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Ruby documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Per questa domanda, forniamo anche un metodo per aggiornare done
, per indicare che l'attività è 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 API Cloud Datastore C# documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Go documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Java documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Node.js documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore PHP documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Python documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Ruby documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore C# documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Go documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Java documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Node.js documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore PHP documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Python documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Ruby documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Esecuzione di una query
Oltre a recuperare le entità dalla modalità Datastore direttamente dalle rispettive chiavi, può eseguire una query per recuperarli in base ai valori 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 i tipi con proprietà corrispondenti a una valore
- Zero o più ordinamenti per sequenziare i risultati
Per questa applicazione, eseguiremo query in modalità Datastore per Task
entità ordinate per
data e ora 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 API Cloud Datastore C# documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Go documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Java documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Node.js documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore PHP documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Python documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Datastore Ruby documentazione di riferimento.
Per eseguire l'autenticazione in Cloud Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Passaggi successivi
Questo tutorial illustra solo i passaggi basilari necessari per effettuare chiamate al API in modalità Datastore da un'applicazione a riga di comando. La modalità Datastore supporta transazioni ACID altamente scalabili, query di tipo SQL, indici e altro ancora.
- Per uno sguardo più approfondito sulle funzionalità della modalità Datastore, consulta Che cos'è Firestore in modalità Datastore?
- Per informazioni sull'utilizzo dell'emulatore di modalità Datastore durante lo sviluppo del tuo vedi Emulatore di modalità Datastore.