<< Click to Display Table of Contents >> 连接到SQL数据源复制链接 |
通用的连接到SQL数据源流程如下。
1.添加SQL数据源
在新建数据源页面选择某种SQL数据源点击进入新建页面:
2.SQL数据源配置信息介绍
2.1 基础属性
SQL数据源通常需要配置基础属性如图:
•按URL配置:
基础属性 |
说明 |
---|---|
驱动版本 |
默认驱动有默认关键字标识,未标识的驱动为自定义驱动。自定义驱动会列出驱动类型匹配的类,包括:同样类型的,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 |
认证方式 |
通常包含两种方式:用户名和密码、无身份验证。当数据库设定了访问权限后,用户需要使用用户名和密码来访问当前数据库。也支持Kerberos认证(比如Hive),集成身份认证(比如SSAS)。 |
开启SSL |
SQL数据源中MYSQL、CLICKHOUSE、ELASTIC SEARCH数据源支持SSL设置。MYSQL、CLICKHOUSE的SSL设置,详情请参考SSL设置。ELASTIC SEARCH的SSL配置,详情请参考ELASTIC SEARCH > SSL设置。 |
用户名 |
连接数据库所需要的用户名,DATA MART数据源为登录系统的用户名。 |
密码 |
连接数据库所需要的密码,DATA MART数据源为登录系统的密码。 |
租户模式 |
*适用数据源:OCEANBASE 连接数据库时的租户模式,包括MySQL模式和Oracle模式。 |
指定数据库 |
控制数据源下展示的数据库(Catalog)。输入要连接的数据库的名称,数据源下就只展示对应的数据库,如果此处不做指定,那将显示所有的数据库。 |
指定表结构模式 |
控制数据源下展示的表结构模式(Schema)。当选择一个表结构模式,数据源下就只展示指定的这一个,如果此处不做指定,那将显示所有的表结构模式。 |
•按服务器配置:
基础属性 |
说明 |
---|---|
服务器 |
数据源的服务器地址。 |
端口号 |
数据源的端口号。 |
默认数据库 |
默认数据库。 |
服务 |
连接数据源的服务器名或IP,适用于ORACLE数据源。 |
驱动版本 |
参考按URL的设置方式。
|
用户名 |
|
密码 |
|
租户模式 |
|
指定数据库 |
|
指定表结构模式 |
•基础属性
有些额外的基础属性数据源在建立连接的时候可以在书写URL中添加,有的基础连接属性在建立连接时不能通过URL中添加,可以点击“添加基础属性”按钮,自定义名称和值,添加基础属性:
2.2 认证方式
连接数据源支持多种认证,在配置数据源时点击这个选项的下拉选框可以选择多种认证方式。
•通常SQL数据源支持两种配置:用户名和密码认证,无身份验证;
•对于FUSIONINSIGHT HD、HIVE、SPARK、IMPALA、HBASE、PRESTO、TRANSWARP、TBDS、TBDS OLAP数据源,在原有的两种基础上额外支持两种配置:用户名认证,Kerberos认证,详细的Kerbero认证配置信息请参考Kerberos认证说明。
•适用于MYSQL数据源
MySQL数据源可以勾选开启SSL,设置SSL属性如图。
属性说明如下。
属性名称 |
说明 |
---|---|
服务器证书文件路径 |
服务器证书文件的路径。 |
客户端证书文件路径 |
客户端证书文件的路径。 |
客户端密钥文件路径 |
客户端密钥文件的路径。 |
需要SSL |
默认不勾选,通过SSL连接失败的话会自动转非ssl连接;勾选后,只能通过SSL连接数据库,连不上会报错 。 |
验证服务器证书 |
默认不勾选,勾选后,客户端会验证服务器的证书。 |
•适用于CLICKHOUSE
CLICKHOUSE数据源可以勾选开启SSL,设置SSL属性如图。
属性说明如下。
属性名称 |
说明 |
---|---|
服务器证书文件路径 |
服务器证书文件的路径。 |
客户端证书文件路径 |
客户端证书文件的路径。 |
客户端密钥文件路径 |
客户端密钥文件的路径。 |
SSL模式 |
支持两种SSL模式strict、none。 |
➢说明:
上传文件的类型与大小受ssl.certificate.file.type、file.upload.maxsize控制,详情请参考附录 > 安全配置。
2.4 选择转换时区
对于ELASTIC SEARCH、CTSDB和GREENPLUM数据源,支持配置转换时区。
输入数据存入数据库时的时区。如果数据存入数据库时,没有指定时区,可以不做选择。如果存入数据时,指定了时区,在这需要选择相应的时区对数据进行转换。
配置的时区会影响数据库生成的时间戳和一些函数返回的值。
2.5 高级属性
除了DATA MART以外的SQL数据源都支持高级属性的配置,高级属性通常是收起的,点击以展开。
展开的高级属性配置面板如下:
数据源开放提供配置数据库configuration properties的接口,点击添加高级属性图标会在高级属性内添加一行“名称”和“值”供用户进行自定义设置,可手工添加多个数据库属性。
SQL所有默认的高级属性详细含义如下:
高级属性 |
说明 |
---|---|
开启连接池 |
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。 |
数据库版本 |
数据源测试连接成功后,可以直接获取数据源的主版本号,并且有灰色文字说明返回的主版本号。 |
3.连接配置的数据源
3.1 测试连接
点击测试连接,提示测试成功,即该数据源成功连接到相应数据库。
3.2 保存连接
点击顶部工具栏的保存、另存为以保存当前配置的数据源。
创建数据集和制作报告模块都可以使用已保存的数据源。