Pular para o conteúdo principal
Versão Next

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

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
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

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 de um novo Pool de Conexões, com a opção de definir seus parâmetros no momento da criação.

  • Ao editar um Pool de Conexões, com a opção de alterar seus parâmetros conforme necessário.

    Consulta Parâmetros Pool​

    1. Selecione o Agente do PgSmart desejado ou Registrar um novo Agente.

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

      1.2. Selecione Listar

      • Serão exibidos os Pools de Conexão existentes com seus parâmetros default e configurados pelo cliente.

      • Para localizar um parâmetro na lista, digite seu nome completo, parcial ou qualquer conjunto de caracteres relacionados ao valor ou à seção desejada. A busca não diferencia maiúsculas de minúsculas (case insensitive).

      • Para visualizar detalhes do parâmetro, clique <ENTER> no parâmetro desejado.

        nota

        • Os parâmetros de Pools de Conexão são agrupados por seção:

        • Cada parâmetro é identificado por sua origem de valores, que diz respeito a localização onde se origina o valor:

        • default: parâmetros que permanecem com os valores padrão, sem intervenção do usuário.

        • pool : parâmetros configurados 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 na cor azul são obrigatórios e essenciais para o funcionamento do serviço.
        • parâmetros em vermelho estão inconsistentes no arquivo de configuração e devem ser corrigidos.
        nota

        • Os parâmetros do pool de conexões são descritos com base em suas principais características, que ajudam a entender seu comportamento e restrições.

        • Cada parâmetro é documentado de forma completa para garantir que o usuário saiba como configurá-lo corretamente com as seguintes informações (desde que aplicáveis):

          • Nome: Nome do parâmetro.

          • Tipo: Define o tipo de dado aceito (ex.: integer, boolean, string, size, list, list_kv).

          • Valor Corrente: Valor atualmente configurado.

          • Origem do Valor: Fonte que definiu o valor (ex.: default, global).

          • Valor Padrão: Valor assumido se nenhum outro for configurado.

          • Grupo: Categoria funcional do parâmetro (ex.: Configurações de Autenticação, Timeouts, Configurações TLS, etc. ).

          • Seções: Contextos onde o parâmetro pode ser usado (pgbouncer).

          • Valores possíveis: Lista de valores aceitáveis.

          • Obrigatório?: Informa se o parâmetro é mandatório.

          • Requer Reinicialização?: Se mudanças exigem reinicializar o serviço.

          • Somente Leitura?: Indica se o valor pode ou não ser alterado depois da configuração inicial.

          • Descrição: Explicação resumida da função do parâmetro.

          • Descrição Complementar: Informações adicionais, exemplos ou observações importantes.

        Figura 1 - Configuração de Parâmetros Globais de pool - Consulta
        Figura 1 - Configuração de Parâmetros Globais de pool - Consulta

    Edição Parâmetros Pool​

    1. Selecione o Agente do PgSmart desejado ou Registrar 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 de Conexões conforme sua necessidade:

      • Nome do Pool no qual as aplicações/clientes irão se conectar.
      • Tipo da conexão ao banco de dados.
      • Hostname ou IP de conexão da instância PostgreSQL.
      • Versão majoritária do PostgreSQL
      • Banco de dados: (Opcional para Unix Socket ou AutoDB (*).

      1.4. Confirme a necessidade de Edição dos parâmetros avançados para esse Pool (Parâmetros default serão sobrescritos).

      • Usuário de conexão ao banco de dados (user): (Opcional)
      • Senha do usuário de conexão ao banco de dados: (Opcional)
      • Usuário utilizado para consultar na instância PostgreSQL os usuários não especificados no arquivo de autenticação (auth_user): (Opcional)
      • Tamanho máximo do Pool (pool_size): (Opcional)
      • Quantidade de conexões adicionais reservadas (reserve_pool): (Opcional)
      • Consulta a ser executada após a conexão ao banco de dados ser estabilizada (connect_query): (Opcional)
      • Modo de reuso das conexões (pool_mode): (Opcional)
      • Numero máximo de conexões no banco de dados (max_db_connections): (Opcional)
      • Codificação de caracteres a ser utilizada na conexão (client_encoding): (Opcional)
      • Estilo da data a ser utilizada na conexão (datestyle): (Opcional)
      • Fuso horário a ser utilizado na conexão (timezone): (Opcional)

      1.5. Confirme a Operação.

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

      Figura 2 - Configuração de Parâmetros Globais de pool - Consulta
      Figura 2 - Configuração de Parâmetros Globais de pool - Consulta
Notas Finais
nota

  • Conforme o parâmetro modificado, pode ser necessário o RELOAD ou então o RESTART da instância. O PgSmart irá informar qual ação é necessária para efetivar a mudança do parâmetro.

  • Caso o Reload ou Restart não seja confirmado, a configuração permanecerá no arquivo até que a ação necessária seja realizada.