Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Configure the connection settings for a database proxy endpoint

Última atualização: Jun 26, 2026

Cada endpoint de proxy de banco de dados tem configurações de conexão independentes que controlam o comportamento de roteamento, o pool de conexões e a distribuição de tráfego de leitura. Após ativar o recurso de proxy de banco de dados em uma instância ApsaraDB RDS for MySQL, modifique essas configurações em qualquer endpoint de proxy para atender aos requisitos da sua carga de trabalho.

Pré-requisitos

Antes de começar, verifique se você tem:

Modificar configurações de conexão de um endpoint de proxy de banco de dados

Nota

Conecte-se a uma instância ApsaraDB RDS usando o endpoint interno ou público de qualquer endpoint de proxy.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde reside sua instância ApsaraDB RDS. Localize a instância e clique em no ID correspondente.

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

  3. Na seção Connection Information, localize o endpoint de proxy na coluna Proxy Endpoint (Terminal) ID e clique em Modify Configuration na coluna Actions.

  4. Na caixa de diálogo, configure os seguintes parâmetros:

    Connection description: descrição personalizada para o endpoint de proxy de banco de dados. Comprimento máximo: 30 caracteres.

    Network and zone: zona e vSwitch do proxy de banco de dados.

    Read/Write attribute: controla a quais instâncias ApsaraDB RDS o endpoint de proxy se conecta e se aceita solicitações de escrita.

    Opção

    Descrição

    Read/Write (Read/Write Splitting)

    Conecta-se à instância primária e às suas instâncias somente leitura. Aceita solicitações de leitura e escrita. Esta é a configuração padrão.

    Read-only (Primary Instance Not Connected to Receive Write Requests)

    Conecta-se apenas a instâncias somente leitura. Não aceita solicitações de escrita.

    Nota

    Alterações no Read/Write attribute entram em vigor apenas para novas conexões. As conexões existentes mantêm a configuração atual. Se você usar a RDS Cluster Edition, os nós primário e secundário do cluster podem gerenciar a divisão de leitura e escrita. Para detalhes, consulte Configurar os atributos de leitura e escrita e o peso de leitura do proxy de banco de dados e O que é divisão de leitura e escrita?.

    Nearest access: ativa o acesso mais próximo para reduzir a latência e melhorar o desempenho. Para mais informações, consulte Configurar o recurso de acesso mais próximo.

    Connection pooling: cada conexão de banco de dados gera sobrecarga devido à alocação de memória, handshake TLS e negociação de autenticação. O pool de conexões reduz essa sobrecarga ao reutilizar conexões existentes entre solicitações, em vez de abrir e fechar conexões para cada uma delas. Escolha o tipo com base no seu padrão de conexão.

    Opção

    Quando usar

    Transaction-level Connection Pooling

    Indicado para conexões de curta duração, estabelecimento frequente de conexões ou quando a quantidade de conexões excede o máximo suportado pela sua instância ApsaraDB RDS. Use esta opção, a menos que seus limites afetem sua carga de trabalho. Para detalhes, consulte Limites de pools de conexão de transação.

    Session-level Connection Pooling

    Recomendado para conexões de curta duração e estabelecimento frequente de conexões, quando os limites do pool de conexão no nível de transação afetam sua carga de trabalho. Para detalhes, consulte Limites de pools de conexão de transação.

    Disable Connection Pooling

    Mais adequado para conexões persistentes, baixa quantidade de conexões ou quando sua aplicação já gerencia um pool de conexões (por exemplo, Druid, DBCP, c3p0 ou HikariCP). Esta é a configuração padrão.

    Nota

    Se a versão do proxy de banco de dados for anterior a 2.9.1, este parâmetro estará disponível apenas quando o Read/Write attribute estiver definido como Read/Write (Read/Write Splitting). A versão 2.9.1 e posteriores não possuem restrições. Para mais informações, consulte Configurar o recurso de pool de conexões.

    Latency threshold: atraso máximo de replicação permitido antes que o proxy pare de rotear solicitações de leitura para uma instância somente leitura. Valores válidos: 0–3600 segundos. Defina este valor como 30 segundos ou mais para evitar o roteamento de leituras para instâncias com dados desatualizados.

    • Quando o atraso de replicação em uma instância somente leitura estiver abaixo deste limiar e seu peso de leitura não for 0, o proxy encaminhará solicitações de leitura para essa instância.

    • Defina este parâmetro como Disable para rotear solicitações de leitura para instâncias somente leitura, independentemente do atraso de replicação.

    • Padrão: 30 segundos quando o Read/Write attribute é Read/Write (Read/Write Splitting); desativado quando o Read/Write attribute é Read-only (Primary Instance Not Connected to Receive Write Requests).

    Nota

    Se a versão do proxy de banco de dados for anterior a 2.9.1, este parâmetro será configurável apenas para endpoints definidos como Read/Write (Read/Write Splitting). A versão 2.9.1 e posteriores não possuem restrições.

    Transaction splitting: fixo como Enabled. Solicitações de leitura que ocorrem antes de uma operação de escrita dentro de uma transação são encaminhadas para instâncias somente leitura, o que reduz a carga na instância primária. Este parâmetro aparece apenas quando o Read/Write attribute está definido como Read/Write (Read/Write Splitting). Para mais informações, consulte Usar o recurso de divisão de transações.

    Read weight allocation: determina como o tráfego de leitura é distribuído entre as instâncias somente leitura. Alterações de peso entram em vigor imediatamente sem causar interrupções no serviço. As conexões existentes permanecem válidas; apenas novas conexões usam os pesos atualizados.

    Opção

    Descrição

    Automatic Distribution

    O proxy atribui pesos de leitura com base nas especificações de cada instância. Novas instâncias somente leitura recebem pesos automaticamente.

    Custom

    Especifique um peso de leitura para cada instância somente leitura. Valores válidos: 0–10000. Novas instâncias somente leitura têm peso padrão de 0 e devem ser atualizadas manualmente.

    Nota
    • O acesso mais próximo controla o roteamento da sua aplicação para o proxy. A alocação de peso de leitura controla o roteamento do proxy para as instâncias de backend. Configure ambos os recursos juntos para minimizar a latência de ponta a ponta.

    • Um peso maior significa que mais solicitações de leitura são roteadas para aquela instância. Por exemplo, se três instâncias somente leitura tiverem pesos de 100, 200 e 200, e a instância primária tiver peso 0, as solicitações de leitura serão distribuídas na proporção de 1:2:2 entre as instâncias somente leitura.

    • Não é possível definir pesos de leitura para instâncias somente leitura que tenham uma latência de replicação de dados configurada. Para detalhes, consulte Configurar uma latência de replicação de dados para uma instância ApsaraDB RDS for MySQL somente leitura.

    • Se você usar a RDS Cluster Edition, os pesos se aplicam aos nós primário e secundário do cluster.

    • Caso utilize a RDS High-availability Edition, crie pelo menos uma instância somente leitura antes de especificar pesos personalizados.

    • Para detalhes sobre como configurar atributos de leitura e escrita, consulte Configurar os atributos de leitura e escrita e o peso de leitura do proxy de banco de dados.

  5. Clique em OK.

Nota

As configurações de conexão persistente aplicam-se a todos os endpoints de proxy de uma instância ApsaraDB RDS. Quando ativado, o proxy retém as conexões durante um failover ou falha da instância, de modo que as aplicações conectadas por meio de um endpoint de proxy não sofram erros de desconexão. Para mais informações, consulte Configurar definições de conexão persistente.

Referência da API

Operação

Descrição

DescribeDBProxy

Consulta os detalhes sobre o proxy de banco de dados de uma instância.

DescribeDBProxyEndpoint

Consulta as configurações de conexão de um endpoint de proxy de banco de dados conectado a uma instância.

ModifyDBProxyEndpoint

Modifica as configurações de um endpoint de proxy de banco de dados conectado a uma instância.

Próximos passos