PostgreSQL 驱动
dc3-driver-postgresql把一个 PostgreSQL 数据库当作数据源接入 IoT DC3——周期性执行SELECT查询把查到的值当采集值，并支持用位号上配置的UPDATE/INSERT写查询向库里写值。
不是所有数据都来自现场协议设备：很多业务数据、历史数据、第三方系统沉淀的结果，本身就躺在一张 PostgreSQL 表里。本驱动作为数据库客户端（驱动 类型 DRIVER_CLIENT），用 JDBC（org.postgresql.Driver）连到一个 PostgreSQL 库，按位号上配置的 SQL 去查值、写值。JDBC 连接的建立与查询执行由共享的 dc3-common-sql 抽象基类负责。适用于：把已有业务库里的字段当位号采集、对接只提供数据库视图的上游系统、把外部系统结果定时拉进平台。
下面先解释两个本驱动特有的概念，后面配置表会反复用到：
- 读查询（Read Query）：位号上配的一条
SELECT语句，驱动按采集周期执行它，取结果作为位号值。 - 写查询（Write Query）：位号上配的一条
UPDATE/INSERT语句，里面用一个?占位符代表要写入的值——向位号写值时，要写入的值会作为该参数绑定进去。
驱动名 / code / 类型
- 驱动名 / code：
PostgreSQL Driver/PostgresqlDriver - 类型：
DRIVER_CLIENT（驱动主动连库并发起查询）
驱动配置（设备级 driver-attribute）
把一个 PostgreSQL 库接进来时，在设备上填这些属性。它们决定连到哪个库、用什么账号、查询超时多久：
| 属性 | code | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
| Host | host | STRING | localhost | PostgreSQL host |
| Port | port | INT | 5432 | PostgreSQL port |
| Database | database | STRING | （空） | PostgreSQL database name |
| Username | username | STRING | root | PostgreSQL username |
| Password | password | STRING | （空） | PostgreSQL password |
| Query Timeout | queryTimeout | INT | 30 | SQL query timeout in seconds |
驱动用 host、port、database 拼出 JDBC URL（形如 jdbc:postgresql://host:port/database），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() 只读取并执行 writeQuery。executeQuery 这个属性保留在配置里，但当前驱动实现中没有任何代码读取或执行它——配了也不会生效。需要写值时，请把 SQL 配在位号的 writeQuery 上。
采集与健康
- 采集周期：默认 cron
0/30 * * * * ?（每 30 秒读一轮）。 - 自定义周期：驱动还有一个 custom 调度，默认 cron
0/5 * * * * ?（每 5 秒），供驱动自定义逻辑使用。 - 健康/在线：设备健康检查默认 cron
0/15 * * * * ?，租约超时45 秒——在线状态机制见设备。
最小接入示例
把一张 sensor 表里 id=1 那行的 temperature 字段当温度位号采进来：
- 选
PostgreSQL Driver创建设备，driver 属性填host=192.168.1.10、port=5432、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} 这类模板语法，那样既不会被替换、也失去防注入的好处。
库名/表名大小写敏感，按 PostgreSQL 规则写
PostgreSQL 对带双引号的标识符大小写敏感：不加引号的标识符会被折叠成小写，加了双引号则按字面大小写匹配。database 填错大小写连不上库，readQuery 里表名/列名大小写与实际不符也会查不到——按建库时的真实大小写填，必要时在 SQL 里用双引号包住标识符。