Przejdź do treści
Logo Aurabase
aurabaza

Przeprowadź migrację z Supabase

Interfejs API klienta, zasady RLS i Edge Functions zostają przeniesione. Interfejs CLI eksportuje użytkowników Supabase z ich skrótami haseł bcrypt, przywraca zwykły pg_dump (instrukcje, treści funkcji, dane COPY) i importuje użytkowników: ta strona opisuje dokładnie, co przenosi każdy krok i gdzie się kończy.

Przewodnik krok po kroku10 min przeczytanePoziom mediatorZmieniono 10 lis 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

95% tak samo jak Supabase#

Interfejs API klienta, zasady RLS, model uwierzytelniania i pamięć są zgodne z konwencjami Supabase, więc kod aplikacji zmienia się bardzo niewiele. Poniższa tabela pokazuje, co jest takie samo, a co nie.

FunkcjaZgodnośćNotatka
createClient()To samoImportuj @aurabase/aurabase-js zamiast @supabase/supabase-js
.from().select()To samoTen sam łańcuchowy interfejs API PostgREST
RLS zasadyTo samoPostgres Zasady SQL. to authenticated, to anon i to service_role są akceptowane jako aliasy aura_authenticated, aura_anon i aura_service_role. Te role są tworzone za pomocą klastra bazy danych projektu; w klastrze utworzonym przed tą zmianą wpisz nazwy ról aura_*.
auth.uid() i auth.role()To samoPomocnicy kompatybilni z każdym roszczeniem
auth.getUser()Niewielka różnicadata to użytkownik (data.email); Supabase zwraca { data: { user } }. Kod zapisany jako const { data: { user } } = await supabase.auth.getUser() otrzymuje user === undefined tutaj: napisz const { data: user } = await aura.auth.getUser()
.rpc()To samoTen sam podpis dla funkcji Postgres
.storage.from().upload()To samoS3-kompatybilne API z identycznymi ścieżkami
.channel().on("postgres_changes")To samoTa sama powierzchnia przechwytywania danych zmian
Edge Functions (Deno)To samoStandardowe środowisko wykonawcze Deno; Deno.serve() działa bez przepisywania
Haki uwierzytelniająceNiewielka różnicaWebhooki HTTP i dedykowane punkty końcowe
Klucz roli usługiTo samoTa sama rola, ten sam zakres

Cztery polecenia w kolejności#

  1. Eksport — aura migrate export-supabase zapisuje users.json (użytkownicy, skróty haseł, tożsamości OAuth) i dump.sql (pg_dump schematu, struktury i danych public)
  2. Restore — aura db restore dump.sql odtwarza zrzut do połączonego projektu
  3. Importuj użytkowników — aura auth import users.json; użytkownicy zachowują swój identyfikator i hasło
  4. Cutover — zmień adres URL i klucze w swojej aplikacji; wdróż Edge Functions bez zmian
terminalbash
# 1. Eksportuj z Supabase (Ustawienia > Baza danych > Parametry połączenia, rola `postgres`)
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export

# 2. Przywróć schemat i dane do połączonego projektu Aurabase
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run   # przeanalizuj i wydrukuj tylko plan
aura db restore ./supabase-export/dump.sql

# 3. Zaimportuj użytkowników wraz z ich skrótami haseł
aura auth import ./supabase-export/users.json

Przywróć schemat i dane#

aura migrate export-supabase uruchamia pg_dump --schema=public --no-owner --no-acl --format=plain z lokalnym pg_dump (zainstaluj narzędzia klienta PostgreSQL; bez nich polecenie wypisuje dokładną linię pg_dump, którą możesz uruchomić samodzielnie).

aura db restore <file.sql> odczytuje zwykły SQL zrzut w taki sam sposób, jak psql: instrukcje są rozdzielane na zewnątrz ciągów znaków, identyfikatorów w cudzysłowie, komentarzy i treści cytowanych w dolarach ($$ … $$, $fn$ … $fn$), bloki COPY … FROM stdin są odczytywane do linii \. i meta-polecenia psql (\connect, \restrict) są pomijane. To wtedy:

  • usuwa kwalifikator public. zapisywany przez pg_dump, więc tabele lądują w schemacie projektu (--source-schema w przypadku innego schematu);
  • pomija to, co nie ma znaczenia na Aurabase i mówi dlaczego: ustawienia sesji (SET, set_config), OWNER TO, GRANT/REVOKE ról Supabase, CREATE EXTENSION (rozszerzeniami zarządza Aurabase), CREATE SCHEMA public;
  • uruchamia wszystko inne w kolejności pliku, a zatrzymuje się na pierwszym nieudanym kroku z jego numerem, linią zrzutu i błędem. Napraw przyczynę i wznów za pomocą --from <step> lub przekaż --continue-on-error, aby ominąć nieudane kroki i uzyskać listę na końcu. --dry-run drukuje plan bez wykonywania czegokolwiek.

Dwie ścieżki wybrane jak aura db push:

Powiązany projekt, nr DATABASE_URLZestaw DATABASE_URL (ciąg połączenia bezpośredniego)
TransportJedno wywołanie API SQL na instrukcję, sprawdzane przez serwerJedno połączenie PostgreSQL
Dane COPYKonwertowane na partie INSERT (500 wierszy)Protokół COPY, dane w postaci zrzutu
Funkcje, wyzwalacze, bloki DOOdmówiono przez SQL API: utwórz je za pomocą aura db function create i aura db trigger createStworzony
Granica bezpieczeństwaPolityka izolacji serwera dla projektuRola PostgreSQL projektu (tylko własna baza danych, bez superużytkownika, obowiązują zabezpieczenia na poziomie wiersza)

Na ścieżce interfejsu API SQL serwer odrzuca również ciągi E'…', odniesienia do innych schematów oraz w instrukcji tekst, który wygląda na zabronione polecenie, nawet w literale ciągu: wiersz danych zawierający taki tekst nie zawiera numeru kroku. Użyj bezpośredniej ścieżki dla tych zrzutów. Parametry połączenia bezpośredniego znajdują się w Ustawienia > Połączenie, gdy wdrożenie publikuje bezpośredni dostęp PostgreSQL.

Przywracanie jest uruchamiane sekwencyjnie: zamawiany jest zwykły zrzut SQL (tabele, następnie dane, następnie ograniczenia i indeksy) i nie ma wykresu zależności do zrównoleglenia. Nie publikowano żadnych danych dotyczących przepustowości.

Uwaga

Odniesienia do auth.users nie są przywracane w niezmienionym stanie. Aurabase Auth nie przechowuje swoich użytkowników w tabeli auth.users, więc klucz obcy taki jak REFERENCES auth.users(id) kończy się niepowodzeniem. Przywróć za pomocą --continue-on-error i zachowaj kolumny user_id bez tego ograniczenia: identyfikatory użytkowników zostaną zachowane podczas importu poniżej, więc wartości nadal będą zgodne.

Użytkownicy i hasła#

aura migrate export-supabase odczytuje auth.users i auth.identities i zapisuje dla każdego użytkownika: oryginalny identyfikator, adres e-mail, email_verified, skrót bcrypt z encrypted_password, nazwę i metadane (raw_user_meta_data i raw_app_meta_data bez własnych kluczy provider/providers Supabase) i połączonych tożsamości OAuth (Google, GitHub…). Plik jest zapisywany w sposób czytelny tylko dla Ciebie: zawiera skróty haseł, usuń je po imporcie.

aura auth import users.json wysyła użytkowników w partiach po 1000 do interfejsu API importu administratora i wypisuje każdą nie utworzoną linię (skipped, jeśli adres e-mail lub identyfikator już istnieje, error z przyczyną). Ponowne uruchomienie jest bezpieczne: istniejący użytkownicy nigdy nie zostaną nadpisani.

Podczas logowania Aurabase Auth weryfikuje skrót bcrypt, a następnie zastępuje go skrótem Argon2id: Twoi użytkownicy zachowują swoje hasła i nic nie robią. Import akceptuje skróty bcrypt $2a$, $2b$ i $2y$ z kosztem od 4 do 12 (Supabase używa 10) oraz skróty Argon2id z ograniczonymi parametrami; każdy inny format jest odrzucany linia po linii. Użytkownicy OAuth logują się ponownie u tego samego dostawcy i trafiają na to samo konto.

Uwaga

Nie przeniesione: MFA czynniki (TOTP, telefon), aktywne sesje i tokeny odświeżania (każdy użytkownik loguje się ponownie), bany, użytkownicy korzystający tylko z telefonu, anonimowi i usunięci (zliczani i raportowani przez eksport). Użytkownicy z MFA muszą zarejestrować się ponownie.

Natywny Deno — zero przepisów#

Aurabase uruchamia standardowe środowisko wykonawcze Deno. Twoje funkcje korzystające z Deno.serve() są w 100% kompatybilne bez modyfikacji:

functions/hello.tstypescript
// Standardowa funkcja Deno — działa tak jak na Aurabase
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(
    JSON.stringify({ message: `Hello ${name}!` }),
    { headers: { 'content-type': 'application/json' } }
  )
})

Aby pójść dalej#