迁移手册 · 精确目标 gaussdb:505 · 更新于 2026-08-21

Oracle → GaussDB 505(ORA 模式)迁移手册

十章工程目录收录 945 个 Oracle 迁移候选;70 个 verified / doc_based 场景有明确目标结论,62 个 draft 声明仅进入待核验口径,813 个未知项不进行产品家族外推。

945迁移候选
70权威明确结论
62待核验声明
70权威 partial / none
38已登记工件锚点
38版本观察

十章工程目录

1. 类型与值域

40 个候选 · 13 个权威明确 · 11 个待核验

full 0partial 12none 1unknown 2

2. DDL 与数据库对象

183 个候选 · 17 个权威明确 · 4 个待核验

full 0partial 1none 16unknown 143

3. 查询与结果语义

107 个候选 · 7 个权威明确 · 7 个待核验

full 0partial 6none 1unknown 83

5. 函数与表达式

219 个候选 · 22 个权威明确 · 11 个待核验

full 0partial 20none 2unknown 17

7. PL/SQL 与存储程序

301 个候选 · 0 个权威明确 · 11 个待核验

full 0partial 0none 0unknown 140

当前预览没有可链接的权威明确场景;完整构建保留本章事实统计。

8. 序列、同义词与触发器

24 个候选 · 1 个权威明确 · 0 个待核验

full 0partial 1none 0unknown 19

10. 驱动与应用层

5 个候选 · 0 个权威明确 · 0 个待核验

full 0partial 0none 0unknown 0

当前预览没有可链接的权威明确场景;完整构建保留本章事实统计。

优先核对的高风险场景

只收录 authoritative、精确矩阵已声明且 support 为 partial / none 的条目;不把 draft 放入推荐。

CONNECT BY 层次查询

partial · artifact_verified · 目标不保留原生层次句时改 WITH RECURSIVE,并先保留 Oracle 执行序:FROM/WHERE 中的 join 先形成候选关系,START WITH 与 CONNECT BY/PRIOR 再展开层次,剩余 WHERE 最后逐行过滤,不能提前裁掉不满足 WHERE 的父行及其仍应返回的子孙。锚点/递归成员生成 depth/path/visited,visited 必须使用稳定行身份与路径实例,不能用可重复业务键。NOCYCLE 在下一子行已是祖先时停止该边;CONNECT_BY_ISCYCLE 标记“当前行存在一个祖先子行”,不是标记或输出重复子行

LEVEL 层次伪列

partial · artifact_verified · 树深度在递归 CTE 锚点置 depth=1、递归成员置 depth+1;纯行生成须区分根行契约:无 START WITH 且无其他根过滤时,Oracle 在 n<=0/NULL 仍保留 1 个根行,改为无条件产生 1 的递归 CTE 锚点、仅在下一层满足 LEVEL<=n 时递归,或给 generate_series 显式补该分支;有 START WITH/根过滤时才允许根行被过滤为零行

(+) 传统外连接标记

partial · artifact_verified · a.id = b.id(+) 保留 a,改 a LEFT JOIN b ON (...);marker 在左侧时按保留侧改 RIGHT JOIN 或交换表序后改 LEFT JOIN。同一可空表的全部 (+) 谓词(含 b.flag(+) = 常量)必须整体移入 ON, 留在 WHERE 会消掉 NULL 扩展行。含 OR/IN、同一表混合左右 marker、跨多表 marker 不一致或 NEW/OLD 伪表时只给人工方案,不自动重排连接图。

SYS_CONTEXT 函数

partial · artifact_verified · USERENV 的 SESSION_USER -> session_user、CURRENT_USER -> current_user、 CURRENT_SCHEMA -> current_schema、DB_NAME/DB_UNIQUE_NAME -> current_database(); IP_ADDRESS 可在连接拓扑明确时映射 inet_client_addr()。 OS_USER、CLIENT_IDENTIFIER、AUTHENTICATED_IDENTITY、PROXY_USER、BG_JOB_ID、HOST/SERVER_HOST 与 MODULE 只能做近似映射,不能把 OS_USER/CLIENT_IDENTIFIER 当 session_user,或把 BG_JOB_ID 当 pg_backend_pid() 冒充等价。自定义 namespace 必须追踪 DBMS_SESSION.SET_CONTEXT 写入链并重设计。

TO_DATE 函数(格式模型差异)

partial · artifact_verified · 字符单参数读取 NLS_DATE_FORMAT;DATE/datetime 参数复现时显式 date→char→DATE 往返,移除 TO_DATE 属获批纠错;无时间元素用 date parser,含 HH/MI/SS 用 timestamp parser 后 cast 到 Oracle-DATE 映射以返回 DATE;映射 RR/J/IW/FX;DEFAULT 只捕获 char 转换,default 自身同格式失败继续报错,表达式求值错误不得吞掉

既有改造点明细

保留原有实质详情 canonical,下面是当前页前 80 个改造点入口;迁移手册不复制问题详情。

ADD_MONTHS 函数partial · minor · ora.func.add_monthsALTER SESSION SET 会话参数unknown · minor · ora.syntax.alter_sessionANYDATA 动态类型列unknown · critical · ora.type.anydataASCIISTR Unicode 转义函数unknown · major · ora.func.asciistr关联数组(INDEX BY 表)unknown · major · ora.plsql.associative_arrayAT TIME ZONE 时区表达式unknown · major · ora.func.at_time_zoneAUTHID 执行者/定义者权限模式unknown · critical · ora.plsql.authid自治事务(PRAGMA AUTONOMOUS_TRANSACTION)partial · critical · ora.plsql.autonomous_txn触发器内自治事务none · blocker · ora.trigger.autonomous_transaction视图 BEQUEATH 子句unknown · minor · ora.ddl.bequeathBFILE 外部文件类型unknown · critical · ora.type.bfileBFILENAME 外部文件定位函数unknown · critical · ora.func.bfilenameBIN_TO_NUM 位序列转数值unknown · major · ora.func.bin_to_numBINARY_DOUBLE 类型partial · minor · ora.type.binary_doubleBINARY_FLOAT 类型none · minor · ora.type.binary_floatOracle 二进制浮点特殊字面量unknown · critical · ora.literal.binary_float_specialBITAND 函数partial · minor · ora.func.bitandBITMAP 位图索引unknown · major · ora.index.bitmapBULK COLLECT 批量取数unknown · major · ora.plsql.bulk_collectLENGTHB / SUBSTRB / INSTRB 字节语义函数partial · major · ora.func.byte_semanticsCDB/多租户与排序规则 DDL 子句(SHARING / DEFAULT COLLATION / CONTAINER_MAP)unknown · minor · ora.ddl.container_clausesCHAR 定长补空格类型unknown · minor · ora.type.char_paddingCHR(0) NUL 字符语义差异unknown · major · ora.func.chr_zeroOracle 聚簇表与 CLUSTER 子句unknown · major · ora.object.cluster_tableOracle 集合 CARDINALITYunknown · major · ora.func.cardinalitySQL 层集合运算函数unknown · major · ora.func.collection_sql列 DEFAULT 使用序列伪列unknown · major · ora.column.default_sequence存储过程内 COMMIT/ROLLBACKunknown · major · ora.plsql.commit_in_proc复合 UNIQUE 的部分 NULL 唯一性语义unknown · blocker · ora.constraint.composite_unique_null字符串拼接 || 的 NULL 语义unknown · minor · ora.behavior.concat_nullCONNECT BY 层次查询partial · critical · ora.syntax.connect_byCONNECT BY 操作数含函数none · critical · ora.syntax.connect_by_function_operandLEVEL 层次伪列partial · major · ora.syntax.level_pseudocolumnCONNECT_BY_ROOT 层次操作符partial · major · ora.syntax.connect_by_root约束 DISABLE 状态unknown · major · ora.ddl.constraint_disableCREATE INDEX ... NOLOGGINGunknown · major · ora.ddl.create_index_nologging游标属性(%FOUND/%NOTFOUND/%ISOPEN/%ROWCOUNT)unknown · major · ora.plsql.cursor_attributesSQL%BULK_ROWCOUNT 逐项批量 DML 计数none · critical · ora.cursor.sql_bulk_rowcount游标 FOR 循环unknown · minor · ora.plsql.cursor_for_loop日期直接加减数字(天数运算)unknown · major · ora.behavior.date_arithmeticDATE 映射 TIMESTAMP 后日期差聚合类型变化unknown · critical · ora.dm.timestamp_delta_aggregateDATE 类型含时间部分的语义partial · major · ora.type.date_semanticsDBLINK 引用(obj@link)unknown · major · ora.object.dblink_ref过程体内 DBLINK 引用(obj@link)unknown · critical · ora.plsql.dblink_in_bodyDBMS_RANDOM 随机数调用(过程体内)unknown · minor · ora.pkg.dbms_randomDBMS_RANDOM 包调用unknown · minor · ora.func.dbms_randomDBMS_JOB 定时作业调用(过程体内)unknown · major · ora.pkg.dbms_jobDBMS_SCHEDULER 调度器调用(过程体内)unknown · major · ora.pkg.dbms_schedulerDBMS_SCHEDULER / DBMS_JOB 调度作业unknown · major · ora.plsql.dbms_schedulerDBTIMEZONE 数据库时区函数unknown · major · ora.func.dbtimezoneDECODE 函数partial · major · ora.func.decodeDEFAULT ON NULL 列默认值unknown · minor · ora.column.default_on_nullDETERMINISTIC 函数标记unknown · minor · ora.plsql.deterministicDROP USER ... CASCADE 级联删除unknown · critical · ora.ddl.drop_user_cascadeDUAL 虚表unknown · minor · ora.syntax.dualDUMP 内部表示诊断函数unknown · major · ora.func.dump动态 SQL(EXECUTE IMMEDIATE)partial · major · ora.plsql.dynamic_sqlOPEN FOR 直接使用 SQL 字符串表达式partial · critical · ora.cursor.open_expressionEDITIONABLE / NONEDITIONABLE 关键字unknown · minor · ora.ddl.editionableEMPTY_CLOB / EMPTY_BLOB 函数unknown · minor · ora.func.empty_lob与空串字面量的等值/不等比较('' 即 NULL 语义)unknown · critical · ora.behavior.empty_string_compareEXCEPTION 异常处理块unknown · minor · ora.plsql.exception_block显式游标声明(CURSOR ... IS)unknown · minor · ora.plsql.cursor_explicitJava/C 外部语言存储例程unknown · critical · ora.plsql.external_routine外部表(ORGANIZATION EXTERNAL)unknown · critical · ora.object.external_tableFIRST_VALUE IGNORE NULLSnone · major · ora.func.first_value_ignore_nullsFLASHBACK 查询(AS OF SCN/TIMESTAMP、VERSIONS BETWEEN)unknown · major · ora.syntax.flashback_querySELECT ... FOR UPDATE OF 列级锁定写法unknown · minor · ora.syntax.for_update_of外连接查询 FOR UPDATEnone · critical · ora.syntax.for_update_outer_joinFOR UPDATE WAIT n 超时等待子句unknown · minor · ora.syntax.for_update_waitFORALL 批量 DMLunknown · major · ora.plsql.forallCREATE FORCE VIEWunknown · minor · ora.ddl.view_forceFROM_TZ 时区附加函数unknown · major · ora.func.from_tzOracle Text 全文索引与 CTX 包unknown · critical · ora.index.fulltext_contextPL/SQL 代码中的全角标点unknown · major · ora.plsql.fullwidth_punctuation索引表达式中的 TO_DATE/TO_CHARnone · critical · ora.index.nonimmutable_conversionMDSYS / SDO 空间类型与包unknown · critical · ora.func.gis_sdo全局临时表(GLOBAL TEMPORARY TABLE)partial · major · ora.object.gttGOTO 语句unknown · major · ora.plsql.gotoGREATEST / LEAST 函数(NULL 传播差异)partial · major · ora.func.greatest_least

上线前验证清单