Nesta página, descrevemos como criar, listar, editar, excluir instâncias do Cloud Spanner. Para saber mais sobre instâncias, consulte Instâncias.
Como criar uma instância
É possível criar uma instância na linha de comando usando a ferramenta de linha de comando gcloud ou por meio do Console do Google Cloud Platform.
Console
- Acesse a página do Spanner no Console do GCP.
Acessar a página do Spanner - Clique em Criar instância.
Na caixa de diálogo de criação de instância, especifique:
- o nome da instância (nome de exibição). É necessário que esse nome seja exclusivo para o projeto do Google Cloud Platform;
- o código da instância. Esse código precisa ser exclusivo para o projeto e não pode ser alterado;
- uma configuração, que define o posicionamento geográfico e a replicação dos nós na sua instância;
- o número de nós dessa instância. Esse número corresponde à quantidade de recursos de serviço e de armazenamento que estão disponíveis para os bancos de dados na instância.
Clique em Criar para criar uma instância.
Veja a seguir um exemplo de uma página de criação de instância:
gcloud
Use o comando gcloud spanner instances create, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:
gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --nodes=[NODE-COUNT]
em que:
[INSTANCE-ID]: um identificador que precisa ser exclusivo no projeto do Google Cloud Platform. Esse código não pode ser alterado.[INSTANCE-CONFIG]: uma configuração de instância, que define o posicionamento geográfico e a replicação dos dados na instância.[INSTANCE-NAME]: um nome de exibição da instância que precisa ser exclusivo para o projeto do Google Cloud Platform.[NODE-COUNT]: o número de nós dessa instância. A contagem de nós corresponde à quantidade de recursos de serviço e de armazenamento que estão disponíveis para os bancos de dados na instância.
Exemplo:
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Você verá:
Creating instance...done.
Como listar instâncias
Console
Acesse a página Instâncias do Spanner no Console do GCP.
Acessar a página Instâncias do Spanner
Você verá uma lista de suas instâncias do Cloud Spanner, além do código, nome de exibição, configuração e o número de nodes da instância.
gcloud
gcloud spanner instances list
Você verá uma lista de suas instâncias do Cloud Spanner, além do nome de exibição, configuração e o número de nodes da instância.
Como editar uma instância
Como alterar o nome de exibição
Console
- Acesse a página Instâncias do Spanner no Console do GCP.
Acesse a página “Instâncias do Spanner” - Para renomear, clique no nome da instância.
- Clique em Editar instância.
- Especifique um novo nome de instância. Esse nome precisa ser exclusivo para o projeto do Google Cloud Platform.
- Clique em Salvar.
gcloud
gcloud spanner instances update [INSTANCE-ID] --description=[INSTANCE-NAME]
Como alterar uma configuração de instância
Não é possível alterar a configuração de uma instância existente.
Como alterar o número de nós
Console
- Acesse a página Instâncias do Spanner no Console do GCP.
Acesse a página “Instâncias do Spanner” - Para alterar a contagem de nodes, clique no nome da instância.
- Clique em Editar instância.
- Especifique o número de nós.
Se os nós não forem suficientes no local, siga as instruções para solicitar mais nós antes de prosseguir. - Clique em Salvar.
gcloud
gcloud spanner instances update [INSTANCE-ID] --nodes=[NODE-COUNT]
Como excluir uma instância
Console
- Acesse a página Instâncias do Spanner no Console do GCP.
Acesse a página “Instâncias do Spanner” - Clique no nome da instância que você quer excluir.
- Clique em Excluir instância.
- Siga as instruções para confirmar a exclusão.
- Clique em Excluir.
Excluir uma instância remove permanentemente a instância e todos os bancos de dados dela. Não é possível desfazer essa ação.
gcloud
gcloud spanner instances delete [INSTANCE-ID]
Excluir uma instância remove permanentemente a instância e todos os bancos de dados dela. Não é possível desfazer essa ação.
