करार
स्कीमा, कॉलम, RLS नीतियों, ऑथ हेल्पर्स, इंडेक्स का नामकरण। स्थिर, प्रलेखित परंपराएँ ताकि आपकी टीम के पास चीजों को नाम देने का एक तरीका हो।
यह पृष्ठ स्वचालित रूप से अनुवादित किया गया था. अंग्रेजी संस्करण प्रामाणिक है.
प्रति डोमेन एक उपसर्ग#
प्रत्येक प्रोजेक्ट को project_{uuid} उपसर्ग वाले चार उप-योजनाएँ प्राप्त होती हैं। आपकी व्यावसायिक तालिकाएँ मुख्य स्कीमा में जाती हैं; सिस्टम स्कीमा में कभी भी ऑब्जेक्ट न बनाएं।
| योजना | मालिक | उपयोग |
|---|---|---|
project_{uuid} | आप | तालिकाएँ, दृश्य और व्यावसायिक कार्य। यह वह स्कीमा है जिसमें आपका अयोग्य SQL (create table posts …) आता है; इसका नाम public केवल उस SQL पर है जिसे आप aura db backup download और schema/dump के साथ निर्यात करते हैं, जो पोर्टेबल हैं। |
project_{uuid}_auth | aura-auth | उपयोगकर्ता, सत्र और MFA। संशोधित न करें. |
project_{uuid}_storage | aura-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- योजनाबद्ध पहले से ही इन्सुलेटर है
sql
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 निर्दिष्ट करें।
sql
-- ✓ अच्छा: टेबल_स्कोप_ऑप
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अन्यथा