De MongoDB Database Tools bevatten een hulpprogramma genaamd mongoexport
waarmee u MongoDB-gegevens naar een CSV- of JSON-bestand kunt exporteren.
Een van de dingen die u met dit hulpprogramma kunt doen, is het exporteren van queryresultaten. Dit artikel laat zien hoe u mongoexport
. gebruikt om MongoDB-queryresultaten naar een CSV-bestand te exporteren.
Syntaxis
De syntaxis voor mongoexport
gaat als volgt:
mongoexport --collection=<coll> <options> <connection-string>
U moet mongoexport
uitvoeren opdrachten vanaf de opdrachtregel van uw systeem (bijvoorbeeld een nieuw Terminal- of opdrachtpromptvenster).
Voer mongoexport
niet uit commando's van de mongo
schelp.
Voorbeeld
De volgende voorbeeldcode exporteert de resultaten van een zoekopdracht naar een CSV-bestand:
mongoexport --db=PetHotel --collection=pets --type=csv --fields=_id,name,type,weight --query='{ "type": "Dog" }' --out=data/dogs.csv
Dit exporteert een zoekopdracht die een verzameling opvraagt met de naam pets
in het PetHotel
databank. De zoekopdracht wordt geëxporteerd naar een bestand met de naam dogs.csv
in de data/
map.
Als de map niet bestaat, wordt deze gemaakt. Hetzelfde met het bestand. Dit veronderstelt trouwens dat er geen toestemmingsproblemen zijn bij het schrijven van een bestand naar de opgegeven locatie.
In dit voorbeeld heb ik geen host, poort, authenticatie, enz. gespecificeerd, dus het exporteert de verzameling van de MongoDB-instantie die wordt uitgevoerd op het standaard localhost-poortnummer 27017
.
Hieronder vindt u een uitleg van de parameters die we hier hebben opgegeven.
Parameter | Beschrijving |
---|---|
--db of -d | Specificeert de database waarop mongoexport moet worden uitgevoerd . In dit geval heet de database PetHotel . Deze parameter kan ook worden doorgegeven met -d (in plaats van --db ). |
--collection of -c | Specificeert de verzameling die we willen exporteren (of de query uitvoeren). In dit geval heet de verzameling pets . Deze parameter kan ook worden doorgegeven als -c (in plaats van --collection ). |
--type | Specificeert het geëxporteerde bestandstype. In dit geval specificeren we csv om het naar een CSV-bestand te exporteren. |
--fields | Specificeert de velden die we willen exporteren. We hebben de mogelijkheid om alle velden of slechts enkele te exporteren. Je moet ze hier allemaal vermelden, gescheiden door een komma. Bij het exporteren naar CSV is het opgeven van de veldnamen een vereiste. U kunt dit doen via de --fields parameter of de --fieldFile parameter (daarover later meer). |
--query of -q | Specificeert de zoekopdracht waarvoor we de resultaten willen exporteren. Dit moet tussen enkele aanhalingstekens staan (zodat het geen interactie heeft met uw shell). Deze parameter kan ook worden doorgegeven met -q . |
--out | Specificeert de naam van het geëxporteerde bestand en waar het zich zal bevinden. Als u geen bestandsnaam opgeeft, mongoexport schrijft gegevens naar standaarduitvoer (stdout ). |
Controleer het geëxporteerde bestand
Laten we controleren of de exportbewerking werkte zoals verwacht.
Laten we eerst de query uitvoeren op de oorspronkelijke verzameling.
use PetHotel
db.pets.find({ "type": "Dog" })
Resultaat:
{ "_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 }
We kunnen dus zien dat er 4 honden zijn, allemaal met dezelfde velden die we hebben gespecificeerd in onze exportbewerking.
Laten we nu het geëxporteerde bestand dogs.csv
. openen om te zien wat erin zit:
_id,name,type,weight 1,Wag,Dog,20 2,Bark,Dog,10 6,Fetch,Dog,17 7,Jake,Dog,30
OK, dus alle gegevens staan zoals verwacht in het geëxporteerde bestand.
Minder velden exporteren
U kunt minder velden specificeren met de --fields
parameter als je wilt.
Voorbeeld:
mongoexport --db=PetHotel --collection=pets --type=csv --fields=name,weight --query='{ "type": "Dog" }' --out=data/dogs.csv
Resulterend bestand:
name,weight Wag,20 Bark,10 Fetch,17 Jake,30
Kolomkoppen verwijderen
U zult zien dat het geëxporteerde bestand in de vorige voorbeelden de kolomkoppen bevatte.
Je hebt ook de mogelijkheid om het bestand zonder . te exporteren kolomkoppen. Gebruik hiervoor de --noHeaderLine
parameter.
Voorbeeld:
mongoexport --db=PetHotel --collection=pets --type=csv --fields=_id,name,type,weight --query='{ "type": "Dog" }' --noHeaderLine --out=data/dogs.csv
Als ik nu het geëxporteerde bestand open, zijn er geen kolomkoppen:
1,Wag,Dog,20 2,Bark,Dog,10 6,Fetch,Dog,17 7,Jake,Dog,30
Gebruik een bestand voor de veldnamen
U kunt het --field
. vervangen parameter met de --fieldFile
parameter om de naam op te geven van een bestand dat de veldnamen bevat die u wilt exporteren.
mongoexport --db=PetHotel --collection=pets --type=csv --fieldFile=data/dogs_fields.txt --query='{ "type": "Dog" }' --out=data/dogs.csv
Het bestand dat de velden bevat, moet de velden bevatten, één per regel.
Dit is wat de dogs_fields.txt
bestand zag er voor dit voorbeeld uit:
name type weight
Hierdoor zag de inhoud van het geëxporteerde bestand er als volgt uit:
name,type,weight Wag,Dog,20 Bark,Dog,10 Fetch,Dog,17 Jake,Dog,30
De kolomvolgorde wijzigen
U kunt de volgorde van de te exporteren velden wijzigen. Ze hoeven niet in dezelfde volgorde te staan als het onderliggende document.
Bijvoorbeeld deze code:
mongoexport --db=PetHotel --collection=pets --type=csv --fields=type,name,weight,_id --query='{ "type": "Dog" }' --out=data/dogs.csv
Resultaten in het volgende CSV-bestand:
type,name,weight,_id Dog,Wag,20,1 Dog,Bark,10,2 Dog,Fetch,17,6 Dog,Jake,30,7
Toegangscontrole/authenticatie
Als u localhost niet gebruikt, kunt u de --host
. gebruiken parameter om de host op te geven, en --port
om de poort te specificeren. U kunt ook de --username
. gebruiken parameter om de gebruikersnaam en --password
. op te geven naar voor het wachtwoord. Als u de wachtwoordparameter weglaat, wordt u hierom gevraagd. Er is ook een --authenticationDatabase
parameter voor het specificeren van de authenticatiedatabase waarin de gebruiker is aangemaakt.
Voorbeeld:
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
Controleer op mongoexport
mongoexport
maakt deel uit van het MongoDB Database Tools-pakket. De MongoDB Database Tools zijn een reeks opdrachtregelhulpprogramma's voor het werken met MongoDB.
Als u niet zeker weet of u over de MongoDB Database Tools/mongoexport
beschikt geïnstalleerd, probeer dan het volgende commando in je Terminal of Command Prompt uit te voeren om te controleren:
mongoexport --version
Als je het hebt, zou je versie-informatie, enz. moeten zien. Als je het niet hebt, kun je de installatie-instructies op de MongoDB-website gebruiken om het op je systeem te installeren.
Waar moeten de opdrachten worden uitgevoerd?
Vergeet niet dat u mongoexport
. moet uitvoeren opdrachten vanaf de opdrachtregel van uw systeem (bijvoorbeeld een nieuw Terminal- of opdrachtpromptvenster).