Todos os produtos
Search
Central de documentação

PolarDB:Visualize or apply for an endpoint

Última atualização: Sep 20, 2026

Ao se conectar a um cluster PolarDB, é necessário fornecer um endpoint para o cluster PolarDB. O PolarDB oferece endpoints privados e públicos para endpoints de cluster e endpoints primários. Este tópico descreve como visualize e solicite endpoints no console.

Endpoints

image

Tipo

Descrição

Tipo de rede

Endpoint de cluster (recomendado)

  • Cada cluster inclui um endpoint de cluster padrão. O service para este endpoint é fornecido por PolarProxy.

  • O endpoint de cluster padrão oferece suporte à divisão automática de leitura e gravação. O endpoint roteia solicitações de gravação para o nó primário e solicitações de leitura para os nós somente leitura.

  • Privado

  • Público

Endpoint primário

Cada cluster PolarDB possui apenas um endpoint primário. O endpoint primário tem as seguintes características:

  • Ele sempre se conecta ao nó primário e oferece suporte a operações de leitura e gravação.

  • Se o nó primário falhar, o endpoint primário realizará o failover automaticamente para o novo nó primário.

Endpoint personalizado

  • Crie até cinco endpoints personalizados adicionais. Os services para esses endpoints também são fornecidos por PolarProxy.

  • Configure o modo de leitura/gravação e as políticas de balanceamento de carga para um endpoint personalizado, a fim de implementar a divisão de leitura e gravação ou oferecer suporte a cargas de trabalho somente leitura.

  • Um endpoint personalizado deve ser associado a pelo menos um nó somente leitura. As solicitações enviadas para esse endpoint são roteadas apenas para os nós associados.

Nota

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

Endpoints privados e públicos

Tipo de rede

Descrição

Casos de uso

Privado

  • Um endpoint privado oferece o melhor desempenho para o PolarDB.

  • Um endpoint privado é criado por padrão ao criar um cluster. Você pode modify este endpoint, mas não pode liberá-lo.

Exemplos:

  • Se uma instância ECS e o cluster de banco de dados estiverem na mesma VPC, a instância ECS poderá acessar o cluster de banco de dados usando um endpoint privado.

  • Acesso a um cluster de banco de dados usando o Data Management (DMS).

Público

  • Você pode apply for ou release um endpoint público.

  • Os endpoints públicos se conectam pela internet. O acesso pela internet não fornece o desempenho ideal do PolarDB.

Por exemplo, é possível acessar um cluster de banco de dados pela internet para manutenção.

Visualize endpoints e portas

  1. Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters, selecione a região onde o cluster está localizado e, em seguida, clique no ID do cluster para abrir a página de detalhes do cluster.

  2. Na página Basic Information, na seção Database Connections, passe o mouse sobre um endpoint de destino para visualizar suas Network Information, incluindo o endpoint e a porta, em uma dica de ferramenta. A seção Database Connection exibe o endpoint privado (por exemplo, pc-xxx.polardb.rds.aliyuncs.com) e a porta (por exemplo, 1521). Um endpoint público não é ativado por padrão. Clique em Apply e crie um. A seção Database Connection contém dois tipos de endpoints: Primary Endpoint e Cluster Endpoint (Recommended). O modo padrão para o endpoint de cluster é Read/Write (Automatic Read/Write Splitting). Cada tipo de endpoint exibe seu endpoint privado, endpoint público e EndpointId. Você também pode clicar em Crie Endpoint Personalizado para adicionar um novo endpoint personalizado.

Nota

Se você se conectou anteriormente ao seu banco de dados usando um nome de domínio e deseja continuar usando-o após a migração para a cloud, clique em More > Bind Private Domain Name. Somente endpoints Private podem ser vinculados a um private domain name.

Solicitar um endpoint público

  1. Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters, selecione a região onde o cluster está localizado e, em seguida, clique no ID do cluster para abrir a página de detalhes do cluster.

  2. Na página Basic Information, na seção Database Connections, na linha do endpoint desejado, clique em Apply na coluna Internet.

    Nota

    Você pode solicitar apenas um endpoint Internet. Um endpoint Internal Network é criado automaticamente ao criar um cluster ou um endpoint personalizado, portanto, não é necessário solicitar um.

  3. Na caixa de diálogo, defina o prefixo do endpoint e clique em OK.

    Nota

    O prefixo do endpoint deve atender aos seguintes requisitos:

    • Deve ter de 6 a 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 database cluster

APIs relacionadas

API

Descrição

CreateDBEndpointAddress

Cria um endpoint público para o endpoint primário, de cluster padrão ou personalizado de um cluster PolarDB.

DescribeDBClusterEndpoints

Recupera as informações de endpoint de um cluster PolarDB.