Créer et mettre à jour des compteurs dans Bigtable

Créer et mettre à jour des compteurs dans Bigtable

Découvrez comment créer et mettre à jour des compteurs dans Bigtable à l'aide d'agrégats, c'est-à-dire des cellules de table qui agrègent des valeurs au moment de l'écriture. Ce guide de démarrage rapide utilise Google Cloud CLI et la CLI cbt pour créer trois compteurs :

• Un compteur qui conserve une somme cumulée
• Compteur qui suit le minimum de toutes les valeurs ajoutées
• Compteur qui suit le maximum de toutes les valeurs ajoutées

Avant de commencer

Sign in to your Google Account.

If you don't already have one, sign up for a new account.

Install the 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

Après avoir initialisé la gcloud CLI, mettez-la à jour et installez les composants requis :

gcloud components update
gcloud components install cbt

Create or select a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Bigtable API and Cloud Bigtable Admin API APIs:

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

Install the 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

Après avoir initialisé la gcloud CLI, mettez-la à jour et installez les composants requis :

gcloud components update
gcloud components install cbt

Create or select a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Bigtable API and Cloud Bigtable Admin API APIs:

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

1. Exécutez les commandes suivantes pour vous assurer que gcloud CLI est à jour et inclut la CLI cbt :

   gcloud components update

   gcloud components install cbt

Créer une instance Bigtable

1. Utilisez la commande bigtable instances create pour créer une instance.

   gcloud bigtable instances create counters-quickstart-instance \
       --display-name="Counters quickstart instance" \
       --cluster-config=id="counters-quickstart-cluster",zone="us-east1-c"
   

Se connecter à l'instance

1. Configurez la CLI cbt pour utiliser votre projet et votre instance en créant un fichier .cbtrc.

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

   Remplacez PROJECT_ID par l'ID du projet que vous utilisez.

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 = counters-quickstart-instance

   Vous pouvez maintenant utiliser la CLI cbt avec votre instance.

Créer une table avec des familles de colonnes agrégées

1. Exécutez la commande cbt createtable pour créer une table nommée counters_quickstart_table comportant trois familles de colonnes agrégées. Configurez chaque famille de colonnes avec un type d'agrégation différent :

   • La famille de colonnes max_family est de type Max avec un type d'entrée Integer.
   • La famille de colonnes min_family est de type Min avec un type d'entrée Integer.
   • La famille de colonnes sum_family est de type Sum avec un type d'entrée Integer.

   cbt createtable counters_quickstart_table families=sum_family:never:intsum,min_family:never:intmin,max_family:never:intmax
   

2. Listez vos familles de colonnes en exécutant la commande cbt ls.

   cbt ls counters_quickstart_table
   

   Le shell affiche un résultat semblable à celui-ci :

   Family Name     GC Policy
   -----------     ---------
   max_family      <never>
   min_family      <never>
   sum_family      <never>
   

Créer des compteurs dans le tableau

1. Utilisez la commande cbt addtocell pour écrire une valeur initiale de 5 dans une nouvelle colonne de chacune des trois familles de colonnes, en utilisant une clé de ligne de row-key1 et un code temporel de 0. Cette opération crée des cellules agrégées, que vous utilisez comme compteurs.

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=5@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=5@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=5@0
   

Lire les données

1. Pour afficher les valeurs des compteurs sous forme d'entiers plutôt que d'octets, définissez un fichier yaml que la CLI cbt peut utiliser pour mettre en forme la sortie. Exécutez la commande suivante :

   echo "families:" > cbtformat.yaml
   echo "  max_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   echo "  min_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   echo "  sum_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   

2. Vérifiez que vous avez correctement configuré le fichier cbtformat.yaml.

   cat ~/cbtformat.yaml
   

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

   families:
     max_family:
       default_encoding: BigEndian
       default_type: INT64
     min_family:
       default_encoding: BigEndian
       default_type: INT64
     sum_family:
       default_encoding: BigEndian
       default_type: INT64
   

3. Utilisez la commande cbt read pour transmettre le fichier yaml et lire les données que vous avez ajoutées à la table. Le tableau comporte désormais trois colonnes, chacune avec un type d'agrégation différent.

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   Le shell affiche un résultat semblable à celui-ci. Les valeurs sont formatées sous forme d'entiers et les codes temporels sont au format UTC.

   row-key1
     max_family:max_column                    @ 1970/01/01-00:00:00.000000
       5
     min_family:min_column                    @ 1970/01/01-00:00:00.000000
       5
     sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
       5
   

Mettre à jour les compteurs

1. Ajoutez la valeur 3 à chaque colonne du tableau, en utilisant les mêmes codes temporels que ceux utilisés lors de la création des cellules. Dans chaque colonne, la valeur de la cellule est fusionnée avec la valeur existante en fonction du type d'agrégation de la cellule.

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=3@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=3@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=3@0
   

2. Utilisez à nouveau la commande cbt read pour lire les données de la table. Chaque cellule contient désormais une valeur agrégée.

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   sum_column contient la somme de 5 et 3 (8), min_column contient le minimum des deux valeurs qui y ont été écrites (3) et max_column contient le maximum des deux valeurs qui y ont été écrites (5).

   row-key1
       max_family:max_column                    @ 1970/01/01-00:00:00.000000
           5
       min_family:min_column                    @ 1970/01/01-00:00:00.000000
           3
       sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
           8
   

3. Facultatif : Interrogez la table dans la console Google Cloud avec SQL.

   1. Dans la console Google Cloud , ouvrez la page Instances Bigtable.

      Accéder à la liste des instances

   2. Sélectionnez counters-quickstart-instance dans la liste.

   3. Dans le menu de navigation, cliquez sur Bigtable Studio.

   4. Cliquez sur l'onglet Éditeur.

   5. Collez cette requête dans l'éditeur :

      SELECT * FROM `counters_quickstart_table`
      

   6. Cliquez sur Exécuter. Les résultats de la requête s'affichent dans le tableau Résultats et ressemblent à ce qui suit :

   _key	max_family	min_family	sum_family
   row-key1	{ "max_column": 5 }	{ "min_column": 5 }	{ "sum_column": 8 }

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , supprimez le projet Google Cloud qui les contient.

1. Dans le terminal, supprimez la table counters_quickstart_table :

   cbt deletetable counters_quickstart_table
   

2. Supprimez l'instance :

   cbt deleteinstance counters-quickstart-instance
   

3. Supprimez le fichier .cbtrc :

   rm ~/.cbtrc
   

4. Supprimez le fichier de mise en forme :

   rm ~/cbtformat.yaml
   

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

   gcloud auth revoke
   

Étapes suivantes

• En savoir plus sur les agrégats
• Utilisez SQL pour interroger les données Bigtable.