# Oracle数据连接参数说明
表1Oracle数据连接
| 参数 | 是否必选 | 说明 |
|:---|:---|:---|
| 数据连接类型 | 是 | Oracle连接固定选择为ORACLE。 |
| 数据连接名称 | 是 | 数据连接的名称，只能包含字母、数字、下划线和中划线，且长度不超过100个字符。 |
| 描述 | 否 | 为更好地识别数据连接，此处加以描述信息，长度不能超过100个字符。 |
| 标签 | 否 | 标识数据连接的属性。设置标签后，便于统一管理。 说明： 标签的名称，只能包含中文、英文字母、数字和下划线，不能以下划线开头，且长度不能超过100个字符。 |
| 适用组件 | 是 | 选择此连接适用的组件。勾选组件后，才能在相应组件内使用本连接。 说明： - 当开启离线数据集成或实时数据集成作业特性后，可勾选数据集成组件，勾选后在数据开发组件创建集成作业时支持选择本数据连接。 - 离线数据集成或实时数据集成作业功能当前需申请白名单后才能使用。如需使用该特性，请联系客服或技术支持人员。 |
| **基础与网络连通配置** |||
| IP或域名 | 是 | 待连接的数据库的访问地址，可填写为IP或域名，其中公网IP和内网IP地址均支持。 |
| 端口 | 是 | 待连接的数据库端口。 |
| KMS加密密钥 | 是 | 通过KMS加解密数据源认证信息，选择KMS中的任一默认密钥或自定义密钥即可。 说明： - 第一次通过DataArts Studio或KPS使用KMS加密时，会自动生成默认密钥dlf/default或kps/default。关于默认密钥的更多信息，请参见[什么是默认密钥](https://support.huaweicloud.com/dew_faq/dew_01_0045.html)章节。 - 仅支持通过对称密钥加密，暂不支持非对称密钥。 |
| 绑定Agent | 是 | DataArts Studio无法直接与非全托管服务进行连接。CDM集群提供了DataArts Studio与非全托管服务通信的代理，所以创建Oracle的数据连接时，请选择一个CDM集群。如果没有可用的CDM集群，请参考[创建CDM集群](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_0576.html)进行创建。 CDM集群作为网络代理，必须和Oracle网络互通才可以成功创建Oracle连接。 |
| **数据源认证及其他功能配置** |||
| 用户名 | 是 | 待连接数据库的用户。该数据库用户需要有数据表的读写权限，以及对元数据的读取权限。 说明： CONNECT权限的用户(只读用户)创建连接时会出现"表或视图不存在"的提示，需要执行如下操作进行授权： 1. 以**root**用户登录oracle节点。 2. 执行如下命令，切换到oracle用户。 **su oracle** 3. 执行如下命令，登录数据库。 **sqlplus /nolog** 4. 执行如下命令，登录**sys** 用户 **connect sys as sysdba;** 输入sys用户的密码。 5. 执行如下SQL语句，进行授权。 **GRANT SELECT ON GV_$INSTANCE to *xxx*;** 其中，*xxx*为需要授权的用户名。 |
| 密码 | 是 | 用户密码。 |
| 数据库连接类型 | 是 | 选择所需的连接方式。 - SID： SID即Oracle数据库实例ID。一个实例只能对应一个数据库，但是一个数据库可以由多个实例对应。 - Service Name： Service Name参数是由oracle8i开始引进的，即Oracle数据库对外服务名，标识整个数据库。 |
| SID | 是 | "数据库连接类型"配置为"SID"时，为必选项。 SID即Oracle数据库实例ID。一个实例只能对应一个数据库，但是一个数据库可以由多个实例对应。 |
| Service Name | 是 | "数据库连接类型"配置为"Service Name"时，为必选项。 Service Name参数是由oracle8i开始引进的，即Oracle数据库对外服务名，标识整个数据库。 |
| **数据源驱动配置** |||
| 驱动程序名称 | 是 | 连接Oracle数据源时，选择"oracle.jdbc.OracleDriver"驱动程序名称。 |
| 驱动文件来源 | 是 | 选择驱动文件的来源方式。 |
| 驱动文件路径 | 是 | "驱动文件来源"选择"OBS路径"时配置。 驱动文件在OBS上的路径。需要您自行到官网下载.jar格式驱动并上传至OBS中。 驱动包下载地址：，推荐使用ojdbc8的12.2.0.1版本。 说明： 如果需要更新驱动文件，则需要先在数据集成页面重启CDM集群，然后通过编辑数据连接的方式重新选择新版本驱动，更新驱动才能生效。 |
| 驱动文件 | 是 | "驱动文件来源"选择"本地文件"时配置。 驱动文件需要您自行到官网下载.jar格式驱动。 驱动包下载地址：，推荐使用ojdbc8的12.2.0.1版本。 说明： 如果需要更新驱动文件，则需要先在数据集成页面重启CDM集群，然后通过编辑数据连接的方式重新选择新版本驱动，更新驱动才能生效。 |
| **数据集成** **配置** |||
| 单次请求行数 | 否 | 可选参数，指定每次请求获取的行数，根据数据源端和作业数据规模的大小配置该参数。如果配置过大或过小，可能影响作业的时长。默认1000。 |
| 连接属性 | 否 | 可选参数，自定义连接属性，单击"添加"可增加多个属性。 常见配置举例如下： - oracle.net.CONNECT_TIMEOUT：连接超时时间， 默认60000，单位为毫秒。 - oracle.jdbc.ReadTimeout：Socket read timeout超时时间， 默认 300000，单位为毫秒。 - jdbc.read.timestamp.with.time.zone.switch=false：该参数用于控制抽取TIMESTAMP WITH TIME ZONE和TIMESTAMP WITH LOCAL TIME ZONE类型数据时是否保留时区信息。 该参数默认值为false，表示不保留时区信息；设为true时，则保留时区信息。通常情况下，数据集成已自动处理时区问题。若发现目的端数据出现时区信息丢失（例如从2026-07-21 10:30:00.123456+08:00变为2026-07-21 10:30:00.123456），建议尝试将此开关设置为true。 |
| 引用符号 | 否 | 可选参数，连接引用表名或列名时的分隔符号，参考对应数据库的产品文档进行配置。默认为"。 |