Pular para o conteúdo principal
Versão 4.0

Configuração dos Parâmetros Globais 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

Consulta de Parâmetros Globais​

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

1.1. Selecione Configurações Globais no menu de opções.

  • Serão apresentados os parâmetros globais default e os configurados pelo usuário.

  • Para localizar um parâmetro, digite o nome completo ou parcial, ou qualquer cadeia relacionada. A busca é insensível a maiúsculas/minúsculas.

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

nota

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

  • Cada parâmetro é identificado conforme a sua origem, ou seja, o local onde o valor foi definido:

    global: parâmetros configurados manualmente pelo usuário.
    default: parâmetros que mantêm os valores por defeito, sem intervenção do usuário.
    user: parâmetros definidos por usuários autorizados no Pool de Conexões.
    pool: parâmetros específicos de cada Pool de Conexões.

  • Exemplos:

    • Parâmetro global (aplica-se a todos os pools de conexão e grupos de usuários):

        ─── [ pgbouncer ] ───
            client_idle_timeout = (disabled)
        ─── [ pgbouncer ] ───
            (default) autodb_idle_timeout = 3600s
alerta
  • Parâmetros a azul são obrigatórios e essenciais para o funcionamento do serviço.
  • Parâmetros a vermelho indicam inconsistências no ficheiro de configuração e devem ser corrigidos.
nota

  • Cada parâmetro do pool de conexões é documentado com:

    • Nome
    • Tipo (integer, boolean, string, size, list, list_kv)
    • Valor Corrente
    • Origem do Valor
    • Valor Padrão
    • Grupo (ex.: Configurações de Autenticação, Timeouts, Configurações TLS)
    • Seções (ex.: pgbouncer)
    • Valores Possíveis
    • Obrigatório?
    • Requer Reinicialização?
    • Só Leitura?
    • Descrição
    • Descrição Complementar (exemplos, observações)
Figura 1 - Consulta de Parâmetros Globais do pool
Figura 1 - Consulta de Parâmetros Globais do pool
Figura 2 - Consulta de Parâmetros Globais do pool por filtro
Figura 2 - Consulta de Parâmetros Globais do pool por filtro

Edição de Parâmetros Globais​

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

1.1. Selecione Configurações Globais no menu de opções.

  • Serão apresentados os parâmetros globais default e os configurados.

1.2. Selecione o parâmetro pretendido e pressione <ENTER>.

  • Serão apresentados os detalhes do parâmetro.

1.3. Selecione Editar.

1.4. Ajuste a configuração conforme solicitado (varia consoante o tipo de parâmetro).

1.8. Confirme a operação.

1.9. Confirme a reinicialização, se solicitado.

nota
  • A configuração varia conforme o tipo:
    • boolean Ativar/desAtivar
    • string valor digitado
    • integer número dentro de um intervalo
    • lista valores separados por vírgulas
    • size em B, KB, MB, GB, TB, PB
    • time em ms, s, min, h, d, w
    • enum valor da lista
    • path caminho de ficheiro
alerta
  • Para modificar uma configuração existente, utilize a funcionalidade Editar Parâmetro.
Figura 3 - Edição de Parâmetro Global do pool
Figura 3 - Edição de Parâmetro Global do pool

Remoção de Parâmetros Globais​

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

1.1. Selecione Configurações Globais no menu.

  • Serão apresentados os parâmetros globais default e configurados.

1.2. Pressione <ENTER> no parâmetro pretendido para visualizar detalhes.

1.3. Selecione Remover.

1.4. Confirme a operação.

1.5. Confirme a reinicialização, se solicitado.

Figura 4 - Remoção de Parâmetro Global do pool
Figura 4 - Remoção de Parâmetro Global do pool
nota

Ao remover a configuração dum parâmetro, este voltará ao valor default.

Notas Finais
nota

  • Dependendo do parâmetro modificado, poderá ser necessário efectuar RELOAD ou RESTART. O PgSmart informará qual ação será necessária.

  • Se Reload ou Restart não forem confirmados, a configuração permanecerá pendente até à realização da ação.