Vai al contenuto
Logo Aurabase
aurabase

Migra da Supabase

L'API client, le policy RLS e Edge Functions vengono trasferite. La CLI esporta i tuoi utenti Supabase con i relativi hash delle password bcrypt, ripristina un semplice pg_dump (istruzioni, corpi delle funzioni, dati COPY) e importa gli utenti: questa pagina dice esattamente cosa riporta ogni passaggio e dove si ferma.

Guida pratica10 min lettoLivello intermedioRevisionato il 10 nov 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

95% uguale a Supabase#

L'API client, le policy RLS, il modello di autenticazione e l'archiviazione seguono le convenzioni di Supabase, quindi il codice dell'applicazione cambia molto poco. La tabella seguente indica cosa è uguale e cosa no.

CaratteristicaCompatibilitàNota
createClient()Lo stessoImporta @aurabase/aurabase-js invece di @supabase/supabase-js
.from().select()Lo stessoStessa API PostgREST concatenabile
RLS politicheLo stessoPostgres Criteri SQL. to authenticated, to anon e to service_role sono accettati come alias di aura_authenticated, aura_anon e aura_service_role. Questi ruoli vengono creati con il cluster database del progetto; su un cluster creato prima di tale modifica, scrivere i nomi dei ruoli aura_*.
auth.uid() e auth.role()Lo stessoAiutanti compatibili richiesta per richiesta
auth.getUser()Piccola differenzadata è l'utente (data.email); Supabase restituisce { data: { user } }. Il codice scritto come const { data: { user } } = await supabase.auth.getUser() ottiene user === undefined qui: scrivi const { data: user } = await aura.auth.getUser()
.rpc()Lo stessoStessa firma per le funzioni Postgres
.storage.from().upload()Lo stessoS3-API compatibile con percorsi identici
.channel().on("postgres_changes")Lo stessoStessa superficie di acquisizione dei dati di modifica
Edge Functions (Deno)Lo stessoTempo di esecuzione standard Deno; Deno.serve() funziona senza riscrittura
Ganci di autenticazionePiccola differenzaWebhook HTTP ed endpoint dedicati
Chiave del ruolo del servizioLo stessoStesso ruolo, stesso ambito

Quattro comandi, in ordine#

  1. Esporta — aura migrate export-supabase scrive users.json (utenti, hash delle password, identità OAuth) e dump.sql (pg_dump dello schema, struttura e dati public)
  2. Restore — aura db restore dump.sql riproduce il dump nel progetto collegato
  3. Importa utenti — aura auth import users.json; gli utenti mantengono il proprio ID e la propria password
  4. Cutover: cambia l'URL e le chiavi nella tua app; distribuisci il tuo Edge Functions invariato
terminalbash
# 1. Esporta da Supabase (Impostazioni > Database > stringa di connessione, ruolo `postgres`)
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export

# 2. Ripristinare lo schema e i dati nel progetto Aurabase collegato
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run   # analizzare e stampare solo il piano
aura db restore ./supabase-export/dump.sql

# 3. Importa gli utenti, con i relativi hash delle password
aura auth import ./supabase-export/users.json

Ripristinare lo schema e i dati#

aura migrate export-supabase esegue pg_dump --schema=public --no-owner --no-acl --format=plain con il tuo pg_dump locale (installa gli strumenti client PostgreSQL; senza di essi, il comando stampa la riga esatta pg_dump per eseguire te stesso).

aura db restore <file.sql> legge un semplice SQL dump come fa psql: le istruzioni sono divise all'esterno di stringhe, identificatori tra virgolette, commenti e corpi tra virgolette in dollari ($$ … $$, $fn$ … $fn$), i blocchi COPY … FROM stdin vengono letti fino alla loro riga \. e psql i meta-comandi (\connect, \restrict) vengono saltati. Quindi:

  • rimuove il qualificatore public. che pg_dump scrive, quindi le tabelle finiscono nello schema del progetto (--source-schema per un altro schema);
  • salta ciò che non ha significato su Aurabase e dice perché: impostazioni della sessione (SET, set_config), OWNER TO, GRANT/REVOKE dei ruoli Supabase, CREATE EXTENSION (le estensioni sono gestite da Aurabase), CREATE SCHEMA public;
  • esegue tutto il resto nell'ordine del file e si ferma al primo passaggio non riuscito con il suo numero, la sua riga di dump e l'errore. Risolvi la causa e riprendi con --from <step> oppure passa --continue-on-error per superare i passaggi non riusciti e ottenere l'elenco alla fine. --dry-run stampa il piano senza eseguire nulla.

Due percorsi, scelti come aura db push:

Progetto collegato, no DATABASE_URLDATABASE_URL impostato (stringa di connessione diretta)
TrasportiUna chiamata API SQL per istruzione, convalidata dal serverUna connessione PostgreSQL
COPY datiConvertito in batch INSERT (500 righe)Protocollo COPY, dati come scaricati
Funzioni, trigger, blocchi DORifiutato dall'API SQL: creali con aura db function create e aura db trigger createCreato
Confine di sicurezzaLa politica di isolamento del server per il progettoIl ruolo PostgreSQL del progetto (solo il proprio database, nessun superutente, si applica la sicurezza a livello di riga)

Sul percorso API SQL, il server rifiuta anche stringhe E'…', riferimenti ad altri schemi e, in un'istruzione, testo che assomiglia a un comando proibito, anche all'interno di una stringa letterale: una riga di dati contenente tale testo fallisce con il suo numero di passo. Usa il percorso diretto per quei dump. La stringa di connessione diretta si trova in Impostazioni › Connessione quando la distribuzione pubblica l'accesso diretto PostgreSQL.

Il ripristino viene eseguito in sequenza: viene ordinato un semplice dump SQL (tabelle, quindi dati, quindi vincoli e indici) e non ha un grafico delle dipendenze da parallelizzare. Non viene pubblicata alcuna cifra di throughput.

Attenzione

I riferimenti a auth.users non vengono ripristinati così come sono. Aurabase L'autenticazione non mantiene i propri utenti in una tabella auth.users, quindi una chiave esterna come REFERENCES auth.users(id) fallisce. Ripristina con --continue-on-error e mantieni le colonne user_id senza tale vincolo: gli ID utente vengono conservati dall'importazione di seguito, quindi i valori corrispondono ancora.

Utenti e password#

aura migrate export-supabase legge auth.users e auth.identities e scrive, per ciascun utente: l'originale id, l'email, email_verified, l'bcrypt hash di encrypted_password, il nome e i metadati (raw_user_meta_data e raw_app_meta_data senza i tasti provider/providers di Supabase) e le identità OAuth collegate (Google, GitHub…). Il file è leggibile solo da te: contiene gli hash delle password, eliminalo dopo l'importazione.

aura auth import users.json invia gli utenti in batch di 1.000 all'API di importazione dell'amministratore e stampa ogni riga che non viene creata (skipped quando l'e-mail o l'ID esiste già, error con il motivo). Eseguirlo nuovamente è sicuro: gli utenti esistenti non verranno mai sovrascritti.

All'accesso, Aurabase Auth verifica l'hash bcrypt, quindi lo sostituisce con un hash Argon2id: i tuoi utenti mantengono la propria password e non fanno nulla. L'importazione accetta hash bcrypt $2a$, $2b$ e $2y$ con un costo da 4 a 12 (Supabase utilizza 10) e hash Argon2id con parametri limitati; qualsiasi altro formato viene rifiutato riga per riga. Gli utenti OAuth accedono nuovamente con lo stesso provider e accedono allo stesso account.

Attenzione

Non riportato: MFA fattori (TOTP, telefono), sessioni attive e token di aggiornamento (ogni utente accede nuovamente), divieti, utenti solo telefono, anonimi ed eliminati (contati e segnalati dall'esportazione). Gli utenti con MFA devono registrarsi nuovamente.

Nativo Deno: zero riscritture#

Aurabase esegue un runtime Deno standard. Le tue funzioni che utilizzano Deno.serve() sono compatibili al 100% senza modifiche:

functions/hello.tstypescript
// Funzione Deno standard: funziona così com'è su Aurabase
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(
    JSON.stringify({ message: `Hello ${name}!` }),
    { headers: { 'content-type': 'application/json' } }
  )
})

Per andare oltre#