NoSQL e archivio documenti
Motore di database orientato ai documenti compatibile con MongoDB. Archivia strutture dati JSON flessibili, indicizza le tue raccolte ed esegui pipeline di aggregazione complesse.
L'archivio documenti Aurabase#
Oltre al motore relazionale PostgreSQL, Aurabase consente di attivare un motore NoSQL Document Store isolato per progetto. Offre la flessibilità dei documenti semistrutturati con la robustezza dell'infrastruttura Aurabase (backup, controllo degli accessi, osservabilità).
Scegli il motore NoSQL per il monitoraggio/analisi di eventi, cataloghi di prodotti con attributi eterogenei, telemetria in tempo reale e sessioni utente.
Operazioni di raccolta#
const { data, error } = await aura.nosql
.collection('events')
.insertOne({
type: 'user_signup',
userId: 'usr_9482',
metadata: { country: 'FR', plan: 'pro' },
timestamp: new Date(),
})
Chi sa leggere e scrivere una raccolta#
L'accesso è privato per impostazione predefinita e isolato per proprietario. Ogni documento riporta il timbro dell'utente che lo ha scritto e un utente che ha effettuato l'accesso legge e scrive solo i propri documenti. Una richiesta senza utente (solo la chiave anon) viene rifiutata con 403 — «Lettura rifiutata: nessuna identità utente per applicare l'isolamento per proprietario» — a meno che la raccolta non sia resa esplicitamente leggibile pubblicamente. Una chiave service_role ignora l'isolamento.
Per rendere una raccolta leggibile da tutti, aprila in Studio › Database e fai clic su Rendi pubblico (scrive resta isolato per proprietario e il campo proprietario non viene mai restituito). Lo stesso switch è disponibile sul piano di gestione, con un token di console: PUT /v1/db/{project_id}/schema/tables/{collection}/public-read con {"public_read": true}.
Motore ottimizzato per la produzione#
- Schema flessibile. Documenti JSON/BSON dinamici. Ideale per log, cataloghi e-commerce, telemetria IoT e profili non standardizzati.
- Operatori di query.
$eq,$ne,$gt,$gte,$lt,$lte,$in,$nin,$regex(modelli semplici) e$exists, su campi di livello superiore e percorsi nidificati come'metadata.country'. Un operatore non supportato dal motore viene rifiutato con un errore esplicito, mai ignorato, quindi un filtro non restituisce mai silenziosamente più di quanto richiesto. - Pipeline di aggregazione. Trasformazioni in più passaggi con $match, $project, $group, $sort, $unwind e calcoli metrici in streaming.
- Indicizzazione. Indici di testo semplici e composti per la ricerca full-text e indici TTL con eliminazione automatica dei documenti scaduti.
- Spiegazione e profilazione. Piano di esecuzione dettagliato per ogni query (COLLSCAN vs IXSCAN, tempo di esecuzione, indici utilizzati).
- API REST e SDK. Accesso diretto tramite endpoint REST
/v1/nosql/{collection}(sull'URL del tuo progetto, con il tuoapikey) o@aurabase/aurabase-jsSDK.
Ottimizzazione delle query (spiegazione)#
Chiama aura.nosql.collection('events').explain({ type: 'user_signup' }) per ottenere il progetto di un filtro.
Ogni query può essere analizzata per ispezionare i passaggi di esecuzione, identificare se è stato richiesto un indice (IXSCAN) o se è stata effettuata una scansione completa (COLLSCAN):
{
"queryPlanner": {
"winningPlan": {
"stage": "IXSCAN",
"indexName": "metadata.country_1_timestamp_-1",
"keysExamined": 42,
"docsExamined": 42
},
"executionTimeMillis": 1.2
}
}
PostgreSQL vs NoSQL: quale motore scegliere?#
| Criterio | PostgreSQL (relazionale) | Archivio documenti (NoSQL) |
|---|---|---|
| Struttura | Schema rigoroso, migrazioni con versione | Schema dinamico senza vincoli rigidi |
| Relazioni e join | Join SQL e chiavi esterne | Documenti annidati o denormalizzati |
| Controllo degli accessi | Sicurezza dichiarativa a livello di riga (RLS) in SQL | Autorizzazioni per raccolta e token del ruolo |
| Ricerca vettoriale | Nativo pgvector con HNSW | Filtraggio per attributi e indici di testo |
| Meglio per | Core banking, SaaS B2B, gestione dei diritti | Log, cataloghi dinamici, IoT, eventi |