ApsaraDB RDS:Ajustar parâmetros da instância

back_log

Controla o tamanho da fila de conexões quando a instância processa um grande volume de conexões de curta duração. Quando a fila está cheia, a instância rejeita novas solicitações de conexão.

Sintoma: Um valor muito baixo provoca o seguinte erro na aplicação:

SQLSTATE[HY000] [2002] Connection timed out

Valor recomendado: 3000

net_write_timeout

Define quanto tempo a instância aguarda antes de enviar um bloco de dados para um cliente.

Sintoma: Um valor insuficiente gera o seguinte erro no cliente:

"the last packet successfully received from the server was milliseconds ago"
"the last packet sent successfully to the server was milliseconds ago"

Valor recomendado: 60 (segundos, valor padrão). Se a rede for instável ou se o cliente demorar muito para processar cada bloco, aumente esse valor para evitar desconexões inesperadas.

innodb_lock_wait_timeout

Especifica o tempo máximo (em segundos) que uma transação InnoDB aguarda por um bloqueio de linha antes de ser abortada.

Valor recomendado: 50

innodb_thread_concurrency

Estabelece o número máximo de threads simultâneas dentro do InnoDB. O valor 0 remove o limite.

Valor recomendado: 0 (ilimitado), exceto durante a solução de problemas de desempenho relacionados a alta concorrência.

loose_rds_threads_running_high_watermark

Limita o número total de consultas concorrentes. Por exemplo, definir este parâmetro como 100 permite até 100 consultas MySQL simultâneas; consultas adicionais serão rejeitadas.

Utilize este parâmetro para proteger a instância contra picos de tráfego e sobrecarga em horários de maior demanda.

thread_pool_enabled

Ativa ou desativa o recurso de pool de threads.

Valor recomendado: ON

thread_pool_size

Determina a quantidade de grupos de threads no pool de threads.

Valor recomendado: {LEAST(DBInstanceClassCPU × 2, 64)}

thread_pool_oversubscribe

Define o número máximo de threads ativas por grupo de threads.

Valor recomendado: 32

thread_stack

Configura a profundidade da pilha para cada thread de usuário. Valores muito baixos fazem com que consultas SQL profundamente recursivas falhem.

Valor recomendado: 1048576

innodb_buffer_pool_size

Define o tamanho do buffer pool do InnoDB, a principal área de memória para cache de dados de tabelas e índices. Um buffer pool dimensionado corretamente mantém seu conjunto de trabalho (os dados e índices acessados com mais frequência pelas consultas) na memória, reduzindo drasticamente a E/S de disco.

Valor recomendado: {DBInstanceClassMemory × 3/4}

innodb_buffer_pool_instances

Divide o buffer pool em várias instâncias gerenciadas independentemente para suportar leituras e gravações concorrentes. Aplica-se apenas quando innodb_buffer_pool_size excede 1 GB.

Valor recomendado: {LEAST(DBInstanceClassMemory/1073741824, 8)}

innodb_max_dirty_pages_pct_lwm

Estabelece o limiar percentual de páginas sujas que aciona a pré-liberação (pre-flushing). O valor deve ser menor que innodb_max_dirty_pages_pct. Definir como 0 desativa a pré-liberação.

Valor recomendado: 10

innodb_lru_scan_depth

Define a profundidade de varredura das threads de limpeza de páginas na lista Least Recently Used (LRU) de cada instância do buffer pool durante a liberação de páginas sujas.

Valor recomendado: {LEAST(DBInstanceClassMemory/1048576/8, 8192)}

innodb_page_cleaners

Especifica o número de threads de limpeza de páginas usadas para liberar páginas sujas das instâncias do buffer pool. Se esse valor exceder o número de instâncias do buffer pool, o sistema o limita automaticamente ao valor de innodb_buffer_pool_instances. O padrão é 4.

Valor recomendado: 8

tmp_table_size

Define o tamanho máximo de uma tabela temporária interna em memória por thread. O limite efetivo corresponde ao menor valor entre tmp_table_size e max_heap_table_size. Quando uma tabela temporária ultrapassa esse limite, o MySQL a converte em uma tabela em disco (InnoDB no MySQL 8.0; MyISAM nas versões anteriores).

Sintoma: Consultas complexas com GROUP BY ou DISTINCT que não podem ser atendidas por um índice tornam-se mais lentas quando as tabelas temporárias transbordam para o disco.

Valor padrão: 2097152. Aumente esse valor em instâncias com memória abundante se as consultas contiverem muitas cláusulas GROUP BY ou DISTINCT.

innodb_io_capacity

Define o número máximo de operações de E/S por segundo que as tarefas em segundo plano do InnoDB podem consumir.

Valor recomendado: 20000

innodb_io_capacity_max

Especifica o IOPS máximo que o InnoDB pode utilizar quando a liberação de dados fica atrasada em relação à taxa configurada.

Valor recomendado: 40000

innodb_flush_neighbors

Controla se o InnoDB libera páginas sujas vizinhas ao liberar uma página suja específica. Valores válidos:

• 0: Libera apenas a página suja alvo.

• 1: Libera a página alvo e suas vizinhas na mesma extensão.

• 2: Libera todas as páginas sujas na mesma extensão.

Valor recomendado: 0

innodb_change_buffering

Adia operações de escrita em índices secundários para converter E/S aleatória em E/S sequencial. Isso ajuda em discos HDD, mas oferece benefícios limitados em hardware de armazenamento moderno.

Valor recomendado: none

innodb_log_file_size

Define o tamanho de cada arquivo de log no grupo de redo logs. O tamanho total do redo log é calculado por innodb_log_file_size × innodb_log_files_in_group e não pode exceder 512 GB. O padrão é 48 MB.

Um arquivo de log maior reduz a frequência de checkpoints e a E/S de disco, mas aumenta o tempo de recuperação após falhas. Configure este valor com tamanho suficiente para que a instância consiga lidar com o tráfego de escrita por mais de uma hora, suavizando a diferença entre a E/S de pico e a de fora de pico.

Valor recomendado: Configure com base nas especificações da sua instância.

open_files_limit

Define o número de handles de arquivos que a instância pode abrir simultaneamente. Também afeta o parâmetro innodb_open_files.

Valores recomendados:

• MySQL 5.6: 65535

• MySQL 5.7 e 8.0: 655350

Para instâncias com 32 ou mais núcleos de CPU e um grande número de sessões ou tabelas ativas, defina este valor ligeiramente acima do número real de arquivos da instância.

innodb_open_files

Estabelece o número máximo de handles de arquivos que o InnoDB pode manter abertos ao mesmo tempo.

Sintoma: Um valor muito baixo gera o seguinte aviso, que degrada o desempenho:

[Warning] [MY-012152] [InnoDB] Open files * exceeds the limit *

Valor recomendado: 20000

table_open_cache

Define o número máximo de tabelas que o servidor mantém abertas em todas as instâncias de cache de tabelas. Um valor muito baixo prejudica o desempenho das consultas sob alta concorrência; um valor muito alto aumenta o consumo de memória. Monitore o uso de memória ao aumentar este valor.

Valor recomendado: {LEAST(DBInstanceClassMemory/1073741824 × 1024, 16384)}

table_open_cache_instances

Particiona o cache de tabelas em instâncias separadas, cada uma com tamanho de table_open_cache / table_open_cache_instances. Isso reduz a contenção no cache de tabelas entre as sessões.

Valor recomendado: 16

innodb_autoinc_lock_mode

Controla como o InnoDB gerencia bloqueios de autoincremento para chaves primárias desse tipo. Valores válidos:

• 0 (tradicional): Mantém o bloqueio AUTO-INC durante toda a execução da instrução. Limita significativamente a concorrência de INSERT.

• 1 (consecutivo, padrão): Mantém o bloqueio AUTO-INC brevemente. Libera-o imediatamente para inserções de linhas fixas; mantém-no durante toda a instrução para inserções de linhas variáveis.

• 2 (intercalado): Libera o bloqueio AUTO-INC assim que o valor é atribuído, independentemente de o número de linhas ser fixo ou não.

Valor recomendado: 2. Isso elimina deadlocks de AUTO-INC e melhora o desempenho de INSERT … SELECT.

innodb_adaptive_hash_index

Ativa ou desativa o índice hash adaptativo, que ajuda o InnoDB a localizar rapidamente páginas do buffer pool com base nos padrões de consulta.

Sintoma: Quando ativado (ON), certas instruções — especialmente DDL — podem acionar a manutenção do índice hash adaptativo, bloqueando outras consultas ou degradando o desempenho.

Valor recomendado: OFF. Para informações de contexto, consulte Melhores práticas sobre índices hash adaptativos do ApsaraDB RDS for MySQL.

rpl_semi_sync_master_timeout

Define quanto tempo a instância RDS primária aguarda o reconhecimento de recebimento dos logs binários pela instância RDS secundária antes de confirmar uma transação. Se o tempo limite for excedido, a replicação é rebaixada de semissíncrona para assíncrona. Assim que a instância secundária se atualizar, a replicação retornará automaticamente ao modo semissíncrono.

Valor recomendado: 1000 (milissegundos, equivalente a 1 segundo). Para cargas de trabalho que exigem alta confiabilidade de dados, aumente esse valor para evitar a degradação para replicação assíncrona. Observe que um valor alto pode fazer com que requisições de escrita fiquem paralisadas durante transações longas, o que pode levar o componente de alta disponibilidade (HA) a detectar uma falha na instância e iniciar um failover.

slave_parallel_workers

Define o número de threads de reprodução paralela na instância RDS secundária. Poucas threads limitam o throughput da reprodução paralela e aumentam a latência de replicação.

Valor recomendado: {GREATEST(DBInstanceClassCPU, 8)}

binlog_transaction_dependency_tracking

Especifica como o MySQL rastreia dependências de transações para replicação paralela. Definir este parâmetro como WRITESET ativa a detecção de conflitos no nível de linha, permitindo uma reprodução paralela mais rápida na instância RDS secundária.

Valor recomendado: WRITESET. Defina transaction_write_set_extraction antes de alterar este parâmetro. Para detalhes, consulte Modificar parâmetros relacionados ao WRITESET.

binlog_transaction_dependency_history_size

Define o número máximo de entradas de transações com hash mantidas na memória para rastreamento de dependências. Quando o limite é atingido, todas as entradas são limpas.

Sintoma: Um valor muito baixo reduz a concorrência da reprodução paralela na instância RDS secundária, aumentando a latência de replicação.

Valor recomendado: 500000. Para detalhes, consulte Modificar parâmetros relacionados ao WRITESET.

transaction_write_set_extraction

Define o algoritmo de hash utilizado pelo WRITESET.

Valor recomendado: XXHASH64. Para detalhes, consulte Modificar parâmetros relacionados ao WRITESET.

query_cache_size

Controla a memória alocada para o cache de consultas do MySQL. Quando ativado, o MySQL verifica o cache antes de executar uma consulta. Em cargas de trabalho com muitas leituras e poucas escritas, isso pode melhorar o desempenho. Em cargas com muitas escritas, o mecanismo de bloqueio do cache de consultas causa conflitos frequentes que degradam o desempenho de SELECT.

Sintoma: Muitas conexões presas nestes estados:

checking query cache for query
waiting for query cache lock
storing result in query cache

Valor recomendado: Mantenha desativado (padrão do ApsaraDB RDS). Se você ativou o cache de consultas anteriormente e observar os sintomas acima, desative-o.

eq_range_index_dive_limit

Controla quando o otimizador muda de index dives para estimativa baseada em estatísticas em condições de intervalo de igualdade. Para uma consulta como:

col_name IN (val1, ..., valN)
col_name = val1 OR ... OR col_name = valN

Se N for menor que este limite, o otimizador amostra dados usando index dives. Se N for maior ou igual a este limite, o otimizador usa estatísticas da tabela.

Para mais informações, consulte a documentação do MySQL sobre eq_range_index_dive_limit.

Valores recomendados:

• MySQL 5.6: 10

• MySQL 5.7 e 8.0: 100

loose_rds_max_tmp_disk_space

Limita o tamanho total dos arquivos temporários na instância.

Sintoma: Exceder esse limite causa o seguinte erro:

The table '/home/mysql/dataxxx/tmp/#sql_2db3_1' is full

Primeiro, verifique se é possível otimizar as instruções SQL que geram arquivos temporários. Se a instância tiver espaço em disco suficiente e as consultas não puderem ser evitadas, aumente este valor.

loose_innodb_rds_faster_ddl

Acelera certas operações DDL (como alterações de esquema) usando um mecanismo de gerenciamento de buffer pool desenvolvido pela equipe do ApsaraDB RDS, reduzindo o impacto do DDL nas cargas de trabalho em execução.

Valor recomendado: Ativado.

innodb_ft_cache_size

Define a memória (em bytes) alocada para dados de índice de texto completo por tabela.

Valor recomendado: 8000000

innodb_ft_total_cache_size

Define a memória total (em bytes) alocada para dados de índice de texto completo em todas as tabelas da instância.

Valor recomendado: 640000000

innodb_ft_result_cache_limit

Define o limite de memória (em bytes) para o conjunto de resultados de cada consulta de índice de texto completo.

Valor recomendado: 2000000000

innodb_purge_threads

Define o número de threads em segundo plano que o InnoDB usa para limpar registros de undo. Mais threads melhoram o throughput de limpeza, evitando o acúmulo de arquivos de undo e melhorando o desempenho de DML e consultas em algumas cargas de trabalho.

Valor recomendado: LEAST(DBInstanceClassMemory/1073741824, 8)

innodb_sync_array_size

Define o tamanho do array de espera de mutex/bloqueio. Um valor maior melhora a concorrência para cargas de trabalho que geram muitas threads em espera. Este parâmetro é lido na inicialização e não pode ser alterado em tempo de execução. Se o número de threads em espera exceder frequentemente 768, aumente este valor.

Valor recomendado: 128

innodb_parallel_read_threads

Define o número de threads concorrentes para varreduras de chave primária. Este parâmetro possui bugs conhecidos.

Valor recomendado: 0 (desativado)

performance_schema

Ativa ou desativa o Performance Schema, que instrumenta a execução interna do MySQL. Ativá-lo adiciona sobrecarga de memória e pode afetar o desempenho.

Valor recomendado: OFF

general_log

Ativa ou desativa o log geral de consultas, que registra todas as instruções recebidas pelo servidor.

Sintoma: Ativar este log pode esgotar o armazenamento da instância. Para mais informações, consulte FAQ sobre o recurso de log geral de consultas.

Valor recomendado: OFF

default_time_zone

Define o fuso horário padrão do servidor.

Sintoma: Um fuso horário não definido ou incompatível causa conversões de tempo incorretas, timestamps inconsistentes e maior uso de CPU devido a ajustes frequentes de fuso horário — especialmente em aplicações que atendem múltiplas regiões.

Valor recomendado: Defina com base nos requisitos do seu negócio. Para detalhes, consulte Melhores práticas do parâmetro time_zone no ApsaraDB RDS for MySQL.

loose_tokudb_buffer_pool_ratio

Define a porcentagem de memória do buffer que as tabelas TokuDB podem usar, em relação a innodb_buffer_pool_size. Por exemplo, se innodb_buffer_pool_size for 1000 MB e este parâmetro estiver definido como 50, as tabelas TokuDB poderão usar até 500 MB.

Aumente este valor se as tabelas TokuDB representarem a carga de trabalho principal na instância.

loose_max_statement_time

Define o tempo máximo de execução para consultas, em milissegundos. Consultas que excedem esse limite são interrompidas. Por padrão, a duração da consulta é ilimitada.

Sintoma: Exceder o limite causa o seguinte erro:

ERROR 3006 (HY000): Query execution was interrupted, max_statement_time exceeded

Configure este parâmetro quando precisar impor limites de tempo de consulta na instância.