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