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

قاعدة البيانات

PostgreSQL 18، قاعدة بيانات مخصصة لكل مشروع في مجموعة مؤسستك، ومخططات معزولة، وأنواع TypeScript يتم إنشاؤها تلقائيًا، وRLS أصلية. لا توجد شوكات، ولا إعادة كتابة الوكلاء - تعمل الإضافات والمشغلات وPL/pgSQL كما هي.

شرح8 د قراءةالمستوى وسيطةتمت المراجعة في 15‏/04‏/2026

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

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 للمشروع الذي تم إدخاله.

التدفق الداخليtext
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 الخاص بك، ويعمل الإكمال التلقائي على الأعمدة والوصلات والإرجاع.

queries.tstypescript
// قم بإدراج آخر 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. كلمة المرور هي تصدر عند الطلب وتظهر مرة واحدة: لا تحتفظ المنصة بها بشكل واضح، لذلك يتم استبدال كلمة المرور المفقودة، ولا يتم استردادها أبدًا.

connect.shbash
# المضيف والمنفذ وقاعدة البيانات ودور المشروع المرتبط (بدون كلمة مرور)
aura db connection

# إصدار كلمة مرور وطباعة سلسلة الاتصال كاملة (يلغي كلمة المرور السابقة)
aura db connection --new-password

# افتح psql عليه (يطلب psql كلمة المرور)
aura connect

aura db connection --new-password يطبع سلسلة يمكنك لصقها في أي مكان:

سلسلة الاتصالtext
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 عندما لا يكون الأمر كذلك.

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