Cette page a été traduite par l'API Cloud Translation.

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

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.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

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.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

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

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

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

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.
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

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
```

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

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

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

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

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

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
```

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

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 }

_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.

Dans le terminal, supprimez la table counters_quickstart_table :
```
cbt deletetable counters_quickstart_table
```

Supprimez l'instance :

cbt deleteinstance counters-quickstart-instance

Supprimez le fichier .cbtrc :
```
rm ~/.cbtrc
```
Supprimez le fichier de mise en forme :
```
rm ~/cbtformat.yaml
```
Facultatif : Révoquez les identifiants de gcloud CLI :
```
gcloud auth revoke
```

Créer et mettre à jour des compteurs dans Bigtable

Avant de commencer

Créer une instance Bigtable

Se connecter à l'instance

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

Créer des compteurs dans le tableau

Lire les données

Mettre à jour les compteurs

Effectuer un nettoyage

Étapes suivantes