FILEOPEN

FILEOPENファンクションは、ファイルを開き、それにファイル・ユニット番号(不定のINTEGER)を割り当て、その番号を返します。その後でそのファイルを参照する場合、ファイル名ではなくこのファイル・ユニット番号を使用します。Oracle OLAPがファイルを開くことができない場合、エラーが発生します。

関連項目:

OUTFILE

戻り値

INTEGER

構文

FILEOPEN(file-name {READ|WRITE|APPEND} [BINARY]) [NLS_CHARSET charset-exp]

パラメータ

file-name

開くファイルの名前を指定するテキスト式。そのファイルがカレント・ディレクトリにない場合、ファイルの名前にディレクトリ・オブジェクトの名前を含める必要があります。

注意:

ディレクトリ・オブジェクトはデータベースで定義され、ディレクトリおよびディレクトリ内のファイルへのアクセスを制御します。CDA文を使用して、カレント・ディレクトリ・オブジェクトを特定および指定できます。使用するデータベース・ユーザー名で読取りおよび書込み可能なファイルがあるディレクトリ・オブジェクトへのアクセス権については、Oracle DBAに問い合せてください。

READ

(省略形はR)読取り用としてファイルを開きます。

WRITE

(省略形はW)書込み用としてファイルを開きます。ファイル・アクセスはファイルの先頭から開始されます。したがって、既存のファイルをWRITEモードで開くと、ファイルにデータが書き込まれる前にそのすべての内容が消去されます。

APPEND

書込み用としてファイルを開きます。ファイル・アクセスはファイルの末尾から開始され、既存の内容にデータが追加されます。

BINARY

バイナリ形式のファイル(パック・データまたはバイナリ・データのファイル)を開きます。BINARYを指定すると、Oracle OLAPはファイル内のすべての文字をデータとして認識します。レコードの終端の指定に改行文字を使用しない場合、固定長のレコードとみなされ、レコード長はFILESET(...LSIZE)で設定できます。デフォルトのレコード長は80です。

NLS_CHARSET charset-exp

file-nameによって指定されるファイルからデータを読み取る際にOracle OLAPが使用するキャラクタ・セットを指定します。この引数を省略すると、Oracle OLAPでは、ファイルのデータは、NLS_LANGオプションに記録されているデータベース・キャラクタ・セットを持つものとして処理されます。

使用上の注意

ファイル・ユニットの数

同時に開くことができるファイルの数は、オペレーティング・システムの設定と同じです。

アクセス・モード

アクセス・モード(READ、WRITEまたはAPPEND)は、ファイルに適したものを指定する必要があります。

例

例7-91 プログラムに渡される引数があるFILEOPEN

次のプログラムの行は、プログラム引数として指定された名前のファイルを開き、ファイル・ユニット番号を変数fil.unitに保存します。

fil.unit = FILEOPEN(ARG(1), READ)

例7-92 バイナリ・ファイルのFILEOPEN

次の文は、バイナリ・ファイルを開き、レコード長を設定します。

VARIABLE filenum INTEGER
filenum = FILEOPEN('mydata' READ BINARY)
FILESET filenum LSIZE 132