MySQL 驱动
dc3-driver-mysql把一个 MySQL 数据库当作数据源接入 IoT DC3——周期性执行SELECT查询把查到的值当采集值，并支持用位号上配的UPDATE/INSERT写查询向库里写值。
不是所有数据都来自现场协议设备：很多业务数据、历史数据、第三方系统沉淀的结果，本身就躺在一张 MySQL 表里。本驱动作为数据库客户端（驱动 类型 DRIVER_CLIENT），用 JDBC（mysql-connector-j）连到一个 MySQL 库，按位号上配置的 SQL 去查值、写值。JDBC 连接的建立与查询执行由共享的 dc3-common-sql 抽象基类负责。适用于：把已有业务库里的字段当位号采集、对接只提供数据库视图的上游系统、把外部系统结果定时拉进平台。
下面先解释两个本驱动特有的概念，后面配置表会反复用到：
- 读查询（Read Query）：位号上配的一条
SELECT语句，驱动按采集周期执行它，取结果作为位号值。 - 写查询（Write Query）：位号上配的一条
UPDATE/INSERT语句，里面用一个?占位符代表要写入的值——写命令触发时，命令参数会作为该参数绑定进去。
驱动名 / code / 类型
- 驱动名 / code：
MySQL Driver/MysqlDriver - 类型：
DRIVER_CLIENT（驱动主动连库并发起查询）
驱动配置（设备级 driver-attribute）
把一个 MySQL 库接进来时，在设备上填这些属性。它们决定连到哪个库、用什么账号、查询超时多久：
| 属性 | code | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
| Host | host | STRING | localhost | MySQL host |
| Port | port | INT | 3306 | MySQL port |
| Database | database | STRING | （空） | MySQL database name |
| Username | username | STRING | root | MySQL username |
| Password | password | STRING | （空） | MySQL password |
| Query Timeout | queryTimeout | INT | 30 | SQL query timeout in seconds |
驱动用 host、port、database 拼出 JDBC URL（形如 jdbc:mysql://host:port/database?...），host、port、database、username、password 五项均为必填——缺任一项，设备配置校验都不会通过。
位号配置（point-attribute）
每个采集位号上填它对应的读/写 SQL：
| 属性 | code | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
| Read Query | readQuery | STRING | （空） | SQL SELECT query for reading point value |
| Write Query | writeQuery | STRING | （空） | SQL UPDATE/INSERT using a single ? placeholder for the written value (bound as a parameter) |
Read Query 取结果的第一个值
readQuery 是一条普通 SELECT，驱动取其结果中的第一个值作为该位号的值——所以写成 SELECT temperature FROM sensor WHERE id = 1 这种只返回单行单列的查询最稳妥。位号的数据类型（Point 的 pointTypeFlag）决定这个值如何被解析。readQuery 是位号的必填项，缺了位号校验不通过。
写命令配置（command-attribute）
写命令上可以配这个属性：
| 属性 | code | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
| Execute Query | executeQuery | STRING | （空） | SQL query to execute for command |
executeQuery 当前未被实现消费
写值走的是位号上的 writeQuery：write() 取 point-attribute 的 writeQuery，用预编译参数绑定执行 UPDATE/INSERT。command-attribute 上的 executeQuery 仅作为配置项保留，当前驱动代码中没有任何地方读取或执行它——不存在"按命令直接执行一段 SQL"的独立路径，写值一律走 writeQuery。
采集与健康
- 采集周期：默认 cron
0/30 * * * * ?（每 30 秒读一轮）。 - 自定义周期：驱动还有一个 custom 调度，默认 cron
0/5 * * * * ?（每 5 秒），供驱动自定义逻辑使用。 - 健康/在线：设备健康检查默认 cron
0/15 * * * * ?，租约超时45 秒——在线状态机制见设备。
最小接入示例
把一张 sensor 表里 id=1 那行的 temperature 字段当温度位号采进来：
- 选
MySQL Driver创建设备，driver 属性填host=192.168.1.10、port=3306、database=iot、username=root、password=******。 - 给设备绑定的物模型加一个温度位号（
pointTypeFlag=FLOAT、READ_ONLY），point 属性填readQuery=SELECT temperature FROM sensor WHERE id = 1。 - 启动驱动，30 秒内就能在位号值里看到查到的温度值。
易错点
Read Query 必须是只读且能定位到单值
驱动取 readQuery 结果的第一个值，所以查询要返回单行单列、且能稳定定位到目标行（带 WHERE 主键条件）。返回多行/多列时只会取到第一个，结果可能不是你想要的那条；别在 readQuery 里写 UPDATE/DELETE，采集是只读路径。把过滤条件写全，避免随表数据变化取到错行。
Write Query 用 ? 占位符，不是 ${value}
写值时 writeQuery 里用一个 ? 占位符代表写入值（如 UPDATE sensor SET temperature = ? WHERE id = 1），驱动会把命令参数作为 JDBC 参数绑定进去——这是预编译参数绑定，不是字符串拼接。不要在 SQL 里手动拼接值，也不要用 ${value} 这类模板语法，那样既不会被替换、也失去防注入的好处。
查询超时按 queryTimeout 秒生效
queryTimeout（默认 30 秒）作用在每次 SQL 执行上。位号对应的查询若涉及大表或慢 SQL，可能在采集周期内还没返回就被超时打断——这时应优化 SQL 或加索引，而不是一味调大超时。