Pular para o conteúdo principal
Versão 3.1.1

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 requisições futuras às bases de dados forem solicitadas.

Para viabilizar 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 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 visto no log do PgSmart Client. Usada em conjunto com a opção --agent.
Configuração Não-Interativa

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

Configuração Interativa
Terminal input
pgsmart pool config

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

  2. Escolha a Seção Pools de Conexão(a seleção é feita com a tecla [spaces]).

    Ao selecionar a seção Pools de Conexão, as seguintes operações são disponibilizadas:

  • Listar os Pools de Conexão já configurados.
  • Criar um Pool de Conexões.
  • Editar um Pool de Conexões.
  • Remover um Pool de Conexões.

Listar os pools de Conexão já configurados​

  1. Escolha a operação Listar.
Figura 1 - Configuração - Pool de Conexões - lista
Figura 1 - Configuração - Pool de Conexões - lista
nota

Será apresentada a lista de Pools de Conexão configurados.

Criar um pool de Conexões​

  1. Escolha a opção Criar.

  2. Indique o nome do pool no qual as aplicações/clientes irão se conectar. (o "*" indica que, se não existir um Pool no momento da conexão com a Base de Dados com o nome indicado, o Pool a ser utilizado é um "padrão" já existente no PgBouncer).

  3. Indique o tipo de conexão.

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

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

  6. Escolha a Versão Majoritária do PostgreSQL ou o Diretório de Dados (o que for pedido).

  7. Indique o nome da Base de Dados.

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

    No caso de confirmada a necessidade de adicionar parâmetros avançados:

    8.1. Indique o Usuário de conexão a Base de Dados (user). [opcional].

    8.2. Indique o Usuário utilizado para consultar na instância PostgreSQL (auth_user). [opcional].

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

    8.4. Indique a quantidade de conexões adicionais reservadas (reserved_pool) [opcional].

    8.5. Indique a consulta (entre aspas simples) a ser executada após a conexão a Base de Dados ser estabilizada (connect_query) [opcional].

    8.6. Escolha o modo de reuso das conexões (pool_mode) [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 a ser utilizada na conexão (client_encoding). [opcional].

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

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

  9. Confirme a criação do Pool de Conexões.

    nota

    Parâmetros não informados têm seus valores assumidos com base nos Parâmetros Globais, cujos valores são adotados como "default".

    nota

    • Ao finalizar a criação, o PgSmart oferece um exemplo de comando para testar a conexão e uma série de recomendações.

    • Para testar a conexão, execute o comando:

      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. Escolha a opção Editar.

    nota

    Ao selecionar esta ação, o PgSmart oferecerá uma listagem com os Pools já configurados.

  2. Escolha o Pool configurado que deseja alterar e ajustar.

  3. Indique o nome do pool no qual as aplicações/Clientes irão se conectar (Default: pool1).

  4. Escolha o tipo de conexão.

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

  6. Indique a porta da instãncia PostgreSQL [Default:5432].

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

  8. Indique o nome da Base de Dados (opcional para Unix Socket ou AutoDB).

  9. Confirme a edição dos parâmetros avançados para esse Pool (os parâmetros default serão sobrescritos).

    No caso de confirmada a necessidade de adicionar parâmetros avançados:

    9.1. Indique o Usuário de conexão a Base 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 a Base 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. Escolha 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 na Base 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 informados têm seus valores assumidos com base nos Parâmetros Globais, cujos valores são adotados como "default".

  10. 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. Escolha a operação Remover.

    nota

    Ao selecionar esta ação, o PgSmart oferecerá uma listagem com os Pools já configurados.

  2. Escolha o Pool configurado que deseja remover.

  3. Confirme a Exclusão do Pool de Conexões.

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