قاعدة البيانات
PostgreSQL 18، قاعدة بيانات مخصصة لكل مشروع في مجموعة مؤسستك، ومخططات معزولة، وأنواع TypeScript يتم إنشاؤها تلقائيًا، وRLS أصلية. لا توجد شوكات، ولا إعادة كتابة الوكلاء - تعمل الإضافات والمشغلات وPL/pgSQL كما هي.
Postgres 18، بدون تجريد#
تعرض خدمة aura-db CRUD عامة أعلى PostgreSQL 18: كل مشروع لديه قاعدة بيانات خاصة به، مستضافة على مجموعة PostgreSQL الخاصة بمؤسستك (مجموعة مخصصة بالكامل لمشروع واحد في عرض المؤسسة). تتم ترجمة كل استدعاء SDK إلى SQL أصلي عبر طبقة رقيقة تحترم RLS policies الذي تم إدخاله في الجلسة.
يمكنك أيضًا تجاوز SDK والإشارة إلى psql أو Prisma أو Drizzle أو Kysely أو Metabase أو pg_dump في قاعدة البيانات الخاصة بك: بروتوكول الأسلاك القياسي PostgreSQL، TLS، وهو الدور الذي يمكن أن يصل فقط إلى قاعدة بيانات الخاصة بمشروعك. راجع الاتصال مباشرة أدناه. (النشر الذي لا ينشر منفذ PostgreSQL ينص على ذلك في Studio › الإعدادات › الاتصال: استخدم SDK أو REST API أو محرر SQL أو CLI، aura db raw.)
يمنحك pg_dump قاعدة بياناتك الكاملة (المخطط والبيانات والإضافات والسياسات). لا يوجد أقفال، هجرة خارجية تافهة.
يستدعي SDK PostgREST، والذي يستدعي Postgres#
تحت الغطاء، تقوم SDK بتسلسل مكالمات .from().select()… الخاصة بك في طلب HTTP إلى aura-db الذي يفوض إلى PostgREST عربة جانبية. يترجم PostgREST إلى SQL ويفتح اتصالاً مجمعًا عبر PgBouncer مع search_path للمشروع الذي تم إدخاله.
SDK → HTTPS GET /v1/db/sensors?select=id,name
Gateway → aura-db Session verification & routing
aura-db → PgBouncer → PostgreSQL 18
# اتصال مع مشروع search_path
SET LOCAL search_path = project_a7f3_, public;
SET LOCAL request.jwt.claims = '{ "sub": "u_9k2", "tenant": "t_4c" }';
SELECT id, name, temperature FROM sensors WHERE active = true LIMIT 50;
تتمتع سياسات RLS بإمكانية الوصول إلى auth.uid() و auth.role() و auth.tenant(). يقرأ هؤلاء المساعدون request.jwt.claims الذي تم إدخاله بواسطة البوابة - ومن المستحيل التلاعب به من جانب العميل.
ست قدرات أصلية#
- مخطط لكل مشروع. تم تطبيق التقسيم بواسطة PostgreSQL: لا يوجد عمود معرف المستأجر، دور اتصال واحد لكل مشروع، الحقوق لم يتم فتحها مطلقًا لـ PUBLIC.
- عمليات الترحيل ذات الإصدار. إصدار SQL، التراجع الذري، عدم التوقف عن العمل. يتم تجديد أنواع TypeScript مع كل عملية ترحيل.
- كودجن TypeScript & Rust. الإنشاء التلقائي لأنواع الجداول وطرق العرض والتعدادات ووظائف RPC من مخططك المباشر.
- أصلي RLS. السياسات التصريحية القابلة للاختبار. يقوم SDK بإدخال مستأجر المطالبة في كل اتصال.
- الإضافات المدرجة في القائمة المسموح بها. 14 ملحقًا يتم تثبيتها بواسطة النظام الأساسي عند إنشاء مشروع:
pgvector,pgcrypto,uuid-ossp,pg_trgm,pg_graphql,pg_stat_statements,citext,hstore,ltree,unaccent,btree_gin,btree_gist,fuzzystrmatch,intarray. - فروع قاعدة البيانات.
aura branch createينسخ مشروعًا (المخطط والسياسات والوظائف والمشغلات وطرق العرض والصفوف) إلى مشروع جديد بعنوان URL الخاص به والمفاتيح، ويتم حذفه تلقائيًا بعد انتهاء صلاحيته. نسخة تم إنشاؤها في وقت الإنشاء، وليست نسخة طبق الأصل حية.
CRUD كاملة، مكتوبة#
تشترك العمليات الأساسية الأربع في نفس سطح .from(table). يتم استنتاج الأنواع التي يتم إرجاعها من مخططك - افتح IDE الخاص بك، ويعمل الإكمال التلقائي على الأعمدة والوصلات والإرجاع.
// قم بإدراج آخر 50 جهاز استشعار نشط
const { data, error } = await aura
.from('sensors')
.select('id, name, temperature, location!inner(city)')
.eq('active', true)
.order('captured_at', { ascending: false })
.limit(50)
هل تحتاج إلى لغة SQL أكثر تعقيدًا؟ قم بإنشاء دالة Postgres واستدعائها عبر aura.rpc('function_name', args). تستفيد الوظائف من نفس سياسات RLS مثل الجداول.
14 امتدادًا مدرجًا في القائمة المسموح بها جاهزة#
14 ملحقًا مدرجًا في القائمة المسموح بها، جاهزة لكل مشروع جديد
يقوم النظام الأساسي بتثبيتها عند إنشاء المشروع (لا يمكن لدور المشروع تشغيل CREATE EXTENSION نفسه، لذلك لا توجد خطوة تنشيط يجب نسيانها). قم بإدراج ما تم تثبيته باستخدام aura db extensions list أو Studio ›قاعدة البيانات› الامتدادات؛ aura db extensions enable <name> وPOST /v1/db/{project_id}/schema/extensions يعيدان تطبيق واحد مسموح به.
- pgvector (
vector) - pg_graphql (يتم تثبيته عندما تقوم بتمكين GraphQL)
- pg_stat_statements
- com.pgcrypto
- uuid-ossp
- pg_trgm
- com.citext
- com.hstore
- ltree
- غير لهجة
- btree_gin
- btree_gist
- com.fuzzystrmatch
- إنتراراي
postgis و pg_cron و timescaledb و pgmq و pg_partman ليست مجمعة في الصورة المُدارة القياسية. بالنسبة لأحمال العمل المجدولة، قم بتشغيل وظيفة Edge في جدول cron في Cron. يحتوي المشروع الذي تم إنشاؤه قبل هذا التغيير على الامتدادات التاريخية الخمسة فقط (vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql) حتى يقوم النظام الأساسي بتشغيل تحديث المخطط التالي؛ ولا يمكنك إضافة الآخرين بنفسك، لأن مشغل قاعدة البيانات فقط هو الذي يمكنه تثبيتها.
الاتصال مباشرة: psql، Prisma، Drizzle، pg_dump#
كل مشروع له دور تسجيل الدخول PostgreSQL الخاص به (proj_xxxxxxxx) ومضيف النموذج <project-slug>.db.<your-domain> على المنفذ 5432. كلمة المرور هي تصدر عند الطلب وتظهر مرة واحدة: لا تحتفظ المنصة بها بشكل واضح، لذلك يتم استبدال كلمة المرور المفقودة، ولا يتم استردادها أبدًا.
# المضيف والمنفذ وقاعدة البيانات ودور المشروع المرتبط (بدون كلمة مرور)
aura db connection
# إصدار كلمة مرور وطباعة سلسلة الاتصال كاملة (يلغي كلمة المرور السابقة)
aura db connection --new-password
# افتح psql عليه (يطلب psql كلمة المرور)
aura connect
aura db connection --new-password يطبع سلسلة يمكنك لصقها في أي مكان:
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require
نفس البطاقة موجودة في Studio › الإعدادات › الاتصال › قاعدة البيانات (إنشاء كلمة المرور / إعادة تعيين كلمة المرور).
- مطلوب TLS. ترفض نقطة النهاية اتصالات النص العادي (
sslmode=require). في حزمة k3d المحلية، تكون الشهادة موقعة ذاتيًا (*.db.localhost)، لذلك يفشلsslmode=verify-fullهناك حسب التصميم؛ يستخدم الإنتاج شهادة صادرة لـ*.db.<your-domain>. - يقتصر على مشروعك. يختار جهاز التوجيه قاعدة البيانات الخاصة بك من اسم الدور ويفرضها: لا يزال طلب اسم قاعدة بيانات آخر يصل إليك، ويتم رفض تقديم دورك على مضيف مشروع آخر. دورك ليس مستخدمًا متميزًا ولا يتجاوز RLS؛ لتشغيل الترحيل كمالك الجدول، استخدم
BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;. - الجداول التي تقوم بإنشائها هنا خاصة بالمنصة. لا يمكن تشغيل أمان مستوى الصف تلقائيًا لجدول تم إنشاؤه عبر هذا الاتصال (يحتاج إلى مستخدم متميز PostgreSQL، والذي لا يكشفه المشروع المُدار أبدًا)، لذلك لا تحصل المفاتيح العامة على أي امتياز عليه: تجيب REST API على
permission deniedعلى المفتاح المجهول والمستخدمين الذين قاموا بتسجيل الدخول، بينما يقوم مفتاحservice_roleوالاستوديو ودورك بقراءته وكتابته. لعرضه على SDK، قم بتمكين RLS ومنحه ثم أضف سياسة (راجع أمان مستوى الصف):ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …. PostgREST يتعرف على الجدول الجديد عند تشغيلNOTIFY pgrst, 'reload schema'. يتم إغلاق الجداول التي تم إنشاؤها عبر هذا الاتصال قبل وجود هذه القاعدة في المرة التالية التي تقوم فيها بإصدار كلمة مرور (aura db connection --new-password)، إلا إذا تم تمكين RLS بالفعل. - مجمع المعاملات. تمر الاتصالات عبر PgBouncer في وضع المعاملة. لا تنتقل حالة الجلسة من معاملة إلى أخرى: استخدم
SET LOCALداخل المعاملة، وتوقع عدم موثوقية البيانات المعدة بالاسم،LISTENوالأقفال الاستشارية على مستوى الجلسة (Prisma: أضفpgbouncer=trueإلى عنوان URL). - إصدار العميل.
pg_dumpيرفض خادمًا أحدث منه: استخدم عميل PostgreSQL 18 (pg_dump --version).
يعتمد الوصول المباشر على نشر منفذ PostgreSQL. وهو قيد التشغيل لمكدس k3d المحلي ولعمليات النشر التي تمكّنه قيم Helm الخاصة بها (ingress.tcp.enabled خلف ingress-nginx، أو pgproxy.nodePort)؛ يخبرك الاستوديو وaura db connection عندما لا يكون الأمر كذلك.
للذهاب أبعد من ذلك#
- الأمان على مستوى الصف
السياسات الأصلية، والاختبار، وأنماط المستأجرين المتعددين.
- الاتفاقيات
تسمية المخططات والأعمدة والسياسات والمساعدين RLS.
- فروع قاعدة البيانات
نسخة من المشروع لكل طلب سحب، تم حذفه بواسطة TTL الخاص به.
- الهندسة المعمارية
كيف تتناسب aura-db مع الخدمات الثمانية.
- واجهة برمجة تطبيقات REST
سطح HTTP الخام لقاعدة البيانات والمصادقة والتخزين.
- Supabase الهجرة
pg_dump + RLS remap، ساعة واحدة لمشروع متوسط.