انتقل إلى المحتوى
شعار أوراباسي
aurabase

الترحيل من Supabase

يتم ترحيل واجهة برمجة تطبيقات العميل وسياسات RLS وEdge Functions. تقوم واجهة سطر الأوامر (CLI) بتصدير مستخدمي Supabase الخاصين بك مع تجزئات كلمة المرور المشفرة الخاصة بهم، واستعادة pg_dump العادي (العبارات، ونصوص الوظائف، وبيانات النسخ) واستيراد المستخدمين: توضح هذه الصفحة بالضبط ما تحمله كل خطوة وأين تتوقف.

دليل عملي10 د قراءةالمستوى وسيطةتمت المراجعة في 10‏/11‏/2026

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

95% نفس Supabase#

تتبع واجهة برمجة تطبيقات العميل وسياسات RLS ونموذج المصادقة والتخزين اصطلاحات Supabase، لذلك يتغير رمز التطبيق قليلاً جدًا. يوضح الجدول أدناه ما هو نفسه وما هو ليس كذلك.

ميزةالتوافقملاحظة
createClient()نفسهقم باستيراد @aurabase/aurabase-js بدلاً من @supabase/supabase-js
.from().select()نفسهنفس واجهة برمجة التطبيقات PostgREST القابلة للتسلسل
سياسات RLSنفسهPostgres سياسات SQL. يتم قبول to authenticated و to anon و to service_role كأسماء مستعارة لـ aura_authenticated و aura_anon و aura_service_role. يتم إنشاء هذه الأدوار باستخدام مجموعة قاعدة بيانات المشروع؛ في المجموعة التي تم إنشاؤها قبل هذا التغيير، اكتب أسماء الأدوار aura_*.
auth.uid() و auth.role()نفسهمساعدين مطالبة متوافقة عن طريق المطالبة
auth.getUser()فرق بسيطdata هو المستخدم (data.email); Supabase يُرجع { data: { user } }. الكود المكتوب كـ const { data: { user } } = await supabase.auth.getUser() يحصل على user === undefined هنا: اكتب const { data: user } = await aura.auth.getUser()
.rpc()نفسهنفس التوقيع لوظائف Postgres
.storage.from().upload()نفسهS3- واجهة برمجة تطبيقات متوافقة مع مسارات متطابقة
.channel().on("postgres_changes")نفسهنفس تغيير سطح التقاط البيانات
Edge Functions (Deno)نفسهوقت التشغيل القياسي Deno؛ Deno.serve() يعمل بدون إعادة الكتابة
خطافات المصادقةفرق بسيطخطافات ويب HTTP ونقاط النهاية المخصصة
مفتاح دور الخدمةنفسهنفس الدور، نفس النطاق

أربعة أوامر بالترتيب#

  1. تصدير — aura migrate export-supabase يكتب users.json (المستخدمون، وتجزئة كلمة المرور، وهويات OAuth) وdump.sql (pg_dump لمخطط public وبنيته وبياناته)
  2. استعادة — aura db restore dump.sql يعيد تشغيل التفريغ في المشروع المرتبط
  3. استيراد المستخدمين — aura auth import users.json; يحتفظ المستخدمون بمعرفهم وكلمة المرور الخاصة بهم
  4. القطع - قم بتبديل عنوان URL والمفاتيح في تطبيقك؛ انشر Edge Functions دون تغيير
terminalbash
# 1. التصدير من Supabase (الإعدادات > قاعدة البيانات > سلسلة الاتصال، دور "postgres")
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export

# 2. قم باستعادة المخطط والبيانات في مشروع Aurabase المرتبط
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run   # تحليل وطباعة الخطة فقط
aura db restore ./supabase-export/dump.sql

# 3. قم باستيراد المستخدمين، مع تجزئات كلمة المرور الخاصة بهم
aura auth import ./supabase-export/users.json

استعادة المخطط والبيانات#

يقوم aura migrate export-supabase بتشغيل pg_dump --schema=public --no-owner --no-acl --format=plain باستخدام pg_dump المحلي (قم بتثبيت أدوات العميل PostgreSQL؛ وبدونها، يطبع الأمر سطر pg_dump الدقيق لتشغيله بنفسك).

يقرأ aura db restore <file.sql> تفريغ SQL عادي بالطريقة التي يفعلها psql: يتم تقسيم البيانات خارج السلاسل والمعرفات المقتبسة والتعليقات والأجسام المقتبسة بالدولار ($$ … $$, $fn$ … $fn$)، تتم قراءة كتل COPY … FROM stdin حتى سطر \. الخاص بها، وpsql يتم تخطي الأوامر الوصفية (\connect, \restrict) . ومن ثم:

  • يزيل المؤهل public. الذي يكتبه pg_dump، بحيث تصل الجداول إلى مخطط المشروع (--source-schema لمخطط آخر)؛
  • يتخطى ما ليس له معنى في Aurabase ويوضح السبب: إعدادات الجلسة (SET, set_config), OWNER TO, GRANT/REVOKE لأدوار Supabase، CREATE EXTENSION (تتم إدارة الامتدادات بواسطة Aurabase)، CREATE SCHEMA public؛
  • يقوم بتشغيل كل شيء آخر بترتيب الملف، ويتوقف عند الخطوة الفاشلة الأولى برقمه وسطر التفريغ والخطأ. أصلح السبب واستأنف باستخدام --from <step>، أو مرر --continue-on-error لتجاوز الخطوات الفاشلة والحصول على القائمة في النهاية. --dry-run يطبع الخطة دون تنفيذ أي شيء.

مساران، تم اختيارهما مثل aura db push:

المشروع المرتبط، رقم DATABASE_URLمجموعة DATABASE_URL (سلسلة اتصال مباشرة)
النقلاستدعاء SQL API واحد لكل عبارة، ويتم التحقق من صحته بواسطة الخادماتصال PostgreSQL واحد
COPY البياناتتم التحويل إلى دفعات INSERT (500 صف)بروتوكول COPY، البيانات مُلقاة
الوظائف والمشغلات وكتل DOتم رفض بواسطة SQL API: قم بإنشائها باستخدام aura db function create وaura db trigger createتم إنشاؤها
حد الأمانسياسة عزل الخادم للمشروعدور PostgreSQL للمشروع (قاعدة البيانات الخاصة به فقط، لا يوجد مستخدم متميز، ينطبق أمان مستوى الصف)

في مسار SQL API، يرفض الخادم أيضًا سلاسل E'…'، والإشارات إلى المخططات الأخرى، وفي البيان، النص الذي يبدو كأمر محظور، حتى داخل سلسلة حرفية: يفشل صف البيانات الذي يحتوي على هذا النص مع رقم الخطوة الخاص به. استخدم المسار المباشر لتلك المقالب. توجد سلسلة الاتصال المباشر في الإعدادات › الاتصال عندما ينشر النشر وصولاً مباشرًا إلى PostgreSQL.

تعمل الاستعادة بشكل تسلسلي: يتم طلب تفريغ SQL عادي (الجداول، ثم البيانات، ثم القيود والفهارس) ولا يحتوي على رسم بياني للتبعية لموازته. لم يتم نشر رقم الإنتاجية.

انتبه

لا تتم استعادة المراجع إلى auth.users كما هي. Aurabase لا يحتفظ Auth بمستخدميه في جدول auth.users، لذلك يفشل المفتاح الخارجي مثل REFERENCES auth.users(id). قم بالاستعادة باستخدام --continue-on-error واحتفظ بأعمدة user_id بدون هذا القيد: يتم الاحتفاظ بمعرفات المستخدم من خلال الاستيراد أدناه، لذلك تظل القيم متطابقة.

المستخدمين وكلمات المرور#

aura migrate export-supabase يقرأ auth.users و auth.identities ويكتب، لكل مستخدم: معرف الأصلي، البريد الإلكتروني، email_verified، تجزئة التشفير لـ encrypted_password، الاسم والبيانات الوصفية (raw_user_meta_data و raw_app_meta_data بدون مفاتيح Supabase الخاصة بـ provider/providers)، وهويات OAuth المرتبطة (Google، GitHub...). الملف مكتوب بحيث يكون قابلاً للقراءة بواسطتك فقط: فهو يحتوي على تجزئات كلمة المرور، وقم بحذفها بعد الاستيراد.

يرسل aura auth import users.json المستخدمين على دفعات مكونة من 1000 إلى واجهة برمجة تطبيقات استيراد المسؤول ويطبع كل سطر لم يتم إنشاؤه (skipped عندما يكون البريد الإلكتروني أو المعرف موجودًا بالفعل، error مع السبب). يعد تشغيله مرة أخرى أمرًا آمنًا: لا يتم الكتابة فوق المستخدمين الحاليين أبدًا.

عند تسجيل الدخول، تتحقق Aurabase Auth من تجزئة bcrypt، ثم تستبدلها بتجزئة Argon2id: يحتفظ المستخدمون بكلمة المرور الخاصة بهم ولا يفعلون شيئًا. يقبل الاستيراد تجزئات bcrypt $2a$ و $2b$ و $2y$ بتكلفة من 4 إلى 12 (يستخدم Supabase 10)، وتجزئة Argon2id بمعلمات محددة؛ يتم رفض أي تنسيق آخر سطرًا بسطر. يقوم مستخدمو OAuth بتسجيل الدخول مرة أخرى باستخدام نفس المزود والوصول إلى نفس الحساب.

انتبه

لم يتم ترحيله: MFA العوامل (TOTP، الهاتف)، الجلسات النشطة ورموز التحديث (كل مستخدم يسجل الدخول مرة أخرى)، الحظر، الهاتف فقط، المستخدمون المجهولون والمحذوفون (يتم حسابهم والإبلاغ عنهم بواسطة التصدير). يجب على المستخدمين الذين لديهم MFA التسجيل مرة أخرى.

Deno الأصلي - لا توجد إعادة كتابة#

يقوم Aurabase بتشغيل وقت تشغيل قياسي Deno. وظائفك التي تستخدم Deno.serve() متوافقة بنسبة 100% بدون تعديل:

functions/hello.tstypescript
// وظيفة Deno القياسية — تعمل كما هي في Aurabase
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(
    JSON.stringify({ message: `Hello ${name}!` }),
    { headers: { 'content-type': 'application/json' } }
  )
})

للذهاب أبعد من ذلك#