Criar e gerenciar instâncias

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

  1. Acesse a página do Spanner no Console do GCP.
    Acessar a página do Spanner
  2. Clique em Criar instância.
  3. 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.
  4. Clique em Criar para criar uma instância.

Veja a seguir um exemplo de uma página de criação de instância:

Captura de tela da janela 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

  1. Acesse a página Instâncias do Spanner no Console do GCP.
    Acesse a página “Instâncias do Spanner”
  2. Para renomear, clique no nome da instância.
  3. Clique em Editar instância.
  4. Especifique um novo nome de instância. Esse nome precisa ser exclusivo para o projeto do Google Cloud Platform.
  5. 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

  1. Acesse a página Instâncias do Spanner no Console do GCP.
    Acesse a página “Instâncias do Spanner”
  2. Para alterar a contagem de nodes, clique no nome da instância.
  3. Clique em Editar instância.
  4. 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.
  5. Clique em Salvar.

gcloud

gcloud spanner instances update [INSTANCE-ID] --nodes=[NODE-COUNT]

Como excluir uma instância

Console

  1. Acesse a página Instâncias do Spanner no Console do GCP.
    Acesse a página “Instâncias do Spanner”
  2. Clique no nome da instância que você quer excluir.
  3. Clique em Excluir instância.
  4. Siga as instruções para confirmar a exclusão.
  5. 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.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud Spanner