Nesta página, descrevemos como criar, listar, editar e excluir o Spanner instances.
Criar uma instância
É possível criar uma instância com o console do Google Cloud, Google Cloud CLI ou bibliotecas de cliente. Também é possível criar instância com um configuração personalizada da instância adicionando réplicas somente leitura opcionais.
Console
No console do Google Cloud, acesse a página Instâncias do Spanner.
Clique em Criar instância.
Na seção Selecionar uma edição, selecione um Spanner edição.
Se você quiser comparar as especificações entre as diferentes edições, clique em Comparar edições. Para mais informações, consulte a Visão geral das edições do Spanner.
Clique em Continuar.
Na seção Nomear a instância, insira um Nome da instância para mostrar no console do Google Cloud. O nome da instância precisa ser exclusivo no projeto do Google Cloud.
Insira um ID da instância para identificá-la permanentemente. O o ID da instância também precisa ser exclusivo no projeto do Google Cloud. Não será possível alterá-lo depois.
Clique em Continuar.
Na seção Configurar sua instância, em Escolha uma configuração, selecione Regional, Birregional ou Multirregional.
Selecione um local de configuração na lista suspensa.
Opcional: para adicionar uma réplica somente leitura a uma base do Spanner do seu aplicativo, primeiro crie uma configuração de instância personalizada usando o Google Cloud CLI. A adição de réplicas somente leitura opcionais a uma configuração de base está disponível nas edições Enterprise e Enterprise Plus.
Clique em Continuar.
Na seção Alocar capacidade de computação, em Selecionar unidade, clique em uma destas 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 Escolher um modo de escalonamento, clique em uma das seguintes opções:
Alocação manual, se você quiser definir manualmente a capacidade de computação para custos e recursos fixos de computação.
- Quantidade indica o número de nós ou unidades de processamento. usar para essa instância.
Escalonamento automático (Pré-lançamento), para permitir que o Spanner adicione e remova automaticamente recursos de armazenamento. O escalonador automático gerenciado está disponível Spanner Enterprise e Enterprise Plus. 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, com base na unidade de medida escolhida para o Compute de armazenamento. Para mais informações, consulte Determinar o limite mínimo.
- Máximo indica o limite máximo para escalonamento, dependendo da unidade de medida escolhida para a capacidade de computação. Para mais informações, consulte Determinar o limite máximo.
- Meta de utilização de CPU de alta prioridade indica a meta a porcentagem de CPU de alta prioridade a ser usada. Para mais informações, consulte Determinar a meta de utilização da CPU.
- A meta de uso do armazenamento indica a porcentagem de armazenamento a ser usada. Para mais informações, consulte Determinar o objetivo de uso do armazenamento.
Clique em Criar para criar a instância.
gcloud
Use o comando gcloud spanner instances create
para criar uma instância. Especificar a capacidade de computação
como o número de nós ou unidades de processamento que você quer ter na instância.
gcloud spanner instances create INSTANCE_ID \ --edition=EDITION \ --config=INSTANCE_CONFIG \ --description=INSTANCE_DESCRIPTION \ --nodes=NODE_COUNT
ou
gcloud spanner instances create INSTANCE_ID \ --edition=EDITION \ --config=INSTANCE_CONFIG \ --description=INSTANCE_DESCRIPTION \ --processing-units=PROCESSING_UNIT_COUNT
Substitua:
- INSTANCE-ID: um identificador permanente que é exclusivo em seu projeto do Google Cloud. Não será possível alterá-lo depois.
- INSTANCE-CONFIG: um identificador permanente da configuração da instância, que define a localização geográfica dela e afeta a maneira como os dados são replicados. Para configurações de instância personalizadas,
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 em 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 até 1.000 em múltiplos de 100 (100, 200, 300 e assim por diante) e insira maior quantidades em múltiplos de 1000 (1000, 2000, 3000 e assim por diante). Observação: Não use esse parâmetro ao criar uma instância que você pretende para ativar com o escalonador automático gerenciado mais tarde.
Adicionar o escalonamento automático gerenciado (pré-lançamento)
Também é possível criar instâncias da edição Enterprise e da
edição Enterprise Plus
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 um escalonador automático gerenciado.
gcloud beta spanner instances create INSTANCE_ID \ --edition=EDITION \ --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 \ --edition=EDITION \ --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 que é exclusivo em seu projeto do Google Cloud. Não será possível alterá-lo depois.
- INSTANCE-CONFIG: um identificador permanente da configuração da instância, que define a localização geográfica dela e afeta a maneira como os dados são replicados. Para configurações de instâncias personalizadas, ele
começa com
custom-
. Para mais informações, consulte instance personalizadas. - INSTANCE-DESCRIPTION: o nome a ser exibido para a instância em 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 nós ou unidades de processamento ao reduzir a escala vertical. Para mais informações, consulte Determinar o limite mínimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: o e o número máximo de nós ou unidades de processamento durante o escalonamento vertical. Para mais informações, consulte Determinar o limite máximo.
- CPU_PERCENTAGE: a porcentagem desejada de CPU de alta prioridade para usar, de 10 a 90%. Se você estiver otimizando para 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 Determine 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ância regional
base us-central1
, execute:
gcloud spanner instances create test-instance --edition=STANDARD --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Para criar uma instância custom-eur6-instance
na multirregião personalizada
configuração da instância custom-eur6
, primeiro
criar uma configuração de instância personalizada.
Depois, execute:
gcloud spanner instances create custom-eur6-instance --edition=ENTERPRISE_PLUS --config=custom-eur6 \
--description="Instance with custom read-only" --nodes=1
Uma mensagem semelhante ao exemplo a seguir será exibida depois de executar um dos comandos anteriores:
Creating instance...done.
C++
Para aprender a instalar e usar a biblioteca de cliente do 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 aprender a instalar e usar a biblioteca de cliente do 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 do 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 o Go (pré-lançamento)
Java
Para saber como instalar e usar a biblioteca de cliente do 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é-lançamento)
Node.js
Para saber como instalar e usar a biblioteca de cliente do 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 aprender a instalar e usar a biblioteca de cliente do 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 do 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 aprender a instalar e usar a biblioteca de cliente do 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 suas instâncias do Spanner, incluindo o ID, o nome de exibição, a configuração e a capacidade de computação expressas nas unidades de processamento e nos nós.
gcloud
Use o comando gcloud spanner instances list
:
gcloud spanner instances list
A CLI do gcloud mostra uma lista das suas instâncias do Spanner, incluindo o ID, o nome de exibição, a configuração e a capacidade de computação de cada instância.
Editar uma instância
As seções a seguir explicam como fazer upgrade da edição da sua instância e mudar o nome de exibição e a capacidade de computação de uma instância. Não é possível alterar ID ou configuração da instância (no entanto, você pode mover a instância).
Fazer upgrade da edição
É possível fazer upgrade das instâncias da edição Standard para um nível superior edição. É possível fazer upgrade das instâncias da edição Standard para a Enterprise ou Enterprise Plus. As instâncias da edição Enterprise podem ser atualizadas para a edição Enterprise Plus.
O downgrade por autoatendimento não está disponível. Para fazer downgrade da edição abrir um tíquete de suporte. Para mais informações, consulte as Perguntas frequentes sobre as edições do Spanner.
Console
Acesse a página Instâncias do Spanner no console do Google Cloud.
Clique no nome da instância que você quer atualizar.
Clique em Fazer upgrade ao lado do tipo de edição.
Na página Edição da instância, em Atualizar edição, selecione a nova edição de nível superior para sua instância.
Clique em Salvar.
gcloud
Use o comando gcloud spanner instances update
para fazer upgrade da edição da sua instância:
gcloud spanner instances update INSTANCE_ID --edition=EDITION \ [--async]
Substitua:
- INSTANCE_ID: o identificador permanente da instância.
- EDITION: especifica a nova edição de nível superior para sua instância. Para mais informações, consulte a Visão geral das edições do Spanner.
Sinalizações opcionais:
--async
: use essa sinalização se quiser que sua solicitação seja retornada imediatamente; sem esperar a conclusão da operação em andamento. Você pode conferir o status da sua solicitação executandogcloud spanner operations describe
Go
Java
Node.js
Para aprender a instalar e usar a biblioteca de cliente do 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 do 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.
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
Provisione capacidade de computação suficiente para manter a utilização da CPU e a utilização de armazenamento abaixo dos valores máximos recomendados. Para mais informações, consulte as cotas e limites do Spanner.
Há alguns casos em que não é possível reduzir a capacidade de computação de uma instância:
- 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 seus padrões históricos de uso, o Spanner criou um grande número de divisões para sua dos dados da instância e, em alguns casos raros, o Spanner não poderia para gerenciar as divisões depois de remover a capacidade de computação.
No último caso, é possível tentar reduzir a capacidade de computação progressivamente em valores menores até encontrar a capacidade mínima que o Spanner precisa para gerenciar todas as divisões da instância. Se a instância não exigir mais tantas divisões devido a uma mudança nos padrões de uso, o Spanner poderá mesclar algumas divisões e permitir que você tente reduzir ainda mais a capacidade de computação da instância depois de uma ou duas semanas.
Ao remover a capacidade de computação, monitore a utilização da CPU e as latências de solicitação em Monitoramento do Cloud para garantir que a utilização da CPU permaneça abaixo de 65% para instâncias regionais e 45% para cada região em instâncias multirregionais. Pode haver um aumento temporário nas solicitações e latências ao remover a capacidade de computação.
Se você quiser aumentar a capacidade de uma instância, seu projeto do Google Cloud precisa ter cota suficiente para adicionar a capacidade de computação. O tempo necessário para que a solicitação de aumento seja concluída depende do tamanho da solicitação. Na maioria dos casos, as solicitações são concluídas em alguns minutos. Ativado raras ocasiões, um escalonar verticalmente pode levar até uma hora para ser concluído.
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.
Escolha as unidades de medida para alterar a capacidade de computação (unidades de processamento ou nós) e, em seguida, inserir uma quantidade. Ao usar unidades de processamento, insira quantidades 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 [--async]
ou
gcloud spanner instances update INSTANCE_ID --processing-units=PROCESSING_UNIT_COUNT [--async]
Substitua:
- INSTANCE_ID: o identificador permanente da instância.
- NODE_COUNT: a capacidade de computação da instância, expressa como uma total 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 até 1.000 em múltiplos de 100 (100, 200, 300 e assim por diante) e insira maior quantidades em múltiplos de 1000 (1000, 2000, 3000 e assim por diante).
Sinalizações opcionais:
--async
: use essa flag se quiser que a solicitação seja retornada imediatamente, sem aguardar a conclusão da operação em andamento. Você pode conferir o status da sua solicitação executandogcloud spanner operations describe
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 escalonamento automático gerenciado atributo em uma instância atual:
- O escalonador automático gerenciado só está disponível na edição Enterprise ou Enterprise Plus.
- Não é possível ativar o escalonador gerenciado em uma instância que está sendo movida.
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 ativado.
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 na redução de escala. Para mais informações, consulte Determinar o limite mínimo.
Em Máximo, selecione o limite máximo a ser usado no escalonamento. Para mais informações, consulte Determinar o limite máximo.
Em Meta de utilização de CPU de alta prioridade, selecione a porcentagem de CPU de alta prioridade a ser usada. Para mais informações, consulte Determinar a meta de utilização da CPU.
Em Meta de uso do armazenamento, selecione a porcentagem de armazenamento usar. Para mais informações, consulte Determine a meta de utilização do armazenamento.
Clique em Salvar.
gcloud
Use o
gcloud beta spanner instances update
para adicionar o escalonador automático gerenciado a uma instância. Para mais informações e
limitações, consulte sinais e limitações de Google Cloud CLI
.
É possível adicionar o escalonador automático gerenciado com o seguinte comando:
gcloud beta spanner instances update INSTANCE_ID \ --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 INSTANCE_ID \ --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:
- INSTANCE_ID: o identificador permanente da instância.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: o número mínimo de unidades ou nós de processamento para usar ao reduzir a escala vertical. Para mais informações, consulte Determine o limite mínimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: o número máximo de unidades de processamento ou nós a serem usadas ao aumentar a escala. Para mais informações, consulte Determinar o limite máximo
- CPU_PERCENTAGE: a porcentagem desejada de CPU de alta prioridade para uso, de 10% a 90%. Se você otimizar os custos e não precisar de latência em todas as solicitações e depois use uma porcentagem maior. Para mais informações, consulte Determine a meta de utilização da CPU.
- STORAGE_PERCENTAGE: a porcentagem de armazenamento a ser usada, de 10% a 99%. Para mais informações, consulte Determine a meta de utilização do armazenamento.
Depois de adicionar o escalonador automático gerenciado a uma instância, também é possível modificar o configurações do escalonador automático gerenciado. Por exemplo, se você quiser aumentar o limite número de unidades de processamento para 10.000, execute o seguinte comando:
gcloud beta spanner instances update test-instance \
--autoscaling-max-processing-units=10000
Alterar uma instância do uso do escalonador automático gerenciado para o 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 gerenciamento. escalonador automático ativado.
Em Escolher um modo de escalonamento, clique em Alocação manual.
Clique em Salvar.
gcloud
Usar o gcloud beta spanner instances update
para atualizar a instância.
Use o comando a seguir para mudar uma instância do escalonador automático gerenciado para o escalonamento manual:
gcloud beta spanner instances update INSTANCE_ID \ --processing-units=PROCESSING_UNIT_COUNT
ou
gcloud beta spanner instances update INSTANCE_ID \ --nodes=NODE_COUNT
Substitua:
- INSTANCE_ID: o identificador permanente da instância.
- NODE_COUNT: a capacidade de computação da instância, expressa como uma série 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 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).
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. É possível adicionar, excluir ou atualizar rótulos para a instância do Spanner.
Mover uma instância
Para instruções sobre como mover a instância de qualquer configuração para outra, incluindo configurações regionais e multirregionais, consulte Mover uma instância.
Excluir uma instância
É possível excluir uma instância usando o console do Google Cloud ou a CLI do Google Cloud.
Se você quer excluir uma instância que tem um ou mais bancos de dados com ativada, é necessário desativar a proteção contra exclusão em todos os bancos de dados da instância antes que seja possível 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 próprias tarefas e recursos, incluindo monitoramento e reinicialização e 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 o Linguagem de manipulação de dados (DML, na sigla em inglês) ou a CLI gcloud.
- Conceda papéis de gerenciamento de identidade e acesso para a instância e os respectivos bancos de dados.
- Saiba como projetar um esquema do Spanner.