Vai al contenuto principale
Un server MongoDB gestito con connessione TLS tramite certificato client e un utente che gestisce i propri database, collection e indici. Le informazioni comuni a tutti i motori (limiti, snapshot, Insights) si trovano nella panoramica dei database.

Connettersi

Copia l’URL di connessione dalla pagina del database nella dashboard. Ha questa forma, con l’utente default che si autentica sul database admin:
MongoDB richiede TLS e il certificato client. Scarica il .pem in Connessione → Certificato SSL/TLS e passalo sia come certificato client sia come CA: tls=true, tlsCertificateKeyFile e tlsCAFile.
Se aggiungi un nome di database all’URL (mongodb://...:PORT/mydb), i driver si autenticano su mydb e l’accesso fallisce con Authentication failed. In quel caso mantieni authSource=admin: mongodb://default:PASSWORD@HOST:PORT/mydb?authSource=admin.

Un server standalone

Ogni database è un singolo server standalone: niente replica set né oplog, e non può essere convertito in uno. Questo significa: Le scritture su un singolo documento sono atomiche: gli aggiornamenti con operatori come $inc, $push o $set, e findOneAndUpdate, coprono molti casi che altrimenti richiederebbero una transazione. Le librerie che aprono sessioni con transazioni (per esempio connection.transaction() di Mongoose) falliscono con il primo errore qui sopra.

Connessioni

Ogni database accetta fino a 256 connessioni simultanee. Ogni MongoClient mantiene il proprio pool (maxPoolSize) più 2 connessioni di monitoraggio, quindi crea un solo client per processo e riutilizzalo: un client per ogni richiesta esaurisce rapidamente le connessioni. La scheda Insights mostra chi tiene aperte le connessioni.

Il tuo utente e i permessi

L’utente default ha i ruoli readWriteAnyDatabase e dbAdminAnyDatabase. Puoi creare ed eliminare database, collection e indici, e leggere db.stats(), $collStats, explain() e il profiler (system.profile). Non può creare utenti o ruoli, eseguire db.serverStatus(), vedere le operazioni di altre connessioni (currentOp), né eseguire top, hostInfo, setParameter o shutdown. Gli strumenti di monitoraggio che dipendono da serverStatus non funzionano; usa invece db.stats(), $collStats e il profiler.

Memoria

MongoDB dimensiona la sua cache WiredTiger in base alla RAM del database: il valore maggiore tra il 50% di (RAM meno 1 GB) e 256 MB.
  • La dimensione viene letta all’avvio del server: riavvia il database dopo averne cambiato la RAM. Non può essere regolata.
  • La cache contiene solo le pagine di dati e di indici toccate dalle tue query.
  • Memoria fuori dalla cache: circa 1 MB per connessione, la creazione degli indici e le aggregazioni (uno stage oltre i 100 MB viene riversato su disco).
  • L’allocatore di memoria conserva la memoria liberata per riutilizzarla, quindi la RAM mostrata nella dashboard sale e poi resta alta. È normale, non un memory leak.

Query lente

Il profiler registra le operazioni che richiedono 100 ms o più nella collection system.profile di ogni database (limitata a 1 MB), e la scheda Insights le elenca:
Usa explain("executionStats") su una query lenta per vedere se usa un indice.

Storage

MongoDB conserva fino a 200 MB di propri dati diagnostici, che contano nei 10 GB del database. Quando lo storage è completamente pieno, MongoDB si arresta e non riparte da solo: avvialo dalla dashboard e libera subito spazio (elimina le collection o gli indici che non ti servono). Vedi disco pieno.

Snapshot

Uno snapshot di MongoDB contiene tutti i database, utenti inclusi, in forma compressa; il limite di dimensione si applica all’esportazione compressa. Senza oplog, uno snapshot creato mentre sono in corso scritture non corrisponde a un singolo istante. Vedi snapshot e ripristino.

Errori comuni

Contattaci

Se continui a riscontrare difficoltà tecniche, il nostro team di supporto specializzato è disponibile ad assisterti. Contattaci e saremo felici di aiutarti a risolvere qualsiasi problema: la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud 4,9/5 su 402 recensioni su Google e Trustpilot.