
# 配置PostgreSQL连接器
PostgreSQL连接器用于连接PostgreSQL数据库，负责建立和维护应用程序和PostgreSQL数据库之间的连接，并管理数据的传输。
- PostgreSQL是一个特性齐全的开源的对象-关系型数据库。
- PostgreSQL默认端口为5432，但是管理员可以根据需要将其更改为其他端口。
#### 创建PostgreSQL连接
1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)。
2. 在左侧导航栏选择"连接器"，在连接器页面单击"新建连接"。
3. 选择"PostgreSQL"连接器。
4. 在弹窗中配置连接器信息，完成后单击"确定"。
   
   | 参数     | 说明                                                                                                                                                                                                                                                                   |
   |:---|:---|
   | 连接名称   | 填写连接器实例名称。                                                                                                                                                                                                                                                           |
   | 区域     | 选择区域。                                                                                                                                                                                                                                                                |
   | 项目     | 选择项目。                                                                                                                                                                                                                                                                |
   | 实例     | 选择实例，用于后续验证连通性。                                                                                                                                                                                                                                                      |
   | 连接与安全  | 选择数据库的连接模式。 - 默认：由系统根据用户配置自动拼接数据源连接字符串。  - 专业：由用户自己输入数据源连接字符串。   |
   | 主机IP地址 | **仅当"连接与安全"选择"默认"时需要配置。** 填写数据库的连接IP地址。                                                                                                                                                                                              |
   | 端口     | **仅当"连接与安全"选择"默认"时需要配置。** 填写数据库的连接端口号。                                                                                                                                                                                               |
   | 数据库名   | **仅当"连接与安全"选择"默认"时需要配置。** 填写要连接的数据库名。                                                                                                                                                                                                 |
   | 连接字符串  | **仅当"连接与安全"选择"专业"时需要配置。** 填写PostgreSQL数据库的JDBC格式连接串，例如：jdbc:postgresql://{hostname}:{port}/{dbname}。                                                                                                                                    |
   | 用户名    | 连接数据库的用户名。                                                                                                                                                                                                                                                           |
   | 密码     | 连接数据库的用户密码。                                                                                                                                                                                                                                                          |
   | 描述     | 填写连接器的描述信息，用于识别不同的连接器。                                                                                                                                                                                                                                               |
      
   
 
#### 支持的动作
- 获取记录
- 添加记录
- 更新记录
- 同步数据
- 增量获取记录
- 删除记录
- 自定义SQL
 
#### 配置参数
![](https://support.huaweicloud.com/usermanual-roma/public_sys-resources/notice_3.0-zh-cn.png)
PostgreSQL连接器不支持中文表名，仅支持英文表名。
表1获取记录 
| 参数         | 说明                         |
|:---|:---|
| 表名         | 选择或者填写要查询的数据库中的表名。         |
| 字段名        | 选择要查询数据表的字段名。              |
| WHERE条件    | 配置要查询数据的条件值（注意值要用英文单引号包住）。 |
| Order by字段 | 填写返回结果的排序字段。               |
| Limit条数    | 填写返回结果的每页数据条数。             |
| Offset偏移量  | 填写分页查询的偏移量。                |
   
表2添加记录 
| 参数   | 说明                           |
|:---|:---|
| 表名   | 选择或者填写数据库中要插入数据的表名。          |
| 插入数据 | 填写插入操作中目标字段的值（注意值要用英文单引号包住）。 |
   
表3更新记录 
| 参数      | 说明                           |
|:---|:---|
| 表名      | 选择或者填写数据库中要更新数据的表名。          |
| 更新数据    | 填写更新操作中目标字段的值（注意值要用英文单引号包住）。 |
| WHERE条件 | 配置要更新数据的条件值（注意值要用英文单引号包住）。   |
   
表4同步数据 
| 参数  | 说明                  |
|:---|:---|
| 表名  | 选择或者填写数据库中要同步数据的表名。 |
| 清空表 | 每次同步数据，是否先清空表。      |
   
表5增量获取记录 
| 参数           | 说明                         |
|:---|:---|
| 表名           | 选择或者填写要增量获取记录的数据库中的表名。     |
| 字段名          | 选择要查询数据表的字段名。              |
| WHERE条件      | 配置要查询数据的条件值（注意值要用英文单引号包住）。 |
| Order by字段   | 填写返回结果的排序字段。               |
| 增量获取时区       | 增量数据获取开始时区。                |
| 增量获取时间戳字段    | 增量数据获取的时间戳字段。              |
| 增量获取时间戳初始值   | 增量数据获取的时间戳初始值。             |
| 重置增量获取时间初始值  | 选择是否开启重置增量获取时间初始值。         |
| 增量获取时间补偿(毫秒） | 增量获取时间补偿。                  |
   
表6删除记录 
| 参数      | 说明                         |
|:---|:---|
| 表名      | 选择或者填写数据库中要删除数据的表名。        |
| WHERE条件 | 配置要删除数据的条件值（注意值要用英文单引号包住）。 |
   
表7自定义SQL 
| 参数   | 说明                                                                               |
|:---|:---|
| 执行语句 | 执行语句内容会明文展示所输入信息，防止信息泄露。仅支持执行一条select、update、insert或delete语句。select语句最多返回500条数据。 |
   
表8自定义SQL输出 
| 参数             | 说明                                                                                                                                   |
|:---|:---|
| Payload        | 返回json格式行数据。键表示数据库字段名称，值表示数据库字段值。每行数据以逗号拼接。Payload说明详见[组合应用引用变量](https://support.huaweicloud.com/usermanual-roma/roma_03_5212.html)。 |
| Updated count  | 更新数据行数                                                                                                                               |
| Selected count | 查询数据行数                                                                                                                               |
| Start time     | 节点执行开始时间。                                                                                                                            |
| End time       | 节点执行结束时间。                                                                                                                            |
| Execution time | 节点执行耗时，单位：ms。                                                                                                                        |
   
