Como criar e gerenciar instâncias

Nesta página, você verá como criar, listar, editar e excluir instâncias do Cloud Spanner.

Como criar uma instância

Para criar uma instância, use a ferramenta de linha de comando gcloud ou Console do Google Cloud Platform.

Console

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

    Criar uma instância

  2. Digite os seguintes valores:

    • Um nome de instância a ser exibido no Console do GCP. Ele precisa ser exclusivo no projeto do Google Cloud Platform.
    • Um código de instância para identificá-la permanentemente. Ele também precisa ser exclusivo no projeto do GCP. 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 como os dados são replicados. 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.

A captura de tela a seguir mostra 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 instances create:

gcloud 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 no projeto do Google Cloud Platform. 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 dela e afeta 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 GCP. Ele precisa ser exclusivo no projeto do Google Cloud Platform.
  • [NODE-COUNT]: 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.

Por exemplo:

gcloud 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 GCP.

Acessar a página "Instâncias"

O Console do GCP mostra uma lista das instâncias do Cloud Spanner com o código, o nome de exibição, a configuração e o número de nós de cada instância.

gcloud

Use o comando gcloud spanner instances list:

gcloud spanner instances list

A ferramenta gcloud imprime uma lista das instâncias do Cloud Spanner com o código, o nome de exibição, a configuração e o número de nós de cada instância.

Como editar uma instância

Nas seções a seguir, você verá como alterar o nome de exibição e o número de nós de uma instância. Não é possível alterar a configuração de uma instância atual.

Como alterar o nome de exibição

Console

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

    Acessar a página "Instâncias"

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

  3. Clique em Editar instância.

  4. Digite um novo nome de instância. Ele precisa ser exclusivo no projeto do GCP.

  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 GCP. Ele precisa ser exclusivo no projeto do Google Cloud Platform.

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.

Para aumentar o número de nós em uma instância, o projeto do GCP precisa ter cota suficiente para adicioná-los.

Console

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

    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 para a instância

Como excluir uma instância

Console

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

    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

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

Enviar comentários sobre…

Documentação do Cloud Spanner