NoSQL & Document Store
Moteur de base de données orienté documents compatible MongoDB. Stockez des structures de données JSON flexibles, indexez vos collections et exécutez des pipelines d'agrégation complexes.
Le Document Store Aurabase#
En complément du moteur relationnel PostgreSQL, Aurabase permet d'activer un moteur NoSQL Document Store isolé par projet. Il offre la flexibilité des documents semi-structurés avec la robustesse de l'infrastructure Aurabase (sauvegardes, contrôle d'accès, observabilité).
Privilégiez le moteur NoSQL pour les événements de tracking/analytics, les catalogues de produits aux attributs hétérogènes, la télémétrie temps réel et les sessions utilisateurs.
Opérations sur les collections#
const { data, error } = await aura.nosql
.collection('events')
.insertOne({
type: 'user_signup',
userId: 'usr_9482',
metadata: { country: 'FR', plan: 'pro' },
timestamp: new Date(),
})
Qui peut lire et écrire une collection#
L'accès est privé par défaut et isolé par propriétaire. Chaque document est marqué de l'utilisateur qui l'a écrit, et un utilisateur connecté ne lit et n'écrit que ses propres documents. Une requête sans utilisateur (la seule clé anon) est refusée en 403 — « Read refused: no user identity to apply per-owner isolation » — sauf si la collection a été explicitement rendue lisible publiquement. Une clé service_role contourne l'isolation.
Pour rendre une collection lisible par tous, ouvrez-la dans Studio › Database et cliquez sur Make public (les écritures restent isolées par propriétaire, et le champ propriétaire n'est jamais renvoyé). Le même interrupteur existe sur le plan de gestion, avec un jeton console : PUT /v1/db/{project_id}/schema/tables/{collection}/public-read avec {"public_read": true}.
Moteur optimisé pour la production#
- Schéma flexible. Documents JSON/BSON dynamiques. Idéal pour logs, catalogues e-commerce, télémétrie IoT et profils non normalisés.
- Opérateurs de requête.
$eq,$ne,$gt,$gte,$lt,$lte,$in,$nin,$regex(motifs simples) et$exists, sur les champs de premier niveau et les chemins imbriqués comme'metadata.country'. Un opérateur que le moteur ne gère pas est rejeté avec une erreur explicite, jamais ignoré : un filtre ne renvoie donc jamais silencieusement plus que ce que vous avez demandé. - Pipelines d’agrégation. Transformations en plusieurs étapes avec $match, $project, $group, $sort, $unwind et calculs de métriques en streaming.
- Indexation performante. Index simples, composés, texte pour la recherche plein texte et index TTL avec purge automatique des documents expirés.
- Explain & Profiling. Plan d’exécution détaillé pour chaque requête (COLLSCAN vs IXSCAN, temps d’exécution, index utilisés).
- API REST & SDK unifié. Accès direct via les endpoints REST
/v1/nosql/{collection}(sur l’URL de votre projet, avec votreapikey) ou le SDK@aurabase/aurabase-js.
Optimisation des requêtes (Explain)#
Appelez aura.nosql.collection('events').explain({ type: 'user_signup' }) pour obtenir le plan d’un filtre.
Chaque requête peut être analysée pour inspecter les étapes d'exécution, identifier si un index a été sollicité (IXSCAN) ou si un scan complet a eu lieu (COLLSCAN) :
{
"queryPlanner": {
"winningPlan": {
"stage": "IXSCAN",
"indexName": "metadata.country_1_timestamp_-1",
"keysExamined": 42,
"docsExamined": 42
},
"executionTimeMillis": 1.2
}
}
PostgreSQL vs NoSQL : Quel moteur choisir ?#
CritèrePostgreSQL (Relationnel)Document Store (NoSQL)
StructureSchéma strict, migrations versionnéesSchéma dynamique sans contraintes rigides
Relations & JointuresJointures SQL complexes, clés étrangèresDocuments imbriqués / dénormalisés
Contrôle d’accèsRow-Level Security (RLS) déclaratif SQLPermissions par collection & rôle token
Recherche Vectoriellepgvector natif avec index HNSWFiltrage par attributs et index texte
Idéal pourCore banking, SaaS B2B, gestion de droitsLogs, catalogues dynamiques, IoT, events