Cette page explique comment créer et gérer les profils d'application d'une instance Cloud Bigtable. Elle indique également comment utiliser un profil d'application personnalisé pour se connecter à Cloud Bigtable.
Avant de lire cette page, il est recommandé de comprendre ce que sont les profils d'application et leur fonctionnement. Si vous en utilisez pour configurer la réplication, vous devez également avoir consulté la présentation de la réplication Cloud Bigtable et les exemples de paramètres de réplication, et avoir déterminé les paramètres convenant le mieux à votre cas d'utilisation.
Créer un profil d'application personnalisé
Vous pouvez créer de nombreux profils d'application personnalisés pour chaque instance. Utilisez les profils d'application personnalisés pour contrôler la manière dont chaque application, ou chaque fonction distincte d'une application, interagit avec une instance. Vous pouvez par exemple utiliser un profil d'application pour une application par lots afin d'isoler son trafic dans un cluster unique, et un autre profil d'application pour permettre une haute disponibilité à une seconde application.
Pour créer un profil d'application personnalisé, procédez comme suit :
Console
Ouvrez la liste des instances Cloud Bigtable dans Cloud Console.
Cliquez sur l'instance sur laquelle vous souhaitez créer le profil d'application.
Dans le volet de gauche, cliquez sur Profils d'application.
Cliquez sur Créer un profil d'application.
Saisissez l'ID du profil d'application.
L'ID de profil d'application est un identifiant permanent du profil d'application. Votre application fournit cet ID lorsqu'elle se connecte à Cloud Bigtable.
Saisissez une description du profil d'application.
Dans le champ Routage vers les clusters, sélectionnez un ID de cluster pour utiliser le routage vers un cluster unique ou Tous les clusters pour utiliser le routage multi-cluster. En savoir plus
Dans le champ Transactions à ligne unique, cochez la case Autoriser les transactions à ligne unique si vous devez activer ce type de transaction. En savoir plus
Pour activer les transactions à ligne unique, vous devez utiliser le routage vers un cluster unique.
Cliquez sur Créer pour créer le profil d'application.
Mettez à jour le code de votre application pour vous connecter à Cloud Bigtable afin qu'il puisse utiliser le nouveau profil d'application.
gcloud
Si vous ne connaissez pas l'ID d'instance, exécutez la commande
bigtable instances list
pour afficher la liste des instances du projet :gcloud bigtable instances list
Utilisez la commande
bigtable app-profiles create
pour créer un profil d'application :gcloud bigtable app-profiles create APP_PROFILE_ID \ --instance=INSTANCE_ID \ [--description=DESCRIPTION] \ [--force] \ [--route-any] \ [--route-to=CLUSTER_ID] \ [--transactional-writes]
Indiquez les valeurs suivantes :
APP_PROFILE_ID
: identifiant permanent du profil d'application.INSTANCE_ID
: identifiant permanent de l'instance.
La commande accepte les options facultatives suivantes :
--description=DESCRIPTION
: description détaillée du profil d'application.--force
: permet d'ignorer les avertissements relatifs aux problèmes et aux conflits potentiels avec d'autres profils d'application.--route-any
: permet d'activer le routage multicluster pour rediriger les requêtes vers un cluster disponible.Vous ne pouvez pas associer cette option à
--route-to
ou--transactional-writes
.--route-to=CLUSTER_ID
: ID du cluster vers lequel toutes les demandes doivent être acheminées. Cette option active le routage vers un cluster unique.Vous ne pouvez pas associer cette option à
--route-any
.--transactional-writes
: permet d'activer les transactions à ligne unique dans le profil d'application.Vous ne pouvez pas associer cette option à
--route-any
.
Mettez à jour le code de votre application pour établir la connexion à Cloud Bigtable, afin qu'il puisse utiliser le nouveau profil d'application.
Se connecter avec un profil d'application personnalisé
Après avoir créé un profil d'application personnalisé, vous pouvez mettre à jour votre code afin que votre application l'utilise pour se connecter à Cloud Bigtable.
Les exemples suivants montrent comment spécifier un profil d'application lorsqu'une application crée un client Cloud Bigtable et se connecte à une instance. Remplacez [APP_PROFILE_ID]
par la valeur appropriée.
C#
var client = BigtableClient.Create(appProfileId: "[APP_PROFILE_ID]");
Go
clientConf := bigtable.ClientConfig{AppProfile:"[APP_PROFILE_ID]"}
client, err = bigtable.NewClientWithConfig(ctx, project, instance, clientConf)
HappyBase
La bibliothèque cliente HappyBase n'est pas compatible avec les profils d'application personnalisés. Cette bibliothèque cliente utilise toujours le profil d'application par défaut.
HBase Java
// If using BigtableOptions directly:
optionsBuilder.setAppProfileId("[APP_PROFILE_ID]");
// If using BigtableOptionsFactory:
configuration.set(BigtableOptionsFactory.APP_PROFILE_ID_KEY, "[APP_PROFILE_ID]");
// If using system properties, set "google.bigtable.app_profile.id" to
// "[APP_PROFILE_ID]"
// If using CloudBigtableIO for Cloud Dataflow:
config.withConfiguration(BigtableOptionsFactory.APP_PROFILE_ID_KEY,
"[APP_PROFILE_ID]");
Node.js
const bigtable = new Bigtable({appProfileId: '[APP_PROFILE_ID]'});
Python
from google.cloud import bigtable
client = bigtable.Client(project=project_id)
instance = client.instance(instance_id)
table = bigtable.table.Table(table_id, instance, '[APP_PROFILE_ID]')
Mettre à jour un profil d'application
Vous pouvez afficher les profils d'application d'une instance et mettre à jour leurs paramètres à tout moment. Cloud Bigtable vous avertit de toute mise à jour pouvant entraîner des changements de comportement inattendus.
Pour afficher ou mettre à jour un profil d'application existant, procédez comme suit :
Console
Ouvrez la liste des instances Cloud Bigtable dans Cloud Console.
Dans la colonne Profils d'application, cliquez sur le profil que vous souhaitez afficher ou mettre à jour.
Si vous ne voyez pas le profil d'application que vous souhaitez modifier, vous pouvez afficher une liste complète en cliquant sur le nom de l'instance, puis en cliquant sur Profils d'application dans le volet de gauche.
Mettez à jour les paramètres selon vos besoins, puis cliquez sur Enregistrer ou Annuler pour quitter sans enregistrer.
gcloud
Si vous ne connaissez pas l'ID d'instance, exécutez la commande
bigtable instances list
pour afficher la liste des instances du projet :gcloud bigtable instances list
Si vous ne connaissez pas l'ID du profil d'application, exécutez la commande
bigtable app-profiles list
pour afficher la liste des profils d'application de l'instance :gcloud bigtable app-profiles list --instance=INSTANCE_ID
Remplacez
INSTANCE_ID
par l'identifiant permanent de l'instance.(Facultatif) Exécutez la commande
bigtable app-profiles describe
pour afficher les paramètres du profil d'application :gcloud bigtable app-profiles describe APP_PROFILE_ID \ --instance=INSTANCE_ID
Indiquez les valeurs suivantes :
APP_PROFILE_ID
: identifiant permanent du profil d'application.INSTANCE_ID
: identifiant permanent de l'instance
Exécutez la commande
bigtable app-profiles update
pour mettre à jour les paramètres du profil d'application :gcloud bigtable app-profiles update APP_PROFILE_ID \ --instance=INSTANCE_ID \ [--description=DESCRIPTION] \ [--force] \ [--route-any] \ [--route-to=CLUSTER_ID] \ [--transactional-writes]
Indiquez les valeurs suivantes :
APP_PROFILE_ID
: identifiant permanent du profil d'application.INSTANCE_ID
: identifiant permanent de l'instance.
La commande accepte les options facultatives suivantes :
--description=DESCRIPTION
: description détaillée du profil d'application.--force
: permet d'ignorer les avertissements relatifs aux problèmes et aux conflits potentiels avec d'autres profils d'application.--route-any
: permet d'activer le routage multicluster pour rediriger les requêtes vers un cluster disponible.Vous ne pouvez pas associer cette option à
--route-to
ou--transactional-writes
.--route-to=CLUSTER_ID
: ID du cluster vers lequel toutes les demandes doivent être acheminées. Cette option active le routage vers un cluster unique.Vous ne pouvez pas associer cette option à
--route-any
.--transactional-writes
: permet d'activer les transactions à ligne unique dans le profil d'application.Vous ne pouvez pas associer cette option à
--route-any
.
Supprimer un profil d'application personnalisé
Vous pouvez supprimer les profils d'application d'une instance, mais pas le profil d'application par défaut.
Pour supprimer un profil d'application personnalisé, procédez comme suit :
Console
Ouvrez la liste des instances Cloud Bigtable dans Cloud Console.
Cliquez sur l'instance qui contient le profil d'application que vous souhaitez supprimer.
Dans le volet de gauche, cliquez sur Profils d'application.
Ouvrez le menu Autres actions
, puis cliquez sur Supprimer le profil d'application. Une boîte de dialogue de confirmation s'affiche.
Suivez les instructions de la boîte de dialogue de confirmation, puis cliquez sur Supprimer.
gcloud
Si vous ne connaissez pas l'ID d'instance, exécutez la commande
bigtable instances list
pour afficher la liste des instances du projet :gcloud bigtable instances list
Si vous ne connaissez pas l'ID du profil d'application, exécutez la commande
bigtable app-profiles list
pour afficher la liste des profils d'application de l'instance :gcloud bigtable app-profiles list --instance=INSTANCE_ID
Remplacez
INSTANCE_ID
par l'identifiant permanent de l'instance.Exécutez la commande
bigtable app-profiles delete
pour supprimer le profil d'application :gcloud bigtable app-profiles delete APP_PROFILE_ID \ --instance=INSTANCE_ID \ [--force]
Indiquez les valeurs suivantes :
APP_PROFILE_ID
: identifiant permanent du profil d'application.INSTANCE_ID
: identifiant permanent de l'instance.
La commande accepte l'option facultative suivante :
--force
: permet d'ignorer les avertissements relatifs aux problèmes et aux conflits potentiels avec d'autres profils d'application.