mongo如何导出json

MongoDB 数据导出全攻略：轻松将数据导出为 JSON 格式**

MongoDB 作为目前最受欢迎的 NoSQL 数据库之一，其灵活的文档存储结构深受开发者喜爱，在实际开发和管理过程中，我们经常需要将 MongoDB 中的数据导出为 JSON 格式，例如用于数据备份、数据迁移、数据分析或与其他系统交换数据，本文将详细介绍几种常用的 MongoDB 数据导出 JSON 的方法，帮助您轻松完成这项任务。

使用 mongoexport 命令行工具 (推荐用于集合导出)

mongoexport 是 MongoDB 官方提供的命令行工具，专门用于从 MongoDB 集合中导出数据，它可以将数据导出为 JSON、CSV 或 TSV 格式，对于 JSON 导出，这是最常用且高效的方式。

基本语法

mongoexport --host <hostname> --port <port> --username <username> --password <password> --authenticationDatabase <authDB> --db <databaseName> --collection <collectionName> --out <outputFile.json> --jsonArray

参数说明

• --host / -h: MongoDB 服务主机名或 IP 地址，默认为 localhost。
• --port / -p: MongoDB 服务端口，默认为 27017。
• --username / -u: 用于认证的用户名。
• --password / -p: 用于认证的密码。
• --authenticationDatabase / -a: 认证数据库的名称，通常为 admin。
• --db / -d: 要导出数据的数据库名称。
• --collection / -c: 要导出数据的集合名称。
• --out / -o: 导出文件的路径，如果文件已存在，则会被覆盖。
• --jsonArray: (重要) 此参数指定导出的 JSON 格式是一个数组，即文件内容为 [ {doc1}, {doc2}, ... ]，如果不指定，默认情况下每个文档会单独一行输出，即 {doc1}\n{doc2}\n...，后者在某些 JSON 解析器中可能不被视为标准 JSON 数组。
• --query / -q: 可选，用于筛选导出数据的查询条件，类似于 find() 方法的查询文档。--query '{"status": "active", "age": {"$gt": 25}}'。
• --fields / -f: 可选，指定要导出的字段，多个字段用逗号分隔。--fields 'name,age,email'，不指定则导出所有字段。
• --pretty: 可选，以更美观的格式（缩进）输出 JSON，便于阅读，但文件体积会稍大。

示例

• 示例 1：导出指定数据库和集合的所有数据为 JSON 数组

假设我们有数据库 mydb，集合 users，无需认证：

  mongoexport --db mydb --collection users --out users_export.json --jsonArray

• 示例 2：导出带有查询条件和指定字段的数据

导出 mydb 数据库 products 集合中，类别为 "electronics" 且价格大于 100 的 name 和 price 字段：

  mongoexport --db mydb --collection products --query '{"category": "electronics", "price": {"$gt": 100}}' --fields 'name,price' --out electronics_products_over100.json --jsonArray

• 示例 3：连接需要认证的 MongoDB 实例

假设 MongoDB 启用了认证，用户名为 adminUser，密码为 adminPass，认证数据库为 admin：

  mongoexport --host mymongodb.example.com --port 27017 --username adminUser --password adminPass --authenticationDatabase admin --mydb --collection users --out users_export_auth.json --jsonArray

使用 mongosh (MongoDB Shell) 进行导出

除了 mongoexport，您还可以使用 MongoDB Shell (mongosh) 执行 JavaScript 代码来导出数据，这种方法更灵活，可以实现一些复杂的导出逻辑。

连接到 MongoDB

启动 mongosh 并连接到您的 MongoDB 实例：

mongosh "mongodb://username:password@hostname:port/authenticationDatabase"

或者,先连接再认证：

mongosh hostname:port
use admin
db.auth("username", "password")

执行导出命令

在 mongosh 中，可以使用 mongoexport 的命令行参数，但需要将其作为一个字符串传递给 runCommand，或者直接使用 mongoexport 的简化形式（mongosh 版本支持），更常见的是使用 find() 和 writeFile() 结合。

示例：使用 find() 和 writeFile()

// 1. 选择数据库和集合
use mydb;
const usersCollection = db.getCollection('users');
// 2. 查询数据（可选，这里查询所有数据）
const userData = usersCollection.find({}).toArray();
// 3. 将数据转换为 JSON 字符串并写入文件
// 注意：在 mongosh 中直接写文件路径可能受限，或者需要特定配置。
// 更常见的方式是输出到标准输出，然后重定向到文件。
// 将结果打印到标准输出，然后通过 shell 重定向：
// print(JSON.stringify(userData)) > users_export_mongosh.json
// 或者，如果环境允许，可以使用 Node.js 的 fs 模块（mongosh 运行在 Node.js 环境下）
// 但更通用的做法是：
printjson(JSON.stringify(userData));

然后在 mongosh 外部执行：

mongosh "mongodb://user:pass@host:port/mydb" --eval "db.users.find().forEach(doc => printjson(doc))" > users_export_mongosh.json

注意：

• forEach(printjson) 会将每个文档单独一行输出，类似 mongoexport 不加 --jsonArray 的效果。
• 如果要输出为数组形式,可以先 toArray() 再 printjson(JSON.stringify(result))，但要注意大内存消耗。

mongosh "mongodb://user:pass@host:port/mydb" --eval "db.users.find().toArray().forEach(doc => printjson(doc))" > users_export_mongosh_array.json

但这样输出的每一行还是一个独立的 JSON 对象，而不是一个包含所有对象的数组，要输出真正的 JSON 数组，更可靠的方式还是 mongoexport 的 --jsonArray 参数。

使用第三方 GUI 工具 (适合可视化操作)

对于不习惯命令行的用户,可以使用一些流行的 MongoDB GUI 工具，如 MongoDB Compass、Robo 3T (现在是 Robo 3T 免费版，但功能有所限制) 或 NoSQLBooster for MongoDB 等，这些工具通常都提供图形化的数据导出功能。

以 MongoDB Compass 为例：

1. 连接到您的 MongoDB 服务器。
2. 在左侧导航栏中选择要导出的数据库和集合。
3. 点击集合名称,进入集合视图。
4. 点击右侧的 "Export" 按钮。
5. 在弹出的导出窗口中,选择导出格式为 JSON。
6. 可以设置查询条件、选择要导出的字段等。
7. 选择保存路径,点击 "Export" 即可。

这种方法直观易用,适合需要频繁进行可视化数据操作的用户。

注意事项

1. 数据量大时的性能：mongoexport 在导出大量数据时可能会消耗较多内存和 I/O 资源，对于非常大的集合，可以考虑分批导出（使用 --query 和 skip/limit 组合）或使用 MongoDB 的快照功能进行备份。
2. 权限：确保执行导出操作的用户具有足够的权限（通常是 read 权限）。
3. JSON 格式选择：--jsonArray 参数通常更符合标准的 JSON 数组格式，便于其他程序解析，如果不需要严格的标准，单独行输出也可以。
4. 文件路径：确保 --out 指定的文件路径有写入权限。
5. 特殊字符：如果数据中包含特殊字符，mongoexport 通常能正确处理，但如果遇到问题，可能需要检查文件的编码。

导出 MongoDB 数据为 JSON 格式有多种途径：

• mongoexport 命令行工具：功能强大，灵活高效，适合脚本化和自动化，是官方推荐的主要方式。
• mongosh Shell：适合需要结合复杂查询逻辑或进行其他数据库操作时一并导出。
• GUI 工具：操作直观，适合不熟悉命令行的