الترحيل من Supabase
يتم ترحيل واجهة برمجة تطبيقات العميل وسياسات RLS وEdge Functions. تقوم واجهة سطر الأوامر (CLI) بتصدير مستخدمي Supabase الخاصين بك مع تجزئات كلمة المرور المشفرة الخاصة بهم، واستعادة pg_dump العادي (العبارات، ونصوص الوظائف، وبيانات النسخ) واستيراد المستخدمين: توضح هذه الصفحة بالضبط ما تحمله كل خطوة وأين تتوقف.
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 ونقاط النهاية المخصصة |
| مفتاح دور الخدمة | نفسه | نفس الدور، نفس النطاق |
أربعة أوامر بالترتيب#
- تصدير —
aura migrate export-supabaseيكتبusers.json(المستخدمون، وتجزئة كلمة المرور، وهويات OAuth) وdump.sql(pg_dumpلمخططpublicوبنيته وبياناته) - استعادة —
aura db restore dump.sqlيعيد تشغيل التفريغ في المشروع المرتبط - استيراد المستخدمين —
aura auth import users.json; يحتفظ المستخدمون بمعرفهم وكلمة المرور الخاصة بهم - القطع - قم بتبديل عنوان URL والمفاتيح في تطبيقك؛ انشر Edge Functions دون تغيير
# 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% بدون تعديل:
// وظيفة Deno القياسية — تعمل كما هي في Aurabase
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(
JSON.stringify({ message: `Hello ${name}!` }),
{ headers: { 'content-type': 'application/json' } }
)
})