Vai al contenuto
Logo Aurabase
aurabase

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.

Spiegazione9 min lettoLivello intermedioRevisionato il 19 ago 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

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à).

Casi d'uso consigliati

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#

nosql-insert.tstypescript
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 tuo apikey) o @aurabase/aurabase-js SDK.

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):

explain-plan.jsonjson
{
  "queryPlanner": {
    "winningPlan": {
      "stage": "IXSCAN",
      "indexName": "metadata.country_1_timestamp_-1",
      "keysExamined": 42,
      "docsExamined": 42
    },
    "executionTimeMillis": 1.2
  }
}

PostgreSQL vs NoSQL: quale motore scegliere?#

CriterioPostgreSQL (relazionale)Archivio documenti (NoSQL)
StrutturaSchema rigoroso, migrazioni con versioneSchema dinamico senza vincoli rigidi
Relazioni e joinJoin SQL e chiavi esterneDocumenti annidati o denormalizzati
Controllo degli accessiSicurezza dichiarativa a livello di riga (RLS) in SQLAutorizzazioni per raccolta e token del ruolo
Ricerca vettorialeNativo pgvector con HNSWFiltraggio per attributi e indici di testo
Meglio perCore banking, SaaS B2B, gestione dei dirittiLog, cataloghi dinamici, IoT, eventi

Per andare oltre#