रियल टाइम
स्व-बातचीत वेबसॉकेट, एसएसई और NATS। उपस्थिति, रीप्ले, गारंटीकृत ऑर्डर, बैकप्रेशर। POP द्वारा 1M कनेक्शन, क्षेत्रों के बीच फैनआउट सब-15ms p99।
सिंक, उपस्थिति, प्रसारण#
aura-realtime सेवा तीन प्रकार की घटनाओं का प्रसारण करती है: CDC Postgres (INSERT/UPDATE/DELETE फ़िल्टर RLS), उपस्थिति (जो ऑनलाइन है) और प्रसारण (डेटाबेस से स्वतंत्र कस्टम इवेंट)। सभी .channel() के माध्यम से एक ही SDK से गुजरते हैं।
एक चैनल की पहचान एक मनमाने नाम (sensors:live, doc:42, room:abc) से की जाती है। संदेशों को चैनल द्वारा ऑर्डर किया जाता है, message_id द्वारा डुप्लिकेट किया जाता है, और एक ही चैनल के भीतर बिल्कुल एक बार गारंटी दी जाती है।
सदस्यताएँ डेटाबेस से RLS नीतियां प्राप्त करती हैं। एक क्लाइंट केवल उन परिवर्तनों की सदस्यता ले सकता है जिन्हें वह पढ़ सकता है - फ़िल्टर का मूल्यांकन वाल पर सर्वर-साइड पर किया जाता है, क्लाइंट-साइड पर नहीं।
एक कनेक्शन, एन चैनल#
SDK क्लाइंट और निकटतम POP के बीच को एकल मल्टीप्लेक्स टीसीपी कनेक्शन बनाए रखता है। आप 100 सॉकेट खोले बिना 100 चैनल खोल सकते हैं।
┌──────────────────┐
Client (WS) ────▶ │ aura-realtime │
│ ─ CDC listener │
│ ─ Presence CRDT │
│ ─ Broadcast hub │
└────────┬─────────┘
│ NATS JetStream
┌────────────────────┴────────────────────┐
▼ ▼ ▼
aura-db WAL Presence state autres POPs
घटनाओं को लगातार हैशिंग द्वारा विभाजित किया जाता है। एक चैनल हमेशा एक ही पीओपी पर रहता है, लेकिन अन्य पीओपी पर इसकी प्रतिकृति 15ms p99 से कम में गारंटी दी जाती है।
छह मूल क्षमताएँ#
- उच्च-थ्रूपुट परिवहन। नेटिव वेबसॉकेट कनेक्शन अंतर-सेवा NATS द्वारा संचालित है।
- Postgres CDC। वाल परिवर्तन सर्वर साइड पर फ़िल्टर किए गए, 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() पर कॉल करें। रिएक्ट में, इसे useEffect क्लीनअप में करें - ऊपर दिया गया useChannel हुक आपके लिए यह करता है।
हम क्या वादा करते हैं, क्या नहीं करते#
✓ गारंटी
- चैनल द्वारा ऑर्डर करना
- एक चैनल में प्रति
message_idबिल्कुल एक बार - फैनआउट पी99 <15एमएस क्रॉस-रीजन
- 60 के दशक के रीप्ले के साथ ऑटो रीकनेक्शन
- स्पष्ट बैकप्रेशर (कॉन्फ़िगर करने योग्य ड्रॉप नीति)
✗ गारंटी नहीं
- क्रॉस-चैनल ऑर्डरिंग
- बिल्कुल एक बार क्रॉस-चैनल (कम से कम एक बार)
- उप-एमएस विलंबता (<15ms p99 हमारी मंजिल है)
- 60 के बाद दोबारा चलाएं (Postgres लॉग का उपयोग करें)