Pular para o conteúdo principal
Versão 4.1.0

Configuração do Pool de Conexões

Um pool de conexões é um conjunto de conexões ad-hoc para acesso às bases de dados, mantido de forma que as conexões possam ser reutilizadas quando novas requisições forem realizadas.

Para possibilitar esta operação, o PgSmart integra-se com o PgBouncer.

Sintaxe do Comando
Terminal input
    pgsmart pool config [Flags]

Flags:​

  • -a, --agent=<agent> => Alias, hostname ou endereço IP do servidor onde o PgSmart Agent pretendido está instalado.
  • -h, --help => Ajuda.
  • -q, --quiet => Execução não interativa para controlo do serviço do componente (status|start|stop|restart|reload). O resultado da operação poderá ser visualizado no log do PgSmart Client. Utilizado em conjunto com a opção --agent.
Configuração Não Interativa

A execução não interativa está desativada para esta operação.

Configuração Interativa
Terminal input
    pgsmart pool config

  1. Selecione o Agente do PgSmart (ou Registar novo Agente).

  2. Selecione a seção Pools de Conexão (seleção feita com a tecla [space]).

Ao Selecionar a seção Pools de Conexão, as seguintes operações estarão disponíveis:

  • Listar os pools de conexões já configurados
  • Criar um novo pool de conexões
  • Editar um pool de conexões
  • Remover um pool de conexões

Listar os Pools de Conexão Configurados​

  1. Selecione a operação Listar.

    Figura 1 - Configuração - Pool de Conexões - Listagem
    Figura 1 - Configuração - Pool de Conexões - Listagem
nota

Será apresentada a lista dos pools de conexão configurados.

Criar um Pool de Conexões​

  1. Selecione a opção Criar.

  2. Indique o nome do pool que as aplicações/clientes irão utilizar. ("*" indica que, se não existir pool com o nome indicado, será utilizado o pool padrão existente no PgBouncer).

  3. Indique o tipo de conexão.

  4. Indique o IP de conexão da instância PostgreSQL [Predefinição: localhost].

  5. Indique a Porta de conexão da instância PostgreSQL.

  6. Selecione a Versão Majoritária do PostgreSQL ou o Diretório de Dados.

  7. Indique o Nome da base de dados.

  8. Confirme se deseja adicionar parâmetros avançados para o pool (os parâmetros padrão serão sobrescritos).

Se confirmado:

8.1. Indique o Usuário de conexão [opcional].

8.2. Indique o Usuário de autenticação (auth_user) [opcional].

8.3. Indique o Tamanho máximo do pool (pool_size) [opcional].

8.4. Indique o Número de conexões reservadas (reserved_pool) [opcional].

8.5. Indique a Consulta a executar após estabilizar a conexão (connect_query) [opcional].

8.6. Selecione o Modo de reutilização das conexões [opcional].

8.7. Indique o Número máximo de conexões na base de dados (max_db_connections) [opcional].

8.8. Indique a Codificação de caracteres (client_encoding) [opcional].

8.9. Indique o Estilo de datas (datestyle) [opcional].

8.10. Indique o Fuso horário (timezone) [opcional].

  1. Confirme a criação do pool de conexões.
nota

Parâmetros não fornecidos assumirão valores definidos nos Parâmetros Globais.

nota

  • Após a criação, o PgSmart disponibiliza um exemplo de teste e recomendações.

  • Para testar a conexão, execute:

Terminal input
    psql -U <Usuário> -h <Endereço-IP> -p 6432 apppool
Figura 2 - Configuração - Pool de Conexões - Criação
Figura 2 - Configuração - Pool de Conexões - Criação

Editar um Pool de Conexões​

  1. Selecione a opção Editar.

    nota

    O PgSmart apresentará a lista de pools já configurados.

  2. Selecione o Pool configurado que deseja alterar.

  3. Indique o Nome do pool (Predefinição: pool1).

  4. Selecione o tipo de conexão.

  5. Indique o IP/hostname da instância PostgreSQL [Predefinição: localhost].

  6. Indique a porta da instância PostgreSQL [Predefinição: 5432].

  7. Selecione a Versão Majoritária da instância.

  8. Indique o Nome da base de dados (opcional).

  9. Confirme a edição de parâmetros avançados.

Se confirmado:

9.1. Indique o Usuário de conexão do banco de dados (user). [opcional]. Se informado, exigirá que o usuário seja o informado. Caso não seja informado, qualquer usuário terá permissão.

9.2. Indique o Usuário utilizado para consultar na instância PostgreSQL (auth_user). [opcional]. Usuário que será utilizado para autenticação na instância. Se não informado e inexistir um usuário no ficheiro de autenticação, o PgSmart rejeitará a conexão.

9.3. Indique o tamanho máximo do pool (pool_size). [opcional]. Número máximo de conexões do pool.

9.4. Indique a quantidade de conexões adicionais reservadas (reserved_pool) [opcional]. Indica que, do número total de conexões, um volume indicado deverá ser reservado para um superusuário ou um usuário de manutenção.

9.5. Indique a consulta (entre aspas simples) a ser executada após a conexão ao banco de dados ser estabilizada (connect_query) [opcional]. Indica a consulta a ser utilizada para validar a conexão. Vazio indica o uso de uma consulta padrão.

9.6. Selecione o modo de reuso das conexões [opcional]. Caso nao seja informado, será adotado o Default, que é o "session" (ou aquele definido no Parâmetro Global, no caso de ter sido modificado).

9.7. Indique o número máximo de conexões no banco de dados (max_db_connections). [opcional].

9.8. Indique a codificação de caracteres a ser utilizada na conexão (client_encoding). [opcional].

9.9. Indique o estilo da data a ser utilizada na conexão (datestyle). [opcional].

9.10. Indique o fuso horário a ser utilizado na conexão (timezone). [opcional].

nota

Parâmetros não fornecidos assumirão valores definidos nos Parâmetros Globais.

  1. Confirme a edição do pool de conexões.

    Figura 3 - Configuração - Pool de Conexões - Edição
    Figura 3 - Configuração - Pool de Conexões - Edição

Remover um Pool de Conexões​

  1. Selecione a operação Remover.

    nota

    O PgSmart apresentará a lista de pools configurados.

  2. Selecione o Pool a ser removido.

  3. Confirme a remoção do pool.

    Figura 4 - Configuração - Pool de Conexões - Remoção
    Figura 4 - Configuração - Pool de Conexões - Remoção