在知识库中专注阅读，并随时返回相关工具与课程
大家好，这里是 DBA 学习之路，专注于提升数据库运维效率。 @TOC目录 今天协助客户将 Oracle 数据库从 9.2.0.1 升级至 19.3.0.0，升级采用 exp/imp 逻辑迁移方式，升级完成后测试发现，开发使用 DBLink 无法正常工作，报错信息如下： ORA-02019: connection description for remote database not found
大家好，这里是 DBA 学习之路，专注于提升数据库运维效率。
本章目标：掌握本章核心知识点 前置要求：完成前序章节学习 预计时长：60 分钟
今天协助客户将 Oracle 数据库从 9.2.0.1 升级至 19.3.0.0，升级采用 exp/imp 逻辑迁移方式，升级完成后测试发现，开发使用 DBLink 无法正常工作，报错信息如下：
ORA-02019: connection description for remote database not found
本文记录该问题的分析定位过程及最终解决方案。
升级完成后，我确认已成功创建了 DBLink 并进行了基础测试：
1-- 从源库提取 DBLink 创建语句 (9i 密码可见)2SQL> SELECT 'CREATE ' || DECODE(U.NAME, 'PUBLIC', 'public ') || 'DATABASE LINK ' || DECODE(U.NAME, 'PUBLIC', Null, 'SYS', '', U.NAME || '.') || L.NAME || ' CONNECT TO ' || L.USERID || ' IDENTIFIED BY "' || L.PASSWORD || '" USING ''' || L.HOST || ''';' TEXT3FROM SYS.LINK$ L, SYS.USER$ U4WHERE L.OWNER# = U.USER#;56-- 在新库创建 DBLink7CREATE public DATABASE LINK LUCIFER.LPC.ORACLE.COM CONNECT TO ORACLE IDENTIFIED BY "ORACLE" USING 'LUCIFER';89-- 基础测试 (成功)10select sysdate from dual@LUCIFER.LPC.ORACLE.COM;查询结果如下：
然而，应用反馈其查询失败（使用的短名称格式）：
1select sysdate from dual@LUCIFER;在 SQL*Plus 中复现应用查询方式，确实报错：
1SQL> select count(*) from od_cow@LUCIFER;2select count(*) from od_cow@LUCIFER3 *4ERROR at line 1:5ORA-02019: connection description for remote database not found问题明确：使用 @LUCIFER（短名称） 访问 DBLink 失败，而使用 @LUCIFER.LPC.ORACLE.COM（完整名称） 成功。
初步怀疑问题与域名（Domain） 配置差异有关。对比源库与新库的关键配置：
1-- global_names 参数 (决定 DBLink 名称是否强制匹配远程库 global_name)2SQL> show parameter global_names34NAME TYPE VALUE5------------------------------------ ----------- ------------------------------6global_names boolean FALSE78-- db_domain 参数 (数据库域名)9SQL> show parameter db_domain1011NAME TYPE VALUE12------------------------------------ ----------- ------------------------------13db_domain string1415-- global_name 值 (数据库全局名称)16SQL> select * from global_name;1718GLOBAL_NAME19--------------------------------------------------------------------------------20ORCL.LPC.ORACLE.COM1SQL> show parameter global_names23NAME TYPE VALUE4------------------------------------ ----------- ------------------------------5global_names boolean FALSE67SQL> show parameter db_domain89NAME TYPE VALUE10------------------------------------ ----------- ------------------------------11db_domain string1213SQL> select * from global_name;1415GLOBAL_NAME16--------------------------------------------------------------------------------17ORCL核心问题定位：源库的 global_name 为 ORCL.LPC.ORACLE.COM，而新库的 global_name 仅为 ORCL。当应用程序使用短名称 @LUCIFER 访问 DBLink 时，Oracle 会尝试将其解析为 LUCIFER.<当前库的 global_name 后缀>。新库后缀为空，因此实际查找的是名为 LUCIFER 的 DBLink，但我们在新库创建的是全名 LUCIFER.LPC.ORACLE.COM，导致名称不匹配而报错。
目标：将新库的 global_name 修改为 ORCL.LPC.ORACLE.COM，使其与源库一致。
1-- 新库操作2SQL> UPDATE GLOBAL_NAME SET GLOBAL_NAME='ORCL.LPC.ORACLE.COM';31 row updated.45SQL> commit;6Commit complete.78-- 测试应用查询 (仍然失败)9SQL> select count(*) from od_cow@LUCIFER;10select count(*) from od_cow@LUCIFER11 *12ERROR at line 1:13ORA-02019: connection description for remote database not found结果：查询依然失败，尝试重建 DBLink (失败)：
LUCIFER.LPC.ORACLE.COM) 后，重建全名 DBLink 后测试失败。LUCIFER) 后，使用 @LUCIFER 成功，但 DBLink 名称不符合源库规范（源库 DBLink 是全名）。1-- 新库操作：使用 RENAME 命令修改 global_name2SQL> alter database rename global_name to ORCL.LPC.ORACLE.COM;34Database altered.56-- 尝试重建 DBLink (先删除旧的)7SQL> SELECT * FROM dba_db_links;89OWNER DB_LINK USERNAME HOST CREATED10-------------------- ------------------------------------------------------------ -------------------- ------------------------------ ----------11PUBLIC LUCIFER ORACLE LUCIFER 1213SQL> drop public database link LUCIFER.LPC.ORACLE.COM;14drop public database link LUCIFER.LPC.ORACLE.COM15 *16ERROR at line 1:17ORA-02024: database link not found1819SQL> drop public database link LUCIFER;20drop public database link LUCIFER21 *22ERROR at line 1:23ORA-02024: database link not found问题：明明存在名为 LUCIFER 的 DBLink (dba_db_links 可查)，却无法删除，提示不存在！为什么删不掉？ 搜了下 MOS，有一篇文档 DB Parameters - Global Database Name (GLOBAL_DB_NAME) (Doc ID 2643771.1) 比较符合：
这个跟我遇到的问题一致，都是 rename 方式修改了 global_name 之后无法删除已创建的 DBLink，解决方案：
手动修正 props$：
1-- 检查当前的 GLOBAL_DB_NAME 值2SQL> select name,value$ from props$ where name ='GLOBAL_DB_NAME';34NAME VALUE$ 5-------------------- ------------------------------------------------------------6GLOBAL_DB_NAME ORCL.LPC.ORACLE.COM 78-- rename 修改 global_name9SQL> alter database rename global_name to ORCL;1011Database altered.1213-- 再次查询，发现 rename 根本没有更新表 props$ 的值14SQL> select name,value$ from props$ where name ='GLOBAL_DB_NAME';1516NAME VALUE$ 17-------------------- ------------------------------------------------------------18GLOBAL_DB_NAME ORCL.LPC.ORACLE.COM 1920-- 需要手动更新 props$ 表的 GLOBAL_DB_NAME 值21SQL> update props$ set value$ = 'ORCL' where name ='GLOBAL_DB_NAME';22231 row updated.2425SQL> commit;2627Commit complete.2829-- 确保已经更新30SQL> select name,value$ from props$ where name ='GLOBAL_DB_NAME';3132NAME VALUE$ 33-------------------- ------------------------------------------------------------34GLOBAL_DB_NAME ORCL删除旧的 DBLink (此时成功)：
1SQL> drop public database link LUCIFER;23Database link dropped.重新 RENAME 到目标名称：
1SQL> alter database rename global_name to ORCL.LPC.ORACLE.COM;23Database altered.45-- 检查 props$ 表6NAME VALUE$ 7-------------------- ------------------------------------------------------------8GLOBAL_DB_NAME ORCL.LPC.ORACLE.COM重建 DBLink (使用源库相同的全名格式)：
1SQL> CREATE public DATABASE LINK LUCIFER.LPC.ORACLE.COM CONNECT TO ORACLE IDENTIFIED BY "ORACLE" USING 'LUCIFER';23Database link created.45SQL> SELECT * FROM dba_db_links;67OWNER DB_LINK USERNAME HOST CREATED8-------------------- ------------------------------------------------------------ -------------------- ------------------------------ ----------9PUBLIC LUCIFER.LPC.ORACLE.COM ORACLE LUCIFER测试数据是否可以正常访问：
1SQL> select count(*) from od_cow@LUCIFER;23 COUNT(*)4----------5 456093867SQL> select count(*) from od_cow@LUCIFER.LPC.ORACLE.COM;89 COUNT(*)10----------11 4560939问题解决！ 应用程序可以正常使用短名称 DBLink 访问。
数据库升级过程中，DBLink 是极易出问题的环节，务必高度重视。结合本次及以往经验，总结几点关键注意事项：
global_name 与源库完全一致（特别是域名部分），这是短名称 DBLink 解析的基础。tnsnames.ora），保证 DBLink 连接字符串能正确解析到远程数据库。rename global_name 后操作异常（如无法删除 DBLink），检查并手动更新 props$ 表是有效的解决途径 (参考 MOS 文档)。希望本次故障排查经验能为大家的升级工作提供参考，避免类似问题。升级无小事，细节定成败！