Nesta página, descrevemos como criar, listar, editar e excluir instâncias do Spanner.
criar uma instância
É possível criar uma instância com o console do Google Cloud, a Google Cloud CLI ou as bibliotecas de cliente. Também é possível criar uma instância com uma configuração de instância personalizada adicionando réplicas somente leitura opcionais.
Console
Acesse a página Criar uma instância no Console do Google Cloud.
Digite um Nome de instância para exibir no console do Google Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.
Insira o ID da instância para identificá-la permanentemente. Ele também precisa ser exclusivo no projeto do Google Cloud. Não será possível alterá-lo depois.
Em Escolher uma configuração, clique em Regional ou Multirregional. Como alternativa, se você quiser comparar as especificações entre duas regiões, clique em Comparar configurações de região.
Selecione uma configuração no menu suspenso.
Opcional: adicione réplicas somente leitura para escalonar leituras e oferecer suporte a leituras desatualizadas de baixa latência. Quando você cria e adiciona uma réplica somente leitura a uma configuração de instância usando o console do Google Cloud, a configuração de instância personalizada é criada automaticamente. Para adicionar uma réplica somente leitura, faça o seguinte:
Expanda Configurar réplicas somente leitura.
Clique em Adicionar réplica somente leitura.
Selecione uma região e um número.
Na seção Configurar capacidade de computação, em Selecionar unidade, clique em uma das seguintes opções:
- Unidades de processamento para instâncias pequenas.
- Nós para instâncias grandes. Um nó tem 1.000 unidades de processamento.
Para mais informações, consulte Capacidade de computação, nós e unidades de processamento.
Em Escolha um modo de escalonamento, clique em uma das seguintes opções:
Alocação manual: se você quiser definir manualmente a capacidade de computação de custos e recursos fixos de computação.
- Quantidade indica o número de nós ou unidades de processamento a serem usados para essa instância.
Escalonamento automático (Pré-lançamento) para permitir que o Spanner adicione e remova automaticamente a capacidade de computação. Para mais informações sobre o escalonador automático gerenciado, consulte Escalonador automático gerenciado para o Spanner. Configure as seguintes opções do escalonador automático gerenciado:
- Mínimo indica o limite mínimo de redução da escala vertical, dependendo da unidade de medida escolhida para Capacidade de computação. Para mais informações, consulte Determinar o limite mínimo.
- Máximo indica o limite máximo de escalonamento vertical, dependendo da unidade de medida escolhida para Capacidade de computação. Para mais informações, consulte Determinar o limite máximo.
- Meta de utilização da CPU de alta prioridade indica a porcentagem desejada de CPU de alta prioridade a ser usada. Para mais informações, consulte Determinar a meta de utilização da CPU.
- A meta de utilização do armazenamento indica a porcentagem desejada de armazenamento a ser usada. Para mais informações, consulte Determinar o destino de utilização do armazenamento.
Clique em Criar para gerar a instância.
gcloud
Use o comando gcloud spanner instances create
para criar uma instância. Especifique a capacidade de computação
como o número de nós ou unidades de processamento que você quer na instância.
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --nodes=NODE-COUNT
ou
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --processing-units=PROCESSING-UNIT-COUNT
Substitua:
- INSTANCE-ID: um identificador permanente exclusivo no projeto do Google Cloud. Não será possível alterá-lo depois.
- INSTANCE-CONFIG: identificador permanente da configuração da instância, que define a localização geográfica dela e afeta como os dados são replicados. Para configurações de instâncias personalizadas, ele
começa com
custom-
. Para mais informações, consulte configurações de instâncias. - INSTANCE-DESCRIPTION: o nome a ser exibido para a instância no console do Google Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.
NODE-COUNT: a capacidade de computação da instância, expressa como um número de nós. Cada nó é igual a 1.000 unidades de processamento.
PROCESSING-UNIT-COUNT: a capacidade de computação da instância, expressa como um número de unidades de processamento. Insira quantidades de até 1.000 em múltiplos de 100 (100, 200, 300 e assim por diante) e insira quantidades maiores em múltiplos de 1.000 (1.000, 2000, 3000 e assim por diante). Observação: não use esse parâmetro ao criar uma instância que você pretende ativar com o escalonador automático gerenciado mais tarde.
Adicionar escalonamento automático gerenciado (pré-lançamento)
Também é possível configurar novas instâncias para usar o escalonamento automático gerenciado com o
comando
gcloud beta spanner instances create
. Para mais informações, consulte
Escalonador automático gerenciado para o Spanner.
Use o comando a seguir para criar uma instância com o escalonador automático gerenciado.
gcloud beta spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \ --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
ou
gcloud beta spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --autoscaling-min-nodes=MINIMUM_NODES \ --autoscaling-max-nodes=MAXIMUM_NODES \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
Substitua:
- INSTANCE-ID: um identificador permanente exclusivo no projeto do Google Cloud. Não será possível alterá-lo depois.
- INSTANCE-CONFIG: identificador permanente da configuração da instância, que define a localização geográfica dela e afeta como os dados são replicados. Para configurações de instâncias personalizadas, ele
começa com
custom-
. Para mais informações, consulte configurações de instâncias. - INSTANCE-DESCRIPTION: o nome a ser exibido para a instância no console do Google Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: o número mínimo de unidades de processamento ou nós ao reduzir a escala. Para mais informações, consulte Determinar o limite mínimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: o número máximo de unidades de processamento ou nós ao escalonar verticalmente. Para mais informações, consulte Determinar o limite máximo.
- CPU_PERCENTAGE: a porcentagem desejada de CPU de alta prioridade a ser usada, de 10 a 90%. Se você estiver otimizando o custo, use uma porcentagem maior. Para mais informações, consulte Determinar a meta de utilização da CPU.
- STORAGE_PERCENTAGE: a porcentagem desejada de armazenamento a ser usada, de 10 a 99%. Para mais informações, consulte Determinar a meta de utilização do armazenamento.
Exemplos de uso de configurações personalizadas
Para criar uma instância test-instance
na configuração de instâncias regionais de base us-central1
, execute:
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Para criar uma instância custom-eur6-instance
na configuração de instância multirregional personalizada custom-eur6
, primeiro crie uma configuração de instância personalizada.
Depois, execute:
gcloud spanner instances create custom-eur6-instance --config=custom-eur6 \
--description="Instance with custom read-only" --nodes=1
Você verá uma mensagem semelhante ao exemplo a seguir depois de executar um dos comandos acima:
Creating instance...done.
C++
Para saber como instalar e usar a biblioteca de cliente para o Spanner, consulte Bibliotecas de cliente do Spanner.
Para autenticar no Spanner, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Para saber como instalar e usar a biblioteca de cliente para o Spanner, consulte Bibliotecas de cliente do Spanner.
Para autenticar no Spanner, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para saber como instalar e usar a biblioteca de cliente para o Spanner, consulte Bibliotecas de cliente do Spanner.
Para autenticar no Spanner, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Criar uma instância com escalonamento automático gerenciado usando Go (Prévia)
Java
Para saber como instalar e usar a biblioteca de cliente para o Spanner, consulte Bibliotecas de cliente do Spanner.
Para autenticar no Spanner, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Criar uma instância com escalonamento automático gerenciado usando Java (prévia)
Node.js
Para saber como instalar e usar a biblioteca de cliente para o Spanner, consulte Bibliotecas de cliente do Spanner.
Para autenticar no Spanner, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para saber como instalar e usar a biblioteca de cliente para o Spanner, consulte Bibliotecas de cliente do Spanner.
Para autenticar no Spanner, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para saber como instalar e usar a biblioteca de cliente para o Spanner, consulte Bibliotecas de cliente do Spanner.
Para autenticar no Spanner, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para saber como instalar e usar a biblioteca de cliente para o Spanner, consulte Bibliotecas de cliente do Spanner.
Para autenticar no Spanner, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Listar instâncias
É possível mostrar uma lista das suas instâncias do Spanner.
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
O console do Google Cloud mostra uma lista das instâncias do Spanner, além do ID, nome de exibição, configuração e capacidade de computação de cada instância expresso em unidades de processamento e em nós.
gcloud
Use o comando gcloud spanner instances list
:
gcloud spanner instances list
A CLI gcloud imprime uma lista de instâncias do Spanner, além do ID, nome de exibição, configuração e capacidade de computação de cada instância.
Editar uma instância
As seções a seguir explicam como alterar o nome de exibição e a capacidade de computação de uma instância. Não é possível alterar o código ou a configuração da instância.
Mudar o nome de exibição
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
Para renomear, clique no nome da instância.
Clique em Editar instância.
Insira um novo nome de instância. Esse nome precisa ser exclusivo no projeto do Google Cloud.
Clique em Salvar.
gcloud
Use o comando gcloud spanner instances update
:
gcloud spanner instances update INSTANCE-ID --description=INSTANCE-NAME
Substitua:
- INSTANCE-ID: o identificador permanente da instância.
- INSTANCE-NAME: o nome a ser exibido para a instância no console do Google Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.
Mudar a capacidade de computação
É preciso provisionar capacidade de computação suficiente para manter a utilização da CPU e a utilização do armazenamento abaixo dos valores máximos recomendados. Para mais informações, consulte as cotas e limites do Spanner.
Existem alguns casos em que não é possível reduzir a capacidade de computação de uma instância atual:
- A remoção da capacidade de computação exigiria que sua instância armazenasse mais de 4 TB de dados por 1.000 unidades de processamento (1 nó).
- Com base nos padrões de uso históricos, o Spanner criou um grande número de divisões para os dados da instância e, em alguns casos raros, o Spanner não poderia gerenciar as divisões após a remoção da capacidade de computação.
No último caso, tente reduzir a capacidade de computação em quantidades cada vez menores até encontrar a capacidade mínima necessária para o Spanner gerenciar todas as divisões da instância. Se a instância não exigir mais tantas divisões devido a uma alteração nos padrões de uso, o Spanner poderá mesclar algumas divisões e permitir que você tente reduzir a capacidade de computação da instância ainda mais depois de uma ou duas semanas.
Ao remover a capacidade de computação, monitore o uso da CPU e solicite latências no Cloud Monitoring para garantir que a utilização permaneça abaixo de 65% para instâncias regionais e de 45% para cada região em instâncias multirregionais. Pode haver um aumento temporário nas latências de solicitação ao remover a capacidade de computação.
Se você quiser aumentar a capacidade de computação de uma instância, seu projeto do Google Cloud precisará ter cota suficiente para adicionar essa capacidade.
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
Clique no nome da instância a ser modificada.
Clique em Editar instância.
Para alterar a capacidade de computação, escolha as unidades de medida (unidades de processamento ou nós) e insira uma quantidade. Ao usar unidades de processamento, insira quantidades de até 1.000 em múltiplos de 100 (100, 200, 300 e assim por diante) e insira quantidades maiores em múltiplos de 1.000 (1.000, 2.000, 3.000 e assim por diante). Cada nó é igual a 1.000 unidades de processamento.
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
. Ao usar esse comando, especifique a capacidade de computação como um
número de nós ou unidades de processamento.
gcloud spanner instances update INSTANCE-ID --nodes=NODE-COUNT
ou
gcloud spanner instances update INSTANCE-ID --processing-units=PROCESSING-UNIT-COUNT
Substitua:
- INSTANCE-ID: o identificador permanente da instância.
- NODE-COUNT: a capacidade de computação da instância, expressa como um número de nós. Cada nó é igual a 1.000 unidades de processamento.
- PROCESSING-UNIT-COUNT: a capacidade de computação da instância, expressa como um número de unidades de processamento. Insira quantidades de até 1.000 em múltiplos de 100 (100, 200, 300 e assim por diante) e insira quantidades maiores em múltiplos de 1.000 (1.000, 2000, 3000 e assim por diante).
Ativar ou modificar o escalonador automático gerenciado em uma instância
As limitações a seguir se aplicam quando você adiciona ou altera o recurso de escalonamento automático gerenciado em uma instância atual:
- Não é possível ativar o escalonador automático gerenciado em uma instância que você está movendo.
Não é possível mover uma instância enquanto o escalonador automático gerenciado está ativado.
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
Clique no nome da instância em que você quer ativar o escalonador automático gerenciado.
Clique em Editar instância.
Em Configurar capacidade de computação, clique em Escalonamento automático.
Em Mínimo, selecione o limite mínimo a ser usado ao reduzir a escala. Para mais informações, consulte Determinar o limite mínimo.
Em Máximo, selecione o limite máximo a ser usado ao escalonar verticalmente. Para mais informações, consulte Determinar o limite máximo.
Para Meta de utilização de CPU de alta prioridade, selecione a porcentagem de CPU de alta prioridade que será usada. Para mais informações, consulte Determinar a meta de utilização da CPU.
Em Meta de utilização do armazenamento, selecione a porcentagem de armazenamento que será usada. Para mais informações, consulte Determinar a meta de utilização do armazenamento.
Clique em Salvar.
gcloud
Use o
comando gcloud beta spanner instances update
para adicionar o escalonador automático gerenciado a uma instância. Para mais informações e
limitações, consulte Flags e limitações do Google Cloud CLI
.
Para adicionar o escalonador automático gerenciado, use o seguinte comando:
gcloud beta spanner instances update \ --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \ --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
ou
gcloud beta spanner instances update \ --autoscaling-min-processing-units=MINIMUM_NODES \ --autoscaling-max-processing-units=MAXIMUM_NODES \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
Substitua:
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: o número mínimo de unidades de processamento ou nós a serem usados durante a redução. Para mais informações, consulte Determinar o limite mínimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: o número máximo de unidades de processamento ou nós a serem usados no escalonamento vertical. Para mais informações, consulte Determinar o limite máximo.
- CPU_PERCENTAGE: a porcentagem desejada da CPU de alta prioridade a ser usada, de 10% a 90%. Se você estiver otimizando o custo e não precisar de baixa latência em todas as solicitações, use uma porcentagem maior. Para mais informações, consulte Determinar a meta de utilização da CPU.
- STORAGE_PERCENTAGE: a porcentagem desejada de armazenamento a ser usada, de 10% a 99%. Para mais informações, consulte Determinar o destino de utilização do armazenamento.
Depois de adicionar o escalonador automático gerenciado a uma instância, também é possível modificar as configurações dele. Por exemplo, se você quiser aumentar o número máximo de unidades de processamento para 10.000, execute o seguinte comando:
gcloud beta spanner instances update \
--autoscaling-max-processing-units=10000
Alterar uma instância de escalonamento automático gerenciado para escalonamento manual
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
Clique no nome da instância em que você quer desativar o escalonador automático gerenciado.
Em Escolher um modo de escalonamento, clique em Alocação manual.
Clique em Salvar.
gcloud
Use o comando gcloud beta spanner instances update
para atualizar a instância.
Use o comando a seguir para alterar uma instância do escalonamento automático gerenciado para o escalonamento manual:
gcloud beta spanner instances update \ --processing-units=PROCESSING-UNITS-COUNT
ou
gcloud beta spanner instances update \ --nodes=NODE-COUNT
Substitua PROCESSING-UNIT-COUNT ou NODE-COUNT pelo número de unidades de processamento ou nós que você quer usar na instância.
Rotular uma instância
Os rótulos ajudam a organizar os recursos.
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
Marque a caixa de seleção da instância. O Painel de informações aparece no lado direito da página.
Clique na guia Permissões no painel de informações. Em seguida, adicione, exclua ou atualize os rótulos da instância do Spanner.
Mover uma instância
Para instruções sobre como mover sua instância de qualquer configuração de instância para qualquer outra configuração, inclusive entre configurações regionais e multirregionais, consulte Mover uma instância.
Excluir uma instância
É possível excluir uma instância com o console do Google Cloud ou a Google Cloud CLI.
Para excluir uma instância que tem um ou mais bancos de dados com a proteção contra exclusão ativada, desative a proteção contra exclusão em todos os bancos de dados da instância antes de excluí-la.
Console
Acesse a página Instâncias do Spanner no Console do Google Cloud.
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 ID da instância:
gcloud spanner instances delete INSTANCE-ID
Interromper ou reiniciar uma instância
O Spanner é um serviço de banco de dados totalmente gerenciado que supervisiona as próprias tarefas e recursos subjacentes, incluindo o monitoramento e a reinicialização de processos quando necessário, sem inatividade. Como não é necessário interromper ou reiniciar manualmente uma determinada instância, o Spanner não oferece uma maneira de fazer isso.
A seguir
- Saiba como inserir, atualizar e excluir dados com a linguagem de manipulação de dados (DML) ou a CLI gcloud.
- Conceda papéis de gerenciamento de identidade e acesso à instância e aos bancos de dados dela.
- Entenda como projetar um esquema do Spanner.