Sobre configurações de instância,Sobre configurações de instância,Sobre configurações de instância,Sobre configurações de instância

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esta página fornece 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 (default)  POSTGRES_17
PostgreSQL 16            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 (default) POSTGRES_17
PostgreSQL 16           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 ID da instância é o nome da instância. Ele é usado para identificar exclusivamente sua instância dentro do projeto. Escolha um nome de instância que esteja alinhado com a finalidade da instância, sempre que possível.

O comprimento total de project-ID:instance-ID deve ser de 98 caracteres ou menos.

Não é necessário incluir o ID do projeto no nome da instância. Isso é feito automaticamente quando apropriado (por exemplo, nos arquivos de log). Consulte as diretrizes de nomenclatura

Região

O Google Cloud região onde sua instância está localizada. Você só pode definir a região durante a criação da instância. Para melhorar o desempenho, mantenha seus dados próximos aos serviços que precisam deles. Para obter mais informações, consulte Locais de Instâncias .

Zona

O Google Cloud Zona onde sua instância está localizada. Se você estiver se conectando a partir de uma instância do Compute Engine, selecione a zona onde a instância do Compute Engine está localizada. Caso contrário, aceite a zona padrão. Você pode editar a instância posteriormente para alterar a zona, se necessário. Para obter mais informações, consulte Locais das Instâncias .

Tipo de máquina

Determina a memória e os núcleos virtuais disponíveis para sua instância do Cloud SQL. Os tipos de máquina fazem parte de uma série de máquinas, e a disponibilidade da série de máquinas é determinada pela sua edição do Cloud SQL.

Para instâncias da edição Cloud SQL Enterprise Plus, o Cloud SQL oferece tipos de máquina predefinidos para suas instâncias nas séries de máquinas N2 e C4A .

Para instâncias da edição Enterprise do Cloud SQL, o Cloud SQL oferece tipos de máquina predefinidos e personalizados.

Se você precisar de processamento em tempo real, como processamento de transações online (OLTP), certifique-se de que sua instância tenha memória suficiente para conter todo o conjunto de trabalho. No entanto, existem outros fatores que podem afetar os requisitos de memória, como o número de conexões ativas e processos internos de sobrecarga. Execute testes de carga para evitar problemas de desempenho em seu ambiente de produção.

Ao configurar sua instância, selecione memória e vCPUs suficientes para atender às suas necessidades e aumente a escala da instância conforme suas necessidades aumentarem. Uma configuração de máquina com vCPUs insuficientes pode perder a cobertura do SLA. Para obter mais informações, consulte Diretrizes operacionais .

Para saber mais sobre os tipos de máquina e séries de máquinas disponíveis para sua instância do Cloud SQL, consulte Visão geral da série de máquinas .

O tipo de máquina afeta o custo da sua instância. Para mais informações, consulte "Preços da Instância" . Você também pode ver os preços para vários cenários com a Calculadora de Preços .

Definir política de senha

A política de senha para a instância. Inclui as seguintes opções:

• Comprimento mínimo : especifica o número mínimo de caracteres que a senha deve 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 você não pode reutilizar.
• Não permitir 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 da sua instância. Você também pode optar por criar uma instância com menos de uma CPU (uma instância de código compartilhado ou vCPU compartilhada).

Memória

A quantidade de memória disponível para sua instância. Para cargas de trabalho sensíveis ao desempenho, como processamento de transações online (OLTP), certifique-se de que sua instância tenha memória suficiente para conter todo o conjunto de trabalho. No entanto, existem outros fatores que podem afetar os requisitos de memória, como o número de conexões ativas. Realize testes de carga para evitar problemas de desempenho em produção.

Versão do banco de dados

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

Tipo de armazenamento

O tipo de armazenamento é determinado pelo tipo de máquina selecionado para sua instância. Cada tipo de máquina pertence a uma série específica, e cada série oferece diferentes opções de tipo de armazenamento.

Tipo de armazenamento por série de máquinas:

• Série de máquinas C4A : Hyperdisk Balanced
• Série de máquinas N2 : SSD ou HDD

Para a série de máquinas N2, escolher SSD , o valor padrão, fornece armazenamento SSD à sua instância. SSDs oferecem menor latência e maior taxa de transferência de dados. Se você não precisa de acesso de alto desempenho aos seus dados, por exemplo, para armazenamento de longo prazo ou dados raramente acessados, pode reduzir seus custos escolhendo HDD .

Para a série de máquinas C4A, escolher o Hyperdisk Balanced , o único valor padrão, oferece um serviço de armazenamento escalável e de alto desempenho. Para saber mais sobre o Hyperdisk Balanced e suas limitações, consulte Visão geral das opções de armazenamento .

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 instâncias. Você pode usar a configuração do modo SSL sslMode para impor que todas as conexões de banco de dados com uma instância usem criptografia SSL/TLS. Você também pode usar essa configuração para impor a verificação de certificados de cliente. Essa configuração oferece controles mais granulares sobre suas conexões SSL em comparação com requireSsl . Recomendamos o uso de sslMode . Para obter mais informações, consulte IpConfiguration . Você pode impor SSL ao criar uma instância ou atualizá-la para qualquer instância existente.

Modo CA do servidor

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

• GOOGLE_MANAGED_INTERNAL_CA : este é o valor padrão. O Cloud SQL cria uma nova CA de servidor autoassinada para cada instância.
• GOOGLE_MANAGED_CAS_CA : a instância usa uma hierarquia de CA de servidor hospedada pelo Serviço de Autoridade de Certificação e as CAs emissoras são compartilhadas entre todas as instâncias na mesma região.

Para obter mais informações sobre essas opções, consulte Hierarquias de autoridade de certificação (CA) . O modo CA do servidor está em Visualização .

Capacidade de armazenamento

Escolha uma capacidade adequada ao tamanho do seu banco de dados. Após criar sua instância, você pode aumentar manualmente a capacidade de armazenamento editando a configuração da instância , mas não pode diminuí-la. Aumentar a capacidade de armazenamento não causa tempo de inatividade.

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

Para réplicas de leitura, a capacidade de armazenamento deve ser sempre pelo menos tão alta quanto a capacidade de armazenamento da instância primária. Quando uma instância primária é 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 primária atualizada.

Habilitar aumentos automáticos de armazenamento

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

A configuração de aumento automático de armazenamento de uma instância primária aplica-se automaticamente a todas as réplicas de leitura dessa instância. A configuração de aumento automático de armazenamento não pode ser definida independentemente para réplicas de leitura.

Limite

O tamanho limite depende da quantidade de armazenamento atualmente provisionada para sua instância; ele não pode ser maior que 25 GB.

Para instâncias provisionadas com 500 GB de armazenamento (ou mais), o limite é sempre 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 o número inteiro mais próximo.

Cálculo de limite 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 para uma instância com capacidade de armazenamento de 1000 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 adicionada

A quantidade de armazenamento adicionada à instância é igual ao tamanho limite, que não pode ser maior que 25 GB.

Considerações para discos grandes

Para instâncias provisionadas com armazenamento de 500 GB ou mais, o tamanho limite é sempre 25 GB e a quantidade de armazenamento adicionada é sempre 25 GB. Como resultado, o espaço vazio máximo possível é 50 GB. Se você não redimensionar manualmente a instância com disco maior que 5 TB, o disco poderá permanecer com 99% da capacidade o tempo todo, mesmo que a instância tenha 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 tabela temporária grande, redimensione o disco manualmente, em vez de depender do aumento automático do armazenamento para acompanhar.

O sistema de arquivos usa algum espaço internamente para metadados do sistema de arquivos. Esse espaço não está incluído na métrica de uso do disco ( database/disk/bytes_used ). Para discos grandes, o espaço reservado pode ocupar de 1% a 3% do tamanho total do disco, portanto, você pode ver o aumento automático de armazenamento ocorrer antes que o uso do disco atinja o limite.

Método de criptografia de dados

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

O uso de chaves do Cloud KMS permite que você controle o nível de proteção, a localização, o cronograma de rotação, o uso e as permissões de acesso. Além disso, você pode usar diversas chaves de criptografia em todos os recursos. O uso do Cloud KMS também permite rastrear o uso das chaves, visualizar logs de auditoria e controlar o ciclo de vida das chaves.

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

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

Limite de aumento automático de armazenamento

Se você habilitar a configuração de aumento automático de armazenamento , poderá definir um limite específico para o crescimento automático do armazenamento da sua instância. Lembre-se de que quanto maior o tamanho da instância, maior a latência operacional.

Não é possível reduzir o tamanho do armazenamento, portanto, esse limite pode evitar que o tamanho da sua instância fique muito grande (devido a um aumento temporário no tráfego). Lembre-se de que, quando uma instância não consegue adicionar o armazenamento necessário, ela provavelmente para de aceitar conexões de entrada e pode ficar offline.

Definir esse limite como zero, o valor padrão, significa que não há limite (além do armazenamento máximo disponível para a camada da 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 de criação da 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 de limite de aumento automático de armazenamento de uma instância primária aplica-se automaticamente a todas as réplicas de leitura dessa instância. A configuração de limite de aumento automático de armazenamento não pode ser definida independentemente para réplicas de leitura.

Backups automatizados e recuperação pontual

Essas opções determinam se backups automatizados serão realizados e se o registro de gravação antecipada será habilitado. Ambas as opções adicionam um pequeno custo de desempenho e usam armazenamento adicional, mas são necessárias para a criação de réplicas e clones, bem como para recuperação pontual. Ao selecionar esta opção, você também pode selecionar um período para a realização de backups automatizados.

Os backups automatizados acontecem diariamente, durante o período que você escolher. Ao final de sete dias, o backup mais antigo é excluído.

Para obter informações sobre recuperação de ponto no tempo, consulte Visão geral da recuperação de ponto no tempo .

Para obter informações sobre replicação, consulte Opções de Replicação . Para obter informações sobre clonagem de instâncias, consulte Clonagem de Instâncias .

Configurações de retenção para backups automatizados

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

Consulte Backup automatizado e retenção de log de transações para obter mais informações.

Opções de localização

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, pois oferece proteção contra tempo de inatividade quando uma região fica indisponível. Os backups são armazenados nas regiões mais próximas da instância.

Você também tem a opção de selecionar um local personalizado para o seu backup. Use esta opção somente se exigido por regulamentação ou se uma política da organização exigir que seus backups sejam feitos em regiões específicas, múltiplas ou únicas. Consulte Locais personalizados para obter mais informações.

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

Protege uma instância contra exclusão acidental. Se esta configuração estiver habilitada, você deverá desativá-la antes de excluir a instância. Consulte Impedir a exclusão de uma instância .

Manter backups após a exclusão da instância

Mantém backups sob demanda e automatizados para uma instância após a exclusão. Para obter mais informações sobre essa configuração, consulte Backups retidos .

Habilitar recuperação pontual

A recuperação em um ponto específico no tempo permite que você recupere a partir de um backup, começando em um ponto específico no tempo.

Para obter informações sobre recuperação de ponto no tempo, consulte Visão geral da recuperação de ponto no tempo .

Disponibilidade: Zonal

Coloca sua instância e backups em uma única zona. Ao selecionar esta opção, não há failover em caso de interrupção. Recomendado apenas para fins de teste e desenvolvimento.

Alta disponibilidade (regional)

Ao selecionar Alta disponibilidade (regional) , em caso de interrupção, sua instância realizará failover para outra zona na região onde está localizada, desde que a zona de failover não esteja com interrupção. É recomendável selecionar Alta disponibilidade (regional) para instâncias em seu ambiente de produção.

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

Janela de manutenção

O dia e a hora em que seus eventos de manutenção para a instância do Cloud SQL estão agendados. Para instâncias primárias da edição Enterprise Plus do Cloud SQL, o tempo de inatividade para manutenção normalmente é inferior a 1 segundo. Para todas as outras instâncias, o tempo de inatividade para manutenção normalmente é de 60 segundos ou menos, em média.

As réplicas de leitura não oferecem suporte às configurações de janela de manutenção no momento.

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

Cronograma de manutenção

Sua preferência quanto ao tempo relativo das atualizações de manutenção. Você pode receber suas atualizações uma ou duas semanas após a notificação e testá-las em um ambiente de teste antes que suas instâncias de produção recebam a atualização. Você também pode optar por receber a atualização de manutenção cinco semanas (" week5 ") após o envio da notificação. A configuração do tempo de manutenção não afeta a versão de manutenção que o Cloud SQL aplica à sua instância.

Se você não definir a configuração de tempo de manutenção, o Cloud SQL escolherá o tempo das atualizações na sua instância (dentro da janela de manutenção, se aplicável).

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

IP privado

Configura sua instância para usar IP privado. Saiba mais .

IP público

Se habilitado, sua instância receberá um endereço IPv4 público. Ao desativar o IP Público, esse endereço será liberado; você poderá reabilitá-lo posteriormente, mas 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 habilitar o acesso.

Redes autorizadas

Você pode adicionar endereços IP específicos ou intervalos de endereços para abrir sua instância para esses endereços.

Para obter informações sobre como configurar endereços IP, consulte Configurando conectividade IP .

Caminho privado para Google Cloud serviços

Ao selecionar esta caixa de seleção, você permite que outros Google Cloudserviços, como o BigQuery, para acessar dados no Cloud SQL e fazer consultas nesses dados por meio de uma conexão privada.

Esta caixa de seleção será habilitada somente se você marcar a caixa de seleção IP privado e adicionar ou selecionar uma rede autorizada para criar uma conexão privada.

Cache de dados

O cache de dados é opcional para instâncias do Cloud SQL para PostgreSQL Enterprise Plus. O cache de dados utiliza SSDs locais para estender o cache de páginas do sistema operacional da memória para a camada SSD. O Cloud SQL gerencia essa configuração. Armazenar em cache todo o seu conjunto de trabalho proporciona o máximo desempenho ao usar o cache de dados. Você pode usar o Google Cloud console, gcloud CLI ou Cloud SQL Admin API para ativar ou desativar essa configuração para suas instâncias do Cloud SQL para PostgreSQL Enterprise Plus edition.

Política de ativação

Você altera a política de ativação iniciando e interrompendo a instância . Interromper a instância evita cobranças adicionais.

Sinalizadores de banco de dados

Você pode definir sinalizadores de banco de dados específicos na instância do Cloud SQL.

Para obter uma lista completa dos sinalizadores de banco de dados que você pode definir, consulte Configurar sinalizadores de banco de dados .

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

Para a maioria das configurações de instância, o Cloud SQL aplica a alteração imediatamente e a conectividade com a instância não é afetada.

Se você estiver usando a edição Enterprise do Cloud SQL, alterar o número de CPUs ou o tamanho da memória fará com que a instância fique offline por menos de 60 segundos. O tempo total para as alterações entrarem em vigor pode levar vários minutos. Alterar a zona de uma instância, configurar o IP privado, alterar sua rede e habilitar a alta disponibilidade fará com que a instância fique offline por vários minutos.

Se você estiver usando a edição Cloud SQL Enterprise Plus, poderá fazer algumas alterações nas configurações da instância, como aumentar a escala de vCPUs ou habilitar ou desabilitar o cache de dados, com tempo de inatividade quase zero. Para obter mais informações, consulte Disponibilidade no Cloud SQL .

O Cloud SQL gerencia automaticamente o valor do sinalizador max_connections com base na quantidade de memória na instância (para obter mais informações, consulte sinalizadores compatíveis ). O PostgreSQL exige que o valor de max_connections seja sempre pelo menos tão grande em uma réplica de leitura quanto em seu primário. Portanto, se as réplicas de leitura tiverem menos memória do que o primário, alterar a quantidade de memória no primário pode fazer com que suas réplicas de leitura fiquem offline por menos de 60 segundos. Isso acontece porque as réplicas de leitura podem precisar receber um novo valor de max_connections para permanecerem consistentes com a alteração no primário, e atualizar o valor de max_connections requer reiniciar o PostgreSQL. Para evitar que isso aconteça, defina o sinalizador max_connections no primário para um valor de sua escolha.

Planeje fazer esse tipo de alteração quando seu serviço puder lidar com uma interrupção dessa duração.

O que vem a seguir

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