PolarDB:Configurar o PolarProxy

Escopo de aplicação

Atualmente, os clusters do PolarDB for PostgreSQL Distributed Edition não suportam a configuração do PolarProxy.

Criar um endpoint de cluster personalizado

1. Para começar, acesse o console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a Region onde o cluster está implantado e, em seguida, clique no ID do cluster para acessar a página de detalhes do cluster.

2. Na página Basic Information, na seção Database Connections, clique em Create Custom Cluster Endpoint.

3. Na caixa de diálogo Create Custom Cluster Endpoint, configure os seguintes parâmetros.

   Parâmetro		Descrição
   Network Information		Por padrão, o PolarDB fornece um endpoint privado para cada endpoint de cluster. Caso você modifique o endpoint ou solicite um endpoint público, consulte Modify an endpoint e Apply for an endpoint.
   Cluster Settings	Read/Write	O modo de leitura e gravação deste endpoint. As opções válidas são Read-only e Read/Write (Automatic Read/Write Splitting). Nota É possível que você modifique o modo de leitura e gravação após a criação do endpoint de cluster personalizado. O novo modo entra em vigor apenas para novas conexões. As conexões existentes mantêm o modo original.
   	Endpoint Name	Neste campo, insira um nome para o endpoint de cluster.
   Node Settings	Available Nodes e Selected Nodes	Na caixa Available Nodes à esquerda, selecione os nós que deseja adicionar a este endpoint para processar solicitações de leitura e, em seguida, clique no ícone para movê-los para a caixa Selected Nodes à direita. Nota O Available Nodes inclui o nó primário e todos os nós somente leitura. Selecionar nós não afeta o modo de leitura e gravação. Quando o modo é Read/Write (Automatic Read/Write Splitting), o PolarDB envia as solicitações de gravação apenas para o nó primário, independentemente de o nó primário estar selecionado. O PolarDB permite que você crie um endpoint de cluster com apenas um nó. No entanto, quando o modo é Read-only, não é possível que você crie um endpoint de cluster de nó único contendo apenas o nó primário.
   	Automatically Associate New Nodes	Define se novos nós são adicionados automaticamente a este endpoint.
   Load Balancing Settings	Load Balancing Policy	Quando o modo é Read-only, esta é a política de distribuição de solicitações de leitura entre vários nós. As opções válidas são Connections-based Load Balancing e Active Request-based Load Balancing. Quando o modo é Read/Write (Automatic Read/Write Splitting), esta é a política de distribuição de solicitações de leitura entre vários nós. O padrão é Active Request-based Load Balancing e não é possível alterá-la.
   	Primary Node Accepts Read Requests	Para reduzir a carga no nó primário e garantir sua estabilidade, ative este recurso, pois o sistema envia instruções SQL de consulta apenas para os nós somente leitura. Para obter mais informações sobre a proteção do nó primário, consulte Read/write splitting. Nota Esta configuração é compatível apenas com o modo Read/Write (Automatic Read/Write Splitting).
   	Transaction Splitting	Use esta opção para que você ative ou desative a divisão de transações. Para obter mais informações sobre a divisão de transações, consulte Transaction splitting. Nota Esta configuração é compatível apenas quando o modo é Read/Write (Automatic Read/Write Splitting).
   Consistency Settings	Consistency Level	Quando o modo é Read/Write (Automatic Read/Write Splitting), os níveis de consistência válidos são Eventual Consistency (Weak), Session Consistency (Medium) e Global Consistency (Strong). Para obter mais informações, consulte Consistency levels. Quando o modo é Read-only, o nível de consistência padrão é Eventual Consistency (Weak) e não é possível alterá-lo. Nota Uma alteração no nível de consistência entra em vigor imediatamente para todas as conexões. A Global Consistency (Strong) é compatível com as edições PolarDB for PostgreSQL PostgreSQL 14, e a versão secundária do kernel deve ser 2.0.14.11.22.0 ou posterior. Para obter mais informações sobre este recurso, consulte Global consistency.
   	Global Consistency Timeout	O tempo limite de espera para a sincronização dos nós somente leitura com os dados mais recentes para garantir a consistência. Valores válidos: 1 a 1.000.000. Unidade: ms. Valor padrão: 100. Nota Esta configuração é compatível apenas quando o Consistency Level é Global Consistency (Strong).
   	Global Consistency Timeout Policy	A política executada quando a espera por um nó somente leitura atinge o tempo limite. Valores válidos: Send Requests to Primary Node (Default). Return Error Messages Due to Timeout Automatic Downgrade to Inconsistent Read Due to Timeout Nota Esta configuração é compatível apenas quando o Consistency Level é Global Consistency (Strong).
   Connection Pool Settings	Connection Pool	Selecione Off (padrão) ou Transaction-level. Use o pool de conexões no nível de transação de acordo com os requisitos do seu negócio para ajudar a reduzir a carga do banco de dados gerada por um grande número de conexões. Para obter mais informações, consulte Transaction-level connection pool.

4. Por fim, clique em OK.

Modificar um endpoint de cluster

1. Para começar, acesse o console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a Region onde o cluster está implantado e, em seguida, clique no ID do cluster para acessar a página de detalhes do cluster.

2. Na página Basic Information, na seção Database Connections, localize o endpoint de cluster de destino e clique em Configure à direita do endpoint.

3. Na caixa de diálogo Modify Endpoint Settings, configure os parâmetros relacionados.

4. Por fim, clique em OK.

Liberar um endpoint de cluster personalizado

1. Para começar, acesse o console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a Region onde o cluster está implantado e, em seguida, clique no ID do cluster para acessar a página de detalhes do cluster.

2. Na página Basic Information, na seção Database Connections, localize o endpoint de cluster personalizado de destino e clique em Release à direita do endpoint.

3. Na caixa de diálogo exibida, clique em OK.