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 の取得を読み取り前に行わせることができます。