Banca dati
PostgreSQL 18, un database dedicato per progetto sul cluster della tua organizzazione, schemi isolati, tipi TypeScript generati automaticamente, nativo RLS. Nessun fork, nessun proxy di riscrittura: le tue estensioni, trigger e PL/pgSQL funzionano così come sono.
Postgres 18, senza astrazione#
Il servizio aura-db espone un CRUD generico sopra un PostgreSQL 18: ogni progetto ha il proprio database, ospitato sul cluster PostgreSQL della tua organizzazione (un cluster interamente dedicato a un singolo progetto nell'offerta enterprise). Ogni chiamata SDK viene tradotta in SQL nativo tramite un livello sottile che rispetta RLS policies inserito nella sessione.
Puoi anche ignorare l'SDK e puntare psql, Prisma, Drizzle, Kysely, Metabase o pg_dump al tuo database: protocollo wire standard PostgreSQL, TLS, un ruolo che può raggiungere solo il database del tuo progetto. Vedere Connessione diretta di seguito. (Una distribuzione che non pubblica la porta PostgreSQL lo dice in Studio › Impostazioni › Connessione: utilizza l'SDK, l'API REST, l'editor SQL o la CLI, aura db raw.)
A pg_dump ti fornisce il tuo database completo (schema, dati, estensioni, policy). Nessun lock-in, banale migrazione in uscita.
L'SDK chiama PostgREST, che chiama Postgres#
Sotto il cofano, l'SDK serializza le tue chiamate .from().select()… in una richiesta HTTP a aura-db che delega a un sidecar PostgREST. PostgREST si traduce in SQL e apre una connessione in pool tramite PgBouncer con search_path del progetto inserito.
SDK → HTTPS GET /v1/db/sensors?select=id,name
Gateway → aura-db Session verification & routing
aura-db → PgBouncer → PostgreSQL 18
# Connessione con il progetto search_path
SET LOCAL search_path = project_a7f3_, public;
SET LOCAL request.jwt.claims = '{ "sub": "u_9k2", "tenant": "t_4c" }';
SELECT id, name, temperature FROM sensors WHERE active = true LIMIT 50;
I criteri RLS hanno accesso a auth.uid(), auth.role(), auth.tenant(). Questi helper leggono request.jwt.claims iniettato dal gateway: impossibile manometterlo dal lato client.
Sei abilità native#
- Schema per progetto. Partizionamento applicato da PostgreSQL: nessuna colonna tenant_id, un ruolo di connessione per progetto, diritti mai aperti a PUBLIC.
- Migrazioni con versione. SQL con versione, rollback atomico, tempi di inattività pari a zero. I tipi TypeScript si rigenerano con ogni migrazione.
- Generazione codici TypeScript & Rust. Generazione automatica di tipi per tabelle, viste, enumerazioni e funzioni RPC dal tuo schema live.
- Nativo RLS. Politiche dichiarative verificabili. L'SDK inserisce il tenant della richiesta in ogni connessione.
- Estensioni consentite. 14 estensioni installate dalla piattaforma quando viene creato un progetto:
pgvector,pgcrypto,uuid-ossp,pg_trgm,pg_graphql,pg_stat_statements,citext,hstore,ltree,unaccent,btree_gin,btree_gist,fuzzystrmatch,intarray. - Rami del database.
aura branch createcopia un progetto (schema, policy, funzioni, trigger, visualizzazioni e righe) in un nuovo progetto con il proprio URL e chiavi, eliminati automaticamente allo scadere del tempo. Una copia realizzata al momento della creazione, non una replica dal vivo.
CRUD completo, digitato#
Le quattro operazioni di base condividono la stessa superficie .from(table). I tipi restituiti vengono dedotti dal tuo schema: apri il tuo IDE, il completamento automatico funziona su colonne, join e ritorni.
// Elenca gli ultimi 50 sensori attivi
const { data, error } = await aura
.from('sensors')
.select('id, name, temperature, location!inner(city)')
.eq('active', true)
.order('captured_at', { ascending: false })
.limit(50)
Hai bisogno di SQL più complesso? Crea una funzione Postgres e chiamala tramite aura.rpc('function_name', args). Le funzioni beneficiano delle stesse policy RLS delle tabelle.
14 estensioni consentite pronte#
14 estensioni consentite, pronte per ogni nuovo progetto
La piattaforma li installa quando viene creato il progetto (un ruolo di progetto non può eseguire CREATE EXTENSION da solo, quindi non c'è alcun passaggio di attivazione da dimenticare). Elenca cosa è installato con aura db extensions list o Studio › Database › Estensioni; aura db extensions enable <name> e POST /v1/db/{project_id}/schema/extensions ne riapplicano uno consentito.
- pgvector (
vector) - pg_graphql (installato quando abiliti GraphQL)
- pg_stat_statements
- pgcrypto
- uuid-ossp
- pg_trgm
- citesto
- hstore
- lalbero
- senza accento
- btree_gin
- btree_gist
- fuzzystrmatch
- intarsio
postgis, pg_cron, timescaledb, pgmq e pg_partman non sono inclusi nell'immagine gestita standard. Per i carichi di lavoro pianificati, attiva una funzione Edge su una pianificazione cron in Cron. Un progetto creato prima di questa modifica ha solo le cinque estensioni storiche (vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql) finché la piattaforma non esegue il successivo aggiornamento dello schema; non è possibile aggiungere gli altri da soli, perché solo l'operatore del database può installarli.
Connettiti direttamente: psql, Prisma, Drizzle, pg_dump#
Ogni progetto ha il proprio ruolo di login PostgreSQL (proj_xxxxxxxx) e un host del modulo <project-slug>.db.<your-domain> sulla porta 5432. La password è emessa su richiesta e mostrata una volta: la piattaforma non la mantiene in chiaro, quindi una password persa viene sostituita, mai recuperata.
# Host, porta, database e ruolo del progetto collegato (nessuna password)
aura db connection
# Emetti una password e stampa la stringa di connessione completa (revoca la password precedente)
aura db connection --new-password
# Apri psql su di esso (psql richiede la password)
aura connect
aura db connection --new-password stampa una stringa che puoi incollare ovunque:
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require
La stessa carta esiste in Studio › Impostazioni › Connessione › Database (Genera password / Reimposta password).
- TLS è obbligatorio. L'endpoint rifiuta le connessioni in testo normale (
sslmode=require). Su uno stack k3d locale il certificato è autofirmato (*.db.localhost), quindisslmode=verify-fullfallisce in base alla progettazione; la produzione utilizza un certificato emesso per*.db.<your-domain>. - Limitato al tuo progetto. Il router seleziona il tuo database dal nome del ruolo e lo forza: la richiesta di un altro nome di database arriva comunque nel tuo e la presentazione del tuo ruolo sull'host di un altro progetto viene rifiutata. Il tuo ruolo non è quello di superutente e non bypassa RLS; per eseguire una migrazione come proprietario della tabella, utilizzare
BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;. - Le tabelle create qui sono private sulla piattaforma. La sicurezza a livello di riga non può essere attivata automaticamente per una tabella creata su questa connessione (che necessita di un superutente PostgreSQL, che un progetto gestito non espone mai), quindi le chiavi pubbliche non ottengono alcun privilegio su di essa: l'API REST risponde
permission deniedalla chiave anon e agli utenti che hanno effettuato l'accesso, mentre la chiaveservice_role, Studio e il tuo ruolo la leggono e scrivono. Per esporlo all'SDK, abilitare RLS, concedere, quindi aggiungere una policy (vedere Sicurezza a livello di riga):ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …. PostgREST apprende la nuova tabella quando eseguiNOTIFY pgrst, 'reload schema'. Le tabelle create su questa connessione prima che esistesse questa regola verranno chiuse la prossima volta che si immette una password (aura db connection --new-password), a meno che non abbiano già RLS abilitato. - Pool di transazioni. Le connessioni passano attraverso PgBouncer in modalità transazione. Lo stato della sessione non viene trasferito da una transazione a quella successiva: utilizzare
SET LOCALall'interno di una transazione e aspettarsi che le istruzioni preparate denominate,LISTENe i blocchi consultivi a livello di sessione non siano affidabili (Prisma: aggiungerepgbouncer=trueall'URL). - Versione del client.
pg_dumprifiuta un server più recente di se stesso: utilizzare un client PostgreSQL 18 (pg_dump --version).
L'accesso diretto dipende dalla distribuzione che pubblica la porta PostgreSQL. È attivo per lo stack k3d locale e per le distribuzioni i cui valori Helm lo abilitano (ingress.tcp.enabled dietro ingress-nginx o pgproxy.nodePort); lo Studio e aura db connection ti dicono quando non lo è.
Per andare oltre#
- Sicurezza a livello di riga
Policy native, testing, pattern multi-tenant.
- Convenzioni
Denominazione di schemi, colonne, policy, RLS helper.
- Rami del database
Una copia di un progetto per ogni richiesta pull, eliminata dal relativo TTL.
- Architettura
Come si inserisce aura-db negli 8 servizi.
- API REST
Superficie HTTP grezza per database, autenticazione, archiviazione.
- Supabase Migrazione
pg_dump + RLS rimappatura, 1 ora per un progetto medio.