diff options
Diffstat (limited to 'debian/mongoexport.1')
-rw-r--r-- | debian/mongoexport.1 | 386 |
1 files changed, 331 insertions, 55 deletions
diff --git a/debian/mongoexport.1 b/debian/mongoexport.1 index d702671102b..d82825f2a7c 100644 --- a/debian/mongoexport.1 +++ b/debian/mongoexport.1 @@ -1,75 +1,351 @@ -.TH MONGOEXPORT "1" "June 2009" "10gen" "Mongo Database" -.SH "NAME" -mongoexport \- the Mongo export tool -.SH "SYNOPSIS" -\fBmongoexport [\fIOPTIONS\fR]\fR -.SH "DESCRIPTION" -.PP -\fBmongoexport\fR -is a tool to export a MongoDB collection to either JSON or CSV. The query can be filtered or a list of fields to output can be given. -.PP -If the output is CSV, the fields must be specified in order. -.SH "EXAMPLES" -.TP -.B mongoexport -d test -c test1 --csv -f "name,num" -export documents from test.test1 in CSV format -.SH "OPTIONS" +.TH "MONGOEXPORT" "1" "March 14, 2013" "2.2.3" "mongodb-manual" +.SH NAME +mongoexport \- MongoDB +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.\" Man page generated from reStructuredText. +. +.SH SYNOPSIS +.sp +\fI\%mongoexport\fP is a utility that produces a JSON or CSV export +of data stored in a MongoDB instance. See the +"\fB/administration/import\-export\fP" document for a more in depth +usage overview, and the "\fBmongoimport\fP" document for more +information regarding the \fBmongoimport\fP utility, which +provides the inverse "importing" capability. +.IP Note +Do not use \fBmongoimport\fP and \fI\%mongoexport\fP for +full\-scale backups because they may not reliably capture data type +information. Use \fBmongodump\fP and \fBmongorestore\fP as +described in "\fB/administration/backups\fP" for this kind of +functionality. +.RE +.SH OPTIONS +.INDENT 0.0 +.TP +.B mongoexport +.UNINDENT +.INDENT 0.0 .TP .B \-\-help -show usage information +Returns a basic help and usage text. +.UNINDENT +.INDENT 0.0 .TP -.B \-\-version -show version information +.B \-\-verbose, \-v +Increases the amount of internal reporting returned on the command +line. Increase the verbosity with the \fB\-v\fP form by including +the option multiple times, (e.g. \fB\-vvvvv\fP.) +.UNINDENT +.INDENT 0.0 .TP -.B \-v, \-\-verbose -be more verbose (include multiple times for more verbosity -e.g. \-vvvvv) +.B \-\-version +Returns the version of the \fI\%mongoexport\fP utility. +.UNINDENT +.INDENT 0.0 .TP -.B \-h, \-\-host HOST -server to connect to (default HOST=localhost) +.B \-\-host <hostname><:port> +Specifies a resolvable hostname for the \fBmongod\fP from which you +want to export data. By default \fI\%mongoexport\fP attempts to +connect to a MongoDB process ruining on the localhost port number +\fB27017\fP. +.sp +Optionally, specify a port number to connect a MongoDB instance +running on a port other than \fB27017\fP. +.sp +To connect to a replica set, you can specify the replica set seed +name, and a seed list of set members, in the following format: +.sp +.nf +.ft C +<replica_set_name>/<hostname1><:port>,<hostname2:<port>,... +.ft P +.fi +.UNINDENT +.INDENT 0.0 .TP -.B\-\-port arg -server port. Can also use \-\-host hostname:port +.B \-\-port <port> +Specifies the port number, if the MongoDB instance is not running on +the standard port. (i.e. \fB27017\fP) You may also specify a port +number using the \fI\%mongoexport --host\fP command. +.UNINDENT +.INDENT 0.0 .TP .B \-\-ipv6 -enable IPv6 support (disabled by default) +Enables IPv6 support that allows \fI\%mongoexport\fP to connect +to the MongoDB instance using an IPv6 network. All MongoDB programs +and processes, including \fI\%mongoexport\fP, disable IPv6 +support by default. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-ssl +New in version 2.4: MongoDB added support for SSL connections to \fBmongod\fP +instances in mongoexport. +.IP Note +SSL support in mongoexport is not compiled into the default +distribution of MongoDB. See \fB/administration/ssl\fP for more +information on SSL and MongoDB. +.sp +Additionally, mongoexport does not support connections to +\fBmongod\fP instances that require client certificate +validation. +.RE +.sp +Allows \fI\%mongoexport\fP to connect to \fBmongod\fP +instance over an SSL connection. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-username <username>, \-u <username> +Specifies a username to authenticate to the MongoDB instance, if your +database requires authentication. Use in conjunction with the +\fI\%mongoexport --password\fP option to supply a password. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-password <password>, \-p <password> +Specifies a password to authenticate to the MongoDB instance. Use +in conjunction with the \fI\%--username\fP +option to supply a username. +.sp +If you specify a \fI\%--username\fP +without the \fI\%--password\fP option, \fI\%mongoexport\fP +will prompt for a password interactively. +.UNINDENT +.INDENT 0.0 .TP -.B \-u|\-\-username USERNAME -specify user to log in as +.B \-\-authenticationDatabase <dbname> +New in version 2.4. +.sp +Specifies the database that holds the user\(aqs (e.g +\fI\%--username\fP) credentials. +.sp +By default, \fI\%mongoexport\fP assumes that the database specified to the +\fI\%--db\fP argument holds the user\(aqs credentials, unless you +specify \fI\%--authenticationDatabase\fP. +.sp +See \fBuserSource\fP, +\fB/reference/privilege\-documents\fP and +\fB/reference/user\-privileges\fP for more information about +delegated authentication in MongoDB. +.UNINDENT +.INDENT 0.0 .TP -.B \-p|\-\-password PASSWORD -specify password of user +.B \-\-authenticationMechanism <name> +New in version 2.4. +.sp +Specifies the authentication mechanism. By default, the +authentication mechanism is \fBMONGODB\-CR\fP, which is the MongoDB +challenge/response authentication mechanism. In the MongoDB Subscriber Edition, +\fI\%mongoexport\fP also includes support for \fBGSSAPI\fP to handle +Kerberos authentication. +.sp +See \fB/tutorial/control\-access\-to\-mongodb\-with\-kerberos\-authentication\fP +for more information about Kerberos authentication. +.UNINDENT +.INDENT 0.0 .TP -.B \-\-dbpath PATH -directly access mongod data files in this path, instead of connecting to a mongod instance +.B \-\-dbpath <path> +Specifies the directory of the MongoDB data files. If used, the +\fB\-\-dbpath\fP option enables \fI\%mongoexport\fP to attach +directly to local data files and insert the data without the +\fBmongod\fP. To run with \fB\-\-dbpath\fP, \fI\%mongoexport\fP +needs to lock access to the data directory: as a result, no +\fBmongod\fP can access the same path while the process runs. +.UNINDENT +.INDENT 0.0 .TP .B \-\-directoryperdb -if dbpath specified, each db is in a separate directory +Use the \fI\%--directoryperdb\fP in conjunction with the +corresponding option to \fBmongod\fP, which allows +\fI\%mongoexport\fP to export data into MongoDB instances that +have every database\(aqs files saved in discrete directories on the +disk. This option is only relevant when specifying the +\fI\%--dbpath\fP option. +.UNINDENT +.INDENT 0.0 .TP -.B \-d, \-\-db DATABASE -database to use +.B \-\-journal +Allows \fI\%mongoexport\fP operations to access the durability +\fIjournal\fP to ensure that the export is in a +consistent state. This option is only relevant when specifying the +\fI\%--dbpath\fP option. +.UNINDENT +.INDENT 0.0 .TP -.B \-c, \-\-c COLLECTION -collection to use +.B \-\-db <db>, \-d <db> +Use the \fI\%--db\fP option to specify the name of the database +that contains the collection you want to export. +.UNINDENT +.INDENT 0.0 .TP -.B \-f, \-\-fields FIELDS -comma\-separated list of field names +.B \-\-collection <collection>, \-c <collection> +Use the \fI\%--collection\fP option to specify the collection +that you want \fI\%mongoexport\fP to export. +.UNINDENT +.INDENT 0.0 .TP -.B \-\-fieldFile FILE -file with fields names \- 1 per line +.B \-\-fields <field1[,field2]>, \-f <field1[,field2]> +Specify a field or number fields to \fIinclude\fP in the export. All +other fields will be \fIexcluded\fP from the export. Comma separate a +list of fields to limit the fields exported. +.UNINDENT +.INDENT 0.0 .TP -.B \-\-query -JSON query filter +.B \-\-fieldFile <file> +As an alternative to "\fI\%--fields\fP" +the \fI\%--fieldFile\fP option allows you to specify a file +(e.g. \fB<file>\(ga\fP) to hold a list of field names to specify a list +of fields to \fIinclude\fP in the export. All other fields will be +\fIexcluded\fP from the export. Place one field per line. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-query <JSON> +Provides a \fIJSON document\fP as a query that optionally limits +the documents returned in the export. +.UNINDENT +.INDENT 0.0 .TP .B \-\-csv -export to CSV instead of JSON -.TP -.B \-o, \-\-out FILE -output file, if not specified, stdout is used -.SH "COPYRIGHT" -.PP -Copyright 2007\-2011 10gen -.SH "SEE ALSO" -For more information, please refer to the mongoexport page in the MongoDB manual, available at http://dochub.mongodb.org/core/mongoexportmanpage -.SH "AUTHOR" -Kristina Chodorow +Changes the export format to a comma separated values (CSV) +format. By default \fI\%mongoexport\fP writes data using one +\fIJSON\fP document for every MongoDB document. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-jsonArray +Modifies the output of \fI\%mongoexport\fP to write the +entire contents of the export as a single \fIJSON\fP array. By +default \fI\%mongoexport\fP writes data using one JSON document +for every MongoDB document. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-slaveOk, \-k +Allows \fI\%mongoexport\fP to read data from secondary or slave +nodes when using \fI\%mongoexport\fP with a replica set. This +option is only available if connected to a \fBmongod\fP or +\fBmongos\fP and is not available when used with the +"\fI\%mongoexport --dbpath\fP" option. +.sp +This is the default behavior. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-out <file>, \-o <file> +Specify a file to write the export to. If you do not specify a file +name, the \fI\%mongoexport\fP writes data to standard output +(e.g. \fBstdout\fP). +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-forceTableScan +New in version 2.2. +.sp +Forces \fI\%mongoexport\fP to scan the data store directly: +typically, \fI\%mongoexport\fP saves entries as they appear in the +index of the \fB_id\fP field. Use \fI\%--forceTableScan\fP to skip +the index and scan the data directly. Typically there are two cases +where this behavior is preferable to the default: +.INDENT 7.0 +.IP 1. 3 +If you have key sizes over 800 bytes that would not be present +in the \fB_id\fP index. +.IP 2. 3 +Your database uses a custom \fB_id\fP field. +.UNINDENT +.sp +When you run with \fI\%--forceTableScan\fP, \fI\%mongoexport\fP +does not use \fB$snapshot\fP. As a result, the export produced +by \fI\%mongoexport\fP can reflect the state of the database at +many different points in time. +.IP Warning +Use \fI\%--forceTableScan\fP with extreme caution +and consideration. +.RE +.UNINDENT +.SH USAGE +.sp +In the following example, \fI\%mongoexport\fP exports the +collection \fBcontacts\fP from the \fBusers\fP database from the +\fBmongod\fP instance running on the localhost port +number \fB27017\fP. This command writes the export data in \fICSV\fP +format into a file located at \fB/opt/backups/contacts.csv\fP. +.sp +.nf +.ft C +mongoexport \-\-db users \-\-collection contacts \-\-csv \-\-out /opt/backups/contacts.csv +.ft P +.fi +.sp +The next example creates an export of the collection \fBcontacts\fP +from the MongoDB instance running on the localhost port number \fB27017\fP, +with journaling explicitly enabled. This writes the export to the +\fBcontacts.json\fP file in \fIJSON\fP format. +.sp +.nf +.ft C +mongoexport \-\-db sales \-\-collection contacts \-\-out contacts.json \-\-journal +.ft P +.fi +.sp +The following example exports the collection \fBcontacts\fP from the +\fBsales\fP database located in the MongoDB data files located at +\fB/srv/mongodb/\fP. This operation writes the export to standard output +in \fIJSON\fP format. +.sp +.nf +.ft C +mongoexport \-\-db sales \-\-collection contacts \-\-dbpath /srv/mongodb/ +.ft P +.fi +.IP Warning +The above example will only succeed if there is no \fBmongod\fP +connected to the data files located in the \fB/srv/mongodb/\fP +directory. +.RE +.sp +The final example exports the collection \fBcontacts\fP from the +database \fBmarketing\fP . This data resides on the MongoDB instance +located on the host \fBmongodb1.example.net\fP running on port +\fB37017\fP, which requires the username \fBuser\fP and the password +\fBpass\fP. +.sp +.nf +.ft C +mongoexport \-\-host mongodb1.example.net \-\-port 37017 \-\-username user \-\-password pass \-\-collection contacts \-\-db marketing \-\-out mdb1\-examplenet.json +.ft P +.fi +.SH AUTHOR +MongoDB Documentation Project +.SH COPYRIGHT +2011-2013, 10gen, Inc. +.\" Generated by docutils manpage writer. +. |