The APPEND stored procedure appends the content of an internal source LOB to a target LOB.
Applicability
This topic applies only to OceanBase Database Enterprise Edition. OceanBase Database Community Edition does not support this feature.
Syntax
DBMS_LOB. APPEND (
dest_lob IN OUT NOCOPY BLOB,
src_lob IN BLOB);
DBMS_LOB.APPEND (
dest_lob IN OUT NOCOPY CLOB CHARACTER SET ANY_CS,
src_lob IN CLOB CHARACTER SET ANY_CS);
Parameters
| Parameter | Description |
|---|---|
| dest_lob | The locator of the internal LOB to which data is appended. |
| src_lob | The locator of the internal LOB from which data is read. |
Exceptions
| Exception | Description |
|---|---|
| VALUE_ERROR | The source LOB or the destination LOB is NULL. |
| QUERY_WRITE | The LOB write operation cannot be performed in a query or in a parallel DML server. |
| BUFFERING_ENABLED | If buffering is enabled for any LOB, the operation cannot be performed when buffering is enabled for the LOB. |
Considerations
You do not have to wrap
LOBoperations in the Open/Close interface. If you do not open aLOBbefore performing an operation, the function index and domain index on theLOBcolumn will be updated during the operation. However, if you open aLOBbefore performing an operation, you must close it before committing the transaction. When you close an internalLOB, the function index and domain index on theLOBcolumn will be updated.If you do not wrap
LOBoperations in the Open/Close interface, the function index and domain index on theLOBcolumn will be updated every time you write to theLOB. To avoid affecting performance, we recommend that you includeLOBwrite operations inOPENorCLOSEstatements.If you call
APPENDon an archivedLOB, it will implicitly acquire theLOBbefore writing the first byte.
