Accordi
Denominazione di schemi, colonne, policy RLS, helper di autenticazione, indici. Convenzioni stabili e documentate in modo che il tuo team abbia un solo modo per dare un nome alle cose.
Un prefisso per dominio#
Ogni progetto riceve quattro sottoschemi con il prefisso project_{uuid}. Le tue tabelle aziendali entrano nello schema principale; non creare mai oggetti negli schemi di sistema.
| Schema | Proprietario | Utilizzare |
|---|---|---|
project_{uuid} | tu | Tabelle, viste e funzioni aziendali. Questo è lo schema in cui arriva il tuo SQL non qualificato (create table posts …); è denominato public solo sull'SQL esportato con aura db backup download e schema/dump, che sono portatili. |
project_{uuid}_auth | aura-auth | Utenti, sessioni e MFA. Non modificare. |
project_{uuid}_storage | aura-storage | Bucket, oggetti e policy di storage |
project_{uuid}_platform | piattaforma | Funzioni, job, cron e segreti |
serpente_case, plurale, id uuid#
- Plurale tabelle:
posts,comments,invoices - Colonne in
snake_case:created_at,user_id,last_seen_at - Chiavi primarie
id uuid primary key default gen_random_uuid()— nouuid_generate_v4(). Preferisciuuidrispetto abigint generated always as identityquando gli ID sono esposti ai client (non indovinabile, nessun problema di precisione 2 ^ 53 in JavaScript); funziona anche una colonna di identità e i backup e i ripristini la gestiscono. - Timestamp
timestamptz, maitimestampnudo - FK suffisso
_id:author_id,tenant_id - Booleani con prefisso
is_ohas_ - Nessuna colonna
project_id— lo schema è già l'isolante
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()
);
Non aggiungere mai una colonna project_id. L'isolamento deriva già dallo schema e una colonna di questo tipo aggiungerebbe indici senza aggiungere sicurezza.
Tre funzioni inserite in ogni sessione#
Il gateway apre connessioni Postgres con request.jwt.claims specificato. I tre aiutanti di seguito leggono queste affermazioni e possono essere utilizzati ovunque nelle tue polizze.
auth.uid()— uuid dell'utente corrente, NULL se anonauth.role()— testo · anon / authenticated / service_roleauth.tenant()— uuid del tenant corrente (RBAC multi-tenant)auth.has_role(name)— booleano · vero se l'utente ha questo ruolo dell'applicazioneauth.email()— testo · email dell'utente, letto da JWTauth.claim(key)— jsonb · accesso non elaborato a un'attestazione personalizzata
Un nome prevedibile, un'operazione, un ruolo#
Convenzione: <table>_<scope>_<operation>. Esempio: posts_own_read, orders_admin_delete. Specificare sempre to aura_authenticated o to aura_anon.
-- ✓ Buono: table_scope_op
create policy "posts_own_read" on posts for select …
create policy "orders_admin_all" on orders for all …
-- ✗ Da evitare
create policy "allow_stuff" -- troppo vago
create policy "new_policy_42" -- non descrittivo
Denominazione e quando indicizzare#
- Nome:
idx_<table>_<colonnes>ouq_<table>_<colonnes>(unico) - Indicizza sempre: FK, colonne
filter/order_byfrequenti,wheredi policy RLS - Non indicizzare: colonne booleane con cardinalità elevata bassa (usa indice parziale), tabelle < 1000 righe
- pgvector:
using hnswper > 100k vettori,ivfflataltrimenti