更新时间:2025-08-27 GMT+08:00

RDS(SQL Server)数据连接参数说明

RDS(SQL Server)数据连接支持连接云数据库SQL Server、自建SQL Server等数据库。

表1 RDS数据连接

参数

是否必选

说明

数据连接类型

RDS(SQL Server)连接固定选择为RDS(SQL Server)。

数据连接名称

数据连接的名称,只能包含字母、数字、下划线和中划线,且长度不超过100个字符。

描述

为更好地识别数据连接,此处加以描述信息,长度不能超过100个字符。

标签

标识数据连接的属性。设置标签后,便于统一管理。
说明:

标签的名称,只能包含中文、英文字母、数字和下划线,不能以下划线开头,且长度不能超过100个字符。

适用组件

选择此连接适用的组件。勾选组件后,才能在相应组件内使用本连接。

说明:
  • 当开启离线数据集成或实时数据集成作业特性后,可勾选数据集成组件,勾选后在数据开发组件创建集成作业时支持选择本数据连接。
  • 离线数据集成或实时数据集成作业功能当前需申请白名单后才能使用。如需使用该特性,请联系客服或技术支持人员

基础与网络连通配置

IP或域名

表示通过内部网络访问关系型数据库的访问地址,可填写为IP或域名。

  • 如果为RDS等云上数据源,可以通过管理控制台获取访问地址:
    1. 根据注册的账号登录对应云服务的管理控制台。
    2. 从左侧列表选择实例管理。
    3. 单击某一个实例名称,进入实例基本信息页面。在连接信息标签中可以获取到内网IP、域名和端口等信息。
  • 如果为自建SQL Server等线下数据源,可以通过数据库管理员获取相应的访问地址。

端口

关系型数据库数据源的访问端口。请确保您已在安全组规则中开放此端口,以便DataArts Studio实例可以通过该端口连接此数据库。

  • 如果为RDS等云上数据源,可以通过管理控制台获取访问地址:
    1. 根据注册的账号登录对应云服务的管理控制台。
    2. 从左侧列表选择实例管理。
    3. 单击某一个实例名称,进入实例基本信息页面。在连接信息标签中可以获取到内网IP、域名和端口等信息。
  • 如果为自建SQL Server等线下数据源,可以通过数据库管理员获取相应的访问地址。

KMS密钥

通过KMS加解密数据源认证信息,选择KMS中的任一默认密钥或自定义密钥即可。
说明:
  • 第一次通过DataArts Studio或KPS使用KMS加密时,会自动生成默认密钥dlf/default或kps/default。关于默认密钥的更多信息,请参见什么是默认密钥
  • 仅支持通过对称密钥加密,暂不支持非对称密钥。

绑定Agent

RDS类型数据源为非全托管服务,DataArts Studio无法直接与非全托管服务进行连接。CDM集群提供了DataArts Studio与非全托管服务通信的代理,所以创建RDS类型的数据连接时,请选择一个CDM集群。如果没有可用的CDM集群,请参考创建CDM集群进行创建。

CDM集群作为网络代理,必须和RDS网络互通才可以成功创建RDS连接,为确保两者网络互通,CDM集群必须和RDS处于相同的区域、可用区,且使用同一个VPC和子网,安全组规则需允许两者网络互通。

说明:

CDM集群作为管理中心数据连接Agent时,单集群的并发活动线程最大为200。即当多个数据连接共用同一Agent时,通过这些数据连接提交SQL脚本、Shell脚本、Python脚本等任务的同时运行上限为200,超出的任务将排队等待。建议您按照业务量情况规划多个Agent分担压力。

SSL加密

支持对RDS服务启用SSL加密传输。

数据源驱动配置

驱动程序名称

com.microsoft.sqlserver.jdbc.SQLServerDriver: 连接SQL Server数据源时,选择此驱动名称。

驱动文件路径

驱动文件在OBS上的路径。需要您自行到官网下载.jar格式驱动并上传至OBS中。

SQL Server驱动获取地址:https://learn.microsoft.com/zh-cn/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver16,建议8.4.1版本。

说明:
  • 驱动文件所在的OBS路径中不能包含中文。
  • 出于安全考虑,当前系统会对所选择的驱动文件校验其SHA512值和字节大小。如不在允许清单中,则会提示报错,推荐您使用建议版本的驱动文件,或联系客服或技术支持人员
  • 如果需要更新驱动文件,则需要先在数据集成页面重启CDM集群,然后通过编辑数据连接的方式重新选择新版本驱动,更新驱动才能生效。

数据源认证及其他功能配置

用户名

数据库的用户名,创建集群的时候,输入的用户名。

密码

数据库的访问密码,创建集群的时候,输入的密码。

数据集成配置

数据库名称

配置为要连接的数据库名称。

单次请求行数

可选参数,指定每次请求获取的行数,根据数据源端和作业数据规模的大小配置该参数。如果配置过大或过小,可能影响作业的时长。默认1000。

连接属性

可选参数,单击“添加”可增加多个指定数据源的JDBC连接器的属性,参考对应数据库的JDBC连接器说明文档进行配置。

SQL Server举例如下:
  • connectTimeout=60socketTimeout=300:迁移数据量较大、或通过查询语句检索全表时,会由于连接超时导致迁移失败。此时可自定义连接超时时间与socket超时时间(单位s),避免超时导致失败。
  • useCursorFetch=false:CDM作业默认打开了JDBC连接器与关系型数据库通信使用二进制协议开关,即useCursorFetch=true。部分第三方可能存在兼容问题导致迁移时间转换出错,可以关闭此开关。
  • trustServerCertificate=true:在创建安全连接的时候可能会报PKIX错误,建议设置为true。
  • sslmode=require:PostgreSQL在开启SSL认证时可能会连接失败,需要设置为require。

引用符号

可选参数,连接引用表名或列名时的分隔符号,参考对应数据库的产品文档进行配置。默认为"。