Nesta página, descrevemos como mover uma instância no Spanner.
É possível mover sua instância do Spanner de qualquer instância a qualquer outra configuração de instância, inclusive configurações regionais, birregionais e multirregionais. Transporte a instância não causar inatividade, e o Spanner continua fornecer as garantias de transação normais, incluindo consistência forte, durante a mudança.
Também é possível mover sua instância da configuração da instância de origem
para uma configuração de instância personalizada (por exemplo, uma configuração base nam3
com uma réplica somente leitura us-west2
). Como não é possível atualizar a topologia
você precisa criar uma instância personalizada
de rede com a topologia que você quer primeiro. Depois de criar a nova
da instância, mova sua instância da instância de origem
para a nova configuração da instância personalizada.
Por que mover sua instância do Spanner?
Os benefícios de mover sua instância incluem:
- Aumentar a disponibilidade: ter 99,999% de disponibilidade sem inatividade depois de realizar uma mudança regional para birregional ou multirregional.
- Reduzir latência: reduza a latência e aumente a cobertura geográfica com o réplicas somente leitura adicionais por meio de uma região regional para birregional ou multirregional ou multirregião para multirregião.
- Reduzir custos: reduza os custos por hora migrando de um local birregional ou multirregional. para uma configuração regional.
- Colocar banco de dados: colocar o banco de dados do Spanner com o aplicativo cliente movendo a instância para um local mais otimizado.
Preços
Ao mover uma instância, as configurações da instância de origem e de destino estão sujeitas a cobranças de computação e armazenamento horárias. Quando a migração for concluída, você será cobrado pelo armazenamento da instância no configuração de destino.
Se você estiver movendo sua instância para um novo local regional, birregional ou multirregional configuração da instância, você poderá estar sujeito a cobranças de transferência de dados de saída. Para mais informações, consulte Preços do Spanner.
Limitações
- Para mover sua instância, ela deve ter um mínimo de 1 nó (1.000 unidades de processamento).
- Não é possível mover sua instância entre projetos e contas do Google Cloud.
- Não é possível mover uma instância de teste gratuito do Spanner. É possível mover a instância após o upgrade para uma instância paga.
- Se você tiver solicitações ativas usando um endpoint de serviço regional em qualquer um dos recursos da instância, a movimentação da instância afeta todas as solicitações que usam o endpoint regional porque a aplicação regional bloqueia o acesso a instâncias entre regiões. As solicitações que usam um endpoint global são sem ser afetada.
- Os backups do Spanner são específicos para uma configuração de instância e não são incluídos na movimentação de uma instância. Para Para mais informações, consulte Backups.
- As seguintes APIs são desativadas durante uma movimentação de instância:
InstanceAdmin.DeleteInstance
InstanceAdmin.UpdateInstance
DatabaseAdmin.CreateDatabase
DatabaseAdmin.UpdateDatabaseDdl
(desativado sedefault_leader
for especificado na solicitação.DatabaseAdmin.RestoreDatabase
DatabaseAdmin.CreateBackup
DatabaseAdmin.CopyBackup
- Não é possível mover instâncias que contêm qualquer componente ativado para CMEK bancos de dados.
- Se um banco de dados tiver um líder padrão modificado, a seleção será preservada se nomear uma região de leitura/gravação no configuração da instância de destino e essa configuração é multirregional. Se a configuração de destino for regional ou não incluem a região de leitura/gravação nomeada, a seleção líder padrão será limpos.
- Mover uma instância altera o atributo de configuração da instância
instância. Se você gerencia os recursos do Spanner por
automação, prepare e resolva quaisquer inconsistências que possam
surgir.
- Por exemplo, se você usar o Terraform para
gerenciar instâncias e bancos de dados do Spanner e
ative
terraform apply --auto-approve
para manter seus recursos sincronizados todas as instâncias e recursos filhos são excluídos quando a instância é movida. Atualize a configuração para evitar exclusão e perda de dados. Consulte Opções de aplicação do Terraform para mais informações sobre o comandoapply
.
- Por exemplo, se você usar o Terraform para
gerenciar instâncias e bancos de dados do Spanner e
ative
- Enquanto a instância é movida, o serviço de monitoramento e os gráficos podem mostrar dados na origem e no destino configurações de instância da instância ou só pode refletir o desempenho em uma instância configuração do Terraform.
- Se você configurou a ferramenta de escalonamento automático de código aberto,
precisará desativá-la. Ela falha porque
InstanceAdmin.UpdateInstance
(usado para alterações no nó e na unidade de processamento). Não é possível mover uma instância se o Escalonador automático gerenciado do Spanner está habilitado nele. Para mover a instância, é preciso desativar o escalonador automático gerenciado, mover a instância e reativar o escalonador automático.
Além disso, se você estiver usando o escalonamento automático, você precisa provisionar nós suficientes para o uso máximo da CPU de acordo com o as recomendações máximas observadas e, em seguida, desative o escalonamento automático antes de mover a instância.
Considerações sobre desempenho
Quando uma instância está sendo movida, ela tem latências de leitura/gravação maiores e uma taxa de cancelamento de transação mais alta. O uso da CPU durante a migração pode aumentar para 100%, porque a movimentação da instância é realizada usando uma CPU extra provisionada pelo o usuário. No entanto, mover uma instância não causa inatividade. O horário para mover uma instância depende de vários fatores, incluindo o tamanho bancos de dados, o número de nós e o tipo de mudança (por exemplo, regional para multirregional).
Depois de mover uma instância, o desempenho dela varia de acordo com os detalhes da configuração da instância. Por exemplo: birregional e configurações multirregionais costumam ter maior latência de gravação e menor latência de leitura configurações regionais.
Backups
Quando você move uma instância, os backups na instância de origem não são movidos para a nova configuração de destino automaticamente. A movimentação da instância será cancelada se Existem backups na configuração da instância de origem quando você inicia a instância se moverem. É importante copiar seus backups e considerar as plano de recuperação de dados antes de migrar instância.
Se houver backups na instância de origem que precisem ser mantidos, recomendamos copie os backups para o configuração da instância de destino e outra instância com a mesma instância como a instância de origem a ser movida. Dessa forma:
- É possível copiar os backups para a configuração da instância de destino imediatamente após a conclusão da migração da instância.
- Se você precisar cancelar a movimentação da instância, será possível restaurar rapidamente seus backups da instância com a mesma configuração da origem configuração da instância.
Depois de copiar seus backups para outra instância, é necessário excluir na instância de origem antes de movê-la. Então, uma vez a movimentação da instância for concluída, você terá uma cópia do backup no configuração do Terraform. Também é possível criar um backup.
Para saber mais sobre como copiar backups e os custos associados, consulte Copiar um backup.
Como mover uma instância
É possível mover uma instância usando o Cloud Shell do console do Google Cloud e
a CLI gcloud usando os comandos gcloud
.
Pré-requisitos
Antes de mover a configuração da instância, verifique se você leia as Limitações e Considerações sobre desempenho em outras seções. Em seguida, siga estas etapas:
- Verifique se você tem a permissão do IAM
spanner.instances.update
na instância de origem. - Se aplicável, mova as instâncias que não são de produção. (como teste e preparo) antes de mover as instâncias de produção para ajudar avaliar e entender o impacto no desempenho das cargas de trabalho durante uma instância se moverem.
- Quando você move uma instância do Spanner, o processo de mudança exclui as tags de instância que você criou Data Catalog. Para preservar sua você precisará exportá-las antes da movimentação e importá-las após a movimentação. Para mais informações, consulte Exportar e importar tags.
Para ter acesso às práticas recomendadas, siga também estas diretrizes:
- Testar cargas de trabalho de desempenho em instâncias de não produção no destino antes de mover a instância de produção. Testar mover uma instância de teste semelhante à sua instância de produção para ter uma noção de quanto tempo levará para mover sua instância de produção.
- Use o Key Visualizer para verificar se não há pontos de acesso nos seus bancos de dados.
- Verifique se você tem uma cota de nós suficiente na configuração da instância de destino para dar suporte ao pico de uso esperado da instância. Para mais informações, consulte Cotas do Spanner e Limites.
- Verifique se o uso máximo da CPU de sua instância for menor que 40% para a configuração da instância movida e a quantidade de armazenamento por nó for menor que 1 tebibyte (TiB);
- Não faça alterações na instância durante a movimentação. Isso inclui alterar o número de nós da instância, alterar esquemas do banco de dados, criação ou eliminação de bancos de dados e criação ou exclusão de backups.
Se você mover sua instância de acordo com essas recomendações, a migração geralmente é concluído em até 24 horas. No entanto, dependendo do aplicativo carga de trabalho, o tempo de conclusão pode ser maior ou menor.
Mover uma instância
Console do Google Cloud
Clique em . Ative o Cloud Shell na parte superior do console do Google Cloud.
Uma sessão do Cloud Shell é aberta em um novo frame no na parte de baixo do console do Google Cloud e mostra um prompt de linha de comando. A inicialização da sessão pode levar alguns segundos.
Usar o
gcloud spanner instances move
para mover a instância.gcloud spanner instances move INSTANCE_ID \ --target-config=TARGET_CONFIG
Substitua:
- INSTANCE_ID: o identificador permanente da instância que que você quer mover.
- TARGET_CONFIG: um identificador permanente da instância.
para onde quer mover a instância. A nova área geográfica
o local da instância. Pode ser regional, birregional,
multirregional ou de instância personalizada (por exemplo,
nam3
,us-central1
oucustom-nam3-us-west2
).
Por exemplo, para mover a instância test-instance
da atual
configuração da instância como nam3
, execute o seguinte:
gcloud spanner instances move test-instance --target-config=nam3
Opcional: se você quiser adicionar uma réplica somente leitura, us-west2
, à base
configuração da instância nam3
, faça o seguinte:
Clone a configuração de base e adicione a réplica somente leitura:
gcloud spanner instance-configs create custom-nam3-us-west2 \ --clone-config=nam3 --add-replicas=location=us-west2, type=READ_ONLY
Mover a instância
test-instance
da instância atual para esta nova configuração de instânciacustom-nam3-us-west2
:gcloud spanner instances move test-instance --target-config=custom-nam3-us-west2
CLI da gcloud
Usar o gcloud spanner instances move
para mover a instância.
gcloud spanner instances move INSTANCE_ID \
--target-config=TARGET_CONFIG
Substitua:
- INSTANCE_ID: o identificador permanente da instância que que você quer mover.
- TARGET_CONFIG: um identificador permanente da instância.
para onde quer mover a instância. A nova área geográfica
o local da instância. Pode ser regional, birregional ou
configuração de instância multirregional (por exemplo,
nam3
,us-central1
, oucustom-nam3-us-west2
).
Por exemplo, para mover a instância test-instance
da atual
configuração da instância como nam3
, execute o seguinte:
gcloud spanner instances move test-instance --target-config=nam3
Opcional: se você quiser adicionar uma réplica somente leitura, us-west2
, à base
configuração da instância nam3
, faça o seguinte:
Clone a configuração de base e adicione a réplica somente leitura:
gcloud spanner instance-configs create custom-nam3-us-west2 \ --clone-config=nam3 --add-replicas=location=us-west2, type=READ_ONLY
Mover a instância
test-instance
da instância atual para esta nova configuração de instânciacustom-nam3-us-west2
:gcloud spanner instances move test-instance --target-config=custom-nam3-us-west2
Como monitorar o progresso da movimentação e do cancelamento da instância
Você pode usar gcloud spanner operations describe
ou criar um
Painel do Cloud Monitoring para monitorar o progresso de uma movimentação de instância.
Ver o progresso da operação de movimentação e cancelamento
Para acompanhar o progresso de uma movimentação ou cancelamento de movimentação de uma instância
operação, use o método gcloud spanner operations describe
kubectl. Esse comando exige o ID da operação da movimentação de instância em andamento.
operação
Para saber o ID da operação de transferência da instância, execute o seguinte comando:
gcloud spanner operations list --instance="INSTANCE_ID"
Substitua:
- INSTANCE-ID: o identificador permanente da instância que você querem se mover.
A saída mostra uma lista de operações de longa duração, incluindo a migração de instância operação
Execute o comando
gcloud spanner operations describe
para conferir o progresso porcentagem e status:gcloud spanner operations describe OPERATION_ID --instance=INSTANCE_ID
Substitua:
- OPERATION_ID: o ID da operação de movimentação da instância. que você quer verificar.
- INSTANCE_ID: o ID da instância que você quer verificação.
Monitorar uma operação de movimentação de instância
É possível criar um painel personalizado do Cloud Monitoring para exibir durante a movimentação da instância, uma operação de longa duração com potencial implicações do serviço.
Os gráficos Armazenamento total e Armazenamento total do banco de dados por banco de dados no painel são úteis para monitorar o progresso da mudança. Confira o na configuração de origem cai gradualmente enquanto o armazenamento na a configuração de destino aumenta.
Console do Google Cloud
- Faça o download do
move-instance-dashboard.json
. Esse arquivo tem as informações necessárias para preencher um painel personalizado no Monitoring. -
No console do Google Cloud, acesse a página Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
- Na página Visão geral dos painéis, clique em Criar painel.
- Na barra de ferramentas do painel, clique no menu suspenso Configurações do painel. Depois, Selecione JSON e, em seguida, Editor do JSON.
- No painel JSON Editor, copie o conteúdo do
move-instance-dashboard.json
do qual você fez o download e colá-lo no editor. - Para aplicar as mudanças ao painel, clique em Aplicar alterações. Se você não quiser usar este painel, volte para "Painéis" Página de visão geral.
- Depois que o painel for criado, clique em Adicionar filtro. Em seguida, selecione
project_id
ouinstance_id
para monitorar o progresso da instância. se moverem.
CLI da gcloud
- Faça o download do
move-instance-dashboard.json
. Esse arquivo tem as informações necessárias para preencher um painel personalizado no Monitoring. Para criar um painel em um projeto, use o comando
gcloud monitoring dashboards create
:gcloud monitoring dashboards create --config-from-file=move-instance-dashboard.json
Para mais informações, consulte a referência
gcloud monitoring dashboards create
.
Como cancelar uma movimentação de instância
Só é possível cancelar uma movimentação de instância que ainda está em andamento. Se você quiser reverter uma movimentação de instância já concluída, terá que iniciar uma nova movimentação.
Você pode usar gcloud spanner operations cancel
para cancelar operações de movimentação de instâncias. O cancelamento não é instantâneo
e leva aproximadamente o mesmo tempo decorrido desde a
início da mudança. Isso ocorre porque os dados precisam ser movidos de volta para a instância de origem
configuração do Terraform.
Esse comando exige o ID da operação da movimentação de instância em andamento. operação
Encontre o ID da operação executando:
gcloud spanner operations list --type=INSTANCE --instance="INSTANCE_ID" --filter="done:False AND metadata.@type:MoveInstanceMetadata
Substitua:
- INSTANCE_ID: o identificador permanente da instância que você querem se mover.
A saída mostra uma lista de operações de movimentação de instâncias em andamento.
Execute o comando
gcloud spanner operations cancel
para cancelar a instância mover:gcloud spanner operations cancel OPERATION_ID
Substitua:
- OPERATION_ID: o ID da operação de movimentação da instância que que você quer cancelar.
A seguir
- Saiba mais sobre o Spanner Configurações regionais, birregionais e multirregionais.
- Saiba mais sobre as regiões e zonas do Google Cloud.