MongoDB Compass: in­stal­la­zio­ne e primi passi

MongoDB Compass facilita il lavoro con MongoDB grazie alla sua in­ter­fac­cia grafica. Ti mostriamo come in­stal­la­re e uti­liz­za­re questo strumento.

MongoDB Compass: gestire i database in modo più semplice

MongoDB è una delle soluzioni NoSQL più popolari e di successo. L’obiettivo prin­ci­pa­le di questo sistema di gestione dei database è la me­mo­riz­za­zio­ne e la gestione di ampi registri di dati, che possono essere elaborati in vari formati e rag­grup­pa­ti in raccolte come documenti BSON. Sebbene la soluzione cerchi di essere il più semplice possibile, il lavoro con le righe di comando richiede un po’ di co­no­scen­ze pre­li­mi­na­ri e molta pre­ci­sio­ne.

MongoDB Compass fornisce una chiara in­ter­fac­cia grafica con cui è possibile vi­sua­liz­za­re, mo­di­fi­ca­re e ana­liz­za­re i dati. Qui ti spie­ghia­mo come in­stal­la­re MongoDB Compass sul tuo sistema e quali sono le funzioni offerte dallo strumento nell’uso quo­ti­dia­no.

Quali funzioni offre MongoDB Compass?

MongoDB Compass può fare tutto ciò che può fare la shell. Tuttavia, grazie all’in­ter­fac­cia user-friendly, molte ope­ra­zio­ni risultano de­ci­sa­men­te più rapide e semplici. L’accesso si estende ai singoli documenti, alle raccolte e persino alla creazione di un database completo. Le ope­ra­zio­ni che si possono eseguire con MongoDB Compass includono:

• Creare nuovi database, raccolte e documenti
• Vi­sua­liz­za­re dati me­mo­riz­za­ti nel database
• Ag­giun­ge­re, mo­di­fi­ca­re ed eliminare un documento
• Ef­fet­tua­re un’analisi ap­pro­fon­di­ta e completa del sistema e dei database creati
• Mo­ni­to­rag­gio continuo delle pre­sta­zio­ni del sistema
• Mo­ni­to­rag­gio e per­so­na­liz­za­zio­ne dei dati secondo i principi del formato JSON

MongoDB Compass è gratuito.

MongoDB Compass: requisiti per l’in­stal­la­zio­ne e versioni di­spo­ni­bi­li

Prima di poter in­stal­la­re MongoDB Compass, è ne­ces­sa­rio scegliere la versione dello strumento:

• MongoDB Compass è la versione completa.
• MongoDB Compass Read-Only non offre alcuna opzione per la modifica o l’eli­mi­na­zio­ne dei documenti.
• MongoDB Compass Isolated funziona in­di­pen­den­te­men­te dalla rete.

Tutte e tre le versioni sono di­spo­ni­bi­li per il download sul sito web di MongoDB.

MongoDB Compass è com­pa­ti­bi­le con i sistemi operativi più comuni. È possibile ottenere l’in­ter­fac­cia utente grafica (GUI) per OS X, Ubuntu e Windows.

Per poter uti­liz­za­re lo strumento, il database orientato ai documenti deve essere già in­stal­la­to sul tuo sistema. Se hai bisogno di aiuto al riguardo, nel nostro tutorial su MongoDB trovi tutte le in­for­ma­zio­ni ne­ces­sa­rie. Devi inoltre disporre dei permessi di am­mi­ni­stra­to­re. Sebbene le singole fasi di in­stal­la­zio­ne possano variare leg­ger­men­te a seconda del sistema, i processi effettivi con MongoDB Compass sono identici su tutte le macchine.

Come in­stal­la­re MongoDB Compass

Con OS X o Windows, è suf­fi­cien­te col­le­gar­si al sito web sopra indicato, se­le­zio­na­re la versione de­si­de­ra­ta, sca­ri­car­la e seguire le istru­zio­ni della procedura guidata di in­stal­la­zio­ne. Se invece desideri in­stal­la­re MongoDB Compass in Ubuntu, ad esempio, devi disporre dei permessi sudo. Se ne sei in possesso, puoi procedere come segue:

1. Vai al sito web di MongoDB Compass e copia il link per il download della ri­spet­ti­va versione.
2. Utilizza il comando wget. Nella versione 1.39.4 si presenta così:

wget https://downloads.mongodb.com/compass/mongodb-compass_1.39.4_amd64.deb

3. Utilizza il comando apt per in­stal­la­re MongoDB Compass:

sudo apt install ./mongodb-compass_1.39.4_amd64.deb

4. Una volta com­ple­ta­ta l’in­stal­la­zio­ne, apri MongoDB Compass:

$ mongodb-compass

A questo punto viene vi­sua­liz­za­ta una schermata iniziale. Nelle prossime sezioni ti spie­ghe­re­mo come procedere e quali opzioni hai a di­spo­si­zio­ne.

Stabilire una con­nes­sio­ne al server

Per poter uti­liz­za­re MongoDB Compass, è ne­ces­sa­rio in­nan­zi­tut­to stabilire una con­nes­sio­ne al server. Il modo più semplice per farlo è eseguire i seguenti passaggi:

1. Per prima cosa, fai clic su “New Con­nec­tion” (Nuova con­nes­sio­ne) nell’angolo in alto a sinistra per stabilire una con­nes­sio­ne.
2. A questo punto troverai in alto l’opzione “Fill in con­nec­tion fields in­di­vi­dual­ly” (Compila i campi di con­nes­sio­ne in­di­vi­dual­men­te). Se­le­zio­na­la facendoci clic sopra.
3. Ora inserisci l’IP del tuo server remoto nel campo “Hostname” (nome host).
4. Se la porta non è stata mo­di­fi­ca­ta ma­nual­men­te in pre­ce­den­za, puoi uti­liz­za­re il valore pre­de­fi­ni­to, ovvero: “27017”.
5. Se desideri uti­liz­za­re ulteriori misure di sicurezza, vai a “Username / Password” alla voce “Au­then­ti­ca­tion” (Au­ten­ti­ca­zio­ne) e inserisci i dati di login che utilizzi nor­mal­men­te per MongoDB.
6. Dopo aver com­ple­ta­to i passaggi necessari, MongoDB Compass si con­net­te­rà al tuo server. Sulla destra verrà vi­sua­liz­za­to un riepilogo dei database.

Creare un database con MongoDB Compass

Nel caso in cui tu non abbia ancora creato un database o se desideri crearne uno ag­giun­ti­vo, MongoDB Compass ti permette di farlo molto fa­cil­men­te. Ti basta seguire i seguenti passaggi:

1. Per prima cosa fai clic sul pulsante “CREATE DATABASE” (Crea database) in alto. Si aprirà una finestra pop-up.
2. Ora dai un nome al tuo nuovo database.
3. Assegna un titolo alla tua raccolta.
4. Una volta che tutte le voci sono sod­di­sfat­te, fai clic su “CREATE DATABASE” (Crea database) in basso a destra.

Ag­giun­ge­re o creare documenti

MongoDB Compass consente anche di salvare i dati in documenti BSON. È inoltre possibile creare e inserire nuovi documenti nella GUI. Basta seguire i seguenti passaggi:

1. Fai clic sul database ap­pro­pria­to sul lato sinistro.
2. Seleziona la raccolta corretta. Si aprirà una nuova finestra.
3. In “Add Data” (Aggiungi dati) hai la pos­si­bi­li­tà di importare un documento esistente (“Import File”) o di creare un nuovo documento (“Insert Document”).
   • Se desideri ag­giun­ge­re un documento esistente, fai clic su “Import File” (Importa file), seleziona il file e specifica il formato. Quindi fai clic su “IMPORT” (Importa).
   • Alla voce “Insert Document” (Inserisci documento) si apre una nuova finestra, in cui è possibile ag­giun­ge­re valori in formato JSON o coppie chiave-valore. Una volta mo­di­fi­ca­to il documento, fai clic su “INSERT” (Inserisci).

MongoDB Compass: vi­sua­liz­za­re, mo­di­fi­ca­re o eliminare documenti

MongoDB Compass consente anche di vi­sua­liz­za­re, mo­di­fi­ca­re o eliminare i documenti. Ti spie­ghia­mo bre­ve­men­te come fare.

Vi­sua­liz­za­re i documenti

Per vi­sua­liz­za­re il contenuto di un documento specifico, MongoDB Compass offre tre diverse modalità:

• Elenco
• Pa­no­ra­mi­ca JSON
• Tabella

È suf­fi­cien­te se­le­zio­na­re la modalità ap­pro­pria­ta nella barra superiore. Si trova accanto all’opzione “VIEW” (Vista).

Mo­di­fi­ca­re i documenti

Per mo­di­fi­ca­re un documento, procedi come segue:

1. Apri il documento.
2. Fai clic sull’icona della matita nell’angolo in alto a destra.
3. Seleziona il campo che desideri mo­di­fi­ca­re.
4. Una volta terminate le modifiche, conferma con “UPDATE” (Aggiorn).

Eliminare i documenti

Eliminare un documento in MongoDB Compass è molto semplice:

1. Apri il documento.
2. As­si­cu­ra­ti che il documento non ti serva più.
3. Fai clic sull’icona del cestino nell’angolo in alto a destra e conferma la procedura.