Configuração do pool de Conexões
Sintaxe do Comando
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 interativa
pgsmart backup config
Configuração dos pools de Conexões
-
Selecione o Agente do PgSmart ou registre um novo.
-
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ão já configurados
-
Selecione a operação "Listar"
Será apresentada a lista de pools de Conexão configurados. |
Criar um pool de Conexões
-
Selecione a opção "Criar"
-
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).
-
Informe o tipo de conexão.
-
Informe o IP de conexão da instância PostgreSYS [Default:localhost]
-
Informe a Porta de conexão da instância PostgreSQL.
-
Selecione a versão majoritária do PostgreSQL ou o Diretório de Dados (o que for pedido).
-
Informe o nome do banco de dados.
-
Confirme 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:
-
Informe o Usuário de conexão ao banco de dados (user). [opcional]
-
Informe o Usuário utilizado para consultar na instância PostgreSQL (auth_user). [opcional]
-
Informe o tamanho máximo do pool (pool_size). [opcional]
-
Informe a quantidade de conexões adicionais reservadas (reserved_pool) [opcional].
-
Informe a consulta (entre aspas simples) a ser executada após a conexão ao banco de dados ser estabilizada (connect_query) [opcional]
-
Selecione o modo de reuso das conexões (pool_mode) [opcional].
-
Informe o número máximo de conexões no banco de dados (max_db_connections). [opcional]
-
Informe a codificação de caracteres a ser utilizada na conexão (client_encoding). [opcional]
-
Informe o estilo da data a ser utilizada na conexão (datestyle). [opcional]
-
Informe o fuso horário a ser utilizado na conexão (timezone). [opcional]
-
Confirme 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
Editar um pool de Conexões
-
Selecione a opção "Editar"
Ao selecionar esta ação, o PgSmart oferecerá uma listagem com os pools já configurados. |
-
Selecione o pool configurado que deseja alterar e ajustar.
-
Informe o Nome do pool no qual as aplicações/Clientes irão se conectar (Default: pool1)
-
Selecionar o tipo de conexão.
-
Informe o IP/hostname da instância PostgreSYS [Default: localhost]
-
Informe a porta da instãncia PostgreSYS [Default:5432]
-
Selecione a versão majoritária da instância PostgreSQL.
-
Informe o nome do banco de dados (opcional para Unix Socket ou AutoDB)
-
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:
-
Informe 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.
-
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.
-
Informe o tamanho máximo do pool (pool_size). [opcional]. Número máximo de conexões do pool.
-
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.
-
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.
-
Selecione 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).
-
Informe o número máximo de conexões no banco de dados (max_db_connections). [opcional]
-
Informe a codificação de caracteres a ser utilizada na conexão (client_encoding). [opcional]
-
Informe o estilo da data a ser utilizada na conexão (datestyle). [opcional]
-
Informe 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". |
-
Confirme a Edição do pool de Conexões.