Set the parameters of an RDS for PostgreSQL instance - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Este tópico descreve como modifique parâmetros de uma instância do ApsaraDB RDS for PostgreSQL para otimizar o desempenho ou atender aos requisitos de negócios. Também é possível visualize o histórico de modificações de parâmetros.

Observações de uso

A modificação de alguns parâmetros aciona a reinicialização da instância. A instância reinicia imediatamente após a alteração dos parâmetros e o clique em Apply Parameters. Para verificar se a alteração de um parâmetro exige reinicialização, consulte a coluna Force Restart na aba Modifiable Parameters. Caso a instância reinicie, sua aplicação será desconectada. Certifique-se de que seu negócio tolera essa interrupção antes de prosseguir.
Ao modificar um parâmetro no console, verifique os valores permitidos na coluna Valid Values da aba Modifiable Parameters.
Ao alterar os seguintes parâmetros na instância primária, as mudanças são sincronizadas com todas as instâncias somente leitura associadas:

wal_level, max_replication_slots, max_wal_senders, max_locks_per_transaction, max_worker_processes, max_prepared_transactions
Durante a modificação de um parâmetro, o sistema tenta aplicar a alteração. Se o novo valor for inválido ou causar falha na instância, a mudança será revertida e o resultado marcado como Failed. É possível acompanhar o status na coluna Status da aba Edit History.
O parâmetro log_statement não pode ser modificado diretamente. Para alterar esse parâmetro, ative ou desative o SQL Explorer and Audit.

Modifique valores de parâmetros

Faça login no console do ApsaraDB RDS e acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância desejada e clique em ID da instância.
No painel de navegação à esquerda, clique em Parameters.
Na aba Modifiable Parameters, encontre o parâmetro que deseja alterar. As modificações podem ser feitas individualmente ou em lote:
- Modificar um único parâmetro
  1. Clique em ícone ao lado do parâmetro que deseja edite.
  2. Insira o novo valor e clique em OK.
  3. Clique em Apply Parameters.
  4. Na caixa de diálogo, escolha quando o novo valor deve entrar em vigor: Take Effect Immediately, Take Effect Within the Maintenance Window (02:00-06:00) ou Take Effect at Specified Time. Depois, clique em OK.
- Modificar parâmetros em lote
  1. Clique em Export Parameters para baixe o arquivo de parâmetros para o seu computador.
  2. Abra o arquivo de parâmetros e edite os valores desejados.
  3. Clique em Import Parameters.
  4. Na caixa de diálogo Import Parameters, cole os parâmetros com seus novos valores e clique em OK.
  5. Confirme as alterações na lista de parâmetros e clique em Apply Parameters.
  6. Na caixa de diálogo, defina quando os novos valores devem entrar em vigor: Take Effect Immediately, Take Effect Within the Maintenance Window (02:00-06:00) ou Take Effect at Specified Time. Em seguida, clique em OK.
Nota
Na aba Scheduled Tasks, é possível visualize as tarefas de modificação de parâmetros agendadas para Take Effect Within the Maintenance Window (02:00-06:00) ou Take Effect at Specified Time.

Consulte histórico de modificações de parâmetros

Faça login no console do ApsaraDB RDS e acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância desejada e clique em ID da instância.
No painel de navegação à esquerda, clique em Parameters.
Clique em aba Edit History.
Selecione um intervalo de tempo e clique em OK.

Expressões de parâmetros

É possível utilizar expressões para defina parâmetros. Ao configurar um parâmetro relacionado ao tipo de instância com uma expressão, o valor se ajusta automaticamente sempre que o tipo de instância for alterado. Isso garante que o parâmetro permaneça otimizado para a nova especificação.

A tabela abaixo detalha a sintaxe das expressões compatíveis.

Categoria	Observações de uso	Exemplo
Parâmetros	Os seguintes parâmetros aceitam expressões: Parâmetros compatíveis com expressões work_mem: define a quantidade de memória usada por operações de ordenação interna e tabelas hash antes que os dados sejam gravados em arquivos temporários. maintenance_work_mem: estabelece o limite máximo de memória para operações de manutenção, como VACUUM e CREATE INDEX. autovacuum_work_mem: especifica a memória máxima que cada processo worker do autovacuum pode consumir. max_parallel_workers: determina o número máximo de workers que o sistema suporta para operações paralelas. max_parallel_workers_per_gather: limita a quantidade de workers iniciados por um único nó Gather ou Gather Merge. effective_cache_size: configura o valor estimado pelo otimizador para o tamanho total do cache de dados. autovacuum_max_workers: indica o número máximo de processos autovacuum executados simultaneamente, excluindo o launcher. max_wal_size: define o tamanho dos arquivos de write-ahead logging (WAL) que disparam um checkpoint. min_wal_size: estabelece o tamanho mínimo de arquivos WAL para reciclagem. Enquanto o uso de disco permanecer abaixo desse valor, arquivos antigos serão reciclados em checkpoints futuros em vez de excluídos. temp_file_limit: restringe o espaço em disco que um processo pode usar para arquivos temporários, incluindo ordenações, hashes ou armazenamento de cursores mantidos. wal_buffers: ajusta o tamanho dos buffers de páginas de disco na memória compartilhada para WAL, correspondendo à memória usada para dados WAL ainda não persistidos. max_parallel_maintenance_workers: controla o número máximo de workers paralelos para operações CREATE INDEX. max_worker_processes: define o teto de processos worker concorrentes. Nota O parâmetro max_parallel_maintenance_workers é compatível apenas com o RDS PostgreSQL 11.0 ou superior.	effective_cache_size
Variáveis	AllocatedStorage: capacidade de armazenamento do tipo de instância em MB. O valor desta variável é um número inteiro. DBInstanceClassMemory: tamanho da memória do tipo de instância em bytes. O valor desta variável é um número inteiro. DBInstanceClassCPU: número de núcleos de CPU do tipo de instância. O valor desta variável é um número inteiro. DBInstanceClassConnections: número máximo de conexões do tipo de instância. O valor desta variável é um número inteiro. Nota Para mais detalhes sobre os tipos de instância e suas respectivas capacidades de armazenamento, memória, núcleos de CPU e conexões máximas, consulte Tipos de instância primária do RDS for PostgreSQL.	effective_cache_size={DBInstanceClassMemory/16384}
Operadores	Sintaxe de expressão: Uma expressão deve estar entre chaves (`{}`). Operador de divisão (/): divide o dividendo pelo divisor e retorna um quociente inteiro. Se o resultado for decimal, o sistema trunca a parte fracionária sem arredondar. Dividendo e divisor podem ser decimais. Operador de multiplicação (*): multiplica dois fatores e retorna um produto inteiro. Caso o resultado seja decimal, a parte fracionária é truncada. Ambos os fatores podem ser decimais.	effective_cache_size={DBInstanceClassMemory/16384}
Funções	A função GREATEST() retorna o maior valor em uma lista de inteiros ou fórmulas de parâmetros. A função LEAST() retorna o menor valor em uma lista de inteiros ou fórmulas de parâmetros. A função SUM() soma os valores de inteiros ou fórmulas de parâmetros especificados.	max_parallel_workers={GREATEST(DBInstanceClassCPU*3/4, 8)}

Referências

Para obter mais informações sobre parâmetros do PostgreSQL, consulte Server Configuration na documentação oficial do PostgreSQL.

Para modifique parâmetros via chamadas de API, utilize as operações abaixo:

API	Descrição
ModifyParameter	Modifica os parâmetros de uma instância RDS.
DescribeParameterTemplates	Consulta o modelo de parâmetros de um banco de dados.
DescribeParameters	Recupera as configurações atuais de parâmetros de uma instância.

FAQ

Como alterar o número máximo de conexões de uma instância RDS for PostgreSQL?

O limite de conexões de uma instância RDS for PostgreSQL é definido pelo tipo de instância e não pode ser alterado manualmente. Para aumentar esse limite, faça upgrade para um tipo de instância maior. Vale ressaltar que o número máximo de conexões pode variar entre instâncias primárias e somente leitura. Para mais detalhes, consulte Tipos de instância primária e Tipos de instância somente leitura.

Por que ocorre um erro ao modificar o parâmetro max_slot_wal_keep_size?

Esse problema geralmente afeta instâncias do RDS for PostgreSQL que utilizam o mecanismo DuckDB. Veja as causas e recomendações a seguir:

O parâmetro max_slot_wal_keep_size é uma limitação do mecanismo DuckDB e não permite modificações.
Caso precise ajustar esse parâmetro para controlar o crescimento dos logs WAL, recomendamos adquirir uma nova instância RDS for PostgreSQL que não utilize o mecanismo DuckDB. Assim, você poderá configurar o parâmetro normalmente na nova instância.