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
Acesse a página Criar uma instância no Console do GCP.
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.
Clique em Criar para criar a instância.
A captura de tela a seguir mostra a 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.
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
Acesse a página Instâncias do Spanner no Console do GCP.
Para renomear, clique no nome da instância.
Clique em Editar instância.
Digite um novo nome de instância. Ele precisa ser exclusivo no projeto do GCP.
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
Acesse a página Instâncias do Spanner no Console do GCP.
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 para a instância
Como excluir uma instância
Console
Acesse a página Instâncias do Spanner no Console do GCP.
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 mais sobre 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.
