Cet exemple de code présente une application "Hello World" écrite en C#. Il montre comment effectuer les tâches suivantes :
- Se connecter à une instance Cloud Bigtable
- Créer une table
- Écrire des données dans une table
- Relire les données
- Supprimer la table
Exécuter l'exemple
Ce code communique avec Cloud Bigtable à l'aide des bibliothèques de l'API Admin en C# et de l'API Data en C# qui se trouvent dans les bibliothèques clientes Google Cloud pour .NET.
Pour exécuter cet exemple de programme, suivez les instructions relatives aux exemples Cloud Bigtable pour .NET sur GitHub.
Suivez les procédures Build and Run (Créer et exécuter) et Quick Start (Démarrage rapide) pour créer des ressources que vous pouvez exploiter dans votre application Hello World. Veillez à modifier le fichier HelloWorld.cs
pour ajouter les noms des ressources créées.
Utiliser la bibliothèque cliente Cloud avec Cloud Bigtable
L'exemple d'application permet de se connecter à Cloud Bigtable et décrit quelques opérations simples.
Se connecter à Cloud Bigtable
Pour commencer, créez deux objets client dont vous pouvez vous servir pour vous connecter à Cloud Bigtable. La classe BigtableTableAdminClient
de l'API Admin en C# vous permet de créer et de supprimer des instances et des tables. La classe BigtableClient
de l'API Data en C# vous sert quant à elle à lire et à écrire les données d'une table.
Créer une table
Appelez la méthode CreateTable()
du client d'administration pour générer un objet Table
qui stocke les messages d'accueil de l'application "Hello World". La table possède une seule famille de colonne qui conserve une version de chaque valeur.
Écrire des lignes dans une table
Définissez le tableau de chaînes s_greetings[]
, qui contient trois messages d'accueil simples, comme source de données à écrire dans la table. Commencez par écrire une seule ligne dans la table à l'aide de la méthode MutateRow()
. Passez en revue le reste du tableau pour créer un objet MutateRowsRequest
contenant une entrée pour chaque message d'accueil. Effectuez la requête pour écrire toutes les entrées en une fois à l'aide de la méthode MutateRows()
. Parcourez ensuite la réponse renvoyée pour vérifier le code d'état de chaque entrée afin de vous assurer qu'elles ont bien été écrites.
Créer un filtre
Avant de lire les données que vous avez écrites, créez un filtre pour limiter les données renvoyées par Cloud Bigtable. Ce filtre indique à Cloud Bigtable de ne renvoyer que la version la plus récente de chaque valeur, même si la table contient des versions antérieures qui n'ont pas fait l'objet d'une récupération de mémoire.
Lire une ligne à l'aide de sa clé
Utilisez la méthode ReadRow()
en appliquant le filtre que vous venez de créer pour obtenir une version de chaque valeur dans cette ligne.
Analyser toutes les lignes de la table
Appelez la méthode ReadRows()
en transmettant le filtre, afin d'obtenir toutes les lignes de la table. En raison du filtre, Cloud Bigtable ne renvoie qu'une version de chaque valeur.
Supprimer une table
Supprimez la table à l'aide de la méthode DeleteTable()
.
Synthèse
Voici l'exemple de code complet sans commentaires.