Como criar e gerenciar instâncias

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

  1. Acesse a página Criar uma instância no Console do Cloud.

    Criar uma instância

  2. 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.
  3. Clique em Criar para criar a instância.

Na captura de tela a seguir, veja a página de criação da instância:

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

Acessar a página "Instâncias"

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

  1. Acesse a página Instâncias do Spanner no Console do Cloud.

    Acessar a página "Instâncias"

  2. Para renomear, clique no nome da instância.

  3. Clique em Editar instância.

  4. Insira um novo nome de instância. Esse nome precisa ser exclusivo no projeto do Google Cloud.

  5. 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.

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

  1. Acesse a página Instâncias do Spanner no Console do Cloud.

    Acessar a página "Instâncias"

  2. Clique no nome da instância a ser modificada.

  3. Clique em Editar instância.

  4. Digite o número de nós desejado.

  5. 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

  1. Acesse a página Instâncias do Spanner no Console do Cloud.

    Acessar a página "Instâncias"

  2. Clique no nome da instância a ser excluída.

  3. Clique em Excluir instância.

  4. Siga as instruções para confirmar a exclusão da instância.

  5. 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