数据库查询
组件介绍
组件图标
组件作用
数据库查询组件允许您查找数据库表中的值。查找值将作为新字段添加到流中。
输入输出描述
- 输入：数据库连接
- 输出：连接查询的结果
页面介绍
双击数据库查询组件得到下图所示的界面：
参数选项
“数据库查询”组件页面包含如下选项：
| 选项 | 说明 | 样例值 |
|---|---|---|
| 步骤名称 | 在画布上指定“数据库查询”步骤的唯一名称，可以自定义名称或保留默认名称。 | 数据库查询 |
| 数据库连接 | 数据库连接到查找表。 | |
| 模式名称 | 包含查找表的数据库架构。 | |
| 表名 | 于查找的数据库表的名称。 | |
| 使用缓存 | 启用数据库查找的缓存。这意味着一旦查找了一个键（或一组键），将存储查找的值，并在下次查找该键（或一组键）时再次返回。 | |
| 缓存大小 | 缓存的大小（行数），0表示缓存所有内容。 | |
| 从表中加载所有数据 | 将查询表中存在的所有数据预加载到缓存中。通过避免数据库调用，可以提高性能。但是，如果表很大，则存在内存不足的风险。 | |
| 查询所需的关键字 | 执行数据库查找的键和条件。 | |
| 查询表返回的值 | 查找表中要添加到输出流中的字段。如果数据库列名称不合适，则可以使用“新名称”使用其他名称。“默认”是在查找失败时返回的值（而不是null）。请注意，在“数据库查找”步骤中启用错误处理会将所有失败的查找行重定向到错误处理步骤，而不是将它们添加到具有空值/默认值的主输出流中。“类型”是输出字段的类型。 | |
| 查询失败则忽略 | 启用以避免在查找失败时避免传递行。在SQL语法内，启用此选项将是INNER JOIN，否则将是OUTER JOIN。 | |
| 多个结果时失败 | 如果查询返回多个结果，则启用该选项可强制步骤失败。 | |
| 排序 | 如果查找查询返回多个结果，则ORDER BY子句可帮助您选择要采用的记录。 |
案例示例
本案例用“自定义常量数据”生成了 张三、李四、王五 三位学生的成绩，希望通过数据库查询的方式知道他们的分数是及格、良好亦或是优秀:
输入输出结果对比预览：
无
案例数据
表数据与结构：score_level.sql
该文件共包含100条数据
| 列名 | 说明 |
|---|---|
| score | 成绩 |
| level | 等级 |
案例操作
该步骤为数据库查询提供查询数据
该组件配置 主要分 2 步：
- 第一步：填写字段信息
- 第二步：填写数据信息
② 数据库查询
该步骤查询出张三、李四和王五的成绩的等级
该组件配置主要分 4 步：
- 第一步：新增一个数据库连接；
- 第二步：输入数据库信息-一般；
- 第三步：输入数据库信息-选项（serverTimezone=Asia/Shanghai）；
- 第四步：选择刚刚添加的数据库连接后，选择表名、关键字和返回值；
结果预览
最终结果如下：
常见问题
无