Modificar uma instância

Depois de criar uma instância do Bigtable, será possível atualizar as seguintes configurações sem inatividade:

  • Escalonamento automático

    É possível ativar ou desativar o escalonamento automático de clusters de uma instância ou definir as configurações de clusters que já têm o escalonamento automático ativado.

  • O número de nós em clusters com escalonamento manual

    Depois de você adicionar ou remover nós, normalmente levará alguns minutos sob carga para o Bigtable otimizar o desempenho do cluster.

  • o número de clusters na instância

    Depois de você adicionar um cluster, levará algum tempo para o Bigtable replicar os dados para o novo cluster. Novos clusters são replicados a partir do cluster geograficamente mais próximo na instância. Em geral, quanto maior a distância, mais longa será a replicação.

  • Os perfis de aplicativo da instância, em que estão as configurações de replicação

  • O local dos seus dados

  • os rótulos da instância, que fornecem metadados sobre a instância

  • O nome de exibição da instância

É possível alterar um ID de cluster apenas excluindo e recriando o cluster.

Para alterar qualquer um dos itens a seguir, crie uma nova instância com suas configurações de preferência. exportar os dados da instância antiga; importar os dados para a nova instância; e exclua a instância antiga.

  • ID da instância

  • Tipo de armazenamento (SSD ou HDD)

  • Configuração da chave de criptografia gerenciada pelo cliente (CMEK, na sigla em inglês)

Antes de começar

Se você quiser usar as interfaces de linha de comando do Bigtable, instale a Google Cloud CLI e a CLI cbt caso ainda não tenha feito isso.

Configure o escalonamento automático

É possível ativar ou desativar o escalonamento automático para qualquer cluster existente. Também é possível alterar a meta de utilização da CPU, o número mínimo de nós e o número máximo de nós para um cluster. Para mais orientações sobre como escolher suas configurações de escalonamento automático, consulte Escalonamento automático. Não é possível usar a CLI cbt para configurar o escalonamento automático.

Ativar o escalonamento automático

Console

  1. Abra a lista de instâncias do Bigtable no Console do Google Cloud.

    Abrir a lista de instâncias

  2. Clique na instância que você quer alterar e em Editar instância.

  3. Em Configurar clusters, clique em Editar no cluster que você quer atualizar.

  4. Selecione Escalonamento automático.

  5. Insira os seguintes valores:

    • Número mínimo de nós
    • Número máximo de nós
    • Meta de utilização da CPU
    • Meta de uso do armazenamento

  6. Clique em Save.

gcloud

  1. Se você não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do projeto: 

    gcloud bigtable instances list

  2. Se você não souber os IDs dos clusters da instância, use o comando bigtable clusters list para ver uma lista de clusters da instância: 

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando bigtable clusters update para ativar o escalonamento automático:

    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

    Preencha o seguinte:

    • CLUSTER_ID: identificador permanente do cluster.
    • INSTANCE_ID: identificador permanente da instância
    • AUTOSCALING_MAX_NODES: o número mínimo de nós
    • AUTOSCALING_MIN_NODES: o número máximo de nós
    • AUTOSCALING_CPU_TARGET: a meta de porcentagem de utilização da CPU que o Bigtable mantém adicionando ou removendo nós. Esse valor precisa ser de 10 a 80.

    • AUTOSCALING_STORAGE_TARGET: o destino de utilização do armazenamento em GiB por nó que o Bigtable mantém ao adicionar ou remover nós

      Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

Desative o escalonamento automático.

Console

  1. Abra a lista de instâncias do Bigtable no Console do Google Cloud.

    Abrir a lista de instâncias

  2. Clique na instância que você quer alterar e em Editar instância.

  3. Em Configurar clusters, clique em no cluster que você quer atualizar.

  4. Selecione Alocação manual de nó.

  5. Digite o número de nós do cluster no campo Quantidade.

    Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

  6. Clique em Save.

gcloud

  1. Se você não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do projeto: 

    gcloud bigtable instances list

  2. Se você não souber os IDs dos clusters da instância, use o comando bigtable clusters list para ver uma lista de clusters da instância: 

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando bigtable clusters update para desativar o escalonamento automático e configurar um número constante de nós:

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

    Preencha o seguinte:

    • CLUSTER_ID: identificador permanente do cluster.
    • INSTANCE_ID: identificador permanente da instância

    • NUM_NODES: este campo é opcional. Se nenhum valor for definido, o Bigtable vai alocar automaticamente os nós com base no seu volume de dados e otimizar para 50% da utilização do armazenamento. Se você quiser controlar o número de nós em um cluster, atualize o valor NUM_NODES. Verifique se o número de nós está definido como um valor diferente de zero.

      Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

Alterar configurações de escalonamento automático

Console

  1. Abra a lista de instâncias do Bigtable no Console do Google Cloud.

    Abrir a lista de instâncias

  2. Clique na instância que você quer alterar e em Editar instância.

  3. Em Configurar clusters, clique em no cluster que você quer atualizar.

  4. Insira novos valores para qualquer fluxo de trabalho que você queira alterar:

    • Número mínimo de nós
    • Número máximo de nós
    • Meta de utilização da CPU
    • Meta de uso do armazenamento

  5. Clique em Save.

gcloud

  1. Se você não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do projeto: 

    gcloud bigtable instances list

  2. Se você não souber os IDs dos clusters da instância, use o comando bigtable clusters list para ver uma lista de clusters da instância: 

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando bigtable clusters update para atualizar as configurações de escalonamento automático:

    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

    Preencha o seguinte:

    • CLUSTER_ID: identificador permanente do cluster.
    • INSTANCE_ID: identificador permanente da instância

    O comando aceita sinalizações de escalonamento automático opcional. É possível usar todas as sinalizações ou apenas as sinalizações dos valores que você quer alterar.

    • AUTOSCALING_MAX_NODES: o número mínimo de nós.
    • AUTOSCALING_MIN_NODES: o número máximo de nós.
    • AUTOSCALING_CPU_TARGET: a meta de porcentagem de utilização da CPU que o Bigtable mantém adicionando ou removendo nós. Esse valor precisa ser de 10 a 80.

    • AUTOSCALING_STORAGE_TARGET: o destino de utilização do armazenamento em GiB por nó que o Bigtable mantém ao adicionar ou remover nós.

      Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

Adicionar ou remover nós manualmente

Na maioria dos casos, recomendamos ativar o escalonamento automático. Se você não quiser, e o modo de escalonamento de nós do cluster for manual, será possível adicionar ou remover nós, e o número de nós vai permanecer constante até que você o mude novamente. Para analisar as cotas de nó padrão por zona, de acordo com o projeto do Google Cloud, consulte Cotas de nós. Se você precisar provisionar mais nós do que o padrão, solicite mais.

Para alterar o número de nós em um cluster que usa escalonamento manual:

Console

  1. Abra a lista de instâncias do Bigtable no Console do Google Cloud.

    Abrir a lista de instâncias

  2. Clique na instância que você quer alterar e em Editar instância.

  3. Em Configurar clusters, clique em Editar no cluster que você quer atualizar.

  4. Na seção Alocação manual de nós, insira o número de nós do cluster no campo Quantidade.

    Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

  5. Clique em Save.

gcloud

  1. Se você não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do projeto: 

    gcloud bigtable instances list

  2. Se você não souber os IDs dos clusters da instância, use o comando bigtable clusters list para ver uma lista de clusters da instância: 

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando bigtable clusters update para alterar o número de nós:

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

    Preencha o seguinte:

    • CLUSTER_ID: identificador permanente do cluster.
    • INSTANCE_ID: identificador permanente da instância

    • NUM_NODES: este campo é opcional. Se nenhum valor for definido, o Bigtable vai alocar automaticamente os nós com base no seu volume de dados e otimizar para 50% da utilização do armazenamento. Se você quiser controlar o número de nós em um cluster, atualize o valor NUM_NODES. Verifique se o número de nós está definido como um valor diferente de zero.

      Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

cbt

  1. Se você não souber o ID da instância, use o comando listinstances para ver uma lista das instâncias do projeto: 

    cbt listinstances

  2. Se você não souber os IDs de cluster da instância, use o comando listclusters para ver uma lista de clusters na instância: 

    cbt -instance=INSTANCE_ID listclusters

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando updatecluster para alterar o número de nós:

    cbt -instance=INSTANCE_ID updatecluster CLUSTER_ID NUM_NODES

    Preencha o seguinte:

    • INSTANCE_ID: identificador permanente da instância
    • CLUSTER_ID: identificador permanente do cluster.

    • NUM_NODES: este campo é opcional. Se nenhum valor for definido, o Bigtable vai alocar automaticamente os nós com base no seu volume de dados e otimizar para 50% da utilização do armazenamento. Se você quiser controlar o número de nós em um cluster, atualize o valor NUM_NODES. Verifique se o número de nós está definido como um valor diferente de zero.

      Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

Adicionar um cluster

É possível adicionar clusters a uma instância atual. Uma instância pode ter clusters em até oito regiões em que o Bigtable está disponível. Cada zona em uma região pode conter apenas um cluster. Os locais ideais para clusters adicionais dependem do seu caso de uso.

Se a instância estiver protegida por CMEK, cada cluster novo precisará usar uma chave CMEK na mesma região do cluster. Antes de adicionar um novo cluster a uma instância protegida por CMEK, identifique ou crie uma chave de CMEK na região em que você planeja localizar o cluster.

Antes de adicionar clusters a uma instância de cluster único, leia sobre as restrições que se aplicam quando você altera as políticas de coleta de lixo nas tabelas replicadas. Em seguida, consulte os exemplos de configurações de replicação para ver algumas recomendações.

Para adicionar um cluster a uma instância:

Console

  1. Abra a lista de instâncias do Bigtable no Console do Google Cloud.

    Abrir a lista de instâncias

  2. Clique na instância que você quer alterar e em Editar instância.

  3. Em Configurar clusters, clique em Adicionar cluster.

    Se esse botão estiver desativado, a instância já tem o número máximo de clusters.

  4. Digite um código de cluster e selecione a região e a zona do cluster.

  5. Insira o número de nós do cluster.

    Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

  6. Se a instância estiver protegida por CMEK, selecione ou insira uma chave gerenciada pelo cliente. A chave CMEK precisa estar na mesma região que o cluster.

  7. Clique em Add.

  8. Repita essas etapas para cada cluster adicional e clique em Salvar. O Bigtable cria o cluster e começa a replicar os dados para o novo cluster. Talvez haja aumento na utilização da CPU à medida que a replicação começa.

  9. Revise as configurações de replicação no perfil de aplicativo padrão para ver se elas se aplicam ao caso de uso de replicação. Talvez seja necessário atualizar o perfil de aplicativo padrão ou criar perfis de aplicativo personalizados.

gcloud

  1. Se você não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do projeto: 

    gcloud bigtable instances list

  2. Se você não souber os IDs dos clusters da instância, use o comando bigtable clusters list para ver uma lista de clusters da instância: 

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando bigtable clusters create para adicionar um 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] \

    Preencha o seguinte:

    • CLUSTER_ID: identificador permanente do cluster.
    • INSTANCE_ID: identificador permanente da instância

    • ZONE: a zona em que o cluster é executado.

      Cada zona em uma região pode conter apenas um cluster. Por exemplo, se uma instância tiver um cluster em us-east1-b, será possível adicionar um cluster em uma zona diferente na mesma região, como us-east1-c, ou em uma zona em uma região separada, como europe-west2-a. Acesse a lista de zonas.

    A sinalização --async é altamente recomendada, mas não obrigatória. Sem essa sinalização, o comando pode expirar antes da conclusão da operação. O Bigtable continuará criando o cluster em segundo plano.

    O comando aceita as sinalizações opcionais a seguir:

    • --kms-key=KMS_KEY: a chave CMEK está sendo usada pelo cluster. Só é possível adicionar clusters do CMEK a instâncias que já estejam protegidas por CMEK.
    • --kms-keyring=KMS_KEYRING: o ID do keyring KMS para a chave.
    • --kms-location=KMS_LOCATION: o local do Google Cloud para a chave.
    • --kms-project=KMS_PROJECT: o ID do projeto do Google Cloud para a chave.
    • --storage-type=STORAGE_TYPE: o tipo de armazenamento a ser usado no cluster. Cada cluster em uma instância precisa usar o mesmo tipo de armazenamento. Aceita os valores SSD e HDD. O valor padrão é SSD.

    Se nenhum valor for definido para a opção --num-nodes, o Bigtable vai alocar os nós ao cluster automaticamente com base no volume de dados e otimizar para 50% da utilização do armazenamento. Essa alocação automática de nós tem um impacto nos preços. Se você quiser controlar o número de nós em um cluster, atualize o valor NUM_NODES. Verifique se o número de nós está definido como um valor diferente de zero. Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

    Para escalonamento automático, forneça as três sinalizações autoscaling- e não use num-nodes. Consulte Escalonamento automático para orientações sobre como escolher os valores das configurações de escalonamento automático. Substitua:

    • AUTOSCALING_MIN_NODES: o número mínimo de nós do cluster.
    • AUTOSCALING_MAX_NODES: o número máximo de nós para o cluster.
    • AUTOSCALING_CPU_TARGET: a meta de uso da CPU para o cluster. Esse valor precisa ser de 10 a 80.
    • AUTOSCALING_STORAGE_TARGET: o destino de utilização do armazenamento em GiB que o Bigtable mantém adicionando ou removendo nós.

  4. Revise as configurações de replicação no perfil de aplicativo padrão para ver se elas se aplicam ao caso de uso de replicação. Talvez seja necessário atualizar o perfil de aplicativo padrão ou criar perfis de aplicativo personalizados.

cbt

  1. Se você não souber o ID da instância, use o comando listinstances para ver uma lista das instâncias do projeto: 

    cbt listinstances

  2. Se você não souber os IDs de cluster da instância, use o comando listclusters para ver uma lista de clusters na instância: 

    cbt -instance=INSTANCE_ID listclusters

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando createcluster para adicionar um cluster:

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

    Preencha o seguinte:

    • INSTANCE_ID: identificador permanente da instância
    • CLUSTER_ID: identificador permanente do cluster.

    • ZONE: a zona em que o cluster é executado.

      Cada zona em uma região pode conter apenas um cluster. Por exemplo, se uma instância tiver um cluster em us-east1-b, será possível adicionar um cluster em uma zona diferente na mesma região, como us-east1-c, ou em uma zona em uma região separada, como europe-west2-a. Acesse a lista de zonas.

    • NUM_NODES: este campo é opcional. Se nenhum valor for definido, o Bigtable vai alocar automaticamente os nós com base no seu volume de dados e otimizar para 50% da utilização do armazenamento. Se você quiser controlar o número de nós em um cluster, atualize o valor NUM_NODES. Verifique se o número de nós está definido como um valor diferente de zero.

      Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.

    • STORAGE_TYPE: o tipo de armazenamento a ser usado no cluster. Cada cluster em uma instância precisa usar o mesmo tipo de armazenamento. Aceita os valores SSD e HDD.

  4. Revise as configurações de replicação no perfil de aplicativo padrão para ver se elas se aplicam ao caso de uso de replicação. Talvez seja necessário atualizar o perfil de aplicativo padrão ou criar perfis de aplicativo personalizados.

Excluir um cluster

Se uma instância tiver vários clusters, você poderá excluir todos, exceto um deles. A exclusão de todos os clusters, exceto um, desativa automaticamente a replicação.

Em alguns casos, o Bigtable não permite excluir um cluster:

  • Se um dos perfis de aplicativo encaminhar todo o tráfego para um único cluster, o Bigtable não permitirá excluir esse cluster. Você precisa editar ou excluir o perfil de aplicativo para remover o cluster.
  • Se você adicionar novos clusters a uma instância existente, não será possível excluir clusters nessa instância até que a cópia de dados inicial para os novos clusters seja concluída.

Para excluir um cluster de uma instância:

Console

  1. Abra a lista de instâncias do Bigtable no Console do Google Cloud.

    Abrir a lista de instâncias

  2. Clique na instância que você quer alterar e em Editar instância.

  3. Em Configurar clusters, clique em Excluir cluster no cluster que você quer excluir.

  4. Para cancelar a operação de exclusão, clique em Desfazer, que ficará disponível até que você clique em Salvar. Caso contrário, clique em Salvar.

gcloud

  1. Se você não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do projeto: 

    gcloud bigtable instances list

  2. Se você não souber os IDs dos clusters da instância, use o comando bigtable clusters list para ver uma lista de clusters da instância: 

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando bigtable clusters delete para excluir o cluster:

    gcloud bigtable clusters delete CLUSTER_ID \
    --instance=INSTANCE_ID

    Preencha o seguinte:

    • CLUSTER_ID: identificador permanente do cluster.
    • INSTANCE_ID: identificador permanente da instância

cbt

  1. Se você não souber o ID da instância, use o comando listinstances para ver uma lista das instâncias do projeto: 

    cbt listinstances

  2. Se você não souber os IDs de cluster da instância, use o comando listclusters para ver uma lista de clusters na instância: 

    cbt -instance=INSTANCE_ID listclusters

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando deletecluster para excluir o cluster:

    cbt -instance=INSTANCE_ID deletecluster CLUSTER_ID

    Preencha o seguinte:

    • INSTANCE_ID: identificador permanente da instância
    • CLUSTER_ID: identificador permanente do cluster.

Mover dados para um novo local

Para mover os dados em uma instância do Bigtable para uma nova zona ou região, adicione um novo cluster no local que você quer migrar e exclua o cluster no local de onde você quer se mover. O cluster excluído permanece disponível até que os dados sejam replicados para o novo cluster. Portanto, não é preciso se preocupar com solicitações com falha. O Bigtable replica todos os dados para o novo cluster automaticamente.

Gerenciar perfis de app

Os perfis de aplicativo, ou perfis de app, controlam como os aplicativos se conectam a uma instância que usa a replicação. Cada instância com mais de um cluster tem o próprio perfil de app padrão. Também é possível criar perfis de app personalizados diferentes para cada instância. Para isso, use um perfil de app diferente para cada tipo de aplicativo executado.

Para saber como configurar os perfis de aplicativos de uma instância, veja Como configurar perfis de aplicativos. Para conferir exemplos de configurações que podem ser usadas para implementar casos de uso comuns, consulte Exemplos de configurações de replicação.

Gerenciar rótulos

Rótulos são pares de chave-valor que você pode usar para agrupar instâncias relacionadas e armazenar metadados sobre uma instância.

Para saber como gerenciar rótulos, consulte Como adicionar ou atualizar os rótulos de uma instância e Como remover um rótulo de uma instância.

Alterar o nome de exibição de uma instância

Para alterar o nome de exibição de uma instância, que o Console do Google Cloud usa para identificá-la:

Console

  1. Abra a lista de instâncias do Bigtable no Console do Google Cloud.

    Abrir a lista de instâncias

  2. Clique na instância que você quer alterar e em Editar instância.

  3. Edite o nome da instância e clique em Salvar.

gcloud

  1. Se você não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do projeto: 

    gcloud bigtable instances list

  2. Use o comando bigtable instances update para atualizar o nome de exibição:

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

    Preencha o seguinte:

    • INSTANCE_ID: identificador permanente da instância
    • DISPLAY_NAME: um nome legível que identifica a instância no console do Google Cloud.

cbt

Esse recurso não está disponível na CLI cbt.

A seguir