Configurar uma instância do Spanner

O Spanner é um serviço de banco de dados totalmente gerenciado e essencial que reúne recursos relacionais, gráficos, de chave-valor e de pesquisa. O Spanner oferece consistência transacional em grande escala global, replicação automática e síncrona para alta disponibilidade e suporte para os seguintes dialetos SQL:

  • GoogleSQL
  • PostgreSQL

Para mais informações, consulte Visão geral das instâncias.

Este documento descreve as conexões e os parâmetros que podem ser configurados ao usar o App Design Center para criar uma instância do Spanner. Os parâmetros de configuração são baseados no módulo terraform-google-cloud-spanner do Terraform.

Conexões de componentes

A tabela a seguir inclui os componentes que podem ser conectados a uma instância do Spanner e as atualizações resultantes no aplicativo e no código do Terraform gerado.

Componente conectado

Atualizações do aplicativo

Informações prévias

Modelo de instância do Compute Engine

  • As instâncias do Compute Engine podem ler e gravar dados na instância do Spanner.
  • O papel roles/spanner.databaseAdmin é adicionado à conta de serviço do modelo de instância do Compute Engine.
  • A conta de serviço do Compute Engine é adicionada como um usuário do IAM à instância do Spanner.
Como usar o Spanner em uma instância de máquina virtual

Conta de serviço

  • A conta de serviço tem acesso à instância do Spanner.
  • A conta de serviço é adicionada como um usuário do IAM à instância do Spanner.
Configurar uma instância com uma conta de serviço

Cloud Run

  • O serviço do Cloud Run pode gerenciar a instância do Spanner.
  • Os detalhes da conexão do Spanner são adicionados às variáveis de ambiente do Cloud Run.
  • O papel roles/spanner.databaseAdmin é adicionado à conta de serviço do Cloud Run.
  • As informações do IAM da conta de serviço do Cloud Run são adicionadas à instância do Spanner.
Conectar aoserviços Google Cloud

Parâmetros de configuração obrigatórios

Se o modelo incluir um componente do Spanner, configure os seguintes parâmetros antes da implantação.

Nome do parâmetro

Descrição e restrições

Informações prévias

ID do projeto

O projeto em que você quer implantar a instância do Spanner.

Configurar componentes

Nome da instância

Um identificador exclusivo para a instância, que não pode ser alterado depois que ela é criada. O nome precisa ter entre 6 e 30 caracteres. name

Configuração da instância

config Configurações de instância

Parâmetros de configuração opcionais

Os parâmetros a seguir são opcionais. Para mostrar os parâmetros avançados, na área Configuração, selecione Mostrar campos avançados.

Recurso

Nome do parâmetro

Descrição e informações de restrição

Informações prévias

Tamanho da instância

Número de nós

nodeCount Capacidade de computação, nós e unidades de processamento

Unidades de processamento

processingUnits Capacidade de computação, nós e unidades de processamento

Nome de exibição da instância

displayName Mudar o nome de exibição

Criar instância

Por padrão, uma nova instância do Spanner é criada. Desmarque a caixa de seleção para usar uma instância atual. Criar e gerenciar instâncias

Ativar escalonamento automático

Selecione para ativar o escalonamento automático na instância do Spanner. Visão geral do escalonamento automático

IAM da instância

Uma lista separada por vírgulas de permissões na instância. Por exemplo, user:user1@cymbalgroup.com=>roles/spanner.databaseAdmin, user:user2@cymbalgroup.com=>roles/spanner.databaseAdmin Visão geral do IAM
Rótulos de instância

Key

labels Marcar uma instância

Valor

labels Marcar uma instância
Configuração do banco de dados

Key

A chave do objeto de mapa database_config. database_config

Período de retenção da versão

versionRetentionPeriod Visão geral da recuperação pontual (PITR)

DDL

ddl GoogleSQL ou PostgreSQL

Nome da chave do KMS

kmsKeyName Visão geral das chaves de criptografia gerenciadas pelo cliente (CMEK)

Proteção contra exclusão

Selecione para impedir que o Terraform exclua o banco de dados. deletion_protection

IAM do banco de dados

Uma lista separada por vírgulas de permissões no banco de dados. Por exemplo, user:user1@cymbalgroup.com=>roles/spanner.databaseAdmin, user:user2@cymbalgroup.com=>roles/spanner.databaseAdmin Visão geral do IAM

Ativar backup

Por padrão, um backup automatizado do banco de dados é criado. Se você não quiser um backup, desmarque a caixa de seleção. Visão geral dos backups

Retenção de backup

retentionDuration Backups incrementais

Criar banco de dados

Por padrão, um banco de dados é criado. Se você não quiser um banco de dados, desmarque a caixa de seleção. Visão geral dos bancos de dados

Texto da especificação do cron

texto Criar e gerenciar programações de backup

Mínimo de unidades de processamento

minProcessingUnits Escalonador automático gerenciado

Máximo de unidades de processamento

maxProcessingUnits Escalonador automático gerenciado

Mínimo de nós

minNodes Escalonador automático gerenciado

Número máximo de nós

maxNodes Escalonador automático gerenciado

Porcentagem de uso da CPU de alta prioridade

highPriorityCpuUtilizationPercent Escalonador automático gerenciado

Porcentagem de uso do armazenamento

storageUtilizationPercent Escalonador automático gerenciado

Local da réplica

local Escalonamento automático de somente leitura assimétrica

Substituir o número mínimo de nós

AutoscalingConfigOverrides Parâmetros do escalonador automático gerenciado

Substituir o número máximo de nós

AutoscalingConfigOverrides Parâmetros do escalonador automático gerenciado

Edição

Edição Visão geral das edições do Spanner

Tipo de programação de backup padrão

defaultBackupScheduleType Programações de backup padrão

Forçar exclusão

Selecione para excluir backups ao excluir a instância do Spanner. force_destroy

Usar especificação de backup completo

fullBackupSpec Programações de backup

Usar especificação de backup incremental

incrementalBackupSpec Backups incrementais