Créer une instance et écrire des données avec la CLI cbt

Si vous découvrez Bigtable, ce guide de démarrage rapide peut vous aider à vous familiariser avec les principes de base que vous utiliseriez à grande échelle dans un environnement de production.

Dans ce guide de démarrage rapide, vous effectuez les actions suivantes :

• Connexion à une instance Bigtable
• Tâches d'administration de base
• Écriture de données dans une table
• Lecture des données d'une table

Avant de commencer

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.
Installez la Google Cloud CLI.
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
Pour initialiser la gcloud CLI, exécutez la commande suivante :
gcloud init
Créez ou sélectionnez un projet Google Cloud .
Rôles requis pour sélectionner ou créer un projet
• Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
• Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.
Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.
• Créez un projet Google Cloud  :

  gcloud projects create PROJECT_ID

  Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

• Sélectionnez le projet Google Cloud que vous avez créé :

  gcloud config set project PROJECT_ID

  Remplacez PROJECT_ID par le nom de votre projet Google Cloud .
Vérifiez que la facturation est activée pour votre projet Google Cloud .
Activez les API Cloud Bigtable et Cloud Bigtable Admin :
Rôles requis pour activer les API
Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.
gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com
Attribuez des rôles à votre compte utilisateur. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants : roles/bigtable.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Remplacez les éléments suivants :
• PROJECT_ID : ID de votre projet
• USER_IDENTIFIER : identifiant de votre compte utilisateur . Par exemple, [e-mail].
• ROLE : rôle IAM que vous accordez à votre compte utilisateur.

Installez la Google Cloud CLI.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour initialiser la gcloud CLI, exécutez la commande suivante :

gcloud init

Créez ou sélectionnez un projet Google Cloud .

Rôles requis pour sélectionner ou créer un projet

• Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
• Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

• Créez un projet Google Cloud  :

  gcloud projects create PROJECT_ID

  Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

• Sélectionnez le projet Google Cloud que vous avez créé :

  gcloud config set project PROJECT_ID

  Remplacez PROJECT_ID par le nom de votre projet Google Cloud .

Vérifiez que la facturation est activée pour votre projet Google Cloud .

Activez les API Cloud Bigtable et Cloud Bigtable Admin :

Rôles requis pour activer les API

Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

Attribuez des rôles à votre compte utilisateur. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants : roles/bigtable.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• USER_IDENTIFIER : identifiant de votre compte utilisateur . Par exemple, [e-mail].
• ROLE : rôle IAM que vous accordez à votre compte utilisateur.
1. Exécutez la commande suivante pour installer la CLI cbt :

   gcloud components install cbt

Créer une instance Bigtable

1. Accédez à la page Créer une instance dans la console Google Cloud .

   Créer une instance

2. Dans le champ Nom de l'instance, saisissez Quickstart instance.

3. Dans le champ ID d'instance, saisissez quickstart-instance.

4. Cliquez sur Continuer.

5. Comme Type de stockage, sélectionnez SSD.

6. Cliquez sur Continuer.

7. Dans le champ ID de cluster, saisissez quickstart-instance-c1.

8. Dans le champ Région, sélectionnez une région à proximité de votre emplacement.

9. Dans le champ Zone, sélectionnez Toutes.

10. Dans le champ Mode de scaling des nœuds, sélectionnez Allocation manuelle.

11. Dans le champ Quantité, sélectionnez 1.

12. Cliquez sur Créer pour créer l'instance.

Se connecter à l'instance

1. Configurez la CLI cbt pour utiliser votre projet et votre instance en créant un fichier .cbtrc, en remplaçant PROJECT_ID par l'ID du projet dans lequel vous avez créé votre instance Bigtable :

   echo project = PROJECT_ID >> ~/.cbtrc && echo instance = quickstart-instance >> ~/.cbtrc
   

2. Vérifiez que vous avez correctement configuré le fichier .cbtrc :

   cat ~/.cbtrc

   Le terminal affiche le contenu du fichier .cbtrc, qui doit ressembler à ce qui suit :

   project = PROJECT_ID
   instance = quickstart-instance

   Vous pouvez maintenant utiliser la CLI cbt avec l'instance.

Lire et écrire des données

Bigtable enregistre les données dans des tables contenant des lignes. Chaque ligne est identifiée par une clé de ligne.

Les données d'une ligne sont organisées en familles de colonnes, qui sont des groupes de colonnes. Un qualificatif de colonne identifie une seule colonne au sein d'une famille.

Il peut exister plusieurs cellules horodatées à l'intersection d'une ligne et d'une colonne.

1. Créez une table nommée my-table.

   cbt createtable my-table

2. Répertoriez vos tables :

   cbt ls

   La commande affiche un résultat semblable à celui-ci :

       my-table

3. Ajoutez une famille de colonnes nommée cf1 :

   cbt createfamily my-table cf1

4. Répertoriez vos familles de colonnes :

   cbt ls my-table

   La commande affiche un résultat semblable à celui-ci :

       Family Name     GC Policy
       -----------     ---------
       cf1             <never>

5. Écrivez les valeurs test-value1 et test-value2 dans la ligne r1 en utilisant la famille de colonnes cf1 et le qualificatif de colonne c1 :

   cbt set my-table r1 cf1:c1=test-value1
     cbt set my-table r1 cf1:c1=test-value2
   

6. Utilisez la commande cbt read pour lire les données que vous avez ajoutées à la table :

   cbt read my-table

   L'interface système affiche un résultat semblable à celui-ci :

       ----------------------------------------
       r1
         cf1:c1                                   @ 2023/03/22-06:56:11.323000
           "test-value1"
         cf1:c1                                   @ 2023/03/22-06:56:04.361000
           "test-value2"

   Deux valeurs horodatées sont stockées pour la même colonne dans la ligne r1.

   Remarque : Dans ce guide de démarrage rapide, vous ne définissez que deux cellules, mais Bigtable vous permet de définir jusqu'à 10 000 cellules dans une seule requête d'écriture.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans ce guide de démarrage rapide soient facturées sur votre compte Google Cloud , supprimez l'instance. Dès lors que vous supprimez le fichier .cbtrc, vous êtes prêt à travailler sur un autre projet.

1. Supprimez la table my-table :

   cbt deletetable my-table

2. Supprimez l'instance :

   cbt deleteinstance quickstart-instance

3. Supprimez le fichier .cbtrc :

   rm ~/.cbtrc

4. Facultatif : Révoquez les identifiants de gcloud CLI :

   gcloud auth revoke

Étapes suivantes

• Suivez un atelier de programmation Bigtable.
• Consultez la documentation de référence de la CLI cbt.
• Consultez l'exemple de code source pour un cas d'utilisation de détection de fraude.
• Écrivez une application Hello World en C#, C++, Go, Java, Node.js, PHP, Python, Ruby ou en utilisant le client HBase pour Java.