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 ferramenta de linha de comando gcloud ou com o Console do Google Cloud.
Console
Acesse a página Criar uma instância no Console do Cloud.
Insira os seguintes valores:
- Um nome da instância a ser exibido no Console do 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 dos nós da instância e afeta a replicação dos dados. Saiba mais sobre configurações de instâncias.
- O número de nós para a instância. Esse número determina a quantidade de recursos de exibição e armazenamento disponíveis para bancos de dados na instância.
Clique em Criar para criar a instância.
Na captura de tela a seguir, veja a página de criação da instância:
gcloud
Use o comando gcloud spanner instances create:
gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --nodes=[NODE-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 a localização geográfica dos nós da instância e afeta a replicação dos dados. Saiba mais sobre configurações de instâncias.[INSTANCE-NAME]: o nome a ser exibido para a instância no Console do Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.[NODE-COUNT]: o número de nós da instância. Esse número determina a quantidade de recursos de exibição e armazenamento disponíveis para bancos de dados na instância.
Por 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.
Como listar instâncias
Console
Acesse a página Instâncias do Spanner no Console do Cloud.
No Console do Cloud, você encontra uma lista de instâncias do Cloud Spanner, incluindo código, nome de exibição, configuração e número de nós correspondentes.
gcloud
Use o comando gcloud spanner instances list:
gcloud spanner instances list
A ferramenta gcloud imprime uma lista de instâncias do Cloud Spanner, incluindo código, nome de exibição, configuração e número de nós correspondentes.
Como editar uma instância
Nas seções a seguir, explicamos como alterar o nome de exibição e o número de nós 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 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 Salvar.
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 Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.
Como alterar o número de nós
É preciso provisionar nós suficientes para acomodar suas necessidades de armazenamento e manter a utilização da CPU abaixo do máximo recomendado. Para mais informações sobre os recursos fornecidos por um nó, consulte cotas e limites do Cloud Spanner.
Em alguns casos, não é possível remover nós de uma instância existente:
- A remoção dos nós exigiria que a instância armazenasse mais de 2 TB de dados por 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 o Cloud Spanner não consegue gerenciar as divisões depois da remoção dos nós.
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. Talvez haja um aumento temporário nas latências de solicitação durante a remoção de nós.
Para aumentar o número de nós em uma instância, seu projeto do Google Cloud precisa ter cota suficiente para adicionar os nós.
Console
Acesse a página Instâncias do Spanner no Console do Cloud.
Clique no nome da instância a ser modificada.
Clique em Editar instância.
Digite o número de nós desejado.
Clique em Salvar.
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:
gcloud spanner instances update [INSTANCE-ID] --nodes=[NODE-COUNT]
Forneça os valores a seguir:
[INSTANCE-ID]: o identificador permanente da instância.[NODE-COUNT]: o número de nós da instância.
Como excluir uma instância
Console
Acesse a página Instâncias do Spanner no Console do 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]
A seguir
- Saiba como inserir, atualizar e excluir dados com a linguagem de manipulação de dados (DML, na sigla em inglês) ou a ferramenta
gcloud. - Conceda papéis de IAM para a instância e os respectivos bancos de dados.
- Saiba como projetar um esquema do Cloud Spanner.