问题现象
用户反馈 UNDO 表空间持续膨胀，出现 UNDO 空间不足，需要查明原因并如何做清理。
问题的风险及影响
影响对应功能使用
问题影响的版本
YashanDB 版本：23.2 及以上所有版本
解决方法及规避方式
在崖山是官网上有对 UNDO 空间的详细描述，UNDO 的基本知识比较齐全，可以查阅 UNDO表空间管理 | YashanDB Doc
这里补齐常见的排查方法和应对措施。
1、核查方法
核查 tablespace 表空间情况，对应视图 dba_tablespace，如果没有 dba 权限，则查询 V$tablespace
表空间有对应的数据文件，对应视图 dba_data_files/V$datafile, 重点关注 AUTO_EXTEND 是否打开为 ON，FREE_BLOCKS/BLOCKS 的比例
SQL> SELECT * FROM DBA_TABLESPACES dt;
ID TABLESPACE_NAME BLOCK_SIZE MAX_SIZE TOTAL_BYTES USER_BYTES USER_BLOCKS STATUS CONTENTS LOGGING ALLOCATION_TYPE SEGMENT_SPACE_MANAGEMENT ENCRYPTED COMPRESSED SHARED
0 SYSTEM 8192 5.4976E+11 67108864 26083328 3184 ONLINE PERMANENT LOGGING AUTO BITMAP N N SHARED
1 SYSAUX 8192 5.4976E+11 67108864 38600704 4712 ONLINE PERMANENT LOGGING AUTO BITMAP N N SHARED
2 TEMP 8192 5.4976E+11 67108864 61865984 7552 ONLINE TEMPORARY NOLOGGING UNIFORM BITMAP N N SHARED
3 SWAP 8192 5.4976E+11 67108864 66060288 8064 ONLINE SWAP NOLOGGING UNIFORM BITMAP N N SHARED
4 USERS 8192 5.4976E+11 67108864 66060288 8064 ONLINE PERMANENT LOGGING AUTO BITMAP N N SHARED
5 UNDO 8192 6.8719E+10 469762048 303906816 37098 ONLINE UNDO LOGGING AUTO BITMAP N N SHARED
6 rows fetched.
SQL> SELECT * FROM V$tablespace;
ID NAME STATUS EXTENT_BLOCKS CONTENTS ALLOCATION_TYPE MEMORY_MAPPED ENCRYPTED TEMPORARY COMPRESSED SHARED
0 SYSTEM ONLINE 8 PERMANENT AUTO FALSE FALSE FALSE FALSE SHARED
1 SYSAUX ONLINE 8 PERMANENT AUTO FALSE FALSE FALSE FALSE SHARED
2 TEMP ONLINE 8 TEMPORARY UNIFORM FALSE FALSE TRUE FALSE SHARED
3 SWAP ONLINE 8 SWAP UNIFORM FALSE FALSE TRUE FALSE SHARED
4 USERS ONLINE 8 PERMANENT AUTO FALSE FALSE FALSE FALSE SHARED
5 UNDO ONLINE 1 UNDO AUTO FALSE FALSE FALSE FALSE SHARED
6 rows fetched.
SQL> SELECT * FROM V$datafile;
ID NAME CREATION_TIME TS# BLOCKS BLOCK_SIZE BYTES STATUS RELATIVE_FNO AUTO_EXTEND NEXT_SIZE MAX_SIZE FREE_BLOCKS DISK_BYTES SHADOW
0 /data/fangjingbian/yasdb_data/db-1-1/dbfiles/system 2024-08-15 04:27:42.148097 0 8192 8192 67108864 ONLINE 0 ON 67108864 549755813888 3184 67108864 FALSE
1 /data/fangjingbian/yasdb_data/db-1-1/dbfiles/sysaux 2024-08-15 04:27:42.720697 1 8192 8192 67108864 ONLINE 0 ON 67108864 549755813888 4712 67108864 FALSE
2 /data/fangjingbian/yasdb_data/db-1-1/dbfiles/temp 2024-08-15 20:19:59.067646 2 8192 8192 67108864 ONLINE 0 ON 67108864 549755813888 7552 67108864 FALSE
3 /data/fangjingbian/yasdb_data/db-1-1/dbfiles/swap 2024-08-15 20:19:59.137679 3 8192 8192 67108864 ONLINE 0 ON 67108864 549755813888 8064 67108864 FALSE
4 /data/fangjingbian/yasdb_data/db-1-1/dbfiles/users 2024-08-15 04:27:44.796951 4 8192 8192 67108864 ONLINE 0 ON 67108864 549755813888 8064 67108864 FALSE
5 /data/fangjingbian/yasdb_data/db-1-1/dbfiles/undo 2024-08-15 04:27:45.022139 5 57344 8192 469762048 ONLINE 0 ON 67108864 68719476736 37098 469762048 FALSE
6 rows fetched.
SQL> SELECT * FROM DBA_DATA_FILES;
FILE_NAME FILE_ID TABLESPACE_NAME BYTES BLOCKS STATUS MAXBYTES MAXBLOCKS AUTO_EXTEND NEXT_SIZE USER_BYTES USER_BLOCKS
/data/fangjingbian/yasdb_data/db-1-1/dbfiles/system 0 SYSTEM 67108864 8192 ONLINE 549755813888 67108864 ON 67108864 26083328 3184
/data/fangjingbian/yasdb_data/db-1-1/dbfiles/sysaux 1 SYSAUX 67108864 8192 ONLINE 549755813888 67108864 ON 67108864 38600704 4712
/data/fangjingbian/yasdb_data/db-1-1/dbfiles/temp 2 TEMP 67108864 8192 ONLINE 549755813888 67108864 ON 67108864 61865984 7552
/data/fangjingbian/yasdb_data/db-1-1/dbfiles/swap 3 SWAP 67108864 8192 ONLINE 549755813888 67108864 ON 67108864 66060288 8064
/data/fangjingbian/yasdb_data/db-1-1/dbfiles/users 4 USERS 67108864 8192 ONLINE 549755813888 67108864 ON 67108864 66060288 8064
/data/fangjingbian/yasdb_data/db-1-1/dbfiles/undo 5 UNDO 469762048 57344 ONLINE 68719476736 8388608 ON 67108864 303906816 37098
6 rows fetched.
SQL>
2、处理方法
1）在磁盘空间足够的情况下，直接加数据文件即可
ALTER TABLESPACE UNDO ADD DATAFILE 'undo02' SIZE 10G AUTOEXTEND ON;
2）空间回收
undo 空间不能通过 alter tablespace shrink 的方法缩小空间，但可以通过配置 UNDO_SHRINK_ENABLED、UNDO_SHRINK_INTERVAL 实现自动回收，详见 配置参数 | YashanDB Doc
另外，UNDO 的事务完成之后，对应的 block 在经过 UNDO_RETENTION 设置的时间之后，是可被其他事务复用的，因此，在没有长事务的情况下，可以缩小 UNDO_RETENTION 的时间，另空间可以快速复用。
3）原因核查
一般情况下 UNDO 的空间默认是自动扩展的，最大数据文件大小有 64GB（和其他数据文件不一样，其他数据文件最大有 512GB），是用不完的。
undo 的空间不足一般情况下通过上面两种方法可以快速规避，但是还需要定位为什么会占用这么大的 UNDO 空间。
UNDO 是做事务一致性控制必须的，其空间膨胀必然有大事务执行，用户在使用的过程应该尽量避免大事务，例如在 loop 过程分批提交。
另外，后台任务也可能有事务产生，如定时任务、快照清理。快照如果太大太多，也容易造成大事务占用 UNDO 空间，需要及时处理，快照可以通过 SYSAUX 表空间核查。
