# 在CodeArts TestPlan接口脚本中调用MongoDBQuery关键字
MongoDB查询操作使用，系统限制最大查询结果记录数100条。
| 参数         | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| Ip         | 是    | String  | 数据库ip地址                                                                                                                                                                                                                                                              |
| Port       | 是    | Integer | 数据库端口                                                                                                                                                                                                                                                                |
| User Name  | 是    | String  | 用户名                                                                                                                                                                                                                                                                  |
| Password   | 是    | String  | 密码（登录密码属于个人敏感信息，须在环境参数中定义为敏感参数）                                                                                                                                                                                                                                      |
| DB Name    | 是    | String  | 数据库实例名称                                                                                                                                                                                                                                                              |
| Collection | 是    | String  | 集合名称                                                                                                                                                                                                                                                                 |
| Query      | 否    | String  | 查询操作指定查询条件（Bson格式数据），默认为空查询集合下的所有数据，系统限制最大记录数为100条。                                                                                                                                                                                                                  |
| Limit      | 否    | Integer | - 查询结果限制条数，默认为空查询集合下的所有数据，系统限制最大记录数为100条。  - 若输入的参数0-100之外的其他数字则取最大限制数100条。   |
   
#### MongoDBQuery响应
状态：成功
| 参数       | 参数类型                 | 描述          |
|:---|:---|:---|
| \[数组元素\] | Array of Row objects | 查询结果列表返回结构体 |
   
#### 参数列表
| 参数     | 参数类型    | 描述       |
|:---|:---|:---|
| field1 | String  | 数据库字段1   |
| field2 | Integer | 数据库字段2   |
| ...    | String  | 数据库字段n.. |
   
#### MongoDBQuery响应示例
```
[ {
  "_id" : {
    "$oid" : "62465c42907c00003d0076fe"
  },
  "title" : "MongoDB 教程",
  "description" : "MongoDB 是一个 Nosql 数据库",
  "by" : "test",
  "url" : "",
  "tags" : [ "mongodb", "database", "NoSQL" ],
  "likes" : 100.0
}, {
  "_id" : {
    "$oid" : "62465ce4907c00003d0076ff"
  },
  "title" : "PHP 教程",
  "description" : "PHP 是一种创建动态交互性站点的强有力的服务器端脚本语言。",
  "by" : "test",
  "url" : "",
  "tags" : [ "php" ],
  "likes" : 200.0
}, {
  "_id" : {
    "$oid" : "62465ce8907c00003d007700"
  },
  "title" : "Java 教程",
  "description" : "Java 是由Sun Microsystems公司于1995年5月推出的高级程序设计语言。",
  "by" : "test",
  "url" : "",
  "tags" : [ "java" ],
  "likes" : 150.0
} ]
```
#### MongoDBQuery使用示例
- 查询数据库集合下的文档数量，系统关键字返回查询文档数据列表，用户可根据业务对返回进行判断。 ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001964032881.png "点击放大")
  通过返回的List可以进行结果判断，例如：判断集合中的文档数量为10个。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001964152681.png "点击放大")
  
- 查询用户数据并进行数据提取，结果返回查询出的数据列表。 ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001937073638.png "点击放大")
  通过响应提取可以进行结果提取或者判断。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001964032885.png "点击放大")