Todos os produtos
Search
Central de documentação

PolarDB:Uso de modelos de parâmetros

Última atualização: Jun 28, 2026

Se você gerencia vários clusters do PolarDB com configurações de parâmetros compartilhadas, utilize modelos de parâmetros para centralizar essas definições. Essa abordagem simplifica o gerenciamento de parâmetros e acelera a configuração dos clusters.

Criar um modelo de parâmetros

  1. Faça login no console do PolarDB. Selecione a região do cluster. No painel de navegação à esquerda, escolha Parameter Templates.

  2. Na aba Custom Parameter Templates, clique em Create Parameter Template. Configure os parâmetros a seguir e clique em OK.

    Parâmetro

    Descrição

    Nome do modelo

    O nome do modelo deve atender aos seguintes requisitos:

    • Deve conter apenas letras, dígitos e sublinhados (_) e começar com uma letra. Caracteres chineses não são permitidos.

    • Deve ter entre 8 e 64 caracteres.

    Mecanismo de banco de dados

    Selecione um mecanismo de banco de dados. Valores válidos: MySQL, ou .

    Versão do banco de dados

    Selecione uma versão do mecanismo de banco de dados. Valores válidos:

    • 8.0

    • 5.7

    • 5.6

    Descrição

    (Opcional) Insira uma descrição para o modelo. A descrição pode ter até 200 caracteres e estar em qualquer idioma.

    Adicionar parâmetro

    Clique em Add Parameter para adicionar uma linha de parâmetro. Selecione um Parameter Name e defina o Current Value com base nas colunas Description e Valid Value. Também é possível visualizar informações como a necessidade de reinicialização do cluster e o valor padrão do parâmetro.

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

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

    Importar parâmetro

    Clique em Import Parameter e insira os parâmetros e valores. Utilize o formato key=value e insira cada par chave-valor em uma nova linha. Por exemplo:

    wait_timeout=60
        thread_stack=262144

Aplicar um modelo de parâmetros

Após criar um modelo de parâmetros, aplique-o aos clusters de uma das duas formas a seguir:

  • Aplique o modelo pela página de detalhes do cluster: para o cluster PolarDB desejado, acesse Settings and Management > Parameters e clique em Apply Template. Para mais informações, consulte Aplicar um modelo.

  • Para aplicar o modelo diretamente ao cluster, siga as etapas abaixo.

Depois de criar um modelo de parâmetros, aplique-o a um cluster.

Nota

Se um modelo de parâmetros contiver parâmetros que exigem reinicialização do cluster para entrar em vigor, aplique o modelo fora do horário de pico e garanta que sua aplicação possua um mecanismo de reconexão.

  1. Faça login no console do PolarDB. Selecione a região do cluster. No painel de navegação à esquerda, escolha Parameter Templates.

  2. Na aba Custom Parameter Templates, localize o modelo desejado e clique em Apply to Cluster na coluna Actions.

  3. Na página Apply to Cluster, selecione os clusters de destino. Clique no ícone 移动 para adicioná-los à lista de selecionados. Revise as diferenças entre os valores dos parâmetros no modelo e nos clusters na seção Parameter comparison. Após confirmar as alterações, clique em OK.

    Nota

    Ao aplicar um modelo de parâmetros a vários clusters, observe o seguinte:

    • Confirme se os parâmetros são adequados para todos os clusters selecionados. Prossiga com cautela.

    • É possível aplicar um modelo de parâmetros a no máximo 10 clusters por vez. Para aplicar o modelo a mais de 10 clusters, realize a operação em lotes.

    • Um modelo de parâmetros só pode ser aplicado a clusters na mesma região. Se seus clusters estiverem em uma região diferente, crie primeiro o modelo nessa região antes de aplicá-lo.

Clonar um modelo de parâmetros

  1. Faça login no console do PolarDB. Selecione a região do cluster. No painel de navegação à esquerda, escolha Parameter Templates.

  2. Na aba Custom Parameter Templates, localize o modelo desejado e clique em Clone na coluna Actions. Configure os parâmetros a seguir e clique em OK.

    Parâmetro

    Descrição

    Nome do modelo

    O nome do modelo deve atender aos seguintes requisitos:

    • Deve conter apenas letras, dígitos e sublinhados (_) e começar com uma letra. Caracteres chineses não são permitidos.

    • Deve ter entre 8 e 64 caracteres.

    Mecanismo de banco de dados

    Selecione um mecanismo de banco de dados. Valores válidos: MySQL, ou .

    Versão do banco de dados

    Selecione uma versão do mecanismo de banco de dados. Valores válidos:

    • 8.0

    • 5.7

    • 5.6

    Descrição

    (Opcional) Insira uma descrição para o modelo. A descrição pode ter até 200 caracteres e estar em qualquer idioma.

    Adicionar parâmetro

    Clique em Add Parameter para adicionar uma linha de parâmetro. Selecione um Parameter Name e defina o Current Value com base nas colunas Description e Valid Value. Também é possível visualizar informações como a necessidade de reinicialização do cluster e o valor padrão do parâmetro.

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

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

    Importar parâmetro

    Clique em Import Parameter e insira os parâmetros e valores. Utilize o formato key=value e insira cada par chave-valor em uma nova linha. Por exemplo:

    wait_timeout=60
        thread_stack=262144

Excluir um modelo de parâmetros

  1. Faça login no console do PolarDB. Selecione a região do cluster. No painel de navegação à esquerda, escolha Parameter Templates.

  2. Na aba Custom Parameter Templates, localize o modelo desejado e clique em Delete na coluna Actions.

Nota

Para excluir vários modelos de parâmetros de uma vez, selecione-os e clique em Batch Delete.

Comparar modelos de parâmetros

  1. Faça login no console do PolarDB. Selecione a região do cluster. No painel de navegação à esquerda, escolha Parameter Templates.

  2. Na aba Custom Parameter Templates, selecione os modelos de parâmetros que deseja comparar e clique em Compare abaixo da lista.

  3. Na página Compare, a caixa de diálogo Compare é aberta, exibindo uma tabela de parâmetros com valores diferentes. Os valores divergentes são destacados em vermelho. Por exemplo, os valores do parâmetro wait_timeout em diferentes modelos podem ser 86400, 43200 e 172800.

Referência de API

API

Descrição

CreateParameterGroup

Cria um grupo de parâmetros.

DescribeParameterGroups

Consulta uma lista de grupos de parâmetros.

DescribeParameterGroup

Consulta os detalhes de um grupo de parâmetros.

ModifyDBClusterParameters

Modifica parâmetros do cluster ou aplica um grupo de parâmetros.

DeleteParameterGroup

Exclui um grupo de parâmetros.