washpost/mongo-vandelay

镜像概述

该镜像是一个基于MongoDB官方镜像构建的功能扩展版本，在保留原生MongoDB数据库核心功能的基础上，集成了完整的数据导入/导出工具链，旨在简化MongoDB数据的备份、迁移及跨系统数据交换流程，适用于需要频繁进行数据导入导出操作的场景。

核心功能和特性

• 原生兼容：基于官方MongoDB镜像构建，完全兼容MongoDB标准功能及数据结构
• 导入工具支持：集成mongoimport命令，支持导入JSON、CSV、TSV等格式数据至指定数据库集合，支持字段映射、数据类型指定及批量导入
• 导出工具支持：集成mongoexport命令，支持将MongoDB集合数据导出为JSON、CSV、TSV格式文件，可指定导出字段、筛选条件及数据格式
• 灵活参数配置：支持通过命令行参数指定数据库地址、认证信息、目标集合、文件路径等关键配置
• 数据卷集成：支持挂载本地文件系统路径，实现宿主机与容器间的数据文件双向传输

使用场景和适用范围

• 数据备份与恢复：定期将核心业务数据导出为文件归档，或从备份文件恢复数据至数据库
• 跨环境数据迁移：在开发、测试、生产环境间迁移数据（如将测试数据集导入生产环境初始化）
• 跨系统数据交换：与数据分析平台（如Excel、Tableau）、ETL工具或第三方系统进行数据格式转换与传输
• 初始化数据部署：新环境部署时，通过导入预定义JSON/CSV数据快速初始化业务数据库
• 数据归档管理：将历史数据导出为压缩文件长期存储，释放数据库存储空间

使用方法和配置说明

基础运行命令

启动包含导入/导出功能的MongoDB容器，默认监听27017端口：

bash
docker run -d \
  --name mongo-import-export \
  -p 27017:27017 \
  -v /local/mongo/data:/data/db \  # 持久化存储数据库文件
  -v /local/import-export:/data/ie \  # 挂载导入导出文件目录
  mongo-import-export

数据导入操作示例

1. 导入JSON格式数据

将本地JSON文件导入至指定数据库集合：

bash
# 导入JSON数组文件（文件路径为容器内挂载路径）
docker exec -it mongo-import-export mongoimport \
  --uri "mongodb://localhost:27017/mydatabase" \  # 目标数据库地址
  --collection users \  # 目标集合名称
  --file /data/ie/users.json \  # 容器内JSON文件路径
  --jsonArray  # 声明文件为JSON数组格式（单文档JSON无需此参数）

2. 导入CSV格式数据

导入包含表头的CSV文件至数据库集合：

bash
docker exec -it mongo-import-export mongoimport \
  --uri "mongodb://localhost:27017/mydatabase" \
  --collection products \
  --type csv \  # 指定文件格式为CSV
  --file /data/ie/products.csv \
  --headerline  # 使用CSV首行作为字段名

数据导出操作示例

1. 导出JSON格式数据

将指定集合数据导出为JSON文件：

bash
docker exec -it mongo-import-export mongoexport \
  --uri "mongodb://localhost:27017/mydatabase" \
  --collection orders \
  --out /data/ie/orders_export.json  # 容器内导出文件路径

2. 导出CSV格式数据（指定字段）

导出集合中特定字段数据为CSV文件：

bash
docker exec -it mongo-import-export mongoexport \
  --uri "mongodb://localhost:27017/mydatabase" \
  --collection users \
  --type csv \
  --fields name,email,register_date \  # 指定导出字段列表
  --out /data/ie/users_export.csv

带身份验证的操作配置

当MongoDB启用身份验证时，需在连接URI中指定认证信息：

bash
# 启动带身份验证的容器
docker run -d \
  --name mongo-import-export-auth \
  -p 27017:27017 \
  -v /local/mongo/data:/data/db \
  -v /local/import-export:/data/ie \
  -e MONGO_INITDB_ROOT_USERNAME=admin \  # 管理员用户名
  -e MONGO_INITDB_ROOT_PASSWORD=securepass \  # 管理员密码
  mongo-import-export

# 带认证的导出示例（需指定authSource为管理员数据库）
docker exec -it mongo-import-export-auth mongoexport \
  --uri "mongodb://admin:securepass@localhost:27017/mydatabase?authSource=admin" \
  --collection sensitive_data \
  --out /data/ie/sensitive_export.json

关键配置参数说明