在DB2的联邦查询体系里，create wrapper是一条绕不开的命令。所谓联邦，就是让DB2数据库能够像操作本地表一样去访问Oracle、SQL Server、MySQL等异构数据源中的数据，而包装器正是实现这种能力的基础组件。它本质上是一组库文件和配置信息的集合，负责建立DB2与远程数据源之间的连接协议，并把DB2下发的SQL请求翻译成目标数据源能够识别的方言。如果包装器没有创建或者创建得不正确，后面创建服务器（create server）、创建用户映射（create user mapping）、建立昵称（create nickname）这些步骤统统无法进行。
create wrapper的完整语法与参数说明
create wrapper的基本语法结构比较简单，但不同DB2版本之间存在一些差异。在Linux、UNIX和Windows平台上的DB2中，语法如下：
CREATE WRAPPER wrapper_name [LIBRARY library_name] [OPTIONS ( ADD option_name 'option_value' [, ...] )]
其中wrapper_name是用户自定义的包装器名称，习惯上会直接使用数据源类型作为名称，比如取名为oracle_wrapper、mssql_wrapper，这样便于后续维护时一眼识别。LIBRARY子句指定包装器所依赖的库文件名称，在Windows平台上通常是dll文件，在Linux和AIX上则是对应的共享库文件。OPTIONS子句用来给包装器传递附加参数，最常见的是DB2_FENCED，用来指定包装器是否在受保护模式下运行。
需要注意的是，DB2较早版本要求必须显式指定LIBRARY子句，而从DB2 9.7之后的版本开始，如果包装器名称与系统已知的包装器类型一致，DB2可以自动关联默认库文件，LIBRARY子句就变成了可选项。例如下面这条语句在较新版本中可以直接执行成功：
-- 创建一个用于连接Oracle数据源的包装器 CREATE WRAPPER oracle_wrapper LIBRARY 'libdb2oracle4.so' OPTIONS (ADD DB2_FENCED 'Y');
这条命令创建了一个名为oracle_wrapper的包装器，明确指定了Oracle访问库文件，并通过DB2_FENCED选项让它运行在fenced模式下。fenced模式意味着包装器进程与DB2数据库主进程隔离，即使第三方库出现异常也不会直接拖垮整个数据库实例，代价是进程间通信会带来轻微的性能开销。对于生产环境，一般建议保持fenced模式以保证稳定性。
不同数据源对应的包装器类型如何选择
DB2为每种支持的远程数据源提供了对应的包装器类型，不同的类型绑定了不同的库文件。执行create wrapper之前，需要先确认数据库实例启用了联邦功能，并且安装了对应的联邦访问组件。常见的包装器类型包括：
- oracle：访问Oracle数据库，库文件为libdb2oracle4（Linux）或db2oracle4.dll（Windows）
- sqlserver：访问微软SQL Server，依赖SQL Server客户端驱动
- drda：访问其他DB2家族数据库，比如DB2 for i、DB2 for z/OS
- mysql：访问MySQL和MariaDB，需要安装InfoSphere Federation Server的相关组件
- odbc：通过ODBC接口访问没有专用包装器的数据源，灵活性最高但功能受限
启用联邦功能是前提条件，可以在数据库级别通过下面的命令确认和设置：
-- 更新数据库配置，启用联邦访问 UPDATE DBM CFG USING FEDERATED YES; -- 修改后必须重启实例才能生效 db2stop; db2start; -- 连接到数据库后创建包装器 CONNECT TO SAMPLE; CREATE WRAPPER drda_wrapper; -- 查看已创建的包装器 SELECT * FROM SYSIBM.SYSWRAPPERS;
如果实例没有开启FEDERATED配置参数，执行create wrapper会直接报错SQL1822N或者提示联邦功能不可用。这是实际操作中最常见的坑之一。另外，包装器名称本身只是一个标识符，DB2判断包装器类型是依据LIBRARY子句指定的库文件，所以LIBRARY写错了类型，即使包装器名叫oracle_wrapper，实际走的也可能是别的通道，排查问题时要注意这一点。
创建失败常见报错与排查思路
实际执行create wrapper时，遇到的报错主要集中在权限、环境配置和语法三个层面。下面分别说明处理办法。
第一个常见报错是权限问题。创建包装器要求用户具有SYSADM或DBADM权限，普通用户执行会收到SQL0551N错误，提示没有执行该操作的权限。解决办法是用管理员账号连接数据库，或者让DBA代为执行。可以在执行前用GET AUTHORIZATIONS命令确认当前用户的权限级别。
第二个常见问题是库文件找不到，报错信息通常类似SQL10007N或者提示无法加载模块。这种情况要先检查数据库安装目录下的lib目录（Linux上是sqllib/lib，Windows上是sqllib\bin）中是否存在对应的库文件。如果文件不存在，说明安装DB2服务器时没有勾选联邦组件，需要重新运行安装程序补装。对于Oracle包装器，还需要确认Oracle客户端已经安装并且环境变量正确配置，比如Linux下要检查sqllib/cfg目录下的db2dj.ini文件中ORACLE_HOME的路径设置是否指向了有效的Oracle安装目录。
-- db2dj.ini 文件内容示例，用于指定Oracle环境 ORACLE_HOME=/opt/oracle/product/19c/dbhome_1 ORACLE_SID=orcl -- 修改后确认库文件是否存在 ls -l $HOME/sqllib/lib/libdb2oracle4.so
第三个常见问题是语法层面的，比如OPTIONS子句写法不对。OPTIONS中每一项必须是ADD、SET或者DROP开头，多个选项之间用逗号分隔，选项值必须用单引号包裹。如果写成了普通键值对的形式，解析器会直接报语法错误。还有一个容易忽略的细节是，包装器一旦创建，如果后续想修改它的定义，只能先DROP再重建，drop wrapper并不会影响已经创建的昵称定义，但重建后要确保库文件配置一致，否则联邦查询会失败。
验证包装器创建是否成功，除了查询SYSIBM.SYSWRAPPERS目录表之外，还可以继续往下走一步，尝试create server创建对应的服务器定义。如果create server能够识别这个包装器并正常接受，说明包装器层面已经就绪。整个联邦环境的搭建链条是环环相扣的：先启用FEDERATED参数，再create wrapper，然后create server定义远程服务器，接着create user mapping建立用户映射，最后create nickname生成昵称表，缺了任何一环查询都会报错。掌握create wrapper只是第一步，理解它在整个链条中的位置，排查问题才能有的放矢。
DB2 create wrapper联合数据库数据联邦修改时间：2026-09-10 02:24:33