FOPEN 関数は、ユーザーが指定した情報に基づいてファイルを開くために使用されます。システムは最大で50個のファイルを同時に開くことができます。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity Editionは現在サポートされていません。
構文
UTL_FILE.FOPEN (
location IN VARCHAR2,
filename IN VARCHAR2,
open_mode IN VARCHAR2,
max_linesize IN BINARY_INTEGER DEFAULT 1024)
RETURN FILE_TYPE;
パラメータの説明
パラメータ |
説明 |
|---|---|
| location | 開くファイルのパスオブジェクト名。 |
| filename | 開くファイル名。ファイル名には「/」を含めることはできません。 |
| open_mode | ファイルの開き方を指定します。モードは以下のとおりです：
open_mode に a または ab を指定してもファイルが存在しない場合、そのファイルは write モードで作成されます。 |
| max_linesize | このファイルの各行の最大バイト数です。改行文字も含みます。[1、32767]の範囲です。デフォルト値は1024です。 |
戻り値
FOPEN は、ファイルを開くハンドルである FILE_TYPE を返します。このハンドルは、そのファイルに対するすべての後続の操作プロセスに渡されなければなりません。ファイルハンドルの具体的な内容は UTL_FILE のプライベートなものであるため、参照や変更はできません。
例外状況
INVALID_MAXILINESIZEINVALID_MODEINVALID_OPERATIONINVALID_PATHINVALID_FILENAME
使用方法
ファイルの場所とファイル名のパラメータは、FOPEN 関数に引用符付き文字列として指定する必要があります。これにより、ALL_DIRECTORIES ビューで指定されたアクセス可能ディレクトリリストに基づいてファイルの場所をチェックできます。
同時に開くファイルが50個を超えると、INVALID_OPERATION 例外が発生します。