---
url: /v6.2/connecting-tidb.md
---
# 连接 TiDB

### 连接步骤

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

1. 在数据连接页面右上角点击新建数据连接。

   ![](/images/data-connection/connection-001.png)

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

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

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

   | 字段        | 说明               |
   | ----------- | ---------------- |
   | 名称                                  | 连接的名称。必填，且用户内唯一                               |
   | 机器地址                              | 数据库的地址。如果填了 url 字段，优先使用 url 里面的         |
   | 端口                                  | 数据库的端口。如果填了 url 字段，优先使用 url 里面的         |
   | 用户名                                | 数据库的用户名                                               |
   | 密码                                  | 数据库的密码                                                 |
   | 数据库                                | 数据库名称                                                   |
   | 最大连接数                            | 连接池最大连接数                                             |
   | 优先使用数据库 comment 做数据集的标题 | 优先显示表的名字还是表的注释。开启时显示标题，关闭时显示表注释 |
   | URL                                   | 数据库的 jdbc url                                            |
   | 分层加载 schema 和表                  | 默认为 关闭。开启时分层加载 schema 和表，连接过程只加载 schema，需要点击schema才会加载schame下的table |
   | 查询超时时间（秒）                    | 默认为 600. 当数据量较大时,可以适当增加超时时间              |
   | 只显示指定数据库/模式下的表           | 该项选中时并且 database 字段不为空，则只显示该 db 下面的表   |

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

5. 验证通过后，点击 `执行预置代码`，弹出该数据源对应的预置代码，点击执行按钮。

6. 点击`添加`按钮，添加 `TiDB` 连接。

> \[!CAUTION] 请注意
>
> 1. 配置参数时带\*的参数是必填参数，其他参数为选填。
> 2. Tidb 不支持窗口函数，所以不支持[高级计算](chart-advanced-calculation.md)，必须要开启[加速引擎](dataset-engine.md)才支持。
> 3. 连接数据源时，必须执行预置代码。不执行会导致数据分析过程中某些函数无法使用。此外，从4.4之前的版本升到4.4时，需要对系统中已经存在的数据连接执行预置代码。

***

### 支持的`TiDB`版本

`v2.0`、`v2.1`、`v3.0`、`v3.1`、`v4.0`、`v5.0`、`v5.1`、`v5.3`、`v6.0`、`v6.2`、`v6.3`、`v6.4`、`v6.6`、`v7.0`、`v7.2`、`v7.3`、`v7.4`、`v7.6`、`v8.0`、`v8.2`、`v8.3`、`v8.4`

### 数据连接预览支持

支持普通`table` 和 `view` 等`show tables`能列出的表。

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

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