组件介绍
SQL数据库接口是把数据库数据作为数据来源的输入组件,通过查询数据库数据提供给其他组件进行数据处理。SQL数据库接口既可以通过定时触发,也可以通过上一级组件输出数据进行触发。
SQL数据库接口组件实际上是一个数据库SQL语句的构建器。组件提供两种方式构建SQL语句,一种是页面上选择配置参数进行SQL配置、一种是自定义原生SQL语句。
配置说明
参数名称 | 数据类型 | 是否必填 | 描述 |
---|---|---|---|
自定义SQL | Boolean | 是 | 构建SQL语句方式(SQL配置、自定义原生SQL) |
数据源 | Integer | 是 | 需提前在数据源管理模块创建数据库源,具体配置方法详见数据源配置 |
数据库表 | String | 否 | 选择数据库表 |
数据字段 | List<QueryColumn> | 否 | 选择数据库列,支持多选,默认不填则查询数据库表所有列 |
条件配置 | List<Clause> | 否 | 选择数据库列、条件规则、条件值,条件值可以是固定值,也可以是绑定上一级输出属性对应的输出值 |
排序配置 | Object | 否 | 选择数据库列、是否正序 |
分页配置 | Integer | 否 | 数据分页、设置offset、limit |
输出属性 | String | 否 | 对查询数据结果集进行包装,输出以Key:value格式,Key是输出属性、Value是查询数据结果集 |
输出格式 | Boolean | 否 | 输出格式分为数组和对象 |
自定义SQL字符串 | String | 否 (自定义SQL配置为True时为必填) | 编写SQL字符串。SQL查询条件需要绑定上一级时,使用?xxx表示绑定上一级输出属性xxx值 |
配置操作说明
- 点击左侧导航栏【数据引擎】->【数据引擎】,进入数据引擎列表页面;点击右侧【新增】按钮,新建数据引擎
- 点击操作栏的【配置】按钮,进入数据引擎编辑页面
- 从右上角设备输入栏中,点击设备输入的下拉框,鼠标按住SQL数据库接口不放,拖动组件进入画布中心,如下图
- 点击SQL数据库接口组件框右上角的【配置】按钮,进入配置页面,选择对应的SQL构建方式、数据源、数据库表、查询结果字段等。
数据源需提前在数据源配置中创建数据库连接。
- 图一的示例中,查询数据源的Machine_tool_equipment表中main_axle_load、fault_status2列字段,当running_status值等于ture时,按main_axle_load逆序的方式以数组格式输出。
- 图二示例中,查询数据源下Machine_tool_equipment数据表的所有列,以数组形式输出查询结果。
- SQL数据库配置完成后,点击右上角的【保存】按钮进行保存,也可点击右下角的【执行并保存】按钮启动该服务。选中SQL数据接口组件,可查看组件数据及日志。