Datenbank
PostgreSQL 18, eine dedizierte Datenbank pro Projekt im Cluster Ihrer Organisation, isolierte Schemata, automatisch generierte TypeScript-Typen, natives RLS. Keine Forks, keine Rewrite-Proxys – Ihre Erweiterungen, Trigger und PL/pgSQL funktionieren wie sie sind.
Postgres 18, ohne Abstraktion#
Der aura-db-Dienst stellt ein generisches CRUD auf einem PostgreSQL bereit. 18: Jedes Projekt verfügt über eine eigene Datenbank, die im PostgreSQL-Cluster Ihrer Organisation gehostet wird (ein Cluster, der vollständig einem einzelnen Projekt im Unternehmensangebot gewidmet ist). Jeder SDK-Aufruf wird über eine dünne Schicht in natives SQL übersetzt, die den in die Sitzung eingefügten RLS policies berücksichtigt.
Sie können das SDK auch umgehen und psql, Prisma, Drizzle, Kysely, Metabase oder pg_dump auf Ihre Datenbank verweisen: Standard-PostgreSQL-Drahtprotokoll, TLS, eine Rolle, die nur die-Datenbank Ihres Projekts erreichen kann. Siehe Direkt verbinden unten. (Eine Bereitstellung, die den PostgreSQL-Port nicht veröffentlicht, sagt dies in Studio › Einstellungen › Verbindung: Verwenden Sie das SDK, die REST-API, den SQL-Editor oder die CLI, aura db raw.)
Ein pg_dump bietet Ihnen Ihre vollständige Datenbank (Schema, Daten, Erweiterungen, Richtlinien). Keine Lock-Ins, einfache Outbound-Migration.
Das SDK ruft PostgREST auf, wodurch Postgres aufgerufen wird.#
Unter der Haube serialisiert das SDK Ihre .from().select()…-Aufrufe in eine HTTP-Anfrage an aura-db, die an einen PostgREST-Sidecar delegiert. PostgREST übersetzt in SQL und öffnet eine Poolverbindung über PgBouncer mit dem search_path des injizierten Projekts.
SDK → HTTPS GET /v1/db/sensors?select=id,name
Gateway → aura-db Session verification & routing
aura-db → PgBouncer → PostgreSQL 18
# Verbindung mit dem search_path-Projekt
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-Richtlinien haben Zugriff auf auth.uid(), auth.role(), auth.tenant(). Diese Helfer lesen vom Gateway injizierte request.jwt.claims – eine Manipulation auf der Clientseite ist nicht möglich.
Sechs native Fähigkeiten#
- Schema pro Projekt. Partitionierung angewendet durch PostgreSQL: keine Spalte „manant_id“, eine Verbindungsrolle pro Projekt, Rechte werden nie für PUBLIC geöffnet.
- Versionierte Migrationen. Versioniertes SQL, atomares Rollback, keine Ausfallzeit. TypeScript-Typen werden bei jeder Migration neu generiert.
- Codegen TypeScript & Rust. Automatische Generierung von Typen für Tabellen, Ansichten, Aufzählungen und RPC-Funktionen aus Ihrem Live-Schema.
- Native RLS. Testbare deklarative Richtlinien. Das SDK fügt den Anspruchsmieter in jede Verbindung ein.
- Erweiterungen auf der Zulassungsliste. 14 Erweiterungen, die von der Plattform beim Erstellen eines Projekts installiert werden:
pgvector,pgcrypto,uuid-ossp,pg_trgm,pg_graphql,pg_stat_statements,citext,hstore,ltree,unaccent,btree_gin,btree_gist,fuzzystrmatch,intarray. - Datenbankzweige.
aura branch createkopiert ein Projekt (Schema, Richtlinien, Funktionen, Trigger, Ansichten und Zeilen) in ein neues Projekt mit eigener URL und eigenen Schlüsseln, das nach Ablauf seiner Lebensdauer automatisch gelöscht wird. Eine zum Zeitpunkt der Erstellung erstellte Kopie, keine Live-Replik.
CRUD vollständig, getippt#
Die vier Grundoperationen nutzen dieselbe .from(table)-Oberfläche. Zurückgegebene Typen werden aus Ihrem Schema abgeleitet – öffnen Sie Ihre IDE, die automatische Vervollständigung funktioniert für Spalten, Verknüpfungen und Rückgaben.
// Listen Sie die letzten 50 aktiven Sensoren auf
const { data, error } = await aura
.from('sensors')
.select('id, name, temperature, location!inner(city)')
.eq('active', true)
.order('captured_at', { ascending: false })
.limit(50)
Benötigen Sie komplexeres SQL? Erstellen Sie eine Postgres-Funktion und rufen Sie sie über aura.rpc('function_name', args) auf. Funktionen profitieren von denselben RLS-Richtlinien wie Tabellen.
14 Erweiterungen auf der Zulassungsliste stehen bereit#
14 Erweiterungen auf der Zulassungsliste, bereit für jedes neue Projekt
Die Plattform installiert sie, wenn das Projekt erstellt wird (eine Projektrolle kann CREATE EXTENSION nicht selbst ausführen, daher ist kein Aktivierungsschritt zu vergessen). Listen Sie auf, was mit aura db extensions list oder installiert wird. Studio › Datenbank › Erweiterungen; aura db extensions enable <name> und POST /v1/db/{project_id}/schema/extensions wenden einen zulässigen erneut an.
- pgvector (
vector) - pg_graphql (wird installiert, wenn Sie GraphQL aktivieren)
- pg_stat_statements
- pgcrypto
- uuid-ossp
- pg_trgm
- Zitext
- hstore
- ltree
- ohne Akzent
- btree_gin
- btree_gist
- fuzzystrmatch
- Intarray
postgis, pg_cron, timescaledb, pgmq und pg_partman sind nicht im standardmäßig verwalteten Image enthalten. Lösen Sie für geplante Workloads eine Edge-Funktion in einem Cron-Zeitplan in Cron aus. Ein vor dieser Änderung erstelltes Projekt verfügt nur über die fünf historischen Erweiterungen (vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql), bis die Plattform ihr nächstes Schema-Update ausführt; Sie können die anderen nicht selbst hinzufügen, da nur der Datenbankbetreiber sie installieren kann.
Direkt verbinden: psql, Prisma, Drizzle, pg_dump#
Jedes Projekt hat seine eigene PostgreSQL-Anmelderolle (proj_xxxxxxxx) und einen Host der Form <project-slug>.db.<your-domain> auf Port 5432. Das Passwort wird auf Anfrage ausgegeben und einmal angezeigt: Die Plattform hält es nicht im Klartext, sodass ein verlorenes Passwort ersetzt und nie wiederhergestellt wird.
# Host, Port, Datenbank und Rolle des verknüpften Projekts (kein Passwort)
aura db connection
# Vergeben Sie ein Passwort und drucken Sie die vollständige Verbindungszeichenfolge aus (widerruft das vorherige Passwort)
aura db connection --new-password
# Öffnen Sie psql darauf (psql fragt nach dem Passwort)
aura connect
aura db connection --new-password gibt eine Zeichenfolge aus, die Sie an einer beliebigen Stelle einfügen können:
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require
Die gleiche Karte existiert in Studio › Einstellungen › Verbindung › Datenbank (Passwort generieren / Passwort zurücksetzen).
- TLS ist erforderlich. Der Endpunkt lehnt Klartextverbindungen ab (
sslmode=require). Auf einem lokalen k3d-Stack ist das Zertifikat selbstsigniert (*.db.localhost), daher schlägtsslmode=verify-fulldort konstruktionsbedingt fehl; Die Produktion verwendet ein für*.db.<your-domain>ausgestelltes Zertifikat. - Auf Ihr Projekt beschränkt. Der Router wählt Ihre Datenbank anhand des Rollennamens aus und erzwingt sie: Wenn Sie nach einem anderen Datenbanknamen fragen, landen Sie immer noch in Ihrer Datenbank, und die Präsentation Ihrer Rolle auf dem Host eines anderen Projekts wird abgelehnt. Ihre Rolle ist kein Superuser und umgeht RLS nicht; Um eine Migration als Tabelleneigentümer durchzuführen, verwenden Sie
BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;. - Tabellen, die Sie hier erstellen, sind für die Plattform privat. Row Level Security kann nicht automatisch für eine über diese Verbindung erstellte Tabelle aktiviert werden (die einen PostgreSQL-Superuser benötigt, den ein verwaltetes Projekt niemals verfügbar macht), daher erhalten die öffentlichen Schlüssel keine Berechtigung dafür: Die REST-API antwortet
permission deniedauf den anonymen Schlüssel und auf angemeldete Benutzer, während derservice_role-Schlüssel, Studio und Ihre eigene Rolle ihn lesen und schreiben. Um es dem SDK verfügbar zu machen, aktivieren Sie RLS, gewähren Sie es und fügen Sie dann eine Richtlinie hinzu (siehe Sicherheit auf Zeilenebene):ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …. PostgREST erfährt mehr über die neue Tabelle, wenn SieNOTIFY pgrst, 'reload schema'ausführen. Tabellen, die über diese Verbindung erstellt wurden, bevor diese Regel existierte, werden geschlossen, wenn Sie das nächste Mal ein Passwort (aura db connection --new-password) vergeben, es sei denn, für sie ist RLS bereits aktiviert. - Transaktionspooler. Verbindungen laufen über PgBouncer im Transaktionsmodus. Der Sitzungsstatus wird nicht von einer Transaktion zur nächsten übertragen: Verwenden Sie
SET LOCALinnerhalb einer Transaktion und gehen Sie davon aus, dass benannte vorbereitete Anweisungen,LISTENund Beratungssperren auf Sitzungsebene nicht zuverlässig sind (Prisma:pgbouncer=truezur URL hinzufügen). - Client-Version.
pg_dumplehnt einen Server ab, der neuer als er selbst ist: Verwenden Sie einen PostgreSQL 18-Client (pg_dump --version).
Der direkte Zugriff hängt von der Bereitstellung ab, die den PostgreSQL-Port veröffentlicht. Es ist für den lokalen k3d-Stack und für Bereitstellungen aktiviert, deren Helm-Werte es aktivieren (ingress.tcp.enabled hinter ingress-nginx oder pgproxy.nodePort); Das Studio und aura db connection sagen Ihnen, wenn dies nicht der Fall ist.
Um weiter zu gehen#
- Sicherheit auf Zeilenebene
Native Richtlinien, Tests, mandantenfähige Muster.
- Konventionen
Benennung von Schemata, Spalten, Richtlinien und RLS-Helfern.
- Datenbankzweige
Eine Kopie eines Projekts für jede Pull-Anfrage, gelöscht durch seine TTL.
- Architektur
Wie aura-db in die 8 Dienste passt.
- REST-API
Rohe HTTP-Oberfläche für Datenbank, Authentifizierung, Speicherung.
- Supabase Migration
pg_dump + RLS remap, 1 Stunde für ein durchschnittliches Projekt.