الوقت الحقيقي
WebSocket وSSE وNATS ذاتي التفاوض. الحضور، الإعادة، الطلب المضمون، الضغط الخلفي. اتصالات 1M عبر POP، وfanout sub-15ms p99 بين المناطق.
المزامنة، الحضور، البث#
تبث خدمة aura-realtime ثلاثة أنواع من الأحداث: CDC Postgres (تمت تصفية INSERT/UPDATE/DELETE بواسطة RLS)، والحضور (المتصل بالإنترنت) والبث (أحداث مخصصة مستقلة عن قاعدة البيانات). كل ذلك يمر عبر نفس SDK عبر .channel().
يتم تعريف القناة باسم عشوائي (sensors:live, doc:42, room:abc). يتم ترتيب الرسائل حسب القناة، ويتم إلغاء تكرارها بواسطة message_id، ويتم ضمانها مرة واحدة بالضبط داخل نفس القناة.
ترث الاشتراكات سياسات RLS من قاعدة البيانات. يمكن للعميل الاشتراك فقط في التغييرات التي يمكنه قراءتها - يتم تقييم عامل التصفية من جانب الخادم على WAL، وليس من جانب العميل.
اتصال واحد، قنوات N#
تحتفظ SDK بـ باتصال TCP واحد متعدد الإرسال بين العميل وأقرب POP. يمكنك فتح 100 قناة دون فتح 100 مقبس.
┌──────────────────┐
Client (WS) ────▶ │ aura-realtime │
│ ─ CDC listener │
│ ─ Presence CRDT │
│ ─ Broadcast hub │
└────────┬─────────┘
│ NATS JetStream
┌────────────────────┴────────────────────┐
▼ ▼ ▼
aura-db WAL Presence state autres POPs
يتم تقسيم الأحداث عن طريق التجزئة المتسقة. تعيش القناة دائمًا على نفس بروتوكول POP، ولكن يتم ضمان نسخها إلى نقاط POP أخرى في أقل من 15 مللي ثانية p99.
ست قدرات أصلية#
- نقل عالي الإنتاجية. اتصال WebSocket الأصلي مدعوم من الخدمة الداخلية NATS.
- Postgres CDC. تمت تصفية تغييرات WAL على جانب الخادم، وتم تطبيق RLS على التدفق.
- واجهة برمجة تطبيقات التواجد. من المتصل بالإنترنت، حالة تعسفية، الانضمام/الخروج من الأحداث.
- تعدد الإرسال. تشترك عدة قنوات في اتصال WebSocket واحد.
- تسليم الحدث. التسليم المباشر بأفضل جهد مع إعادة الاتصال التلقائي بالعميل.
- المؤشرات التعاونية. بدائية أصلية، دواسة الوقود التكيفية 60 إطارًا في الثانية، استيفاء العميل.
أربعة أنماط أساسية#
const channel = aura.channel('db:public.devices')
.on('postgres_changes', {
event: '*',
schema: 'public',
table: 'devices',
filter: `tenant_id=eq.${tid}`,
}, ({ new: row }) => render(row))
.subscribe()
اتصل دائمًا بـ channel.unsubscribe() عند إلغاء التحميل. في React، قم بذلك في عملية التنظيف useEffect — الخطاف useChannel أعلاه يقوم بذلك نيابةً عنك.
ما نعد به، وما لا نعد به#
✓ مضمونة
- الطلب عن طريق القناة
- بالضبط مرة واحدة لكل
message_idفي القناة - Fanout p99 <15 مللي ثانية عبر المنطقة
- إعادة الاتصال التلقائي مع إعادة التشغيل لمدة 60 ثانية
- الضغط الخلفي الصريح (سياسة الإسقاط القابلة للتكوين)
✗ غير مضمون
- الطلب عبر القنوات
- مرة واحدة بالضبط عبر القنوات (مرة واحدة على الأقل)
- زمن الوصول الفرعي (< 15 مللي ثانية p99 هو الأرضية لدينا)
- إعادة التشغيل بعد مرور 60 ثانية (استخدم سجل Postgres)