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 aos bancos de dados, mantido de forma que as conexões possam ser reutilizadas quando requisições futuras ao banco 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 desejado está instalado.
  • -h, --help => Ajuda.
  • -q, --quiet => Execução não interativa para controle 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. Selecione o Agente do PgSmart (ou Registrar novo Agente).

  2. Selecione 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ões 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. Selecione 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. Selecione a opção Criar

  2. Informe 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 o banco de dados com o nome indicado, o pool a ser utilizado é um "padrão" já existente no PgBouncer).

  3. Informe o tipo de conexão.

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

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

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

  7. Informe o Nome do banco 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. Informe o Usuário de conexão do banco de dados (user). [opcional].

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

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

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

    8.5. Informe a consulta (entre aspas simples) a ser executada após a conexão ao banco de dados ser estabilizada (connect_query) [opcional].

    8.6. Selecione o modo de reuso das conexões [opcional].

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

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

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

    8.10. Informe 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. Selecione a opção Editar

    nota

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

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

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

  4. Selecione o tipo de conexão.

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

  6. Informe a porta da instância PostgreSQL [Default:5432].

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

  8. Informe o Nome do banco 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. Informe 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. Informe 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 arquivo de autenticação, o PgSmart rejeitará a conexão.

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

    9.4. Informe 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. Informe 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. Informe o número máximo de conexões no banco de dados (max_db_connections). [opcional].

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

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

    9.10. Informe 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. Selecione a operação Remover.

    nota

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

  2. Selecione 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