WRITEAPPEND ストアドプロシージャは、指定された量のデータを内部 LOB の末尾に書き込みます。データは buffer パラメータによって書き込まれます。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
構文
DBMS_LOB.WRITEAPPEND (
lob_loc IN OUT NOCOPY BLOB,
amount IN INTEGER,
buffer IN RAW);
DBMS_LOB.WRITEAPPEND (
lob_loc IN OUT NOCOPY CLOB CHARACTER SET ANY_CS,
amount IN INTEGER,
buffer IN VARCHAR2 CHARACTER SET ANY_CS);
パラメータの説明
パラメータ |
説明 |
|---|---|
| lob_loc | 内部 LOB データを書き込むためのロケーターです。DBMS_LOBの使用方法を参照してください。 |
| amount | 書き込むバイト数（BLOBの場合）または文字数（CLOBの場合）。 |
| buffer | 書き込み用の入力バッファー。 |
説明
入力量がバッファ内のデータより大きい場合、エラーが発生します。入力量がバッファ内のデータより小さい場合、バッファ内のバイトまたは文字数だけが LOB の末尾に書き込まれます。
例外状況
Exception |
Description |
|---|---|
| VALUE_ERROR | lob_loc、amount、または offset のいずれかのパラメータが NULL、範囲外、または無効です。 |
| INVALID_ARGVAL | 以下のいずれかの場合：
|
| QUERY_WRITE | クエリまたはPDML並列実行サーバーで LOB 書き込みを実行できません。 |
| BUFFERING_ENABLED | LOB でバッファリングが有効になっている場合、その状態で操作を実行できません。 |
使用方法
VARCHARバッファの形式は、CLOBパラメータの形式と一致している必要があります。入力されたLOBパラメータのタイプがCLOBの場合、バッファにはCHARデータを含める必要があります。クライアントから
DBMS_LOB_WRITEAPPENDを呼び出す際（例えば、OBClient のBEGIN/ENDブロック内で）、バッファにはクライアント文字セットのデータを含める必要があります。バッファデータをLOBに書き込む前に、データベースはクライアントバッファをサーバーの文字セットに変換します。LOB操作を Open/Close インターフェースで囲む必要はありません。操作を実行する前にLOBを開いていない場合、呼び出し中にLOB列上の機能インデックスとドメインインデックスが更新されます。しかし、操作を実行する前にLOBを開いている場合は、トランザクションをコミットする前にそれを閉じる必要があります。内部LOBを閉じると、LOB列上の機能インデックスとドメインインデックスが更新されます。LOB操作を Open/Close API で囲まない場合、LOBに書き込むたびに機能インデックスとドメインインデックスが更新されます。これはパフォーマンスに悪影響を及ぼします。そのため、LOBへの書き込み操作はOPENまたはCLOSEステートメント内に含めることを推奨します。必要に応じて、
WRITEAPPENDはLOBに追加する前にLOBを取得します。