NoSQL y almacén de documentos
Motor de base de datos orientado a documentos compatible con MongoDB. Almacene estructuras de datos JSON flexibles, indexe sus colecciones y ejecute procesos de agregación complejos.
El almacén de documentos Aurabase#
Además del motor relacional PostgreSQL, Aurabase le permite activar un motor NoSQL Document Store aislado por proyecto. Ofrece la flexibilidad de los documentos semiestructurados con la solidez de la infraestructura Aurabase (copias de seguridad, control de acceso, observabilidad).
Elija el motor NoSQL para seguimiento/análisis de eventos, catálogos de productos con atributos heterogéneos, telemetría en tiempo real y sesiones de usuarios.
Operaciones de cobranza#
const { data, error } = await aura.nosql
.collection('events')
.insertOne({
type: 'user_signup',
userId: 'usr_9482',
metadata: { country: 'FR', plan: 'pro' },
timestamp: new Date(),
})
¿Quién puede leer y escribir una colección?#
El acceso es privado de forma predeterminada y aislado por propietario. Cada documento lleva el sello del usuario que lo escribió y un usuario que ha iniciado sesión solo lee y escribe sus propios documentos. Una solicitud sin usuario (solo la clave anon) se rechaza con 403 — «Lectura rechazada: no hay identidad de usuario para aplicar aislamiento por propietario» — a menos que la colección se haga explícitamente legible públicamente. Una clave service_role evita el aislamiento.
Para que todos puedan leer una colección, ábrala en Studio › Base de datos y haga clic en Hacer pública (las escrituras permanecen aisladas por propietario y el campo de propietario nunca se devuelve). El mismo conmutador está disponible en el plano de administración, con un token de consola: PUT /v1/db/{project_id}/schema/tables/{collection}/public-read con {"public_read": true}.
Motor optimizado para la producción.#
- Esquema flexible. Documentos JSON/BSON dinámicos. Ideal para registros, catálogos de comercio electrónico, telemetría IoT y perfiles no estandarizados.
- Operadores de consulta.
$eq,$ne,$gt,$gte,$lt,$lte,$in,$nin,$regex(patrones simples) y$exists, en campos de nivel superior y rutas anidadas como'metadata.country'. Un operador que el motor no admite es rechazado con un error explícito, nunca ignorado, por lo que un filtro nunca devuelve silenciosamente más de lo solicitado. - Canalizaciones de agregación. Transformaciones de varios pasos con cálculos de métricas de $match, $project, $group, $sort, $unwind y streaming.
- Indexación. Índices de texto simples y compuestos para búsqueda de texto completo e índices TTL con purga automática de documentos caducados.
- Explicar y perfilar. Plan de ejecución detallado para cada consulta (COLLSCAN vs IXSCAN, tiempo de ejecución, índices utilizados).
- API REST y SDK. Acceso directo a través de puntos finales REST
/v1/nosql/{collection}(en la URL de su proyecto, con suapikey) o el SDK@aurabase/aurabase-js.
Optimización de consultas (Explicar)#
Llame a aura.nosql.collection('events').explain({ type: 'user_signup' }) para obtener el plan de un filtro.
Cada consulta se puede analizar para inspeccionar los pasos de ejecución, identificar si se solicitó un índice (IXSCAN) o si se realizó un análisis completo (COLLSCAN):
{
"queryPlanner": {
"winningPlan": {
"stage": "IXSCAN",
"indexName": "metadata.country_1_timestamp_-1",
"keysExamined": 42,
"docsExamined": 42
},
"executionTimeMillis": 1.2
}
}
PostgreSQL vs NoSQL: ¿Qué motor elegir?#
| Criterio | PostgreSQL (relacional) | Almacén de documentos (NoSQL) |
|---|---|---|
| Estructura | Esquema estricto, migraciones versionadas | Esquema dinámico sin restricciones rígidas. |
| Relaciones y uniones | Uniones SQL y claves foráneas | Documentos anidados o desnormalizados |
| control de acceso | Seguridad declarativa a nivel de fila (RLS) en SQL | Permisos por colección y token de rol |
| Búsqueda de vectores | Nativo pgvector con HNSW | Filtrado por atributos e índices de texto |
| Lo mejor para | Core bancario, B2B SaaS, gestión de derechos | Logs, catálogos dinámicos, IoT, eventos |