Créer et configurer des profils d'application

Cette page explique comment créer et gérer les profils d'application d'une instance Cloud Bigtable. Elle montre également comment utiliser un profil d'application personnalisé pour se connecter à Bigtable.

Avant de lire cette page, il est recommandé de comprendre ce que sont les profils d'application et leur fonctionnement. Si vous utilisez des profils d'application pour configurer la réplication, vous devez également connaître la Présentation de la réplication Bigtable, et nous vous recommandons de consulter leExemples de paramètres de réplication et de choisir les paramètres les mieux adaptés à votre cas d'utilisation.

Créer un profil d'application

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 :

Console

1. Ouvrez la liste des instances Bigtable dans Google Cloud Console.

   Ouvrir la liste des instances

2. Cliquez sur l'instance sur laquelle vous souhaitez créer le profil d'application.

3. Dans le volet de gauche, cliquez sur Profils d'application.

4. Cliquez sur Créer un profil d'application.

5. 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 à Bigtable.

6. Saisissez une description du profil d'application.

7. Dans le champ Routage vers les clusters, sélectionnez le routage à cluster unique ou multicluster. En savoir plus

8. Si vous choisissez Cluster unique :

   1. Dans le menu déroulant, sélectionnez le cluster vers lequel acheminer les requêtes.

   2. Si vous devez activer les transactions à ligne unique, cochez la case Autoriser les transactions à ligne unique.

9. Si vous choisissez Multicluster :

   1. Pour acheminer les requêtes vers n'importe quel cluster de l'instance, sélectionnez Tous les clusters dans la liste déroulante Groupe de clusters.
   2. Pour limiter le routage des requêtes à certains clusters de l'instance (routage de groupe de clusters), cochez la case correspondant à chaque cluster que vous souhaitez inclure dans le groupe de routage, puis cliquez sur OK.

10. Cliquez sur Créer pour créer le profil d'application.

11. Mettez à jour le code de votre application pour vous connecter à Bigtable afin qu'il puisse utiliser le nouveau profil d'application.

gcloud

1. Si vous ne connaissez pas l'ID d'instance, utilisez la commande bigtable instances list pour afficher la liste des instances du projet:

   gcloud bigtable instances list
   

2. 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] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
       [--route-to=CLUSTER_ID] \
       [--transactional-writes]
   

   Indiquez les éléments suivants :

   • APP_PROFILE_ID : identifiant permanent du profil d'application.
   • INSTANCE_ID : identifiant permanent de l'instance.

   La commande accepte les paramètres facultatifs suivants :

   • --description=DESCRIPTION : description détaillée du profil d'application.
   • --force : permet d'ignorer les avertissements concernant des problèmes potentiels et des conflits avec d'autres profils d'application.

   • --route-any : activez le routage multicluster pour acheminer les requêtes vers n'importe quel cluster disponible.

     Vous ne pouvez pas combiner cette option avec les options --route-to ou --transactional-writes.

   • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2... : liste des clusters vers lesquels les requêtes doivent être acheminées. Utilisez cette option si vous souhaitez n'acheminer les requêtes que vers certains clusters de l'instance.

     Vous ne pouvez pas combiner cette option avec les options --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 combiner cette option avec l'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 ou --restrict-to.

3. Mettez à jour le code de votre application pour vous connecter à 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 à Bigtable.

Les exemples suivants montrent comment spécifier un profil d'application lorsqu'une application crée un client 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)

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. Bigtable vous avertit de toute mise à jour pouvant entraîner des changements de comportement inattendus.

Important : Les modifications apportées à un profil d'application prennent effet immédiatement et s'appliquent à toutes les applications qui l'utilisent. Si vous devez apporter des modifications qui ne doivent pas prendre effet immédiatement, créez un autre profil d'application et mettez à jour votre application pour qu'elle utilise ce nouveau profil pour se connecter à Bigtable. .

Pour afficher ou mettre à jour un profil d'application existant, procédez comme suit :

Console

1. Ouvrez la liste des instances Bigtable dans Google Cloud Console.

   Ouvrir la liste des instances

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

3. Mettez à jour les paramètres selon vos besoins, puis cliquez sur Enregistrer ou Annuler pour quitter sans enregistrer.

gcloud

1. Si vous ne connaissez pas l'ID d'instance, utilisez la commande bigtable instances list pour afficher la liste des instances du projet:

   gcloud bigtable instances list
   

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

3. (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 éléments suivants :

   • APP_PROFILE_ID : identifiant permanent du profil d'application.
   • INSTANCE_ID : identifiant permanent de l'instance.

4. 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] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
       [--route-to=CLUSTER_ID] \
       [--transactional-writes]
   

   Indiquez les éléments suivants :

   • APP_PROFILE_ID : identifiant permanent du profil d'application.
   • INSTANCE_ID : identifiant permanent de l'instance.

   La commande accepte les paramètres facultatifs suivants :

   • --description=DESCRIPTION : description détaillée du profil d'application.
   • --force : permet d'ignorer les avertissements concernant des problèmes potentiels et des conflits avec d'autres profils d'application.

   • --route-any : activez le routage multicluster pour acheminer les requêtes vers n'importe quel cluster disponible.

     Vous ne pouvez pas combiner cette option avec les options --route-to ou --transactional-writes.

   • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2... : liste des clusters vers lesquels les requêtes doivent être acheminées. Utilisez cette option si vous souhaitez n'acheminer les requêtes que vers certains clusters de l'instance.

     Vous ne pouvez pas combiner cette option avec les options --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 combiner cette option avec l'option --route-any.

   • --transactional-writes : permet d'activer les transactions à ligne unique dans le profil d'application.

     Vous ne pouvez pas combiner cette option avec l'option --route-any.

Supprimer un profil d'application

Vous pouvez supprimer les profils d'application d'une instance, mais pas le profil d'application par défaut.

Avertissement : Ne supprimez pas un profil d'application personnalisé qui est encore utilisé par une application. La suppression d'un profil d'application personnalisé entraîne l'échec de toutes les requêtes qui l'utilisent.

Pour supprimer un profil d'application personnalisé, procédez comme suit :

Console

1. Ouvrez la liste des instances Bigtable dans Google Cloud Console.

   Ouvrir la liste des instances

2. Cliquez sur l'instance qui contient le profil d'application que vous souhaitez supprimer.

3. Dans le volet de gauche, cliquez sur Profils d'application.

4. Ouvrez le menu Autres actions , puis cliquez sur Supprimer le profil d'application. Une boîte de dialogue de confirmation s'affiche.

5. Suivez les instructions de la boîte de dialogue de confirmation, puis cliquez sur Supprimer.

gcloud

1. Si vous ne connaissez pas l'ID d'instance, utilisez la commande bigtable instances list pour afficher la liste des instances du projet:

   gcloud bigtable instances list
   

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

3. 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 éléments suivants :

   • APP_PROFILE_ID : identifiant permanent du profil d'application.
   • INSTANCE_ID : identifiant permanent de l'instance.

   La commande accepte l'indicateur facultatif suivant :

   --force : permet d'ignorer les avertissements concernant des problèmes potentiels et des conflits avec d'autres profils d'application.