Pular para o conteúdo principal
Versão 4.0

Configuração dos Parâmetros do Pool de Conexões

Pré-Requisitos
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
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

Os parâmetros específicos de cada Pool de Conexões podem ser visualizados ou configurados das seguintes formas:

  • Ao listar os Pools de Conexões existentes.

  • Durante a criação dum novo Pool, com a opção de definir os seus parâmetros no momento da criação.

  • Ao editar um Pool, com a opção de ajustar os parâmetros conforme necessário.

Consulta de Parâmetros do Pool​

  1. Selecione o Agente do PgSmart pretendido ou Registar um novo Agente.

1.1. Selecione Pools de Conexão no menu de opções.

1.2. Selecione Listar.

  • Serão apresentados os Pools existentes com seus parâmetros default e definidos pelo usuário.

  • Para localizar um parâmetro, introduza o nome (completo ou parcial) ou qualquer conjunto de caracteres relacionados. A busca não diferencia maiúsculas/minúsculas.

  • Para ver os detalhes do parâmetro, pressione <ENTER>.

nota

  • Os parâmetros são agrupados por seção.

  • Cada parâmetro possui uma origem de valor, que diz respeito a localização onde se origina o valor:

    • default: valor padrão (não modificado).
    • pool: configurado especificamente para o Pool.

Exemplos:

─── [ pool1 ] ─── (pool) host = 192.168.56.238 (default) min_pool_size = (disabled)

─── [ pool32 ] ─── (pool) auth_user = user2 (default) min_pool_size = (enabled)

alerta
  • Parâmetros a azul são obrigatórios para o funcionamento do serviço.
  • Parâmetros a vermelho indicam inconsistências e devem ser corrigidos.
nota

  • Os parâmetros são descritos com base nas suas principais características:

    • Nome
    • Tipo (integer, boolean, string, size, list, list_kv)
    • Valor actual
    • Origem do valor
    • Valor por omissão
    • Grupo funcional (ex.: Autenticação, Timeouts, TLS)
    • Seções aplicáveis (ex.: PgBouncer)
    • Valores possíveis
    • Obrigatório?
    • Requer reinicialização?
    • Só leitura?
    • Descrição
    • Notas adicionais / exemplos
Figura 1 - Parâmetros do Pool - Consulta
Figura 1 - Parâmetros do Pool - Consulta

Edição dos Parâmetros do Pool​

  1. Selecione o Agente do PgSmart pretendido ou Registar um novo Agente.

1.1. Selecione Pools de Conexão no menu de opções.

1.2. Selecione Editar.

1.3. Selecione um Pool de Conexões.

1.3.1. Ajuste as informações do Pool:

  • Nome do Pool a que as aplicações/clientes se conectarão.
  • Tipo de conexão à base de dados.
  • Hostname ou IP da instância PostgreSQL.
  • Versão majoritária do PostgreSQL.
  • Base de dados (opcional para Unix Socket ou AutoDB).

1.4. Confirme a necessidade de editar os parâmetros avançados (os valores default serão sobrescritos):

  • Usuário de conexão (user): (Opcional)
  • Palavra-passe do usuário de conexão: (Opcional)
  • Usuário de autenticação (auth_user): (Opcional)
  • Tamanho máximo do Pool (pool_size): (Opcional)
  • Conexões reservadas (reserve_pool): (Opcional)
  • Consulta após conexão (connect_query): (Opcional)
  • Modo de reutilização (pool_mode): (Opcional)
  • Número máximo de conexões (max_db_connections): (Opcional)
  • Codificação (client_encoding): (Opcional)
  • Estilo de datas (datestyle): (Opcional)
  • Fuso horário (timezone): (Opcional)

1.5. Confirme a operação.

1.6. Confirme o Reload do serviço do Pool de Conexões.

Figura 2 - Parâmetros do Pool - Edição
Figura 2 - Parâmetros do Pool - Edição
Notas Finais
nota

  • Consoante o parâmetro modificado, poderá ser necessário efectuar um RELOAD ou RESTART da instância. O PgSmart indicará a ação necessária.

  • Se o Reload ou Restart não for confirmado, a alteração permanecerá no ficheiro até ser aplicada.