Base de données
PostgreSQL 18, une base de données dédiée par projet sur le cluster de votre organisation, des schémas isolés, des types TypeScript générés automatiquement, des RLS natifs. Pas de forks, pas de proxy de réécriture – vos extensions, déclencheurs et PL/pgSQL fonctionnent tels quels.
Postgres 18, sans abstraction#
Le service aura-db expose un CRUD générique au-dessus d'un PostgreSQL 18 : chaque projet possède sa propre base de données, hébergée sur le cluster PostgreSQL de votre organisation (un cluster entièrement dédié à un seul projet sur l'offre entreprise). Chaque appel du SDK est traduit en SQL natif via une fine couche qui respecte le RLS policies injecté dans la session.
Vous pouvez également contourner le SDK et pointer psql, Prisma, Drizzle, Kysely, Metabase ou pg_dump sur votre base de données : protocole filaire standard PostgreSQL, TLS, un rôle qui ne peut atteindre que la base de données de votre projet. Voir Connectez-vous directement ci-dessous. (Un déploiement qui ne publie pas le port PostgreSQL le précise dans Studio › Paramètres › Connexion: utilisez le SDK, l'API REST, l'éditeur SQL ou la CLI, aura db raw.)
Un pg_dump vous donne votre base de données complète (schéma, données, extensions, politiques). Pas de blocage, migration sortante triviale.
Le SDK appelle PostgREST, qui appelle Postgres#
Sous le capot, le SDK sérialise vos appels .from().select()… dans une requête HTTP à aura-db qui délègue à un side-car PostgREST. PostgREST se traduit en SQL et ouvre une connexion poolée via PgBouncer avec le search_path du projet injecté.
SDK → HTTPS GET /v1/db/sensors?select=id,name
Gateway → aura-db Session verification & routing
aura-db → PgBouncer → PostgreSQL 18
# Connexion avec le projet search_path
SET LOCAL search_path = project_a7f3_, public;
SET LOCAL request.jwt.claims = '{ "sub": "u_9k2", "tenant": "t_4c" }';
SELECT id, name, temperature FROM sensors WHERE active = true LIMIT 50;
Les stratégies RLS ont accès à auth.uid(), auth.role(), auth.tenant(). Ces assistants lisent request.jwt.claims injecté par la passerelle – impossible à falsifier côté client.
Six capacités natives#
- Schéma par projet. Partitionnement appliqué par PostgreSQL: pas de colonne tenant_id, un rôle de connexion par projet, droits jamais ouverts au PUBLIC.
- Migrations versionnées. SQL versionné, restauration atomique, temps d'arrêt nul. Les types TypeScript sont régénérés à chaque migration.
- Codegen TypeScript & Rust. Génération automatique de types pour les tables, vues, énumérations et fonctions RPC à partir de votre schéma en direct.
- Natif RLS. Politiques déclaratives testables. Le SDK injecte le locataire de revendication dans chaque connexion.
- Extensions autorisées. 14 extensions installées par la plateforme lors de la création d'un projet :
pgvector,pgcrypto,uuid-ossp,pg_trgm,pg_graphql,pg_stat_statements,citext,hstore,ltree,unaccent,btree_gin,btree_gist,fuzzystrmatch,intarray. - Branches de la base de données.
aura branch createcopie un projet (schéma, politiques, fonctions, déclencheurs, vues et lignes) dans un nouveau projet avec sa propre URL et ses propres clés, supprimée automatiquement après sa durée de vie. Une copie réalisée au moment de la création, pas une réplique dynamique.
CRUD complet, tapé#
Les quatre opérations de base partagent la même surface .from(table). Les types renvoyés sont déduits de votre schéma : ouvrez votre IDE, la saisie semi-automatique fonctionne sur les colonnes, les jointures et les retours.
// Lister les 50 derniers capteurs actifs
const { data, error } = await aura
.from('sensors')
.select('id, name, temperature, location!inner(city)')
.eq('active', true)
.order('captured_at', { ascending: false })
.limit(50)
Besoin de SQL plus complexe ? Créez une fonction Postgres et appelez-la via aura.rpc('function_name', args). Les fonctions bénéficient des mêmes politiques RLS que les tables.
14 extensions sur liste blanche prêtes#
14 extensions sur liste blanche, prêtes pour chaque nouveau projet
La plateforme les installe lors de la création du projet (un rôle de projet ne peut pas exécuter lui-même CREATE EXTENSION, il n'y a donc aucune étape d'activation à oublier). Répertoriez ce qui est installé avec aura db extensions list ou Studio › Base de données › Extensions; aura db extensions enable <name> et POST /v1/db/{project_id}/schema/extensions en réappliquent un autorisé.
- pgvector (
vector) - pg_graphql (installé lorsque vous activez GraphQL)
- pg_stat_statements
- pgcrypto
- uuid-ossp
- pg_trgm
- citext
- hstore
- larbre
- sans accent
- btree_gin
- btree_gist
- match flou
- réseau intégré
postgis, pg_cron, timescaledb, pgmq et pg_partman ne sont pas regroupés dans l'image gérée standard. Pour les charges de travail planifiées, déclenchez une fonction Edge selon une planification cron dans Cron. Un projet créé avant ce changement n'a que les cinq extensions historiques (vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql) jusqu'à ce que la plateforme exécute sa prochaine mise à jour de schéma ; vous ne pouvez pas ajouter les autres vous-même, car seul l'opérateur de la base de données peut les installer.
Connectez-vous directement : psql, Prisma, Drizzle, pg_dump#
Chaque projet possède son propre rôle de connexion PostgreSQL (proj_xxxxxxxx) et un hôte du formulaire <project-slug>.db.<your-domain> sur le port 5432. Le mot de passe est émis à la demande et affiché une fois: la plateforme ne le garde pas en clair, donc un mot de passe perdu est remplacé, jamais récupéré.
# Hôte, port, base de données et rôle du projet lié (pas de mot de passe)
aura db connection
# Émettez un mot de passe et imprimez la chaîne de connexion complète (révoque le mot de passe précédent)
aura db connection --new-password
# Ouvrez psql dessus (psql demande le mot de passe)
aura connect
aura db connection --new-password imprime une chaîne que vous pouvez coller n'importe où :
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require
La même carte existe dans Studio › Paramètres › Connexion › Base de données (Générer le mot de passe / Réinitialiser le mot de passe).
- TLS est requis. Le point de terminaison refuse les connexions en texte clair (
sslmode=require). Sur une pile k3d locale, le certificat est auto-signé (*.db.localhost), doncsslmode=verify-fulléchoue de par sa conception ; la production utilise un certificat délivré pour*.db.<your-domain>. - Confiné à votre projet. Le routeur sélectionne votre base de données à partir du nom de rôle et le force : demander un autre nom de base de données atterrit toujours dans la vôtre, et la présentation de votre rôle sur l'hôte d'un autre projet est refusée. Votre rôle n'est pas celui d'un superutilisateur et ne contourne pas RLS; pour exécuter une migration en tant que propriétaire de la table, utilisez
BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;. - Les tables que vous créez ici sont privées pour la plateforme. La sécurité au niveau des lignes (RLS) ne peut pas être activée automatiquement pour une table créée par cette connexion (il faudrait un superutilisateur PostgreSQL, qu'un projet managé n'expose jamais) : les clés publiques n'ont donc aucun privilège dessus. L'API REST répond
permission deniedà la clé anon et aux utilisateurs connectés, tandis que la cléservice_role, le Studio et votre propre rôle la lisent et l'écrivent. Pour l'exposer au SDK, activez RLS, accordez les droits, puis ajoutez une stratégie (voir Sécurité au niveau des lignes) :ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …. PostgREST découvre la nouvelle table quand vous exécutezNOTIFY pgrst, 'reload schema'. Les tables créées par cette connexion avant cette règle sont fermées à la prochaine émission d'un mot de passe (aura db connection --new-password), sauf si leur RLS est déjà activée. - Pool de transactions. Les connexions passent par PgBouncer en mode transaction. L'état de session ne se transmet pas d'une transaction à la suivante : utilisez
SET LOCALdans une transaction et attendez-vous à ce que les instructions préparées nommées,LISTENet les verrous consultatifs au niveau de la session ne soient pas fiables (Prisma : ajoutezpgbouncer=trueà l'URL). - Version client.
pg_dumprefuse un serveur plus récent que lui : utilisez un client PostgreSQL 18 (pg_dump --version).
L'accès direct dépend du déploiement publiant le port PostgreSQL. Il est activé pour la pile k3d locale et pour les déploiements dont les valeurs Helm le permettent (ingress.tcp.enabled derrière ingress-nginx, ou pgproxy.nodePort) ; le Studio et aura db connection vous indiquent quand ce n'est pas le cas.
Pour aller plus loin#
- Sécurité au niveau des lignes
Politiques natives, tests, modèles multi-tenants.
- Congrès
Nommer les schémas, les colonnes, les politiques, les assistants RLS.
- Branches de base de données
Une copie d'un projet pour chaque pull request, supprimée par son TTL.
- Architecture
Comment aura-db s'intègre dans les 8 services.
- API REST
Surface HTTP brute pour la base de données, l'authentification et le stockage.
- SupabaseMigration
pg_dump + remappage RLS, 1 heure pour un projet moyen.