Oracle SQLcl apex export -split参数超5位页码导出文件名不稳定咨询

该问题根因为22.2及更早版本的SQLcl，对apex export -split的页面文件命名规则做了5位页号长度限制，超出长度的页号会被归为同一分组，按导出时的排序顺序追加后缀，导致新增页面后原有页面的文件名发生变化。

方案1：升级SQLcl到23.1及以上版本（最优先） #

Oracle在23.1版本的SQLcl中修复了该命名规则问题，升级后直接使用原有apex export -split命令导出，无论页号位数多少，都会生成仅基于页号的静态文件名page_<完整页号>.sql，无需额外调整参数，导出的文件可直接对接Git等版本控制系统。

方案2：暂无法升级时使用导出后重命名脚本 #

如果当前环境无法升级SQLcl，可以在导出完成后运行简单的批量重命名脚本，提取页面SQL文件头部内置的页号注释重命名文件，确保文件名唯一固定。

Linux/Mac Shell 示例脚本 #

# 进入APEX导出的pages目录后执行
for f in page_*.sql; do
    # 提取SQL头部的页号注释
    page_id=$(grep -m 1 "^-- application page: " "$f" | awk '{print $4}')
    # 重命名为静态文件名
    mv "$f" "page_${page_id}.sql"
done

Windows 批处理示例脚本 #

@echo off
setlocal enabledelayedexpansion
for %%f in (page_*.sql) do (
    for /f "tokens=4" %%p in ('findstr /b /c:"-- application page: " "%%f"') do (
        ren "%%f" "page_%%p.sql"
    )
)

方案3：使用APEX_EXPORT PL/SQL API自定义导出逻辑 #

也可以直接调用APEX内置的导出API自行控制文件名规则，无需依赖SQLcl的命令行导出逻辑，示例代码如下：

DECLARE
    l_export_files apex_export.t_export_files;
    l_page_id NUMBER;
BEGIN
    -- 替换为你的应用ID
    l_export_files := apex_export.get_application(
        p_application_id => 100,
        p_split => TRUE,
        p_with_date => FALSE
    );

    FOR i IN 1 .. l_export_files.COUNT LOOP
        -- 仅处理页面文件
        IF l_export_files(i).name LIKE 'page\_%' ESCAPE '\' THEN
            -- 提取文件内容中的页号
            SELECT REGEXP_SUBSTR(l_export_files(i).contents, '^-- application page: (\d+)', 1, 1, NULL, 1)
            INTO l_page_id FROM DUAL;
            -- 自定义输出文件名，可自行调整逻辑写入本地文件
            DBMS_OUTPUT.PUT_LINE('静态文件名：page_'||l_page_id||'.sql');
            DBMS_OUTPUT.PUT_LINE('内容长度：'||DBMS_LOB.GETLENGTH(l_export_files(i).contents));
        END IF;
    END LOOP;
END;
/

内容的提问来源于stack exchange，提问作者hinotf