İçeriğe geç
Aurabase Logosu
aura tabanı

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.

Nasıl yapılır kılavuzu10 dk. okuSeviye orta düzey10 Kas 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

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.

ÖzellikUyumlulukNot
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 farkdata 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 farkHTTP web kancaları ve özel uç noktalar
Hizmet rolü anahtarıAynıAynı rol, aynı kapsam

Sırayla dört komut#

  1. Dışa aktarma — aura migrate export-supabase, users.json (kullanıcılar, şifre karmaları, OAuth kimlikleri) ve dump.sql ( public şemasının, yapısının ve verilerinin pg_dump) yazar
  2. Geri Yükle — aura db restore dump.sql bağlantılı projedeki dökümü yeniden oynatır
  3. Kullanıcıları içe aktarın — aura auth import users.json; kullanıcılar kimliklerini ve şifrelerini saklar
  4. Cutover — uygulamanızdaki URL'yi ve anahtarları değiştirin; Edge Functions'inizi değiştirmeden dağıtın
terminalbash
# 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-error iletin. --dry-run hiçbir şeyi yürütmeden planı yazdırır.

aura db push gibi seçilen iki yol:

Bağlantılı proje, hayır DATABASE_URLDATABASE_URL set (doğrudan bağlantı dizesi)
TaşımaSunucu tarafından doğrulanan, ifade başına bir SQL API çağrısıBir PostgreSQL bağlantı
COPY verileriINSERT gruba dönüştürüldü (500 satır)COPY protokolü, veriler atılmış olarak
İşlevler, tetikleyiciler, DO bloklarSQL API tarafından reddedildi: bunları aura db function create ve aura db trigger create ile oluşturunOluş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ı.

Dikkat

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.

Dikkat

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:

functions/hello.tstypescript
// 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' } }
  )
})

Daha ileri gitmek için#