Naar de inhoud springen
Aurabase-logo
aurabasis

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.

Uitleg8 min lezenNiveau tussenproductHerzien op 15 apr 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

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.)

Tip

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.

interne stroomtext
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;
Info

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 create kopieert 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.

queries.tstypescript
// 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)
Tip

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
Info

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.

connect.shbash
# 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:

verbindingsreekstext
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), dus sslmode=verify-full faalt 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 denied op de anon-sleutel en op ingelogde gebruikers, terwijl de service_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 u NOTIFY 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 LOCAL binnen een transactie en verwacht dat benoemde voorbereide instructies, LISTEN en adviesvergrendelingen op sessieniveau niet betrouwbaar zijn (Prisma: voeg pgbouncer=true toe aan de URL).
  • Clientversie. pg_dump weigert een server die nieuwer is dan hijzelf: gebruik een PostgreSQL 18 client (pg_dump --version).
Info

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#