Todos los productos
Search
Centro de documentos

PolarDB:Manage Orca endpoints

Última actualización: Oct 09, 2026

Este tema describe cómo gestionar los endpoints de Orca para PolarDB for MySQL.

Endpoints predeterminados y personalizados

Tipo de endpoint

Descripción

Casos de uso

Endpoint predeterminado

Cuando se crea un clúster de PolarDB for MySQL y se selecciona Enable Orca, se asigna un endpoint de Orca predeterminado a cada clúster. PolarProxy proporciona este endpoint.

El endpoint de Orca predeterminado admite la división automática de lectura y escritura: las solicitudes de escritura se enrutan al nodo principal y las de lectura a los nodos de solo lectura. Para obtener más información sobre PolarProxy, consulte Database proxy.

Recomendado para cargas de trabajo que requieren división de lectura y escritura. Agregue nodos de solo lectura para escalar su carga de trabajo de forma rápida y en tiempo real.

Endpoint personalizado

PolarDB for MySQL permite crear endpoints de Orca personalizados. PolarProxy proporciona estos endpoints.

  • Es posible configurar un modo de lectura y escritura, así como una política de balanceo de carga para un endpoint personalizado. De esta manera, se admiten tanto cargas con división de lectura y escritura como cargas de solo lectura. Para conocer los detalles de la configuración, consulte Configure the database proxy.

  • Un endpoint personalizado debe tener como mínimo un nodo de solo lectura asociado. Las solicitudes enviadas a través de este endpoint llegan únicamente a dicho nodo.

  • Utilice endpoints personalizados para aislar el acceso a los nodos de la base de datos según las distintas cargas de trabajo.

  • Establezca Read-write mode en Read-only para que el endpoint admita exclusivamente cargas de trabajo de solo lectura.

Nota

In-memory column index (IMCI) nodes no son compatibles con Orca. Por lo tanto, los endpoints de Orca no pueden enrutarse a in-memory column index (IMCI) nodes.

Creación de un endpoint personalizado de Orca

  1. Inicie sesión en la consola de PolarDB.

  2. En el panel de navegación izquierdo, haga clic en Clusters.

  3. En la esquina superior izquierda, seleccione la región donde se despliega el clúster.

  4. Busque el clúster de destino y haga clic en su identificador.

  5. En la página Basic Information del clúster, dentro de la sección Database Connections, haga clic en Create Custom Cluster Endpoint. Establezca Endpoint Type en ORCA Endpoint, introduzca un valor en Endpoint Name y configure las funciones de PolarProxy. Para obtener más información, consulte Configure the database proxy.

    Nota
    • Endpoint Type debe establecerse en ORCA Endpoint.

    • Para un ORCA Endpoint, en la configuración del proxy, Load Balancing Settings solo admite Load Balancing Policy y Primary Node Accepts Read Requests. Consistency Settings solo admite Consistency Level. No es posible configurar Connection Pool Settings, HTAP Optimization ni Security Protection.

Modificación de un endpoint de Orca

  1. Inicie sesión en la consola de PolarDB.

  2. En el panel de navegación izquierdo, haga clic en Clusters.

  3. En la esquina superior izquierda, seleccione la región donde se despliega el clúster.

  4. Busque el clúster de destino y haga clic en su identificador.

  5. En la página Basic Information del clúster, dentro de la sección Database Connections, busque el endpoint de destino. A la derecha de Private o Public, haga clic en image > Edit para modificar el endpoint.

Importante
  • El prefijo del endpoint debe cumplir con los siguientes requisitos:

    • Debe tener entre 6 y 40 caracteres de longitud. Solo puede contener letras minúsculas, dígitos y guiones (-).

    • Debe comenzar con una letra minúscula y terminar con un dígito o una letra.

  • El número de puerto debe estar en el rango de 3000 a 5999.

  • Si SSL está habilitado para el endpoint, cualquier modificación provocará que el clúster se reinicie.

  • Si SSL está habilitado para el endpoint, la longitud total del endpoint modificado no debe superar los 64 caracteres.

Liberación de un endpoint de Orca

Importante
  • Antes de liberar un endpoint, compruebe que sus aplicaciones se hayan actualizado para usar uno nuevo.

  • Un endpoint liberado no se puede recuperar. La única alternativa es crear uno nuevo.

  1. Inicie sesión en la consola de PolarDB.

  2. En el panel de navegación izquierdo, haga clic en Clusters.

  3. En la esquina superior izquierda, seleccione la región donde se despliega el clúster.

  4. Busque el clúster de destino y haga clic en su identificador.

  5. En la página Basic Information del clúster, dentro de la sección Database Connections, busque el endpoint de destino y haga clic en Release, ubicado en la esquina superior derecha del endpoint, para liberarlo.

  6. En el cuadro de diálogo que aparece, haga clic en OK.