Créer une instance et écrire des données avec la CLI cbt
Si vous découvrez Bigtable , le guide de démarrage rapide vous présente les principes de base que vous pouvez utiliser à 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 gratuits pour exécuter, tester et déployer des charges de travail.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
-
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activer les API Cloud Bigtable and Cloud Bigtable Admin :
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
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_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.
- Replace
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
-
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activer les API Cloud Bigtable and Cloud Bigtable Admin :
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
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_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.
- Replace
- Exécutez la commande suivante pour installer la CLI
cbt
:gcloud components install cbt
Créer une instance Bigtable
Accédez à la page Créer une instance dans Google Cloud Console.
Dans le champ Nom de l'instance, saisissez
Quickstart instance
.Dans le champ ID d'instance, saisissez
quickstart-instance
.Cliquez sur Continuer.
Comme Type de stockage, sélectionnez SSD.
Cliquez sur Continuer.
Dans le champ ID de cluster, saisissez
quickstart-instance-c1
.Dans le champ Région, sélectionnez une région à proximité de votre emplacement.
Dans le champ Zone, sélectionnez Toutes.
Dans le champ Mode de scaling des nœuds, sélectionnez Allocation manuelle.
Dans le champ Quantité, sélectionnez 1.
Cliquez sur Créer pour créer l'instance.
Se connecter à l'instance
Configurez la CLI
cbt
pour qu'elle utilise votre projet et votre instance. Pour ce faire, créez un fichier.cbtrc
, en remplaçantPROJECT_ID
par l'ID du projet dans lequel vous avez créé votre instance Bigtable:echo project = PROJECT_ID >> ~/.cbtrc && echo instance = quickstart-instance >> ~/.cbtrc
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.
Créez une table nommée
my-table
.cbt createtable my-table
Répertoriez vos tables :
cbt ls
La commande affiche un résultat semblable à celui-ci :
my-table
Ajoutez une famille de colonnes nommée
cf1
:cbt createfamily my-table cf1
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>
Écrivez les valeurs
test-value1
ettest-value2
dans la ligner1
en utilisant la famille de colonnescf1
et le qualificatif de colonnec1
:cbt set my-table r1 cf1:c1=test-value1 cbt set my-table r1 cf1:c1=test-value2
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.
Supprimez la table
my-table
:cbt deletetable my-table
Supprimez l'instance :
cbt deleteinstance quickstart-instance
Supprimez le fichier
.cbtrc
:rm ~/.cbtrc
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.