Créer et configurer des profils d'application

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

Avant de lire cette page, comprenez ce que sont les profils d'application et comment ils fonctionnent. En particulier, assurez-vous de comprendre la différence entre un profil d'application standard (un profil d'application que vous configurez pour utiliser le calcul standard) et un profil d'application Data Boost (un profil d'application qui utilise le calcul sans serveur Data Boost pour exécuter des jobs de lecture à haut débit). Pour en savoir plus sur Data Boost et sur la différence avec le calcul à l'aide de nœuds de cluster provisionnés, consultez la présentation de Data Boost.

Si vous utilisez des profils d'application standards pour configurer la réplication, familiarisez-vous avec la présentation de la réplication Bigtable, consultez les exemples de paramètres de réplication et choisissez les paramètres les mieux adaptés à votre cas d'utilisation.

Si vous utilisez des profils d'application standards avec le niveau en mémoire (Preview), familiarisez-vous avec la présentation du niveau en mémoire.

Rôles requis

Pour obtenir les autorisations nécessaires pour créer, configurer ou supprimer un profil d'application, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Bigtable (roles/bigtable.admin) sur l'instance. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

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.

Créer un profil d'application standard

Pour créer un profil d'application standard :

Console

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

    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. Sélectionnez Standard.

  6. Cliquez sur Suivant.

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

  8. Saisissez une description du profil d'application.

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

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

  11. Si vous choisissez Multicluster :

    1. Pour acheminer les requêtes vers n'importe quel cluster de l'instance, sélectionnez Tous les clusters dans le menu déroulant 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.
  12. Cliquez sur Créer pour créer le profil d'application.

  13. 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, exécutez 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] \
        [--priority=PRIORITY] \
        [--row-affinity]
    

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

    • --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 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 seul cluster.

      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 ou --restrict-to.

    • --priority=PRIORITY : niveau de priorité que le profil d'application doit utiliser. Les valeurs acceptées sont PRIORITY_HIGH, PRIORITY_MEDIUM ou PRIORITY_LOW.

    • --row-affinity : permet d'activer le routage avec affinité de ligne dans le profil d'application.

      Vous ne pouvez pas associer cette option à --route-to ou --transactional-writes.

  3. Mettez à jour le code de votre application pour établir la connexion à Bigtable, afin qu'il puisse utiliser le nouveau profil d'application.

Créer un profil d'application standard avec le niveau en mémoire

Pour créer un profil d'application standard sur un cluster avec le niveau en mémoire activé, procédez comme suit :

Console

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

    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. Sélectionnez Standard avec niveau en mémoire.

  6. Cliquez sur Suivant.

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

  8. Saisissez une description du profil d'application.

  9. Sous Routage vers les clusters, sélectionnez un cluster sur lequel le niveau en mémoire est activé.

    Les clusters en mémoire doivent utiliser le routage à cluster unique.

  10. Si vous devez activer les transactions à ligne unique, sélectionnez Autoriser les transactions à ligne unique.

  11. Sous Sélectionner une priorité de routage, attribuez une priorité de routage à vos demandes en sélectionnant l'une des options suivantes :

    • Élevée : à utiliser pour les requêtes sensibles à la latence
    • Moyenne : à utiliser pour les demandes à usage général
    • Faible : à utiliser pour les tâches en arrière-plan ou les opérations moins urgentes
  12. Cliquez sur Créer pour créer le profil d'application.

  13. 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, exécutez la commande bigtable instances list pour afficher la liste des instances du projet :

    gcloud bigtable instances list
    
  2. Utilisez la commande gcloud beta bigtable app-profiles create pour créer un profil d'application :

    gcloud beta bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --route-to=CLUSTER_ID \
        --use-memory-layer \
        [--description=DESCRIPTION] \
        [--transactional-writes] \
        [--priority=PRIORITY]
    

    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 options facultatives suivantes :

    • --route-to=CLUSTER_ID : ID du cluster vers lequel toutes les demandes doivent être acheminées. Cette option active le routage vers un seul cluster.
    • --use-memory-layer : routez les requêtes avec ce profil d'application vers le niveau en mémoire. Cette option est limitée à l'édition Enterprise Plus et au routage vers un seul cluster.
    • --description=DESCRIPTION : description détaillée du profil d'application.
    • --transactional-writes : permet d'activer les transactions à ligne unique dans le profil d'application.
    • --priority=PRIORITY : niveau de priorité des requêtes envoyées à l'aide du profil d'application. Les valeurs acceptées sont PRIORITY_HIGH, PRIORITY_MEDIUM ou PRIORITY_LOW. Les priorités des requêtes n'ont pas d'incidence sur les requêtes éligibles au niveau en mémoire.
  3. Mettez à jour le code de votre application pour établir la connexion à Bigtable, afin qu'il puisse utiliser le nouveau profil d'application.

Créer un profil d'application Data Boost

Pour créer un profil d'application Data Boost (un profil d'application qui utilise le calcul sans serveur Data Boost), suivez ces étapes. Pour vous assurer que votre charge de travail est compatible avec Data Boost, consultez les limites.

Console

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

    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. Sélectionnez Data Boost.

  6. Cliquez sur Suivant.

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

  8. Saisissez une description du profil d'application.

  9. Sous Routage vers les clusters, sélectionnez le cluster vers lequel acheminer les requêtes.

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

  11. Mettez à jour le code de votre application pour établir la connexion à Bigtable, afin qu'il puisse utiliser le nouveau profil d'application.

gcloud

  1. 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
    
  2. Utilisez la commande gcloud beta bigtable app-profiles create pour créer un profil d'application :

    gcloud bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --data-boost \
        --data-boost-compute-billing-owner=HOST_PAYS \
        --route-to=CLUSTER_ID
    

    Indiquez les éléments suivants :

    • APP_PROFILE_ID : identifiant permanent du profil d'application.
    • INSTANCE_ID : identifiant permanent de l'instance.
    • CLUSTER_ID : ID du cluster vers lequel toutes les demandes doivent être acheminées. Cette option active le routage vers un seul cluster.

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.

Pour savoir comment passer d'un profil d'application standard à un profil Data Boost ou inversement, consultez Convertir un profil d'application.

Mettre à jour un profil d'application standard

Pour modifier un profil d'application standard :

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance contenant le profil d'application que vous souhaitez mettre à jour.

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

  4. Cliquez sur Modifier le profil d'application pour le profil d'application que vous souhaitez mettre à jour.

  5. Mettez à jour les paramètres si nécessaire.

  6. Cliquez sur Enregistrer ou, pour quitter sans enregistrer, cliquez sur Annuler.

gcloud

  1. 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
    
  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] \
        [--row-affinity]
    

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

    • --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 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 seul cluster.

      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.

    • --priority=PRIORITY : niveau de priorité utilisé par le profil d'application. Les valeurs acceptées sont PRIORITY_HIGH, PRIORITY_MEDIUM ou PRIORITY_LOW.

Mettre à jour un profil d'application standard avec le niveau en mémoire

Pour mettre à jour un profil d'application standard sur un cluster avec le niveau en mémoire activé, procédez comme suit :

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance contenant le profil d'application que vous souhaitez mettre à jour.

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

  4. Cliquez sur Modifier le profil d'application pour le profil d'application que vous souhaitez mettre à jour.

  5. Mettez à jour les paramètres si nécessaire.

  6. Cliquez sur Enregistrer ou, pour quitter sans enregistrer, cliquez sur Annuler.

gcloud

  1. 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
    
  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 gcloud 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 gcloud beta bigtable app-profiles update pour mettre à jour les paramètres du profil d'application :

    gcloud beta bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --route-to=CLUSTER_ID \
        [--description=DESCRIPTION] \
        [--transactional-writes] \
        [--priority=PRIORITY] \
        [--use-memory-layer] \
        [--no-use-memory-layer]
    

    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 options facultatives suivantes :

    • --description=DESCRIPTION : description détaillée du profil d'application.
    • --route-to=CLUSTER_ID : ID du cluster vers lequel toutes les demandes doivent être acheminées. Cette option active le routage vers un seul cluster.
    • --transactional-writes : permet d'activer les transactions à ligne unique dans le profil d'application.
    • --priority=PRIORITY : niveau de priorité utilisé par le profil d'application. Les valeurs acceptées sont PRIORITY_HIGH, PRIORITY_MEDIUM ou PRIORITY_LOW.
    • --use-memory-layer : routez les requêtes avec ce profil d'application vers le niveau en mémoire. Utilisez --no-use-memory-layer pour désactiver le routage en mémoire pour ce profil d'application. Cet indicateur est limité à l'édition Enterprise Plus et au routage vers un seul cluster.

Mettre à jour un profil d'application Data Boost

Pour modifier le cluster à partir duquel un profil d'application Data Boost lit les données, procédez comme suit :

Console

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

    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 sur Profils d'application dans le volet gauche.

  3. Sélectionnez le nouveau cluster vers lequel le trafic doit être redirigé, puis cliquez sur Enregistrer.

gcloud

  1. 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
    
  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 gcloud 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 gcloud beta bigtable app-profiles update pour mettre à jour les paramètres du profil d'application :

    gcloud beta bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --route-to=CLUSTER_ID
    

    Indiquez les éléments suivants :

    • APP_PROFILE_ID : identifiant permanent du profil d'application.
    • INSTANCE_ID : identifiant permanent de l'instance.
    • CLUSTER_ID : ID du nouveau cluster à partir duquel lire les données

Convertir un profil d'application

Vous pouvez convertir un profil d'application standard en profil d'application Data Boost, ou inversement. Avant de convertir un profil d'application, consultez les conseils sur les modifications apportées aux profils d'application.

Passer du mode standard à Data Boost

Avant de mettre à jour un profil d'application standard (nœuds provisionnés pour le calcul) vers le calcul sans serveur Data Boost, vérifiez les métriques d'éligibilité de Data Boost. Vous devez également tenir compte des limites de Data Boost.

Console

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

    Ouvrir la liste des instances

  2. Dans la colonne Profils d'application, cliquez sur le profil que vous souhaitez modifier.

    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 sur Profils d'application dans le volet gauche.

  3. Sélectionnez Data Boost.

  4. Sélectionnez le cluster vers lequel les requêtes doivent être acheminées.

  5. Cliquez sur Enregistrer.

gcloud

  1. 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
    
  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 gcloud beta bigtable app-profiles update pour convertir un profil d'application standard en profil Data Boost :

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --data-boost \
        --data-boost-compute-billing-owner=HOST_PAYS \
        --route-to=CLUSTER_ID
    

    Indiquez les éléments suivants :

    • APP_PROFILE_ID : identifiant permanent du profil d'application.
    • INSTANCE_ID : identifiant permanent de l'instance.
    • CLUSTER_ID : ID du cluster vers lequel toutes les demandes doivent être acheminées. Cette option active le routage vers un seul cluster.

Passer de Data Boost à Standard

Pour passer d'un profil d'application utilisant Data Boost (calcul sans serveur) à un profil standard (nœuds provisionnés pour le calcul), procédez comme suit :

Console

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

    Ouvrir la liste des instances

  2. Dans la colonne Profils d'application, cliquez sur le profil que vous souhaitez modifier.

    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 sur Profils d'application dans le volet gauche.

  3. Sélectionnez Standard.

  4. Cliquez sur Suivant.

  5. Facultatif : modifiez la description du profil d'application.

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

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

  8. Si vous choisissez Multicluster :

    1. Pour acheminer les requêtes vers n'importe quel cluster de l'instance, sélectionnez Tous les clusters dans le menu déroulant 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.
  9. Cliquez sur Enregistrer.

gcloud

  1. 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
    
  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
    
  4. Utilisez la commande gcloud beta bigtable app-profiles update pour convertir le profil d'application :

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --standard \
        [--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 options facultatives suivantes :

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

  • --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 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 seul cluster.

    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 ou --restrict-to.

Supprimer un profil d'application

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

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

    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, exécutez 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'option facultative suivante :

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