# 在CodeArts TestPlan接口脚本中调用OpenGaussQuery关键字
适用于OpenGaussQuery SELECT操作使用，系统限制最大查询结果行数100条。
| 参数        | 是否必选 | 参数类型    | 描述                                                                                                                                                                                  |
|:---|:---|:---|:---|
| Ip        | 是    | String  | 数据库ip： 如果是云数据库 GaussDB实例，需要绑定EIP，并保证实例端口安全组策略开启放行，详细请参考华为云：[通过gsql连接实例](https://support.huaweicloud.com/usermanual-gaussdb/gaussdb_01_503.html)。 |
| Port      | 是    | Integer | 数据库端口                                                                                                                                                                               |
| DB Name   | 是    | String  | 数据库实例名称                                                                                                                                                                             |
| User Name | 是    | String  | 用户名                                                                                                                                                                                 |
| Password  | 是    | String  | 密码（登录密码属于个人敏感信息，须在环境参数中定义为敏感参数）                                                                                                                                                     |
| Sql       | 是    | String  | SQL查询语句                                                                                                                                                                             |
   
#### OpenGaussQuery响应
状态：成功
| 参数       | 参数类型                 | 描述             |
|:---|:---|:---|
| \[数组元素\] | Array of Row objects | SQL查询结果列表返回结构体 |
   
#### 参数列表
| 参数     | 参数类型    | 描述     |
|:---|:---|:---|
| field1 | String  | 数据库字段1 |
| field2 | Integer | 数据库字段2 |
| ...    | String  | 数据库字段n |
   
#### OpenGaussQuery响应示例
```
[ 
    { 
        "name": "张三", 
        "id": "efdb403066474ab08836b9eeaaa23bca", 
        "age": 18 
    }, 
    { 
        "name": "李四", 
        "id": "g582b0d966611486f918bedb9c711b14", 
        "age": 20 
    } 
]
```
#### OpenGaussQuery使用示例
查询数据库表数据，系统关键字返回用户数据列表，用户可根据业务对返回进行判断。
![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001936913970.png "点击放大")
用户可以在返回的List里面进行结果判断：
![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001936913962.png "点击放大")
查询用户数据并进行数据统计，结果返回用户数据统计列表。
![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001964152349.png "点击放大")
用户可以在响应提取里面进行结果判断：
![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001937073314.png "点击放大")