Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Use parameter templates

Última atualização: Oct 10, 2026

Para gerenciar parâmetros de várias instâncias em massa, utilize modelos de parâmetros e aplique configurações rapidamente às suas instâncias. Os modelos de parâmetros dividem-se em modelos de parâmetros do sistema e modelos de parâmetros personalizados.

Pré-requisitos

Sua instância deve executar uma das seguintes versões do MySQL:

  • MySQL 8.4

  • MySQL 8.0 (incluindo instâncias serverless)

  • MySQL 5,7

  • MySQL 5.6

Informações básicas

Para garantir a disponibilidade do service, a Alibaba Cloud restringe a modificação de certos parâmetros críticos. Para atender a diversas necessidades de negócios, como obter maior desempenho, o ApsaraDB RDS oferece vários modelos de parâmetros do sistema. Você também pode criar modelos de parâmetros personalizados para aplicar configurações de parâmetros em massa com base em seus casos de uso específicos.

Nota

Se você precisar modificar um parâmetro apenas para uma única instância, consulte Set instance parameters.

Modelos de parâmetros do sistema

Nota

Os modelos de parâmetros do sistema estão disponíveis apenas para instâncias que executam o RDS High-availability Edition e RDS Basic Edition. Para instâncias que executam o RDS Enterprise Edition, você pode create a custom parameter template.

Os seguintes modelos de parâmetros do sistema estão disponíveis para instâncias que executam o RDS High-availability Edition e RDS Basic Edition:

  • Modelo de parâmetros padrão

    Este modelo oferece a maior segurança de dados, mas apresenta desempenho de leitura e gravação mais lento. A replicação de dados utiliza o modo semissíncrono. São utilizados os seguintes parâmetros de proteção de dados:

    • Engine InnoDB

      • innodb_flush_log_at_trx_commit = 1

      • sync_binlog = 1

    • Engine X-Engine (apenas o modelo de parâmetros padrão é fornecido para esta engine)

      sync_binlog = 1

    Nota
    • Ao criar uma instância, o sistema utiliza por padrão um modelo de parâmetros correspondente à versão e série selecionadas. Para visualizar os valores dos parâmetros do modelo padrão, faça login no console do ApsaraDB RDS, clique em Parameter Templates na barra de navegação à esquerda, clique na aba System Parameter Templates e pesquise por Default Parameter Template. Assim, você poderá visualizar os valores de todos os modelos de parâmetros padrão.

    • Não é possível modificar um modelo de parâmetros padrão.

  • Modelo de parâmetros assíncrono

    Este modelo proporciona alta segurança de dados e desempenho mais rápido. A replicação de dados utiliza o modo assíncrono. São utilizados os seguintes parâmetros de proteção de dados:

    • innodb_flush_log_at_trx_commit = 1

    • sync_binlog=1

    • rpl_semi_sync_master_enabled=off

    Nota

    Para alterar o modo de replicação de dados para assíncrono, consulte Query and modify the data replication mode.

  • Modelo de parâmetros de alto desempenho

    Este modelo oferece segurança de dados moderada e o desempenho de leitura e gravação mais rápido. A replicação de dados utiliza o modo assíncrono. São utilizados os seguintes parâmetros de proteção de dados:

    • innodb_flush_log_at_trx_commit = 2

    • sync_binlog = 1000

Nota

Não é possível usar um modelo de parâmetros personalizado para modificar os parâmetros definidos em um modelo de parâmetros do sistema.

A tabela a seguir descreve os parâmetros.

Parâmetro

Valor

Descrição

innodb_flush_log_at_trx_commit

1

Quando uma transação é confirmada, o sistema grava o log da transação do buffer para o arquivo de log e o libera imediatamente para o disco.

2

Quando uma transação é confirmada, o log da transação é gravado do buffer para o arquivo de log, mas não necessariamente liberado para o disco imediatamente. O arquivo de log é liberado para o disco uma vez por segundo. Se o sistema falhar antes da liberação, as transações do último segundo poderão ser perdidas.

sync_binlog

1

Após a confirmação de uma transação, o log binário é gravado e liberado imediatamente para o disco, ignorando o cache do sistema.

1000

O sistema libera o log binário para o disco a cada 1.000 operações de gravação. Isso cria um risco de perda de dados caso ocorra uma falha.

Aplicar um modelo de parâmetros

  1. Faça login no console do ApsaraDB RDS. Na barra de navegação à esquerda, selecione Parameter Templates e, em seguida, selecione uma região na parte superior.

  2. Na aba Custom Parameter Templates ou System Parameter Templates, localize o modelo que deseja aplicar e, na coluna Actions, clique em More > Apply to Instance.

  3. Na lista de instâncias à esquerda, selecione as instâncias de destino e clique no ícone para movê-las para a direita. Revise as alterações de parâmetros.

    Importante

    Ao aplicar um modelo de parâmetros a várias instâncias, certifique-se de que os parâmetros sejam adequados para todas as instâncias selecionadas. Prossiga com cautela.

  4. Clique em OK.

Criar um modelo de parâmetros personalizado

  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. Na barra de navegação à esquerda, clique em Parameter Templates e, na página Parameter Templates à direita, clique em Create Parameter Template.

  3. Configure os seguintes parâmetros.

    Parâmetro

    Descrição

    Template Name

    O nome deve ter entre 8 e 64 caracteres e pode conter letras, dígitos, pontos (.) e sublinhados (_). Deve começar com uma letra e não pode conter caracteres chineses.

    Database Engine

    Este tópico usa o MySQL como exemplo. Selecione MySQL.

    Engine Version

    Versões suportadas: MySQL 5.6, 5,7 e 8.0.

    Description

    Insira uma descrição para o modelo. A descrição pode ter até 200 caracteres.

    Add Parameter

    Clicar em Add Parameter adiciona uma nova linha de parâmetro, permitindo selecionar um Parameter, definir um valor e visualizar informações como intervalo de valores e valor padrão.

    Nota
    • Para visualizar os parâmetros que podem ser adicionados ou modificados, acesse a página RDS Instances, selecione uma região na parte superior e clique no ID da instância de destino. No painel de navegação à esquerda, clique em Parameters e visualize os parâmetros na aba Editable Parameters.

    • Para configurar outro parâmetro, clique novamente em Add Parameter.

    • Para excluir um parâmetro, clique em Delete à direita do parâmetro.

    Import

    Você pode modificar o modelo exportado, clicar em Import e colar os parâmetros para gerar o modelo. Para exportar um modelo, consulte Set instance parameters.

  4. Clique em Confirm.

Clonar um modelo de parâmetros personalizado

É possível clonar um modelo de parâmetros personalizado para outra região ou criar uma cópia na mesma região para servir de base para um novo modelo.

Nota

Apenas modelos de parâmetros personalizados podem ser clonados. Modelos de parâmetros do sistema não podem ser clonados.

  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. Na barra de navegação à esquerda, clique em Parameter Templates.

  3. À direita do ID do modelo de parâmetros, na coluna Actions, clique em icon > Clone.

  4. Configure os seguintes parâmetros.

    Parâmetro

    Descrição

    Region

    A região de destino para o modelo clonado.

    Template Name

    O nome deve ter entre 8 e 64 caracteres e pode conter letras, dígitos, pontos (.) e sublinhados (_). Deve começar com uma letra e não pode conter caracteres chineses.

    Description

    Insira uma descrição para o modelo. A descrição pode ter até 200 caracteres.

  5. Clique em OK.

Gerenciar modelos de parâmetros

  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. Na barra de navegação à esquerda, clique em Parameter Templates.

  3. Você pode gerenciar modelos de parâmetros das seguintes formas:

    Nota

    Os modelos do sistema suportam apenas View e Apply to Instance.

    • Visualizar um modelo de parâmetros

      Clique no ID do modelo de parâmetros ou clique em View na coluna Actions do modelo de parâmetros para visualizar suas informações básicas e detalhes dos parâmetros.

    • Modificar um modelo de parâmetros

      Importante
      • Se você modificar um modelo de parâmetros personalizado, deverá reaplicá-lo às suas instâncias para que as alterações entrem em vigor.

      • Uma instância reinicia após a aplicação do modelo apenas se o modelo contiver parâmetros que exijam reinicialização.

      1. Clique em Icon > Modify na coluna Actions ao lado do ID do modelo de parâmetros, ou clique em Edit Parameter Template na parte superior da página enquanto visualiza um modelo de parâmetros. Para descrições detalhadas dos parâmetros, consulte Parameter template descriptions.

      2. Clique em Yes.

    • Excluir um modelo de parâmetros

      Nota

      A exclusão de um modelo de parâmetros não afeta as instâncias que já o utilizam.

      Clique em icon > Delete na coluna Actions do modelo de parâmetros de destino e, na caixa de diálogo exibida, clique em OK.

Referência de API

API

Descrição

CreateParameterGroup

Cria um modelo de parâmetros do RDS.

ModifyParameterGroup

Modifica um modelo de parâmetros do RDS.

CloneParameterGroup

Clona um modelo de parâmetros do RDS para a mesma região ou para outra região.

DescribeParameterGroups

Consulta uma lista de modelos de parâmetros em uma região específica.

DescribeParameterGroup

Consulta os detalhes de um modelo de parâmetros específico do RDS.

DeleteParameterGroup

Exclui um modelo de parâmetros do RDS.

Perguntas frequentes

P: Como redefinir um parâmetro em um modelo de parâmetros personalizado para seu valor padrão?

R:

  1. No modelo de parâmetros personalizado, localize o parâmetro de destino e redefina seu valor para o padrão. Para obter instruções, consulte Modify a parameter template.

  2. Reaplique o modelo de parâmetros à instância de destino. Para obter instruções, consulte Apply a parameter template.