Gli strumenti di database MongoDB includono un'utilità chiamata mongoexport
che ti consente di esportare i dati MongoDB in un file CSV o JSON.
Una delle cose che puoi fare con questa utilità è esportare i risultati della query. Questo articolo mostra come utilizzare mongoexport
per esportare i risultati delle query MongoDB in un file CSV.
Sintassi
La sintassi per mongoexport
va così:
mongoexport --collection=<coll> <options> <connection-string>
Devi eseguire mongoexport
comandi dalla riga di comando del sistema (ad es. una nuova finestra del terminale o del prompt dei comandi).
Non eseguire mongoexport
comandi dal mongo
guscio.
Esempio
Il codice di esempio seguente esporta i risultati di una query in un file CSV:
mongoexport --db=PetHotel --collection=pets --type=csv --fields=_id,name,type,weight --query='{ "type": "Dog" }' --out=data/dogs.csv
Questo esporta una query che interroga una raccolta chiamata pets
nel PetHotel
Banca dati. La query viene esportata in un file chiamato dogs.csv
nei data/
cartella.
Se la cartella non esiste, viene creata. Lo stesso con il file. A proposito, questo presuppone che non ci siano problemi di autorizzazione con la scrittura di un file nella posizione specificata.
In questo esempio non ho specificato alcun host, porta, autenticazione, ecc, quindi esporta la raccolta dall'istanza MongoDB in esecuzione sul numero di porta localhost predefinito 27017
.
Di seguito è riportata una spiegazione dei parametri che abbiamo fornito qui.
Parametro | Descrizione |
---|---|
--db o -d | Specifica il database su cui eseguire mongoexport . In questo caso, il database si chiama PetHotel . Questo parametro può essere passato in alternativa usando -d (invece di --db ). |
--collection o -c | Specifica la raccolta che vogliamo esportare (o eseguire la query). In questo caso, la collezione si chiama pets . Questo parametro può in alternativa essere passato come -c (invece di --collection ). |
--type | Specifica il tipo di file esportato. In questo caso specifichiamo csv per esportarlo in un file CSV. |
--fields | Specifica i campi che vogliamo esportare. Abbiamo la possibilità di esportare tutti i campi o solo alcuni. Devi elencarli tutti qui, separati da una virgola. Quando si esporta in CSV, è necessario specificare i nomi dei campi. Puoi farlo tramite i --fields parametro o il --fieldFile parametro (ne parleremo più avanti). |
--query o -q | Specifica la query per cui desideriamo esportare i risultati. Questo deve essere racchiuso tra virgolette singole (in modo che non interagisca con la tua shell). Questo parametro può essere passato anche usando -q . |
--out | Specifica il nome del file esportato e la posizione in cui verrà posizionato. Se non specifichi un nome file, mongoexport scrive i dati nello standard output (stdout ). |
Controlla il file esportato
Verifichiamo che l'operazione di esportazione abbia funzionato come previsto.
Innanzitutto, eseguiamo la query sulla raccolta originale.
use PetHotel
db.pets.find({ "type": "Dog" })
Risultato:
{ "_id" : 1, "name" : "Wag", "type" : "Dog", "weight" : 20 } { "_id" : 2, "name" : "Bark", "type" : "Dog", "weight" : 10 } { "_id" : 6, "name" : "Fetch", "type" : "Dog", "weight" : 17 } { "_id" : 7, "name" : "Jake", "type" : "Dog", "weight" : 30 }
Quindi possiamo vedere che ci sono 4 cani, tutti con gli stessi campi che abbiamo specificato nella nostra operazione di esportazione.
Ora apriamo il file esportato dogs.csv
per vedere cosa c'è dentro:
_id,name,type,weight 1,Wag,Dog,20 2,Bark,Dog,10 6,Fetch,Dog,17 7,Jake,Dog,30
OK, quindi tutti i dati sono nel file esportato come previsto.
Esporta meno campi
Puoi specificare meno campi con i --fields
parametro se lo desideri.
Esempio:
mongoexport --db=PetHotel --collection=pets --type=csv --fields=name,weight --query='{ "type": "Dog" }' --out=data/dogs.csv
File risultante:
name,weight Wag,20 Bark,10 Fetch,17 Jake,30
Rimuovi le intestazioni delle colonne
Noterai che il file esportato negli esempi precedenti includeva le intestazioni di colonna.
Hai anche la possibilità di esportare il file senza intestazioni di colonna. Per fare ciò, usa il --noHeaderLine
parametro.
Esempio:
mongoexport --db=PetHotel --collection=pets --type=csv --fields=_id,name,type,weight --query='{ "type": "Dog" }' --noHeaderLine --out=data/dogs.csv
Ora, quando apro il file esportato, non ci sono intestazioni di colonna:
1,Wag,Dog,20 2,Bark,Dog,10 6,Fetch,Dog,17 7,Jake,Dog,30
Utilizzare un file per i nomi dei campi
Puoi sostituire il --field
parametro con il --fieldFile
parametro per specificare il nome di un file che contiene i nomi dei campi che si desidera esportare.
mongoexport --db=PetHotel --collection=pets --type=csv --fieldFile=data/dogs_fields.txt --query='{ "type": "Dog" }' --out=data/dogs.csv
Il file che contiene i campi deve avere i campi elencati, uno per riga.
Ecco cosa è il dogs_fields.txt
il file era simile a questo esempio:
name type weight
Ciò ha comportato che il contenuto del file esportato fosse simile a questo:
name,type,weight Wag,Dog,20 Bark,Dog,10 Fetch,Dog,17 Jake,Dog,30
Modifica dell'ordine delle colonne
È possibile modificare l'ordine dei campi da esportare. Non devono essere necessariamente nello stesso ordine del documento sottostante.
Ad esempio, questo codice:
mongoexport --db=PetHotel --collection=pets --type=csv --fields=type,name,weight,_id --query='{ "type": "Dog" }' --out=data/dogs.csv
Risulta nel seguente file CSV:
type,name,weight,_id Dog,Wag,20,1 Dog,Bark,10,2 Dog,Fetch,17,6 Dog,Jake,30,7
Controllo accessi/Autenticazione
Se non stai usando localhost, puoi usare il --host
parametro per specificare l'host e --port
per specificare la porta. Puoi anche usare il --username
parametro per specificare il nome utente e --password
a per la password. Se ometti il parametro password, ti verrà richiesto. C'è anche un --authenticationDatabase
parametro per specificare il database di autenticazione in cui è stato creato l'utente.
Esempio:
mongoexport --host=myhost.example.com --port=37017 --username=homer --authenticationDatabase=admin --db=PetHotel --collection=pets --type=csv --fields=_id,name,type,weight --query='{ "type": "Dog" }' --out=data/dogs.csv
Cerca mongoexport
mongoexport
fa parte del pacchetto MongoDB Database Tools. I MongoDB Database Tools sono una suite di utilità da riga di comando per lavorare con MongoDB.
Se non sei sicuro di avere MongoDB Database Tools/mongoexport
installato, prova a eseguire il seguente comando nel terminale o nel prompt dei comandi per verificare:
mongoexport --version
Se ce l'hai, dovresti vedere le informazioni sulla versione, ecc. Se non ce l'hai, puoi usare le istruzioni di installazione sul sito Web di MongoDB per installarlo sul tuo sistema.
Dove eseguire i comandi?
Non dimenticare che devi eseguire mongoexport
comandi dalla riga di comando del sistema (ad es. una nuova finestra del terminale o del prompt dei comandi).