Nesta página, descrevemos como criar, listar, editar e excluir instâncias do Cloud Spanner.
Como criar uma instância
É possível criar uma instância com a CLI do Google Cloud ou com o Console do Google Cloud.
Console
Acesse a página Criar uma instância no Console do Google Cloud.
Digite os seguintes valores:
- Um nome de instância a ser exibido no Console do Google Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.
- Um código de instância para identificá-la permanentemente. O código da instância também precisa ser exclusivo no projeto do Google Cloud. Não será possível alterá-lo depois.
- Uma configuração, que define a localização geográfica da instância e afeta a maneira como os dados são replicados. Saiba mais sobre configurações de instâncias.
- A quantidade de capacidade de computação da instância. A capacidade de computação determina a quantidade de recursos de serviço e de armazenamento disponíveis para os bancos de dados na instância. Para especificar a capacidade de computação, escolha as unidades de medida (unidades de processamento ou nós) e insira uma quantidade. Ao usar unidades de processamento, insira quantidades até 1000 em múltiplos de 100 (100, 200, 300 e assim por diante) e insira quantidades maiores em múltiplos de 1000 (1000, 2000, 3000 e assim por diante). Cada nó é igual a 1.000 unidades de processamento. Saiba mais sobre o processamento de unidades e nós.
Clique em Criar para criar a instância.
gcloud
Use o comando gcloud spanner instances create
: Ao usar esse comando,
especifique a capacidade de computação como um número ou nós ou unidades de processamento.
gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --nodes=[NODE-COUNT]
ou
gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --processing-units=[PROCESSING-UNIT-COUNT]
Forneça os valores a seguir:
[INSTANCE-ID]
: um identificador permanente exclusivo em seu projeto do Google Cloud. Não será possível alterá-lo depois.[INSTANCE-CONFIG]
: a configuração da instância, que define o local geográfico dela e afeta a maneira como os dados são replicados. Saiba mais sobre configurações de instâncias.[INSTANCE-NAME]
: o nome a ser exibido para a instância no Console do Google Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.[NODE-COUNT]
: a capacidade de computação da instância, expressa como um número de nós. Cada nó é igual 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. Insira quantidades até 1.000 em múltiplos de 100 (100, 200, 300 etc.) e digite quantidades maiores em múltiplos de 1.000 (1.000, 2.000, 3.000 e assim por diante).
Exemplo:
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Será exibida uma mensagem parecida com o exemplo a seguir:
Creating instance...done.
C++
Para aprender a instalar e usar a biblioteca de cliente para o Cloud Spanner, consulte Bibliotecas de cliente do Cloud Spanner.
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud Spanner, consulte Bibliotecas de cliente do Cloud Spanner.
Go
Para saber como instalar e usar a biblioteca de cliente do Cloud Spanner, consulte Bibliotecas de cliente do Cloud Spanner.
Java
Para aprender a instalar e usar a biblioteca de cliente para o Cloud Spanner, consulte Bibliotecas de cliente do Cloud Spanner.
Node.js
Para aprender a instalar e usar a biblioteca de cliente para o Cloud Spanner, consulte Bibliotecas de cliente do Cloud Spanner.
PHP
Para aprender a instalar e usar a biblioteca de cliente para o Cloud Spanner, consulte Bibliotecas de cliente do Cloud Spanner.
Python
Para aprender a instalar e usar a biblioteca de cliente para o Cloud Spanner, consulte Bibliotecas de cliente do Cloud Spanner.
Ruby
Para aprender a instalar e usar a biblioteca de cliente para o Cloud Spanner, consulte Bibliotecas de cliente do Cloud Spanner.
Como listar instâncias
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
O Console do Google Cloud mostra uma lista de instâncias do Cloud Spanner com o ID, o nome de exibição, a configuração e a capacidade de computação de cada instância, expressas em unidades de processamento e nós.
gcloud
Use o comando gcloud spanner instances list
:
gcloud spanner instances list
A CLI gcloud exibe uma lista de instâncias do Cloud Spanner, além do ID, nome de exibição, configuração e capacidade de computação de cada instância.
Como editar uma instância
As seções a seguir explicam como alterar o nome de exibição e a capacidade de computação de uma instância. Não é possível alterar o código ou a configuração da instância.
Como alterar o nome de exibição
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
Para renomear, clique no nome da instância.
Clique em Editar instância.
Insira um novo nome de instância. Esse nome precisa ser exclusivo no projeto do Google Cloud.
Clique em Save.
gcloud
Use o comando gcloud spanner instances update
:
gcloud spanner instances update [INSTANCE-ID] --description=[INSTANCE-NAME]
Forneça os valores a seguir:
[INSTANCE-ID]
: o identificador permanente da instância.[INSTANCE-NAME]
: o nome a ser exibido para a instância no Console do Google Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.
Como alterar 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 Cloud Spanner.
Há alguns casos em que não é possível reduzir a capacidade de computação de uma instância atual:
- A remoção da capacidade de computação exige que a instância armazene mais de 4 TB de dados a cada 1.000 unidades de processamento (1 nó).
- Com base nos padrões históricos de uso, o Cloud Spanner criou um grande número de divisões nos dados da instância, e, em alguns raros casos, o Cloud Spanner não consegue gerenciar as divisões depois da remoção dos nós.
No último caso, é possível tentar reduzir a capacidade de computação progressivamente em valores menores até encontrar a capacidade mínima que o Cloud Spanner precisa para gerenciar todas as divisões da instância. Se a instância não exigir mais tantas divisões devido a uma alteração nos padrões de uso, o Cloud Spanner poderá mesclar algumas divisões e permitir que você tente reduzir ainda mais a capacidade de computação da instância depois de uma ou duas semanas. de dados.
Ao remover nós, monitore a utilização da CPU e as latências de solicitação em Monitoramento do Cloud para garantir que a utilização da CPU permaneça abaixo de 65% para instâncias regionais e 45% para cada região em instâncias multirregionais. Pode haver um aumento temporário nas latências de solicitação ao remover a capacidade de computação.
Se você quiser aumentar a capacidade de uma instância, seu projeto do Google Cloud precisa ter cota suficiente para adicionar a capacidade de computação.
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
Clique no nome da instância a ser modificada.
Clique em Editar instância.
Para alterar a capacidade de computação, escolha as unidades de medida (unidades de processamento ou nós) e insira uma quantidade. Ao usar unidades de processamento, insira quantidades até 1.000 em múltiplos de 100 (100, 200, 300 e assim por diante) e insira quantidades maiores 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.
Clique em Save.
Se for exibida uma caixa de diálogo informando que sua cota é insuficiente para adicionar nós neste local, siga as instruções para solicitar uma cota maior.
gcloud
Use o comando gcloud spanner instances update
. Ao usar esse comando,
especifique a capacidade de computação como um número ou nós ou unidades de
processamento.
gcloud spanner instances update [INSTANCE-ID] --nodes=[NODE-COUNT]
ou
gcloud spanner instances update [INSTANCE-ID] --processing-units=[PROCESSING-UNIT-COUNT]
Forneça os valores a seguir:
[INSTANCE-ID]
: o identificador permanente da instância.[NODE-COUNT]
: a capacidade de computação da instância, expressa como um número de nós. Cada nó é igual 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. Insira quantidades até 1.000 em múltiplos de 100 (100, 200, 300 etc.) e digite quantidades maiores em múltiplos de 1.000 (1.000, 2.000, 3.000 e assim por diante).
Como rotular uma instância
Os rótulos ajudam a organizar os recursos.
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
Marque a caixa de seleção da instância. O Painel de informações aparece no lado direito da página.
Clique na guia Permissões no painel de informações. É possível adicionar, excluir ou atualizar rótulos para a instância do Cloud Spanner.
Excluir uma instância
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
Clique no nome da instância a ser excluída.
Clique em Excluir instância.
Siga as instruções para confirmar a exclusão da instância.
Clique em Excluir.
gcloud
Use o comando gcloud spanner instances delete
, substituindo [INSTANCE-ID]
pelo código da instância:
gcloud spanner instances delete [INSTANCE-ID]
Como interromper ou reiniciar uma instância
O Cloud Spanner é um serviço de banco de dados totalmente gerenciado que supervisiona as próprias tarefas e recursos subjacentes, incluindo monitoramento e reinicialização de processos quando necessário, sem inatividade. Como não é necessário interromper ou reiniciar manualmente uma determinada instância, o Cloud Spanner não oferece uma maneira de fazer isso.
A seguir
- Saiba como inserir, atualizar e excluir dados com a Linguagem de manipulação de dados (DML) ou a CLI gcloud.
- Conceda papéis de IAM para a instância e os respectivos bancos de dados.
- Saiba como projetar um esquema do Cloud Spanner.