mongoexport

版本控制¶

从MongoDB 4.4开始，mongoexport现已与MongoDB服务器分开发布，并使用其自己的版本控制（初始版本为）100。以前，mongoexport该版本与MongoDB Server一起发布，并使用了匹配的版本控制。

有关MongoDB 4.2或更早版本的 文档mongoexport，请参阅该工具版本的MongoDB服务器文档：

本文档的版本100的mongoexport。

MongoDB服务器兼容性¶

mongoexport版本100支持以下版本的MongoDB Server：

• MongoDB 4.4
• MongoDB 4.2
• MongoDB 4.0
• MongoDB 3.6

虽然mongoexport在早期版本的MongoDB服务器上可以使用，但不能保证任何此类兼容性。

平台支持¶

mongoexport100以下平台支持该版本：

连接到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

• 在中指定主机名和端口--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

• 在中指定副本集名称和成员--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

• 您可以使用--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

• 在中指定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

• 您可以使用--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：

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

例如，以下在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

导出的数据为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"}}}

FIPS ¶

mongoexport自动创建符合FIPS的连接到一个mongod/ mongos被 配置为使用FIPS模式。

读取首选项¶

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

如果您在URI字符串和中指定读取首选项，则 --readPreference该 --readPreference值将覆盖URI字符串中指定的读取首选项。