جديدPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2انظر سجل التغيير →

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

PostgreSQL، على بعد سطر واحد مكتوب.

قاعدة بيانات PostgreSQL 18 حقيقية لكل مشروع، يمكن الوصول إليها من تطبيقك باستخدام SDK بطلاقة، ومحمية بأمان على مستوى الصف وكتابتها من مخططك الخاص.

16
نسخة بوستجرسكل
2
المحركات: PostgreSQL، MongoDB
db.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
const { data, error } = await aura.db
.from('posts')
.select('id,title,author:authors(*)')
.eq('published', true)
.order('created_at', 'desc')
.limit(10)

ما هو مدرج

قاعدة بيانات يمكن لتطبيقك التحدث إليها. بدون كتابة API.

المحرك

حقيقي بوستجرس كيو ال 16

تعيش بياناتك في PostgreSQL، بأنواعها وقيودها ومشغلاتها ووظائفها.

منشئ الاستعلام

الاستعلامات المكتوبة بطلاقة

المساواة والنطاق والنمط والمصفوفة ونوع النطاق ومرشحات النص الكامل والترتيب والعد وترقيم الصفحات.

العلاقات

يدمج

جلب الصفوف ذات الصلة في طلب واحد مع تضمين مثل المؤلف:المؤلفون(*).

وظائف

وظائف الاتصال مع rpc ()

اكشف وظائف PostgreSQL لتطبيقك. يتم تصفية وظائف إرجاع المجموعة مثل الجداول.

الأمن

الأمان على مستوى الصف

اكتب السياسات في SQL باستخدام auth.uid() بحيث يصل كل مستخدم فقط إلى الصفوف الخاصة به. قاعدة البيانات تفرضها، وليس العميل.

أنواع

أنواع TypeScript التي تم إنشاؤها

قم بإنشاء نوع قاعدة بيانات من المخطط الخاص بك واحصل على الأعمدة المكتوبة والمدخلات والوسائط الوظيفية.

منظمة العفو الدولية

المتجهات مع pgvector

يأتي ملحق pgvector مع صورة قاعدة البيانات للبحث عن التشابه.

الاشتراك

GraphQL لكل مشروع

قم بتشغيل pg_graphql لمشروع عندما تريد واجهة برمجة تطبيقات GraphQL على مخططه.

محرك بديل

MongoDB، إذا كنت تفضل المستندات

اختر MongoDB كمحرك للمشروع. يستخدم العزل بعد ذلك مالكي المستندات بدلاً من الأمان على مستوى الصف.

كيف يعمل

من جدول إلى استعلام مكتوب.

  1. 1

    إنشاء جدول

    استخدم محرر جدول Studio أو SQL العادي.

  2. 2

    أضف سياسة

    قم بتشغيل الأمان على مستوى الصف ووصف من يمكنه رؤية الصفوف.

  3. 3

    توليد أنواع

    قم بتشغيل aurabase-gen للحصول على نوع قاعدة البيانات لعميلك.

  4. 4

    الاستعلام

    اتصل بـ aura.db.from(...) من تطبيقك، مع جلسة المستخدم.

REST API

هل تفضل HTTP العادي؟ كل شيء هنا.

SDK عبارة عن طبقة رقيقة فوق هذه المسارات. أرسل مفتاح API الخاص بمشروعك مع كل طلب.

الطريقةنقطة النهايةالوصف
GET/v1/db/{table}قراءة الصفوف، مع المرشحات، والترتيب والتضمين.
POST/v1/db/{table}قم بإدراج صف واحد أو عدة صفوف، أو قم بإدراجه.
PATCH/v1/db/{table}تحديث الصفوف.
DELETE/v1/db/{table}حذف الصفوف.
POST/v1/db/rpc/{function}استدعاء وظيفة PostgreSQL.
GET/v1/db/schemaاذكر جداول المشروع ووظائفه.
GET/v1/db/functionsقائمة الوظائف المحددة في المشروع.
POST/v1/db/rawتشغيل عبارة SQL. محفوظة لدور الخدمة.

أسئلة

من الجيد أن نعرف.

هل هذا PostgreSQL حقيقي؟+
نعم. تعمل المشاريع على تشغيل PostgreSQL 18 بامتداد pgvector، بحيث تعمل SQL والقيود والمشغلات والوظائف الخاصة بك كما هو مكتوب.
كيف يمكنني إبعاد المستخدمين عن بيانات بعضهم البعض؟+
قم بتمكين الأمان على مستوى الصف في الجدول واكتب سياسة تقارن عمودًا بـ auth.uid(). تطبقها قاعدة البيانات على كل طلب يتم تقديمه باستخدام الرمز المميز للمستخدم.
هل يمكنني تشغيل SQL الخام؟+
نعم، مع دور الخدمة، من خلال aura.db.sql() أو محرر SQL في Studio. إنه غير متاح للمستخدمين المجهولين أو الذين قاموا بتسجيل الدخول، لذا احتفظ به على الخادم.
هل أحصل على أنواع TypeScript لجداولي؟+
نعم. قم بتشغيل npx aurabase-gen لكتابة ملف قاعدة البيانات.types.ts ، ثم قم بتمرير نوع قاعدة البيانات الخاصة به إلى createClient .
كيف أقوم بترقيم النتائج؟+
استخدم Limit() و Offset() . يتوفر ترقيم الصفحات للمؤشر فقط في مشاريع MongoDB وعلى مسار المحرك الأصلي.
ما الذي يتغير مع MongoDB؟+
لا يوجد أمان على مستوى الصف. تتم تصفية عمليات القراءة بواسطة المستخدمين الذين قاموا بتسجيل الدخول إلى المستندات التي يمتلكونها، ولا يوجد مالك للمستندات التي تم إنشاؤها باستخدام دور الخدمة، لذلك لا يمكن للمستخدمين رؤيتها.

هل أنت مستعد لتخزين البيانات؟

قاعدة البيانات الخاصة بك على بعد مشروع واحد.

يتم تضمين قاعدة بيانات في كل مشروع. لا حاجة لبطاقة الائتمان.