READ

READ ステートメントは、LOB で始まる指定されたオフセットからデータを読み取り、buffer パラメータに返すために使用されます。

amountパラメータには、実際に読み取られたバイト数または文字数が返されます。入力されたオフセットが LOB の末尾を超える場合、amount は0に設定され、NO_DATA_FOUND例外が発生します。

構文

DBMS_LOB.READ (
lob_loc   IN             BLOB,
amount    IN OUT NOCOPY  INTEGER,
offset    IN             INTEGER,
buffer    OUT            RAW);

DBMS_LOB.READ (
lob_loc   IN             CLOB CHARACTER SET ANY_CS,
amount    IN OUT NOCOPY  INTEGER,
offset    IN             INTEGER,
buffer    OUT            VARCHAR2 CHARACTER SET ANY_CS);

パラメータの説明

異常時の動作

使用方法

• VARCHAR2 バッファの形式は、CLOB パラメータの形式と一致していなければなりません。言い換えれば、入力される LOB パラメータのタイプが CLOB の場合、バッファには CHAR データを含める必要があります。

• クライアントから DBMS_LOB.READ を呼び出すと、返されるバッファの値にはクライアント文字セットのデータが含まれます。バッファの値をユーザーに返す前に、データベースはサーバーの文字セットから LOB 値をクライアントの文字セットに変換します。

• 必要に応じて、READ によって読み取り前に LOB を取得させることができます。