Supabase से माइग्रेट करें
क्लाइंट एपीआई, RLS नीतियां और Edge Functions आगे बढ़ते हैं। सीएलआई आपके Supabase उपयोगकर्ताओं को उनके bcrypt पासवर्ड हैश के साथ निर्यात करता है, एक सादा pg_dump (कथन, फ़ंक्शन निकाय, COPY डेटा) पुनर्स्थापित करता है और उपयोगकर्ताओं को आयात करता है: यह पृष्ठ सटीक रूप से बताता है कि प्रत्येक चरण क्या करता है और कहां रुकता है।
95% Supabase के समान#
क्लाइंट एपीआई, RLS नीतियां, ऑथ मॉडल और स्टोरेज Supabase के सम्मेलनों का पालन करते हैं, इसलिए एप्लिकेशन कोड बहुत कम बदलता है। नीचे दी गई तालिका बताती है कि क्या समान है और क्या नहीं।
| विशेषता | अनुकूलता | टिप्पणी |
|---|---|---|
createClient() | वही | @supabase/supabase-js के बजाय @aurabase/aurabase-js आयात करें |
.from().select() | वही | समान श्रृंखलाबद्ध PostgREST एपीआई |
| RLS नीतियां | वही | Postgres SQL नीतियाँ। to authenticated, to anon और to service_role को aura_authenticated, aura_anon और aura_service_role के उपनाम के रूप में स्वीकार किया जाता है। ये भूमिकाएँ प्रोजेक्ट के डेटाबेस क्लस्टर के साथ बनाई गई हैं; उस परिवर्तन से पहले बनाए गए क्लस्टर पर, aura_* भूमिका नाम लिखें। |
auth.uid() और auth.role() | वही | मददगार दावे दर दावे संगत |
auth.getUser() | मामूली अंतर | data उपयोगकर्ता है (data.email); Supabase { data: { user } } लौटाता है। const { data: { user } } = await supabase.auth.getUser() के रूप में लिखे गए कोड को यहां user === undefined मिलता है: const { data: user } = await aura.auth.getUser() लिखें |
.rpc() | वही | Postgres फ़ंक्शंस के लिए समान हस्ताक्षर |
.storage.from().upload() | वही | S3-समान पथों के साथ संगत एपीआई |
.channel().on("postgres_changes") | वही | समान परिवर्तन डेटा कैप्चर सतह |
| Edge Functions (Deno) | वही | मानक Deno रनटाइम; Deno.serve() पुनर्लेखन के बिना काम करता है |
| प्रामाणिक हुक | मामूली अंतर | HTTP वेबहुक और समर्पित समापन बिंदु |
| सेवा भूमिका कुंजी | वही | वही भूमिका, वही दायरा |
चार आदेश, क्रम में#
- निर्यात -
aura migrate export-supabaseusers.json(उपयोगकर्ता, पासवर्ड हैश, OAuth पहचान) औरdump.sql(publicस्कीमा, संरचना और डेटा काpg_dump) लिखता है। - पुनर्स्थापित करें -
aura db restore dump.sqlडंप को लिंक किए गए प्रोजेक्ट में दोबारा चलाता है - उपयोगकर्ताओं को आयात करें —
aura auth import users.json; उपयोगकर्ता अपनी आईडी और पासवर्ड रखते हैं - कटओवर - अपने ऐप में यूआरएल और कुंजियाँ स्विच करें; अपने Edge Functions को अपरिवर्तित तैनात करें
# 1. Supabase से निर्यात करें (सेटिंग्स > डेटाबेस > कनेक्शन स्ट्रिंग, `पोस्टग्रेज़' भूमिका)
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export
# 2. स्कीमा और डेटा को लिंक किए गए Aurabase प्रोजेक्ट में पुनर्स्थापित करें
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run # केवल योजना को पार्स करें और प्रिंट करें
aura db restore ./supabase-export/dump.sql
# 3. उपयोगकर्ताओं को उनके पासवर्ड हैश के साथ आयात करें
aura auth import ./supabase-export/users.json
स्कीमा और डेटा पुनर्स्थापित करें#
aura migrate export-supabase आपके स्थानीय pg_dump के साथ pg_dump --schema=public --no-owner --no-acl --format=plain चलाता है (PostgreSQL क्लाइंट टूल इंस्टॉल करें; उनके बिना, कमांड स्वयं को चलाने के लिए सटीक pg_dump लाइन प्रिंट करता है)।
aura db restore <file.sql> एक सादा SQL डंप पढ़ता है जिस तरह से psql करता है: कथन स्ट्रिंग, उद्धृत पहचानकर्ताओं, टिप्पणियों और डॉलर-उद्धृत निकायों ($$ … $$, $fn$ … $fn$) के बाहर विभाजित होते हैं, COPY … FROM stdin ब्लॉक उनकी \. लाइन तक पढ़े जाते हैं, और psql मेटा-कमांड (\connect, \restrict) छोड़ दिए गए हैं। यह तो:
public.क्वालिफायर को हटा देता है जिसेpg_dumpलिखता है, इसलिए तालिकाएँ प्रोजेक्ट स्कीमा में आ जाती हैं (किसी अन्य स्कीमा के लिए--source-schema);- Aurabase पर जिसका कोई अर्थ नहीं है उसे छोड़ देता है और कहता है क्यों: सत्र सेटिंग्स (
SET,set_config),OWNER TO,GRANT/REVOKESupabase भूमिकाओं में से,CREATE EXTENSION(एक्सटेंशन Aurabase द्वारा प्रबंधित होते हैं),CREATE SCHEMA public; - फ़ाइल के क्रम में बाकी सब कुछ चलाता है, और अपने नंबर, इसकी डंप लाइन और त्रुटि के साथ पहले असफल चरण पर रुक जाता है। कारण को ठीक करें और
--from <step>के साथ फिर से शुरू करें, या असफल चरणों से आगे बढ़ने और अंत में सूची प्राप्त करने के लिए--continue-on-errorपास करें।--dry-runबिना कुछ क्रियान्वित किए योजना को प्रिंट करता है।
दो रास्ते, aura db push जैसे चुने गए:
लिंक किया गया प्रोजेक्ट, नहीं DATABASE_URL | DATABASE_URL सेट (प्रत्यक्ष कनेक्शन स्ट्रिंग) | |
|---|---|---|
| परिवहन | प्रति कथन एक SQL API कॉल, सर्वर द्वारा मान्य | एक PostgreSQL कनेक्शन |
COPY डेटा | INSERT बैचों में परिवर्तित (500 पंक्तियाँ) | COPY प्रोटोकॉल, डेटा डंप किया गया |
फ़ंक्शन, ट्रिगर, DO ब्लॉक | ने SQL API द्वारा को अस्वीकृत कर दिया: उन्हें aura db function create और aura db trigger create के साथ बनाएं | बनाया था |
| सुरक्षा सीमा | प्रोजेक्ट के लिए सर्वर की अलगाव नीति | प्रोजेक्ट की PostgreSQL भूमिका (केवल इसका अपना डेटाबेस, कोई सुपरयूजर नहीं, रो लेवल सिक्योरिटी लागू होती है) |
एसक्यूएल एपीआई पथ पर, सर्वर E'…' स्ट्रिंग्स, अन्य स्कीमा के संदर्भ और, एक बयान में, टेक्स्ट को अस्वीकार कर देता है जो एक निषिद्ध कमांड की तरह दिखता है, यहां तक कि एक स्ट्रिंग शाब्दिक के अंदर भी: ऐसे टेक्स्ट वाली डेटा पंक्ति अपने चरण संख्या के साथ विफल हो जाती है। उन डंपों के लिए सीधे रास्ते का उपयोग करें। जब आपका परिनियोजन प्रत्यक्ष PostgreSQL एक्सेस प्रकाशित करता है तो सीधा कनेक्शन स्ट्रिंग सेटिंग्स › कनेक्शन में होता है।
को क्रमिक रूप से पर पुनर्स्थापित करें: एक सादा SQL डंप ऑर्डर किया गया है (तालिकाएं, फिर डेटा, फिर बाधाएं और अनुक्रमणिका) और समानांतर करने के लिए कोई निर्भरता ग्राफ़ नहीं है। कोई थ्रूपुट आंकड़ा प्रकाशित नहीं किया गया है.
auth.users के सन्दर्भ यथावत पुनर्स्थापित नहीं होते। Aurabase Auth अपने उपयोगकर्ताओं को auth.users तालिका में नहीं रखता है, इसलिए REFERENCES auth.users(id) जैसी विदेशी कुंजी विफल हो जाती है। --continue-on-error के साथ पुनर्स्थापित करें और user_id कॉलम को उस बाधा के बिना रखें: उपयोगकर्ता आईडी नीचे आयात द्वारा संरक्षित हैं, इसलिए मान अभी भी मेल खाते हैं।
उपयोगकर्ता और पासवर्ड#
aura migrate export-supabase auth.users और auth.identities को पढ़ता है और प्रत्येक उपयोगकर्ता के लिए लिखता है: मूल आईडी, ईमेल, email_verified, encrypted_password का bcrypt हैश, नाम और मेटाडेटा (raw_user_meta_data, और raw_app_meta_data बिना Supabase की अपनी provider/providers कुंजियाँ), और लिंक की गई OAuth पहचान (Google, GitHub…)। फ़ाइल केवल आपके द्वारा पढ़ने योग्य लिखी गई है: इसमें पासवर्ड हैश है, आयात के बाद इसे हटा दें।
aura auth import users.json उपयोगकर्ताओं को 1,000 के बैच में व्यवस्थापक आयात API पर भेजता है और प्रत्येक पंक्ति को प्रिंट करता है जो नहीं बनाई गई है (skipped जब ईमेल या आईडी पहले से मौजूद है, error कारण के साथ)। इसे दोबारा चलाना सुरक्षित है: मौजूदा उपयोगकर्ताओं को कभी भी अधिलेखित नहीं किया जाता है।
साइन-इन पर, Aurabase Auth bcrypt हैश को सत्यापित करता है, फिर इसे Argon2id हैश से बदल देता है: आपके उपयोगकर्ता अपना पासवर्ड रखते हैं और कुछ नहीं करते हैं। आयात 4 से 12 (Supabase 10 का उपयोग करता है) की लागत के साथ bcrypt हैश $2a$, $2b$ और $2y$ और सीमित मापदंडों के साथ Argon2id हैश स्वीकार करता है; किसी अन्य प्रारूप को पंक्ति दर पंक्ति अस्वीकार कर दिया जाता है। OAuth उपयोगकर्ता उसी प्रदाता के साथ दोबारा साइन इन करते हैं और उसी खाते पर आते हैं।
आगे नहीं बढ़ाया गया: MFA कारक (TOTP, फ़ोन), सक्रिय सत्र और ताज़ा टोकन (प्रत्येक उपयोगकर्ता एक बार फिर से साइन इन करता है), प्रतिबंध, फ़ोन-केवल, अनाम और हटाए गए उपयोगकर्ता (निर्यात द्वारा गिना और रिपोर्ट किया गया)। MFA वाले उपयोगकर्ताओं को फिर से नामांकन करना होगा।
मूल Deno - शून्य पुनर्लेखन#
Aurabase एक मानक Deno रनटाइम चलाता है। Deno.serve() का उपयोग करने वाले आपके फ़ंक्शन बिना किसी संशोधन के 100% संगत हैं:
// मानक Deno फ़ंक्शन - Aurabase की तरह काम करता है
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(
JSON.stringify({ message: `Hello ${name}!` }),
{ headers: { 'content-type': 'application/json' } }
)
})