Database
PostgreSQL 18, een speciale database per project op het cluster van uw organisatie, geïsoleerde schema's, automatisch gegenereerde TypeScript-typen, native RLS. Geen forks, geen herschrijfproxy's: uw extensies, triggers en PL/pgSQL werken zoals ze zijn.
Postgres 18, zonder abstractie#
De aura-db-service biedt een generieke CRUD bovenop een PostgreSQL 18: elk project heeft zijn eigen database, gehost op het PostgreSQL-cluster van uw organisatie (een cluster dat volledig is gewijd aan één enkel project in het zakelijke aanbod). Elke SDK-aanroep wordt vertaald naar native SQL via een dunne laag die de RLS policies respecteert die in de sessie is geïnjecteerd.
U kunt ook de SDK omzeilen en psql, Prisma, Drizzle, Kysely, Metabase of pg_dump naar uw database verwijzen: standaard PostgreSQL wire-protocol, TLS, een rol die alleen de-database van uw project kan bereiken. Zie Direct verbinding maken met hieronder. (Een implementatie die de PostgreSQL-poort niet publiceert, zegt dit in Studio › Instellingen › Verbinding: gebruik de SDK, de REST API, de SQL-editor of de CLI, aura db raw.)
Een pg_dump geeft u uw volledige database (schema, gegevens, extensies, beleid). Geen lock-ins, triviale uitgaande migratie.
De SDK roept PostgREST aan, die Postgres aanroept#
Onder de motorkap serialiseert de SDK uw .from().select()…-oproepen in een HTTP-verzoek naar aura-db, dat delegeert aan een zijspan PostgREST. PostgREST vertaalt naar SQL en opent een gepoolde verbinding via PgBouncer met de search_path van het geïnjecteerde project.
SDK → HTTPS GET /v1/db/sensors?select=id,name
Gateway → aura-db Session verification & routing
aura-db → PgBouncer → PostgreSQL 18
# Verbinding met search_path-project
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;
RLS-beleid heeft toegang tot auth.uid(), auth.role(), auth.tenant(). Deze helpers lezen request.jwt.claims dat door de gateway is geïnjecteerd – onmogelijk om mee te knoeien aan de clientzijde.
Zes inheemse vaardigheden#
- Schema per project. Partitionering toegepast door PostgreSQL: geen kolom tenant_id, één verbindingsrol per project, rechten nooit geopend voor PUBLIC.
- Versiemigraties. SQL met versieversie, atomaire rollback, zero-downtime. TypeScript-typen worden bij elke migratie opnieuw gegenereerd.
- Codegen TypeScript & Rust. Automatisch genereren van typen voor tabellen, views, enums en RPC-functies vanuit uw live schema.
- Oorspronkelijk RLS. Toetsbaar declaratief beleid. De SDK injecteert de claimtenant in elke verbinding.
- Extensies op de toelatingslijst. 14 extensies geïnstalleerd door het platform wanneer een project wordt gemaakt:
pgvector,pgcrypto,uuid-ossp,pg_trgm,pg_graphql,pg_stat_statements,citext,hstore,ltree,unaccent,btree_gin,btree_gist,fuzzystrmatch,intarray. - Databasevertakkingen.
aura branch createkopieert een project (schema, beleid, functies, triggers, views en rijen) naar een nieuw project met zijn eigen URL en sleutels, en wordt automatisch verwijderd nadat het live is gegaan. Een kopie gemaakt tijdens het maken, geen live replica.
CRUD compleet, getypt#
De vier basisbewerkingen delen hetzelfde .from(table)-oppervlak. Geretourneerde typen worden afgeleid uit uw schema: open uw IDE, automatisch aanvullen werkt op kolommen, joins en retourneert.
// Maak een lijst van de laatste 50 actieve sensoren
const { data, error } = await aura
.from('sensors')
.select('id, name, temperature, location!inner(city)')
.eq('active', true)
.order('captured_at', { ascending: false })
.limit(50)
Heeft u complexere SQL nodig? Maak een Postgres-functie en roep deze aan via aura.rpc('function_name', args). Functies profiteren van hetzelfde RLS-beleid als tabellen.
14 extensies op de toelatingslijst gereed#
14 extensies op de toelatingslijst, klaar voor elk nieuw project
Het platform installeert ze wanneer het project wordt aangemaakt (een projectrol kan CREATE EXTENSION niet zelf uitvoeren, dus er is geen activatiestap die je hoeft te vergeten). Lijst wat is geïnstalleerd met aura db extensions list of Studio › Database › Extensies; aura db extensions enable <name> en POST /v1/db/{project_id}/schema/extensions passen een toegestane waarde opnieuw toe.
- pgvector (
vector) - pg_graphql (geïnstalleerd wanneer u GraphQL inschakelt)
- pg_stat_statements
- pgcrypto
- uuid-ossp
- pg_trgm
- citekst
- hwinkel
- lboom
- geen accent
- btree_gin
- btree_gist
- fuzzystrmatch
- incarnatie
postgis, pg_cron, timescaledb, pgmq en pg_partman zijn niet gebundeld in de standaard beheerde image. Voor geplande werklasten activeert u een Edge-functie volgens een cron-schema in Cron. Een project dat vóór deze wijziging is gemaakt, heeft slechts de vijf historische extensies (vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql) totdat het platform de volgende schema-update uitvoert; u kunt de anderen niet zelf toevoegen, omdat alleen de database-operator ze kan installeren.
Direct verbinding maken: psql, Prisma, Drizzle, pg_dump#
Elk project heeft zijn eigen PostgreSQL login-rol (proj_xxxxxxxx) en een host van de vorm <project-slug>.db.<your-domain> op poort 5432. Het wachtwoord is , uitgegeven op aanvraag en één keer getoond: het platform houdt het niet duidelijk bij, dus een verloren wachtwoord wordt vervangen en nooit meer hersteld.
# Host, poort, database en rol van het gekoppelde project (geen wachtwoord)
aura db connection
# Geef een wachtwoord op en druk de volledige verbindingsreeks af (trekt het vorige wachtwoord in)
aura db connection --new-password
# Open psql erop (psql vraagt om het wachtwoord)
aura connect
aura db connection --new-password drukt een tekenreeks af die u overal kunt plakken:
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require
Dezelfde kaart bestaat in Studio › Instellingen › Verbinding › Database (Wachtwoord genereren / Wachtwoord opnieuw instellen).
- TLS is vereist. Het eindpunt weigert plattetekstverbindingen (
sslmode=require). Op een lokale k3d-stack is het certificaat zelfondertekend (*.db.localhost), dussslmode=verify-fullfaalt daar door het ontwerp; productie maakt gebruik van een certificaat uitgegeven voor*.db.<your-domain>. - Beperkt tot uw project. De router kiest uw database uit de rolnaam en forceert deze: het vragen om een andere databasenaam komt nog steeds in de uwe terecht, en het presenteren van uw rol op de host van een ander project wordt geweigerd. Uw rol is geen superuser en omzeilt RLS niet; Om een migratie uit te voeren als tabeleigenaar, gebruikt u
BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;. - Tabellen die u hier maakt, zijn privé op het platform. Beveiliging op rijniveau kan niet automatisch worden ingeschakeld voor een tabel die via deze verbinding is gemaakt (die een PostgreSQL superuser nodig heeft, die een beheerd project nooit openbaar maakt), dus de openbare sleutels krijgen er geen privilege op: de REST API antwoordt
permission deniedop de anon-sleutel en op ingelogde gebruikers, terwijl deservice_role-sleutel, Studio en uw eigen rol deze lezen en schrijven. Om het beschikbaar te maken voor de SDK, schakelt u RLS in, verleent u het beleid en voegt u vervolgens een beleid toe (zie Beveiliging op rijniveau):ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …. PostgREST leert over de nieuwe tabel wanneer uNOTIFY pgrst, 'reload schema'uitvoert. Tabellen die via deze verbinding zijn gemaakt voordat deze regel bestond, worden gesloten de volgende keer dat u een wachtwoord (aura db connection --new-password) opgeeft, tenzij RLS al is ingeschakeld. - Transactiepooler. Verbindingen lopen via PgBouncer in transactiemodus. De sessiestatus wordt niet overgedragen van de ene transactie naar de volgende: gebruik
SET LOCALbinnen een transactie en verwacht dat benoemde voorbereide instructies,LISTENen adviesvergrendelingen op sessieniveau niet betrouwbaar zijn (Prisma: voegpgbouncer=truetoe aan de URL). - Clientversie.
pg_dumpweigert een server die nieuwer is dan hijzelf: gebruik een PostgreSQL 18 client (pg_dump --version).
Directe toegang is afhankelijk van de implementatie die de PostgreSQL-poort publiceert. Het is ingeschakeld voor de lokale k3d-stack en voor implementaties waarvan de Helm-waarden dit inschakelen (ingress.tcp.enabled achter ingress-nginx, of pgproxy.nodePort); de Studio en aura db connection vertellen u wanneer dit niet het geval is.
Om verder te gaan#
- Beveiliging op rijniveau
Systeemeigen beleid, testen, patronen voor meerdere tenants.
- Conventies
Benoeming van schema's, kolommen, beleid, RLS helpers.
- Databasetakken
Een kopie van een project voor elke pull-aanvraag, verwijderd door de TTL ervan.
- Architectuur
Hoe aura-db in de 8 diensten past.
- REST-API
Ruw HTTP-oppervlak voor database, authenticatie en opslag.
- Supabase Migratie
pg_dump + RLS remap, 1 uur voor een gemiddeld project.