डेटाबेस
PostgreSQL 18, आपके संगठन के क्लस्टर पर प्रति प्रोजेक्ट एक समर्पित डेटाबेस, पृथक स्कीमा, स्वचालित रूप से जेनरेट किए गए TypeScript प्रकार, मूल RLS। कोई कांटा नहीं, कोई पुनर्लेखन प्रॉक्सी नहीं - आपके एक्सटेंशन, ट्रिगर और पीएल/पीजीएसक्यूएल वैसे ही काम करते हैं।
Postgres 18, अमूर्तता के बिना#
aura-db सेवा PostgreSQL 18 के शीर्ष पर एक सामान्य CRUD को उजागर करती है: प्रत्येक प्रोजेक्ट का अपना डेटाबेस होता है, जो आपके संगठन के PostgreSQL क्लस्टर (एंटरप्राइज़ ऑफ़र पर एक एकल प्रोजेक्ट के लिए पूरी तरह से समर्पित क्लस्टर) पर होस्ट किया जाता है। प्रत्येक SDK कॉल को एक पतली परत के माध्यम से मूल SQL में अनुवादित किया जाता है जो सत्र में इंजेक्ट किए गए RLS policies का सम्मान करता है।
आप SDK को बायपास भी कर सकते हैं और अपने डेटाबेस पर psql, प्रिज्मा, ड्रिज़ल, Kysely, Metabase या pg_dump को इंगित कर सकते हैं: मानक PostgreSQL वायर प्रोटोकॉल, TLS, एक भूमिका जो केवल आपके प्रोजेक्ट के डेटाबेस तक पहुंच सकती है। नीचे सीधे कनेक्ट देखें। (एक परिनियोजन जो PostgreSQL पोर्ट को प्रकाशित नहीं करता है, वह स्टूडियो › सेटिंग्स › कनेक्शन में ऐसा कहता है: SDK, REST API, SQL संपादक या CLI, aura db raw का उपयोग करें।)
एक pg_dump आपको आपका संपूर्ण डेटाबेस (स्कीमा, डेटा, एक्सटेंशन, नीतियां) देता है। कोई लॉक-इन नहीं, तुच्छ आउटबाउंड माइग्रेशन।
SDK PostgREST को कॉल करता है, जो Postgres को कॉल करता है#
हुड के तहत, SDK आपके .from().select()… कॉल को aura-db के HTTP अनुरोध में क्रमबद्ध करता है जो PostgREST साइडकार को सौंपता है। PostgREST SQL में अनुवाद करता है और इंजेक्टेड प्रोजेक्ट के search_path के साथ PgBouncer के माध्यम से एक पूल्ड कनेक्शन खोलता है।
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 द्वारा लागू किया गया: कोई किरायेदार_आईडी कॉलम नहीं, प्रति प्रोजेक्ट एक कनेक्शन भूमिका, अधिकार सार्वजनिक रूप से कभी नहीं खोले गए।
- संस्करणित माइग्रेशन। संस्करणित SQL, परमाणु रोलबैक, शून्य-डाउनटाइम। TypeScript प्रकार प्रत्येक माइग्रेशन के साथ पुनर्जीवित होते हैं।
- कोडजेन TypeScript और Rust। आपके लाइव स्कीमा से तालिकाओं, दृश्यों, एनम और आरपीसी कार्यों के लिए प्रकारों की स्वचालित पीढ़ी।
- मूल निवासी RLS। परीक्षण योग्य घोषणात्मक नीतियां। एसडीके प्रत्येक कनेक्शन में दावा किरायेदार को इंजेक्ट करता है।
- अनुमत सूचीबद्ध एक्सटेंशन। प्रोजेक्ट बनने पर प्लेटफ़ॉर्म द्वारा 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एक प्रोजेक्ट (स्कीमा, नीतियां, फ़ंक्शन, ट्रिगर, दृश्य और पंक्तियां) को अपने यूआरएल और कुंजियों के साथ एक नए प्रोजेक्ट में कॉपी करता है, इसके लाइव होने के बाद स्वचालित रूप से हटा दिया जाता है। निर्माण के समय बनाई गई प्रति, जीवित प्रतिकृति नहीं।
सीआरयूडी पूर्ण, टाइप किया गया#
चार बुनियादी ऑपरेशन समान .from(table)सतह साझा करते हैं। लौटाए गए प्रकारों का अनुमान आपके स्कीमा से लगाया जाता है - अपना आईडीई खोलें, कॉलम, जॉइन और रिटर्न पर स्वत: पूर्ण कार्य।
// अंतिम 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 या स्टूडियो › डेटाबेस › एक्सटेंशन के साथ क्या स्थापित है; aura db extensions enable <name> और POST /v1/db/{project_id}/schema/extensions अनुमत को पुनः लागू करें।
- pgvector (
vector) - pg_graphql (जब आप GraphQL सक्षम करते हैं तो इंस्टॉल हो जाता है)
- pg_stat_statements
- pgक्रिप्टो
- uuid-ossp
- pg_trgm
- उद्धरण
- hstore
- एलपेड़
- बिना उच्चारण वाला
- btree_gin
- btree_gist
- फ़ज़ीस्ट्रमैच
- अंतरारे
postgis, pg_cron, timescaledb, pgmq, और pg_partman को मानक प्रबंधित छवि में बंडल नहीं किया गया है। निर्धारित कार्यभार के लिए, Cron में क्रॉन शेड्यूल पर एक एज फ़ंक्शन ट्रिगर करें। इस परिवर्तन से पहले बनाए गए प्रोजेक्ट में केवल पांच ऐतिहासिक एक्सटेंशन (vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql) होते हैं जब तक कि प्लेटफ़ॉर्म अपना अगला स्कीमा अपडेट नहीं चलाता; आप दूसरों को स्वयं नहीं जोड़ सकते, क्योंकि केवल डेटाबेस ऑपरेटर ही उन्हें इंस्टॉल कर सकता है।
सीधे कनेक्ट करें: psql, प्रिज्मा, ड्रिज़ल, pg_dump#
प्रत्येक प्रोजेक्ट की अपनी PostgreSQL लॉगिन भूमिका (proj_xxxxxxxx) होती है और पोर्ट 5432 पर फॉर्म <project-slug>.db.<your-domain> का एक होस्ट होता है। पासवर्ड है जो मांग पर जारी किया जाता है और एक बार दिखाया जाता है: प्लेटफ़ॉर्म इसे स्पष्ट नहीं रखता है, इसलिए खोया हुआ पासवर्ड बदल दिया जाता है, कभी वापस नहीं मिलता है।
# होस्ट, पोर्ट, डेटाबेस और लिंक्ड प्रोजेक्ट की भूमिका (कोई पासवर्ड नहीं)
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
वही कार्ड स्टूडियो › सेटिंग्स › कनेक्शन › डेटाबेस (पासवर्ड जनरेट करें / पासवर्ड रीसेट करें) में मौजूद है।
- टीएलएस आवश्यक है। समापन बिंदु प्लेनटेक्स्ट कनेक्शन से इनकार करता है (
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 …। जब आपNOTIFY pgrst, 'reload schema'चलाते हैं तो PostgREST नई तालिका के बारे में सीखता है। इस नियम के अस्तित्व में आने से पहले इस कनेक्शन पर बनाई गई तालिकाएँ अगली बार जब आप पासवर्ड जारी करते हैं (aura db connection --new-password) बंद हो जाती हैं, जब तक कि वे पहले से ही RLS सक्षम न हों। - लेनदेन पूलर। कनेक्शन लेनदेन मोड में PgBouncer से गुजरते हैं। सत्र स्थिति एक लेन-देन से दूसरे लेन-देन तक नहीं जाती है: लेन-देन के अंदर
SET LOCALका उपयोग करें, और उम्मीद करें कि नामित तैयार कथन,LISTENऔर सत्र-स्तरीय सलाहकार लॉक विश्वसनीय नहीं होंगे (प्रिज्मा: URL मेंpgbouncer=trueजोड़ें)। - क्लाइंट संस्करण।
pg_dumpअपने से नए सर्वर को अस्वीकार करता है: PostgreSQL 18 क्लाइंट (pg_dump --version) का उपयोग करें।
सीधी पहुंच PostgreSQL पोर्ट को प्रकाशित करने वाली तैनाती पर निर्भर करती है। यह स्थानीय k3d स्टैक और उन परिनियोजन के लिए चालू है जिनके हेल्म मान इसे सक्षम करते हैं (इनग्रेस-nginx के पीछेingress.tcp.enabled, या pgproxy.nodePort); स्टूडियो और aura db connection आपको बताते हैं कि यह कब नहीं है।
आगे जाने के लिए#
- पंक्ति-स्तरीय सुरक्षा
मूल नीतियां, परीक्षण, बहु-किरायेदार पैटर्न।
- कन्वेंशनों
स्कीमा, कॉलम, नीतियों, RLS सहायकों का नामकरण।
- डेटाबेस शाखाएँ
प्रत्येक पुल अनुरोध के लिए प्रोजेक्ट की एक प्रति, उसके टीटीएल द्वारा हटा दी गई।
- वास्तुकला
ऑरा-डीबी 8 सेवाओं में कैसे फिट बैठता है।
- बाकी एपीआई
डेटाबेस, ऑथेंटिकेशन, स्टोरेज के लिए रॉ HTTP सतह।
- Supabase माइग्रेशन
pg_dump + RLS रीमैप, एक औसत प्रोजेक्ट के लिए 1 घंटा।