• Reference >
• MongoDB Package Components >
• bsondump

bsondump

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.

Important

bsondump is a diagnostic tool for inspecting BSON files, not a tool for data ingestion or other application use.

Options

bsondump

--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. Use this option to filter corrupt objects from the output. This option has some performance impact.

--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:

copy

bsondump collection.bson > collection.json

Use the following command (at the system shell) to produce debugging output for a BSON file:

copy

bsondump --type=debug collection.bson

←   mongorestore mongooplog  →

© MongoDB, Inc 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.