Hello World C#
Cet exemple de code présente une application "Hello World" écrite en C#. Il montre comment effectuer les tâches suivantes :
- Configurer l'authentification
- Se connecter à 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 .NET 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 des bibliothèques de l'API Admin C# et de l'API C# Data dans les bibliothèques clientes Google Cloud pour .NET.
Pour exécuter cet exemple de programme, suivez les instructions relatives aux exemples 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 les bibliothèques clientes Cloud avec Bigtable
L'exemple d'application permet de se connecter à Bigtable et décrit quelques opérations simples.
Se connecter à Bigtable
Pour commencer, créez deux objets client dont vous pouvez vous servir pour vous connecter à Bigtable. La classe BigtableTableAdminClient
des API Admin en C# vous permet de créer et de supprimer des instances et des tables. Le langage C#
Les API de données BigtableClient
vous aident à lire et à écrire une table
données.
Créer une table
Appelez la méthode CreateTable()
dans la classe BigtableTableAdminClient
pour :
générer un objet Table
qui stocke le message
du monde" salutations. 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 Bigtable. Ce filtre indique à Bigtable de ne renvoyer que la version la plus récente de chaque valeur, même si la table contient des cellules plus anciennes éligibles à la récupération de mémoire, mais qui n'ont pas encore été supprimées.
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, 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.