数据库管理

后台「开发者工具 → 数据库」提供可视化的数据库管理能力，方便在不登录 MongoDB 客户端的情况下查看和操作数据。

CAUTION

数据库管理属于高级操作，误操作可能导致数据丢失。请在操作前先进行备份，并确认当前操作的影响范围。

数据浏览

数据库管理页面展示系统中所有已注册的模型（集合），包含以下信息：

字段	说明
`modelName`	模型名称
`collectionName`	MongoDB 集合名称
`remark`	模型备注（Schema 注释）
`size`	集合总大小
`count`	文档条数
`avgObjSize`	平均文档大小
`storageSize`	存储占用
`nindexes`	索引数量

点击某个模型即可进入该集合的数据管理。

查看结构

进入集合后可查看其字段结构：

字段	说明
`name`	字段名
`type`	字段类型（String、Number、ObjectId 等）
`required`	是否必填
`default`	默认值
`comment`	字段注释

数据查询

支持 MongoDB 原生查询语法（兼容 MongoDB Compass 格式）：

filter：查询条件（JSON 对象）
project：返回字段投影
sort：排序规则
collation：排序规则（可选）

未提供排序时默认按 _id 倒序，支持分页查询。查询示例：

json

{
  "status": 1,
  "title": { "$regex": "热歌", "$options": "i" }
}

导出与导入

导出数据

选择目标模型后导出，系统将全量数据导出为 JSON 文件，并生成可下载链接。

导入数据

仅支持 JSON 格式文件。
文件内容必须是 JSON 数组。
导入前请确认目标模型存在且字段结构兼容。

备份与恢复

一键备份

系统调用 MongoDB 备份工具将当前数据库导出，并压缩为 zip 文件：

备份文件名格式：bak-[数据库名]-[日期]-[随机串].zip
备份文件保存于服务器 数据目录/backup 下
备份时支持勾选“同时导出”，生成可下载地址便于异地保存

备份列表

展示所有备份文件，包含文件名、创建时间、文件大小与格式，可在此删除历史备份。

恢复数据

从备份列表中选择备份文件进行恢复：

WARNING

恢复操作会覆盖当前数据库（mongorestore --drop），执行前请务必确认，且建议再次备份当前数据。

接口	方法	说明
`/admin/develop/database/fields`	GET	模型 / 集合列表
`/admin/develop/database/structure`	GET	查看模型结构
`/admin/develop/database/documents`	POST	数据查询（分页）
`/admin/develop/database/columns`	GET	获取字段列表
`/admin/develop/database/export`	GET	导出模型数据
`/admin/develop/database/import`	POST	导入模型数据
`/admin/develop/database/backup`	GET	一键备份
`/admin/develop/database/backup_list`	GET	备份文件列表
`/admin/develop/database/backup_delete`	POST	删除备份文件

数据库管理 ​

数据浏览 ​

查看结构 ​

数据查询 ​

导出与导入 ​

导出数据 ​

导入数据 ​

备份与恢复 ​

一键备份 ​

备份列表 ​

恢复数据 ​

相关接口 ​