Todos os produtos
Search

Este produto

    PolarDB:Add or remove compute nodes

    Central de documentação

    PolarDB:Add or remove compute nodes

    Última atualização: Oct 13, 2026

    Se o aumento do tráfego de leitura tornar a resposta do banco de dados mais lenta, adicione nós somente leitura para expandir a capacidade de leitura do cluster. Essa ação melhora o throughput e reduz a carga no nó primário (nó de leitura/gravação). Em períodos de baixa demanda, remova nós somente leitura ociosos para economizar custos. O endpoint de cluster do PolarDB distribui automaticamente as solicitações de leitura entre os nós somente leitura, simplificando o gerenciamento de conexões da aplicação.

    Pré-requisitos

    Antes de começar, verifique se as seguintes condições foram atendidas:

    • Método de faturamento: O cluster de destino deve usar o método de faturamento Subscription ou Pay-as-you-go.

    • Status do cluster: O cluster de destino deve estar no estado Running, sem outras tarefas de alteração de configuração em andamento, como mudanças nas configurações de nós de computação ou atualizações de versões secundárias.

    Impactos e limitações

    Antes de adicionar ou remover um nó somente leitura, compreenda os impactos e as limitações para planejar adequadamente a operação.

    Impacto no serviço

    • Adição de um nó somente leitura: A inclusão de um único nó somente leitura leva aproximadamente 5 minutos. Se você adicionar vários nós simultaneamente, eles serão provisionados em paralelo. O tempo real necessário depende de fatores como a carga de trabalho do cluster e a quantidade de bancos de dados e tabelas. Esse procedimento não afeta o cluster em execução.

    • Remoção de um nó somente leitura: O PolarDB não permite suspender um nó somente leitura individualmente. Para remover um nó, exclua-o. Se precisar restaurá-lo posteriormente, adicione-o novamente pelo console ou chamando a API. Ao remover um nó somente leitura, as conexões direcionadas a ele sofrem uma desconexão transitória, mas os demais nós permanecem inalterados. Execute essa operação fora dos horários de pico e garanta que sua aplicação possua um mecanismo de reconexão automática. Se a aplicação estiver conectada a um endpoint de cluster, o PolarDB retira automaticamente o nó excluído da tabela de roteamento, eliminando a necessidade de alterar a configuração da aplicação.

    Limites de quantidade de nós

    • Enterprise Edition:

      • Cluster Edition: Um cluster suporta até 15 nós somente leitura. É obrigatório manter pelo menos um nó somente leitura para garantir alta disponibilidade. Portanto, não é possível remover o último nó desse tipo.

      • Multi-master Cluster (Limitless) Edition: Um cluster suporta até 63 nós de leitura/gravação e 15 nós somente leitura (nós somente leitura globais).

    • Standard Edition: Um cluster suporta até 7 nós somente leitura.

    Limites de especificação de nós

    Para assegurar a estabilidade e a alta disponibilidade do cluster, as especificações dos nós primários e somente leitura seguem as restrições abaixo:

    • Um novo nó somente leitura deve ter, no mínimo, metade da memória do nó primário.

    • A quantidade mínima de núcleos de CPU para um novo nó somente leitura varia conforme o número de núcleos do nó primário:

      Núcleos do nó primário

      Mínimo de núcleos somente leitura

      2

      2

      4

      4

      8

      4

      16

      8

      32

      16

      64

      32

      88

      64

      120

      64
    Nota

    Adicionar um nó

    1. Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters e selecione a região onde o cluster está implantado.

    2. Acesse a página Add/Remove Node utilizando um dos métodos a seguir:

      • Na linha do cluster desejado, clique em Add/Remove Node na coluna Actions.

      • Clique no ID do cluster alvo para abrir a página Basic Information. Na seção Database Nodes, clique em Add/Remove Node.

    3. Na caixa de diálogo Add/Remove Node, selecione Add Node (ou Add Global Read-Only Node) e clique em OK.

      Nota

      Também é possível adicionar outros tipos de nós conforme a necessidade do seu negócio, como Add Read-Write Node, Add AI Node, Add Read-only IMCI Node ou Add Search Node.

    4. Na página Upgrade/Downgrade, confirme a Current Configuration. Clique no ícone image para inserir um novo nó e definir suas especificações.

      Nota

      Clique neste botão várias vezes para provisionar múltiplos nós simultaneamente.

    5. Defina quando a alteração de configuração deve entrar em vigor:

      • Switch Now: A mudança é aplicada imediatamente.

      • Scheduled Switch: Escolha um horário dentro das próximas 24 horas. A tarefa será concluída em até 30 minutos após o momento agendado. Visualize ou cancele a operação na página Scheduled Tasks.

    6. Leia e aceite os termos de serviço, clique em Buy Now e finalize o pagamento. Após a confirmação do pagamento, a tarefa será executada no horário programado.

    7. (Opcional) Caso tenha adicionado outros tipos de nós, consulte as orientações abaixo para os próximos passos:

      • Nó de leitura/gravação: Execute a instrução CREATE DATABASE <name> [POLARDB_WRITE_NODE master_id]; para criar um banco de dados no novo nó. Para mais detalhes, consulte Usage of Multi-master Clusters.

      • Nó de IA: Utilize instruções SQL de IA prefixando-as com a dica /*polar4ai*/. Para conhecer os casos de uso, veja Data-Agent.

      • Nó IMCI somente leitura: Crie um índice columnstore acrescentando o comentário COLUMNAR=1 a uma tabela ou coluna específica. Consulte Add a columnstore index para mais informações.

      • Nó de busca: Utilize APIs REST compatíveis com Elasticsearch para criar índices e pesquisar dados. Veja Use Intelligent Search para mais detalhes.

    Remover um nó

    Observações

    Nó de leitura/gravação

    Antes de retirar um nó de leitura/gravação de um Multi-master Cluster, transfira os pontos de acesso de todos os bancos de dados desse nó para outros nós de leitura/gravação disponíveis. Consulte Usage of Multi-master Clusters para mais informações.

    Importante

    Sem essa etapa, os bancos de dados ficarão inacessíveis. Se isso ocorrer, restaure o acesso reatribuindo um nó de leitura/gravação a esses bancos. Para isso, execute a seguinte instrução: ALTER DATABASE <name> POLARDB_WRITE_NODE <new_master_id>;.

    1. Consulte a distribuição dos bancos de dados no nó de leitura/gravação.

      SELECT * FROM INFORMATION_SCHEMA.INNODB_CC_GLOBAL_LOCK_INFO WHERE LOCK_MODE = 'SLS_X' AND MASTER_ID = <master_id>;

    2. Transfira os pontos de acesso de todos os bancos de dados ou objetos de dados retornados pela consulta para outros nós de leitura/gravação.

      Nota

      O resultado da consulta pode conter uma entrada chamada mysql/global_ddl_lock com o tipo de object definido como Table. Trata-se de um item interno que não precisa ser transferido.

      ALTER DATABASE <name> POLARDB_WRITE_NODE <new_master_id>;

    Nó de IA

    • Após a remoção do último nó de IA, o sistema elimina imediatamente o nó e seus dados associados, como tabelas vetoriais. Instruções SQL de IA enviadas ao cluster deixarão de receber resposta, enquanto outras instruções SQL continuam funcionando normalmente.

    • Para evitar perda de dados, faça backup das informações necessárias antes de excluir o nó.

    Nó IMCI somente leitura

    • Depois de remover o último nó IMCI somente leitura, o cluster perde a capacidade de acelerar consultas por meio de índices columnstore. Para voltar a utilizar esses índices e melhorar o desempenho, adicione outro nó IMCI somente leitura e aguarde a reconstrução automática dos índices columnstore.

    • O Cluster Endpoint mascara automaticamente os nós com falha, dispensando alterações na configuração da aplicação.

    Nó de busca

    • Quando todos os nós de busca são removidos, o sistema purga imediatamente esses nós e seus dados associados. Requisições via API REST enviadas ao cluster não receberão mais resposta, porém outras instruções SQL permanecem operacionais.

    • Para prevenir perda de dados, realize os data backups necessários antes de excluir os nós.

    Procedimento

    1. Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters e selecione a região onde o cluster está implantado.

    2. Acesse a página Add/Remove Node usando um dos métodos abaixo:

      1. Na linha do cluster alvo, clique em Add/Remove Node na coluna Actions.

      2. Clique no ID do cluster desejado para ir à página Basic Information. Na seção Database Nodes, clique em Add/Remove Node.

    3. Na caixa de diálogo Add/Remove Node, selecione Delete Node (ou Delete Global Read-Only Node), Delete Read-Write Node, Delete AI Node, Delete Read-only IMCI Node ou Delete Search Node conforme a necessidade do seu negócio e clique em OK.

    4. Na página Upgrade/Downgrade, valide a Current Configuration. Clique no ícone de subtração 减号图标 ao lado do nome do nó para removê-lo.

      Nota

      É possível remover vários nós de uma só vez.

    5. Escolha o momento em que a alteração de configuração deve ser aplicada:

      • Switch Now: A modificação entra em vigor imediatamente.

      • Scheduled Switch: Selecione um horário nas próximas 24 horas. A conclusão da tarefa ocorre em até 30 minutos após o tempo estipulado. Visualize ou cancele a operação na página Scheduled Tasks.

    6. Leia e concorde com os termos de serviço, clique em Buy Now e efetue o pagamento. Assim que o pagamento for confirmado, a tarefa será processada no horário agendado.

    Faturamento

    A adição ou remoção de nós impacta exclusivamente as taxas de nós de computação. Custos de recursos como armazenamento permanecem inalterados.

    • Pay-as-you-go

      • Novos nós são cobrados por hora, desde a criação até a liberação.

      • Remova nós a qualquer momento para interromper o faturamento correspondente.

    • Subscription

      • Ao adicionar um nó, pague uma taxa única referente ao período entre a data atual e a expiração do cluster.

      • Ao remover um nó, o sistema calcula automaticamente o valor residual e emite um reembolso. Consulte Refund policy for configuration downgrades para mais detalhes.

    FAQ

    • O que fazer se ocorrer um erro de "recursos insuficientes" ao adicionar um nó?

      Caso o sistema exiba a mensagem Insufficient resources. Please try again in another region or zone, significa que a especificação selecionada está esgotada na zona atual. Recomendamos adotar uma das medidas abaixo:

      1. Selecionar uma especificação similar: Tente optar por uma especificação ligeiramente inferior.

      2. Alterar a zona. Para evitar escassez de recursos em futuras operações de dimensionamento, manually change the zone.

    • É possível adicionar nós de leitura/gravação a um cluster PolarDB?

      Nós de leitura/gravação só podem ser adicionados em clusters Multi-master Cluster (Limitless) Edition. Verifique se o seu cluster pertence a essa edição.

    • O que fazer se o sistema informar que nenhuma alteração de especificação foi detectada ao adicionar ou remover um nó?

      Essa mensagem indica que nenhum nó foi adicionado ou removido ainda. Siga as instruções na tela: clique no ícone image para adicionar um nó ou clique no ícone de subtração 减号图标 antes do nome de um nó para removê-lo.

    • Como proceder se o erro The number of DB nodes is incorrect. aparecer ao remover um nó?

      Para garantir alta disponibilidade (HA) e failover automático, um cluster PolarDB Cluster Edition exige pelo menos um nó somente leitura.

    • Ao remover nós, posso manter apenas um nó primário e um nó IMCI somente leitura?

      Não. Para adicionar ou manter um nó IMCI somente leitura, é obrigatório ter pelo menos um nó somente leitura convencional no cluster.

    • Minha aplicação sofre alta pressão de escrita. Adicionar nós somente leitura resolverá o problema?

      Não. Nós somente leitura processam apenas solicitações de leitura (SELECT). O nó primário é responsável exclusivamente por todas as operações de escrita (INSERT/UPDATE/DELETE). Se o gargalo for desempenho de escrita, atualize as especificações do nó primário em vez de adicionar nós somente leitura.

    Tópicos relacionados

    APIs relacionadas

    API

    Descrição

    CreateDBNodes

    Adiciona nós a um cluster PolarDB.

    DeleteDBNodes

    Remove nós de um cluster PolarDB.