Todos os produtos
Search

Este produto

    PolarDB:Visualizar ou solicitar um endpoint

    Central de documentação

    PolarDB:Visualizar ou solicitar um endpoint

    Última atualização: Sep 20, 2026

    Um cluster PolarDB possui três tipos de endpoints: endpoints primários, endpoints de cluster e endpoints personalizados. Ao se conectar a um cluster PolarDB, utilize um dos três tipos de endpoints disponíveis no cluster PolarDB. Recomendamos o uso do endpoint de cluster.

    Endpoints

    • Cluster centralizado PolarDB for PostgreSQL (Product version é Enterprise Edition ou Standard Edition)

      image

    • Cluster distribuído PolarDB for PostgreSQL

      image

    Tipo

    Descrição

    Tipos de rede

    Endpoint de cluster (Recomendado)

    Ao criar um cluster centralizado PolarDB for PostgreSQL (cuja product version seja Enterprise Edition ou Standard Edition), cada cluster já inclui um endpoint de cluster padrão, atendido por um proxy de banco de dados.

    O endpoint de cluster oferece suporte a separação automática de leitura/escrita. As requisições de escrita são roteadas para o nó primário, e as de leitura, para os nós somente leitura. Para mais informações sobre o proxy de banco de dados, consulte Database proxy.

    Nota

    Os clusters distribuídos PolarDB for PostgreSQL não incluem esse endpoint de cluster padrão.

    • Rede privada

    • Rede pública

    Endpoint primário

    Cada cluster PolarDB possui um único endpoint primário com as seguintes características:

    • Sempre se conecta ao nó primário ou ao CN primário, com suporte a operações de leitura e escrita.

    • Em caso de falha do nó primário ou do CN primário, o endpoint primário executa failover automaticamente para o novo nó primário ou CN.

    Endpoint personalizado

    • Cluster centralizado PolarDB for PostgreSQL

      Ou seja, a product edition é Enterprise Edition ou Standard Edition para clusters PolarDB.

      • É possível crie até cinco endpoints personalizados, todos atendidos pelo proxy de banco de dados.

      • Configure o modo de leitura/escrita e a política de balanceamento de carga para um endpoint personalizado. Esse endpoint pode suportar separação de leitura/escrita ou acesso somente leitura para suas aplicações. Para mais informações sobre as configurações, consulte Configure PolarProxy.

      • Este endpoint roteia requisições apenas para o nó somente leitura associado.

      Nota

      O PolarDB permite crie um endpoint personalizado associado a um único nó. Se esse nó falhar, o endpoint poderá ficar indisponível por até uma hora. Não utilize essa configuração em ambientes de produção.

    • Cluster distribuído PolarDB for PostgreSQL

      • É possível crie até seis endpoints personalizados.

      • Um endpoint personalizado conectado a múltiplos CNs não pode ser usado para execute instruções DDL, como criar ou excluir tabelas e contas. Use esse endpoint para instruções DML e DQL. Para instruções DDL, utilize o endpoint primário.

    Endpoints privados e públicos

    Tipo de rede

    Descrição

    Casos de uso

    Rede privada

    • Os endpoints privados oferecem o melhor desempenho para o PolarDB.

    • Ao criar um cluster, um endpoint privado é gerado automaticamente. Esse endpoint não pode ser liberado, mas é possível modifique-lo. Para mais informações, consulte Modify an endpoint.

    Por exemplo:

    • Uma instância ECS pode acessar o cluster de banco de dados por meio de um endpoint privado, desde que estejam na mesma VPC.

    • Use o DMS para acessar o cluster de banco de dados por meio de uma VPC.

    Rede pública

    • Solicite ou libere um endpoint público conforme necessário. Para mais informações, consulte Apply for a public endpoint.

    • A rede pública corresponde à Internet. O acesso ao PolarDB pela rede pública não garante desempenho ideal.

    Por exemplo: acesse o cluster de banco de dados pela rede pública para fins de manutenção.

    Visualizar endpoints e portas

    1. Acesse o console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a region onde seu cluster está localizado e clique no ID do cluster.

    2. Visualize o endpoint e a porta de acordo com o tipo do seu cluster.

      Clusters centralizados PolarDB for PostgreSQL

      Um cluster centralizado PolarDB for PostgreSQL é aquele cuja product edition é Enterprise Edition ou Standard Edition.

      Na seção Database Connections, passe o cursor sobre o endpoint desejado. Uma caixa de diálogo será exibida com as informações de Network Information, incluindo o endpoint e o número da porta.

      Esta seção exibe o Primary endpoint e o Cluster endpoint (Recommended). O endpoint de cluster opera no modo Read/Write (automatic read/write splitting). Para cada endpoint, é possível visualize o endpoint privado, o endpoint público e o EndpointId. Clique em crie custom endpoint para adicionar uma nova conexão.

      Nota

      Caso você tenha se conectado anteriormente ao banco de dados por meio de um nome de domínio, clique em Bind Private Domain Name para manter o nome de domínio original após migrar o banco de dados para a cloud. O vínculo Private só pode ser associado a um endpoint privado. Para mais informações, consulte Private domain names.

      Cluster PolarDB PostgreSQL Distributed Edition

      Na seção Database Connections, passe o cursor sobre o endpoint privado ou público desejado. Uma caixa de diálogo será exibida com o endpoint e o número da porta.

      O painel Endpoints expandido contém os campos Public Endpoint (clique em Apply caso não haja nenhum disponível), Private Endpoint e EndpointId. A opção crie custom endpoint também está disponível à direita.

    Solicitar um endpoint público

    1. Acesse o console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a region onde seu cluster está localizado e clique no ID do cluster.

    2. Solicite um endpoint de acordo com o tipo do seu cluster.

      Cluster centralizado PolarDB for PostgreSQL

      Um cluster centralizado PolarDB for PostgreSQL é aquele cuja product edition é Enterprise Edition ou Standard Edition.

      1. Na página Basic Information, na seção Database Connections, localize o endpoint desejado e clique em Apply à direita de Public.

        Nota

        Só é possível solicitar um endpoint Public. Ao criar um cluster ou um endpoint personalizado, um endpoint Private é gerado automaticamente, dispensando qualquer solicitação.

      2. Na caixa de diálogo exibida, defina um prefixo para o endpoint e clique em OK.

        Nota

        O prefixo do endpoint deve atender aos seguintes requisitos:

        • Deve ter entre 6 e 40 caracteres e conter apenas letras minúsculas, dígitos e hifens (-).

        • Deve começar com uma letra e terminar com uma letra ou um dígito.

      Clusters PolarDB for PostgreSQL (Distributed Edition)

      1. Na página Basic Information, na seção Database Connections, localize o endpoint desejado e clique em Apply à direita de Public Endpoint.

      2. Na caixa de diálogo exibida, defina um prefixo para o endpoint e clique em OK.

        Nota

        O prefixo do endpoint deve atender aos seguintes requisitos:

        • Deve ter entre 6 e 40 caracteres e conter apenas letras minúsculas, dígitos e hifens (-).

        • Deve começar com uma letra e terminar com uma letra ou um dígito.

    Próximas etapas

    Connect to a PolarDB for PostgreSQL cluster

    APIs relacionadas

    API

    Descrição

    DescribeDBClusterEndpoints

    Consulta as informações de endpoint de um cluster.

    CreateDBEndpointAddress

    Cria um endpoint público para um cluster.

    ModifyDBEndpointAddress

    Modifica o endpoint de um cluster.

    DeleteDBEndpointAddress

    Exclui um endpoint público de um cluster.