Cette page propose un bref exercice pour créer une ligne de commande Application TaskList avec l'API Firestore en mode Datastore Cette application TaskList va permettre de stocker, répertorier, mettre à jour et supprimer des tâches.
Prérequis
- Capacité à écrire et à exécuter une application de ligne de commande dans les langages de programmation utilisés dans cet article
Avant de suivre ce tutoriel, outre une compréhension de base du développement d'applications, vous devez pouvoir télécharger et installer des bibliothèques supplémentaires. - Un projet Google Cloud avec l'API en mode Datastore activée
Les applications qui utilisent le mode Datastore sont associées à un projet Google Cloud avec l'API en mode Datastore activée. Ce projet fournit les identifiants d'authentification que vous employez dans votre application pour l'identifier auprès de Google et l'autoriser à utiliser l'API en mode Datastore.
Suivez ces instructions pour créer un projet, activer l'API en mode Datastore pour celui-ci, et définir des identifiants d'authentification pour votre environnement de développement local à l'aide de la commandegcloud auth login
. Notez l'ID du projet, car vous en aurez besoin ultérieurement.
Installation et configuration
Installez les bibliothèques clientes et configurez tout paramètre supplémentaire pour votre environnement de développement.
C#
- Assurez-vous que Visual Studio (version 2013 ou ultérieure) est installé.
- Téléchargez l'exemple d'application TaskList à partir du dépôt d'exemples.
- Extrayez les fichiers du fichier ZIP dans un répertoire de votre dossier Documents.
- Dans Visual Studio, ouvrez le fichier
dotnet-docs-samples-master\datastore\api\Datastore.sln
. - Dans la fenêtre Solution Explorer (Explorateur de solutions) de Visual Studio, effectuez un clic droit sur la liste de tâches TaskList (Liste de tâches). puis sélectionnez Set as StartUp Project (Définir comme projet de démarrage).
- Effectuez à nouveau un clic droit sur le projet TaskList, puis sélectionnez Propriétés.
Dans la fenêtre Properties (Propriétés), cliquez sur Debug (Débogage), puis saisissez l'ID de votre projet Google Cloud dans la zone Arguments de ligne de commande.
Cliquez sur Fichier, puis sur Enregistrer pour enregistrer les modifications.
Exécutez l'application. Appuyez sur la touche F5 de votre clavier.
Go
Clonez l'exemple d'application TaskList.
go get github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
Remplacez les répertoires par ceux dans lesquels vous avez cloné l'exemple :
cd $GOPATH/src/github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
À l'invite de commande, exécutez la commande suivante, où
<project-id>
correspond à l'ID de votre projet Google Cloud.export DATASTORE_PROJECT_ID=<project-id>
(Utilisateurs de Windows : utilisez
set
au lieu deexport
.)Exécutez l'application.
go run tasks.go
Java
Assurez-vous que Maven et Java (version 8 ou ultérieure) sont installés.
Téléchargez l'exemple d'application TaskList à partir du dépôt d'exemples.
À l'invite de commande, extrayez le téléchargement :
unzip main.zip
Modifiez les répertoires pour qu'ils pointent vers l'application TaskList :
cd java-datastore-main/samples/snippets
Exécutez la commande suivante, où
<project-id>
correspond à l'ID de votre projet Google Cloud.gcloud config set project <project-id>
Compilez et exécutez l'application.
mvn clean compile mvn exec:java -Dexec.mainClass="com.google.datastore.snippets.TaskList"
Node.js
Préparez votre environnement pour un développement en Node.js.
Téléchargez l'exemple d'application TaskList à partir du dépôt d'exemples.
Extrayez le téléchargement:
unzip master.zip
Modifiez les répertoires pour qu'ils pointent vers l'application TaskList :
cd nodejs-datastore-master/samples
Installez les dépendances et associez l'application :
npm install
À l'invite de commande, exécutez la commande suivante, où
<project-id>
correspond à l'ID de votre projet Google Cloud.export GCLOUD_PROJECT=<project-id>
(Utilisateurs de Windows : utilisez
set
au lieu deexport
.)Exécutez l'application.
node tasks.js
PHP
- Assurez-vous que PHP (version 5.6 ou ultérieure) et Composer sont installés.
- Téléchargez l'exemple d'application TaskList à partir du dépôt d'exemples.
Extrayez le téléchargement:
unzip master.zip
Modifiez les répertoires pour qu'ils pointent vers l'application TaskList :
cd php-docs-samples-master/datastore/tutorial
Installez les dépendances.
composer install
Exécutez l'application.
php src/list_tasks.php
Python
- Assurez-vous que Python (version 2.7.9 ou ultérieure), pip et virtualenv sont installés.
Activez une session
virtualenv
.virtualenv venv source venv/bin/activate
Téléchargez l'exemple d'application TaskList à partir du dépôt d'exemples.
Extrayez le téléchargement:
unzip master.zip
Modifiez les répertoires pour qu'ils pointent vers l'application TaskList :
cd python-docs-samples-master/datastore/cloud-client
Installez les dépendances :
pip install -r requirements.txt
Exécutez l'application. Utilisez l'ID de votre projet Google Cloud pour
<project-id>
.python tasks.py new project-id
Ruby
Téléchargez l'exemple d'application TaskList à partir du dépôt d'exemples.
Extrayez le téléchargement:
unzip master.zip
Modifiez les répertoires pour qu'ils pointent vers l'application TaskList :
cd google-cloud-ruby-master/google-cloud-datastore/samples
Installez les dépendances :
bundle install
Lorsque l'invite de commande s'affiche, exécutez la commande suivante, où
<project-id>
correspond à l'ID de votre projet Google Cloud.export GOOGLE_CLOUD_PROJECT=<project-id>
(Utilisateurs de Windows : utilisez
set
au lieu deexport
.)Exécutez l'application.
bundle exec ruby tasks.rb
Créer un objet de service autorisé
Pour envoyer des requêtes authentifiées aux API Google Cloud à l'aide des bibliothèques clientes d'API Google, vous devez :
- extraire les identifiants à utiliser pour les requêtes ;
- créer un objet de service qui utilise ces identifiants.
Vous pouvez ensuite effectuer des appels d'API en appelant des méthodes sur l'objet de service en mode Datastore.
Dans cet exemple, vous allez extraire les identifiants par défaut de l'application de l'environnement, puis les transmettre en tant qu'argument pour créer l'objet de service.
Voici l'appel permettant de créer l'objet de service en mode Datastore autorisé :
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API C# Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore Go.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Java Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Node.js Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API PHP Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore Python.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Ruby Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Stocker des données
Dans le mode Datastore, les objets sont appelés entités, et chaque entité est d'un genre particulier. L'application TaskList stocke des entités du genre Task
, avec les propriétés suivantes :
description
: chaîne spécifiée par l'utilisateur en tant que description de la tâchecreated
: date de création initiale de la tâchedone
: valeur booléenne indiquant si la tâche a été effectuée
Lorsque l'utilisateur ajoute une tâche, l'application TaskList crée un Task
.
avec les valeurs des propriétés précédemment répertoriées:
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore C#.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore Go.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Java Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Node.js Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore PHP.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Python Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Ruby Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Pour cette application, nous fournissons également une méthode pour mettre à jour done
pour indiquer que la tâche est terminée:
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore C#.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Go Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore Java.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Node.js Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore PHP.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Python Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Ruby Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Voici la méthode permettant de supprimer une entité Task
, à l'aide de la clé Task
de l'entité :
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API C# Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Go Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore Java.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Node.js Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore PHP.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Python Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Ruby Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Exécuter une requête
En plus de récupérer les entités à partir du mode Datastore directement à l'aide de leurs clés, une application peut exécuter une requête pour les extraire en fonction des valeurs de leurs propriétés. Une requête type comprend les éléments suivants :
- Un genre d'entité auquel s'applique la requête.
- Zéro, un ou plusieurs filtres, par exemple pour sélectionner des genres dont les propriétés correspondent à une valeur.
- Zéro, un ou plusieurs ordres de tri, pour séquencer les résultats.
Pour cette application, nous allons interroger le mode Datastore pour obtenir les entités Task
triées par date de création :
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API C# Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Go Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Java Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Node.js Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez la page Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Datastore PHP.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Python Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud Datastore, consultez Bibliothèques clientes Cloud Datastore. Pour en savoir plus, consultez les API Ruby Cloud Datastore documentation de référence.
Pour vous authentifier auprès de Cloud Datastore, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Étapes suivantes
Ce tutoriel n'aborde que les étapes les plus élémentaires nécessaires pour appeler l'API en mode Datastore à partir d'une application de ligne de commande. Le mode Datastore est compatible avec les transactions ACID rapides et hautement évolutives, les requêtes de type SQL, les index, etc.
- Consultez la page Qu'est-ce que Firestore en mode Datastore ? pour en savoir plus sur les fonctionnalités du mode Datastore.
- Consultez la page Émulateur en mode Datastore pour savoir comment utiliser l'émulateur en mode Datastore lors du développement de votre application.