MongoDB 数据库
MongoDB 是一种面向文档的数据库管理系统,属于非关系型数据库(NoSQL),旨在为 Web 应用提供可扩展的高性能数据存储解决方案。与关系型数据库(SQL)不同,MongoDB 不使用 SQL 语句对数据库进行操作,而是使用数据库命令(Database Commands)或者更加简单易用的增删查改方法。扩展阅读:《MongoDB 中文手册》。
连接数据库
- 点击接口中的“前置/后置操作“,选择“数据库操作”。
- 点击“数据库连接”下拉框中的“数据库连接管理”选项,然后点击右上角的新建按钮。
- 选择 MongoDB 数据库类型,然后填写相对应的连接信息。
Apifox 重视您的数据安全。数据库地址、端口、用户名、 密码、数据库名仅存储在客户端本地,不会同步到云端。即便是同一团队内,成员之间也不会相互同步数据库的连接信息,每个团队成员需要自己手动设置数据库。
操作数据库
MongoDB 采用 BSON 文档格式存储数据。为了便利大多数人的使用习惯,在 Apifox 中修改 MongoDB 数据库时提交 JSON 格式文件,系统将根据 JSON 的实际内容自动映射每个字段所对应的 BSON 数据类型。
其中,较为特殊的是 _id
字段。根据 MongoDB 规范,每个文档都必须有 _id
字段作为主键,该字段的默认数据类型是 ObjectId
,而不是 String
。
如果需要声明一个 ObjectId
类型的 _id
字段,使用常规的字符串格式即可;如果字符串的内容符合 ObjectId
格式,Apifox 会将其自动映射为 BSON 的 ObjectId
类型。
假设现在 MongoDB 内有这样一个 BSON 文档:
{
_id: ObjectId('65486728456e79993a150f1c'),
name: "Apifox"
}
那么使用 Apifox 通过 _id
查询该文档时,在「查询条件」处需要输入的 JSON 值是:
{
"_id": "65486728456e79993a150f1c"
}
常用操作
对于常用的增删查改操作,支持通过可视化界面操作。无需撰写任何 JavaScript 代码,只需要在“操作类型”中指定动作,然后指定“集合名”,接着在”查询条件“中使用 JSON 撰写相应的内容。
例如针对上文提到的查询操作,输入命令并开启”控制台打印结果“后,就可以在控制台查看查询到的文档。
进阶命令
如果需要更高级的操作,你也可以直接运行数据库命令。在「操作类型」中选择「运行数据库命令」,然后输入 JSON 格式的数据库命令。需要注意的是,数据库命令并非指的是类似 db.collection.findOne()
的方法调用,而是特定格式的 JSON 数据。
比如,要查询 users 集合内的文档数量,就可以使用 count
这个数据库命令:
{
"count": "users"
}
输入命令后可以在控制台中查看结果。