Modifier une instance

Une fois que vous avez créé une instance Bigtable, vous pouvez mettre à jour les paramètres suivants sans aucun temps d'arrêt :

  • Édition

    Vous pouvez passer à Enterprise Plus ou à Enterprise.

  • En mémoire (Aperçu)

    Vous pouvez activer ou désactiver le niveau en mémoire pour un cluster dans une instance.

  • Autoscaling

    Vous pouvez activer ou désactiver l'autoscaling pour les clusters d'une instance, ou configurer les paramètres des clusters où l'autoscaling est déjà activé.

  • Le nombre de nœuds dans les clusters avec scaling manuel

    Une fois que vous avez ajouté ou supprimé des nœuds, l'optimisation des performances du cluster par Bigtable prend généralement quelques minutes en cas de charge élevée.

  • Le nombre de clusters dans l'instance

    Une fois que vous avez ajouté un cluster, Bigtable met du temps à répliquer vos données sur le nouveau cluster. Les nouveaux clusters sont dupliqués à partir du cluster géographiquement le plus proche de l'instance. En général, plus la distance est grande, plus la réplication prend du temps.

  • Les profils d'application de l'instance, qui contiennent les paramètres de réplication

  • L'emplacement de vos données

  • Les étiquettes de l'instance, qui fournissent des métadonnées sur l'instance

  • Le nom à afficher de l'instance

Vous ne pouvez modifier un ID de cluster qu'en supprimant et en recréant le cluster.

Pour modifier l'un des éléments suivants, vous devez créer une instance avec les paramètres de votre choix. exporter vos données à partir de l'ancienne instance ; Importez vos données dans la nouvelle instance. et supprimez l'ancienne instance.

  • ID d'instance

  • Type de stockage (SSD ou HDD)

  • Configuration d'une clé de chiffrement gérée par le client (CMEK)

Avant de commencer

Si vous souhaitez utiliser les interfaces de ligne de commande pour Bigtable, installez Google Cloud CLI et la CLI cbt , si ce n'est déjà fait.

Changer d'édition

Vous pouvez passer d'une édition à l'autre en passant à Enterprise Plus ou en revenant à Enterprise.

Passer à Enterprise Plus

Une fois l'édition modifiée, Bigtable met automatiquement à jour la facturation et vous avez immédiatement accès aux fonctionnalités Enterprise Plus.

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance Enterprise que vous souhaitez mettre à niveau, puis sur Modifier l'instance.

  3. Dans la section Édition, sélectionnez Enterprise Plus.

  4. Cliquez sur Enregistrer.

  5. Facultatif : activez le niveau en mémoire.

gcloud

Utilisez la commande bigtable instances update pour modifier l'édition :

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE_PLUS

Indiquez les éléments suivants :

  • INSTANCE_ID : identifiant permanent de l'instance.

Passer à Enterprise

Pour passer d'Enterprise Plus à Enterprise, vous devez désactiver les fonctionnalités exclusives à Enterprise Plus. Une fois l'édition modifiée, Bigtable met automatiquement à jour la facturation et vous perdez l'accès aux fonctionnalités Enterprise Plus.

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance Enterprise que vous souhaitez rétrograder, puis sur Modifier l'instance.

  3. Dans la section Édition, sélectionnez Enterprise.

  4. Cliquez sur Enregistrer.

gcloud

Utilisez la commande bigtable instances update pour modifier l'édition :

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE

Indiquez les éléments suivants :

  • INSTANCE_ID : identifiant permanent de l'instance.

Configurer la mémoire

Vous pouvez activer ou désactiver le niveau en mémoire, ou afficher des informations le concernant.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer le niveau en mémoire, demandez à votre administrateur de vous accorder le rôle IAM (Identity and Access Management) Administrateur Bigtable (roles/bigtable.admin) sur l'instance.

Ce rôle prédéfini contient les autorisations dont Bigtable a besoin pour fonctionner avec le niveau en mémoire. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

  • bigtable.memoryLayer.get
  • bigtable.memoryLayer.list
  • bigtable.memoryLayer.update

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

Pour en savoir plus sur les rôles et les autorisations Bigtable, consultez Contrôle des accès avec IAM.

Activer le niveau en mémoire

Dans l'édition Enterprise Plus, vous pouvez activer le niveau en mémoire sur un cluster. Pour utiliser le niveau en mémoire, vous devez utiliser un profil d'application que vous avez configuré pour la mémoire. Pour en savoir plus, consultez Présentation d'In-Memory.

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance Enterprise que vous souhaitez mettre à jour, puis sur Modifier l'instance.

  3. Cliquez sur Modifier le cluster pour le cluster dans lequel vous souhaitez activer le niveau en mémoire.

  4. Sélectionnez Activer le stockage en mémoire.

  5. Cliquez sur Enregistrer.

gcloud

Dans l'édition Enterprise Plus, pour activer le niveau en mémoire sur un cluster, utilisez la commande gcloud beta bigtable memory-layers update. 

gcloud beta bigtable memory-layers update CLUSTER_ID \
    --instance=INSTANCE_ID --enable

Indiquez les éléments suivants :

  • CLUSTER_ID : identifiant permanent du cluster.
  • INSTANCE_ID : identifiant permanent de l'instance.

Désactiver le niveau en mémoire

Avant de passer d'Enterprise Plus à Enterprise, vous devez désactiver le niveau en mémoire.

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance Enterprise que vous souhaitez mettre à jour, puis sur Modifier l'instance.

  3. Cliquez sur Modifier le cluster pour le cluster dans lequel vous souhaitez désactiver le niveau en mémoire.

  4. Désactivez l'option Activer le stockage en mémoire.

  5. Cliquez sur Enregistrer.

gcloud

Pour désactiver le niveau en mémoire sur un cluster, utilisez la commande gcloud beta bigtable memory-layers update.

gcloud beta bigtable memory-layers update CLUSTER_ID \
    --instance=INSTANCE_ID --disable

Indiquez les éléments suivants :

  • CLUSTER_ID : identifiant permanent du cluster.
  • INSTANCE_ID : identifiant permanent de l'instance.

Afficher des informations sur le niveau en mémoire

Vous pouvez afficher l'état et la capacité du niveau en mémoire d'un cluster.

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'ID de l'instance contenant le cluster que vous souhaitez afficher.

  3. Dans le tableau du cluster, affichez la colonne En mémoire de votre cluster.

gcloud

Pour afficher des informations sur le niveau en mémoire d'un cluster, comme l'état en mémoire, utilisez la commande gcloud beta bigtable memory-layers describe. 

gcloud beta bigtable memory-layers describe CLUSTER_ID \
    --instance=INSTANCE_ID

Indiquez les éléments suivants :

  • CLUSTER_ID : identifiant permanent du cluster.
  • INSTANCE_ID : identifiant permanent de l'instance.

Configurer l'autoscaling

Vous pouvez activer ou désactiver l'autoscaling pour tout cluster existant. Vous pouvez également modifier l'objectif d'utilisation du processeur, le nombre minimal de nœuds et le nombre maximal de nœuds pour un cluster. Pour obtenir des conseils sur le choix des paramètres d'autoscaling, consultez la page Autoscaling. Vous ne pouvez pas utiliser la CLI cbt pour configurer l'autoscaling.

Activer l'autoscaling

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance à modifier, puis sur Modifier l'instance.

  3. Sous Configurer les clusters, cliquez sur Modifier pour le cluster que vous souhaitez mettre à jour.

  4. Sélectionnez Autoscaling.

  5. Saisissez les valeurs suivantes :

    • Nombre minimal de nœuds
    • Nombre maximal de nœuds
    • Objectif d'utilisation du CPU
    • Objectif d'utilisation du stockage

  6. 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 les ID des clusters de l'instance, exécutez la commande bigtable clusters list pour afficher la liste des clusters de l'instance :

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

  3. Exécutez la commande bigtable clusters update pour activer l'autoscaling :

    gcloud bigtable clusters update CLUSTER_ID \
    --instance=INSTANCE_ID \
    --autoscaling-max-nodes=AUTOSCALING_MAX_NODES \
    --autoscaling-min-nodes=AUTOSCALING_MIN_NODES \
    --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \
    --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET

    Indiquez les éléments suivants :

    • CLUSTER_ID : identifiant permanent du cluster.
    • INSTANCE_ID : identifiant permanent de l'instance.
    • AUTOSCALING_MAX_NODES : nombre minimal de nœuds
    • AUTOSCALING_MIN_NODES : nombre maximal de nœuds
    • AUTOSCALING_CPU_TARGET : pourcentage cible d'utilisation du processeur que Bigtable gère en ajoutant ou en supprimant des nœuds. Cette valeur doit être comprise entre 10 et 80.

    • AUTOSCALING_STORAGE_TARGET: cible d'utilisation du stockage en Gio par nœud que Bigtable gère en ajoutant ou en supprimant des nœuds

      Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

Désactiver l'autoscaling

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance à modifier, puis sur Modifier l'instance.

  3. Sous Configurer les clusters, cliquez sur pour le cluster que vous souhaitez mettre à jour.

  4. Sélectionnez Allocation de nœuds manuel.

  5. Saisissez le nombre de nœuds du cluster dans le champ Quantité.

    Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

  6. 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 les ID des clusters de l'instance, exécutez la commande bigtable clusters list pour afficher la liste des clusters de l'instance :

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

  3. Utilisez la commande bigtable clusters update pour désactiver l'autoscaling et configurer un nombre constant de nœuds :

    gcloud bigtable clusters update CLUSTER_ID \
    --instance=INSTANCE_ID \
    --num-nodes=NUM_NODES --disable-autoscaling

    Indiquez les éléments suivants :

    • CLUSTER_ID : identifiant permanent du cluster.
    • INSTANCE_ID : identifiant permanent de l'instance.

    • NUM_NODES : ce champ est facultatif. Si aucune valeur n'est définie, Bigtable alloue automatiquement des nœuds en fonction de l'empreinte de vos données et optimise l'utilisation du stockage à 50 %. Si vous souhaitez contrôler le nombre de nœuds dans un cluster, mettez à jour la valeur NUM_NODES. Assurez-vous que le nombre de nœuds est défini sur une valeur non nulle.

      Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

Modifier les paramètres d'autoscaling

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance à modifier, puis sur Modifier l'instance.

  3. Sous Configurer les clusters, cliquez sur pour le cluster que vous souhaitez mettre à jour.

  4. Saisissez de nouvelles valeurs pour l'une des options de modification que vous souhaitez modifier :

    • Nombre minimal de nœuds
    • Nombre maximal de nœuds
    • Objectif d'utilisation du CPU
    • Objectif d'utilisation du stockage

  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 les ID des clusters de l'instance, exécutez la commande bigtable clusters list pour afficher la liste des clusters de l'instance :

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

  3. Exécutez la commande bigtable clusters update pour mettre à jour les paramètres d'autoscaling :

    gcloud bigtable clusters update CLUSTER_ID \
    --instance=INSTANCE_ID \
    --autoscaling-max-nodes=AUTOSCALING_MAX_NODES \
    --autoscaling-min-nodes=AUTOSCALING_MIN_NODES \
    --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \
    --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET

    Indiquez les éléments suivants :

    • CLUSTER_ID : identifiant permanent du cluster.
    • INSTANCE_ID : identifiant permanent de l'instance.

    La commande accepte des options d'autoscaling facultatives. Vous pouvez utiliser tous les indicateurs ou uniquement les indicateurs pour les valeurs que vous souhaitez modifier.

    • AUTOSCALING_MAX_NODES : nombre minimal de nœuds
    • AUTOSCALING_MIN_NODES : nombre maximal de nœuds
    • AUTOSCALING_CPU_TARGET : pourcentage cible d'utilisation du processeur que Bigtable gère en ajoutant ou en supprimant des nœuds. Cette valeur doit être comprise entre 10 et 80.

    • AUTOSCALING_STORAGE_TARGET: cible d'utilisation du stockage en Gio par nœud que Bigtable gère en ajoutant ou en supprimant des nœuds.

      Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

Ajouter ou supprimer des nœuds manuellement

Dans la plupart des cas, nous vous recommandons d'activer l'autoscaling. Si vous choisissez de ne pas le faire et que le mode de scaling des nœuds de votre cluster est manuel, vous pouvez ajouter ou supprimer des nœuds. Le nombre de nœuds reste constant jusqu'à ce que vous le modifiiez. Pour connaître les quotas de nœuds par défaut par zone et par projet Google Cloud , consultez la page Quotas de nœuds. Si vous devez dépasser la limite par défaut, vous pouvez en demander davantage.

Pour modifier le nombre de nœuds dans un cluster qui utilise le scaling manuel, 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 à modifier, puis sur Modifier l'instance.

  3. Sous Configurer les clusters, cliquez sur Modifier pour le cluster que vous souhaitez mettre à jour.

  4. Dans la section Allocation manuelle des nœuds, saisissez le nombre de nœuds du cluster dans le champ Quantité.

    Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

  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 les ID des clusters de l'instance, exécutez la commande bigtable clusters list pour afficher la liste des clusters de l'instance :

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

  3. Exécutez la commande bigtable clusters update pour modifier le nombre de nœuds :

    gcloud bigtable clusters update CLUSTER_ID \
    --instance=INSTANCE_ID \
    --num-nodes=NUM_NODES

    Indiquez les éléments suivants :

    • CLUSTER_ID : identifiant permanent du cluster.
    • INSTANCE_ID : identifiant permanent de l'instance.

    • NUM_NODES : ce champ est facultatif. Si aucune valeur n'est définie, Bigtable alloue automatiquement des nœuds en fonction de l'empreinte de vos données et optimise l'utilisation du stockage à 50 %. Si vous souhaitez contrôler le nombre de nœuds dans un cluster, mettez à jour la valeur NUM_NODES. Assurez-vous que le nombre de nœuds est défini sur une valeur non nulle.

      Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

cbt

  1. Si vous ne connaissez pas l'ID d'instance, exécutez la commande listinstances pour afficher la liste des instances du projet :

    cbt listinstances

  2. Si vous ne connaissez pas les ID des clusters de l'instance, exécutez la commande listclusters pour afficher la liste des clusters de l'instance :

    cbt -instance=INSTANCE_ID listclusters

    Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

  3. Exécutez la commande updatecluster pour modifier le nombre de nœuds :

    cbt -instance=INSTANCE_ID updatecluster CLUSTER_ID NUM_NODES

    Indiquez les éléments suivants :

    • INSTANCE_ID : identifiant permanent de l'instance.
    • CLUSTER_ID : identifiant permanent du cluster.

    • NUM_NODES : ce champ est facultatif. Si aucune valeur n'est définie, Bigtable alloue automatiquement des nœuds en fonction de l'empreinte de vos données et optimise l'utilisation du stockage à 50 %. Si vous souhaitez contrôler le nombre de nœuds dans un cluster, mettez à jour la valeur NUM_NODES. Assurez-vous que le nombre de nœuds est défini sur une valeur non nulle.

      Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

Ajouter un cluster

Vous pouvez ajouter des clusters à une instance existante. Une instance peut comporter des clusters dans huit régions au maximum, où Bigtable est disponible. Chaque zone d'une région ne peut contenir qu'un seul cluster. Les emplacements idéaux pour des clusters supplémentaires dépendent de votre cas d'utilisation.

Si votre instance est protégée par une clé CMEK, chaque nouveau cluster doit utiliser une clé CMEK située dans la même région que le cluster. Avant d'ajouter un cluster à une instance protégée par une clé CMEK, identifiez ou créez une clé CMEK dans la région où vous prévoyez de localiser le cluster.

Avant d'ajouter des clusters à une instance à cluster unique, consultez les restrictions qui s'appliquent lorsque vous modifiez les stratégies de récupération de mémoire des tables répliquées. Consultez ensuite la page Exemples de paramètres de réplication pour obtenir des recommandations.

Pour ajouter un cluster à une instance, 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 à modifier, puis sur Modifier l'instance.

  3. Sous Configurer les clusters, cliquez sur Ajouter un cluster.

    Si ce bouton est désactivé, l'instance a déjà le nombre maximal de clusters.

  4. Entrez un ID de cluster pour le premier cluster.

    L'ID de cluster est un identifiant permanent pour le cluster.

  5. Choisissez la région et la zone dans lesquelles le premier cluster sera exécuté.

  6. Facultatif : Pour configurer le cluster afin qu'il effectue toujours un scaling par incréments de deux nœuds, sélectionnez Activer le scaling de nœuds X2. Pour en savoir plus, consultez Facteur de scaling des nœuds.

  7. Choisissez un mode de scaling des nœuds pour le cluster. Dans la plupart des cas, vous devez choisir l'autoscaling. Pour obtenir des conseils de scaling, consultez la section Autoscaling.

    1. Dans le champ Allocation de nœuds manuel, saisissez le nombre de nœuds Bigtable pour le premier cluster. Si vous ne savez pas de combien de nœuds vous avez besoin, utilisez la valeur par défaut. Vous pourrez ajouter des nœuds ultérieurement.
    2. Pour Autoscaling, saisissez les valeurs suivantes :
      • Nombre minimal de nœuds
      • Nombre maximal de nœuds
      • Objectif d'utilisation du CPU
      • Objectif d'utilisation du stockage

  8. Facultatif : Pour protéger votre instance avec des clés CMEK plutôt que d'utiliser le chiffrement géré par Google, procédez comme suit :

    1. Cliquez sur Afficher les options de chiffrement.
    2. Cochez la case d'option Clé de chiffrement gérée par le client (CMEK).
    3. Sélectionnez ou saisissez le nom de ressource de la clé CMEK que vous souhaitez utiliser pour le cluster. Vous ne pourrez pas l'ajouter ultérieurement.
    4. Si vous êtes invité à accorder l'autorisation au compte de service de la clé CMEK, cliquez sur Accorder. Pour effectuer cette tâche, votre compte utilisateur doit disposer du rôle d'administrateur Cloud KMS.
    5. Cliquez sur Enregistrer.

  9. Entrez le nombre de nœuds du cluster.

    Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

  10. Si l'instance est protégée par une clé CMEK, sélectionnez ou fournissez une clé gérée par le client. La clé CMEK doit se trouver dans la même région que le cluster.

  11. Cliquez sur Ajouter.

  12. Répétez ces étapes pour chaque cluster supplémentaire, puis cliquez sur Enregistrer. Bigtable crée le cluster et commence à répliquer les données vers le nouveau cluster. L'utilisation du processeur peut augmenter lorsque la réplication commence.

  13. Vérifiez les paramètres de réplication dans le profil d'application par défaut pour vérifier qu'ils sont adaptés à votre cas d'utilisation de la réplication. Vous devrez peut-être mettre à jour le profil d'application par défaut ou créer des profils d'application personnalisés.

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 les ID des clusters de l'instance, exécutez la commande bigtable clusters list pour afficher la liste des clusters de l'instance :

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

  3. Exécutez la commande bigtable clusters create pour ajouter un cluster :

    gcloud bigtable clusters create CLUSTER_ID \
    --async \
    --instance=INSTANCE_ID \
    --zone=ZONE \
    [--num-nodes=NUM_NODES] \
    [--autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \
    --autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \
    --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \
    --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET] \
    [--kms-key=KMS_KEY --kms-keyring=KMS_KEYRING \
    --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] \

    Indiquez les éléments suivants :

    • CLUSTER_ID : identifiant permanent du cluster.
    • INSTANCE_ID : identifiant permanent de l'instance.

    • ZONE : zone dans laquelle le cluster est exécuté.

      Chaque zone d'une région ne peut contenir qu'un seul cluster. Par exemple, si une instance dispose d'un cluster dans la région us-east1-b, vous pouvez ajouter un cluster dans une autre zone de la même région, telle que us-east1-c, ou dans une zone située dans une région distincte. Par exemple, europe-west2-a. Voir la liste des zones

    L'option --async n'est pas obligatoire, mais elle est fortement recommandée. Sans ce paramètre, la commande peut expirer avant la fin de l'opération. Bigtable continuera à créer le cluster en arrière-plan.

    La commande accepte les options facultatives suivantes :

    • --kms-key=KMS_KEY : clé CMEK utilisée par l'instance. Vous pouvez uniquement ajouter des clusters utilisant des clés CMEK aux instances déjà protégées de la sorte.
    • --kms-keyring=KMS_KEYRING : ID du trousseau de clés KMS de la clé
    • --kms-location=KMS_LOCATION : emplacement Google Cloud de la clé.
    • --kms-project=KMS_PROJECT : ID du projet Google Cloud pour la clé.
    • --storage-type=STORAGE_TYPE : type de stockage à utiliser pour le cluster. Chaque cluster d'une instance doit utiliser le même type de stockage. Accepte les valeurs SSD et HDD. La valeur par défaut est SSD.
    • --node-scaling-factor=node-scaling-factor-2x : indicateur qui active la mise à l'échelle des nœuds par deux. Vous pouvez activer cette fonctionnalité avec le scaling manuel et l'autoscaling.

    Pour afficher la liste des zones Bigtable qui ne sont pas disponibles pour le scaling de nœuds par deux, consultez Limites du facteur de scaling des nœuds.

    Si aucune valeur n'est définie pour l'option --num-nodes, Bigtable alloue automatiquement des nœuds au cluster en fonction de l'empreinte de vos données et optimise l'utilisation du stockage à 50 %. Cette allocation automatique de nœuds a un impact sur les tarifs. Si vous souhaitez contrôler le nombre de nœuds dans un cluster, mettez à jour la valeur NUM_NODES. Assurez-vous que le nombre de nœuds est défini sur une valeur non nulle. Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

    Pour l'autoscaling, fournissez toutes les options autoscaling- et n'utilisez pas num-nodes. Consultez la section Autoscaling pour savoir comment choisir les valeurs de vos paramètres d'autoscaling. Remplacez les éléments suivants :

    • AUTOSCALING_MIN_NODES : nombre minimal de nœuds pour le cluster.
    • AUTOSCALING_MAX_NODES : nombre maximal de nœuds pour le cluster.
    • AUTOSCALING_CPU_TARGET : utilisation du processeur pour le cluster. Cette valeur doit être comprise entre 10 et 80.
    • AUTOSCALING_STORAGE_TARGET : cible d'utilisation du stockage en Gio, gérée par Bigtable, en ajoutant ou en supprimant des nœuds

  4. Vérifiez les paramètres de réplication dans le profil d'application par défaut pour vérifier qu'ils sont adaptés à votre cas d'utilisation de la réplication. Vous devrez peut-être mettre à jour le profil d'application par défaut ou créer des profils d'application personnalisés.

cbt

  1. Si vous ne connaissez pas l'ID d'instance, exécutez la commande listinstances pour afficher la liste des instances du projet :

    cbt listinstances

  2. Si vous ne connaissez pas les ID des clusters de l'instance, exécutez la commande listclusters pour afficher la liste des clusters de l'instance :

    cbt -instance=INSTANCE_ID listclusters

    Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

  3. Exécutez la commande createcluster pour ajouter un cluster :

    
cbt -instance=INSTANCE_ID \
createcluster CLUSTER_ID \
ZONE \
NUM_NODES \
STORAGE_TYPE

    Indiquez les éléments suivants :

    • INSTANCE_ID : identifiant permanent de l'instance.
    • CLUSTER_ID : identifiant permanent du cluster.

    • ZONE : zone dans laquelle le cluster est exécuté.

      Chaque zone d'une région ne peut contenir qu'un seul cluster. Par exemple, si une instance dispose d'un cluster dans la région us-east1-b, vous pouvez ajouter un cluster dans une autre zone de la même région, telle que us-east1-c, ou dans une zone située dans une région distincte. Par exemple, europe-west2-a. Voir la liste des zones

    • NUM_NODES : ce champ est facultatif. Si aucune valeur n'est définie, Bigtable alloue automatiquement des nœuds en fonction de l'empreinte de vos données et optimise l'utilisation du stockage à 50 %. Si vous souhaitez contrôler le nombre de nœuds dans un cluster, mettez à jour la valeur NUM_NODES. Assurez-vous que le nombre de nœuds est défini sur une valeur non nulle.

      Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

    • STORAGE_TYPE : type de stockage à utiliser pour le cluster. Chaque cluster d'une instance doit utiliser le même type de stockage. Accepte les valeurs SSD et HDD.

  4. Vérifiez les paramètres de réplication dans le profil d'application par défaut pour vérifier qu'ils sont adaptés à votre cas d'utilisation de la réplication. Vous devrez peut-être mettre à jour le profil d'application par défaut ou créer des profils d'application personnalisés.

Supprimer un cluster

Si une instance comporte plusieurs clusters, vous pouvez supprimer tous les clusters sauf un. La suppression de tous les clusters sauf un désactive automatiquement la réplication.

Dans certains cas, Bigtable ne vous permet pas de supprimer un cluster :

  • Si l'un de vos profils d'application achemine tout le trafic vers un seul cluster, Bigtable ne vous permet pas de supprimer ce cluster. Vous devez modifier ou supprimer le profil d'application pour pouvoir supprimer le cluster.
  • Si vous ajoutez de nouveaux clusters à une instance existante, vous ne pouvez pas supprimer de clusters dans cette instance tant que la copie de données initiale dans les nouveaux clusters n'est pas terminée.

Pour supprimer un cluster d'une instance :

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance à modifier, puis sur Modifier l'instance.

  3. Sous Configurer les clusters, cliquez sur Supprimer le cluster pour le cluster que vous souhaitez supprimer.

  4. Pour annuler l'opération de suppression, cliquez sur Annuler, qui est disponible jusqu'à ce que vous cliquiez sur Enregistrer. Sinon, 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 les ID des clusters de l'instance, exécutez la commande bigtable clusters list pour afficher la liste des clusters de l'instance :

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

  3. Exécutez la commande bigtable clusters delete pour supprimer le cluster :

    gcloud bigtable clusters delete CLUSTER_ID \
    --instance=INSTANCE_ID

    Indiquez les éléments suivants :

    • CLUSTER_ID : identifiant permanent du cluster.
    • INSTANCE_ID : identifiant permanent de l'instance.

cbt

  1. Si vous ne connaissez pas l'ID d'instance, exécutez la commande listinstances pour afficher la liste des instances du projet :

    cbt listinstances

  2. Si vous ne connaissez pas les ID des clusters de l'instance, exécutez la commande listclusters pour afficher la liste des clusters de l'instance :

    cbt -instance=INSTANCE_ID listclusters

    Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

  3. Exécutez la commande deletecluster pour supprimer le cluster :

    cbt -instance=INSTANCE_ID deletecluster CLUSTER_ID

    Indiquez les éléments suivants :

    • INSTANCE_ID : identifiant permanent de l'instance.
    • CLUSTER_ID : identifiant permanent du cluster.

Déplacer les données vers un nouvel emplacement

Pour déplacer les données d'une instance Bigtable vers une nouvelle zone ou région, ajoutez un nouveau cluster à l'emplacement souhaité, puis supprimez le cluster à l'emplacement depuis lequel vous souhaitez déplacer les données. Le cluster supprimé reste disponible jusqu'à ce que les données soient répliquées sur le nouveau cluster. Vous n'avez donc pas à vous soucier d'un quelconque échec de requête. Bigtable réplique automatiquement toutes les données sur le nouveau cluster.

Gérer les profils d'application

Les profils d'application contrôlent la manière dont vos applications se connectent à une instance utilisant la réplication. Chaque instance comportant plusieurs clusters dispose de son propre profil d'application par défaut. Vous pouvez également créer de nombreux profils d'application personnalisés différents pour chaque instance, en utilisant un profil d'application particulier pour chaque type d'application que vous exécutez.

Pour apprendre à configurer les profils d'application d'une instance, consultez la page Configurer des profils d'application. Pour découvrir des exemples de paramètres à utiliser pour mettre en œuvre des cas d'utilisation courants, consultez Exemples de configurations de réplication.

Gérer les libellés

Les étiquettes sont des paires valeur/clé que vous pouvez utiliser pour regrouper des instances associées et stocker des métadonnées sur une instance.

Pour apprendre à gérer les libellés, consultez les sections Ajouter ou mettre à jour les libellés d'une instance et Supprimer un libellé d'une instance.

Changer le nom à afficher d'une instance

Pour changer le nom à afficher d'une instance, que la console Google Cloud utilise pour identifier l'instance :

Console

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

    Ouvrir la liste des instances

  2. Cliquez sur l'instance à modifier, puis sur Modifier l'instance.

  3. Modifiez le nom de l'instance, 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. Exécutez la commande bigtable instances update pour mettre à jour le nom à afficher :

    gcloud bigtable instances update INSTANCE_ID \
    --display-name=DISPLAY_NAME

    Indiquez les éléments suivants :

    • INSTANCE_ID : identifiant permanent de l'instance.
    • DISPLAY_NAME : nom lisible permettant d'identifier l'instance dans la console Google Cloud .

cbt

Cette fonctionnalité n'est pas disponible dans la CLI cbt.

Étape suivante