Nesta página, você vai aprender a criar e gerenciar partições de instância do Spanner.
Antes de começar
Para usar partições de instância, 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 Google Cloud console.
Selecione a instância em que você quer adicionar partições de instância.
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 Spanner Studio, clique em
Nova guia ou use a guia do editor vazia.Insira a seguinte instrução DDL
ALTER DATABASE
.GoogleSQL
ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);
Substitua DATABASE_ID pelo identificador exclusivo do seu banco de dados.
PostgreSQL
ALTER DATABASE DATABASE_ID SET "spanner.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
.
GoogleSQL
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE DATABASE_ID 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 sua instância do Spanner.
PostgreSQL
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE DATABASE_ID SET "spanner.opt_in_dataplacement_preview" = TRUE"
Substitua:
DATABASE_ID
: o identificador permanente do banco de dados do Spanner.INSTANCE_ID
: o identificador permanente da sua instância do Spanner.
Criar uma partição de instância
Console
No console Google Cloud , abra a página Spanner.
Selecione a instância em que você quer adicionar partições de instância.
No menu de navegação, selecione Partições de instâncias.
Clique em Criar partição de instância.
Insira um ID da partição para identificar permanentemente a partição da instância. O ID da partição da instância também precisa ser exclusivo no seu projetoGoogle Cloud . Não é possível mudar o ID da partição de instância depois.
Na seção Escolher uma configuração, selecione Regional ou Multirregião. Se 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 de instâncias pequenas.
- Nós para instâncias grandes. Um nó equivale a 1.000 unidades de processamento.
Insira um valor para a unidade selecionada.
Sua partição de instância precisa ter pelo menos um nó ou 1.000 unidades de processamento.
Clique em Criar para criar a partição de instância.
gcloud
Para criar uma partição de instância, use
gcloud beta spanner instance-partitions create
.
gcloud beta spanner instance-partitions create INSTANCE_PARTITION_ID \ --config=INSTANCE_PARTITION_CONFIG \ --description="INSTANCE_PARTITION_DESCRIPTION" \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT]
Substitua:
- INSTANCE_PARTITION_ID: o identificador permanente da partição de instância que é exclusivo no projeto Google Cloud . Não é possível mudar o ID da partição de instância depois.
- INSTANCE_PARTITION_CONFIG: o identificador permanente da configuração de partição da instância, que define a localização geográfica da partição e afeta onde os dados são armazenados.
- INSTANCE_PARTITION_DESCRIPTION: o nome a ser exibido para a partição de instância no console do Google Cloud . O nome da partição de instância precisa ser exclusivo no projeto Google Cloud .
- INSTANCE_ID: o identificador permanente da instância do Spanner em que a partição de instância reside.
- NODE_COUNT: a capacidade de computação da partição da instância, 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, expressa como um número de unidades de processamento. Sua partição de instância 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 de instância 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
Bibliotecas de cliente
C++
Para saber como instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
C#
Para saber como instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Go
Para saber como instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Java
Para saber como instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Node.js
Para saber como instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
PHP
Para saber como instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Python
Para saber como instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Descrever uma partição de instância
gcloud
Para descrever uma partição de instância, use
gcloud beta spanner instance-partitions describe
.
gcloud beta spanner instance-partitions describe PARTITION_ID \ --instance=INSTANCE_ID
Substitua:
- INSTANCE_PARTITION_ID: identificador permanente da partição da instância.
- INSTANCE_ID: identificador permanente da instância.
Por exemplo, para descrever a partição de instância europe-partition
,
execute o seguinte:
gcloud beta spanner instance-partitions describe europe-partition
--instance=test-instance
Listar partições de instância
Console
No console Google Cloud , abra a página Spanner.
Selecione uma instância na lista.
No menu de navegação, selecione Partições de instâncias.
Uma lista de partições de instância associadas a essa instância é mostrada.
gcloud
Para listar as partições de instância, 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 de instância do Spanner, além do ID, nome de exibição, configuração e capacidade de computação de cada uma delas.
Editar uma partição de instância
A seção a seguir explica como mudar a capacidade de computação da partição de instância. Não é possível mudar o ID, o nome ou a configuração da partição da instância.
Mudar a capacidade de computação
Provisione capacidade de computação suficiente para manter a utilização da CPU e a utilização de armazenamento abaixo dos valores máximos 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 de instância, seu projetoGoogle Cloud precisa ter cota suficiente para adicionar a capacidade de computação. O tempo necessário para concluir o pedido de aumento depende do tamanho da solicitação. 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 Google Cloud , abra a página Spanner.
Selecione uma instância na lista.
No menu de navegação, selecione Partições de instâncias.
Na lista de partições de instância, na coluna Ações, clique em Mais ações e selecione Editar.
Para mudar a capacidade de computação, escolha uma unidade de medida (unidades de processamento ou nós) e insira 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 de instância precisa ter pelo menos um nó (1.000 unidades de processamento).
Clique em Salvar.
Se for exibida uma caixa de diálogo informando que sua cota é insuficiente para adicionar capacidade de computação , siga as instruções para solicitar uma cota maior.
gcloud
Para mudar a capacidade de computação da partição de instância, 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 INSTANCE_PARTITION_ID \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT] [--async]
Substitua:
- INSTANCE_PARTITION_ID: identificador permanente da partição da instância.
- INSTANCE_ID: identificador permanente da instância.
- NODE_COUNT: a nova capacidade de computação da partição da instância, 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 de instância, expressa como um número de unidades de processamento. Sua partição de instância 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 flag se quiser que sua solicitação retorne imediatamente, sem aguardar a conclusão da operação.
Para verificar o status da sua solicitação, execute
gcloud spanner operations describe
.
Excluir uma partição de instância
Não é possível excluir uma partição de instância enquanto ela estiver associada a posicionamentos ou dados. Primeiro, mova os dados da partição da instância ou exclua as tabelas de posicionamento que usam essa partição antes de excluir a partição da instância.
Console
No console Google Cloud , abra a página Spanner.
Selecione uma instância na lista.
No menu de navegação, selecione Partições de instâncias.
Na lista de partições de instância, na coluna Ações, clique em Mais ações e selecione Excluir.
Siga as instruções para confirmar a exclusão da partição da instância.
Clique em Excluir.
gcloud
Use o comando gcloud beta spanner instance-partitions delete
.
gcloud beta spanner instance-partitions delete INSTANCE_PARTITION_ID --instance=INSTANCE_ID
A seguir
- Saiba como criar e gerenciar tabelas e chaves de posição.