Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Use parameter templates

Última atualização: Jun 26, 2026

Para gerenciar parâmetros de várias instâncias em massa, use 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 serviço, o 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 precisar modificar um parâmetro apenas para uma única instância, consulte Definir parâmetros da instância.

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 criar um modelo de parâmetros personalizado.

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 usa o modo semissíncrono. O sistema aplica 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 usa automaticamente um modelo de parâmetros padrão 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. Em seguida, visualize 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 usa o modo assíncrono. O sistema aplica 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 Consultar e modificar o modo de replicação de dados.

  • 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 usa o modo assíncrono. O sistema aplica 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 sistema grava o log da transação do buffer para o arquivo de log, mas não necessariamente o libera 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 podem ser perdidas.

sync_binlog

1

Após a confirmação de uma transação, o log binário é gravado e liberado para o disco imediatamente, 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 se ocorrer 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 nos 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. Proceda 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 em Add Parameter novamente.

    • 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 Definir parâmetros da instância.

  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 dentro da mesma região para usar como 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. Gerencie os 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 ele 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 Descrições do modelo de parâmetros.

      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 RDS.

ModifyParameterGroup

Modifica um modelo de parâmetros RDS.

CloneParameterGroup

Clona um modelo de parâmetros 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 RDS específico.

DeleteParameterGroup

Exclui um modelo de parâmetros RDS.

Perguntas frequentes

P: Como redefino 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 Modificar um modelo de parâmetros.

  2. Reaplique o modelo de parâmetros à instância de destino. Para obter instruções, consulte Aplicar um modelo de parâmetros.