Cet exemple présente une application très simple "Hello World", écrite en Python, et montre comment :
- se connecter à une instance Cloud Bigtable ;
- créer une table ;
- Écrire des données dans une table
- Relire les données
- Supprimer la table
Exécuter l'exemple
Cet exemple utilise le package Cloud Bigtable de la bibliothèque cliente Google Cloud pour Python afin de communiquer avec Cloud Bigtable. Le package Cloud Bigtable constitue le meilleur choix pour les nouvelles applications. Si vous devez déplacer une charge de travail HBase existante vers Cloud Bigtable, consultez l'exemple "Hello World" qui utilise le package HappyBase.
Pour exécuter ce programme, suivez les instructions de l'exemple sur GitHub.
Utiliser la bibliothèque cliente Cloud avec Cloud Bigtable
L'exemple d'application permet de se connecter à Cloud Bigtable et décrit quelques opérations simples.
Installer et importer la bibliothèque cliente
Utilisez PIP pour installer les packages Python requis dans un environnement virtualenv. L'exemple inclut un fichier de configuration qui définit les packages requis.
Importez les modules.
Se connecter à Cloud Bigtable
Connectez-vous à Cloud Bigtable à l'aide d'un objet bigtable.Client
.
Créer une table
Instanciez un objet de table à l'aide de Instance.table()
. Créez ensuite une famille de colonnes, définissez sa stratégie de récupération de mémoire et transmettez cette famille à Table.create()
pour créer la table.
Écrire des lignes dans une table
Parcourez une liste de chaînes de salutations pour créer des lignes de table.
À chaque itération, utilisez Table.row()
pour définir une ligne et attribuez-lui une clé de ligne. Appelez Row.set_cell()
afin de définir une valeur pour la cellule actuellement sélectionnée, puis ajoutez la nouvelle ligne à un tableau de lignes.
Enfin, appelez Table.mutate_rows()
pour ajouter les lignes à la table.
Créer un filtre
Avant de lire les données que vous avez écrites, créez un filtre à l'aide de row_filters.CellsColumnLimitFilter()
afin de limiter les données renvoyées par Cloud Bigtable. Ce filtre indique à Cloud Bigtable de ne renvoyer que la version la plus récente de chaque valeur, même si la table contient des versions antérieures qui n'ont pas fait l'objet d'une récupération de mémoire.
Lire une ligne à l'aide de sa clé
Appelez la méthode Table.read_row()
pour obtenir une référence à la ligne avec une clé de ligne spécifique, en indiquant la clé et le filtre, afin d'avoir une version de chaque valeur dans cette ligne.
Analyser toutes les lignes de la table
Utilisez Table.read_rows()
pour lire une plage de lignes d'une table.
Supprimer une table
Supprimez une table à l'aide de Table.delete()
.
Synthèse
Voici l'exemple complet sans commentaires.