Todos los productos
Search
Centro de documentos

PolarDB:Conexión a un clúster de PolarDB

Última actualización: Sep 09, 2026

PolarDB expone tres tipos de endpoints de conexión. Cada uno combina una dirección de host y un puerto. Elegir el tipo de endpoint y la configuración de red adecuados determina cómo su aplicación gestiona la separación de lecturas y escrituras, el failover y el aislamiento del tráfico.

Elección de un endpoint

El endpoint de clúster es la opción más adecuada para la mayoría de las cargas de trabajo.

image

Tipo de endpoint Función Cuándo usarlo Tipos de red compatibles
Endpoint de clúster (recomendado) Dirige el tráfico a través de PolarProxy, que separa automáticamente las solicitudes de lectura y escritura. Las escrituras se envían al nodo principal y las lecturas se distribuyen entre los nodos de solo lectura. Úselo en la mayoría de las cargas de trabajo. Ofrece separación de lecturas y escrituras, balanceo de carga y pool de conexiones. Escale las lecturas mediante la adición de nodos de solo lectura en cualquier momento.
  • Red privada

  • Red pública

Endpoint personalizado Es un endpoint definido por el usuario que dirige el tráfico a un subconjunto específico de nodos. Configure qué nodos incluir, el modo de lectura y escritura, y la política de balanceo de carga. Utilícelo para aislar el tráfico de servicios específicos. Por ejemplo, dirija las consultas analíticas a un conjunto dedicado de nodos de solo lectura sin afectar la carga de trabajo de producción. Red privada (VPC), red pública
Endpoint principal Se conecta directamente al nodo principal y omite PolarProxy. Admite tanto lecturas como escrituras. Recomendado cuando su aplicación requiere conexiones directas a la base de datos y no funciona con la separación de lecturas y escrituras. Red privada (VPC)

Restricciones de los endpoints personalizados

Un endpoint personalizado debe incluir como mínimo un nodo de solo lectura. Las solicitudes se dirigen únicamente a los nodos asociados al endpoint.

Importante

Los endpoints personalizados de un solo nodo no ofrecen alta disponibilidad. Si el nodo subyacente falla, el endpoint deja de estar disponible hasta por una hora. Use estos endpoints exclusivamente en entornos de desarrollo y pruebas, nunca en producción.

Comportamiento durante fallas de nodos

Tipo de endpoint

Comportamiento cuando falla un nodo

Endpoint personalizado (un solo nodo)

El endpoint deja de estar disponible hasta por una hora.

Endpoint principal

Se reconecta automáticamente al nuevo nodo principal después de un failover.

Elección de un tipo de red

Tipo de red

Descripción

Casos de uso habituales

Red privada (VPC)

Mantiene el tráfico dentro de su Virtual Private Cloud (VPC). Ofrece el mejor rendimiento y seguridad. Se crea un endpoint privado automáticamente al crear un clúster. Puede modificarlo, pero no eliminarlo. Consulte Change the endpoint of a cluster.

Una instancia de Elastic Compute Service (ECS) y el clúster están en la misma VPC. Acceso al clúster a través de Data Management Service (DMS) mediante VPC.

Red pública

Permite conexiones a través de internet. Ofrece menor rendimiento que la VPC y exige un control de acceso riguroso. Puede crear o liberar un endpoint público en cualquier momento. Consulte Manage the endpoints of a cluster.

Administración remota. Conexión desde servicios o herramientas externos a su VPC.

Use la red privada para todo el tráfico de producción. Reserve los endpoints públicos para desarrollo, administración remota o cuando el acceso por VPC no esté disponible.

Modos de lectura y escritura para endpoints de clúster

Los endpoints de clúster admiten dos modos de lectura y escritura. Elija el modo según si el endpoint necesita procesar escrituras.

Para configurar el modo de lectura y escritura de un endpoint de clúster, consulte Configure PolarProxy .

Lectura y escritura (separación automática de lecturas y escrituras)

Las escrituras se envían al nodo principal. Las lecturas se distribuyen entre los nodos que configure como nodos de servicio.

  • Selección de nodos de servicio: Incluya el nodo principal, uno o más nodos de solo lectura, o ambos.

  • Enrutamiento de escrituras: Todas las solicitudes de escritura se dirigen al nodo principal, independientemente de la configuración de los nodos de servicio.

  • Enrutamiento de lecturas: Lo controla la opción Primary Node Accepts Read Requests. Actívela o desactívela para incluir o excluir el nodo principal del tráfico de lectura.

  • Balanceo de carga: Balanceo de carga basado en solicitudes activas. Consulte Load balancing policies.

  • Separación de transacciones: Compatible cuando Consistency Level está configurado como Session Consistency (Medium) o Global Consistency (Strong). Consulte Transaction splitting.

  • Nivel de consistencia: Admite Eventual Consistency (Weak), Session Consistency (Medium) y Global Consistency (Strong). Consulte Consistency level.

  • Pool de conexiones: De sesión o de transacción. Consulte Connection pool.

    El pool de conexiones de PolarProxy es independiente de cualquier pool de conexiones del lado del cliente. Si su cliente ya administra un pool de conexiones, establezca el pool de conexiones de PolarProxy en Off . Cuando se configura en Off , las conexiones se distribuyen entre todos los nodos configurados. El límite total de conexiones lo determina el máximo de conexiones del nodo principal.
  • Protección de seguridad (protección contra sobrecarga): Compatible. Consulte Overload protection.

Solo lectura

Todo el tráfico se dirige a los nodos de solo lectura que configure. El nodo principal no recibe ninguna solicitud, incluso si aparece en la lista de nodos de servicio.

  • Selección de nodos de servicio: Uno o más nodos de solo lectura. No se admite un endpoint de solo lectura que contenga únicamente el nodo principal.

  • Balanceo de carga: Balanceo de carga basado en conexiones y balanceo de carga basado en solicitudes activas. Consulte Load balancing policies.

  • Nivel de consistencia: Solo Eventual Consistency (Weak). Este endpoint no ejecuta operaciones de escritura.

  • Pool de conexiones: No compatible. PolarDB distribuye las conexiones de manera uniforme entre todos los nodos de solo lectura configurados para el endpoint. Cada conexión de cliente se dirige a un único nodo de solo lectura. El límite total de conexiones es la suma de las conexiones máximas de todos los nodos de solo lectura.

  • Primary Node Accepts Read Requests / Transaction Splitting / Security protection: No aplicable.

Preguntas frecuentes

¿Cómo puedo saber si mi conexión se dirige a un endpoint principal o a un endpoint de clúster?

Revise el ID de sesión o el campo Vip en SQL Explorer.

  • ID de sesión: Si el ID de sesión es menor que 16777215, la conexión usa el endpoint principal. De lo contrario, utiliza un endpoint de clúster.

  • Campo Vip en SQL Explorer: Vaya a la pestaña Audit en SQL Explorer. Si el campo Vip contiene una dirección IP, la conexión usa un endpoint de clúster o personalizado. Si el campo está vacío, la conexión utiliza el endpoint principal o la versión del kernel de la base de datos es demasiado antigua para llenar este campo. Para MySQL 8.0.1, la versión secundaria del kernel debe ser 8.0.1.1.3 o posterior. Si depende de este campo para diagnósticos, actualice el kernel de su base de datos.

¿Cómo puedo saber si estoy conectado al endpoint de clúster predeterminado o a un endpoint personalizado?

Revise el campo Vip en la pestaña Audit de SQL Explorer. La dirección IP mostrada corresponde al endpoint de clúster o personalizado. Si el campo está vacío, es posible que la versión del kernel de la base de datos sea demasiado antigua para mostrar esta información. Para MySQL 8.0.1, la versión secundaria del kernel debe ser 8.0.1.1.3 o posterior.

¿Cómo me conecto directamente a un nodo de solo lectura?

Cree un endpoint personalizado con Read/Write Mode configurado como Read-only y agregue los nodos de solo lectura deseados. Todas las conexiones a través de ese endpoint se dirigirán exclusivamente a dichos nodos.

  1. Inicie sesión en la consola de PolarDB. En la página Basic Information de su clúster, vaya a la sección Database Connections y haga clic en Create Custom Endpoint.

  2. En el cuadro de diálogo Create Custom Endpoint, establezca Read/Write Mode en Read-only, seleccione los nodos de solo lectura que desea incluir y haga clic en OK.

  3. Use la cadena de conexión del nuevo endpoint para conectarse directamente a esos nodos de solo lectura.