NAME¶
bsondump - MongoDB BSON utility
SYNOPSIS¶
The
bsondump converts
BSON files into human-readable formats,
including
JSON. For example,
bsondump is useful for reading the
output files generated by
mongodump.
OPTIONS¶
- --help
- Returns a basic help and usage text.
- --verbose, -v
- Increases the amount of internal reporting returned on the command line.
Increase the verbosity with the -v form by including the option
multiple times, (e.g. -vvvvv.)
- --version
- Returns the version of the bsondump utility.
- --objcheck
- Validates each BSON object before outputting it in JSON
format. By default, bsondump enables --objcheck by default.
For objects with a high degree of sub-document nesting, --objcheck
can have a small impact on performance. You can set --noobjcheck to
disable object checking.
Changed in version 2.4: MongoDB enables --objcheck by default, to
prevent any client from inserting malformed or invalid BSON into a MongoDB
database.
- --noobjcheck
- New in version 2.4.
Disables the default document validation that bsondump performs on
all BSON documents.
- --filter '<JSON>'
- Limits the documents that bsondump exports to only those documents
that match the JSON document specified as '<JSON>'. Be
sure to include the document in single quotes to avoid interaction with
your system's shell environment.
- --type <=json|=debug>
- Changes the operation of bsondump from outputting
"JSON" (the default) to a debugging format.
- <bsonfilename>
- The final argument to bsondump is a document containing
BSON. This data is typically generated by mongodump or by
MongoDB in a rollback operation.
USAGE¶
By default,
bsondump outputs data to standard output. To create
corresponding
JSON files, you will need to use the shell redirect. See
the following command:
bsondump collection.bson > collection.json
Use the following command (at the system shell) to produce debugging output for
a
BSON file:
bsondump --type=debug collection.bson
AUTHOR¶
MongoDB Documentation Project
COPYRIGHT¶
2011-2013, 10gen, Inc.