README
¶
MongoDB Tools
- bsondump - display BSON files in a human-readable format
- mongoimport - Convert data from JSON, TSV or CSV and insert them into a collection
- mongoexport - Write an existing collection to CSV or JSON format
- mongodump/mongorestore - Dump MongoDB backups to disk in .BSON format, or restore them to a live database
- mongostat - Monitor live MongoDB servers, replica sets, or sharded clusters
- mongofiles - Read, write, delete, or update files in GridFS
- mongotop - Monitor read/write activity on a mongo server
Report any bugs, improvements, or new feature requests at https://jira.mongodb.org/browse/TOOLS
Building Tools
We currently build the tools with Go version 1.12, other Go versions may work but they are untested. go get will not
work; you need to clone the repository to build it. Be sure to clone the repository into your Go workspace inside your
$GOPATH.
You can find additional information on GOPATHs here: https://github.com/golang/go/wiki/GOPATH https://github.com/golang/go/wiki/SettingGOPATH
mkdir -p $GOPATH/src/github.com/mongodb
cd $GOPATH/src/github.com/mongodb
git clone https://github.com/mongodb/mongo-tools
cd mongo-tools
To use build/test scripts in the repo, you MUST set GOROOT to your Go root directory.
export GOROOT=/usr/local/go
Quick build
The build.sh script builds all the tools, placing them in the bin
directory. Pass any build tags (like ssl or sasl) as additional command
line arguments.
./build.sh
./build.sh ssl
./build.sh ssl sasl
Manual build
Source set_goenv.sh and run the set_goenv function to setup your GOPATH and
architecture-specific configuration flags:
. ./set_goenv.sh
set_goenv
Pass tags to the go build command as needed in order to build the tools with
support for SSL and/or SASL. For example:
mkdir bin
go build -o bin/mongoimport mongoimport/main/mongoimport.go
go build -o bin/mongoimport -tags ssl mongoimport/main/mongoimport.go
go build -o bin/mongoimport -tags "ssl sasl" mongoimport/main/mongoimport.go
Contributing
See our Contributor's Guide.
Documentation
See the MongoDB packages documentation.
For documentation on older versions of the MongoDB, reference that version of the MongoDB Server Manual:
Adding New Platforms Support
See our Adding New Platform Support Guide.
Vendoring the Change into Server Repo
See our Vendor the Change into Server Repo.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package bsondump converts BSON files into human-readable formats such as JSON.
|
Package bsondump converts BSON files into human-readable formats such as JSON. |
|
main
Main package for the bsondump tool.
|
Main package for the bsondump tool. |
|
Package mongodump creates BSON data from the contents of a MongoDB instance.
|
Package mongodump creates BSON data from the contents of a MongoDB instance. |
|
main
Main package for the mongodump tool.
|
Main package for the mongodump tool. |
|
Package mongoexport produces a JSON or CSV export of data stored in a MongoDB instance.
|
Package mongoexport produces a JSON or CSV export of data stored in a MongoDB instance. |
|
main
Main package for the mongoexport tool.
|
Main package for the mongoexport tool. |
|
Package mongofiles provides an interface to GridFS collections in a MongoDB instance.
|
Package mongofiles provides an interface to GridFS collections in a MongoDB instance. |
|
main
Main package for the mongofiles tool.
|
Main package for the mongofiles tool. |
|
Package mongoimport allows importing content from a JSON, CSV, or TSV into a MongoDB instance.
|
Package mongoimport allows importing content from a JSON, CSV, or TSV into a MongoDB instance. |
|
csv
Package csv reads and writes comma-separated values (CSV) files.
|
Package csv reads and writes comma-separated values (CSV) files. |
|
main
Main package for the mongoimport tool.
|
Main package for the mongoimport tool. |
|
Package mongorestore writes BSON data to a MongoDB instance.
|
Package mongorestore writes BSON data to a MongoDB instance. |
|
main
Main package for the mongorestore tool.
|
Main package for the mongorestore tool. |
|
Package mongostat provides an overview of the status of a currently running mongod or mongos instance.
|
Package mongostat provides an overview of the status of a currently running mongod or mongos instance. |
|
main
Main package for the mongostat tool.
|
Main package for the mongostat tool. |
|
Package mongotop provides a method to track the amount of time a MongoDB instance spends reading and writing data.
|
Package mongotop provides a method to track the amount of time a MongoDB instance spends reading and writing data. |
|
main
Main package for the mongotop tool.
|
Main package for the mongotop tool. |