Pular para o conteúdo principal
Versão 4.1.0

Configuração dos Parâmetros da Instância de Banco de Dados.

Dada uma instância já criada (Inicialização do Banco de Dados), segue-se a configuração de seus parâmetros, ação que modifica os dados do arquivo postgresql.conf, presente no diretório do Banco de Dados.

Os parâmetros disponíveis para edição estão em conformidade com a versão do PostgreSQL instalada e selecionada.

Toda alteração realizada inclui uma linha de comentário no arquivo postgresql.conf com data e usuário que realizou a alteração.

Pré-Requisitos
Sintaxe do Comando
Terminal input
    pgsmart db config [Flags]

Flags​

  • -D, --pgdata=<path> [Default: data]. => Diretório de Dados da instância PostgreSQL.
  • -M, --pgversion=(11|12|13|14|15). => Versão majoritária do PostgreSQL.
  • -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 db config

Configuração dos Parâmetros do Banco de Dados​

Consulta Parâmetro​

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

    1.1. Selecione Configurações das instâncias no menu de opções.

    1.2. Selecione o Diretório de dados da instância PostgreSQL para o qual deseja configurar os Parâmetros.

    1.3. Selecione a opção Parâmetros.

    • Ao selecionar a opção Parâmetros, será exibida a lista de parâmetros configuráveis.

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

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

    nota

    • Os parâmetros são agrupados por seção. No caso dos parâmetros de banco de dados, todos pertencem à seção global, ou seja, possuem abrangência global.

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

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

      • global: parâmetros configurados manualmente pelo usuário.
      • default: parâmetros que permanecem com os valores padrão, sem intervenção do usuário.
      • auto (automático, vindo do arquivo postgresql.auto.conf).
    Figura 1 - Configuração de Parâmetros do Banco de Dados - Consulta
    Figura 1 - Configuração de Parâmetros do Banco de Dados - Consulta
    Figura 2 - Configuração de Parâmetros do Banco de Dados - Consulta parâmetro por filtro
    Figura 2 - Configuração de Parâmetros do Banco de Dados - Consulta parâmetro por filtro

Edição Parâmetro​

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

    1.1. Selecione Configurações das instâncias no menu de opções.

    1.2. Selecione o Diretório de dados da instância PostgreSQL para o qual deseja configurar os Parâmetros.

    1.3. Selecione a opção Parâmetros.

    1.4. Selecione o parâmetro desejado.

    1.5. Clique <ENTER> para ver os detalhes do Parâmetro.

    1.6. Selecione Editar.

    1.7. Atualize o(s) valor(es) do parâmetro selecionado.

    1.8. Confirme a operação, se assim for solicitado.

    1.9. Confirme se deseja realizar a REINICIALIZAÇÃO/RELOAD, se assim for solicitado.

    Figura 3 - Edição da Configuração de Parâmetros do Banco de Dados
    Figura 3 - Edição da Configuração de Parâmetros do Banco de Dados

Remoção Parâmetro​

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

    1.1. Selecione Configurações das instâncias no menu de opções.

    1.2. Selecione o Diretório de dados da instância PostgreSQL para o qual deseja configurar os Parâmetros.

    1.3. Selecione a opção Parâmetros.

    1.4. Selecione o parâmetro desejado.

    1.5. Clique <ENTER> para ver os detalhes do Parâmetro.

    1.6. Selecione Remover.

    1.7. Confirme a operação, se assim for solicitado.

    1.8. Confirme se deseja realizar a REINICIALIZAÇÃO/RELOAD, se assim for solicitado.

    Figura 4 - Remoção da Configuração de Parâmetros do Banco de Dados
    Figura 4 - Remoção da Configuração de Parâmetros do Banco de Dados
    nota

    Ao remover a configuração do parâmetro, ele retornará à sua configuração default.

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.