关系数据源连接是指通过“数据库驱动程序”连接一个本地或远程的关系数据库。
操作入口
1、选择系统导航栏的 数据连接，或者选择系统快捷菜单 数据连接
，如图：
2、在“数据连接”界面主菜单选择 关系数据库
| borderColor | #BBBBBB |
|---|---|
| bgColor | #F0F0F0 |
| borderWidth | 1 |
| borderStyle | solid |
界面介绍
我们在新建关系数据源或是打开数据源，可以看到下面如图的连接信息。
各配置项说明如下：
配置项 | 说明 | |
|---|---|---|
名称 | 新建的数据源的标示名，必须唯一。 | |
别名 | 新建的数据源显示的名称。 | |
驱动程序类型 | ||
用户选择连接的数据库的类型。 关于支持的关系数据库类型，详情请参考 系统环境要求。 其中：
| |
| 驱动程序存放目录 | |
驱动程序存放目录分为“产品内置”和“自定义”。默认为“产品内置”。 驱动包使用的优先级逻辑如下： 1、首先在动态目录smartbiDynamicLib下的自定义目录查找； 其中，各目录路径如下：
| ||||||||
驱动程序类 | 用户选择好连接的数据库的类型的后，系统自动生成驱动程序类。 | |||||||
连接字符串 | 用户选择好连接的数据库的类型后，系统自动生成相应的连接字符串，用户需要把其中的“<servername>”和“<database>”分别换成连接数据源所在的服务器和数据库的名称。 | |||||||
| 链接方式 | 用于设置连接数据库的链接方式，默认为用户名密码，部分数据源可选择Kerberos认证方式。注：Huawei FusionInsight HD数据源的链接方式默认为Kerberos认证。 | |||||||
| 用于设置用户名和密码的验证类型，包含两种静态和动态。 静态：输入连接数据库的用户名和密码。 动态：如要用于连接的用户名和密码是根据登录的用户而动态变化。比如Oracle数据库，不同的用户名对数据库的表的权限是不一样的。选择动态的验证类型，需要从左侧资源树下拖拽“系统函数”或是“用户属性”来作为表达式，实现不同的用户登录设置连接数据库的用户名和密码是动态变化的。 详情查看：动态说明 | |||||||
用户名 | 用户登录所选数据库的用户名。 | |||||||
密码 | 用户登录所选数据库的密码。 | |||||||
| 高级 | 数据库源字符集 | 选择与数据库对应的字符集。一般情况下不需要设置。具体参见字符集。 | ||||||
数据库目标字符集 | 设置为与数据库对应的字符集。一般情况下不需要设置。具体参见字符集。 | |||||||
最大连接数 | ||||||||
新建的数据源允许同时登录的最多用户数。
校验语句
数据源连接进行校验的SQL语句。包含下面几种方式，默认为获取连接时测试。
- 获取连接时测试：获取连接池时进行SQL语句测试，每一次查询的时候，都会从连接池拿到一个空闲连接，先执行配置的校验语句去执行，判断这个连接是否可用，若不可用则会重新获取一个连接。
- 返还时测试：返还连接池时进行SQL语句测试，顾名思义，当执行完查询后，将连接返还给连接池时去执行校验语句，判断这个连接是否可用。
- 获取、返还时测试：获取、返还连接池时都要进行SQL语句测试，执行以上两个步骤。
- 返还时关闭连接：返还时关闭连接池，每一次查询的时候，都会新建一个数据库连接，查询完毕后，会关闭这个连接，同时提交事务，会对性能有一定影响。
- 不测试连接：不进行SQL语句连接，执行查询时，不进行测试连接是否可用。
通常用的是获取连接时测试，特殊情况下会用返还时关闭连接，其它几种基本上用不到。
当数据源启动连接池时，连接池中最多能包含多少个数据库连接。 | |
连接池等待时间(秒) | 当连接池满时，再获取等待的时间，若没有获取到就提示。 默认值为“－1”，表示无限等待。 |
校验语句 | 数据源连接进行校验的SQL语句。 注：因安全问题，校验语句当前仅支持一条语句或留空，非空时必须是以 select 开头的语句，如：select 1 包含下面几种方式，默认为获取连接时测试。
“返还时关闭连接”不启用连接池，其他设置项需要启用连接池。 |
事务隔离级别 | 事务隔离级别用于保证并发读取数据的正确性，下面列出各种事务的隔离级别说明，默认选择为JDBC默认值。需注意的是在选择下面事务级别时，需保证所选择的数据库本身是支持的。 |
|
| |||
| 引用标识符 | 表示是否在表名、字段名外添加一个引号。主要用于一些库中的表可能有特殊符号，不添加引号可能会出错。 应用于自助数据集：设置引用标识符的数据想应用于自助数据集时，需要勾选此设置项。
| ||
描述 | 添加数据源的备注信息。 |
设置好数据源连接的配置项后，必须要先进行 设置好数据源连接的配置项后，可以先进行 测试连接 操作，只有在测试连接通过后才允许保存填写完。 操作，测试连接通过后，再保存。
关系数据源连接成功后，即在资源目录的“数据源”节点下显示出该关系数据源的内容。如下图：关系数据源连接成功后，即在资源目录区的“数据源”节点下显示出该关系数据源的内容。如下图：
| 锚 | ||||
|---|---|---|---|---|
|
驱动程序类型是指用户选择连接的数据库的类型。系统支持连接的关系数据库类型有：ODBC数据源和JDBC数据源。
注意：
驱动程序类型是指用户选择连接的数据库的类型。
为了便于检查数据源连接方面的问题，下面列出各个关系数据库对应的JDBC驱动的jar文件名：
数据库名称 | Jar包名称 | 备注 |
|---|---|---|
SQL Server | sqljdbc.jar | SQL Server 2005 |
msbase.jar | SQL Server 2000 | |
mssqlserver.jar | ||
msutil.jar | ||
MySQL | mysql.jar |
Oracle | Classes12.zip | Oracle9i |
classes12.jar | Oracle10g | |
Db2 | db2java.zip |
db2jcc.jar |
db2jcc_license_cu.jar |
sybase | jconn2d.jar |
Kingbase | kingbasejdbc4.jar |
informix | ifxjdbc.jar |
NCR Teradata | teradata.jar | Ncr 2.5 |
terajdbc4.jar | Ncr 2.5/2.6 | |
tdgssjava.jar | Ncr 2.6 | |
PostgreSQL | postgresql.jar |
Greenplum | postgresql.jar |
| 锚 |
|---|
用于设置数据库连接时的用户名和密码。主要包含静态和动态两种。
静态：输入连接数据库的用户名和密码。
动态：如要用于连接的用户名和密码是根据登录的用户而动态变化。比如Oracle数据库，不同的用户名对数据库的表的权限是不一样的。
我们可以在连接数据源的时候，选择动态的验证类型，然后从左侧资源树下拖拽系统函数或是用户属性来作为表达式，实现不同的用户登录设置连接数据库的用户名和密码是动态变化的。
示例
动态验证类型通常有如下两种适用情况：
| 适用情况描述 | 设置方法 |
|---|---|
| 当数据库用户与smartbi用户是完全同步：名称和密码都完全一致。 我们只需要通过系统函数“CurrentUserName()” |  |
若数据库用户与smartbi用户未完全同步，则可以通过以下方式实现动态： 1、结合系统函数定义用户属性来获取当前用户名称； 2、结合系统函数定义用户属性，根据当前用户在用户表中获取密码； | 1、创建数据源连接，连接用户表所在的数据库：
2、基于该数据源定义获取用户名称的用户属性：
3、基于该数据源定义获取密码的用户属性：
4、利用以上用户和密码的用户属性实现动态数据源连接设置：
|
| 锚 | |||
|---|---|---|---|
|
目前在进行数据源设置的时候可以指定数据库源字符集和数据库目标字符集。一般情况下不需要设置，只有在数据库展示出现乱码的时候，才有可能需要对这些数据集进行设置。
- 数据源字符集：在获取数据库数据时，指定数据库的字符集。一般为数据库的字符集。
- 数据源目录字符集：在展示数据时，指定展示时的字符集。一般为服务器的字符集。数据源目标字符集：当出现乱码时，目标字符集和数据库本身的编码组合测试，直到找不到不乱码的组合。
