Todos os produtos
Search

Este produto

    ApsaraDB RDS:Modificar parâmetros da instância

    Central de documentação

    ApsaraDB RDS:Modificar parâmetros da instância

    Última atualização: Jul 15, 2026

    Modifique as configurações de parâmetros e visualize o histórico de alterações de instâncias do RDS for MySQL pelo console ou API. Visualizar parâmetros da instância.

    Observações de uso

    • Para garantir a estabilidade da instância, modifique apenas os parâmetros disponíveis no console. O comando set global não é suportado.

    • Ao modificar parâmetros, verifique a coluna Value Range na página Editable Parameters. Use também expressões para adaptar automaticamente os parâmetros às mudanças na configuração da instância.

    • Alguns parâmetros modificados na instância primária são sincronizados automaticamente com as instâncias somente leitura. Apêndice: Parâmetros sincronizados.

    • Observações sobre o parâmetro lower_case_table_names:

      • MySQL 5.7, 8,0 e 8,4: Especifique a sensibilidade a maiúsculas e minúsculas em nomes de tabelas ao criar a instância (valor padrão: 1, não diferencia maiúsculas de minúsculas). Não é possível modificar esse parâmetro após a criação da instância, e seu valor permanece inalterado após uma atualização.

      • MySQL 5.6:

        • É possível modificar esse parâmetro após a criação da instância, mas isso reinicia a instância. Recomendamos modificar o parâmetro fora dos horários de pico.

        • Para alterar o valor de 0 para 1, converta previamente os nomes de tabelas em maiúsculas para minúsculas na instância. Caso contrário, as tabelas existentes em maiúsculas ficarão inacessíveis.

        • Instâncias somente leitura não suportam a modificação desse parâmetro. Modifique-o na instância primária; a alteração será sincronizada com as instâncias somente leitura.

    Importante

    A modificação de parâmetros pode exigir a reinicialização ou reconexão da instância. Execute essas operações fora dos horários de pico e garanta que sua aplicação possua um mecanismo de reconexão automática:

    • Alguns parâmetros exigem reinicialização da instância para entrar em vigor. Verifique a coluna Force Restart na página Editable Parameters. Uma reinicialização causa uma interrupção de conexão de aproximadamente 15 segundos. Certifique-se de que sua aplicação tenha um mecanismo de reconexão automática.

    • Parâmetros que não exigem reinicialização entram em vigor apenas em novas conexões. Reconecte as conexões existentes.

    Modificar parâmetros da instância

    Os parâmetros modificáveis variam conforme a versão do mecanismo MySQL. Lista de parâmetros modificáveis para RDS for MySQL.

    Modificar os parâmetros de uma única instância

    1. 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 RDS e clique em ID da instância.

    2. No painel de navegação à esquerda, clique em Parameters.

    3. Execute as seguintes operações:

      Modificar um único parâmetro

      1. Na aba Editable Parameters, localize o parâmetro desejado e altere seu valor de acordo com o cenário:

        • Clique em pencil na coluna Running Parameter Value e insira um valor com base no intervalo sugerido.

        • Na coluna Running Parameter Value, selecione um valor na lista suspensa.

      2. Clique em OK.

      3. Clique em Apply Changes. Na caixa de diálogo exibida, selecione um período de vigência. É possível selecionar Take Effect Immediately, Take Effect Within the Maintenance Window ou Take Effect at Specified Time.

        Nota

        Na aba Scheduled Tasks for Parameter Modification, visualize as tarefas de modificação de parâmetros para as quais você selecionou Take Effect Within the Maintenance Window ou Take Effect at Specified Time.

      4. (Opcional) Para cancelar as modificações de parâmetros antes do envio, clique em Cancel Changes.

      Aplicar e exportar modelos

      Aplicar um modelo de parâmetros

      O RDS fornece modelos de parâmetros do sistema para cenários como alto desempenho. Crie também modelos personalizados para aplicar configurações em lote. Usar um modelo de parâmetros.

      1. Clique em Apply Template.

      2. Selecione o modelo de parâmetros a ser aplicado e clique em OK.

        Nota

        • A caixa de diálogo mostra a quantidade de parâmetros e se é necessária uma reinicialização. Para visualizar as alterações detalhadas, clique em View Parameter Change.

        • Se o modelo de parâmetros não estiver listado, ele pode estar em outra região. Copie o modelo para a região da instância. Usar um modelo de parâmetros.

      Exportar um modelo de parâmetros

      1. Clique em Export as Template.

      2. Configure os seguintes parâmetros.

        Parâmetro

        Descrição

        Template Name

        Nome do modelo. De 8 a 64 caracteres; permite letras, dígitos, pontos (.) e sublinhados (_). Deve começar com uma letra. Não pode conter caracteres chineses.

        Description

        Descrição do modelo. Até 200 caracteres.

      3. Clique em OK para criar um novo modelo de parâmetros na região.

      Importar e exportar parâmetros

      Para modificar muitos parâmetros simultaneamente ou salvar as configurações atuais, exporte um arquivo TXT com todos os valores, edite-o localmente e importe-o para aplicar as alterações.

      1. Clique em Export Parameters para exportar o arquivo de parâmetros no formato TXT.

      2. Após modificar o arquivo, clique em Import Parameters e cole o conteúdo do arquivo na caixa de diálogo.

      3. Clique em OK.

      4. Clique em Apply Changes. Na caixa de diálogo exibida, selecione quando as alterações entrarão em vigor. É possível selecionar Take Effect Immediately, Take Effect Within the Maintenance Window ou Take Effect at Specified Time.

        Nota

        Na aba Scheduled Tasks for Parameter Modification, visualize as tarefas de modificação de parâmetros nas quais você selecionou Take Effect Within the Maintenance Window ou Take Effect at Specified Time.

      5. (Opcional) Para cancelar as modificações de parâmetros antes do envio, clique em Cancel Changes.

        Importante

        Se a mensagem de erro Operation failed. The specified parameter format is invalid. aparecer, verifique se o valor do parâmetro inserido está dentro dos Valid Values.

    Modificar parâmetros de várias instâncias

    1. Faça login no console do ApsaraDB RDS. No painel de navegação à esquerda, clique em Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada.

    2. Marque as caixas de seleção à esquerda de várias instâncias de destino e clique em Apply Changes na parte inferior da página.

      Nota

      As instâncias em uma alteração de parâmetros em lote devem ter a mesma versão e série. Caso contrário, o botão Modify Parameters ficará esmaecido e indisponível.

    3. Na página Parameters exibida, clique em ícone Edit na extremidade direita do nome do parâmetro a ser modificado.

    4. Na caixa value, selecione ou insira um novo valor e clique em OK.

    5. Na janela Parameters exibida, verifique se as alterações estão corretas e clique em OK.

    Visualizar histórico de modificações

    1. 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 RDS e clique em ID da instância.

    2. No painel de navegação à esquerda, clique em Parameters.

    3. Clique em aba Edit History.

    4. Selecione o intervalo de tempo e clique em OK.

    Perguntas frequentes

    As modificações de parâmetros entram em vigor imediatamente? É necessária a reinicialização da instância?

    Algumas alterações entram em vigor em cerca de 5 minutos sem necessidade de reinicialização. Outras exigem reinicialização. Verifique a página Editable Parameters e a coluna Force Restart para confirmar antes de enviar.

    Por que minhas modificações de parâmetros não foram aplicadas?

    As modificações de parâmetros são aplicadas somente após clicar em Apply Changes.

    Se uma instância somente leitura for da Edição de Alta Disponibilidade e tiver uma instância primária e uma secundária, como defino os parâmetros para ambas?

    Defina os parâmetros apenas na instância primária do par somente leitura. Os parâmetros serão então sincronizados automaticamente com a instância secundária.

    Quero modificar o parâmetro expire_logs_days ou binlog_expire_logs_seconds, mas não consigo encontrá-lo no console do RDS. O que devo fazer?

    Os parâmetros expire_logs_days e binlog_expire_logs_seconds são usados no MySQL open-source para controlar o período de retenção do log binário local. No entanto, o RDS for MySQL não usa esses parâmetros para essa finalidade. Para modificar o período de retenção do log binário de uma instância RDS for MySQL, defina a política de retenção de log binário no console do RDS.

    Nota

    Para excluir ou reduzir backups de logs e dados de uma instância RDS for MySQL, consulte Excluir ou reduzir backups.

    Como modifico o parâmetro lower_case_table_names?

    Para mais informações, consulte Observações sobre o parâmetro lower_case_table_names.

    Ao usar o comando set global para modificar um parâmetro, recebo um erro: Access denied; you need (at least one of) the SUPER or SYSTEM_VARIABLES_ADMIN privilege(s) for this operation. O que devo fazer?

    O RDS for MySQL não suporta o comando set global. Modifique apenas os parâmetros disponíveis no console.

    Como modifico os parâmetros collation_connection e collation_database?

    Não é possível modificar diretamente collation_connection ou collation_database. Em vez disso, defina o parâmetro init_connect no console do RDS. Os valores suportados incluem 'set names utf8mb4', 'set names utf8', 'set default_collation_for_utf8mb4=utf8mb4_general_ci', 'set default_collation_for_utf8mb4=utf8mb4_general_ci;set names utf8mb4', 'set names utf8mb4 collate utf8mb4_general_ci' e 'set names utf8mb4 COLLATE utf8mb4_bin'.

    O sistema executa esse comando em cada nova conexão, definindo o conjunto de caracteres e a intercalação. Garanta que sua aplicação não substitua a intercalação da sessão; caso contrário, as configurações no nível da sessão terão precedência.

    Posso modificar o parâmetro sql_log_bin?

    Não. O RDS for MySQL impõe sql_log_bin para todas as sessões a fim de garantir que os logs binários sejam persistidos, mantendo a consistência dos dados para replicação.

    Por que a modificação do parâmetro **wait_timeout** não entra em vigor?

    As modificações no parâmetro wait_timeout aplicam-se apenas a novas conexões. Desconecte e reconecte as conexões existentes para que o novo valor entre em vigor.

    Em uma instância RDS, por que o parâmetro **performance_schema está ativado, mas nenhum registro é encontrado ao consultar a tabela performance_schema.session_connect_attrs**?

    Defina o parâmetro loose_performance_schema_session_connect_attrs_size com um valor maior que 0 no console do RDS.

    Apêndice: Parâmetros sincronizados

    Os seguintes parâmetros são sincronizados automaticamente da instância primária para todas as instâncias somente leitura quando modificados.

    • lower_case_table_names

      Nota

      Para RDS for MySQL 5.7, 8,0 e 8,4, especifique a sensibilidade a maiúsculas e minúsculas em nomes de tabelas apenas ao criar a instância. Não é possível modificar o parâmetro lower_case_table_names posteriormente. Apenas o MySQL 5.6 suporta a modificação desse parâmetro na instância primária, com a alteração sincronizada para as instâncias somente leitura.image

    • innodb_large_prefix

    • loose_validate_password_length

    • default_time_zone

    • rpl_semi_sync_slave_enabled

    • character_set_server

    • collation_server

    Referência de API

    API

    Descrição

    ModifyParameter

    Modifica os parâmetros de uma instância RDS.

    DescribeParameterTemplates

    Consulta modelos de parâmetros de banco de dados.

    DescribeParameters

    Consulta a configuração de parâmetros de uma instância.