Nesta página, descrevemos como criar e gerenciar partições do Spanner.
Antes de começar
Para usar partições, defina a opção de banco de dados
opt_in_dataplacement_preview no banco de dados vazio:
Console
Acesse a página Instâncias no console do Google Cloud.
Selecione a instância em que você quer adicionar partições.
Selecione o banco de dados vazio em que você quer particionar os dados.
No menu de navegação, clique em Spanner Studio.
Na página do Spanner Studio, clique em Nova guia ou use a guia do editor vazia.
Digite a seguinte instrução DDL
ALTER DATABASE.ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);
Substitua DATABASE_ID pelo identificador exclusivo do seu banco de dados.
Clique em Executar.
gcloud
Para definir a opção de banco de dados opt_in_dataplacement_preview, use
gcloud spanner databases ddl update.
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE db SET OPTIONS (opt_in_dataplacement_preview = true);"
Substitua:
DATABASE_ID: o identificador permanente do banco de dados do Spanner.INSTANCE_ID: o identificador permanente da instância do Spanner.
Criar uma partição
Console
No console do Google Cloud, abra a página Spanner.
Selecione a instância em que você quer adicionar partições.
No menu de navegação, selecione Partições.
Clique em Criar partição.
Insira um ID de partição para identificá-la permanentemente. O ID da partição também precisa ser exclusivo no projeto do Google Cloud. Não será possível alterar o ID da partição depois.
Na seção Escolher uma configuração, selecione Regional ou Multirregional. Como alternativa, se você quiser comparar as especificações entre as regiões, clique em Comparar configurações de região.
Selecione uma configuração no menu suspenso.
Na seção Alocar capacidade de computação, em Unidade, clique em uma das seguintes opções:
- Unidades de processamento para partições pequenas de instâncias.
- Nós para instâncias grandes. Um nó tem 1.000 unidades de processamento.
Insira um valor para a unidade selecionada.
Sua partição precisa ter pelo menos um nó ou mil unidades de processamento.
Clique em Criar para criar a partição.
gcloud
Para criar uma partição, use gcloud beta spanner instance-partitions create.
gcloud beta spanner instance-partitions create PARTITION_ID \ --config=PARTITION_CONFIG \ --description="PARTITION_DESCRIPTION" \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT]
Substitua:
- PARTITION_ID: o identificador de partição permanente exclusivo no projeto do Google Cloud. Não é possível alterar o ID da partição mais tarde.
- PARTITION_CONFIG: o identificador permanente da configuração da partição, que define a localização geográfica dela e afeta o local de armazenamento dos dados.
- PARTITION_DESCRIPTION: o nome a ser exibido para a partição no console do Google Cloud. O nome da partição precisa ser exclusivo no projeto do Google Cloud.
- INSTANCE_ID: o identificador permanente da instância do Spanner em que a partição reside.
- NODE_COUNT: a capacidade de computação da partição, expressa como um número de nós. Um nó equivale a 1.000 unidades de processamento.
- PROCESSING_UNIT_COUNT: a capacidade de computação da instância, definida como um número de unidades de processamento. Sua partição precisa ter pelo menos 1.000 unidades de processamento. Insira quantidades em múltiplos de 1.000 (1.000, 2.000, 3.000 e assim por diante).
Por exemplo, para criar uma partição europe-partition em eur3 com cinco nós,
execute o seguinte:
gcloud beta spanner instance-partitions create europe-partition --config=eur3 \
--description="europe-partition" --instance=test-instance --nodes=5
Descrever uma partição
gcloud
Para descrever uma partição, use
gcloud beta spanner instance-partitions describe.
gcloud beta spanner instance-partitions describe PARTITION_ID \ --instance=INSTANCE_ID
Substitua:
- PARTITION_ID: o identificador permanente da partição.
- INSTANCE_ID: o identificador permanente da instância.
Por exemplo, para descrever a partição europe-partition,
execute o seguinte:
gcloud beta spanner instance-partitions describe europe-partition
--instance=test-instance
Listar partições
Console
No console do Google Cloud, abra a página Spanner.
Selecione uma instância na lista.
No menu de navegação, selecione Partições.
Uma lista de partições associadas a essa instância é mostrada.
gcloud
Para listar suas partições, use
gcloud beta spanner instance-partitions list.
gcloud beta spanner instance-partitions list --instance=INSTANCE_ID
A CLI gcloud imprime uma lista das partições do Spanner, além do ID, nome de exibição, configuração e capacidade de computação de cada partição.
Editar uma partição
A seção a seguir explica como alterar a capacidade de computação da partição. Não é possível alterar o ID, o nome ou a configuração da partição.
Alterar a capacidade de computação
É preciso provisionar capacidade de computação suficiente para manter a utilização da CPU e a utilização de armazenamento abaixo dos limites recomendados. Para mais informações, consulte as cotas e limites do Spanner.
Se você quiser aumentar a capacidade de computação de uma partição, seu projeto do Google Cloud precisa ter cota suficiente para adicionar a capacidade de computação. O tempo necessário para que a solicitação de aumento seja concluída depende do tamanho dela. Na maioria dos casos, as solicitações são concluídas em alguns minutos. Em raras ocasiões, um escalonar verticalmente pode levar até uma hora para ser concluído.
Console
No console do Google Cloud, abra a página Spanner.
Selecione uma instância na lista.
No menu de navegação, selecione Partições.
Na lista de partições, na coluna Ações, clique em Mais ações e selecione Editar.
Altere a capacidade de computação escolhendo uma unidade de medida (unidades de processamento ou nós) e inserindo uma quantidade. Ao usar unidades de processamento, insira quantidades em múltiplos de 1.000 (1.000, 2.000, 3.000 e assim por diante). Cada nó é igual a 1.000 unidades de processamento.
Sua partição precisa ter pelo menos um nó (1.000 unidades de processamento).
Clique em Salvar.
Se aparecer uma caixa de diálogo informando que você não tem cota suficiente para adicionar capacidade de computação , siga as instruções para solicitar uma cota maior.
gcloud
Para alterar a capacidade de computação da partição, use
gcloud beta spanner instance-partitions update.
Ao usar esse comando, especifique a capacidade de computação como um
número de nós ou unidades de processamento.
gcloud beta spanner instance-partitions update PARTITION_ID / --instance=INSTANCE_ID / [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT] [--async]
Substitua:
- PARTITION_ID: o identificador permanente da partição.
- INSTANCE_ID: o identificador permanente da instância.
- NODE_COUNT: a nova capacidade de computação da partição, expressa como um número de nós. Um nó equivale a 1.000 unidades de processamento.
- PROCESSING_UNIT_COUNT: a nova capacidade de computação da partição, expressa como um número de unidades de processamento. Sua partição precisa ter pelo menos 1.000 unidades de processamento. Insira quantidades em múltiplos de 1.000 (1.000, 2.000, 3.000 e assim por diante).
Sinalizações opcionais:
--async: use essa sinalização se quiser que sua solicitação retorne imediatamente, sem aguardar a conclusão da operação em andamento.
Para verificar o status da sua solicitação, execute
gcloud spanner operations describe.
Excluir uma partição
Não é possível excluir uma partição enquanto ela está associada a posições ou dados. Primeiro, é preciso mover todos os dados que estejam na partição ou excluir as tabelas de colocação que a usam antes de excluí-la.
Console
No console do Google Cloud, abra a página Spanner.
Selecione uma instância na lista.
No menu de navegação, selecione Partições.
Na lista de partições, na coluna Ações, clique em Mais ações e selecione Excluir.
Siga as instruções para confirmar que você quer excluir a partição.
Clique em Excluir.
gcloud
Use o comando gcloud beta spanner instance-partitions delete.
gcloud beta spanner instance-partitions delete PARTITION_ID --instance=INSTANCE_ID