DBMS_METADATA.GET_DDL返回空或ORA-31603的主因是对象名、类型名、schema名大小写及引号不匹配；需查all_objects确认真实名称，类型全大写，带引号对象须加双引号；权限不足亦致空返回。
DBMS_METADATA.GET_DDL 返回空或报错 ORA-31603
常见现象是调用 dbms_metadata.get_ddl 时返回空字符串，或者直接报 ora-31603: object "xxx" of type xxx not found in schema "yyy"。根本原因不是函数写错了，而是对象名、类型名、schema 名三者必须严格匹配数据库字典里的真实值——尤其注意大小写和引号。
实操建议：
- 先查真实对象名：
SELECT object_name, object_type FROM all_objects WHERE owner = 'SCHEMA_NAME' AND object_type IN ('TABLE', 'VIEW', 'INDEX');，别凭记忆写 - 对象类型名必须用全大写且准确，比如视图是
'VIEW'，不是'view'或'VIEWS' - 如果对象名建表时用了双引号（如
CREATE TABLE "MyTable"），调用时也得传'"MyTable"'，否则 Oracle 默认转成大写去查'MYTABLE'，找不到就报 ORA-31603 - 权限不足也会静默返回空，确认当前用户有
SELECT_CATALOG_ROLE或对sys.all_*视图的查询权限
提取 DDL 时字段顺序乱、缺少注释或约束不完整
DBMS_METADATA.GET_DDL 默认只输出基础定义，像列顺序、注释、外键依赖、索引、触发器这些默认不包含，不是 bug，是设计如此。它只负责“主对象”的核心 DDL，其余靠参数控制。
实操建议：
- 加
DBMS_METADATA.SET_TRANSFORM_PARAM控制输出细节，例如：EXEC DBMS_METADATA.SET_TRANSFORM_PARAM(TRANSFORM_HANDLE => 'DEFAULT', NAME => 'SEGMENT_ATTRIBUTES', VALUE => FALSE);
关掉存储参数避免干扰 - 要带注释，必须显式开启：
DBMS_METADATA.SET_TRANSFORM_PARAM('DEFAULT', 'CONSTRAINTS_AS_ALTER', TRUE)和'CONSTRAINTS', TRUE - 想一次性拿到表 + 索引 + 约束 + 注释，得组合多个
GET_DDL调用，不能指望一次调用全返回 - 注意：
GET_DDL不保证字段物理顺序与建表时完全一致，尤其在有虚拟列或扩展数据类型时，Oracle 内部重排过；若需严格顺序，得解析USER_TAB_COLUMNS手动拼
在 PL/SQL 块里拼接 DDL 遇到 CLOB 截断或换行丢失
直接 DBMS_OUTPUT.PUT_LINE(ddl_clob) 会截断超过 32767 字节的 CLOB，且默认不处理换行符，整段挤成一行，看着像乱码。
实操建议：
- 别用
DBMS_OUTPUT.PUT_LINE直接打 CLOB，改用循环分块输出：DECLARE ddl CLOB; BEGIN ddl := DBMS_METADATA.GET_DDL('TABLE', 'EMP', 'SCOTT'); FOR i IN 1..CEIL(DBMS_LOB.GETLENGTH(ddl)/256) LOOP DBMS_OUTPUT.PUT_LINE(DBMS_LOB.SUBSTR(ddl, 256, (i-1)*256+1)); END LOOP; END; - 确保会话设置足够大的缓冲区：
SET SERVEROUTPUT ON SIZE UNLIMITED（SQL*Plus / SQLcl）或在工具里调高限制 - 如果要把 DDL 写入文件，优先用 UTL_FILE 或外部表，别硬塞进 VARCHAR2 中间变量，容易隐式转换出错
跨版本迁移时 DDL 兼容性被忽略
DBMS_METADATA.GET_DDL 输出的是当前数据库版本的语法，比如 19c 生成的 INVISIBLE COLUMN 或 JSON COLUMN 在 12c 上执行会报错，但它不会自动降级。
实操建议：
- 目标库版本低于源库？必须人工检查 DDL 中的特性关键词：
INVISIBLE、ON UPDATE CURRENT_TIMESTAMP、JSON、MEMOPTIMIZE等，删掉或改写 - 不同字符集下，
NLS_LENGTH_SEMANTICS可能影响VARCHAR2(100)解释为字节还是字符，DDL 里不体现，但执行行为不同 - 分区表 DDL 在低版本中可能含高级语法（如
READ ONLY PARTITION），需提前过滤或替换
最麻烦的其实是依赖关系：GET_DDL('TABLE') 不自动展开外键引用的主表定义，也不管函数索引里用的自定义函数是否存在——这些都得自己捋清楚再补全，不然导过去直接失效。
