xp_read_file システムプロシージャー

xp_read_file( filename [, lazy ] )

filename 内容を返す対象ファイルの名前を指定する LONG VARCHAR パラメーター。
lazy この任意の INTEGER パラメーターを指定し、その値が 0 以外の場合、ファイルの内容は要求されるまで読み込まれません。読み込みが行われるのは、LONG BINARY 値へのアクセス時のみです。また、その対象はファイル内の要求された部分のみです。デフォルトは 0 (non-lazy) です。

この関数は指定したファイルの内容を読み込んで、結果を LONG BINARY 変数として返します。

filename には、データベースサーバーの開始ディレクトリからの相対ファイル名を指定します。

この関数は、ファイルに保存されているドキュメントやイメージ全体をテーブルに挿入するときに役立ちます。ファイルが読み込めない場合は、関数は NULL を返します。

データファイルの文字セットが異なる場合は、CSCONVERT 関数を使用すると文字セットを変換できます。

また、CSCONVERT 関数を使用すると、xp_read_file システムプロシージャーを使用するときに発生する文字セット変換の要件に対処できます。

DBA 権限。

次の文は、テーブル t1 のカラム picture にイメージを挿入します (他のすべてのカラムが NULL を受け入れることができると仮定しています)。

INSERT INTO t1 ( picture )
   SELECT xp_read_file( 'portrait.gif' );