Guide de démarrage rapide avec l'outil cbt

Si vous découvrez Cloud 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.

Ce guide de démarrage rapide utilise l'outil de ligne de commande cbt. Si vous préférez utiliser l'interface système HBase, suivez plutôt le guide de démarrage rapide avec l'interface système HBase.

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

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

Vous pouvez suivre ce guide de démarrage rapide dans Cloud Shell ou dans une fenêtre de terminal local.

Avant de commencer

  1. 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 gratuits pour exécuter, tester et déployer des charges de travail.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activer les API Cloud Bigtable, Cloud Bigtable Admin.

    Activer les API

  5. Créez un compte de service :

    1. Dans Cloud Console, accédez à la page Créer un compte de service.

      Accéder à la page "Créer un compte de service"
    2. Sélectionnez un projet.
    3. Dans le champ Nom du compte de service, saisissez un nom. Cloud Console remplit le champ ID du compte de service en fonction de ce nom.

      Dans le champ Description du compte de service, saisissez une description. Exemple : Service account for quickstart.

    4. Cliquez sur Créer et continuer.
    5. Cliquez sur le champ Sélectionner un rôle, puis sur Bigtable Administrator.

    6. Cliquez sur Continuer.
    7. Cliquez sur OK pour terminer la création du compte de service.

      Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.

  6. Créez une clé de compte de service :

    1. Dans Cloud Console, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
    2. Cliquez sur Clés.
    3. Cliquez sur Add key (Ajouter une clé), puis sur Create new key (Créer une clé).
    4. Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
    5. Cliquez sur Close (Fermer).
  7. Installez et initialisez le SDK Cloud.
  8. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  9. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  10. Activer les API Cloud Bigtable, Cloud Bigtable Admin.

    Activer les API

  11. Créez un compte de service :

    1. Dans Cloud Console, accédez à la page Créer un compte de service.

      Accéder à la page "Créer un compte de service"
    2. Sélectionnez un projet.
    3. Dans le champ Nom du compte de service, saisissez un nom. Cloud Console remplit le champ ID du compte de service en fonction de ce nom.

      Dans le champ Description du compte de service, saisissez une description. Exemple : Service account for quickstart.

    4. Cliquez sur Créer et continuer.
    5. Cliquez sur le champ Sélectionner un rôle, puis sur Bigtable Administrator.

    6. Cliquez sur Continuer.
    7. Cliquez sur OK pour terminer la création du compte de service.

      Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.

  12. Créez une clé de compte de service :

    1. Dans Cloud Console, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
    2. Cliquez sur Clés.
    3. Cliquez sur Add key (Ajouter une clé), puis sur Create new key (Créer une clé).
    4. Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
    5. Cliquez sur Close (Fermer).
  13. Installez et initialisez le SDK Cloud.

Créer une instance Bigtable

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

    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. Comme Type de stockage, sélectionnez SSD.

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

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

  7. Comme Zone, sélectionnez une zone au sein de la région choisie ci-dessus.

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

Se connecter à votre instance

  1. Configurez 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 l'outil 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 versions horodatées de la valeur à l'intersection d'une ligne et d'une colonne. Chaque version est appelée cellule.

  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. Placez la valeur test-value 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-value

  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                                   @ 2019/11/26-15:05:38.840000
            "test-value"

    Un horodatage est ajouté automatiquement car vous n'en avez pas spécifié vous-même.

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