Todos os produtos
Search
Central de documentação

PolarDB:Gerenciar endpoints

Última atualização: Jun 28, 2026

Conecte-se a um cluster PolarDB pelo endpoint de cluster ou pelo endpoint primário. No console, visualize, solicite, crie, modifique e libere endpoints.

Pré-requisitos

Obtenha as informações de conexão necessárias em Conectar-se a um cluster de banco de dados.

Visualizar endpoints e portas

  1. Faça login no console do PolarDB.

  2. No canto superior esquerdo, selecione a região onde o cluster está implantado.

  3. Localize o cluster desejado e clique em seu ID.

  4. Na página Basic Information, na seção Database Connections, passe o mouse sobre o endpoint desejado. A caixa de diálogo Network Information exibe o endpoint e o número da porta.

    A caixa de diálogo mostra endpoints privados e públicos. O endpoint primário conecta-se ao nó primário para operações de leitura e escrita. O endpoint de cluster [Recomendado] oferece suporte à separação de leitura e escrita. Clique em Create Custom Cluster Endpoint para adicionar um endpoint personalizado.

Nota
  • Para continuar usando um nome de domínio após a migração para a nuvem, clique em Bind Private Domain Name. Apenas endpoints Private permitem vincular domínios privados. Consulte Nomes de domínio privados.

  • A porta padrão dos endpoints do PolarDB for MySQL é 3306, mas você pode personalizá-la. Consulte Modificar um endpoint.

Solicitar endpoints públicos

  1. Faça login no console do PolarDB.

  2. No canto superior esquerdo, selecione a região onde o cluster está implantado.

  3. Localize o cluster desejado e clique em seu ID.

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

    Nota

    Solicite apenas endpoints Public. O sistema gera automaticamente o endpoint Private durante a criação do cluster.

  5. Na caixa de diálogo, insira um prefixo para o endpoint e clique em OK.

    Nota

    O prefixo do endpoint deve atender aos seguintes requisitos:

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

    • Começar com uma letra minúscula e terminar com uma letra ou dígito.

    O PolarProxy é ativado por padrão após a criação do endpoint de cluster. Ajuste as configurações em Configurar o PolarProxy.

Criar um endpoint personalizado

Na seção Database Connections da página Basic Information, clique em Create Custom Cluster Endpoint para criar um endpoint personalizado e configurar o PolarProxy. Consulte Configurar o PolarProxy.

Nota

A Cluster Edition do PolarDB for MySQL permite especificar uma VPC e um vSwitch ao criar um endpoint. Consulte Alterar a VPC e o vSwitch.

Modificar um endpoint

Na seção Database Connections da página Basic Information, localize o endpoint desejado. Ao lado do endereço Private ou Public, clique no ícone image e selecione Edit.

Importante
  • O prefixo do endpoint deve atender aos seguintes requisitos:

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

    • Começar com uma letra minúscula e terminar com uma letra ou dígito.

  • O número da porta deve estar no intervalo de 3000 a 5999.

  • Se a criptografia SSL estiver ativada, modificar o endpoint reinicia o cluster.

  • Com o SSL ativado, o endpoint modificado não pode exceder 64 caracteres.

Nota

A Cluster Edition do PolarDB for MySQL permite alterar a VPC e o vSwitch de um endpoint. Consulte Alterar a VPC e o vSwitch.

Liberar um endpoint

Importante
  • Antes de liberar um endpoint, certifique-se de que suas aplicações usem outro endpoint.

  • Não é possível recuperar um endpoint liberado. Solicite um novo clicando em Apply.

  • O endpoint de cluster padrão aceita apenas modificações; não é possível liberá-lo. Endpoints de cluster personalizados podem ser liberados.

Na seção Database Connections da página Basic Information, localize o endpoint desejado. Ao lado do endereço Public, clique no ícone image e selecione Release.

Nota

Libere apenas endpoints públicos.

Próximas etapas

Conectar-se a um cluster de banco de dados

Referência de API

API

Descrição

DescribeDBClusterEndpoints

Consulta os endpoints de um cluster.

CreateDBEndpointAddress

Cria um endpoint público para um cluster.

ModifyDBEndpointAddress

Modifica um endpoint de um cluster.

DeleteDBEndpointAddress

Exclui um endpoint público de um cluster.