Von Supabase migrieren
Die Client-API, die RLS-Richtlinien und die Edge Functions-Übertragung. Die CLI exportiert Ihre Supabase-Benutzer mit ihren bcrypt-Passwort-Hashes, stellt einen einfachen pg_dump (Anweisungen, Funktionskörper, COPY-Daten) wieder her und importiert die Benutzer: Auf dieser Seite wird genau angegeben, was jeder Schritt überträgt und wo er aufhört.
95 % wie Supabase#
Die Client-API, die RLS-Richtlinien, das Authentifizierungsmodell und der Speicher folgen den Konventionen von Supabase, sodass sich der Anwendungscode nur sehr wenig ändert. Die folgende Tabelle gibt an, was gleich ist und was nicht.
| Funktion | Kompatibilität | Hinweis |
|---|---|---|
createClient() | Das Gleiche | @aurabase/aurabase-js statt @supabase/supabase-js importieren |
.from().select() | Das Gleiche | Gleiche verkettbare PostgREST-API |
| RLS-Richtlinien | Das Gleiche | Postgres SQL-Richtlinien. to authenticated, to anon und to service_role werden als Aliase von aura_authenticated, aura_anon und aura_service_role akzeptiert. Diese Rollen werden mit dem Datenbankcluster des Projekts erstellt; Schreiben Sie auf einem Cluster, der vor dieser Änderung erstellt wurde, die Rollennamen aura_*. |
auth.uid() und auth.role() | Das Gleiche | Helfer vereinbar Anspruch für Anspruch |
auth.getUser() | Kleiner Unterschied | data ist der Benutzer (data.email); Supabase gibt { data: { user } } zurück. Als const { data: { user } } = await supabase.auth.getUser() geschriebener Code erhält hier user === undefined: write const { data: user } = await aura.auth.getUser() |
.rpc() | Das Gleiche | Gleiche Signatur für Postgres-Funktionen |
.storage.from().upload() | Das Gleiche | S3-kompatible API mit identischen Pfaden |
.channel().on("postgres_changes") | Das Gleiche | Gleiche Oberfläche zur Erfassung von Änderungsdaten |
| Edge Functions (Deno) | Das Gleiche | Standard-Deno-Laufzeit; Deno.serve() funktioniert ohne Umschreiben |
| Auth-Hooks | Kleiner Unterschied | HTTP-Webhooks und dedizierte Endpunkte |
| Servicerollenschlüssel | Das Gleiche | Gleiche Rolle, gleicher Umfang |
Vier Befehle der Reihe nach#
- Export –
aura migrate export-supabaseschreibtusers.json(Benutzer, Passwort-Hashes, OAuth Identitäten) unddump.sql(pg_dumpdespublic-Schemas, Struktur und Daten) - Wiederherstellen –
aura db restore dump.sqlspielt den Dump im verknüpften Projekt erneut ab - Benutzer importieren —
aura auth import users.json; Benutzer behalten ihre ID und ihr Passwort - Cutover – Ändern Sie die URL und die Schlüssel in Ihrer App; Stellen Sie Ihr Edge Functions unverändert bereit
# 1. Export aus Supabase (Einstellungen > Datenbank > Verbindungszeichenfolge, Rolle „postgres“)
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export
# 2. Stellen Sie das Schema und die Daten im verknüpften Aurabase-Projekt wieder her
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run # Analysieren und drucken Sie nur den Plan
aura db restore ./supabase-export/dump.sql
# 3. Importieren Sie die Benutzer mit ihren Passwort-Hashes
aura auth import ./supabase-export/users.json
Stellen Sie das Schema und die Daten wieder her#
aura migrate export-supabase führt pg_dump --schema=public --no-owner --no-acl --format=plain mit Ihrem lokalen pg_dump aus (installieren Sie die PostgreSQL-Client-Tools; ohne diese gibt der Befehl die genaue pg_dump-Zeile aus, um sich selbst auszuführen).
aura db restore <file.sql> liest einen einfachen SQL-Dump wie psql: Anweisungen werden außerhalb von Zeichenfolgen, Bezeichnern in Anführungszeichen, Kommentaren und Körpern in Dollar-Anführungszeichen ($$ … $$, $fn$ … $fn$) aufgeteilt, COPY … FROM stdin-Blöcke werden bis zu ihrer \.-Zeile gelesen und psql-Metabefehle (\connect, \restrict). übersprungen. Es dann:
- Entfernt den Qualifizierer
public., denpg_dumpschreibt, sodass Tabellen im Projektschema landen (--source-schemafür ein anderes Schema); - überspringt, was auf Aurabase keine Bedeutung hat und sagt warum: Sitzungseinstellungen (
SET,set_config),OWNER TO,GRANT/REVOKEder Supabase-Rollen,CREATE EXTENSION(Erweiterungen werden von Aurabase verwaltet),CREATE SCHEMA public; - führt alles andere in der Reihenfolge der Datei aus und stoppt beim ersten fehlgeschlagenen Schritt mit seiner Nummer, seiner Dump-Zeile und dem Fehler. Beheben Sie die Ursache und fahren Sie mit
--from <step>fort, oder übergeben Sie--continue-on-error, um über fehlgeschlagene Schritte hinauszugehen und die Liste am Ende abzurufen.--dry-rundruckt den Plan, ohne etwas auszuführen.
Zwei Pfade, ausgewählt wie aura db push:
Verlinktes Projekt, kein DATABASE_URL | DATABASE_URL set (direkte Verbindungszeichenfolge) | |
|---|---|---|
| Transport | Ein SQL-API-Aufruf pro Anweisung, validiert vom Server | Eine PostgreSQL-Verbindung |
COPY Daten | Konvertiert in INSERT-Batches (500 Zeilen) | COPY-Protokoll, Daten wie ausgegeben |
Funktionen, Trigger, DO Blöcke | von der SQL-API abgelehnt: Erstellen Sie sie mit aura db function create und aura db trigger create | Erstellt |
| Sicherheitsgrenze | Die Isolationsrichtlinie des Servers für das Projekt | Die PostgreSQL-Rolle des Projekts (nur seine eigene Datenbank, kein Superuser, es gilt die Sicherheit auf Zeilenebene) |
Auf dem SQL-API-Pfad lehnt der Server außerdem E'…'-Zeichenfolgen, Verweise auf andere Schemata und in einer Anweisung Text ab, der wie ein verbotener Befehl aussieht, selbst innerhalb eines Zeichenfolgenliterals: Eine Datenzeile, die solchen Text enthält, schlägt mit ihrer Schrittnummer fehl. Verwenden Sie für diese Dumps den direkten Pfad. Die direkte Verbindungszeichenfolge befindet sich in den -Einstellungen › Verbindung, wenn Ihre Bereitstellung den direkten PostgreSQL-Zugriff veröffentlicht.
Die Wiederherstellung führt nacheinander aus: Ein einfacher SQL-Dump ist geordnet (Tabellen, dann Daten, dann Einschränkungen und Indizes) und verfügt über kein Abhängigkeitsdiagramm zum Parallelisieren. Es wird keine Durchsatzzahl veröffentlicht.
Verweise auf auth.users werden nicht im Ist-Zustand wiederhergestellt. Aurabase Auth behält seine Benutzer nicht in einer auth.users-Tabelle, daher schlägt ein Fremdschlüssel wie REFERENCES auth.users(id) fehl. Stellen Sie mit --continue-on-error wieder her und behalten Sie die user_id-Spalten ohne diese Einschränkung bei: Die Benutzer-IDs bleiben durch den Import unten erhalten, sodass die Werte weiterhin übereinstimmen.
Benutzer und Passwörter#
aura migrate export-supabase liest auth.users und auth.identities und schreibt für jeden Benutzer: die ursprüngliche -ID, die E-Mail email_verified, den bcrypt-Hash von encrypted_password, den Namen und die Metadaten (raw_user_meta_data, und raw_app_meta_data ohne Supabase s eigene provider/providers-Schlüssel) und die verknüpften OAuth Identitäten (Google, GitHub…). Die Datei ist nur für Sie lesbar geschrieben: Sie enthält Passwort-Hashes, löschen Sie sie nach dem Import.
aura auth import users.json sendet die Benutzer in Stapeln von 1.000 an die Admin-Import-API und gibt jede Zeile aus, die nicht erstellt wurde (skipped wenn die E-Mail oder die ID bereits vorhanden ist, error mit dem Grund). Die erneute Ausführung ist sicher: Vorhandene Benutzer werden niemals überschrieben.
Bei der Anmeldung überprüft Aurabase Auth den bcrypt-Hash und ersetzt ihn dann durch einen Argon2id-Hash: Ihre Benutzer behalten ihr Passwort und unternehmen nichts. Der Import akzeptiert bcrypt-Hashes $2a$, $2b$ und $2y$ mit Kosten von 4 bis 12 (Supabase verwendet 10) und Argon2id-Hashes mit begrenzten Parametern; jedes andere Format wird zeilenweise abgelehnt. OAuth-Benutzer melden sich erneut bei demselben Anbieter an und landen auf demselben Konto.
Nicht übertragen: MFA Faktoren (TOTP, Telefon), aktive Sitzungen und Aktualisierungstoken (jeder Benutzer meldet sich erneut an), Sperren, nur telefonische, anonyme und gelöschte Benutzer (vom Export gezählt und gemeldet). Benutzer mit MFA müssen sich erneut registrieren.
Native Deno – keine Umschreibungen#
Aurabase führt eine standardmäßige Deno-Laufzeit aus. Ihre Funktionen, die Deno.serve() verwenden, sind ohne Änderung zu 100 % kompatibel:
// Standardfunktion Deno – funktioniert wie bei Aurabase
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(
JSON.stringify({ message: `Hello ${name}!` }),
{ headers: { 'content-type': 'application/json' } }
)
})