自定义连接器包括自定义驱动和自定义数据源,当BI内置的驱动无法适配您的数据库版本时,可通过自定义驱动的方式进行驱动替换和数据源连接;当需要对接BI标准支持数据库范围之外的各类数据库时,可通过自定义数据源进行自助式数据源接入。本文为您介绍自定义连接器的使用方法。
背景介绍
自定义驱动:自助式数据源版本兼容,当BI内置的驱动无法适配您的数据库版本时,可通过自定义驱动的方式进行驱动替换和数据源连接。
自定义数据源:自助式数据源接入,通过自定义连接器,对接BI标准支持数据库范围之外的各类数据库(必须与已支持方言的语法类型一致)。
前提条件
只有组织管理员才能进入自定义连接器界面,配置自定义驱动和自定义数据源,若其他角色想要拥有相应权限,可自定义角色并赋予相应的权限。
自定义驱动
使用限制
通过自定义驱动连接的数据源不支持数据准备、加速引擎、跨源关联。
操作步骤
您可以按照图示步骤进入自定义驱动管理界面。
单击上传驱动。
在上传驱动界面选择文件、输入驱动名称并选择数据源类型。
配置项
说明
请选择文件
用户自定义的名称,只支持上传.jar、.zip格式的文件,文件大小不超过100M。
驱动名称
驱动名称默认与文件名称一致(去掉后缀),支持修改。
数据源类型
选择该驱动对应的数据源类型。
您可以在对应的数据源类型中选择相应的驱动,完成数据源的创建。
管理自定义驱动
您可以对自定义驱动进行重命名(①)、替换文件(②)和删除(③)操作。
单击操作列的图标,编辑驱动名称。
单击操作列的图标,替换驱动文件。
单击操作列的图标,在弹出的二次确认框中单击确定后删除驱动文件。
自定义数据源
使用限制
自定义数据源不支持SSH、上传文件、Quick引擎、自定义周、数据准备、数据填报和复杂表格填报,其他支持的功能项与方言类型一致,具体请参见数据源功能项列表。
操作步骤
您可以按照图示步骤进入自定义数据源管理界面。
单击新建连接器。
在新建连接器界面,进行以下配置。
配置项
说明
连接器名称
输入连接器名称。
连接器Logo
上传本地图片作为连接器的Logo。
说明图片大小限制为2M,不支持GIF格式。
驱动文件
支持 .jar、.zip 格式的文件,文件大小限制为100M。
方言类型
支持Mysql、PostgreSql、Orcale、Sql Server。
驱动类
输入驱动类类名,例:com.mysql.jdbc.Driver
说明长度限制为150字符,不支持英文、数字、点、下划线等特殊字符。
连接串
jdbc:{方言类型}://<host_port>/<database>,例:jdbc:mysql://<host_port>/<database>
说明长度限制为100字符,不支持英文、数字、英文冒号、斜线(/)、下划线、@、尖括号等特殊字符。
其中:<host_port>和<database>为占位符,在数据源连接时输入配置项即可,连接串会替换为对应的内容;
<host_port>指数据库地址和端口,如:127.0.0.1:3306
<database>为数据库名,如:test_db
若您需要连接的数据源,连接串存在特殊逻辑,可以在此处修改,请保证占位符<host_port>和<database>书写正确。
参数连接符
支持选择英文问号(?)和英文分号(:)。
参数分隔符
支持选择&和英文分号(:)。
创建完成后,您可以在新建数据源时选择自定义数据源进行配置。
管理自定义数据源
您可以对自定义驱动进行编辑(①)和删除(②)操作。
方言类型不支持编辑。