Docs Menu

Docs HomeLaunch & Manage MongoDBMongoDB Database Tools

bsondump

On this page

  • Synopsis
  • Options
  • Learn More

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.

bsondump uses Extended JSON v2.0 (Canonical mode) to format its data.

Run bsondump from the system command line, not the mongo shell.

--help

Returns information on the options and use of bsondump.

--verbose, -v

Increases the amount of internal reporting returned on standard output or in log files. Increase the verbosity with the -v form by including the option multiple times, (e.g. -vvvvv.)

--quiet

Runs bsondump in a quiet mode that attempts to limit the amount of output.

This option suppresses:

  • output from database commands

  • replication activity

  • connection accepted events

  • connection closed events

--version

Returns the bsondump release number.

--objcheck

Validates each BSON object before outputting it in JSON format. By default, bsondump enables --objcheck <bsondump --objcheck>. For objects with a high degree of sub-document nesting, --objcheck <bsondump --objcheck> can have a small impact on performance.

--type=<json|debug>

Changes the operation of bsondump from outputting JSON (the default) to a debugging format.

--pretty

Outputs documents in a pretty-printed format JSON.

--bsonFile

Specifies the path to a BSON file to dump to JSON. --bsonFile is an alternative to the positional \<bsonFilename\> option.

By default, bsondump reads from standard input.

<bsonFilename>

The final argument to bsondump is a document containing BSON. This data is typically generated by bsondump or by MongoDB in a rollback operation.

--outFile=<file>

Specifies the path of the file to which bsondump should write its output JSON data.

By default, bsondump writes to standard output.

←  mongorestorebsondump Compatibility and Installation →