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.
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.
| Funkcja | Zgodność | Notatka |
|---|---|---|
createClient() | To samo | Importuj @aurabase/aurabase-js zamiast @supabase/supabase-js |
.from().select() | To samo | Ten sam łańcuchowy interfejs API PostgREST |
| RLS zasady | To samo | Postgres 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 samo | Pomocnicy kompatybilni z każdym roszczeniem |
auth.getUser() | Niewielka różnica | data 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 samo | Ten sam podpis dla funkcji Postgres |
.storage.from().upload() | To samo | S3-kompatybilne API z identycznymi ścieżkami |
.channel().on("postgres_changes") | To samo | Ta sama powierzchnia przechwytywania danych zmian |
| Edge Functions (Deno) | To samo | Standardowe środowisko wykonawcze Deno; Deno.serve() działa bez przepisywania |
| Haki uwierzytelniające | Niewielka różnica | Webhooki HTTP i dedykowane punkty końcowe |
| Klucz roli usługi | To samo | Ta sama rola, ten sam zakres |
Cztery polecenia w kolejności#
- Eksport —
aura migrate export-supabasezapisujeusers.json(użytkownicy, skróty haseł, tożsamości OAuth) idump.sql(pg_dumpschematu, struktury i danychpublic) - Restore —
aura db restore dump.sqlodtwarza zrzut do połączonego projektu - Importuj użytkowników —
aura auth import users.json; użytkownicy zachowują swój identyfikator i hasło - Cutover — zmień adres URL i klucze w swojej aplikacji; wdróż Edge Functions bez zmian
# 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 przezpg_dump, więc tabele lądują w schemacie projektu (--source-schemaw przypadku innego schematu); - pomija to, co nie ma znaczenia na Aurabase i mówi dlaczego: ustawienia sesji (
SET,set_config),OWNER TO,GRANT/REVOKEró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-rundrukuje plan bez wykonywania czegokolwiek.
Dwie ścieżki wybrane jak aura db push:
Powiązany projekt, nr DATABASE_URL | Zestaw DATABASE_URL (ciąg połączenia bezpośredniego) | |
|---|---|---|
| Transport | Jedno wywołanie API SQL na instrukcję, sprawdzane przez serwer | Jedno połączenie PostgreSQL |
Dane COPY | Konwertowane na partie INSERT (500 wierszy) | Protokół COPY, dane w postaci zrzutu |
Funkcje, wyzwalacze, bloki DO | Odmówiono przez SQL API: utwórz je za pomocą aura db function create i aura db trigger create | Stworzony |
| Granica bezpieczeństwa | Polityka izolacji serwera dla projektu | Rola 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.
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.
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:
// 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' } }
)
})