Todos os produtos
Search
Central de documentação

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

Última atualização: Aug 21, 2026

Após ativar o recurso de proxy de banco de dados em uma instância do ApsaraDB RDS for MySQL, talvez seja necessário modificar as configurações de conexão padrão dos endpoints de proxy conforme os requisitos do seu negócio. O endpoint de proxy de banco de dados era anteriormente denominado terminal de proxy. Este tópico descreve os parâmetros das configurações de conexão de um endpoint de proxy de banco de dados e como configurá-los.

Pré-requisitos

O recurso de proxy de banco de dados está ativado. Para mais informações, consulte Ative database proxy.

Configurar as definições de conexão de um endpoint de proxy de banco de dados

Nota

Conecte-se a uma instância rds usando endpoints internos e públicos de diferentes endpoints de proxy, conforme a necessidade do seu negócio.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância rds está localizada. Em seguida, localize a instância rds 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, localize o endpoint de proxy de banco de dados que deseja configurar na coluna Proxy Endpoint (Terminal) ID e clique em Modify Configuration na coluna Actions.

  4. Na caixa de diálogo exibida, modifique as configurações de conexão relevantes do endpoint de proxy de banco de dados conforme os requisitos do seu negócio. A tabela a seguir descreve os parâmetros.

    Parameter

    Description

    Connection Description

    Descrição personalizada do endpoint de proxy de banco de dados. A descrição pode ter até 30 caracteres.

    Network and Zone

    Zona e vSwitch do proxy de banco de dados.

    Read/Write Attribute

    Atributos de leitura e gravação do endpoint de proxy de banco de dados (anteriormente terminal de proxy).

    • Read/Write (Read/Write Splitting): O endpoint de proxy de banco de dados conecta-se à instância rds primária e às suas instâncias rds somente leitura, podendo receber solicitações de gravação. Este é o valor padrão.

    • Read-only (Primary Instance Not Connected to Receive Write Requests): O endpoint de proxy de banco de dados conecta-se apenas às instâncias rds somente leitura e não pode receber solicitações de gravação.

    Nota

    Nearest Access

    Define se o recurso de acesso mais próximo deve ser ativado. Recomendamos ativar esse recurso para reduzir a latência de acesso e melhorar o desempenho. Para mais informações, consulte Configure nearest access.

    Connection Pooling

    Tipo do pool de conexões. Para mais informações, consulte Configure connection pooling.

    • Transaction-level Connection Pooling: Recomendamos selecionar esta opção.

      • Na maioria dos casos, cargas de trabalho exigem conexões de curta duração.

      • As conexões são estabelecidas frequentemente.

      • O número de conexões excede o máximo suportado por uma instância rds.

      Nos cenários acima, se as limitações do pool de conexões no nível de transação não afetarem suas cargas de trabalho, recomendamos selecionar esta opção. Para mais informações, consulte Limits of transaction connection pools.

    • Session-level Connection Pooling

      • Na maioria dos casos, cargas de trabalho exigem conexões de curta duração.

      • As conexões são estabelecidas frequentemente.

      Nos cenários acima, caso as limitações do pool de conexões no nível de transação afetem suas cargas de trabalho, selecione esta opção. Para mais informações, consulte Limits of transaction connection pools.

    • Disable Connection Pooling: Esta opção vem selecionada por padrão.

      • Na maioria dos casos, cargas de trabalho exigem conexões persistentes.

      • O número de conexões é pequeno.

      • Suas aplicações utilizam pools de conexões como Druid, DBCP, c3p0 e HikariCP.

      Nos cenários acima, não é necessário usar um pool de conexões.

    Nota

    Se a versão do proxy de banco de dados da sua instância rds for anterior a 2.9.1, este parâmetro estará disponível apenas quando o parâmetro Read/Write Attribute estiver definido como Read/Write (Read/Write Splitting). Se a versão do proxy de banco de dados da sua instância rds for 2.9.1 ou posterior, não há restrições.

    Latency Threshold

    Limiar máximo de latência permitido para replicação de dados da instância rds primária para as instâncias rds somente leitura. Valores válidos: 0 a 3600. Unidade: segundos.

    As instâncias rds somente leitura podem replicar dados da instância rds primária com uma determinada latência. Essa latência varia conforme o status das instruções SQL executadas. Recomendamos definir este parâmetro com um valor maior ou igual a 30.

    Nota
    • Se a versão do proxy de banco de dados da sua instância rds for anterior a 2.9.1, você só poderá configurar o pool de conexões para um endpoint de proxy de banco de dados definido como leitura/gravação. Se a versão do proxy de banco de dados da sua instância rds for 2.9.1 ou posterior, não há restrições.

    • Quando a latência de replicação de dados para uma instância rds somente leitura for menor que o valor deste parâmetro e o peso de leitura dessa instância não for 0, o sistema encaminhará solicitações de leitura para ela.

    • É possível selecionar Disable para este parâmetro. Nesse caso, as solicitações de leitura serão distribuídas às instâncias somente leitura independentemente da latência.

    • Se você selecionar Read/Write (Read/Write Splitting) em Read/Write Attributes, o valor padrão deste parâmetro será 30 segundos. Se você selecionar Read-only (Primary Instance Not Connected to Receive Write Requests) em Read/Write Attributes, este parâmetro ficará desativado por padrão.

    Transaction Splitting

    Capacidade de divisão de transações. O valor é fixo como Enabled. Com a divisão de transações ativada, o sistema encaminha as solicitações de leitura anteriores às operações de gravação nas transações para as instâncias rds somente leitura, reduzindo assim a carga na instância rds primária.

    Nota

    Este parâmetro aparece apenas quando o parâmetro Read/Write Attribute está definido como Read/Write (Read/Write Splitting). Para mais informações, consulte Use transaction splitting.

    Read Weight Allocation

    Método usado para atribuir pesos de leitura.

    • Automatic Distribution: O sistema atribui automaticamente um peso de leitura a cada instância rds no seu sistema de banco de dados com base nas especificações da instância. Ao criar uma instância rds somente leitura, o sistema atribui automaticamente um peso de leitura a ela para que processe solicitações de leitura.

    • Custom: Especifique um peso de leitura para cada instância rds somente leitura. Valores válidos: 0 a 10000. As instâncias rds somente leitura processam solicitações de leitura com base nos pesos especificados. O peso de leitura padrão de uma nova instância rds somente leitura é 0. Modifique o peso de leitura da nova instância rds somente leitura.

    Nota
    • O recurso de acesso mais próximo garante que as solicitações sejam encaminhadas da sua aplicação para o proxy de banco de dados. A configuração de peso de leitura garante que as solicitações sejam encaminhadas do proxy de banco de dados para os bancos de dados back-end, sem ser afetada pelo recurso de acesso mais próximo. Use os dois recursos juntos para minimizar a latência de acesso.

    • Um peso de leitura maior indica mais solicitações de leitura a serem processadas. Por exemplo, se a instância rds primária tiver 3 instâncias rds somente leitura com pesos de leitura 100, 200 e 200, e o peso de leitura da instância primária for 0, a instância primária processará apenas solicitações de gravação, enquanto as instâncias somente leitura processarão solicitações de leitura na proporção de 1:2:2.

    • Não é possível especificar pesos para instâncias rds somente leitura cujas latências de replicação de dados já estejam definidas. Para mais informações, consulte Definir a latência de replicação de dados de uma instância ApsaraDB RDS for MySQL somente leitura Configure a data replication latency for a read-only ApsaraDB RDS for MySQL instance

    • Após modificar este parâmetro, os novos pesos de leitura entram em vigor imediatamente. A modificação não causa indisponibilidade do service. As conexões existentes também permanecem válidas. Apenas as solicitações enviadas por novas conexões são encaminhadas com base nos novos pesos.

    • Se você utilizar a rds Cluster Edition, os pesos de leitura especificados indicam os pesos de leitura dos nós primário e secundário no cluster rds.

    • Se você utilizar a rds High-availability Edition, crie pelo menos uma instância rds somente leitura antes de especificar pesos de leitura.

    • Para mais informações sobre como configurar atributos de leitura e gravação, consulte Configure the read and write attributes and the read weight of the database proxy.

  5. Clique em OK.

Nota

Configure as definições de conexão persistente para um proxy de banco de dados conforme os requisitos do seu negócio. Ao configurar opções como ativar ou desativar conexões persistentes, a definição entra em vigor para todos os endpoints de proxy de banco de dados da instância rds. As conexões persistentes mantêm as conexões entre a aplicação e o proxy de banco de dados da instância rds durante um failover da instância ou falha da instância rds. Se sua aplicação se conectar ao sistema de banco de dados usando o endpoint de proxy de banco de dados, não ocorrerão erros de desconexão. Para mais informações, consulte Configure persistent connection settings.

Referências

Operações relacionadas

Operation

Description

DescribeDBProxy

Consulta os detalhes do 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.