FRENAME 过程 - 重命名文件
FRENAME 过程可重命名指定的文件。重命名文件可有效地将文件从一个位置移至另一个位置。
语法
过程参数
- location
- 类型为 VARCHAR(128) 的输入自变量，用于指定包含要重命名的文件的目录的别名。
- filename
- 类型为 VARCHAR(255) 的输入自变量，用于指定要重命名的文件的名称。
- dest_dir
- 类型为 VARCHAR(128) 的输入自变量，用于指定目标目录的别名。
- dest_file
- 类型为 VARCHAR(255) 的输入自变量，用于指定文件的新名称。
- replace
- 类型为 INTEGER 的可选输入自变量，用于指定是否替换目录 dest_dir 中的文件 dest_file（如果该文件已存在）：
- 1
- 替换现有文件。
- 0
- 该文件已存在时抛出异常。如果未对 replace 指定任何值，那么这是缺省值。
权限
对 UTL_FILE 模块的 EXECUTE 特权。
示例
重命名文件 empfile.csv，该文件包含 emp 表中的职员的逗号定界列表。
SET SERVEROUTPUT ON@
CREATE PROCEDURE proc1()
BEGIN
DECLARE v_dirAlias VARCHAR(50) DEFAULT 'empdir';
DECLARE v_src_file VARCHAR(20) DEFAULT 'oldemp.csv';
DECLARE v_dest_file VARCHAR(20) DEFAULT 'newemp.csv';
DECLARE v_replace INTEGER DEFAULT 1;
CALL UTL_FILE.FRENAME(v_dirAlias,v_src_file,v_dirAlias,
v_dest_file,v_replace);
CALL DBMS_OUTPUT.PUT_LINE('The file ' || v_src_file ||
' has been renamed to ' || v_dest_file);
END@
CALL proc1@此示例生成以下输出：
The file oldemp.csv has been renamed to newemp.csv