知行之桥 EDI 系统功能介绍—— Mysql端口配置文档Select篇

知行之桥 MySQL端口-Select配置文档

一、功能背景

MySQL 端口中的 Select 操作用于从 MySQL 数据库中查询数据，并将查询结果输出为 XML 消息，供工作流下游端口（如 XML Map、EDI、File 等）进一步处理。

典型使用场景

与 Upsert / Lookup / 存储过程类操作的分工

关于 Upsert 和 Lookup 的详细配置，请参考对应的专项文档。

二、建立连接

使用 MySQL 端口前，需要先创建 MySQL 连接。连接创建后可以被多个 MySQL 端口复用。

2.1 添加 MySQL 端口

进入工作流页面，鼠标右键选择“添加端口”，搜索并选择 MySQL，填写端口 ID，创建Mysql端口。

2.2 创建连接

进入 MySQL 端口的设置页面，在“连接” 下拉框旁点击“添加新连接”。

也可以从全局入口创建：

系统设置 > 连接 > 添加连接 > MySQL

2.3 填写连接信息

填写完成后点击右上角的 添加并测试，如果连接有问题，则会在右下角报错，反之如果连接成功，则会跳转回设置界面。

三、Select：从 MySQL 查询数据

Select 用于从 MySQL 中查询记录，并将查询结果输出为 XML。它通常放在工作流开头。

3.1 适用场景

3.2 基本配置步骤

本文示例以订单主表（test_order_header） 和订单明细表（test_order_item） 为例，演示如何通过 Select 同时查询主表和明细表，并输出为嵌套 XML。

查询目标：

最终输出的 XML 结构为：一个订单头下挂载其对应的所有订单明细行。

基本配置步骤：

1. 打开 MySQL 端口。
2. 在设置界面选择已创建的 MySQL 连接或者创建新连接。

1. 进入Action界面，操作选择 Select，然后点击 添加表结构。

1. 选择结构类型：父表和子表，或联接表，本次示例选择父表和子表。

5. 选择你要select的表，先选择父表（test_order_header），然后在右侧点击添加子项表，勾选子表（test_order_item）。

添加完成后，点击右下角应用，返回端口主界面，此时就能看到已选中的父表和子表结构了。

6. 添加主表过滤条件。

将鼠标悬浮在要添加条件的表名上，点击表选项

选择表设置，进入编辑界面

点击过滤器，选择添加过滤器

本示例要查询 status = 0 的数据，按下图配置过滤条件：

配置完成后点击 应用。

1. 添加子表过滤条件子表（test_order_item）需要通过 header_id 字段关联到父表（test_order_header）的 id 字段，以确保每个子表记录只属于其对应的父表记录。 如下图所示，添加过滤器，先在左边下拉框选择子表的header_id列，然后在最右边选择REF，中间的运算符选择相等，最后在运算符右边栏位选择父表的id列。

配置说明：上述配置生成的 SQL 关联条件等价于 test_order_item.header_id = test_order_header.id。选择 REF 而非 CONST（常量值），是因为 header_id 需要动态匹配每条父表记录的 id，而非固定值。

1. 代码视图和预览数据点击来源处的蓝色表名test_order_header，即可重新进入添加表结构界面

点击右上角的代码视图，则可以查看当前配置完成的select代码

点击右上角的预览XML，则可以预览select查询的结果

1. 读取后更新表状态在添加表结构界面，勾选更新复选框，选择列 status，填写值为 1。这样查询完成后，test_order_header 表中被查到的记录会自动将 status 更新为 1。该更新发生在 MySQL Select 成功提取记录时，不代表下游端口已全部处理成功。

本示例仅更新父表状态位，子表状态如需同步更新，需要单独在代码视图处进行设置。

1. 全部配置完成后，点击右上角的保存按钮，然后在事务界面，点击接收文件 即可读取订单数据。

3.3 结构类型

Select 支持两种常见结构类型。

3.4 当前 TEST_MySQL 的 父表和子表 Select 示例

当前 TEST_MySQL 端口中的 Select 代码 模板如下图：

重点说明：

输出 XML 示例：

<Items>
  <test_order_header>
    <id>1</id>
    <buyerNo>BUYER001</buyerNo>
    <poNo>PO20260827001</poNo>
    <status>0</status>
    <test_order_item>
      <id>10</id>
      <header_id>1</header_id>
      <poLineNo>1</poLineNo>
      <quantity>100</quantity>
    </test_order_item>
  </test_order_header>
</Items>

四、自动化与测试

Select 端口配置完成后，可以通过手动接收进行测试，也可以在“自动化”页面设置定时查询数据库。

4.1 手动测试 Select

第一次配置完成后，建议先手动测试，不要马上开启自动化。

操作步骤：

1. 确认 MySQL 连接测试成功。
2. 确认 Select 表结构、父子表关系和过滤条件已保存。
3. 进入端口的事务页面。
4. 点击右上角的接收文件。
5. 查看事务列表中是否生成新的输出记录。
6. 点击输出文件，检查生成的 XML 内容是否符合预期。

如果输出成功，说明 MySQL 端口已经可以按当前 Select 配置从数据库读取数据。

4.2 查看输出 XML

Select 成功后，MySQL 端口会将查询结果输出为 XML。对于父表和子表结构，输出通常是嵌套结构。

示例：

<Items>
	<test_order_header>
		<id>1</id>
		<buyerNo>B01</buyerNo>
		<currency>USD</currency>
		<poDate>2026-08-25T11:36:05.0000+08:00</poDate>
		<poNo>PO001</poNo>
		<status>0</status>
		<test_order_item>
			<id>2</id>
			<buyerItemNO>ITEM001</buyerItemNO>
			<header_id>1</header_id>
			<poLineNo>1</poLineNo>
			<quantity>1000</quantity>
			<requestDeliveryDate>2026-09-30T11:36:39.0000+08:00</requestDeliveryDate>
			<status>0</status>
		</test_order_item>
	</test_order_header>
</Items>

检查输出 XML 时，重点确认以下内容：

4.3 配置自动接收

手动测试成功后，可以配置自动化，让 Select 端口定时从 MySQL 查询数据。

进入自动化界面，勾选启用自动接收，开启后，端口会按设定的接收间隔自动查询 MySQL 数据源。支持多种调度模式

五、高级设置与优化

5.1 输出与批量设置

以下设置在 Select 场景中较为常用，决定查询结果如何输出。

本地文件名格式常用宏示例：

示例命名：

MysqlSelect_%ShortDate%_%MessageId%

5.2 连接池设置

连接池管理数据库连接的复用，减少每次查询创建新连接的开销。

5.3 日志与排查设置

日志设置影响问题排查效率，尤其是 SQL 条件、父子表关联和状态位更新问题的定位。

排查 Select 问题时，建议先临时将日志级别改为 Debug，手动点击“接收文件”，然后在事务日志中查看实际执行的 SQL，确认查询条件是否正确。

六、查看事务日志

在 MySQL Select 端口的事务页面，可以查看每次手动接收或自动接收产生的记录。它是排查 Select 问题最常用的位置。

6.1 查看 Select 输出文件

Select 查询成功后，事务页面会生成一条记录。点击文件名，可以查看或下载输出 XML。

重点查看：

6.2 查看日志详情

展开事务记录后，可以查看端口本次执行的详细日志。排查时重点关注以下内容：

提示：如果日志内容不够详细，可以临时将日志级别改为 Debug 后重新测试。问题确认后再改回 Info。

七、常见问题与排查思路

7.1 测试连接失败

可能原因：

• MySQL 服务未启动。
• Server 或 Port 填写错误。
• 防火墙未开放。
• 用户名或密码错误。
• Database 名称不存在。
• 数据库用户没有远程访问权限。

排查建议：

1. 使用 MySQL 客户端在知行之桥服务器上测试连接。
2. 确认端口是否为 3306 或实际 MySQL 端口。
3. 确认 MySQL 用户是否允许远程登录。
4. 确认用户是否有目标表的 SELECT 权限。

7.2 Select 没有输出

可能原因：

• 过滤条件过严，数据库中没有符合条件的数据。
• status = 0 的数据已经被处理成 status = 1。
• 表或字段选择错误。
• 自定义 SQL 在 MySQL 中本身查不到结果。

排查建议：

1. 先把 Select SQL 放到 MySQL 客户端中执行。
2. 确认数据库中存在符合条件的数据。
3. 临时去掉部分过滤条件，缩小问题范围。
4. 检查是否开启了处理后更新状态位。

7.3 子表数据不正确

如果子表输出过多、过少或和父表对不上，通常是父子表关联条件有问题。

重点检查：

7.4 读取后状态没有更新

如果配置了读取后更新 status，但数据库中状态没有变化，可以按以下方向排查：

7.5 查看日志

排查 Select 问题时，可以临时将日志级别改为 Debug，然后重新点击“接收文件”。

日志中重点查看：

八、总结

MySQL Select 端口的作用是从 MySQL 数据库中查询数据，并将结果输出为知行之桥可以继续处理的 XML。

配置 Select 时，建议按以下顺序操作：

1. 先创建并测试 MySQL 连接。
2. 在 Action 页面选择 Select。
3. 先选择父表，再根据业务需要添加子表。
4. 为父表添加业务过滤条件，例如 status = 0。
5. 为子表添加关联条件，例如 header_id = ${id}。
6. 如需避免重复拉取，可配置处理后更新状态位。
7. 先手动点击“接收文件”测试，再开启自动化。
8. 出现问题时，查看事务日志和实际执行 SQL。

对于订单头和订单明细这类一对多业务，推荐使用“父表和子表”结构；对于报表类或扁平数据输出，可以使用“联接表”结构。