Todos os produtos
Search

Este produto

    PolarDB:Set cluster parameters and node parameters

    Central de documentação

    PolarDB:Set cluster parameters and node parameters

    Última atualização: Oct 12, 2026

    Após a criação de um cluster PolarDB, é possível modificar os parâmetros do cluster e do nó no console, além de exportar os parâmetros alterados como um modelo. Clusters na mesma região podem utilizar o recurso de aplicação de modelo para modificar rapidamente os parâmetros do cluster. Este tópico descreve como modificar parâmetros de cluster e de nó, bem como exportar os parâmetros modificados como modelo e aplicá-lo.

    Informações básicas

    O PolarDB oferece parâmetros de nó configuráveis. Você pode definir esses parâmetros conforme as necessidades do seu negócio.

    • Novos nós adicionados a um cluster utilizam os parâmetros do cluster por padrão.

    • Se o nó primário falhar e houver failover para um nó somente leitura:

      • O nó primário original torna-se um nó somente leitura, mantendo seus parâmetros inalterados.

      • Um nó somente leitura original é promovido a nó primário, também com seus parâmetros inalterados.

    • Em caso de falha na zona primária, um nó da zona secundária é promovido a primário e passa a usar os parâmetros do cluster.

    Observações de uso

    • Para garantir compatibilidade com arquivos de configuração do MySQL, todos os parâmetros de cluster no console do PolarDB usam o prefixo loose_.

      Exemplo: loose_rds_audit_log_event_buffer_size e rds_audit_log_event_buffer_size referem-se ao mesmo parâmetro.

    • Apenas alguns parâmetros ou valores de parâmetros de nó podem ser modificados. Consulte as opções suportadas no console para mais detalhes.

    • Para visualizar o histórico de modificações de parâmetros, utilize a aba Parameters na página Parameter Modification History do console ou chame a operação DescribeModifyParameterLog.

    • Caso precise alterar um parâmetro de nó não editável pelo console, acesse o Quota Center. Localize a cota chamada Set cluster parameters and node parameters, clique em Apply na coluna Actions e informe o ID do cluster e os parâmetros desejados no campo Reason for Request.

      Nota

      • Atualmente, apenas os seguintes parâmetros podem ser modificados:

        • PolarDB for MySQL 5.6 e 5.7: parâmetro de nó innodb_buffer_pool_size.

        • PolarDB for MySQL 8.0: parâmetros de nó innodb_buffer_pool_size, loose_oss_outfile_buffer_size, loose_max_oss_outfile_threads, loose_csv_oss_buff_size.

      • Se tiver dúvidas ou precisar modificar outros parâmetros, Contact Us.

    Modificar valores de parâmetros

    Alterações nos parâmetros do cluster afetam todos os nós pertencentes a ele. Já as mudanças em parâmetros de nó impactam exclusivamente o nó especificado. Esta seção apresenta um exemplo de modificação de parâmetros de cluster.

    1. Faça login no console do PolarDB.

    2. No canto superior esquerdo, selecione a região onde o cluster está implantado.

    3. Localize o cluster desejado e clique em seu ID.

    4. No painel de navegação à esquerda, escolha Settings and Management > Parameters.

    5. Para ajustar parâmetros do cluster, selecione Cluster na lista suspensa no canto superior esquerdo.

      Para alterar parâmetros de nó, escolha o nó correspondente na lista suspensa.

    6. No canto superior esquerdo da página, clique em Modify Parameter.

    7. Encontre o parâmetro e insira o novo valor.

      Nota

      • É obrigatório inserir um valor dentro do intervalo definido na coluna Range to Be Modified. Caso contrário, ocorrerá um erro ao clicar em Submit Changes.

      • Clique no ícone Parameter icon ao lado do nome do parâmetro para ver seus detalhes.

      • Para fins de compatibilidade, o prefixo "loose_" é utilizado nos parâmetros do console. Por exemplo, "loose_rds_audit_log_event_buffer_size" e "rds_audit_log_event_buffer_size" representam o mesmo parâmetro.

    8. No canto superior esquerdo, clique em Submit Changes.

    9. Na página Save Changes, selecione os nós a serem atualizados e clique em OK.

      A tabela de alterações de parâmetros na caixa de diálogo inclui as colunas Parameter, New Value, Current Value, Default Value e Global Parameter. É possível ajustar rapidamente os parâmetros clicando em Set All to Current Value ou Set All to Default Value. Ao modificar um parâmetro global, todos os nós são selecionados automaticamente.

      Nota

      • Para parâmetros cujo valor em Force Restart seja Yes, é necessário reiniciar todos os nós do cluster para que os novos valores entrem em vigor. Planeje essa janela de indisponibilidade e proceda com cautela antes de reiniciar o cluster.

      • Se o seu cluster PolarDB for MySQL for versão 8.0, você também pode definir o parâmetro innodb_fast_startup como ON para acelerar a reinicialização.

    Aplicar um modelo de parâmetros

    Depois de configurar os parâmetros, você pode realizar as seguintes ações:

    • Exportar os parâmetros do cluster como um modelo de parâmetros.

      1. Faça login no console do PolarDB.

      2. No canto superior esquerdo do console, selecione a região onde o cluster está localizado.

      3. Localize o cluster desejado e clique em seu ID.

      4. No painel de navegação à esquerda, clique em Settings and Management > Parameters.

      5. Clique em Export as Template.

        Nota

        • Caso deseje alterar parâmetros na lista atual, faça as modificações primeiro e depois clique em Export as Template.

        • O modelo exportado incluirá tanto os parâmetros modificados manualmente quanto aqueles ajustados automaticamente pelo cluster durante a execução.

      6. Na caixa de diálogo Apply Template, configure os seguintes parâmetros.

        Parâmetro

        Descrição

        Template Name

        Nome do modelo, que deve atender aos seguintes requisitos:

        • Deve começar com uma letra e conter apenas letras, dígitos e sublinhados (_).

        • Deve ter entre 8 e 64 caracteres.

        Description

        Insira uma descrição para o modelo. A descrição pode ter de 0 a 200 caracteres.

      7. Clique em OK.

    • Aplicar um modelo de parâmetros a um cluster.

      1. Clique em Apply Template.

      2. Na caixa de diálogo Apply Template, selecione o nome do modelo de parâmetros desejado e clique em OK.

        Nota

        • É possível visualizar a quantidade de parâmetros no modelo, se há necessidade de reinicialização e o horário da última atualização.

        • Caso o modelo contenha parâmetros que exijam reinicialização do cluster, realize essa operação fora dos horários de pico e certifique-se de que sua aplicação possua mecanismo de reconexão.

        • Também é possível aplicar um modelo de parâmetros a um cluster diretamente na página de modelos. Para mais informações, consulte Apply a parameter template.

    Comparar parâmetros de nó

    Utilize o recurso Compare para analisar diferenças nas configurações de parâmetros entre distintos nós.

    1. Faça login no console do PolarDB.

    2. No canto superior esquerdo, selecione a região onde o cluster está implantado.

    3. Localize o cluster desejado e clique em seu ID.

    4. No painel de navegação à esquerda, escolha Settings and Management > Parameters.

    5. No canto superior esquerdo da página, clique em Compare.

      No painel Parameter Comparison à direita, selecione os nós a serem comparados (por exemplo, primary node e read-only node) e visualize os resultados, como o number of different parameters e whether restart-required parameters are included.

    6. Analise os resultados da comparação para os nós selecionados.

    Perguntas frequentes

    Como visualizar a hora atual do sistema e o fuso horário de um cluster?

    Execute instruções SQL para verificar a hora atual do sistema e as configurações de fuso horário do cluster. Recomendamos confirmar a configuração vigente antes de alterar o fuso horário.

    1. Execute a seguinte instrução para consultar a hora atual do sistema.

      SELECT SYSDATE();

      Saída de exemplo:

      +---------------------+
| SYSDATE()           |
+---------------------+
| 2026-07-08 04:00:03 |
+---------------------+

    2. Execute a instrução abaixo para verificar as configurações de fuso horário.

      SHOW GLOBAL VARIABLES LIKE '%time_zone%';

      Saída de exemplo:

      +------------------+--------+
| Variable_name    | Value  |
+------------------+--------+
| system_time_zone | CST    |
| time_zone        | SYSTEM |
+------------------+--------+

      As seguintes variáveis são retornadas:

      • system_time_zone: fuso horário do sistema operacional onde o cluster está executando, como CST.

      • time_zone: fuso horário atualmente em vigor, como SYSTEM, indicando que o cluster segue o fuso horário do sistema operacional.

    Como alterar o fuso horário de um cluster?

    Acesse a página Settings and Management>Parameters, pesquise e modifique o parâmetro default_time_zone. Você pode defini-lo como SYSTEM, um deslocamento de fuso horário como +8:00 ou um fuso horário nomeado como PRC, Asia/Shanghai. É necessário reiniciar o cluster para que a alteração tenha efeito.

    Referência de API

    API

    Descrição

    DescribeDBClusterParameters

    Consulta os parâmetros de um cluster.

    ModifyDBClusterParameters

    Modifica os parâmetros de um cluster.

    ModifyDBClusterAndNodesParameters

    Modifica parâmetros do cluster e aplica as alterações a nós específicos.

    ModifyDBNodesParameters

    Altera os parâmetros de um ou mais nós especificados.

    DescribeParameterTemplates

    Obtém uma lista de modelos de parâmetros padrão.

    DescribeModifyParameterLog

    Recupera o histórico de modificações de parâmetros de um cluster.