---
url: /v6.2/connecting-doris.md
---
# 连接 Apache Doris

### 连接步骤

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

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

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

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

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

   | 字段                                  | 说明                                                         |
   | ------------------------------------- | ------------------------------------------------------------ |
   | 名称                                  | 连接的名称。必填，且用户内唯一                               |
   | 机器地址                              | 数据库的地址。如果填了 url 字段，优先使用 url 里面的         |
   | 端口                                  | 数据库的端口。如果填了 url 字段，优先使用 url 里面的         |
   | 用户名                                | 数据库的用户名                                               |
   | 密码                                  | 数据库的密码                                                 |
   | 数据库                                | 数据库名称                                                   |
   | 最大连接数                            | 连接池最大连接数                                             |
   | 编码                                  | 数据库连接的编码设置                                         |
   | 优先使用数据库 comment 做数据集的标题 | 优先显示表的名字还是表的注释                                 |
   | URL                                   | 数据库的 jdbc url                                            |
   | FE Http Port                          | FE Http Port 是使用 stream load 的方式写入数据的端口。如果提供，写入性能会更好，否则使用 insert 写入。由于 stream load 会302跳转给 BE 的端口，所以要求衡石服务也能访问 BE 的端口才能正常使用这个功能。 |
   | 分层加载 schema 和表                  | 默认为 关闭。开启时分层加载 schema 和表，连接过程只加载 schema，需要点击schema才会加载schame下的table |
   | 查询超时时间（秒）                    | 默认为 600. 当数据量较大时,可以适当增加超时时间              |
   | 允许写入操作                          | 表示该连接可以在[数据集成](pipeline.md)，[批量同步](batch-sync.md)中选择为输出连接。需要有对数据库有写权限且验证通过后，才能配置该参数。 |
   | 支持上传文件到指定路径                | 表示新建本地文件数据集时, 生成的表存放的数据库名称。需要有对数据库有写权限验且证通过后，才能配置该参数。 |
   | 只显示指定数据库/模式下的表           | 该项选中时并且 database 字段不为空，则只显示该 db 下面的表   |

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

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

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

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

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

***

### 支持的`Apache Doris`版本

`1.2.1及以上`、`2.1.x`、`3.0.x`