Vereinbarungen
Benennung von Schemata, Spalten, RLS-Richtlinien, Authentifizierungshilfen, Indizes. Stabile, dokumentierte Konventionen, damit Ihr Team eine Möglichkeit hat, Dinge zu benennen.
Ein Präfix pro Domain#
Jedes Projekt erhält vier Unterschemata mit dem Präfix project_{uuid}. Ihre Geschäftstabellen gehen in das Hauptschema ein; Erstellen Sie niemals Objekte in Systemschemata.
| Schema | Besitzer | Benutzen |
|---|---|---|
project_{uuid} | Du | Tabellen, Ansichten und Geschäftsfunktionen. Dies ist das Schema, in dem Ihr unqualifiziertes SQL (create table posts …) landet; Es heißt public nur in der SQL, die Sie mit aura db backup download und schema/dump exportieren, die portierbar sind. |
project_{uuid}_auth | aura-auth | Benutzer, Sitzungen und MFA. Nicht ändern. |
project_{uuid}_storage | aura-storage | Buckets, Objekte und Speicherrichtlinien |
project_{uuid}_platform | Plattform | Funktionen, Jobs, Cron und Geheimnisse |
Snake_case, Plural, ID-UUID#
- Plural Tabellen:
posts,comments,invoices - Spalten in
snake_case:created_at,user_id,last_seen_at - Primärschlüssel
id uuid primary key default gen_random_uuid()– neinuuid_generate_v4(). Bevorzugen Sieuuidgegenüberbigint generated always as identity, wenn IDs für Clients verfügbar gemacht werden (nicht erraten, kein 2^53-Genauigkeitsproblem in JavaScript); Eine Identitätsspalte funktioniert ebenfalls und wird von Sicherungen und Wiederherstellungen übernommen. - Zeitstempel
timestamptz, niemalstimestampnackt - FKs mit Suffix
_id:author_id,tenant_id - Boolesche Werte mit Präfix
is_oderhas_ - Keine Spalte
project_id– der Schaltplan ist bereits der Isolator
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()
);
Fügen Sie niemals eine project_id-Spalte hinzu. Die Isolation ergibt sich bereits aus dem Schema, und eine solche Spalte würde Indizes hinzufügen, ohne die Sicherheit zu erhöhen.
In jede Sitzung werden drei Funktionen eingefügt#
Das Gateway öffnet Postgres-Verbindungen mit der angegebenen request.jwt.claims. Die drei folgenden Helfer lesen diese Ansprüche und können überall in Ihren Policen verwendet werden.
auth.uid()— uuid des aktuellen Benutzers, NULL, wenn anonymauth.role()— Text · anonym / authentifiziert / service_roleauth.tenant()— uuid des aktuellen Mandanten (Multi-Tenant-RBAC)auth.has_role(name)— boolean · true, wenn der Benutzer diese Anwendungsrolle hatauth.email()— Text · Benutzer-E-Mail, gelesen aus JWTauth.claim(key)— jsonb · Rohzugriff auf einen benutzerdefinierten Anspruch
Ein vorhersehbarer Name, eine Operation, eine Rolle#
Konvention: <table>_<scope>_<operation>. Beispiel: posts_own_read, orders_admin_delete. Geben Sie immer to aura_authenticated oder to aura_anon an.
-- ✓ Gut: table_scope_op
create policy "posts_own_read" on posts for select …
create policy "orders_admin_all" on orders for all …
-- ✗ Zu vermeiden
create policy "allow_stuff" -- zu vage
create policy "new_policy_42" -- nicht beschreibend
Benennung und Zeitpunkt der Indizierung#
- Name:
idx_<table>_<colonnes>oderuq_<table>_<colonnes>(eindeutig) - Indizieren Sie immer: FKs, häufige
filter/order_by-Spalten,wherevon RLS-Richtlinien - Nicht indizieren: Boolesche Spalten mit hoher Kardinalität niedrig (Teilindex verwenden), Tabellen < 1000 Zeilen
- pgvector:
using hnswfür > 100.000 Vektoren, andernfallsivfflat