驱动版本

默认驱动有默认关键字标识，未标识的驱动为自定义驱动。自定义驱动会列出驱动类型匹配的类，包括：同样类型的，Generic类型的，其它可以适配的类型的（比如TIDB数据源，可以展示出类型选择为MYSQL的自定义驱动），无类型的（10.0版本之前定义的自定义驱动没有类型选择）。

默认驱动参考支持的数据源范围中的sql数据源部分。选择驱动然后进行对应的属性配置。

自定义驱动：点击定义驱动按钮，在驱动管理的对话框，默认选中对应驱动类型，并展示对应的驱动列表。从下拉选框中选择用户定义的自定义驱动，自定义驱动的创建和管理参考驱动管理。

URL

数据源的URL包含数据库名称、数据库服务器等信息，对应数据连接页面提供了URL示例，根据自身数据库的信息修改填入即可。

➢例如：MySQL的URL为jdbc:mysql://<Databaseserver>:3306/<DatabaseName>

若自身数据库 IP 为192.168.0.1，数据库名称为mysql ，则填入的URL为

jdbc:mysql://192.168.0.1:3306/mysql

SQLITE数据源的URL填写本地文件路径即可，如jdbc:sqlite:D:\Database\sqlite\test。

认证方式

通常包含两种方式：用户名和密码、无身份验证。当数据库设定了访问权限后，用户需要使用用户名和密码来访问当前数据库。也支持Kerberos认证（比如Hive），集成身份认证（比如SSAS）。

开启SSL

SQL数据源中MYSQL、CLICKHOUSE、ELASTIC SEARCH、OPEN DISTRO数据源支持SSL设置。MYSQL、CLICKHOUSE的SSL设置，详情请参考SSL设置。ELASTIC SEARCH的SSL配置，详情请参考ELASTIC SEARCH > SSL设置。OPEN DISTRO的SSL配置，详情请参考OPEN DISTRO > SSL设置。

用户名

连接数据库所需要的用户名。

密码

连接数据库所需要的密码。

租户模式

*适用数据源：OCEANBASE

连接数据库时的租户模式，包括MySQL模式和Oracle模式。

指定数据库

控制数据源下展示的数据库（Catalog）。输入要连接的数据库的名称，数据源下就只展示对应的数据库，如果此处不做指定，那将显示所有的数据库。

指定表结构模式

控制数据源下展示的表结构模式（Schema）。当选择一个表结构模式，数据源下就只展示指定的这一个，如果此处不做指定，那将显示所有的表结构模式。

服务器

数据源的服务器地址。

端口号

数据源的端口号。

默认数据库

默认数据库。

服务

连接数据源的服务器名或IP，适用于ORACLE数据源。

驱动版本

参考按URL的设置方式。

用户名

密码

租户模式

指定数据库

指定表结构模式

服务器证书文件路径

服务器证书文件的路径。

客户端证书文件路径

客户端证书文件的路径。

客户端密钥文件路径

客户端密钥文件的路径。

需要SSL

默认不勾选，通过SSL连接失败的话会自动转非ssl连接；勾选后，只能通过SSL连接数据库，连不上会报错 。

验证服务器证书

默认不勾选，勾选后，客户端会验证服务器的证书。

服务器证书文件路径

服务器证书文件的路径。

客户端证书文件路径

客户端证书文件的路径。

客户端密钥文件路径

客户端密钥文件的路径。

SSL模式

支持两种SSL模式：strict、none，strict表示验证所有的服务器证书，none表示信任，不验证。

开启连接池

GENERIC、DB2、MYSQL、ORACLE、POSTGRE、SQLSERVER默认开启，其他数据源默认关闭，配置开启数据源连接池的开关，点击勾选可以开启连接池的配置。

开启后才会出现属性【有效连接时间】、【最大连接数】和添加连接池属性。

有效连接时间

数据源的有效连接时间，默认为2小时，当配置为2小时后，超过2小时的连接占用不会放入连接池中。

最大连接数

该数据源最多的连接个数，默认为30。

添加连接池属性

点击添加符号为连接池添加属性，点击后出现【名称】和【值】的输入框，可以点击删除图标删除相应的属性。

Quote符号

定义数据库执行SQL需要转义的情况下，使用的是反引号还是双引号，默认为双引号。

*适用数据源：GENERIC

Fetchsize

控制了JDBC每次读取数据的行数，默认为100。

*JDBC 每次读取的数据是会缓存在内存中的，建议合理配置，保证内存的充足。

*不适用于CLICKHOUSE，DORIS，STARROCKS，TiDB数据源。

事务隔离级别

控制数据源连接的事务隔离级别，此属性包含六个选项值，可在bi.properties通过conn.transaction.level配置控制此属性的全局设置。

•JDBC默认值（默认选中）：使用JDBC的处理方式；

•关闭事务：在不启用事务的情况下执行查询；

•脏数据读：允许读取其它事务正在更新的数据（conn.transaction.level=1）；

•防止脏数据读：如果读取的数据被锁定时，会等待（conn.transaction.level=2）；

•可重复读：读取数据时会锁定数据避免其它事务更新（conn.transaction.level=4）；

•串行：事务逐一执行（conn.transaction.level=8）。

开启limit

默认不勾选，点击勾选开启limit，在预览数据的时候会将limit拼在SQL当中执行。

*适用数据源：GENERIC

AutoCommit

将数据源连接的自动提交模式设置为给定状态。如果连接处于勾选，则它的所有SQL语句将被执行并作为单个事务提交。反之它的SQL语句将聚集到事务中，直到调用commit方法或rollback方法为止。9.2及之后版本默认勾选上了，9.2之前版本默认情况下为不勾选。

获取字段注释为

下拉选项中的值包括空、备注、别名，默认为备注。

•空：数据集端只是获取数据库中列的comment，但不作它用。

•备注：数据集端会获取数据库中列的comment作为备注，数据集上的显示详情请参考列备注。

•别名：数据集端会获取数据库中列的comment作为别名。

*不适用于HBASE，ELASTIC SEARCH数据源

别名类型

Teradata数据库有COMMENT和TITLE，可以选择在数据集端获取数据库中列的COMMENT或者TITLE来作为别名。

*适用数据源：TERADATA

队列名

*适用数据源：HIVE，SPARK，IMPALA，TRANSWARP，FUSIONINSIGHT HD

数据库编码

转换编码

数据库编码是数据库的编码；转换编码是转换成的编码。当编码不一致时可以设置这两项来转换编码。

*不适用于ANALYTICDB，DORIS，ELASTIC SEARCH，OCEANBASE，STARROCKS，TiDB数据源。

数据库字符集

设置指定字符集后，在从数据库中取数据的时候，数据库将解码后的字节码重新按设置的字符集格式编码数据，最后再将数据返回给客户端。目前支持选择为GBK或LATIN1。

*适用数据源：MYSQL、ANALYTICDB，DORIS，OCEANBASE，TiDB，STARROCKS。

数据库版本

数据源测试连接成功后，可以直接获取数据源的主版本号，并且有灰色文字说明返回的主版本号。