Toda instância do ApsaraDB RDS for PostgreSQL possui pelo menos um endpoint e um número de porta para conexões com o banco de dados. Os tipos de endpoint disponíveis variam conforme a edição do RDS. Para mais informações sobre como se conectar usando esses endpoints, consulte Connect to an ApsaraDB RDS for PostgreSQL instance.
RDS Basic Edition e RDS High-availability Edition: endpoint da instância e endpoint do proxy de banco de dados
RDS Cluster Edition: endpoint de leitura/gravação e endpoint somente leitura
RDS Basic Edition e RDS High-availability Edition
Tipos de endpoint
|
Tipo de endpoint |
Descrição |
|
Endpoint da instância |
Adequado para todos os cenários de conexão. Inclui um endpoint interno para acesso de baixa latência pela rede interna (por exemplo, a partir de uma instância ECS na mesma VPC) e um endpoint público para acesso pela Internet. |
|
Endpoint do proxy de banco de dados |
Disponível quando o recurso de proxy de banco de dados está ativado. Recomendamos usar este endpoint se o recurso estiver habilitado na instância, pois melhora o desempenho da divisão de leitura/gravação e reduz a carga na instância primária. Para mais detalhes, consulte What are database proxies?. |
Alterar o endpoint da instância e o número de porta
Pré-requisitos
Antes de começar, verifique se:
Uma lista de permissões de endereços IP está configurada para a instância. Para mais informações, consulte Configure an IP address whitelist
Um endpoint público foi solicitado, se necessário. Para mais informações, consulte Apply for or release a public endpoint
Procedimento
Acesse a página Instances. Na barra de navegação superior, selecione a região da instância RDS e clique em ID da instância.
No painel de navegação à esquerda, clique em Database Connection para visualizar os endpoints internos e públicos e os números de porta.
Na seção Database Connection, clique em Modify Endpoint.
Defina Connection Type como Internal Endpoint ou Public Endpoint. Modifique o prefixo do Endpoint e o número da Port e clique em OK.
O prefixo do endpoint deve ter de 8 a 64 caracteres e pode conter letras minúsculas, dígitos e hifens (-). Deve começar com uma letra minúscula. O número da porta deve estar no intervalo de 1000 a 5999. Se a instância RDS usar SSDs locais premium, não será possível alterar o número da porta.
Alterar o endpoint do proxy de banco de dados e o número de porta
Pré-requisitos
Antes de começar, verifique se:
O recurso de proxy de banco de dados está ativado. Para mais informações, consulte Enable the database proxy feature
Procedimento
Acesse a página Instances. Na barra de navegação superior, selecione a região da instância RDS e clique em ID da instância.
No painel de navegação à esquerda, clique em Database Proxy.
Na seção Connection Information, localize o endpoint do proxy de banco de dados e clique no ícone de edição à direita.
Modifique o prefixo do Endpoint e o número da Port e clique em OK.
O prefixo do endpoint do proxy de banco de dados deve ter de 1 a 40 caracteres e pode conter letras minúsculas, dígitos e hifens (-). Deve começar com uma letra minúscula. O número da porta deve estar no intervalo de 1000 a 5999. Não é possível alterar o valor de Endpoint Type.
Perguntas frequentes
Preciso atualizar minha aplicação após alterar um endpoint ou número de porta?
Sim. Atualize imediatamente o endpoint ou o número de porta na aplicação. Caso contrário, as conexões com a instância falharão.
As alterações de endpoint ou número de porta entram em vigor imediatamente? É necessário reiniciar?
As alterações têm efeito imediato. Não é necessário reiniciar a instância.
Posso reutilizar um endpoint após liberá-lo?
Sim. Após a alteração ou liberação de um endpoint, o endereço anterior fica disponível para outras instâncias RDS.
Um failover primário/secundário altera os endpoints?
Não. Os endpoints permanecem inalterados durante um failover primário/secundário. Apenas os endereços IP subjacentes mudam. A aplicação pode continuar se conectando pelos mesmos endpoints sem modificações.
RDS Cluster Edition
Uma instância RDS que executa a RDS Cluster Edition é denominada cluster RDS. Cada cluster oferece dois tipos de endpoint para diferentes padrões de acesso.
Tipos de endpoint
|
Tipo de endpoint |
Descrição |
|
Endpoint de leitura/gravação |
Um por cluster. Conecta-se exclusivamente ao nó primário. Durante um failover primário/secundário, o endpoint direciona automaticamente o tráfego para o novo nó primário. Consiste em um endpoint interno (gerado automaticamente na criação do cluster) e um endpoint público opcional. |
|
Endpoint somente leitura |
Um por cluster. Direciona o tráfego para um ou mais nós secundários. Permite adicionar e remover nós, além de ajustar pesos para balanceamento de carga. A quantidade de nós secundários sempre corresponde ao valor definido pelo usuário. Se um nó secundário falhar, ele será reconstruído automaticamente. Caso um nó secundário seja promovido a primário, um novo nó secundário é adicionado automaticamente ao endpoint somente leitura. |
Visualizar e gerenciar o endpoint de leitura/gravação
O endpoint de leitura/gravação consiste em endpoints internos e públicos. Um endpoint interno é gerado automaticamente durante a criação do cluster. Solicite um endpoint público conforme as necessidades do negócio.
Acesse a página Instances. Na barra de navegação superior, selecione a região da instância RDS e clique em ID da instância.
-
Na página Basic Information, localize a seção Database Connection em Instance Topology Management.
Visualizar o endpoint de leitura/gravação: Passe o mouse sobre o cartão Read/Write Mode para ver o endpoint na dica de ferramenta.
-
Alterar o endpoint de leitura/gravação ou solicitar um endpoint público: Clique em Edit e execute uma das ações abaixo:
Clique em Change Connection para modificar o endpoint interno e o número da porta.
Clique em Change VPC para trocar a VPC e o vSwitch.
Clique em Apply for para solicitar um endpoint público.
Alternativamente, clique em Apply for Public Endpoint para solicitar um endpoint público.
Visualizar e gerenciar o endpoint somente leitura
Acesse a página Instances. Na barra de navegação superior, selecione a região da instância RDS e clique em ID da instância.
Na página Basic Information, localize a seção Database Connection em Instance Topology Management. Execute as operações conforme necessário:
Criar um endpoint somente leitura
O cluster deve estar no estado Running. A criação de um endpoint somente leitura não afeta as solicitações de leitura e gravação existentes. Apenas um endpoint somente leitura é permitido por cluster. Um endpoint interno é gerado automaticamente para esse fim, fornecendo balanceamento de carga entre os nós secundários.
Clique em Add Endpoint.
Na caixa de diálogo, configure o Internal Endpoint Prefix, a Port, a VPC e o vSwitch. Adicione os nós secundários desejados e ajuste seus pesos.
Clique em OK.
Excluir um endpoint somente leitura
A exclusão de um endpoint somente leitura libera tanto seus endpoints internos quanto públicos e interrompe todas as conexões estabelecidas. As solicitações de leitura e gravação existentes no cluster não são afetadas.
No cartão Read-only Mode, clique em Delete.
Na mensagem de confirmação, clique em OK.
Visualizar o endpoint somente leitura
Passe o mouse sobre o cartão Read-only Mode para ver o endpoint somente leitura.
Adicionar ou remover nós
O cluster deve estar no estado Running. Pelo menos um nó deve permanecer no endpoint somente leitura. Alterações na configuração dos nós aplicam-se tanto aos endpoints internos quanto públicos do endpoint somente leitura.
Adicionar nós:
No cartão Read-only Mode, clique em Edit e selecione o nó a ser adicionado.
Clique no ícone de adição para incluir o nó.
Ajuste os pesos dos nós conforme necessário e clique em OK.
A adição de nós não afeta as conexões persistentes existentes. Novas conexões são distribuídas com base nos pesos atualizados.
Remover nós:
No cartão Read-only Mode, clique em Edit e selecione o nó a ser removido.
Clique no ícone de remoção e depois em OK.
A remoção de um nó causa indisponibilidade de aproximadamente 30 a 120 segundos para esse nó específico. As conexões com outros nós não são afetadas.
Ajustar pesos dos nós
O cluster deve estar no estado Running. Pelo menos um nó deve ter peso maior que 0. Alterações de peso aplicam-se tanto aos endpoints internos quanto públicos do endpoint somente leitura.
No cartão Read-only Mode, clique em Edit.
Ajuste os pesos dos nós na caixa de diálogo e clique em OK.
Conexões existentes não são afetadas. Somente novas conexões seguem a distribuição de pesos atualizada.
Perguntas frequentes
Por que nós com o mesmo peso apresentam uso diferente de CPU e memória?
O Server Load Balancer (SLB) distribui as conexões uniformemente entre os nós, mas o consumo de recursos de cada conexão individual varia. Quantidades idênticas de conexões não garantem uso idêntico de CPU ou memória.
O ajuste de pesos dos nós causa tempo de inatividade?
Não. As conexões existentes permanecem ativas. Apenas as novas conexões são roteadas conforme os pesos atualizados.
Posso definir o peso de todos os nós como 0?
Não. Pelo menos um nó deve ter peso maior que 0.
É possível remover todos os nós do endpoint somente leitura?
Não. Pelo menos um nó deve permanecer no endpoint somente leitura.
Referência de API
As seguintes operações de API estão disponíveis para gerenciar endpoints de instâncias do ApsaraDB RDS for PostgreSQL que executam a RDS Cluster Edition.
|
Operação |
Descrição |
|
Cria um endpoint |
|
|
Consulta endpoints |
|
|
Modifica o endereço de um endpoint |
|
|
Cria um endpoint público |
|
|
Libera um endpoint público |
|
|
Exclui um endpoint |
|
|
Modifica o peso de um endpoint |