oracle 12c+中pdb的unplug/plug仅交换xml元数据(含表空间名、文件路径、字符集、tde状态等),不迁移数据文件;实际文件需手动拷贝,xml不含用户数据且路径在目标端被忽略,由file_name_convert或copy指定新位置。
oracle 12c+ 中 pdb 的 unplug 和 plug 不是“拔插”物理文件,而是交换 xml 元数据描述 —— 真正迁移数据文件必须手动拷贝,且 xml 文件本身不包含任何用户数据。
UNPLUG 生成的 XML 文件里到底有什么
这个 XML 是 PDB 的元数据快照,只记录:表空间名、数据文件路径(源库视角)、默认表空间、字符集、时区、TDE 加密状态等。它不包含任何数据块或对象定义。
-
UNPLUG INTO命令不会触发数据文件复制或压缩,只是写入一个约几 KB 的 XML 文本 - XML 中的
filename字段是源 CDB 的绝对路径,在目标端 plug 时会被直接忽略,实际数据文件位置由CREATE PLUGGABLE DATABASE ... USING后的FILE_NAME_CONVERT或COPY子句决定 - 如果 PDB 启用了 TDE,XML 会标记加密状态,但密钥仍保留在源 keystore 中 —— 目标端必须提前导入相同密钥,否则
PLUG会报ORA-65139: mismatched file metadata
PLUG 时为什么总报 ORA-65139 或 ORA-65120
这两个错误基本都源于 XML 描述与实际文件状态对不上,不是权限或语法问题。
-
ORA-65139: mismatched file metadata:常见于数据文件被修改过(如手工改过大小、加过新文件),或 XML 是从非QUIESCE状态下生成的;解决方法是先在源 PDB 执行ALTER PLUGGABLE DATABASE CLOSE IMMEDIATE再UNPLUG -
ORA-65120: invalid XML file:XML 被文本编辑器意外保存为 UTF-8 with BOM,或换行符损坏;用file -i pdb.xml检查编码,确保是us-ascii或utf-8无 BOM - 如果目标 CDB 版本低于源(比如源是 19c,目标是 12.2),
PLUG会静默失败并报错 —— 必须保证目标 CDB 版本 ≥ 源 PDB 创建时的版本,而非 UNPLUG 时的版本
FILE_NAME_CONVERT 和 COPY 两种方式怎么选
本质区别在于数据文件是否需要重定位或重命名 —— 不是性能或安全差异。
- 用
FILE_NAME_CONVERT:适合源/目标文件系统结构一致(比如都是/u01/oradata/cdb1/pdb1/→/u01/oradata/cdb2/pdb1/),Oracle 自动 rename + offline/online,速度快,但要求目标路径已存在且有写权限 - 用
COPY:必须显式指定每个数据文件的目标路径,Oracle 会调用底层 copy(类似dd),适合跨文件系统、NAS、或需变更文件名场景;缺点是耗时长、占用双倍磁盘空间,且COPY过程中无法中断 - 别混用:
FILE_NAME_CONVERT和COPY不能同时出现在一条CREATE PLUGGABLE DATABASE语句里,否则报ORA-65043
Plug 后必须立刻做的三件事
XML 插进去只是注册了 PDB,离可用还差关键几步。
- 执行
ALTER PLUGGABLE DATABASE pdb_name OPEN—— 默认状态是MOUNTED,不 open 就连不上 - 检查
SELECT CON_ID, NAME, OPEN_MODE FROM V$PDBS,确认状态是READ WRITE;如果卡在RESTRICTED,大概率是隐含参数_oracle_script=TRUE没设(仅限非 CDB$ROOT 容器内操作) - 运行
$ORACLE_HOME/rdbms/admin/noncdb_to_pdb.sql(如果源是 non-CDB plug 进来)—— 但 PDB-to-PDB 场景不需要这步,很多人误跑导致对象失效
最容易被跳过的点:XML 文件里的字符集和时区信息不会自动校验,如果源 PDB 用的是 AL32UTF8,而目标 CDB 实例级 NLS_CHARACTERSET 是 WE8ISO8859P1,plug 成功但后续建表会报 ORA-12712 —— 这个坑得在 plug 前就比对好 NLS_DATABASE_PARAMETERS。










