Modificar Configurações do PostgreSQL

ServBay vem com o banco de dados PostgreSQL e oferece opções de configuração flexíveis. Este documento detalha como modificar as configurações do PostgreSQL no ServBay, incluindo a localização dos arquivos de configuração e opções comuns. Dependendo da versão do PostgreSQL, esses arquivos estão localizados no diretório /Applications/ServBay/etc/postgresql/<version>. Por exemplo, os arquivos de configuração do PostgreSQL 16 estão no diretório /Applications/ServBay/etc/postgresql/16.

Aviso Importante

Por favor, não modifique os arquivos de configuração manualmente. Todos os arquivos de configuração são gerados automaticamente pelo ServBay, e modificações manuais podem ser sobrescritas. Utilize a interface de usuário (UI) para realizar alterações.

Fazendo alterações através da interface de usuário do ServBay

ServBay possui uma poderosa interface gráfica de gerenciamento, permitindo aos usuários modificar parâmetros de configuração diretamente nela. Após clicar em salvar, as alterações serão aplicadas automaticamente e entrarão em vigor imediatamente, eliminando a necessidade de edição manual dos parâmetros.

Os usuários podem acessar a configuração do PostgreSQL através da barra de navegação à esquerda do ServBay, selecionando Banco de Dados - PostgreSQL, e escolher a versão correspondente para editar as configurações do PostgreSQL.

Na interface gráfica de edição, além de acessar o nome de usuário padrão do PostgreSQL e a senha root, os usuários podem alterar o endereço de escuta listen_addresses e a porta port do PostgreSQL (o padrão é *:3306). Os usuários também podem configurar max_connections, work_mem, entre outras opções do PostgreSQL.

Além disso, os usuários podem configurar parâmetros adicionais em Parâmetros Adicionais para atender às necessidades de desenvolvimento.

Após completar as alterações, clique no botão Salvar para aplicar as modificações em tempo real.

Modificando manualmente através da edição de arquivos de configuração

WARNING

Modificar os arquivos de configuração manualmente é apropriado apenas para alterações temporárias em algumas opções de configuração.

Não recomendamos modificar os arquivos de configuração do PostgreSQL manualmente, pois todas as alterações podem ser sobrescritas pelo ServBay.

Visão Geral

No ServBay, os arquivos de configuração do PostgreSQL são armazenados em diferentes diretórios dependendo da versão. Por exemplo, os arquivos de configuração do PostgreSQL 16 estão no diretório /Applications/ServBay/etc/postgresql/16. Os principais arquivos de configuração incluem postgresql.conf e pg_hba.conf.

Localização dos Arquivos de Configuração

• postgresql.conf: /Applications/ServBay/etc/postgresql/16/postgresql.conf
• pg_hba.conf: /Applications/ServBay/db/postgresql/16/pg_hba.conf

Opções de Configuração Comuns e Como Modificá-las

postgresql.conf

postgresql.conf é o principal arquivo de configuração do PostgreSQL, usado para definir as opções de tempo de execução do servidor de banco de dados.

Opções Comuns de Configuração

1. Modificar endereço de escuta:

   listen_addresses = '*'

2. Modificar número da porta:

   port = 5432

3. Modificar número máximo de conexões:

   max_connections = 100

4. Modificar tamanho dos buffers compartilhados:

   shared_buffers = 128MB

5. Modificar caminho dos arquivos de log:

   log_directory = 'log'
   log_filename = 'postgresql-%Y-%m-%d.log'

6. Ativar log de consultas lentas:

   log_min_duration_statement = 2000  # Em milissegundos, registra consultas que demoram mais de 2 segundos para executar.

pg_hba.conf

O arquivo pg_hba.conf é usado para configurar o método de autenticação das conexões dos clientes.

Opções Comuns de Configuração

1. Permitir conexões locais:

   # "local" é apenas para conexões via socket de domínio Unix
   local   all             all                                     trust

2. Permitir conexões remotas de qualquer endereço IP:

   # Conexões locais IPv4:
   host    all             all             0.0.0.0/0               md5

3. Permitir conexões remotas de um endereço IP específico:

   # Conexões locais IPv4:
   host    all             all             192.168.1.0/24          md5

Reiniciar PostgreSQL

Após modificar os arquivos de configuração do PostgreSQL, é necessário reiniciar o serviço para que as alterações entrem em vigor. Isso pode ser feito através da interface de gerenciamento do ServBay ou usando a ferramenta de linha de comando servbayctl.

Reiniciando através da interface de gerenciamento do ServBay

1. Abra a interface de gerenciamento do ServBay.
2. Navegue até Serviços.
3. Encontre o serviço PostgreSQL da versão correspondente e clique no botão Reiniciar.

Reiniciando com servbayctl

A ferramenta de linha de comando servbayctl facilita o reinício do serviço PostgreSQL:

servbayctl restart postgresql 16

Conclusão

No ServBay, os arquivos de configuração do PostgreSQL estão localizados no diretório /Applications/ServBay/etc/postgresql/<version>, incluindo postgresql.conf e pg_hba.conf. Após modificar esses arquivos de configuração, pode-se reiniciar o serviço PostgreSQL através da interface de gerenciamento do ServBay ou usando a ferramenta de linha de comando servbayctl para que as alterações entrem em vigor.