Hello World Python
Cet exemple présente une application "Hello World", écrite en Python, et montre comment :
- Configurez l'authentification.
- Connexion à une instance Bigtable
- créer une table ;
- Écrire des données dans une table
- Relire les données
- Supprimer la table
La bibliothèque cliente Python pour Bigtable propose deux API : asyncio
et une API synchrone. Si votre application est asynchrone, utilisez asyncio
.
Configurer l'authentification
Pour utiliser les exemples Python de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
gcloud auth application-default login
Pour en savoir plus, consultez les sections sur Configurer l'authentification pour un environnement de développement local.
Exécuter l'exemple
Cet exemple utilise le package Bigtable des bibliothèques clientes Cloud pour Python afin de communiquer avec Bigtable. Le package Bigtable constitue le meilleur choix pour les nouvelles applications. Si vous devez déplacer une charge de travail HBase existante vers 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 les bibliothèques clientes Cloud avec Bigtable
L'exemple d'application se connecte à Bigtable et présente quelques opérations.
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.
Asyncio
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Synchroniser
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Se connecter à Bigtable
Connectez-vous à Bigtable à l'aide d'un bigtable.Client
.
Asyncio
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Synchroniser
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
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.
Asyncio
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Synchroniser
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
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 Bigtable. Ce filtre indique à Bigtable de ne renvoyer que la cellule la plus récente de chaque colonne, même si la table contient des cellules plus anciennes qui n'ont pas encore été supprimées lors de la récupération de mémoire.
Asyncio
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Synchroniser
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Lire une ligne à l'aide de sa clé de ligne
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.
Asyncio
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Synchroniser
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Analyser toutes les lignes de la table
Utilisez Table.read_rows()
pour lire une plage de lignes d'une table.
Asyncio
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Synchroniser
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Supprimer une table
Supprimez une table à l'aide de Table.delete()
.
Regrouper tous les éléments
Voici l'exemple complet sans commentaires.
Asyncio
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Synchroniser
Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.
Pour vous authentifier auprès de Bigtable, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.