NOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Veja o changelog →

Engenharia · 9 minutos de leitura

Compatibilidade PostgREST: o que cobre e alternativas

Affane Daylami · Fondateur · 3 de agosto de 2026

Voltar ao blog

PostgREST transforma um esquema PostgreSQL em uma API REST sem back-end para gravação. É uma resposta clara a uma necessidade específica – não um back-end completo. A confusão entre os dois explica a maioria das decepções que lemos nos comentários online.

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Este artigo detalha o que PostgREST realmente cobre, o que deixa para você e compara alternativas sérias - até o que Aurabase realmente cobre internamente, verificado em seu código e não assumido.

O essencial

  • PostgREST gera uma API REST a partir de um esquema Postgres: filtros, incorporação de relacionamento, chamadas RPC, JWT acionado por RLS, especificação OpenAPI - sem uma linha de código de back-end.
  • O que ele não faz nativamente: emite JWTs, armazena arquivos, envia push em tempo real ou fornece um pooler de conexões com alternância de função integrada.
  • Em Aurabase, um projeto de mecanismo Postgres é executado em uma instância PostgREST 16.5 dedicada real - não uma reimplementação. Um projeto de motor MongoDB passa por uma camada REST específica para Aurabase, inspirada nas mesmas convenções, mas com limites diferentes.
  • As alternativas vão desde PostgREST auto-hospedado (tudo a ser montado em torno dele) até um backend completo (Supabase, Aurabase), via APIs GraphQL como Hasura ou PostGraphile.
#
Definição

O que exatamente é PostgREST?

PostgREST é um servidor web autônomo que transforma um banco de dados PostgreSQL existente em uma API REST, diretamente de seu esquema. Nenhuma camada de aplicação para escrever: tabelas, visualizações e funções tornam-se rotas, e permissões SQL — funções, políticas RLS — tornam-se a camada de autorização.

Concretamente, PostgREST cobre cinco capacidades que surgem em quase todas as avaliações:

  • Filtragem horizontal - cerca de trinta operadores (eq, gt, like, ilike, in, is, cs, ov, fts...) diretamente na string de consulta.
  • Filtragem vertical e incorporação — ?select= projeta colunas e incorpora relacionamentos por meio de chave estrangeira, por exemplo customer:customers(email).
  • RPC — um POST /rpc/{fonction} chama diretamente uma função SQL, que se torna um endpoint.
  • RLS conduzido por JWT — PostgREST alterna a função Postgres ativa de acordo com o token recebido (SET LOCAL ROLE), para que suas políticas sejam aplicadas como estão, sem lógica de autorização duplicada no lado do aplicativo.
  • OpenAPI autogerado — a especificação é deduzida do esquema exposto, sem um arquivo para manter manualmente.
Consulta PostgREST típicabash
curl "https://<gateway>/v1/db/<project_id>/orders \
  ?select=id,total,customer:customers(email) \
  &status=eq.paid \
  &order=created_at.desc" \
  -H "apikey: <votre-cle-api>"

Uma única solicitação HTTP filtra os pedidos pagos, incorpora o e-mail do cliente por meio de chave estrangeira e classifica por data — sem que uma única rota precise ser escrita à mão.

O RPC segue a mesma lógica: uma função SQL já escrita em seu banco de dados torna-se um endpoint POST, com seus argumentos passados em JSON.

Chamada RPCbash
curl -X POST "https://<gateway>/v1/db/<project_id>/rpc/monthly_revenue" \
  -H "apikey: <votre-cle-api>" \
  -H "Content-Type: application/json" \
  -d '{"year": 2026, "month": 8}'

Este princípio — o esquema Postgres é a única fonte de verdade da API — é o que torna PostgREST previsível: toda mudança de comportamento passa por uma migração SQL, nunca por uma camada de aplicativo separada que poderia derivar do esquema real. O projeto é de código aberto, desenvolvido em GitHub, independente de qualquer fornecedor BaaS específico.

#
Limites

O que PostgREST não faz

PostgREST resolve a camada CRUD. Isso não resolve o restante do back-end de um aplicativo. Quatro deficiências ocorrem sistematicamente entre as equipes que o adotam sozinhas.

  • Autenticação — sem emissão de JWT ou gerenciamento integrado de usuários. Você deve construí-lo em SQL ou delegá-lo a um serviço externo.
  • Armazenamento de arquivo — nenhum. Um balde S3 ou equivalente ainda precisa ser conectado separadamente.
  • em tempo real — PostgREST responde a solicitações HTTP únicas, não envia nenhum evento.
  • Pooler de conexão — o próprio PostgREST se conecta a Postgres, mas não integra nenhum pooler avançado. Em escala, gerenciá-lo torna-se uma decisão operacional por si só: um pooler no modo de transação clássico entra em conflito com o mecanismo de recarga de esquema PostgREST (veja abaixo como Aurabase resolve esse comprometimento).
Informações

Nenhuma dessas deficiências é uma falha de design: PostgREST faz um trabalho específico (esquema → API REST), voluntariamente. É este perímetro apertado que torna o seu comportamento previsível.

Uma consequência prática merece ser declarada claramente: sem autenticação, as suas políticas RLS tornam-se a única fronteira de segurança entre um cliente anónimo e os seus dados. Uma política mal escrita sobre a função anon não é substituída por uma camada de aplicação adicional – não existe nenhuma.

#
Verificado no código

PostgREST em Aurabase: o que é realmente coberto

Em um projeto de mecanismo Aurabase Postgres — o mecanismo padrão — o gateway roteia cada solicitação CRUD diretamente para uma instância PostgREST 16.5 dedicada a este projeto, duas réplicas, co-localizadas com o cluster Postgres do locatário. Esta não é uma compatibilidade aproximada: é o próprio binário upstream PostgREST, com os mesmos operadores, a mesma incorporação, o mesmo RPC, o mesmo RLS conduzido por JWT.

Em um projeto de mecanismo MongoDB, a história é diferente. MongoDB não tem equivalente a PostgREST: essas solicitações são roteadas para um serviço Aurabase interno, que reimplementa um subconjunto das mesmas convenções - nomes de operadores idênticos, sintaxe ?select= com incorporação, cabeçalhos Prefer e Content-Range - mas em um mecanismo de documento, não relacional. Esta camada tem suas próprias limitações: uma incorporação solicitada na representação retornada por uma mutação é explicitamente negada em vez de ignorada silenciosamente, e não há rota RPC equivalente às funções SQL.

A distinção conta na hora de escolher

A compatibilidade total com PostgREST – RPC e RLS incluídos – é um fato do mecanismo Postgres, não uma garantia entre mecanismos. Se o seu projeto depende de funções SQL expostas no RPC, o mecanismo Postgres é a única opção no momento.

Um detalhe técnico contrasta com a intuição: cada instância PostgREST dedicada permanece diretamente conectada ao Postgres primário, sem passar pelo pooler PgBouncer implantado para este locatário. Razão suposta: o modo de pool de transações interromperia o recarregamento do esquema PostgREST, que depende de LISTEN/NOTIFY — uma conexão persistente, incompatível com um pool que recicla a conexão para cada transação.

Outro detalhe útil na produção: um projeto inativo pode ser pausado para economizar recursos. A primeira solicitação em um projeto inativo aciona sua ativação e recebe um 503 com um atraso de nova tentativa, o tempo para a instância PostgREST dedicada voltar a funcionar – um compromisso assumido entre custo e latência fria, não um incidente oculto.

#
Comparação

Quais alternativas para PostgREST existem?

PostgREST tem um uso claro: o esquema Postgres é a fonte da verdade e a equipe deseja evitar escrever uma camada CRUD manualmente. Além deste caso específico, existem várias famílias de alternativas dependendo do que você deseja adicionar - desde nada (simples auto-hospedado) até um backend completo pronto para uso.

A tabela abaixo compara o que cada opção cobre nativamente e o que ela deixa explicitamente a seu critério — sem julgamento de valor sobre a arquitetura escolhida por cada projeto.

PostgREST auto-hospedadoAPI REST autogerada (filtros, incorporação, RPC, RLS).Autenticação, armazenamento, tempo real, UI de administração – tudo para montar.
SupabaseIntegrado PostgREST + autenticação (GoTrue), armazenamento, tempo real, funções de borda.Pilha heterogênea (Elixir/Go/TS/Node) montada serviço por serviço.
Hasura / PostGraphileAPI GraphQL gerada automaticamente de Postgres.Abordagem GraphQL, não REST – comparação dedicada abaixo.
DiretoUI de administração + API REST/GraphQL geral, multi-DBMS.Projetado para gerenciamento de dados/CMS, não para um back-end de aplicativo completo.
Estrutura artesanal (Express, FastAPI, Rails…)Controle total em todas as estradas.CRUD, validação, autenticação, pooling – tudo manuscrito.
AurabaseReal PostgREST dedicado por projeto Postgres + autenticação, armazenamento, tempo real, funções de borda e IA já integrados.No mecanismo MongoDB, camada REST reconstruída por Aurabase - não pelo próprio PostgREST.

Um ponto muitas vezes subestimado na escolha de "auto-hospedado": o próprio PostgREST permanece leve para ser executado, mas a operação de produção (atualização de versão, alta disponibilidade, associação com pooler, monitoramento) permanece inteiramente de sua responsabilidade - é esse trabalho de operação, e não o software, que as plataformas gerenciadas absorvem.

Para uma comparação detalhada entre as abordagens GraphQL - pg_graphql, Hasura e PostGraphile - consulte nosso artigo dedicado à API GraphQL em Postgres.

#
Decisão

Como escolher

Quatro situações surgem com mais frequência. A escolha certa depende principalmente do que você está disposto a montar e manter.

  • Você deseja apenas uma API REST sobre um esquema Postgres existente, nada mais. PostgREST auto-hospedado é suficiente: ele faz exatamente o que faz e nada mais precisa ser instalado.
  • Você precisa de autenticação adicional, armazenamento e tempo real e está pronto para montar vários serviços. Supabase ou PostgREST acompanhado de sua própria pilha de aplicativos atende a essa necessidade.
  • Você prefere GraphQL a REST. Hasura ou PostGraphile cobrem esse terreno - uma escolha arquitetônica diferente, não uma substituição direta para PostgREST.
  • Você deseja um back-end Postgres completo sem unir vários serviços separados. Este é o ângulo que nossa arquitetura unificada Rust documenta: PostgREST real para a camada CRUD, nativamente cercada por funções de autenticação, armazenamento, tempo real e borda.
#
Perguntas frequentes

Perguntas frequentes

O que é PostgREST?+
PostgREST é um servidor web de código aberto que transforma um banco de dados PostgreSQL existente em uma API REST, diretamente de seu esquema: tabelas, visualizações e funções tornam-se rotas, sem backend para gravação.
PostgREST pode substituir um back-end completo?+
Não. PostgREST cobre a camada CRUD (filtros, incorporação, RPC, RLS), mas não a emissão de JWT, armazenamento de arquivos ou tempo real. Um back-end completo requer a montagem desses blocos você mesmo ou a adoção de uma plataforma que já os integre.
Aurabase é 100% PostgREST compatível?+
Em um projeto de mecanismo Postgres, sim: Aurabase roteia para uma instância PostgREST upstream real, não uma reimplementação. Em um projeto de mecanismo MongoDB, não: a camada REST é um subconjunto das convenções PostgREST reconstruídas por Aurabase em um mecanismo de documento, com limites diferentes (sem RPC, incorporação recusada em mutações).
Como obter uma API REST automática em Postgres sem escrever um back-end?+
Duas opções principais: instalar você mesmo o PostgREST na frente do seu banco de dados (ele lê o diagrama e expõe as rotas), ou utilizar uma plataforma que já o integre – Supabase ou Aurabase, por exemplo – para evitar a exploração da instância além de seu uso.

PRONTO PARA IMPLEMENTAR?

Seu back-end em cinco minutos.

Não é necessário cartão de crédito · 500 MB grátis · 50.000 MAU