NUOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Vedi il registro delle modifiche →

Ingegneria · 9 lettura minima

Compatibilità PostgREST: cosa copre e alternative

Affane Daylami · Fondateur · 3 agosto 2026

Torniamo al blog

PostgREST trasforma uno schema PostgreSQL in un'API REST senza backend da scrivere. È una risposta chiara a un’esigenza specifica, non un backend completo. La confusione tra i due spiega la maggior parte delle delusioni che leggiamo nei feedback online.

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Questo articolo descrive in dettaglio ciò che PostgREST copre effettivamente, cosa lascia a te e confronta alternative serie, fino a ciò che Aurabase copre effettivamente internamente, verificato nel suo codice anziché presunto.

L'essenziale

  • PostgREST genera un'API REST da uno schema Postgres: filtri, incorporamento di relazioni, chiamate RPC, JWT-driven RLS, specifica OpenAPI, senza una riga di codice backend.
  • Cosa non fa in modo nativo: emette JWT, archivia file, esegue il push in tempo reale o fornisce un pool di connessioni con attivazione/disattivazione dei ruoli integrata.
  • In Aurabase, un progetto del motore Postgres viene eseguito su un'istanza PostgREST 16.5 dedicata reale, non una reimplementazione. Un progetto del motore MongoDB passa attraverso un livello REST specifico per Aurabase, ispirato alle stesse convenzioni ma con limiti diversi.
  • Le alternative vanno dal PostgREST self-hosted (tutto da assemblare attorno ad esso) a un backend completo (Supabase, Aurabase), tramite API GraphQL come Hasura o PostGraphile.
#
Definizione

Cos'è esattamente PostgREST?

PostgREST è un web server autonomo che trasforma un database PostgreSQL esistente in un'API REST, direttamente dal suo schema. Nessun livello applicativo da scrivere: tabelle, viste e funzioni diventano percorsi e le autorizzazioni SQL (ruoli, policy RLS) diventano il livello di autorizzazione.

Concretamente, PostgREST copre cinque funzionalità che emergono in quasi tutte le valutazioni:

  • Filtraggio orizzontale — una trentina di operatori (eq, gt, like, ilike, in, is, cs, ov, fts...) direttamente in stringa di interrogazione.
  • Filtraggio verticale e incorporamento — ?select= proietta colonne e incorpora relazioni tramite chiave esterna, ad esempio customer:customers(email).
  • RPC — un POST /rpc/{fonction} chiama direttamente una funzione SQL, che diventa un endpoint.
  • RLS guidato da JWT — PostgREST cambia il ruolo attivo Postgres in base al token ricevuto (SET LOCAL ROLE), in modo che le policy vengano applicate così come sono, senza logica di autorizzazione duplicata sul lato dell'applicazione.
  • OpenAPI autogenerata — la specifica è dedotta dallo schema esposto, senza un file da mantenere manualmente.
Tipica query PostgRESTbash
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>"

Una singola richiesta HTTP filtra gli ordini pagati, incorpora l'e-mail del cliente tramite chiave esterna e ordina per data, senza che un singolo percorso debba essere scritto a mano.

L'RPC segue la stessa logica: una funzione SQL già scritta nel database diventa un endpoint POST, con i suoi argomenti passati in JSON.

Chiamata 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}'

Questo principio (lo schema Postgres è l'unica fonte di verità dell'API) è ciò che rende prevedibile PostgREST: ogni modifica del comportamento passa attraverso una migrazione SQL, mai attraverso un livello applicativo separato che potrebbe derivare dallo schema effettivo. Il progetto è open source, sviluppato su GitHub, indipendente da qualsiasi particolare BaaS provider.

#
Limiti

Cosa non fa PostgREST

PostgREST risolve il livello CRUD. Non risolve il resto del backend dell'applicazione. Quattro carenze si verificano sistematicamente tra i team che lo adottano da soli.

  • Autenticazione: nessuna emissione di JWT o gestione integrata degli utenti. È necessario crearlo in SQL o delegarlo a un servizio esterno.
  • Archiviazione file — nessuno. Resta da collegare separatamente un bucket S3 o equivalente.
  • Tempo reale — PostgREST risponde a richieste HTTP una tantum, non invia alcun evento.
  • Connection Pooler — PostgREST stesso si connette a Postgres, ma non integra alcun pooler avanzato. Su larga scala, gestirlo diventa una decisione operativa a sé stante: un pooler in modalità transazione classica è in conflitto con il meccanismo di ricaricamento dello schema PostgREST (vedi sotto come Aurabase risolve questo compromesso).
Informazioni

Nessuna di queste carenze è un difetto di progettazione: PostgREST svolge un lavoro specifico (schema → REST API), volontariamente. È questo perimetro ristretto che rende prevedibile il suo comportamento.

Una conseguenza pratica merita di essere espressa chiaramente: senza autenticazione, le tue policy RLS diventano l'unico confine di sicurezza tra un cliente anonimo e i tuoi dati. Una policy scritta male sul ruolo anon non viene superata da un livello applicativo aggiuntivo: non ce n'è.

#
Codice registrato

PostgREST a Aurabase: cosa è veramente coperto

Su un progetto del motore Aurabase Postgres (il motore predefinito) il gateway instrada ogni richiesta CRUD direttamente a un'istanza PostgREST 16.5 dedicata a questo progetto, due repliche, co-localizzate con il cluster Postgres del tenant. Questa non è una compatibilità approssimativa: è lo stesso PostgREST binario upstream, con gli stessi operatori, lo stesso incorporamento, lo stesso RPC, lo stesso RLS guidato da JWT.

Su un progetto del motore MongoDB, la storia è diversa. MongoDB non ha equivalenti a PostgREST: queste richieste vengono instradate a un servizio interno Aurabase, che reimplementa un sottoinsieme delle stesse convenzioni - nomi degli operatori identici, sintassi ?select= con incorporamento, intestazioni Prefer e Content-Range - ma su un motore di documenti, non relazionale. Questo livello ha le sue limitazioni: un incorporamento richiesto nella rappresentazione restituita da una mutazione viene esplicitamente negato anziché ignorato silenziosamente e non esiste un percorso RPC equivalente alle funzioni SQL.

La distinzione conta nella scelta

La piena compatibilità con PostgREST (RPC e RLS inclusi) è un dato di fatto del motore Postgres, non una garanzia di tutti i motori. Se il tuo progetto dipende da funzioni SQL esposte in RPC, ad oggi il motore Postgres è l'unica opzione.

Un dettaglio tecnico contrasta con l'intuizione: ogni istanza dedicata PostgREST rimane direttamente connessa al primario Postgres, senza passare attraverso il pooler PgBouncer distribuito per questo tenant. Motivo presunto: la modalità di pooling delle transazioni interromperebbe il ricaricamento dello schema PostgREST, che si basa su LISTEN/NOTIFY — una connessione persistente, incompatibile con un pool che ricicla la connessione per ogni transazione.

Un altro dettaglio utile in produzione: un progetto inattivo può essere messo in pausa per risparmiare risorse. La prima richiesta su un progetto dormiente ne attiva la riattivazione e riceve un 503 con un ritardo tra i tentativi, il tempo necessario affinché l'istanza dedicata PostgREST torni attiva: un presunto compromesso tra costo e latenza a freddo, non un incidente nascosto.

#
Confronto

Quali alternative a PostgREST esistono?

PostgREST ha un utilizzo chiaro: lo schema Postgres è la fonte della verità e il team vuole evitare di scrivere manualmente un livello CRUD. A parte questo caso specifico, esistono diverse famiglie di alternative a seconda di ciò che si desidera aggiungere: dal nulla (nudo self-hosted) a un backend completo pronto all'uso.

La tabella seguente confronta ciò che ciascuna opzione copre in modo nativo e ciò che lascia esplicitamente a te, senza giudizi di valore sull'architettura scelta da ciascun progetto.

Ospitato autonomamente PostgRESTAPI REST autogenerata (filtri, incorporamento, RPC, RLS).Autenticazione, archiviazione, tempo reale, interfaccia utente di amministrazione: tutto da mettere insieme.
SupabasePostgREST integrato + funzioni di autenticazione (GoTrue), archiviazione, tempo reale e edge.Stack eterogeneo (Elixir/Go/TS/Node) assemblato servizio per servizio.
Hasura / PostGraphileAPI GraphQL generata automaticamente da Postgres.Approccio GraphQL, non REST: confronto dedicato di seguito.
DirectusInterfaccia utente di amministrazione + API REST/GraphQL generale, multi-DBMS.Progettato per la gestione dei dati/CMS, non un backend applicativo completo.
Framework fatto a mano (Express, FastAPI, Rails…)Pieno controllo su ogni strada.CRUD, convalida, autenticazione, pooling: tutto scritto a mano.
AurabaseReale PostgREST dedicato per progetto Postgres + autenticazione, archiviazione, tempo reale, funzioni edge e AI già integrate.Sul motore MongoDB, livello REST ricostruito da Aurabase — non da PostgREST stesso.

Un punto spesso sottovalutato quando si sceglie "self-hosted": PostgREST rimane di per sé leggero da eseguire, ma le operazioni di produzione (aggiornamento della versione, alta disponibilità, associazione con un pooler, monitoraggio) rimangono interamente sotto la tua responsabilità: è questo lavoro operativo, non il software, che le piattaforme gestite assorbono.

Per un confronto dettagliato tra gli approcci GraphQL — pg_graphql, Hasura e PostGraphile — consulta il nostro articolo dedicato all'API GraphQL su Postgres.

#
Decisione

Come scegliere

Quattro situazioni si verificano più spesso. La scelta giusta dipende principalmente da ciò che sei disposto a montare e mantenere da solo.

  • Vuoi solo un'API REST su uno schema Postgres esistente, nient'altro. Self-hosted PostgREST è sufficiente: fa esattamente quello che fa e non è necessario installare nient'altro.
  • Hai bisogno di autenticazione, spazio di archiviazione e tempo reale aggiuntivi e sei pronto per assemblare diversi servizi. Supabase o PostgREST accompagnato dal tuo stack di applicazioni, soddisfa questa esigenza.
  • Preferisci GraphQL a REST. Hasura o PostGraphile coprono questo terreno: una scelta architettonica diversa, non un sostituto diretto per PostgREST.
  • Desideri un backend Postgres completo senza unire più servizi separati. Questo è l'angolo che la nostra ha unificato l'architettura Rust documenta: reale PostgREST per il livello CRUD, circondato nativamente da funzioni di autenticazione, archiviazione, tempo reale e edge.
#
Domande frequenti

Domande frequenti

Cos'è PostgREST?+
PostgREST è un web server open source che trasforma un database PostgreSQL esistente in un'API REST, direttamente dal suo schema: tabelle, viste e funzioni diventano rotte, senza un backend da scrivere.
PostgREST può sostituire un backend completo?+
No. PostgREST copre il livello CRUD (filtri, incorporamento, RPC, RLS) ma non l'emissione JWT, l'archiviazione di file o il tempo reale. Un backend completo richiede l'assemblaggio autonomo di questi mattoncini o l'adozione di una piattaforma che li integri già.
Aurabase è compatibile al 100% PostgREST?+
Su un progetto del motore Postgres, sì: Aurabase indirizza a un'istanza PostgREST upstream effettiva, non a una reimplementazione. Su un progetto di motore MongoDB, no: il livello REST è un sottoinsieme delle convenzioni PostgREST ricostruite da Aurabase su un motore di documenti, con limiti diversi (nessun RPC, incorporamento rifiutato in caso di mutazioni).
Come ottenere un'API REST automatica su Postgres senza scrivere un backend?+
Due opzioni principali: installare PostgREST davanti al proprio database (legge il diagramma ed espone i percorsi), oppure utilizzare una piattaforma che già lo integri – Supabase o Aurabase, ad esempio – per evitare di sfruttare l'istanza oltre al suo utilizzo.

PRONTO PER L'IMPLEMENTAZIONE?

Il tuo backend in cinque minuti.

Nessuna carta di credito richiesta · 500 MB gratuiti · 50.000 MAU