Ir para o conteúdo
Promovaweb
Portal independente da Promovaweb

PostgreSQL O banco que confere cada gravação do seu app.

O PostgreSQL é um banco relacional de código aberto que guarda os registros do app em tabelas. Quando a VPS reinicia no meio de uma venda, ele descarta a gravação pela metade, sem estoque baixado para um pedido que não existe.

Código aberto sob a PostgreSQL License, mantido pelo PostgreSQL Global Development Group. Assuntos conferidos na versão 18.7.

Veja como gravar a compra inteira e atender vários apps sem esgotar as conexões do servidor.
  1. IntegridadeCompra de cliente inexistente nunca entra na tabela.
  2. TransaçõesA compra e os itens gravam juntos ou nada grava.
  3. BuscasO índice evita ler a tabela inteira a cada busca.
  4. ConexõesUm pool divide poucas conexões entre muitos workers.

O banco relacional por trás do n8n e do Chatwoot

O PostgreSQL guarda os registros em tabelas com tipo declarado e recusa, já na gravação, o valor que não cabe na coluna.

O app conversa com o servidor pela porta 5432

O PostgreSQL roda como um processo servidor, separado do seu app. O app envia um comando SQL, como um SELECT ou um INSERT, pela conexão na porta 5432 e recebe as linhas ou a confirmação da gravação. Só o servidor sabe onde as tabelas ficam no disco.

Com essa separação, o mesmo banco atende ao mesmo tempo um backend em Laravel, um workflow do n8n e o Metabase montando um relatório. Cada um abre a própria conexão. O servidor coordena o acesso: duas gravações na mesma linha esperam uma pela outra, enquanto uma consulta comum lê só as versões já confirmadas.

Além de números, textos e datas, o PostgreSQL guarda jsonb, uuid, arrays e intervalos como tipos nativos, com operadores e índices próprios. Extensões como a pgvector acrescentam tipos e funções sem trocar de banco.

Cada app que grava na tabela obedece às mesmas regras

  • Validação repetida em cada app. Uma coluna integer recusa abc, uma chave estrangeira recusa a compra de um cliente inexistente e uma restrição unique recusa o e-mail repetido. As regras valem para todos os apps que gravam na tabela, mesmo quando um código esquece a validação.
  • Metade de uma compra gravada. Os comandos entre BEGIN e COMMIT valem por inteiro ou não valem. Uma queda do servidor no meio do caminho não deixa a compra gravada sem os itens.
  • Consulta que lê a tabela inteira. O planejador compara a leitura sequencial com a busca pelo índice e escolhe o caminho de menor custo estimado. O EXPLAIN mostra essa escolha, para você saber se o índice entrou na consulta.
  • Conexões esgotadas na VPS. Cada conexão abre um processo no servidor, com limite padrão de 100. Um pool, no próprio app ou no PgBouncer, reaproveita poucas conexões reais entre muitos workers.

O planejador escolhe o caminho de cada consulta antes da leitura

Toda consulta passa pelas mesmas peças dentro do servidor, na ordem descrita pela documentação. O exemplo abaixo acompanha a busca das compras de um cliente.

  1. ConexãoO processo supervisor recebe o app e cria um processo backend para ele.
  2. ParserConfere a sintaxe do SQL e monta a árvore da consulta.
  3. PlanejadorEstima o custo de cada caminho e escolhe o menor.
  4. ExecutorLê as páginas pelo caminho escolhido e devolve as linhas.
Entre o parser e o planejador, a etapa de reescrita troca uma view pelas tabelas que ela representa. O índice entra como um dos caminhos que o planejador compara.
Veja como o planejador escolhe o caminho

O PostgreSQL rende mais em apps com tabelas ligadas por chaves

  • Tabelas ligadas por chaves estrangeiras. Clientes, compras e itens ligados por chaves, com o banco conferindo cada relação na hora da gravação.
  • Vários apps no mesmo servidor. O n8n, o Chatwoot e o Metabase abrem conexões próprias no mesmo cluster, cada um no próprio banco, isolado dos outros.
  • Apps com IA e documentos. A pgvector guarda embeddings para busca por similaridade e o jsonb guarda documentos na própria tabela, sem um segundo banco.

O navegador não fala direto com o PostgreSQL

  • Um front-end que chama o banco direto. O PostgreSQL não publica uma API HTTP. O navegador não conversa com ele: o acesso passa por um backend com o driver da linguagem.
  • Muitas conexões curtas sem pool. Cada conexão nova cria um processo no servidor. Um app que abre uma conexão por requisição HTTP e não a fecha esgota o limite com processos parados.

Fica com você montar o backup e testar a restauração

  • Uma tela de administração. O servidor não tem interface própria. A administração passa pelo psql, que acompanha o servidor, ou por ferramentas externas que abrem uma conexão comum.
  • A rotina de backup. O servidor oferece o pg_dump e a replicação. A cópia agendada, o teste de restauração e a réplica em outro servidor dependem da configuração que você monta.
  • A migração entre versões principais. Cada versão principal muda o formato interno dos arquivos e exige o pg_upgrade ou um dump seguido de restauração. Uma versão menor troca os binários e reinicia o servidor, salvo ação extra pedida nas notas.
Mantenedor
PostgreSQL Global Development Group, com uma versão principal por ano e cinco anos de suporte para cada uma.
Versão de referência
18.7, a mesma usada nos assuntos deste portal.

Variáveis que preparam o banco na primeira subida do container

Veja o que cada variável faz

Onde o PostgreSQL protege os registros do app

Você pode combinar documentos JSONB com colunas tipadas ou consultar embeddings com a pgvector no mesmo banco.

Portais relacionados

Sistemas ligados a este nas stacks e nos projetos, cada um com o próprio portal.

Continue na comunidade

Leve ao Discord da Promovaweb a consulta lenta ou o erro de limite de conexões. Com o EXPLAIN ou a mensagem do servidor na conversa, a comunidade compara o seu caso com bancos parecidos.

Uma VPS para o seu PostgreSQL

Cada conexão do PostgreSQL ocupa um processo com memória própria no servidor. A VPS da StayCloud em São Paulo vem com acesso root e disco NVMe para o banco e os apps que se conectam a ele.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.