Supabase konumundan taşı
İstemci API'si, RLS politikaları ve Edge Functions aktarımı. CLI, Supabase kullanıcılarınızı bcrypt şifre karmalarıyla birlikte dışa aktarır, düz bir pg_dump'ı (ifadeler, işlev gövdeleri, COPY verileri) geri yükler ve kullanıcıları içe aktarır: bu sayfa her adımın tam olarak neyi taşıdığını ve nerede durduğunu belirtir.
Supabase ile %95 aynı#
İstemci API'si, RLS politikaları, kimlik doğrulama modeli ve depolama alanı Supabase kurallarına uyar, dolayısıyla uygulama kodu çok az değişir. Aşağıdaki tabloda neyin aynı olduğu ve neyin olmadığı belirtilmektedir.
| Özellik | Uyumluluk | Not |
|---|---|---|
createClient() | Aynı | @supabase/supabase-js yerine @aurabase/aurabase-js'yi içe aktar |
.from().select() | Aynı | Aynı zincirlenebilir PostgREST API |
| RLS politikaları | Aynı | Postgres SQL politikaları. to authenticated, to anon ve to service_role, aura_authenticated, aura_anon ve aura_service_role takma adları olarak kabul edilir. Bu roller projenin veritabanı kümesiyle oluşturulur; bu değişiklikten önce oluşturulan bir kümeye aura_* rol adlarını yazın. |
auth.uid() ve auth.role() | Aynı | Hak talebine göre yardımcılar uyumlu hak talebi |
auth.getUser() | Küçük fark | data kullanıcısıdır (data.email); Supabase, { data: { user } } değerini döndürür. const { data: { user } } = await supabase.auth.getUser() olarak yazılan kod buraya user === undefined alır: const { data: user } = await aura.auth.getUser() yazın |
.rpc() | Aynı | Postgres işlevleri için aynı imza |
.storage.from().upload() | Aynı | S3-aynı yollara sahip uyumlu API |
.channel().on("postgres_changes") | Aynı | Aynı değişiklik veri yakalama yüzeyi |
| Edge Functions (Deno) | Aynı | Standart Deno çalışma zamanı; Deno.serve() yeniden yazmaya gerek kalmadan çalışır |
| Kimlik doğrulama kancaları | Küçük fark | HTTP web kancaları ve özel uç noktalar |
| Hizmet rolü anahtarı | Aynı | Aynı rol, aynı kapsam |
Sırayla dört komut#
- Dışa aktarma —
aura migrate export-supabase,users.json(kullanıcılar, şifre karmaları, OAuth kimlikleri) vedump.sql(publicşemasının, yapısının ve verilerininpg_dump) yazar - Geri Yükle —
aura db restore dump.sqlbağlantılı projedeki dökümü yeniden oynatır - Kullanıcıları içe aktarın —
aura auth import users.json; kullanıcılar kimliklerini ve şifrelerini saklar - Cutover — uygulamanızdaki URL'yi ve anahtarları değiştirin; Edge Functions'inizi değiştirmeden dağıtın
# 1. Supabase'den dışa aktarın (Ayarlar > Veritabanı > bağlantı dizesi, 'postgres' rolü)
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export
# 2. Şemayı ve verileri bağlantılı Aurabase projesine geri yükleyin
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run # yalnızca planı ayrıştırın ve yazdırın
aura db restore ./supabase-export/dump.sql
# 3. Kullanıcıları şifre karmalarıyla birlikte içe aktarın
aura auth import ./supabase-export/users.json
Şemayı ve verileri geri yükleyin#
aura migrate export-supabase, pg_dump --schema=public --no-owner --no-acl --format=plain'yi yerel pg_dump ile çalıştırır (PostgreSQL istemci araçlarını yükleyin; bunlar olmadan komut, kendinizi çalıştırmak için tam pg_dump satırını yazdırır).
aura db restore <file.sql>, düz SQL dökümünü psql gibi okur: ifadeler dizelerin, tırnak içine alınmış tanımlayıcıların, yorumların ve dolar tırnaklı gövdelerin ($$ … $$, $fn$ … $fn$) dışına bölünür, COPY … FROM stdin blokları \. satırına kadar okunur ve psql meta komutları (\connect, \restrict) atlanır. O zaman:
pg_dump'nin yazdığıpublic.niteleyicisini kaldırır, böylece tablolar proje şemasına yerleşir (başka bir şema için--source-schema);- Aurabase üzerinde anlamı olmayan şeyleri atlar ve nedenini söyler: Supabase rollerinin oturum ayarları (
SET,set_config),OWNER TO,GRANT/REVOKE,CREATE EXTENSION(uzantılar Aurabase tarafından yönetilir),CREATE SCHEMA public; - geri kalan her şeyi dosya sırasına göre çalıştırır ve numarası, döküm satırı ve hatayla birlikte ilk başarısız olan adımında durur. Nedenini düzeltin ve
--from <step>ile devam edin veya başarısız olan adımları geçip sondaki listeyi almak için--continue-on-erroriletin.--dry-runhiçbir şeyi yürütmeden planı yazdırır.
aura db push gibi seçilen iki yol:
Bağlantılı proje, hayır DATABASE_URL | DATABASE_URL set (doğrudan bağlantı dizesi) | |
|---|---|---|
| Taşıma | Sunucu tarafından doğrulanan, ifade başına bir SQL API çağrısı | Bir PostgreSQL bağlantı |
COPY verileri | INSERT gruba dönüştürüldü (500 satır) | COPY protokolü, veriler atılmış olarak |
İşlevler, tetikleyiciler, DO bloklar | SQL API tarafından reddedildi: bunları aura db function create ve aura db trigger create ile oluşturun | Oluşturuldu |
| Güvenlik sınırı | Sunucunun proje için izolasyon politikası | Projenin PostgreSQL rolü (yalnızca kendi veritabanı, süper kullanıcı yok, Satır Düzeyinde Güvenlik uygulanır) |
Sunucu, SQL API yolunda ayrıca E'…' dizelerini, diğer şemalara yapılan referansları ve bir ifadede, bir dize değişmezi içinde bile yasaklanmış bir komuta benzeyen metni reddeder: bu tür bir metni içeren bir veri satırı, adım numarasıyla başarısız olur. Bu dökümler için doğrudan yolu kullanın. Dağıtımınız doğrudan PostgreSQL erişimi yayınladığında, doğrudan bağlantı dizesi Ayarlar › Bağlantı bölümünde bulunur.
Geri yükleme sıralı olarak çalışır: düz bir SQL dökümü sıralanır (tablolar, sonra veriler, ardından kısıtlamalar ve dizinler) ve paralelleştirilecek bir bağımlılık grafiği yoktur. Hiçbir üretim rakamı yayınlanmadı.
auth.users referansları olduğu gibi geri yüklenmez. Aurabase Auth, kullanıcılarını auth.users tablosunda tutmadığından REFERENCES auth.users(id) gibi bir yabancı anahtar başarısız olur. --continue-on-error ile geri yükleyin ve user_id sütunlarını bu kısıtlama olmadan tutun: kullanıcı kimlikleri aşağıdaki içe aktarma işlemiyle korunur, dolayısıyla değerler hâlâ eşleşir.
Kullanıcılar ve şifreler#
aura migrate export-supabase, auth.users ve auth.identities okur ve her kullanıcı için şunları yazar: orijinal kimliği, e-posta, email_verified, bcrypt karması encrypted_password, ad ve meta veriler (raw_user_meta_data ve raw_app_meta_data olmadan Supabase kendi provider/providers anahtarları) ve bağlantılı OAuth kimlikleri (Google, GitHub…). Dosya yalnızca sizin tarafınızdan okunabilecek şekilde yazılmıştır: parola karmalarını tutar, içe aktarmadan sonra silin.
aura auth import users.json, kullanıcıları 1.000'lik gruplar halinde yönetici içe aktarma API'sine gönderir ve oluşturulmamış her satırı yazdırır (skipped e-posta veya kimlik zaten mevcut olduğunda, error nedeni ile birlikte). Tekrar çalıştırmak güvenlidir: mevcut kullanıcıların üzerine hiçbir zaman yazılmaz.
Oturum açma sırasında, Aurabase Auth, bcrypt karmasını doğrular ve ardından bunu bir Argon2id karması ile değiştirir: kullanıcılarınız şifrelerini saklar ve hiçbir şey yapmaz. İçe aktarma, 4 ila 12 arası bir maliyetle $2a$, $2b$ ve $2y$ bcrypt karmalarını (Supabase 10 kullanır) ve sınırlı parametrelerle Argon2id karmalarını kabul eder; diğer formatlar satır satır reddedilir. OAuth kullanıcıları aynı sağlayıcıyla tekrar oturum açar ve aynı hesaba ulaşır.
Aktarılmaz: MFA faktörler (TOTP, telefon), aktif oturumlar ve yenileme jetonları (her kullanıcı bir kez daha oturum açar), yasaklar, yalnızca telefon, anonim ve silinmiş kullanıcılar (dışa aktarma tarafından sayılır ve raporlanır). MFA sahibi kullanıcıların tekrar kaydolması gerekir.
Yerel Deno — sıfır yeniden yazma#
Aurabase standart bir Deno çalışma zamanını çalıştırır. Deno.serve() kullanan işlevleriniz değişiklik yapılmadan %100 uyumludur:
// Standart Deno işlevi — Aurabase'de olduğu gibi çalışır
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(
JSON.stringify({ message: `Hello ${name}!` }),
{ headers: { 'content-type': 'application/json' } }
)
})