- Reference >
- MongoDB Package Components >
bsondump
bsondump
¶
macOS Sierra and Go 1.6 Incompatibility
Users running on macOS Sierra require the 3.2.10 or newer version
of 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
.
Run bsondump
from the system command line, not the mongo
shell.
Important
bsondump
is a diagnostic tool for inspecting
BSON files, not a tool for data ingestion or other application use.
Options¶
Changed in version 3.0.0: bsondump
removed the --filter
, --dbpath
and the
--noobjcheck
options.
-
bsondump
¶
-
--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
. For objects with a high degree of sub-document nesting,--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
¶
New in version 3.0.0.
Outputs documents in a pretty-printed format JSON.
-
--bsonFile
¶
New in version 3.4.
Specifies a 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
¶
New in version 3.4.
Specifies the path of the file to which bsondump should write its output JSON data.
By default, bsondump writes to standard output.