Configuração dos Parâmetros de Usuários Autorizados do Pool de Conexões

Pré-Requisitos

• PostgreSQL instalado.

• PgBouncer instalado.

• Pool criado e inicializado.

• Usuários Autorizados.

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 Grupos de Usuários autorizados podem ser visualizados ou configurados das seguintes formas:

• Ao listar os perfis de Usuários Autorizados de Conexões existentes.

• Durante a criação de um novo perfil de Usuários Autorizados, com a opção de definir seus parâmetros no momento da criação.

• Ao editar um perfil de Usuários Autorizados, com a opção de alterar seus parâmetros conforme necessário.

  Consulta Parâmetro

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

     1.1. Selecione Usuários Autorizados no menu de opções.

     1.2. Selecione Listar

     • Os parâmetros de usuários autorizados default e aqueles configurados pelo usuário serão exibidos.

     • 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 Usuários Autorizados 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.

       • user : parâmetros configurados especificamente para o o grupo de usuários autorizados.

         • Exemplos:

                   ─── [ postgres ] ───
                   (user)    max_user_connections = 3
                   (default) pool_size = 20
           
                   ─── [ usu2 ] ───
                   (user)    max_user_connections = 10
                   (default) pool_size = 20
           

     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 de usuários autorizados 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 Usuários Autorizados - Consulta

  Vídeo

  Carregando...
  Edição de Parâmetro

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

     1.1. Selecione Usuários Autorizados no menu de opções.

     1.2. Selecione Editar

     1.3. Selecione o Usuário para o qual deseja configurar os parâmetros.

     1.4. Atualize os parâmetros de Usuários Autorizados.

     • Usuário de conexão ao banco de dados.
     • Senha do usuário de conexão ao banco de dados:
     • Modo de reuso das conexões desse usuário: (Opcional)
     • Numero máximo de conexões desse usuário nos Pools: (Opcional)

     1.5. Confirme a operação.

     1.6. Confirme a reinicialização, se for solicitado.

     

     Figura 2 - Configuração de Parâmetros de Usuários Autorizados - Edição

  Vídeo

  Carregando...

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.