DB2数据库与其他主流数据库有一个明显区别：客户端在访问远程数据库之前，必须先在本地把远程服务器节点和数据库实例编目（catalog）到系统数据库目录中。没有完成编目操作，即使网络是通的、实例是启动的，客户端依然无法建立连接。本文围绕catalog命令展开，讲解节点编目和数据库编目的完整流程、参数含义以及常见报错的处理办法。
一、为什么必须先执行catalog编目
DB2采用目录结构管理连接信息。客户端本地维护着三层数据库目录：系统数据库目录（system database directory）、节点目录（node directory）和工作目录（workstation directory，部分平台称本地目录）。系统数据库目录记录所有可以访问的数据库条目，每个条目中都包含一个指向节点目录的类型字段。节点目录则记录远程服务器的通信信息，包括主机地址和端口号。
当客户端发起连接请求时，DB2首先在系统数据库目录中查找数据库名，找到对应的节点名后再去节点目录中查找该节点的IP和端口，最后通过TCPIP协议把连接请求发送到远程实例。由此可见，编目的本质就是把远程连接所需的寻址信息提前登记到本地目录，供连接时查询。如果节点没有编目，系统数据库目录里的条目就是无效的悬空引用；如果数据库没有编目，本地根本不知道有这个库的存在。
理解了这个机制，也就能解释为什么同一个数据库在不同客户端机器上要分别执行编目操作。编目信息只存在于本地的sqllib目录下的配置文件中，不会随网络传播。换一台机器、重装一次客户端，都需要重新编目。
二、catalog命令注册节点与数据库的完整步骤
假设远程服务器IP为192.168.0.10，DB2实例端口为50000，数据库名为sample。编目分两步执行，先编目节点，再编目数据库。
第一步，注册远程节点：
db2 catalog tcpip node mynode remote 192.168.0.10 server 50000 db2 terminate
其中mynode是自定义的节点名，在本地目录中必须唯一，通常建议使用8个字符以内的小写字母。remote参数指定远程服务器地址，可以写IP也可以写主机名。server参数指定实例的通信端口，注意这个端口必须是DB2实例配置文件中SVCENAME对应的端口，而不是客户端随意指定的。执行完catalog后必须执行db2 terminate，否则编目信息可能不会立即写入目录文件。
第二步，注册远程数据库：
db2 catalog database sample as mysamp at node mynode db2 terminate
as后面的mysamp是本地别名，将来客户端连接时就用这个别名。at node参数指向第一步编目的节点名，两者必须严格一致。如果还需要指定认证方式，可以追加authentication server或authentication client子句，指定认证发生在服务端还是客户端。
编目完成后用以下命令验证：
db2 list node directory db2 list database directory db2 connect to mysamp user db2inst1 using 密码
前两条命令分别查看节点目录和系统数据库目录的内容，确认条目已登记。最后一条命令实际测试连接，如果返回连接成功的信息，说明整个编目和链路都没有问题。
三、编目常见报错与维护操作
实际操作中编目环节出错最多的集中在三个方面。第一是端口不通，可以先在客户端用telnet或nc测试远程端口是否可达，如果网络层不通，编目做得再对也无法连接。第二是端口与实例不匹配，服务端通过db2 get dbm cfg查看SVCENAME参数，再在服务端/etc/services文件中确认该服务名对应的端口号，编目时必须使用这个真实端口。第三是节点名或别名重复，编目同名条目会报SQL1005N之类的错误，此时需要先删除旧条目再重新编目。
删除编目使用uncatalog命令：
db2 uncatalog node mynode db2 uncatalog database mysamp db2 terminate
需要注意的是，uncatalog database后面跟的是本地别名，不是远程库的真实名称。如果目录信息混乱，无法逐一清理，可以执行db2 RESET DB DIR CFG重置数据库目录，但这个操作会清空所有编目条目，生产环境要谨慎使用。
另外提醒一点，编目操作不需要实例处于连接状态，但需要客户端环境变量已正确设置。在Linux和Unix平台上，执行db2命令前要先运行用户主目录下sqllib目录中的db2profile脚本；在Windows平台上则以管理员身份运行命令行处理器即可。掌握catalog与uncatalog这对命令，再配合list directory系列命令检查目录内容，DB2客户端访问远程数据库的配置问题基本都能自行解决。
DB2 catalog节点编目数据库编目修改时间：2026-09-15 02:34:18