---
url: /v6.2/connecting-oracle.md
---
# 连接 Oracle

### 操作步骤

请参照如下步骤连接 `Oracle` 数据源。

1. 在数据连接页面右上角点击新建数据连接。
   ![](/images/data-connection/connection-001.png)

2. 在数据源种类中选择 `Oracle` 数据源。
   ![](/images/data-connection/connecting-oracle-001.png)

3. 按要求填写连接时数据源的参数。
   ![](/images/data-connection/connecting-oracle-002.png)

   **连接配置信息说明**

   | 字段            | 说明                       |
   | --------------- | ----------------------- |
   | 名称            | 连接的名称。必填，且用户内唯一     |
   | 机器地址                              | 数据库的地址。如果填了 url 字段，优先使用 url 里面的         |
   | 端口                                  | 数据库的端口。如果填了 url 字段，优先使用 url 里面的         |
   | 用户名                                | 数据库的用户名                                               |
   | 密码                                  | 数据库的密码                                                 |
   | 数据库                                | 数据库名称                                                   |
   | 模式                                  | 数据库的schema                                               |
   | 最大连接数                            | 连接池最大连接数                                             |
   | 优先使用数据库 comment 做数据集的标题 | 优先显示表的名字还是表的注释。开启时显示标题，关闭时显示表注释 |
   | URL                                   | 数据库的 jdbc url                                            |
   | 读取行为的事务隔离级别                | 该设置只影响读取数据，写入数据还是用默认的隔离级别           |
   | 分层加载 schema 和表                  | 默认为 关闭。开启时分层加载 schema 和表，连接过程只加载 schema，需要点击schema才会加载schame下的table |
   | 查询超时时间（秒）                    | 默认为 600. 当数据量较大时,可以适当增加超时时间              |
   | 允许写入操作                          | 表示该连接可以在[数据集成](pipeline.md)，[批量同步](batch-sync.md)中选择为输出连接。需要有对数据库有写权限且验证通过后，才能配置该参数。 |
   | 支持上传文件到指定路径                | 表示新建本地文件数据集时, 生成的表存放的数据库名称。需要有对数据库有写权限验且证通过后，才能配置该参数。 |
   | 只显示指定数据库/模式下的表           | 该项选中时并且 database 字段不为空，则只显示该 db 下面的表   |

4. 填好参数后，点击`验证`按钮，获取验证结果(验证 HENGSHI SENSE 和设置的数据连接的连通性，在未验证通过时不可添加)。

5. 验证通过后`允许写入操作`和 `支持上传文件到指定路径` 由禁用变为启用，可选择是否开启这两项。

6. 点击 `执行预置代码`，弹出该数据源对应的预置代码，点击执行按钮。

7. 点击`添加`按钮，添加 `Oracle` 连接。

> \[!CAUTION] 请注意
>
> 1. 配置参数时带\*的参数是必填参数，其他参数为选填。
> 2. 连接数据源时，必须执行预置代码。不执行会导致数据分析过程中某些函数无法使用。此外，从4.4之前的版本升到4.4时，需要对系统中已经存在的数据连接执行预置代码。

***

### 支持的`Oracle`版本

`10g`, `11.2.x`, `12.1.x`, `12.2.x`

### 数据连接预览支持

支持有读取权限的所有表格。

> \[!CAUTION] 请注意
>
> 1. HENGSHI SENSE 会过滤系统用户的表，需要连接的表不能放在系统用户名下。
> 2. 系统用户包括`OUTLN`, `CTXSYS`, `SYSTEM`, `RDSADMIN`, `DBSNMP`, `GSMADMIN_INTERNAL`, `XDB`, `APPQOSSYS`, `SYS`, `MDSYS`, `OLAPSYS`, `ORDDATA`, `ORDSYS`, `WMSYS`, `LBACSYS`, `DVSYS`, `AUDSYS`, `OJVMSYS`, `FLOWS_FILES`, 以及以`APEX_`开头的用户。

### SQL查询数据集对SQL的支持

支持所有`SELECT`相关特性，`SELECT SQL` 语句需要符合`Oracle`语法规范。

### 认证方式支持说明

支持用户名密码直连的方式，不支持Proxy Authentication方式。

### 不支持的字段类型

Oracle 的以下类型的列，不能正确处理：

* BINARY_FLOAT
* BINARY_DOUBLE
* BFILE
* XMLType
* UriType
* Object
* user-defined datatypes
