# RDS(PostgreSQL)数据连接参数说明 RDS(PostgreSQL)数据连接支持连接云数据库PostgreSQL、自建PostgreSQL和GaussDB等数据库。 表1RDS数据连接 | 参数 | 是否必选 | 说明 | |:---|:---|:---| | 数据连接类型 | 是 | RDS(PostgreSQL)连接固定选择为RDS(PostgreSQL)。 | | 数据连接名称 | 是 | 数据连接的名称，只能包含字母、数字、下划线和中划线，且长度不超过100个字符。 | | 描述 | 否 | 为更好地识别数据连接，此处加以描述信息，长度不能超过100个字符。 | | 标签 | 否 | 标识数据连接的属性。设置标签后，便于统一管理。 说明： 标签的名称，只能包含中文、英文字母、数字和下划线，不能以下划线开头，且长度不能超过100个字符。 | | 适用组件 | 是 | 选择此连接适用的组件。勾选组件后，才能在相应组件内使用本连接。 说明： - 当开启离线数据集成或实时数据集成作业特性后，可勾选数据集成组件，勾选后在数据开发组件创建集成作业时支持选择本数据连接。 - 离线数据集成或实时数据集成作业功能当前需申请白名单后才能使用。如需使用该特性，请联系客服或技术支持人员。 | | **基础与网络连通配置** ||| | IP或域名 | 是 | 表示通过内部网络访问关系型数据库的访问地址，可填写为IP或域名。 - 如果为RDS等云上数据源，可以通过管理控制台获取访问地址： 1. 根据注册的账号登录对应云服务的管理控制台。 2. 从左侧列表选择实例管理。 3. 单击某一个实例名称，进入实例基本信息页面。在连接信息标签中可以获取到内网IP、域名和端口等信息。 - 如果为自建PostgreSQL等线下数据源，可以通过数据库管理员获取相应的访问地址。 - 支持填写GaussDB数据源的IP或域名。 说明： 数据连接用于实时集成作业时，只支持填写主节点IP。 | | 端口 | 是 | 关系型数据库数据源的访问端口。请确保您已在安全组规则中开放此端口，以便DataArts Studio实例可以通过该端口连接此数据库。 - 如果为RDS等云上数据源，可以通过管理控制台获取访问地址： 1. 根据注册的账号登录对应云服务的管理控制台。 2. 从左侧列表选择实例管理。 3. 单击某一个实例名称，进入实例基本信息页面。在连接信息标签中可以获取到内网IP、域名和端口等信息。 - 如果为自建PostgreSQL等线下数据源，可以通过数据库管理员获取相应的访问地址。 - 支持填写GaussDB数据源的IP或域名。 说明： 数据连接用于实时集成作业时，只支持填写主节点IP。 | | 集群模式 | 是 | "驱动程序名称"选择为"com.huawei.opengauss.jdbc.Driver"时生效，选择GaussDB的集群模式。 - 主备模式 - 分布式模式 | | KMS加密密钥 | 是 | 通过KMS加解密数据源认证信息，选择KMS中的任一默认密钥或自定义密钥即可。 说明： - 第一次通过DataArts Studio或KPS使用KMS加密时，会自动生成默认密钥dlf/default或kps/default。关于默认密钥的更多信息，请参见[什么是默认密钥](https://support.huaweicloud.com/dew_faq/dew_01_0045.html)章节。 - 仅支持通过对称密钥加密，暂不支持非对称密钥。 | | 绑定Agent | 是 | RDS类型数据源为非全托管服务，DataArts Studio无法直接与非全托管服务进行连接。CDM集群提供了DataArts Studio与非全托管服务通信的代理，所以创建RDS类型的数据连接时，请选择一个CDM集群。如果没有可用的CDM集群，请参考[创建CDM集群](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_0576.html)进行创建。 CDM集群作为网络代理，必须和RDS网络互通才可以成功创建RDS连接，为确保两者网络互通，CDM集群必须和RDS处于相同的区域、可用区，且使用同一个VPC和子网，安全组规则需允许两者网络互通。 说明： CDM集群作为管理中心数据连接Agent时，单集群的并发活动线程最大为200。即当多个数据连接共用同一Agent时，通过这些数据连接提交SQL脚本、Shell脚本、Python脚本等任务的同时运行上限为200，超出的任务将排队等待。建议您按照业务量情况规划多个Agent分担压力。 | | SSL加密 | 否 | 适用组件勾选"数据集成"后，支持启用SSL加密传输。 | | **数据源驱动配置** ||| | 驱动程序名称 | 是 | - org.postgresql.Driver：连接PostgreSQL数据源时，选择此驱动程序名称。 - com.huawei.opengauss.jdbc.Driver：连接GaussDB数据源时，选择此驱动程序名称。 | | 驱动文件路径 | 是 | 驱动文件在OBS上的路径。需要您自行到官网下载.jar格式驱动并上传至OBS中。 - PostgreSQL驱动：获取地址，建议42.3.4版本。 - GaussDB驱动：请在[GaussDB官方文档](https://support.huaweicloud.com/gaussdb/index.html)中搜索"获取驱动jar包"或"JDBC包、驱动类和环境类"，然后选择GaussDB实例类型和数据库引擎版本对应的场景资料，参考文档获取驱动包并解压驱动包。 说明： - 驱动文件所在的OBS路径中不能包含中文。 - 出于安全考虑，当前系统会对所选择的驱动文件校验其SHA512值和字节大小。如不在管理中心允许使用清单中，则会提示报错，推荐您使用建议版本的驱动文件，或联系客服或技术支持人员。 - 如果需要更新驱动文件，则需要先在数据集成页面重启CDM集群，然后通过编辑数据连接的方式重新选择新版本驱动，更新驱动才能生效。 | | **数据源认证及其他功能配置** ||| | 用户名 | 是 | 数据库的用户名，创建集群的时候，输入的用户名。 | | 密码 | 是 | 数据库的访问密码，创建集群的时候，输入的密码。 | | **数据集成** **配置** ||| | 数据库名称 | 是 | 配置为要连接的数据库名称。 | | 单次请求行数 | 否 | 可选参数，指定每次请求获取的行数，根据数据源端和作业数据规模的大小配置该参数。如果配置过大或过小，可能影响作业的时长。默认1000。 | | 连接属性 | 否 | 可选参数，自定义连接属性，单击"添加"可增加多个属性。 PostgreSQL举例如下： - **connectTimeout=60** 与**socketTimeout=300** ：迁移数据量较大、或通过查询语句检索全表时，会由于连接超时导致迁移失败。此时可自定义连接超时时间与socket超时时间（单位为秒），避免超时导致失败。 同时，不同驱动版本对socketTimeout参数的支持情况不同，建议使用较新版本的驱动，如sqljdbc9.4.jar及以后的版本。 - **jdbc.read.timestamp.with.time.zone.switch=false：** 用于控制抽取DATETIMEOFFSET类型数据时是否保留时区信息。 该参数默认值为false，表示不保留时区信息；设为true时，则保留时区信息。通常情况下，数据集成已自动处理好时区问题。若发现目的端同步数据出现时区信息丢失（例如从2026-07-21 10:30:00.123456+08:00变为2026-07-21 10:30:00.123456），建议尝试将此开关设置为true。 | | 引用符号 | 否 | 可选参数，连接引用表名或列名时的分隔符号，参考对应数据库的产品文档进行配置。默认为"。 | | 私密属性 | 否 | 可选参数，JDBC私密属性，配置后将会进行加密存储，创建连接时会拼接到连接属性中。例如：key1=value1\&key2=value2 |