सामग्री पर जाएँ
ऑराबेस लोगो
aurabase

करार

स्कीमा, कॉलम, RLS नीतियों, ऑथ हेल्पर्स, इंडेक्स का नामकरण। स्थिर, प्रलेखित परंपराएँ ताकि आपकी टीम के पास चीजों को नाम देने का एक तरीका हो।

संदर्भ6 मि॰ पढ़ेंस्तर शुरुआत15 अप्रैल 2026 पर संशोधित

यह पृष्ठ स्वचालित रूप से अनुवादित किया गया था. अंग्रेजी संस्करण प्रामाणिक है.

प्रति डोमेन एक उपसर्ग#

प्रत्येक प्रोजेक्ट को project_{uuid} उपसर्ग वाले चार उप-योजनाएँ प्राप्त होती हैं। आपकी व्यावसायिक तालिकाएँ मुख्य स्कीमा में जाती हैं; सिस्टम स्कीमा में कभी भी ऑब्जेक्ट न बनाएं।

योजनामालिकउपयोग
project_{uuid}आपतालिकाएँ, दृश्य और व्यावसायिक कार्य। यह वह स्कीमा है जिसमें आपका अयोग्य SQL (create table posts …) आता है; इसका नाम public केवल उस SQL ​​पर है जिसे आप aura db backup download और schema/dump के साथ निर्यात करते हैं, जो पोर्टेबल हैं।
project_{uuid}_authaura-authउपयोगकर्ता, सत्र और MFA। संशोधित न करें.
project_{uuid}_storageaura-storageबाल्टी, वस्तुएँ और भंडारण नीतियाँ
project_{uuid}_platformप्लैटफ़ॉर्मकार्य, नौकरियां, क्रोन और रहस्य

स्नेक_केस, बहुवचन, आईडी यूयूआईडी#

  • बहुवचन तालिकाएँ: posts, comments, invoices
  • कॉलम snake_case में: created_at, user_id, last_seen_at
  • प्राथमिक कुंजी id uuid primary key default gen_random_uuid() - नहीं uuid_generate_v4()। जब आईडी ग्राहकों के सामने आती हैं तो bigint generated always as identity के बजाय uuid को प्राथमिकता दें (अनुमान लगाने योग्य नहीं, जावास्क्रिप्ट में कोई 2^53 सटीक समस्या नहीं); एक पहचान स्तंभ भी काम करता है, और बैकअप और पुनर्स्थापना इसे संभालते हैं।
  • टाइमस्टैम्प timestamptz, कभी भी timestamp नग्न नहीं
  • FKs प्रत्यय _id: author_id, tenant_id
  • बूलियन्स उपसर्ग is_ या has_
  • कोई कॉलम नहीं project_id - योजनाबद्ध पहले से ही इन्सुलेटर है
exemplesql
create table posts (
  id            uuid primary key default gen_random_uuid(),
  author_id     uuid not null references users(id) on delete cascade,
  title         text not null,
  is_published  boolean not null default false,
  created_at    timestamptz not null default now()
);
ध्यान

कभी भी project_id कॉलम न जोड़ें। स्कीमा से अलगाव पहले से ही आता है, और ऐसा कॉलम सुरक्षा जोड़े बिना इंडेक्स जोड़ देगा।

प्रत्येक सत्र में तीन फ़ंक्शन इंजेक्ट किए गए#

गेटवे निर्दिष्ट request.jwt.claims के साथ Postgres कनेक्शन खोलता है। नीचे दिए गए तीन सहायक इन दावों को पढ़ते हैं और आपकी पॉलिसियों में कहीं भी उपयोग किए जा सकते हैं।

  • auth.uid() — वर्तमान उपयोगकर्ता का uuid, यदि कोई हो तो शून्य
  • auth.role() — टेक्स्ट · एनोन/प्रमाणित/सेवा_भूमिका
  • auth.tenant() — वर्तमान किरायेदार का यूयूआईडी (बहु-किरायेदार आरबीएसी)
  • auth.has_role(name) — बूलियन · यदि उपयोगकर्ता के पास यह एप्लिकेशन भूमिका है तो सत्य है
  • auth.email() — टेक्स्ट · उपयोगकर्ता ईमेल, JWT से पढ़ें
  • auth.claim(key) — jsonb · कस्टम दावे तक कच्ची पहुंच

एक पूर्वानुमानित नाम, एक ऑपरेशन, एक भूमिका#

कन्वेंशन: <table>_<scope>_<operation>। उदाहरण: posts_own_read, orders_admin_delete। हमेशा to aura_authenticated या to aura_anon निर्दिष्ट करें।

namingsql
-- ✓ अच्छा: टेबल_स्कोप_ऑप
create policy "posts_own_read"   on posts for select …
create policy "orders_admin_all" on orders for all …

-- ✗ बचने के लिए
create policy "allow_stuff"    -- बहुत अस्पष्ट
create policy "new_policy_42" -- वर्णनात्मक नहीं

नामकरण और कब अनुक्रमित करना है#

  • नाम: idx_<table>_<colonnes> या uq_<table>_<colonnes> (अद्वितीय)
  • हमेशा अनुक्रमणिका: FKs, बारंबार filter/order_by कॉलम, RLS नीतियों में से where
  • इंडेक्स न करें: उच्च कार्डिनैलिटी वाले बूलियन कॉलम कम (आंशिक इंडेक्स का उपयोग करें), टेबल <1000 पंक्तियाँ
  • pgvector: using hnsw > 100k वैक्टर के लिए, ivfflat अन्यथा

आगे जाने के लिए#