İçeriğe geç
Aurabase Logosu
aura tabanı

Anlaşmalar

Şemaların, sütunların, RLS politikalarının, kimlik doğrulama yardımcılarının, dizinlerin adlandırılması. Ekibinizin işleri tek bir şekilde adlandırabilmesi için istikrarlı, belgelenmiş kurallar.

Referans6 dk. okuSeviye acemi15 Nis 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

Alan başına bir önek#

Her proje project_{uuid} ön ekine sahip dört alt şema alır. İş tablolarınız ana şemaya girer; asla sistem şemalarında nesneler oluşturmayın.

ŞemaSahipKullanım
project_{uuid}senTablolar, görünümler ve iş fonksiyonları. Bu, niteliksiz SQL'inizin (create table posts …) yer aldığı şemadır; yalnızca taşınabilir olan aura db backup download ve schema/dump ile dışa aktardığınız SQL'de public olarak adlandırılır.
project_{uuid}_authaura-authKullanıcılar, oturumlar ve MFA. Değişiklik yapmayın.
project_{uuid}_storageaura-storageKovalar, nesneler ve depolama politikaları
project_{uuid}_platformplatformuİşlevler, işler, cron ve sırlar

Snake_case, çoğul, kimlik uuid#

  • Çoğul tablolar: posts, comments, invoices
  • snake_case içindeki Sütunları: created_at, user_id, last_seen_at
  • Birincil anahtarlar id uuid primary key default gen_random_uuid() — hayır uuid_generate_v4(). Kimlikler istemcilere açıkken uuid yerine bigint generated always as identity'yi tercih edin (tahmin edilemez, JavaScript'te 2^53 kesinlik sorunu yok); bir kimlik sütunu da çalışır ve yedeklemeler ve geri yüklemeler bunu halleder.
  • Zaman damgaları timestamptz, asla timestamp çıplak
  • FK'ler son eki _id: author_id, tenant_id
  • Boolean'lar ön eki is_ veya has_
  • Sütun yok project_id — şema zaten yalıtkandır
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()
);
Dikkat

Hiçbir zaman project_id sütunu eklemeyin. Yalıtım zaten şemadan gelir ve böyle bir sütun, güvenlik eklemeden dizinler ekleyecektir.

Her oturuma üç işlev enjekte edildi#

Ağ geçidi, request.jwt.claims belirtilen Postgres bağlantılarını açar. Aşağıdaki üç yardımcı bu talepleri okur ve poliçelerinizin herhangi bir yerinde kullanılabilir.

  • auth.uid() — Geçerli kullanıcının kullanıcı kimliği, anonim ise NULL
  • auth.role() — metin · anon / kimliği doğrulanmış / service_role
  • auth.tenant() — Geçerli kiracının kullanıcı kimliği (çok kiracılı RBAC)
  • auth.has_role(name) — boolean · true Kullanıcı bu uygulama rolüne sahipse
  • auth.email() — metin · kullanıcı e-postası, JWT'den okundu
  • auth.claim(key) — jsonb · özel bir talebe ham erişim

Tahmin edilebilir bir isim, bir operasyon, bir rol#

Kural: <table>_<scope>_<operation>. Örnek: posts_own_read, orders_admin_delete. Her zaman to aura_authenticated veya to aura_anon belirtin.

namingsql
-- ✓ İyi: table_scope_op
create policy "posts_own_read"   on posts for select …
create policy "orders_admin_all" on orders for all …

-- ✗ Kaçınmak için
create policy "allow_stuff"    -- çok belirsiz
create policy "new_policy_42" -- açıklayıcı değil

Adlandırma ve ne zaman dizine ekleneceği#

  • Ad: idx_<table>_<colonnes> veya uq_<table>_<colonnes> (benzersiz)
  • Her zaman dizini: FK'ler, sık filter/order_by sütunları, RLS ilkelerinin where
  • Dizine ekleme: Yüksek kardinaliteye sahip düşük Boole sütunları (kısmi dizin kullanın), tablolar < 1000 satır
  • pgvector: > 100k vektörler için using hnsw, aksi takdirde ivfflat

Daha ileri gitmek için#