数据连接配置
进行数据分析的前提条件是获取数据,用户可通过数据连接配置来定义数据来源。实际用户系统最常见的是将数据保存在数据库中,并且不断更新。BPI系统可通过JDBC方式接入数据库中的数据,通过API方式连接服务器文件。
新建JDBC连接
新建一个JDBC连接,请按照以下步骤进行操作。
在导航栏中依次点击业务感知分析>数据准备>数据连接配置,进入数据连接配置页面。
点击页面右上角的新建连接按钮,进入数据连接配置页面。
配置基本信息。
- 数据连接名称:仅支持中英文字符、下划线、数字,最多可输入20个字符;必填项。
- 连接类型:选择JDBC连接。
- 数据库类型:可选择MySQL、IBM DB2、Microsoft SQL Server、Oracle、PostgreSQL。
- 主机:要连接的IP,必填项。
- 端口:要连接的端口号,必填项。
- 用户名称:数据库访问用户名,必填项。
- 登录密码:数据库访问密码,必填项。
- 服务名称:要连接的数据库名称。
- 数据连接URL:该URL是根据用户填写的连接类型、数据库类型、主机、端口、数据库名称自动生成的,用户不需要填写。
- 编码方式:可选择UTF-8、GBK。
用户可选择配置以下高级设置信息,默认为关闭状态,开启后可展开配置项。
初始化连接数:连接池启动时创建的初始化连接数量。默认为0。
最大活动连接数:连接池在同一时间能够分配的最大活动连接的数量,如果设置为非正数则表示不限制。默认为8。
最大空闲连接数: 连接池中容许保持空闲状态的最大连接数量,超过的空闲连接将被释放,如果设置为负数表示不限制。默认为8。
最小空闲连接数:连接池中容许保持空闲状态的最小连接数量,低于这个数量将创建新的连接,如果设置为0则不创建。默认为0。
最大等待时间:当没有可用连接时,连接池等待连接被归还的最大时间(以毫秒计数),超过时间则抛出异常,如果设置为 -1 表示无限等待。默认为-1。
SQL验证查询:用来验证从连接池取出的连接,在将连接返回给调用者之前如果指定,则查询必须是一个 SQL SELECT 并且必须返回至少一行记录。
获取连接前检验:指明是否在从池中取出连接前进行检验,如果检验失败,则从池中去除连接并尝试取出另一个。默认为是。
归还连接前检验:指明是否在归还到池中前进行检验。默认为否。
配置完成后,点击右下角的测试连接按钮测试连接状态。
点击右下角的新建数据表按钮,用户可选择通过配置的连接创建SQL表或DB表。
点击确定保存当前连接。
新创建的JDBC连接将展示在连接列表中。
新建API连接
新建一个API连接,请按照以下步骤进行操作。
在导航栏中依次点击业务感知分析>数据准备>数据连接配置,进入数据连接配置页面。
点击页面右上角的新建连接按钮,进入数据连接配置页面。
配置基本信息。
数据连接名称:仅支持中英文字符、下划线、数字,最多可输入20个字符;必填项。
连接类型:选择API连接。
连接地址:输入文本数据的请求地址,必填项。
文件格式:仅支持JSON格式。
请求类型:可选择GET/POST,两种参数传递方式不一样,GET是将请求参数拼接到 URL 上,POST 是放到 HTTP 请求体中,并且 POST 模式的参数需要自己添加;默认选择“GET”。
编码方式:可选择UTF-8、GBK。
缓存有效期:默认缓存时间为 0 ,表示不启用,且支持集群,可以有效的提升 JSON 数据集的效率。设置缓存时间后,将在首次连接后进行缓存(支持集群),缓存有效期内读取的结果均为缓存内容,不随请求接口数据变化而变化。
请求参数设置:设置数据请求的参数,适用场景说明如下。
- head(请求头):在 header 中,设置 Content-Type 为 Application/json ,表示客户端告诉服务器实际发送的数据类型为 JSON 格式。
- body(请求体):定义一个普通参数num,值为book,请求方式为POST_FORM。
- 点击参数列表右上角的添加参数在列表中增加一行,用户可做以下设置。
- 参数位置:可选择head、body,默认选中head。
- 参数名:仅支持英文、数字、下划线,最多可输入20个字符,区分大小写,且不可重名,必填项。
- 参数值:用户设置请求的参数返回值,最多可输入30个字符,必填项。
- 点击删除可删除当前参数行。
- 当前页最多显示5条参数。
配置完成后,点击右下角的测试连接按钮测试连接状态。
点击右下角的新建数据表按钮,用户可选择通过配置的连接创建文件表。
点击确定保存当前连接。
新创建的API连接将展示在连接列表中。
数据连接列表
在导航栏中依次点击业务感知分析>数据准备>数据连接配置,进入数据连接配置页面。该页面展示当前用户权限范围内的所有数据连接。列表内容包含以下字段:
序号:连接的编号,按用户最后一次创建/修改时间倒序排列。
连接名称:唯一字段区分不同数据连接。
连接类型:显示数据连接类型,包括JDBC、API两种类型。
连接URL:显示数据连接URL。
关联数据表:显示当前正在使用该连接的数据表个数,点击数值后可查看关联的数据表。点击数据表名称后可进行编辑。
连接状态:显示当前连接的最新状态,包括成功和失败2个状态。
测试:测试数据连接是否成功。
操作:对数据连接进行以下操作。
编辑:点击后进入连接编辑页面。
删除:点击后删除该连接,引用次数不等于0时按钮不可用。
复制:点击后复制该连接,在列表第一行创建一个连接副本。
说明:仅有读写权限的用户有以上功能,只读权限的用户按钮不可用。
查询:用户可根据数据连接名称模糊查询,也可单选连接类型进行过滤,点击查询按钮后可查看结果。