Todos os produtos
Search
Central de documentação

PolarDB:Alterar a VPC e o vSwitch

Última atualização: Oct 13, 2026

Os clusters do PolarDB for MySQL Enterprise Edition permitem a troca online da VPC e do vSwitch padrão, mantendo a zona e o endpoint do cluster inalterados.

Caso sua instância ECS e o cluster PolarDB não estejam na mesma VPC, não será possível conectar-se ao cluster pela rede Private. Para resolver isso, altere a VPC do cluster PolarDB para que corresponda à VPC da instância ECS. Essa ação estabelece uma conexão Private e garante que o cluster PolarDB ofereça o melhor desempenho.

Pré-requisitos

Seu cluster deve atender aos seguintes requisitos:

  • A Database Edition deve ser a **Enterprise Edition** e a Edition deve ser a **Cluster Edition**.

  • O método de faturamento deve ser **assinatura ou pago por uso**.

Considerações

  • Durante a troca de VPC e vSwitch:

    • Essa operação causa uma transient connection interruption que dura cerca de 30 segundos. Recomenda-se executar esta operação em horários de baixa demanda e garantir que sua aplicação possua um mecanismo de reconexão para evitar interrupções no serviço.

    • Problemas de cache na resolução de DNS podem causar interrupções na conexão com o banco de dados até que o cache expire. Após a conclusão da troca, recomenda-se reiniciar a aplicação ou limpar o cache de DNS no host onde a aplicação está em execução.

    • A troca afeta brevemente o Data Management Service (DMS) e o Data Transmission Service (DTS). Esses serviços retomam a operação normal automaticamente após a conclusão da troca.

  • Ao trocar a VPC e o vSwitch, escolha se deseja alterar os endpoints existentes.

    • Caso defina a opção Existing Endpoint Switching como No, apenas a VPC padrão e o vSwitch padrão do cluster serão alterados. As VPCs e os vSwitches dos endpoints existentes não serão modificados.

    • Caso defina a opção Existing Endpoint Switching como Yes, a VPC padrão e o vSwitch padrão do cluster serão alterados, e as VPCs e os vSwitches de todos os endpoints existentes também serão modificados.

    Nota

    Ao criar um novo custom endpoint, ele usará por padrão a nova VPC e o novo vSwitch padrão.

Alterar a VPC e o vSwitch padrão de um cluster

  1. Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a região onde o seu cluster está localizado e, em seguida, clique no ID do cluster de destino.

  2. Na página Basic Information, clique em Switch ao lado de Default VPC. Na caixa de diálogo Switch VPC exibida, selecione a VPC e o vSwitch de destino.

    Importante

    Se você não trocar os endpoints existentes, a VPC e o vSwitch deles permanecerão inalterados.

Alterar a VPC e o vSwitch de um endpoint personalizado

Nota

O Primary address e o Cluster Endpoint não suportam a troca independente de VPC e vSwitch.

  1. Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a região onde o seu cluster está localizado e, em seguida, clique no ID do cluster de destino.

  2. Na seção Database Connections, selecione o endpoint personalizado de destino. Na caixa de diálogo Modify Endpoint Settings, clique em More > Edit.

  3. Na caixa de diálogo Modify Private Endpoint exibida, selecione a VPC e o vSwitch de destino.

    Clique em OK. A alteração da VPC e do vSwitch causa uma ou duas ocorrências de transient connection interruption em uma janela de 30 segundos. Recomenda-se executar esta operação em horários de baixa demanda. Caso ative o SSL para o endpoint, a alteração reiniciará o cluster. Além disso, o endpoint modificado não pode exceder 64 caracteres.

Especifique a VPC e o vSwitch ao criar um endpoint personalizado

  1. Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a região onde o seu cluster está localizado e, em seguida, clique no ID do cluster de destino.

  2. Na seção Database Connections, clique em Create Custom Cluster Endpoint. Na caixa de diálogo Create Custom Cluster Endpoint, selecione a VPC e o vSwitch de destino.

    Importante

    Por padrão, um novo endpoint personalizado utiliza a VPC e o vSwitch padrão do cluster. Se você selecionar uma VPC e um vSwitch diferentes, a criação do endpoint personalizado também alterará as configurações padrão do cluster para corresponder à sua nova seleção.