YENİPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Değişiklik günlüğüne bakın →

Mühendislik · 6 dk. okuma

Supabase öğesini Aurabase öğesine taşıyın, RLS öğenizi koruyun

Affane Daylami · Fondateur · 20 Eylül 2026

Bloga geri dön

Supabase kullanıyorsanız ve Aurabase'yi izliyorsanız (ayrıntılı karşılaştırmamıza bakın), iyi haber şu ki en zor kısım seçim yapmaktır. Aşağıdaki tablo, geçiş sırasında tam olarak hangi değişiklikleri listelemektedir ve kısadır: şema, RLS politikaları, SDK, kimlik doğrulama ve depolama aynı kalır.

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

Aurabase'de kendimize tasarım aşamasından itibaren güçlü bir kısıtlama verdik: SDK yüzeyi ve RLS sözleşmelerinin ile ile Supabase ile uyumlu olması gerekiyordu. Aynı createClient(), aynı .from().select().eq(), aynı SQL Postgres politikaları. Fikir: Eğer ayrılmak istiyorsan git; biz bunu önemsiz hale getiriyoruz. İşte tam taktik kitabı.

#
Önceki denetim

Ne hareket eder, ne kalır

Başlamadan önce nelerin değişeceğini, nelerin kalacağını listeleyin. Spoiler: çoğunluk kalıyor.

Postgres ŞemasıAYNIpg_dump → pg_restore. Uzantılar, tetikleyiciler, işlevler, dizinler; her şey yolunda.
RLS PolitikalarAYNIAynı sözdizimi. auth.uid(), auth.role(), auth.jwt() olduğu gibi çalışır.
JavaScript SDK'sı%95 AYNI@supabase/supabase-js'yi @aurabase/aurabase-js ile değiştirin. Aynı zincirlenebilir API.
Kimlik doğrulama akışlarıAYNISignUp, SignInWithPassword, SignInWithOAuth, MFA — aynı adlar, aynı imzalar.
Depolama API'siAYNIaura.storage.from(bucket).upload(...) · uyumlu S3 · aktarılabilir RLS politikaları.
Gerçek zamanlıAYNIchannel().on("postgres_changes", ...) değişmedi. Varlık + yayın aynı.
Edge FunctionsAYNIDeno.serve() Studio düzenleyicisine olduğu gibi yapıştırıldı. CLI, ayrı bir yolu hedefleyen işlevlere sahip olacaktır (Rust WASM olarak derlenmiştir).
Kontrol PaneliFARKLIStudio Aurabase · yönünüzü bulmanıza yardımcı oluyoruz.
#
1. Adım

Hedef Aurabase projesini oluşturun

Resmi CLI ile yeni bir Aurabase projesi oluşturun ve ardından aşağıdaki komutların otomatik olarak uygulanabilmesi için bu klasörü projeye bağlayın.

terminalbash
# Aurabase hesap + CLI
npm i -g @aurabase/cli
aura login

# Projeyi oluşturun (Postgres motoru)
aura projects create my-app --engine postgres

# Bu klasörü oluşturulan projeye bağlayın
aura link --project-id <uuid-du-projet>

# Bağlantılı projenin API anahtarlarını alın
aura projects api-keys
#
2. Adım

Supabase dosyasını boşaltın, Aurabase dosyasını geri yükleyin

Standart bir pg_dump / pg_restore: Aurabase her proje için doğrudan bir Postgres bağlantı dizesi sunar (Stüdyo → Ayarlar → Bağlantı), ara dönüşüme gerek yoktur.

terminalbash
# Supabase bağlantı dizesini kontrol panelinden alın
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"

# Genel şema dökümü (Supabase sistem şemaları olmadan)
pg_dump "$SUPABASE_DB_URL" \
  --schema=public \
  --no-owner --no-acl \
  --format=custom \
  -f supabase-dump.pgdump

# Aurabase bağlantı dizesini alın (Studio → Ayarlar → Bağlantı)
# ?search_path= parametresi ZORUNLUDUR: projenizin şemasına yönlendirir
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"

# Standart pg_restore ile geri yükleyin
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump

# TypeScript türlerini yeniden oluştur
aura db generate > src/aurabase.types.ts
#
3. Adım

Kullanıcıları taşı

Daha önce burada belirttiğimiz ile karşılaştırıldığında düzeltilmesi gereken bir nokta: Aurabase, şifreleri Argon2id ile hashler, ancak Supabase (GoTrue), varsayılan olarak bcrypt ile kendi hashingini yapar — iki format birbirinin yerine kullanılamaz. Bu nedenle kullanıcılarınızın çoğu geçişte olduğu gibi şifrelerini bir kez sıfırlamaları gerekecektir.

Aurabase şu anda Supabase'den toplu içe aktarma aracı sunmamaktadır. İki seçenek: kullanıcılarınızın kendilerini yeniden kaydetmelerine izin verin (aynı e-posta adresiyle signUp) veya parola sıfırlamayı tetiklemeden önce onları yönetici tarafında aura auth users create --email <email> ile birer birer yeniden oluşturun.

Bilgi

Supabase tarafındaki aktif oturumlar taşınmaz (teknik olarak imkansızdır; her platform JWT'lerini kendi anahtarıyla imzalar). Kullanıcıların yeni şifreleriyle tekrar giriş yapmaları gerekecektir.

#
4. Adım

İstemci kodunu uyarlayın

Vakaların %95'i için arama/değiştirme yeterlidir.

lib/supabase.ts → lib/aurabase.tstypescript
// ÖNCE (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)

// SONRA (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)

// Kodun geri kalanı değişmez:
await aura.from('posts').select('*').eq('author_id', userId)
#
Adım 5

Edge Functions'yi dağıtın

Aurabase, Edge Functions için iki yol sunar: Studio kod düzenleyicisi (Deno çalışma zamanı, Supabase ile aynı — işlevinizi olduğu gibi yapıştırın) ve Rust ile yazılan ve WASM ile derlenen işlevler için ayrı bir yol hedefleyen aura functions deployCLI. Mevcut Deno kodunu yeniden yazmadan taşımak için Studio'yu kullanın.

functions/hello/index.tstypescript
// Aynı şekilde çalışır, Studio düzenleyicisine olduğu gibi yapıştırılır
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(JSON.stringify({ hello: name }))
})
#
Geçiş

DNS geçişi ve üretimin başlatılması

İki olası strateji. İlki vakaların %99'u için önerilir.

  1. Doğrudan geçiş — ortamınızdaki NEXT_PUBLIC_AURABASE_URL ve NEXT_PUBLIC_AURABASE_ANON_KEY öğelerini değiştirin, yeniden konuşlandırın. Kullanıcılar yeniden bağlanıyor, her şey çalışıyor. Çoğu proje için önerilir.
  2. Geçici çift yazma — 48 saat boyunca aynı anda Supabase + Aurabase içine yazın, kritik tabloların tutarlılığını manuel olarak kontrol edin (satır sayımı, sağlama toplamları), ardından Supabase kapatın. Kritik uygulamalar için tercih edilir.
#
Yardım

İşler sıkışırsa buradayız

Büyük projelerde veya katı uyumluluk kısıtlamalarına sahip projelerde ekibimiz geçiş konusunda size destek olabilir. Projenize özel teklif için bizimle iletişime geçin.

Destek iste →

DAĞITILMAYA HAZIR MISINIZ?

Beş dakika içinde arka ucunuz.

Kredi kartı gerekmez · 500 MB ücretsiz · 50.000 MAU