mongoexport_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > MongoDB软件包组件 > mongoexport

在本页面

概要
可用性
句法
所需的访问
行为
选件
例子

macOS Sierra和Go 1.6不兼容

在macOS Sierra上运行的用户需要3.2.10或更高版本 mongoexport。

MongoDB 4.4中即将进行的工具迁移

从MongoDB 4.4开始，mongoexport文档迁移到MongoDB数据库工具-mongoexport。有关即将发布的mongoexport（工具版本100.0.0）版本的更多信息，请参见该页面。

本页上的文档仅适用于MongoDB 4.2版本mongoexport。mongoexport可以按照以下“ 可用性”部分中的说明下载MongoDB 4.2版本。

概要¶

mongoexport 是一个命令行工具，可对存储在MongoDB实例中的数据进行JSON或CSV导出。

运行mongoexport系统命令行，而不是mongo外壳。

也可以看看

mongoimport 提供相应的“导入”功能。

可用性¶

该mongoexport工具是MongoDB工具包的一部分。请查阅所用平台的安装指南，以获取有关如何在MongoDB安装过程中安装工具包的说明。

该工具包也可以从 MongoDB下载中心获得，可以单独tools下载，也可以包含在 TGZ或ZIP下载中，具体取决于平台。在Windows上，MSI安装程序包括所有工具作为默认安装的一部分。

小费

如果从下载中心下载TGZ或ZIP文件，则可能需要更新PATH环境变量以包括安装这些工具的目录。有关更多信息，请参见所用平台的安装指南。

语法¶

mongoexport 必须直接从系统命令行运行。

复制

mongoexport --collection=<coll> [options]

您必须指定collection要导出的。如果未指定，则写入标准输出（例如stdout）。output filemongoexport

连接到MongoDB实例¶

要连接到端口27017上运行的本地MongoDB实例，无需指定主机或端口。

例如，要将collection指定的内容从运行在端口27017上的本地MongoDB实例导出到指定的内容，请执行以下操作：output file

复制

mongoexport --collection=events --db=reporting --out=events.json

要指定MongoDB实例的主机和/或端口，您可以：

在中指定主机名和端口：--uri connection string
复制
```
mongoexport --uri="mongodb://mongodb0.example.com:27017/reporting"  --collection=events  --out=events.json [additional options]
```
如果使用，则将数据库指定为字符串的一部分。您不能将命令行选项与一起使用。--uri connection string--db--uri connection string

在中指定主机名和端口--host：

复制

mongoexport --host="mongodb0.example.com:27017" --collection=events --db=reporting --out=events.json [additional options]

指定的主机名和端口--host和--port：

复制

mongoexport --host="mongodb0.example.com" --port=27017 --collection=events --db=reporting --out=events.json [additional options]

有关可用选项的更多信息，请参阅选项。

连接到副本集¶

要连接到副本集以导出其数据，您可以：

在中指定副本集名称和成员：--uri connection string
复制
```
mongoexport --uri="mongodb://mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/reporting?replicaSet=myReplicaSetName" --collection=events --out=events.json [additional options]
```
如果使用，则将数据库指定为字符串的一部分。您不能将命令行选项与一起使用。--uri connection string--db--uri connection string

在中指定副本集名称和成员--host：

复制

mongoexport --host="myReplicaSetName/mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com" --collection=events --db=reporting --out=events.json [additional options]

默认情况下，mongoexport从副本集的主数据库读取。要覆盖默认值，可以指定读取首选项：

您可以在 --uri connection string

复制

mongoexport --uri="mongodb://mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/reporting?replicaSet=myReplicaSetName&readPreference=secondary" --collection=events --out=events.json [additional options]

如果指定读取的首选项标签，请包括以下 readPreferenceTags选项：

复制

mongoexport --uri="mongodb://mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/reporting?replicaSet=myReplicaSetName&readPreference=secondary&readPreferenceTags=region:east" --collection=events --out=events.json [additional options]

如果使用，则将数据库指定为字符串的一部分。您不能将命令行选项与一起使用。--uri connection string--db--uri connection string

您可以使用--readPreference命令行选项指定读取首选项。如果仅指定读取首选项模式，则命令行选项采用字符串：

复制

mongoexport --host="myReplicaSetName/mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017" --readPreference=secondary --collection=events --db=reporting --out=events.json [additional options]

或者，命令行选项可以使用带引号的文档来指定模式，可选的读取首选项标签集和可选的 maxStalenessSeconds：'{ mode: <mode>, tagSets: [ <tag1>, ... ], maxStalenessSeconds:<num>}'

复制

mongoexport --host="myReplicaSetName/mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017" --readPreference='{mode: "secondary", tagSets: [ { "region": "east" } ]}' --collection=events --db=reporting --out=events.json [additional options]

有关可用选项的更多信息，请参阅选项。

连接到分片群集¶

要连接到分片群集以导出其数据，您可以：

在中指定mongos实例的主机名--uri connection string
复制
```
mongoexport --uri="mongodb://mongos0.example.com:27017/reporting" --collection=events --out=events.json [additional options]
```
如果使用，则将数据库指定为字符串的一部分。您不能将命令行选项与一起使用。--uri connection string--db--uri connection string

在中指定mongos实例的主机名和端口--host

复制

mongoexport --host="mongos0.example.com:27017" --collection=events --db=reporting --out=events.json[additional options]

默认情况下，mongoexport从分片副本集的主数据库读取。要覆盖默认值，可以指定读取首选项：

您可以在 --uri connection string

复制

mongoexport --uri="mongodb://mongos0.example.com:27017/reporting?readPreference=secondary" --collection=events --out=events.json [additional options]

如果指定读取的首选项标签，请包括以下 readPreferenceTags选项：

复制

mongoexport --uri="mongodb://mongos0.example.com:27017/reporting?readPreference=secondary&readPreferenceTags=region:east" --collection=events --out=events.json [additional options]

如果使用，则将数据库指定为字符串的一部分。您不能将命令行选项与一起使用。--uri connection string--db--uri connection string

您可以使用--readPreference命令行选项指定读取首选项。如果仅指定读取首选项模式，则命令行选项采用字符串：
复制
```
mongoexport --host="mongos0.example.com:27017" --readPreference=secondary --collection=events --db=reporting --out=events.json [additional options]
```
或者，命令行选项可以使用带引号的文档来指定模式，可选的读取首选项标签集和可选的 maxStalenessSeconds：'{ mode: <mode>, tagSets: [ <tag1>, ... ], maxStalenessSeconds:<num>}'
复制
```
mongoexport --host="mongos0.example.com:27017" --readPreference='{mode: "secondary", tagSets: [ { "region": "east" } ]}' --collection=events --db=reporting --out=events.json [additional options]
```

有关可用选项的更多信息，请参阅选项。

也可以看看

例子

所需的访问权限¶

mongoexport 需要对目标数据库的读取访问权限。

确保连接用户至少具有read 目标数据库上的角色。

当连接到mongod或mongos强制执行身份验证时，请确保根据配置的身份验证机制使用必需的安全性参数。

行为¶

类型保真¶

警告

避免使用mongoimport和mongoexport完全实例制作备份。它们不能可靠地保留所有丰富的 BSON数据类型，因为JSON只能表示BSON支持的类型的子集。如MongoDB备份方法中所述使用mongodump 和mongorestore来实现这种功能。

从4.2版开始，mongoexport：

默认情况下以扩展JSON v2.0（轻松模式）输出数据。
如果与一起使用，则输出扩展的JSON v2.0（规范模式）--jsonFormat。

早期版本使用Extended JSON v1.0（规范模式）。

例如，以下在mongo shell中的插入操作对BSON类型Date和64位整数使用各种shell帮助器：

复制

use test
db.traffic.insert( { _id: 1, volume: NumberLong('2980000'), date: new Date() } )

必须引用64位整数的参数，以避免潜在的准确性损失。

使用mongoexport导出数据：

复制

mongoexport --db=test --collection=traffic --out=traffic.json

在4.2+版本中，导出的数据为Extended JSON v2.0（轻松模式）。

复制

{"_id":1.0,"volume":2980000,"date":{"$date":"2019-08-05T16:18:29.559Z"}}

要以扩展JSON v2.0（规范模式）输出，请包括 --jsonFormat=canonical：

复制

mongoexport --db=test --collection=traffic --jsonFormat=canonical --out=traffic.json

导出的数据为Extended JSON v2.0（规范模式）：

复制

{"_id":{"$numberDouble":"1.0"},"volume":{"$numberLong":"2980000"},"date":{"$date":{"$numberLong":"1565363188675"}}}

在版本4.0和更早版本中，导出的数据为Extended JSON v1.0（严格模式）

复制

{"_id":1.0,"volume":{"$numberLong":"2980000"},"date":{"$date":"2019-08-05T16:18:29.559Z"}}

FIPS ¶

从4.2版开始，MongoDB删除的--sslFIPSMode 选项mongoexport。如果 / 实例配置为使用FIPS模式，mongoexport 它将使用与FIPS兼容的连接 mongod/ 。mongosmongodmongos

读取首选项¶

默认情况下，mongoexport使用read preference primary。要覆盖默认值，您可以在命令行选项或中指定读取首 --readPreference选项。--uri connection string

从4.2版开始，如果您在URI字符串中指定了读取首选项--readPreference，而该--readPreference值将覆盖URI字符串中指定的读取首选项。

在早期版本中，这两个选项不兼容。

选项¶

mongoexport¶

--help¶: 返回有关mongoexport的选项和用法的信息。

--verbose, -v¶: 增加标准输出或日志文件中返回的内部报告的数量。-v通过多次包含选项来增加详细程度（例如）-vvvvv。

--quiet¶

在安静模式下运行mongoexport，该模式试图限制输出量。

此选项禁止显示：

数据库命令的输出
复制活动
连接接受的事件
连接关闭事件

--version¶: 返回mongoexport发行版本号。

--uri=<connectionString>¶

3.4.6版中的新功能。

指定可解析的URI 连接字符串（用引号引起来）以连接到MongoDB部署。

复制

--uri="mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]"

有关连接字符串的组成部分的信息，请参阅“ 连接字符串URI格式”文档。

注意

对于TLS / SSL选项，请使用命令行选项代替TLS / SSL的 URI选项（从4.2开始可用）。

重要

以下命令行选项不能与--urioption 一起使用：

--host
--port
--db
--username
--password （如果 URI连接字符串还包含密码）
--authenticationDatabase
--authenticationMechanism

而是将这些选项指定为--uri 连接字符串的一部分。

--host=<hostname><:port>, -h=<hostname><:port>¶

默认值：本地主机：27017

指定mongod要连接的主机名称。默认情况下，mongoexport尝试连接到端口号为localhost上运行的MongoDB实例27017。

要连接到副本集，请指定replSetName集合成员的和种子列表，如下所示：

复制

--host=<replSetName>/<hostname1><:port>,<hostname2><:port>,<...>

指定副本集列表格式时，mongoexport始终连接到primary。

您还可以通过仅指定该成员的主机和端口来连接到副本集的任何单个成员：

复制

--host=<hostname1><:port>

如果使用IPv6并使用<address>:<port>格式，则必须将地址和端口组合的一部分括在方括号（例如[<address>]）中。

注意

您不能同时指定--host和--uri。

--port=<port>¶

默认值：27017

指定MongoDB实例在其上侦听客户端连接的TCP端口。

注意

您不能同时指定--port和--uri。

--ipv6¶

在3.0版中删除。

启用IPv6支持，并允许mongoexport使用IPv6网络连接到MongoDB实例。在MongoDB 3.0之前，您必须指定--ipv6使用IPv6。在MongoDB 3.0和更高版本中，始终启用IPv6。

--ssl¶

启用与mongod或mongos已启用TLS / SSL支持的连接。

有关TLS / SSL和MongoDB的更多信息，请参阅为客户端的 TLS / SSL和 TLS / SSL配置配置mongod和mongos。

--sslCAFile=<filename>¶

指定.pem包含来自证书颁发机构的根证书链的文件。.pem使用相对或绝对路径指定文件的文件名。

从3.4版开始，如果未指定--tlsCAFile/ net.tls.CAFile（或它们的别名--sslCAFile/ net.ssl.CAFile），并且您没有使用x.509身份验证，则在连接到启用TLS / SSL的服务器时将使用系统范围的CA证书存储。

要使用x.509身份验证，--tlsCAFile或者net.tls.CAFile 必须指定，除非使用--tlsCertificateSelector或 --net.tls.certificateSelector。或者，如果使用ssl别名， --sslCAFile或net.ssl.CAFile必须指定，除非使用 --sslCertificateSelector或net.ssl.certificateSelector。

警告

版本3.2及更早版本：对于TLS / SSL连接（--ssl），以 mongod和mongos，如果mongoexport没有运行 --sslCAFile，mongoexport不会尝试验证服务器证书。这会造成过期mongod和mongos证书以及伪装成有效mongod或 mongos实例的外部进程的漏洞。如果可能发生入侵，请确保始终指定CA文件来验证服务器证书。

有关TLS / SSL和MongoDB的更多信息，请参阅为客户端的 TLS / SSL和 TLS / SSL配置配置mongod和mongos。

--sslPEMKeyFile=<filename>¶

指定.pem同时包含TLS / SSL证书和密钥的文件。.pem使用相对或绝对路径指定文件的文件名。

使用--ssl选项连接到mongod或mongos已 CAFile启用而未启用时，此选项是必需的allowConnectionsWithoutCertificates。

有关TLS / SSL和MongoDB的更多信息，请参阅为客户端的 TLS / SSL和 TLS / SSL配置配置mongod和mongos。

--sslPEMKeyPassword=<value>¶

指定用于解密证书密钥文件的密码（即 --sslPEMKeyFile）。--sslPEMKeyPassword仅当证书密钥文件已加密时才使用该选项。在所有情况下，mongoexport都会从所有日志记录和报告输出中删除密码。

如果PEM文件中的私钥已加密并且您未指定该--sslPEMKeyPassword选项，则mongoexport将提示您输入密码。请参阅 TLS / SSL证书密码。

有关TLS / SSL和MongoDB的更多信息，请参阅为客户端的 TLS / SSL和 TLS / SSL配置配置mongod和mongos。

--sslCRLFile=<filename>¶

指定.pem包含证书吊销列表的文件。.pem使用相对或绝对路径指定文件的文件名。

有关TLS / SSL和MongoDB的更多信息，请参阅为客户端的 TLS / SSL和 TLS / SSL配置配置mongod和mongos。

--sslAllowInvalidCertificates¶

绕过服务器证书的验证检查，并允许使用无效的证书。使用该 allowInvalidCertificates设置时，MongoDB将使用无效证书记录为警告。

从MongoDB 4.0开始，如果在使用x.509身份验证时指定 --sslAllowInvalidCertificates或（或在MongoDB 4.2中为别名或），则无效的证书仅足以建立TLS / SSL连接，但不足以进行身份验证。net.ssl.allowInvalidCertificates: true--tlsAllowInvalidateCertificatesnet.tls.allowInvalidCertificates: true

警告

尽管可用，但请避免使用该 --sslAllowInvalidCertificates选项。如果必须使用 --sslAllowInvalidCertificates，请仅在不可能进行入侵的系统上使用该选项。

如果