Migreren van Supabase
De client-API, het RLS-beleid en de Edge Functions worden overgedragen. De CLI exporteert uw Supabase-gebruikers met hun bcrypt-wachtwoord-hashes, herstelt een gewone pg_dump (statements, functie-instanties, COPY-gegevens) en importeert de gebruikers: deze pagina zegt precies wat elke stap overdraagt en waar deze stopt.
95% hetzelfde als Supabase#
De client-API, het RLS-beleid, het auth-model en de opslag volgen de conventies van Supabase, dus de applicatiecode verandert heel weinig. In onderstaande tabel staat wat hetzelfde is en wat niet.
| Functie | Compatibiliteit | Let op |
|---|---|---|
createClient() | Hetzelfde | Importeer @aurabase/aurabase-js in plaats van @supabase/supabase-js |
.from().select() | Hetzelfde | Dezelfde schakelbare PostgREST API |
| RLS beleid | Hetzelfde | Postgres SQL-beleid. to authenticated, to anon en to service_role worden geaccepteerd als aliassen van aura_authenticated, aura_anon en aura_service_role. Deze rollen worden gemaakt met het databasecluster van het project; op een cluster dat vóór die wijziging is gemaakt, schrijft u de rolnamen aura_*. |
auth.uid() en auth.role() | Hetzelfde | Helpers compatibel claim voor claim |
auth.getUser() | Klein verschil | data is de gebruiker (data.email); Supabase retourneert { data: { user } }. Code geschreven als const { data: { user } } = await supabase.auth.getUser() krijgt hier user === undefined: schrijf const { data: user } = await aura.auth.getUser() |
.rpc() | Hetzelfde | Dezelfde handtekening voor Postgres-functies |
.storage.from().upload() | Hetzelfde | S3-compatibele API met identieke paden |
.channel().on("postgres_changes") | Hetzelfde | Hetzelfde oppervlak voor het vastleggen van wijzigingsgegevens |
| Edge Functions (Deno) | Hetzelfde | Standaard Deno runtime; Deno.serve() werkt zonder herschrijven |
| Authenticatiehaken | Klein verschil | HTTP-webhooks en speciale eindpunten |
| Servicerol sleutel | Hetzelfde | Zelfde rol, zelfde reikwijdte |
Vier commando's, op volgorde#
- Exporteren —
aura migrate export-supabaseschrijftusers.json(gebruikers, wachtwoord-hashes, OAuth identiteiten) endump.sql(pg_dumpvan hetpublicschema, structuur en gegevens) - Herstellen —
aura db restore dump.sqlspeelt de dump af in het gekoppelde project - Gebruikers importeren —
aura auth import users.json; gebruikers behouden hun ID en hun wachtwoord - Cutover — verander de URL en de sleutels in uw app; implementeer uw Edge Functions ongewijzigd
# 1. Exporteren vanuit Supabase (Instellingen > Database > verbindingsreeks, rol `postgres`)
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export
# 2. Herstel het schema en de gegevens in het gekoppelde Aurabase-project
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run # alleen het plan parseren en afdrukken
aura db restore ./supabase-export/dump.sql
# 3. Importeer de gebruikers, met hun wachtwoord-hashes
aura auth import ./supabase-export/users.json
Herstel het schema en de gegevens#
aura migrate export-supabase voert pg_dump --schema=public --no-owner --no-acl --format=plain uit met uw lokale pg_dump (installeer de PostgreSQL clienttools; zonder deze drukt de opdracht de exacte pg_dump regel af om zelf uit te voeren).
aura db restore <file.sql> leest een gewone SQL dump zoals psql dat doet: instructies worden gesplitst buiten strings, tussen aangehaalde identifiers, commentaren en in dollars genoteerde lichamen ($$ … $$, $fn$ … $fn$), COPY … FROM stdin blokken worden gelezen tot aan hun \. regel, en psql meta-opdrachten (\connect, \restrict) worden overgeslagen. Het dan:
- verwijdert de kwalificatie
public.diepg_dumpschrijft, zodat tabellen in het projectschema terechtkomen (--source-schemavoor een ander schema); - slaat over wat geen betekenis heeft op Aurabase en zegt waarom: sessie-instellingen (
SET,set_config),OWNER TO,GRANT/REVOKEvan de Supabase rollen,CREATE EXTENSION(extensies worden beheerd door Aurabase),CREATE SCHEMA public; - voert al het andere uit in de volgorde van het bestand, en stopt bij de eerste mislukte stap met zijn nummer, zijn dumpregel en de fout. Los de oorzaak op en ga verder met
--from <step>, of geef--continue-on-errordoor om de mislukte stappen te doorlopen en de lijst aan het einde te krijgen.--dry-rundrukt het plan af zonder iets uit te voeren.
Twee paden, gekozen als aura db push:
Gekoppeld project, geen DATABASE_URL | DATABASE_URL set (directe verbindingsreeks) | |
|---|---|---|
| Vervoer | Eén SQL API-aanroep per instructie, gevalideerd door de server | Eén PostgreSQL-verbinding |
COPY gegevens | Omgerekend naar INSERT batches (500 rijen) | COPY-protocol, gegevens zoals gedumpt |
Functies, triggers, DO blokken | Geweigerd door de SQL API: maak ze aan met aura db function create en aura db trigger create | Gemaakt |
| Veiligheidsgrens | Het isolatiebeleid van de server voor het project | De PostgreSQL-rol van het project (alleen de eigen database, geen superuser, beveiliging op rijniveau is van toepassing) |
Op het SQL API-pad weigert de server ook E'…'-tekenreeksen, verwijzingen naar andere schema's en, in een instructie, tekst die op een verboden opdracht lijkt, zelfs binnen een letterlijke tekenreeks: een gegevensrij die dergelijke tekst bevat, faalt met zijn stapnummer. Gebruik het directe pad voor die dumps. De directe verbindingsreeks bevindt zich in Instellingen › Verbinding wanneer uw implementatie directe PostgreSQL-toegang publiceert.
Herstel voert opeenvolgend uit: er wordt een gewone SQL-dump besteld (tabellen, dan gegevens, dan beperkingen en indexen) en er is geen afhankelijkheidsgrafiek om te parallelliseren. Er wordt geen overslagcijfer gepubliceerd.
Verwijzingen naar auth.users worden niet zoals ze zijn hersteld. Aurabase Auth houdt zijn gebruikers niet in een auth.users tabel, dus een externe sleutel zoals REFERENCES auth.users(id) mislukt. Herstel met --continue-on-error en behoud de kolommen user_id zonder die beperking: de gebruikers-ID's blijven behouden door de onderstaande import, dus de waarden komen nog steeds overeen.
Gebruikers en wachtwoorden#
aura migrate export-supabase leest auth.users en auth.identities en schrijft voor elke gebruiker: de originele id, de e-mail, email_verified, de bcrypt-hash van encrypted_password, de naam en de metagegevens (raw_user_meta_data en raw_app_meta_data zonder Supabase's eigen provider/providers sleutels), en de gekoppelde OAuth identiteiten (Google, GitHub…). Het bestand is alleen voor u leesbaar geschreven: het bevat wachtwoord-hashes, verwijder het na het importeren.
aura auth import users.json stuurt de gebruikers in batches van 1.000 naar de admin import API en drukt elke regel af die niet is gemaakt (skipped als het e-mailadres of de ID al bestaat, error met de reden). Opnieuw uitvoeren is veilig: bestaande gebruikers worden nooit overschreven.
Bij het inloggen verifieert Aurabase Auth de bcrypt-hash en vervangt deze vervolgens door een Argon2id-hash: uw gebruikers behouden hun wachtwoord en doen niets. De import accepteert bcrypt-hashes $2a$, $2b$ en $2y$ met een kostprijs van 4 tot 12 (Supabase gebruikt 10), en Argon2id-hashes met begrensde parameters; elk ander formaat wordt regel voor regel geweigerd. OAuth gebruikers loggen opnieuw in bij dezelfde provider en komen op hetzelfde account terecht.
Niet overgedragen: MFA factoren (TOTP, telefoon), actieve sessies en vernieuwingstokens (elke gebruiker logt opnieuw in), bans, alleen-telefoon, anonieme en verwijderde gebruikers (geteld en gerapporteerd door de export). Gebruikers met MFA moeten zich opnieuw inschrijven.
Native Deno — nul herschrijvingen#
Aurabase voert een standaard Deno runtime uit. Uw functies die Deno.serve() gebruiken, zijn 100% compatibel zonder aanpassingen:
// Standaard Deno-functie — werkt zoals op Aurabase
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(
JSON.stringify({ message: `Hello ${name}!` }),
{ headers: { 'content-type': 'application/json' } }
)
})