Sobre as configurações da instância

Esta página contém informações sobre as configurações disponíveis para instâncias do Cloud SQL.

Configurações do Cloud SQL para PostgreSQL

Console string           API enum string
PostgreSQL 17            POSTGRES_17
PostgreSQL 16 (default)  POSTGRES_16
PostgreSQL 15            POSTGRES_15
PostgreSQL 14            POSTGRES_14
PostgreSQL 13            POSTGRES_13
PostgreSQL 12            POSTGRES_12

Console string          API enum string
PostgreSQL 17           POSTGRES_17
PostgreSQL 16 (default) POSTGRES_16
PostgreSQL 15           POSTGRES_15
PostgreSQL 14           POSTGRES_14
PostgreSQL 13           POSTGRES_13
PostgreSQL 12           POSTGRES_12
PostgreSQL 11           POSTGRES_11
PostgreSQL 10           POSTGRES_10
PostgreSQL 9.6          POSTGRES_9_6

ID da instância

O código da instância é o nome dela. Ele é usado para identificar exclusivamente sua instância dentro do seu projeto. Sempre que possível, escolha um nome que indique a finalidade da instância

project-ID:instance-ID precisa ter 98 caracteres ou menos.

Não é necessário incluir o ID do projeto no nome da instância. Isso é feito automaticamente quando necessário, como nos arquivos de registros. Consultar as diretrizes de nomenclatura

Região

A região do Google Cloud em que a instância está localizada. Regiões são áreas geográficas independentes que consistem em zonas. Zonas e regiões são abstrações lógicas de recursos físicos subjacentes. Uma região consiste em três ou mais zonas alojadas em três ou mais data centers físicos. As regiões México, Osaka e Montreal têm três zonas instaladas em um ou dois data centers físicos. Essas regiões estão em processo de expansão para pelo menos três data centers físicos. Ao projetar suas soluções no Google Cloud, considere as orientações em Locais do Cloud, SLAs do Google Cloud Platform e a documentação do produto do Google Cloud adequada. Só é possível definir a região durante a criação da instância. Para melhorar o desempenho, mantenha os dados próximos aos serviços que precisam deles. Para mais informações, consulte Locais da instância.

Zona

A zona do Google Cloud em que a instância está localizada. Ao estabelecer uma conexão a partir de uma instância do Compute Engine, você precisará selecionar a zona em que essa instância está localizada. Caso contrário, aceite a zona padrão. É possível editar a instância posteriormente para alterar a zona, se necessário. Para mais informações, consulte Locais da instância.

Tipo de máquina

Determina os núcleos virtuais e de memória disponíveis para a instância do Cloud SQL. A disponibilidade do tipo de máquina é determinada pela edição do Cloud SQL.

Para cargas de trabalho que exigem processamento em tempo real, como processamento de transações on-line (OLTP, na sigla em inglês), verifique se a instância tem memória suficiente para conter todo o conjunto de trabalho. No entanto, há outros fatores que podem afetar os requisitos de memória, como o número de conexões ativas e os processos de sobrecarga interna. Realize o teste de carga para evitar problemas de desempenho no seu ambiente de produção.

Ao configurar a instância, selecione memória e vCPUs suficientes para processar a carga de trabalho e faça o upgrade à medida que a carga de trabalho aumenta. Uma configuração de máquina com vCPUs insuficientes pode perder a cobertura do SLA. Para mais informações, consulte as diretrizes operacionais.

Tipos de máquina para instâncias da edição Cloud SQL Enterprise Plus Para instâncias do Cloud SQL Enterprise Plus, os tipos de máquina são predefinidos da seguinte maneira:

Tipo de máquina da edição Enterprise Plus	vCPUs	Memória (GB)	SSD local
db-perf-optimized-N-2	2	16	375
db-perf-optimized-N-4	4	32	375
db-perf-optimized-N-8	8	64	375
db-perf-optimized-N-16	16	128	750
db-perf-optimized-N-32	32	256	1.500
db-perf-optimized-N-48	48	384	3000
db-perf-optimized-N-64	64	512	6.000
db-perf-optimized-N-80	80	640	6.000
db-perf-optimized-N-96	96	768	6.000
db-perf-optimized-N-128	128	864	9000

Tipos de máquina para instâncias da edição Cloud SQL Enterprise Para instâncias do Cloud SQL Enterprise, também é possível criar configurações personalizadas usando o gcloud sql instances create. Com as configurações de instância flexíveis, você seleciona a quantidade de memória e CPUs necessárias para a instância. Essa flexibilidade permite escolher o formato de VM apropriado para a carga de trabalho.

Os nomes dos tipos de máquina usam o seguinte formato: db-custom-#-#

Substitua o primeiro marcador # pelo número de CPUs na máquina e o segundo marcador # pela quantidade de memória na máquina.

Por exemplo, se o nome da máquina for db-custom e tiver 1 CPU e 3.840 MB de RAM, o formato será db-custom-1-3840.

Ao selecionar o número de CPUs e a quantidade de memória, há algumas restrições à configuração escolhida:

• O valor das vCPUs precisa ser 1 ou um número par entre 2 e 96.
• A memória precisa:
  • ter 0,9 a 6,5 GB por vCPU;
  • ser um múltiplo de 256 MB;
  • ter pelo menos 3,75 GB (3840 MB).

A tabela a seguir lista os nomes de cada tipo de máquina legado, o número de CPUs e RAM de cada tipo de máquina e a string resultante para do tipo de máquina.

É possível criar o tipo de máquina equivalente especificando a CPU e a RAM equivalentes no console do Google Cloud, usando a CLI gcloud ou especificando db-custom-#-# na API.

Tipo de máquina legada	vCPUs	Memória (MB)	db-custom-CPU-RAM (string do nível da API)
db-n1-standard-1	1	3.840	db-custom-1-3840
db-n1-standard-2	2	7.680	db-custom-2-7680
db-n1-standard-4	4	15.360	db-custom-4-15360
db-n1-standard-8	8	30.720	db-custom-8-30720
db-n1-standard-16	16	61.440	db-custom-16-61440
db-n1-standard-32	32	122.880	db-custom-32-122880
db-n1-standard-64	64	245.760	db-custom-64-245760
db-n1-standard-96	96	368640	db-custom-96-368640
db-n1-highmem-2	2	13.312	db-custom-2-13312
db-n1-highmem-4	4	26.624	db-custom-4-26624
db-n1-highmem-8	8	53.248	db-custom-8-53248
db-n1-highmem-16	16	106.496	db-custom-16-106496
db-n1-highmem-32	32	212.992	db-custom-32-212992
db-n1-highmem-64	64	425.984	db-custom-64-425984
db-n1-highmem-96	96	638976	db-custom-96-638976

O tipo de máquina afeta o custo da instância. Para mais informações, consulte Preço da instância. Veja também o preço de vários cenários com a calculadora de preços.

Definir política de senha

A política de senha da instância. Ela inclui as opções a seguir:

• Comprimento mínimo: especifica o número mínimo de caracteres que a senha precisa ter.
• Complexidade da senha: verifica se a senha é uma combinação de caracteres minúsculos, maiúsculos, numéricos e não alfanuméricos.
• Restringir reutilização de senha: especifica o número de senhas anteriores que não podem ser reutilizadas.
• Bloquear nome de usuário: impede o uso do nome de usuário na senha.
• Definir intervalo de alteração de senha: Especifica a duração mínima após a qual você pode alterar a senha.

Núcleos

O número de CPUs de sua instância. Também é possível criar uma instância com menos de uma CPU (uma instância de código compartilhado ou uma vCPU compartilhada).

Memória

A quantidade de memória disponível para a instância. Para cargas de trabalho sensíveis ao desempenho, como processamento de transações on-line (OLTP, na sigla em inglês), verifique se a instância tem memória suficiente para conter todo o conjunto de trabalho. Porém, há outros fatores capazes de afetar os requisitos de memória, como o número de conexões ativas. Realize testes de carga para evitar problemas de desempenho na produção.

Versão do banco de dados

A menos que você precise de um recurso oferecido somente por uma versão específica, aceite a versão padrão do banco de dados (PostgreSQL 15). Para o comando gcloud e o uso da API REST, consulte a documentação de referência.

Tipo de armazenamento

Se a opção for SSD, que é o valor padrão, a instância terá um armazenamento SSD. SSDs oferecem menor latência e maior capacidade transferência de dados. Se você não precisa de acesso de alto desempenho para os seus dados, como armazenamento de longo prazo ou dados raramente acessados, é possível reduzir seus custos escolhendo HDD.

Modo SSL

(Opcional) As opções de SSL/TLS para uma conexão de banco de dados. O Cloud SQL usa SSL/TLS para estabelecer conexões seguras, autenticadas e criptografadas com as instâncias. Use a configuração do modo SSL sslMode para aplicar todas as conexões de banco de dados a uma instância a fim de usar a criptografia SSL/TLS. Também é possível usar essa configuração para aplicar a verificação de certificados do cliente. Essa configuração oferece controles mais granulares sobre as conexões SSL em comparação com requireSsl. Recomendamos usar sslMode. Para mais informações, consulte IpConfiguration. É possível aplicar o SSL ao criar uma instância ou ao atualizá-la para qualquer instância existente.

Modo de CA do servidor

(Opcional) Ao criar uma instância, você pode selecionar o modo de CA do servidor.

• GOOGLE_MANAGED_INTERNAL_CA: é o valor padrão. O Cloud SQL cria uma nova AC autoassinada do servidor para cada instância.
• GOOGLE_MANAGED_CAS_CA: a instância usa uma hierarquia de CA do servidor hospedada pelo Certificate Authority Service, e as CAs emissoras são compartilhadas em todas as instâncias na mesma região.

Para mais informações sobre essas opções, consulte Hierarquias de autoridades certificadoras (ACs). O modo de CA do servidor está em pré-lançamento.

Capacidade de armazenamento

Escolha uma capacidade adequada para o tamanho do seu banco de dados. Depois de criar a instância, é possível aumentar manualmente a capacidade de armazenamento editando a configuração da instância, mas não é possível diminuí-la. Aumentar a capacidade de armazenamento não causa inatividade.

A quantidade de capacidade de armazenamento alocada para sua instância afeta o custo dela. Para mais informações, consulte Preço de armazenamento e rede.

Para réplicas de leitura, a capacidade de armazenamento precisa sempre ser, pelo menos, tão alta quanto a da instância principal. Quando uma instância principal é redimensionada, todas as réplicas de leitura são redimensionadas, se necessário, para que tenham pelo menos a mesma capacidade de armazenamento que a instância principal atualizada.

Ativar aumento automático de armazenamento

Se você ativar essa configuração, o Cloud SQL verificará o armazenamento disponível a cada 30 segundos. Se o armazenamento disponível estiver abaixo do limite, o Cloud SQL adicionará automaticamente mais capacidade de armazenamento. Se o armazenamento disponível ficar repetidamente abaixo do tamanho limite, o Cloud SQL continuará adicionando armazenamento até atingir o limite máximo de 64 TB.

A configuração automática do aumento do armazenamento de uma instância principal se aplica automaticamente a qualquer réplica de leitura dessa instância. A configuração automática do aumento do armazenamento não pode ser definida de maneira independente para réplicas de leitura.

Limite

O limite mínimo depende da quantidade de armazenamento atualmente provisionada para sua instância. Ele não pode ser maior que 25 GB.

No caso de instâncias provisionadas com 500 GB de armazenamento ou mais, o limite mínimo é sempre de 25 GB.

Para instâncias provisionadas com menos de 500 GB de armazenamento, esta fórmula é usada para calcular o limite:

  5 + (provisioned storage)/25

O resultado da divisão é arredondado para baixo para o número inteiro mais próximo.

Cálculo de limite mínimo para uma instância com capacidade de armazenamento de 66 GB:

5 + (1/25th of 66 GB) = 5 + (66/25) = 5 + 2.6 -> 5 + 2 = 7 GB

Cálculo de limite mínimo para uma instância com capacidade de armazenamento de 1.000 GB:

5 + (1/25th of 1000 GB) = 5 + (1000/25) = 5 + 40 = 45 -> rounded down to the
maximum value of 25 GB

Quantidade de armazenamento adicionado

A quantidade de armazenamento adicionado à instância é igual ao limite mínimo, que não pode ser maior que 25 GB.

Considerações sobre discos grandes

Para instâncias provisionadas com armazenamento de 500 GB ou mais, o tamanho limite é sempre de 25 GB e a quantidade de armazenamento adicionada sempre é de 25 GB. Como resultado, o espaço vazio máximo possível é de 50 GB. Se você não redimensionar manualmente a instância com disco maior que 5 TB, o disco poderá permanecer com 99% de capacidade o tempo todo, mesmo que a instância tenha um espaço vazio.

Antes de uma operação que aumenta rapidamente o uso do espaço em disco, como uma importação grande ou uma consulta que requer uma grande tabela temporária, redimensione manualmente o disco em vez de depender de crescimento automático para acompanhar.

Método de criptografia de dados

Por padrão, a instância do Cloud SQL é criptografada com uma chave gerenciada pelo Google. Se você quiser controlar essa chave, use uma chave de criptografia gerenciada pelo cliente (CMEK) no Cloud Key Management Service (KMS). O Cloud KMS se integra ao Cloud SQL.

O uso de chaves do Cloud KMS permite controlar o nível de proteção, o local, a programação de rotação, as permissões de uso e acesso. Além disso, é possível usar várias chaves de criptografia em recursos. O uso do Cloud KMS também permite monitorar o uso de chaves, visualizar registros de auditoria e controlar ciclos de vida importantes.

Em vez de o Google ser proprietário e gerenciar as chaves que protegem seus dados, você controla e gerencia essas chaves no Cloud KMS.

Para mais informações sobre CMEKs, consulte Sobre as chaves de criptografia gerenciadas pelo cliente (CMEKs).

Limite de aumento automático de armazenamento

Se você ativar a configuração de aumento de armazenamento automático, será possível fornecer um limite específico para o tamanho do armazenamento que sua instância poderá aumentar automaticamente. Lembre-se de que quanto maior o tamanho da instância, maior a latência operacional.

Não é possível diminuir o tamanho do armazenamento. Portanto, esse limite pode impedir que o tamanho da instância aumente muito (devido a um aumento temporário no tráfego). Lembre-se de que, quando uma instância não consegue adicionar armazenamento de que precisa, ela provavelmente deixa de aceitar conexões de entrada e pode ficar off-line.

O valor padrão 0 indica que não há limite além do armazenamento máximo disponível para o nível de instância.

Para definir o limite ao criar a instância, use o parâmetro --storage-auto-increase-limit=INTEGER_VALUE_OF_GB, conforme descrito na página criar instância. Para definir o limite em uma instância existente, use o mesmo parâmetro com o comando gcloud beta sql instances patch.

A configuração automática do limite de aumento do armazenamento de uma instância primária se aplica automaticamente a qualquer réplica de leitura dessa instância. Essa configuração automática não pode ser definida de forma independente para réplicas de leitura.

Backups automatizados e recuperação pontual

Essas opções determinam se são feitos backups automatizados e se o registro de gravação antecipada está ativado. Ambas as opções adicionam um pequeno custo de desempenho e usam armazenamento extra, mas são necessárias para a criação de réplicas e clones, assim como para a recuperação pontual. Quando você seleciona essa opção, também é possível selecionar um período em que os backups automatizados ocorrem.

Os backups automatizados ocorrem diariamente, durante o período escolhido. Após sete dias, o backup mais antigo é excluído.

Para informações sobre a recuperação pontual, consulte Visão geral da recuperação pontual.

Para informações sobre replicação, consulte Opções de replicação. Para informações sobre a clonagem de instâncias, consulte Como clonar instâncias.

Configurações de retenção para backups automáticos

O valor padrão para o número de backups retidos é 7, mas é possível alterá-lo para qualquer valor no intervalo de 1 a 365.

Consulte Retenção automatizada de registro de transações e backup para mais informações.

Opções de local

Você pode optar por armazenar backups em várias regiões ou em uma única região. Multirregião é o padrão e a opção recomendada porque oferece proteção contra inatividade quando uma região fica indisponível. Os backups são armazenados em regiões mais próximas da instância.

Você também tem a opção de selecionar um local personalizado para o backup. Use essa opção somente se exigido por regulamentos ou se uma política da organização exigir que seus backups estejam em várias regiões ou em regiões específicas. Consulte Locais personalizados para mais informações.

Proteção contra exclusão de instâncias

Protege uma instância contra exclusão acidental. Se essa configuração estiver ativada, será necessário desativá-la antes de excluir a instância. Consulte Impedir a exclusão de uma instância.

Ativar recuperação pontual

A recuperação pontual permite que você se recupere de um backup, a partir de um momento específico.

Para informações sobre a recuperação pontual, consulte Visão geral da recuperação pontual.

Disponibilidade: por zona

Coloca a instância e os backups em uma única zona. Quando você seleciona essa opção, não há failover em caso de interrupção. Recomendado apenas para fins de teste e desenvolvimento.

Alta disponibilidade (regional)

Quando você seleciona Alta disponibilidade (regional), se houver uma interrupção, a instância fará o failover para outra zona na região em que a instância está localizada, desde que a zona de failover não tenha uma interrupção. É recomendável selecionar Alta disponibilidade (regional) para instâncias no ambiente de produção.

Consulte a Visão geral da configuração de alta disponibilidade.

Janela de manutenção

O dia e a hora em que os eventos de manutenção da instância do Cloud SQL estão programados para acontecer. Para instâncias principais da edição Cloud SQL Enterprise Plus, o tempo de inatividade de manutenção geralmente é inferior a um segundo. Para todas as outras instâncias, o tempo de inatividade de manutenção normalmente é de 60 segundos ou menos.

As réplicas de leitura não suportam as configurações da janela de manutenção no momento.

Para mais informações sobre manutenção, consulte Sobre manutenção em instâncias do Cloud SQL.

Dia/hora da manutenção

Sua preferência sobre o dia/hora das atualizações de manutenção. Você pode receber as atualizações uma ou duas semanas após a notificação e testar as atualizações de manutenção em um ambiente de teste antes que as instâncias de produção recebam a atualização. Também é possível receber a atualização de manutenção cinco semanas ("week5") após o envio da notificação. A configuração de dia/hora da manutenção não afeta a versão de manutenção que o Cloud SQL aplica à instância.

Se você não definir a configuração de dia/hora da manutenção, o Cloud SQL escolherá o dia e a hora das atualizações para a instância (dentro da respectiva janela de manutenção, se aplicável).

Para mais informações sobre manutenção, consulte Sobre manutenção em instâncias do Cloud SQL.

IP particular

Configura a instância para o uso de IP privado. Saiba mais.

IP público

Se ativado, a instância receberá um endereço IPv4 público. O endereço é liberado quando você desativa o IP público. Caso decida reativá-lo, você receberá um endereço IPv4 diferente. Por padrão, o endereço IP público é bloqueado para todos os endereços. Use redes autorizadas para ativar o acesso.

Redes autorizadas

É possível adicionar endereços IP específicos ou intervalos de endereços para abrir a instância para esses endereços.

Para saber mais sobre a configuração de endereços IP, consulte Como configurar a conectividade IP.

Caminho particular para os serviços do Google Cloud

Ao marcar essa caixa de seleção, você permite que outros serviços do Google Cloud, como o BigQuery, acessem dados no Cloud SQL e façam consultas nesses dados por meio de uma conexão particular.

Essa caixa de seleção será ativada somente se você marcar a caixa de seleção IP particular e adicionar ou selecionar uma rede autorizada para criar uma conexão particular.

Cache de dados

O cache de dados é opcional para instâncias da edição Enterprise Plus do Cloud SQL para PostgreSQL. O cache de dados utiliza SSDs locais para estender o cache da página do SO da memória para o nível do SSD. O Cloud SQL gerencia essa configuração. Armazenar em cache todo o conjunto de trabalho oferece desempenho máximo ao usar o cache de dados. Você pode usar o console do Google Cloud, a CLI gcloud ou a API Cloud SQL Admin para ativar ou desativar essa configuração nas suas instâncias da edição Cloud SQL para PostgreSQL Enterprise Plus.

Política de ativação

Para alterar a política de ativação, inicie e interrompa a instância. Interromper a instância impede que novas instâncias sejam cobradas.

Flags do banco de dados

Você pode especificar flags do banco de dados na instância do Cloud SQL.

Para uma lista completa das flags configuráveis do banco de dados, consulte Como configurar flags do banco de dados.

Impacto da alteração das configurações da instância

Para a maioria das configurações da instância, o Cloud SQL aplica as alterações imediatamente, sem afetar a conectividade.

Se você estiver usando o Cloud SQL edição Enterprise, a mudança no número de CPUs ou no tamanho da memória faz com que a instância fique off-line por menos de 60 segundos. O tempo total para que as mudanças entrem em vigor pode levar vários minutos. Alterar a zona de uma instância, configurar o IP particular, alterar a rede e ativar a alta disponibilidade faz com que a instância fique off-line por vários minutos.

Se você estiver usando o Cloud SQL Enterprise Plus, poderá fazer algumas mudanças nas configurações de instância, como aumentar vCPUs ou ativar ou desativar o cache de dados, com tempo de inatividade quase zero. Para mais informações, consulte Disponibilidade no Cloud SQL.

O Cloud SQL gerencia de forma automática o valor da sinalização max_connections com base na quantidade de memória da instância. Para mais informações, consulte sinalizações aceitas. O PostgreSQL exige que o valor de max_connections seja sempre pelo menos tão grande quanto uma réplica principal de leitura. Portanto, se as réplicas de leitura tiverem menos memória do que a principal, alterar a quantidade de memória na principal poderá fazer com que as réplicas de leitura fiquem off-line por menos de 60 segundos. Isso acontece porque as réplicas de leitura podem precisar receber um novo valor de max_connections para permanecer consistente com a mudança na instância principal, e a atualização do valor de max_connections requer a reinicialização do PostgreSQL. Para evitar que isso aconteça, defina a sinalização max_connections no principal como um valor de sua escolha.

Planeje essas mudanças quando seu serviço puder lidar com uma interrupção como essa.

A seguir

• Saiba como editar sua instância.
• Saiba mais sobre as flags do banco de dados.
• Saiba como autorizar o acesso IP para sua instância.
• Saiba mais sobre opções de replicação.
• Consulte o preço da instância.
• Saiba mais sobre as opções para se conectar à sua instância.
• Saiba como configurar um endereço IP para a instância.
• Veja todos os serviços do Google Cloud disponíveis em locais do mundo todo.