FOPEN関数は、ユーザーが指定した情報に基づいてファイルを開くために使用されます。システムは同時に最大50個のファイルを開くことができます。
適用対象
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
構文
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
使用方法
ファイルの場所とファイル名のパラメータは、ALL_DIRECTORIES ビューで指定されたアクセス可能なディレクトリリストに基づいてファイルの場所をチェックできるように、引用符付き文字列として FOPEN 関数に提供する必要があります。
同時に開くファイルが50個を超えると、INVALID_OPERATION 例外が報告されます。