IRIS框架不原生支持PostgreSQL，需通过ODBC驱动（如PostgreSQL ODBC Driver(UNICODE)）桥接访问；必须在系统层安装驱动、配置DSN，并使用%SYS.OdbcConnection类手动建立连接与执行SQL，不支持Spring Boot式YAML配置或Studio图形化直连。
IRIS框架不直接支持PostgreSQL，得靠ODBC桥接
IRIS本身是InterSystems自家的数据库平台，底层用的是专有存储引擎，不是关系型数据库适配器。它原生不提供PostgreSQL驱动或DataSource配置项。想让IRIS应用访问PostgreSQL，必须走标准中间层：ODBC。这不是“集成”，而是“连接外部数据源”，本质是让IRIS当客户端，通过ODBC驱动跟PostgreSQL通信。
常见误区是以为能像Spring Boot那样在application.yml里加个spring.datasource.url就完事——IRIS没这机制。它的数据源抽象只面向自身命名空间或通过%SYS.OdbcConnection这类类间接调用ODBC。
- 必须提前在操作系统层面安装
psqlODBC驱动（推荐UNICODE版，如PostgreSQL ODBC Driver(UNICODE)） - IRIS进程需有权限读取ODBC配置（Windows下检查系统DSN，Linux下确认
odbcinst.ini和odbc.ini路径与权限） - IRIS 2021.1+才较稳定支持64位psqlODBC；老版本IRIS（如2019.1）连42.x驱动会报
SQL_ERROR且无明确日志
用%SYS.OdbcConnection执行简单查询
IRIS里最轻量的调用方式是直接实例化%SYS.OdbcConnection类，手动拼接连接字符串。不依赖任何额外包，但每次都要重复写参数，不适合高频调用。
示例代码（在IRIS终端或类方法中运行）：
set conn = ##class(%SYS.OdbcConnection).%New()
set conn.Driver = "PostgreSQL ODBC Driver(UNICODE)"
set conn.Server = "192.168.1.100"
set conn.Port = 5432
set conn.Database = "myapp"
set conn.UID = "iris_user"
set conn.PWD = "secret123"
set status = conn.Open()
if 'status { write "ODBC连接失败: ", $SYSTEM.Status.GetErrorText(status) quit }
set result = conn.Execute("SELECT current_database(), version() LIMIT 1")
write !,"查询结果: ", result.GetDataAt(1,1), " | ", result.GetDataAt(1,2)注意：GetDataAt(row, col)索引从1开始，不是0；Execute()返回的是%SYS.OdbcResult对象，不能直接当列表遍历。
- 连接字符串里的
Driver值必须和ODBC管理器里注册的驱动名称**完全一致**（区分大小写、空格、括号） - 若PostgreSQL启用了SSL，需额外加
sslmode=require到连接字符串，但%SYS.OdbcConnection不暴露该字段，得改用##class(%SYS.JDBCConnection)配合JDBC桥接（更重，不推荐） - 每次
Open()都新建物理连接，别在循环里反复调用，容易耗尽PostgreSQL的max_connections
在业务类里封装ODBC调用逻辑
硬编码连接参数不可维护。实际项目中应把ODBC配置抽到IRIS配置项（^%SYS("ODBC","PG")全局变量）或自定义配置类里，再封装成可复用的方法。
比如定义一个ZEN.PostgresUtil类，提供静态方法：
ClassMethod Query(sql As %String) As %SYS.OdbcResult
{
set conn = ##class(%SYS.OdbcConnection).%New()
// 从配置读取参数
set conn.Driver = $GET(^%SYS("ODBC","PG","Driver"),"PostgreSQL ODBC Driver(UNICODE)")
set conn.Server = $GET(^%SYS("ODBC","PG","Server"),"localhost")
set conn.Port = $GET(^%SYS("ODBC","PG","Port"),5432)
set conn.Database = $GET(^%SYS("ODBC","PG","Database"),"iris_pg")
set conn.UID = $GET(^%SYS("ODBC","PG","UID"),"postgres")
set conn.PWD = $GET(^%SYS("ODBC","PG","PWD"),"postgres")
set status = conn.Open()
if 'status { throw ##class(%Exception.StatusException).CreateFromStatus(status) }
quit conn.Execute(sql)
}这样业务类只需do ##class(ZEN.PostgresUtil).Query("SELECT * FROM logs WHERE ts > ?")，参数绑定要用?占位符，再配合SetParam()设置值（ODBC协议要求）。
- IRIS对PostgreSQL的
jsonb、array等类型默认映射为字符串，需手动$ZCONVERT()解析 - 事务控制受限：ODBC层不支持嵌套事务，
BEGIN/COMMIT必须在SQL里显式写，IRIS的%Transaction机制对其无效 - 错误码翻译弱：PostgreSQL的
23505（唯一约束冲突）在IRIS里可能只报SQLSTATE 23000，得自己查pg_errcodes.h对照
别指望IRIS Studio图形界面直接连PostgreSQL
IRIS Studio的“System Explorer → SQL”页面只列出当前IRIS实例里的命名空间，它**不会扫描或显示外部ODBC数据源**。你不能在Studio里点开一个“PostgreSQL”库然后拖表建视图——那属于SQL Server Management Studio或DBeaver的功能范畴。
所有PostgreSQL交互必须写代码触发，或者用##class(%SYS.PGSQL).Connect()（该类仅存在于极少数定制版IRIS中，官方文档未公开，不建议依赖）。
真正要可视化调试，得另起一套工具链：用DBeaver连PostgreSQL查数据，用IRIS Terminal跑%SYS.OdbcConnection验证连通性，用^%SYS("ODBC")全局变量存配置——三者职责分明，强行统一入口反而增加故障点。
