Configurando o pool de Conexões

Sintaxe do Comando:

pgsmart pool config

Opções:

-b, --bin=bin [Default:PGBIN] Diretório de binários do PostgreSQL
-h, --help Ajuda

Configuração interativa

pgsmart backup config

Configurando pools de Conexões

Selecionar o agente do PgSmart (ou registrar novo Agente).

Selecionar 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: Permite visualizar os pools de conexão já existentes.
Criar: Permite criar um novo pool de conexão.
Editar: Permite editar um pool de conexão.
Remover: Permite remover um pool de conexão.

Listando os pools de Conexão já configurados

Selecionar a operação "Listar"

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

Criando um pool de Conexões

Selecionar a opção "Criar"

Informar 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).
Informar o tipo de conexão.
Informar o IP/hostname da instância PostgreSYS [Default:localhost]
Informar a porta da instãncia PostgreSYS [Default:5432]
Informar o diretório de instalação dos binários do PostgreSQL(PGBIN).
Informar o nome do banco de dados [opcional para Unix Socket ou AutoDB]. ("*" indica que qualquer conexão que "chegar" a qualquer "banco de dados" na instância será aceita).
Confirmar se deseja adicionar parâmetros avançados para esse pool (os parâmetros default serão sobrescritos). Para cada pool que está sendo montado, alguns limites podem ser determinados (número de conexões, quantidade de usuários, etc.). Caso não se adicione parãmetros, não haverá "limites" para o 'pool', ou seja, ele considerará os parâmetros de forma ilimitada.

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

Informar o Usuário de conexão ao banco de dados (user). [opcional]
Informar o Usuário utilizado para consultar na instância PostgreSQL (auth_user). [opcional]
Informar o tamanho máximo do pool (pool_size). [opcional]
Informar a quantidade de conexões adicionais reservadas (reserved_pool) [opcional].
Informar a consulta (entre aspas simples) a ser executada após a conexão ao banco de dados ser estabilizada (connect_query) [opcional]
Selecionar o modo de reuso das conexões (pool_mode) [opcional].
Informar o número máximo de conexões no banco de dados (max_db_connections). [opcional]
Informar a codificação de caracteres a ser utilizada na conexão (client_encoding). [opcional]
Informar o estilo da data a ser utilizada na conexão (datestyle). [opcional]
Informar o fuso horário a ser utilizado na conexão (timezone). [opcional]

dados de configuração do pool- parametros avançados

Confirmar a criação do pool de Conexões.

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

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:

 psql -U <Usuário> -h <endereço-IP> -p 6432 apppool

Editando um pool de Conexões

Selecionar a opção "Editar"

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

Selecionar o pool configurado que deseja alterar e ajustar.

Informar o Nome do pool no qual as aplicações/Clientes irão se conectar (Default: pool1)
Selecionar o tipo de conexão.
Informar o IP/hostname da instância PostgreSYS [Default: localhost]
Informar a porta da instãncia PostgreSYS [Default:5432]
Informar o nome do banco de dados (opcional para Unix Socket ou AutoDB)
Confirmar se 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:

Informar o usuário de conexão ao 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.
Informar 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.
Informar o tamanho máximo do pool (pool_size). [opcional]. Número máximo de conexões do pool.
Informar 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 um um usuário de manutenção.
Informar 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.
Selecionar o modo de reuso das conexões (pool_mode) [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).
Informar o número máximo de conexões no banco de dados (max_db_connections). [opcional]
Informar a codificação de caracteres a ser utilizada na conexão (client_encoding). [opcional]
Informar o estilo da data a ser utilizada na conexão (datestyle). [opcional]
Informar o fuso horário a ser utilizado na conexão (timezone). [opcional]

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

Confirmar a Edição do pool de Conexões.

Removendo um pool de Conexões

Selecionar a operação "Remover"

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

Selecionar o pool configurado que deseja remover.

Confirmar a Exclusão do pool de Conexões.