FRENAME プロシージャー - ファイルの名前を変更する

FRENAME プロシージャーは、指定されたファイルの名前を変更します。 ファイルの名前を変更 することによって、実質的にファイルをある場所から別の場所へ移動します。

構文

構文図を読む構文図をスキップするUTL_FILE.FRENAME (location,filename, dest_dir,dest_file,replace)

プロシージャー・パラメーター

location
名前を変更するファイルを含むディレクトリーの別名を指定する、タイプ VARCHAR (128) の入力引数。
filename
名前を変更するファイルの名前を指定する、タイプ VARCHAR (255) の入力引数。
dest_dir
宛先ディレクトリーの別名を指定する、タイプ VARCHAR (128) の入力引数。
dest_file
ファイルの新しい名前を指定する、タイプ VARCHAR (255) の入力引数。
replace
ファイルがすでに存在する場合、ディレクトリー dest_dir の ファイル dest_file を置き換えるかどうかを指定する、タイプ INTEGER の オプション入力引数。
1
既存のファイルを置き換えます。
0
ファイルがすでに存在する場合、例外をスローします。 replace に値が指定されていない 場合、これがデフォルトです。

許可

UTL_FILE モジュールに対する EXECUTE 特権。

例

emp 表からの従業員のコンマで区切られたリストを含むファイル、empfile.csv の名前を変更します。

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