Todos los productos
Search

Este producto

    PolarDB:Consultar o solicitar un endpoint

    Centro de documentos

    PolarDB:Consultar o solicitar un endpoint

    Última actualización: Sep 20, 2026

    Un clúster de PolarDB cuenta con tres tipos de endpoints: endpoints principales, endpoints de clúster y endpoints personalizados. Cuando se conecta a un clúster de PolarDB, puede usar cualquiera de estos tres tipos de endpoints del clúster de PolarDB. Se recomienda utilizar el endpoint de clúster.

    Endpoints

    • Clúster centralizado de PolarDB for PostgreSQL (la Product version es Enterprise Edition o Standard Edition)

      image

    • Clúster distribuido de PolarDB for PostgreSQL

      image

    Tipo

    Descripción

    Tipos de red

    Endpoint de clúster (recomendado)

    Cuando se crea un clúster centralizado de PolarDB for PostgreSQL (donde la product version es Enterprise Edition o Standard Edition), cada clúster incluye un endpoint de clúster predeterminado. Un proxy de base de datos gestiona este endpoint.

    El endpoint de clúster 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 el proxy de base de datos, consulte Database proxy.

    Nota

    Los clústeres distribuidos de PolarDB for PostgreSQL no incluyen este endpoint de clúster predeterminado.

    • Red privada

    • Red pública

    Endpoint principal

    Cada clúster de PolarDB tiene un único endpoint principal con las siguientes características:

    • Siempre se conecta al nodo principal o al CN principal y admite operaciones de lectura y escritura.

    • Si el nodo principal o el CN principal falla, el endpoint principal realiza automáticamente un failover hacia el nuevo nodo principal o CN.

    Endpoint personalizado

    • Clúster centralizado de PolarDB for PostgreSQL

      Es decir, cuando la product edition de los clústeres de PolarDB es Enterprise Edition o Standard Edition.

      • Se pueden crear hasta cinco endpoints personalizados. El proxy de base de datos también gestiona estos endpoints.

      • Es posible configurar el modo de lectura/escritura y la política de balanceo de carga para un endpoint personalizado. Este endpoint admite la división de lectura y escritura o el acceso de solo lectura para sus aplicaciones. Para obtener más información sobre estas configuraciones, consulte Configure PolarProxy.

      • Este endpoint enruta las solicitudes únicamente al nodo de solo lectura asociado.

      Nota

      PolarDB permite crear un endpoint personalizado asociado a un solo nodo. Si ese nodo falla, el endpoint podría dejar de estar disponible hasta por una hora. No utilice esta configuración en un entorno de producción.

    • Clúster distribuido de PolarDB for PostgreSQL

      • Se pueden crear hasta seis endpoints personalizados.

      • Un endpoint personalizado que se conecta a varios CN no sirve para ejecutar instrucciones DDL, como crear o eliminar tablas y cuentas. Utilice este endpoint para instrucciones DML y DQL. Para ejecutar instrucciones DDL, use el endpoint principal.

    Endpoints privados y públicos

    Tipo de red

    Descripción

    Casos de uso

    Red privada

    • Los endpoints privados ofrecen el mejor rendimiento para PolarDB.

    • Al crear un clúster, se genera un endpoint privado de forma predeterminada. Este endpoint no se puede liberar, pero sí modificar. Para obtener más información, consulte Modify an endpoint.

    Por ejemplo:

    • Una instancia de ECS puede acceder al clúster de base de datos mediante un endpoint privado si ambos se encuentran en la misma VPC.

    • Utilice DMS para acceder al clúster de base de datos a través de una VPC.

    Red pública

    • Puede solicitar o liberar un endpoint público. Para obtener más información, consulte Apply for a public endpoint.

    • La red pública corresponde a Internet. Al acceder a PolarDB a través de la red pública, no se obtiene un rendimiento óptimo.

    Por ejemplo: acceda al clúster de base de datos a través de la red pública para tareas de mantenimiento.

    Consultar endpoints y puertos

    1. Inicie sesión en la consola de PolarDB. En el panel de navegación izquierdo, haga clic en Clusters. Seleccione la región donde se encuentra su clúster y luego haga clic en el ID del clúster.

    2. Consulte el endpoint y el puerto según el tipo de clúster.

      Clústeres centralizados de PolarDB for PostgreSQL

      Un clúster centralizado de PolarDB for PostgreSQL es aquel cuya product edition es Enterprise Edition o Standard Edition.

      En la sección Database Connections, coloque el cursor sobre el endpoint deseado. Aparecerá un cuadro de diálogo que muestra la Network Information, la cual incluye el endpoint y el número de puerto.

      Esta sección muestra el Primary endpoint y el Cluster endpoint (Recommended). El endpoint de clúster opera en modo Read/Write (automatic read/write splitting). Para cada endpoint, puede consultar el endpoint privado, el endpoint público y el EndpointId. También puede hacer clic en Create custom endpoint para agregar una nueva conexión.

      Nota

      Si anteriormente se conectaba a su base de datos mediante un nombre de dominio, haga clic en Bind Private Domain Name para conservar el nombre de dominio original después de migrar la base de datos a la nube. Solo es posible vincular un dominio Private a un endpoint privado. Para obtener más información, consulte Private domain names.

      Clúster de PolarDB PostgreSQL Distributed Edition

      En la sección Database Connections, coloque el cursor sobre el endpoint privado o público deseado. Aparecerá un cuadro de diálogo que muestra el endpoint y el número de puerto.

      El panel expandido Endpoints contiene los campos Public Endpoint (haga clic en Apply si no hay ninguno disponible), Private Endpoint y EndpointId. La opción Create custom endpoint también está disponible a la derecha.

    Solicitar un endpoint público

    1. Inicie sesión en la consola de PolarDB. En el panel de navegación izquierdo, haga clic en Clusters. Seleccione la región donde se encuentra su clúster y luego haga clic en el ID del clúster.

    2. Solicite un endpoint según el tipo de clúster.

      Clúster centralizado de PolarDB for PostgreSQL

      Un clúster centralizado de PolarDB for PostgreSQL es aquel cuya product edition es Enterprise Edition o Standard Edition.

      1. En la página Basic Information, dentro de la sección Database Connections, busque el endpoint deseado y haga clic en Apply a la derecha de Public.

        Nota

        Solo es posible solicitar un endpoint Public. Al crear un clúster o un endpoint personalizado, se genera un endpoint Private de forma predeterminada, por lo que no necesita solicitar uno.

      2. En el cuadro de diálogo que aparece, establezca un prefijo para el endpoint y haga clic en OK.

        Nota

        El prefijo del endpoint debe cumplir los siguientes requisitos:

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

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

      Clústeres de PolarDB for PostgreSQL (Distributed Edition)

      1. En la página Basic Information, dentro de la sección Database Connections, busque el endpoint deseado y haga clic en Apply a la derecha de Public Endpoint.

      2. En el cuadro de diálogo que aparece, establezca un prefijo para el endpoint y haga clic en OK.

        Nota

        El prefijo del endpoint debe cumplir los siguientes requisitos:

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

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

    Siguientes pasos

    Connect to a PolarDB for PostgreSQL cluster

    API relacionadas

    API

    Descripción

    DescribeDBClusterEndpoints

    Consulta la información de los endpoints de un clúster.

    CreateDBEndpointAddress

    Crea un endpoint público para un clúster.

    ModifyDBEndpointAddress

    Modifica el endpoint de un clúster.

    DeleteDBEndpointAddress

    Elimina un endpoint público de un clúster.