Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Gerencie endpoints de proxy de banco de dados

Última atualização: Oct 12, 2026

Após ativar o proxy de banco de dados em uma instância do ApsaraDB RDS for MySQL, as aplicações devem se conectar ao banco por meio de um endpoint de proxy. Este tópico descreve os tipos de endpoints disponíveis e explica como gerenciar seus endpoints internos e públicos.

Pré-requisitos

The database proxy is enabled.

Tipos de endpoints de proxy de banco de dados

  • Existem três tipos de endpoints de proxy de banco de dados: endpoint interno (VPC), endpoint interno (rede clássica) e endpoint público.

  • Ao enable the database proxy, o sistema cria automaticamente um endpoint de proxy padrão (anteriormente chamado de terminal de proxy). Por padrão, os novos endpoints são criados com um endpoint interno VPC. Você pode solicitar um endpoint público posteriormente.

Nota

Cada instância do ApsaraDB RDS for MySQL suporta de um a sete endpoints de proxy de banco de dados. Para cada endpoint de proxy, é possível solicitar um endpoint interno (VPC) e um endpoint público.

Gerencie endpoints de proxy de banco de dados

Crie um endpoint de proxy (anteriormente terminal de proxy)

Nota
  • Depois de ativar o proxy de banco de dados, crie endpoints adicionais, cada um com sua própria política de acesso.

  • Uma única instância do ApsaraDB RDS for MySQL aceita de um a sete endpoints de proxy de banco de dados.

  • O formato do endpoint de proxy de banco de dados segue o padrão: rm-*****.rwlb.cn-chengdu.rds.aliyuncs.com:3306.

    • rm-*****: Prefixo personalizável do endpoint. Deve ter entre 2 e 40 caracteres, começar com uma letra minúscula e conter apenas letras minúsculas, dígitos e hifens (-).

    • rwlb: Identificador do proxy de divisão de leitura/escrita.

    • cn-chengdu: A região.

    • rds.aliyuncs.com: Nome de domínio do service RDS da Alibaba Cloud.

    • 3306: Porta padrão do MySQL.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região da instância e clique em no ID da instância.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Na parte superior da seção Connection Information, clique em Create Proxy Endpoint.

  4. Na caixa de diálogo exibida, configure a política de acesso do endpoint de proxy e clique em OK. Para mais detalhes sobre os parâmetros de configuração, consulte Configure an access policy for a database proxy endpoint.

Alternar o vSwitch de um endpoint de proxy

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região da instância e clique em no ID da instância.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Na seção Connection Information, em Network Settings do endpoint de proxy desejado, clique em Switch vSwitch.

    Importante
    • A alteração do vSwitch de um endpoint de proxy é suportada apenas em instâncias baseadas em disco cloud. Instâncias baseadas em disco local não oferecem suporte a essa operação.

    • Trocar o vSwitch de um endpoint de proxy causa uma desconexão transitória de aproximadamente 30 segundos. As conexões diretas à sua instância do ApsaraDB RDS for MySQL não são afetadas. Para evitar interrupções no serviço, recomendamos executar essa operação fora do horário de pico ou alternar temporariamente as conexões da aplicação para o endpoint da instância primária ou de uma instância somente leitura. Certifique-se de que sua aplicação possua um mecanismo de reconexão automática; caso contrário, será necessário reconectar manualmente a aplicação ao proxy de banco de dados.

  4. Na caixa de diálogo exibida, selecione Destination vSwitch e Change Time, e clique em OK.

Modifique um endpoint ou porta de proxy

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região da instância e clique em no ID da instância.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Na seção Connection Information, clique em no ícone image.png à direita do endpoint de proxy desejado.

  4. Na caixa de diálogo exibida, defina o prefixo do endereço de conexão e a Port, e clique em OK.

Nota

Se você fez upgrade de um proxy compartilhado para um proxy dedicado, observe que o sufixo do endpoint muda na primeira vez que você o modifica.

Exclua um endpoint de proxy

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região da instância e clique em no ID da instância.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Clique em Delete Connection à direita do endpoint de proxy desejado e, na caixa de diálogo exibida, clique em OK.

Nota
  • É obrigatório manter pelo menos um endpoint de proxy de banco de dados.

  • Esta operação exclui todo o endpoint de proxy, incluindo o ID do endpoint, o endpoint interno e o endpoint público.

Gerencie endpoints públicos

Solicitar um endpoint público

Faça a solicitação na página Database Proxy ou na página Database Connection:

Página Database Proxy

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região da instância e clique em no ID da instância.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Na seção Connection Information, na coluna Public Endpoint/Port correspondente ao ID do endpoint de proxy desejado, clique em Apply for Public Endpoint.

  4. Na caixa de diálogo exibida, defina o prefixo do endereço de conexão pública e a Port, e clique em OK.

Página Database Connection

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região da instância e clique em no ID da instância.

  2. No painel de navegação à esquerda, clique em Database Connection.

  3. Na área Database Proxy Endpoint, clique em Apply for Public Endpoint, defina o prefixo do endpoint público e a Port, e clique em OK.

Nota
  • Cada endpoint de proxy suporta apenas um endpoint público.

  • O prefixo do endpoint deve ter entre 2 e 40 caracteres, iniciar com uma letra minúscula e conter apenas letras minúsculas, dígitos e hifens (-).

  • O número da porta deve estar entre 1000 e 5999.

Liberar um endpoint público

Libere um endpoint público em uma das duas páginas abaixo:

Página Database Proxy

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região da instância e clique em no ID da instância.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. À direita do endpoint público que deseja liberar, clique em Release Public Endpoint e, na caixa de diálogo, clique em OK.

Página Database Connection

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região da instância e clique em no ID da instância.

  2. No painel de navegação à esquerda, clique em Database Connection.

  3. Na seção Database Proxy Endpoint, clique em Release Public Endpoint à direita do endpoint público que deseja liberar e, em seguida, clique em OK na caixa de diálogo.

Documentos relacionados

Referência de API

API

Descrição

DescribeDBProxy

Consulta os detalhes do proxy de banco de dados de uma instância do ApsaraDB RDS.

DescribeDBProxyEndpoint

Consulta informações sobre os endpoints de proxy de banco de dados (anteriormente terminais de proxy) de uma instância do ApsaraDB RDS.

ModifyDBProxyEndpoint

Modifica a política de acesso de um endpoint de proxy de banco de dados de uma instância do ApsaraDB RDS.

CreateDBProxyEndpointAddress

Cria um endpoint de proxy de banco de dados.

ModifyDBProxyEndpointAddress

Modifica um endpoint de proxy de banco de dados.

DeleteDBProxyEndpointAddress

Exclui um endpoint de proxy de banco de dados.