Hello World Java
Cet exemple de code écrite en Java, à l'aide de la Bibliothèque cliente Bigtable pour Java. Il montre comment effectuer les tâches suivantes :
- Configurer l'authentification
- Connexion à une instance Bigtable
- créer une table ;
- Écrire des données dans une table
- Relire les données
- Supprimer la table
Configurer l'authentification
Pour utiliser les exemples Java de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
gcloud auth application-default login
Pour en savoir plus, consultez les sections sur Configurer l'authentification pour un environnement de développement local.
Exécuter l'exemple
Ce code communique avec Bigtable à l'aide de la bibliothèque Google Cloud Bigtable qui se trouve dans les bibliothèques clientes Google Cloud pour Java.
Avant de commencer, suivez les instructions relatives aux exemples Google Cloud Platform sur GitHub.
Utiliser la bibliothèque cliente Cloud avec Bigtable
L'exemple d'application permet de se connecter à Bigtable et décrit quelques opérations simples.
Se connecter à Bigtable
Pour commencer, vous avez besoin d'un client de données que vous utiliserez pour communiquer avec la bibliothèque cliente de l'API Data et d'un client d'administration de table que vous utiliserez pour communiquer avec la bibliothèque cliente de l'API Admin.
Commencez par instancier un objet BigtableDataSettings
incluant l'ID de projet et l'ID d'instance que l'application hello world
utilisera. Ensuite, transmettez les paramètres à la méthode BigtableDataClient.create()
pour créer le client de données.
De même, pour le client d'administration, établissez d'abord les paramètres en créant un objet BigtableTableAdminSettings
, puis utilisez-les pour créer un objet BigtableTableAdminClient
.
Lorsque vous utilisez Bigtable, il est recommandé de systématiquement créer un client une fois, puis de le réutiliser dans l'ensemble de l'application.
Créer une table
Pour créer une table, créez un objet CreateTableRequest
, puis transmettez-le à la méthode createTable()
du client d'administration.
Écrire des lignes dans une table
Créez un tableau de chaînes greetings[]
contenant trois messages d'accueil simples, à utiliser comme source de données à écrire dans la table. Parcourez le tableau. À chaque itération de la boucle, créez un objet RowMutation
et utilisez la méthode setCell()
pour ajouter une entrée à la mutation.
Lire une ligne à l'aide de sa clé
Utilisez la méthode readRow()
du client de données pour lire la première ligne que vous avez écrite.
Analyser toutes les lignes de la table
Ensuite, analysez l'intégralité de la table. Créez un objet Query
, transmettez-le à la méthode readRows()
, puis attribuez les résultats à un flux de lignes.
Supprimer une table
Enfin, supprimez la table à l'aide de la méthode deleteTable()
.
Synthèse
Voici l'exemple de code complet sans commentaires.