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

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. Install the Google Cloud CLI.

  3. To initialize the gcloud CLI, run the following command: 

    gcloud init

  4. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Enable the Cloud Bigtable and Cloud Bigtable Admin APIs: 

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

  7. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/bigtable.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
    • Replace PROJECT_ID with your project ID.

    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:myemail@example.com.

    • Replace ROLE with each individual role.
    8.
  8. Install the Google Cloud CLI.

  9. To initialize the gcloud CLI, run the following command: 

    gcloud init

  10. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  11. Make sure that billing is enabled for your Google Cloud project.

  12. Enable the Cloud Bigtable and Cloud Bigtable Admin APIs: 

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

  13. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/bigtable.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
    • Replace PROJECT_ID with your project ID.

    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:myemail@example.com.

    • Replace ROLE with each individual role.
    14.
  14. 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 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. 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 votre 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.

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