当业务数据分散在不同数据库实例甚至不同品牌的数据库中时，直接在SQL层面打通这些数据源就成了刚需。DB2的Federation（联邦数据库）功能正是为此而生，它允许你在一个DB2实例中创建指向远程数据库的"虚拟表"，查询时就像访问本地表一样简单。本文将围绕DB2联邦数据库的完整配置流程展开，从参数设置到包装器、服务器、用户映射、nickname的创建逐一讲解，并给出常见问题的排查思路。
一、联邦数据库的工作原理与前置条件
联邦数据库的核心思想是"透明访问"。DB2通过一个叫SQLEDBA层的组件，借助包装器（Wrapper）与远程数据源通信。包装器负责协议转换，服务器对象（Server）描述远程连接信息，用户映射（User Mapping）解决认证问题，而nickname（昵称表）则是远程表在本地的逻辑映射。查询时优化器会把针对nickname的SQL改写为远程能理解的下推语句（谓词下推），再把结果拉回本地做合并。
配置前需要确认几件事：第一，联邦功能在DB2 LUW的企业版和高级企业版中默认可用，如果用的是Express-C版本，则不支持Federation，这一点务必先确认，否则后面创建包装器时会直接报SQL1159错误。第二，远程数据源的连通性要提前验证好，比如用db2catalog命令或者直接用db2 connect测试远程库能否连上。第三，本地实例的FEDERATED参数必须打开，这是整个配置的入口。
另外要注意，DB2访问不同类型的数据源需要对应的包装器库文件。访问远程DB2（DRDA协议）使用内置的DB2数据源支持，一般开箱即用；访问Oracle、SQL Server、MySQL等则需要在服务器上安装对应的客户端驱动，并把这些驱动的lib路径加入DB2实例的环境变量中，否则创建包装器时会报找不到库的错误。
二、开启FEDERATED参数并创建数据库
FEDERATED是数据库管理器级别的参数，默认值是NO。修改它需要在DB2实例用户下执行db2 update dbm cfg命令，修改后必须重启实例才能生效。具体操作步骤如下：
-- 切换到实例用户 su - db2inst1 -- 查看当前FEDERATED参数值 db2 get dbm cfg | grep -i federated -- 开启联邦支持 db2 update dbm cfg using FEDERATED YES -- 停止并重启实例使参数生效 db2stop db2start
重启后再次执行db2 get dbm cfg确认FEDERATED已经变成YES。接下来创建或者选择一个本地数据库作为联邦数据库，nickname等对象都建在这个库里。注意这些联邦对象是数据库级别的，换一个数据库就要重新创建一遍。创建数据库并连接的命令如下：
db2 "CREATE DB FEDDB AUTOMATIC STORAGE YES USING CODESET UTF-8 TERRITORY CN" db2 "CONNECT TO FEDDB"
这里有个容易踩的坑：如果实例是从老版本升级上来的，FEDERATED参数可能因为配置覆盖被重置回NO，升级后要记得复查。另外，开启FEDERATED后实例内存占用会略有增加，主要给SQLEDBA通信层使用，生产环境规划内存时要预留这部分空间。
三、创建Wrapper、Server、User Mapping和Nickname
这是联邦配置最核心的四步，环环相扣。下面以访问远程DB2数据库为例给出完整的脚本，远程库地址是192.168.0.1，服务端口50000，远程库名SAMPLE，目标表是SALES表。
第一步创建包装器。DB2到DB2之间使用DRDA包装器，名字可以自定义，方便后续管理：
CREATE WRAPPER DRDA LIBRARY 'libdb2drda.so' OPTIONS (DB2_FMPYES 'N');
第二步创建服务器对象，TYPE和VERSION描述数据源类型，OPTIONS里写连接信息。DBNAME是远程库名，就是编目时用的那个名字，如果远程DB2不在同一台机器上，需要先在本地编目远程节点和数据库：
-- 先编目远程节点和数据库 db2 "CATALOG TCPIP NODE RMTNODE REMOTE 192.168.0.1 SERVER 50000" db2 "CATALOG DB SAMPLE AT NODE RMTNODE"
CREATE SERVER RMT_SERVER TYPE DB2/UDB VERSION 11.5 WRAPPER DRDA OPTIONS (ADD DBNAME 'SAMPLE', PASSWORD 'Y');
第三步创建用户映射，把本地用户和远程用户绑定起来，本地用户执行查询时会以映射的远程身份去认证：
CREATE USER MAPPING FOR DB2INST1 SERVER RMT_SERVER OPTIONS (ADD REMOTE_AUTHID 'remoteuser', ADD REMOTE_PASSWORD 'remotepass');
第四步创建nickname，指向远程的具体表。可以指定列名映射，也可以直接用CREATE NICKNAME ... FOR语法快速创建：
CREATE NICKNAME SALES_NICK FOR RMT_SERVER.DBSALES.SALES; -- 之后就可以像本地表一样查询 SELECT * FROM SALES_NICK WHERE REGION = 'NORTH';
创建完成后，通过syscat.tablename或者控制中心就能看到nickname。查询时可以打开监视器验证谓词是否成功下推到远程，只有过滤条件被下推，跨库查询的性能才可接受。可以用db2 explain查看访问计划，如果发现远程表上的谓词显示为本地过滤，就要检查服务器定义中DB2_FENCED设置和数据源版本号是否匹配。
四、访问非DB2数据源与常见报错处理
如果目标数据源是Oracle，除了安装Oracle客户端并把lib路径加入sqllib/cfg/db2dj.ini之外，创建服务器时TYPE要写ORACLE，VERSION写对应的Oracle版本，脚本示例如下：
CREATE WRAPPER ORACLE LIBRARY 'libdb2net8.so'; CREATE SERVER ORA_SRV TYPE ORACLE VERSION 12.2 WRAPPER ORACLE OPTIONS (ADD NODE 'ORCL'); CREATE USER MAPPING FOR DB2INST1 SERVER ORA_SRV OPTIONS (ADD REMOTE_AUTHID 'orauser', ADD REMOTE_PASSWORD 'orapass'); CREATE NICKNAME EMP_NICK FOR ORA_SRV.ORAUSER.EMPLOYEES;
配置过程常见的报错主要有几类。SQL1102W或者SQL30082说明认证有问题，检查用户映射中的远程账号密码是否正确；SQL1822表示在远程数据源上执行出错，需要结合DBCODEPAGE和db2diag日志看具体原因；创建包装器报SQL10001N找不到库文件，基本是驱动未安装或者db2dj.ini里路径配置有误，改完后要重启实例。此外，nickname创建时报找不到远程表，多数是大小写问题——Oracle中未加双引号创建的对象默认是大写，DB2映射时要写成大写表名。
最后提醒一点，联邦查询虽然方便，但它不是ETL工具。大量数据通过nickname做关联和聚合会把数据拉到本地处理，网络开销很大，高频大表关联场景建议还是用物化视图或定期同步的方式。掌握好谓词下推的验证方法和连接复用参数（如COMM_RATE），才能让联邦数据库在生产环境中稳定发挥价值。
DB2 Federation联邦数据库跨库查询修改时间：2026-09-04 13:50:49