OCIDirPathDataSave()

Purpose

Depending on the action requested, does a data savepoint, or commits the loaded data and finishes the direct path load operation.

Syntax

sword OCIDirPathDataSave ( OCIDirPathCtx          *dpctx,
                           OCIError               *errhp,
                           ub4                    action  ); 

Parameters

dpctx (IN)

Direct path context handle for the object loaded.

errhp (IN/OUT)

An error handle you can pass to OCIErrorGet() for diagnostic information in the event of an error.

action (IN)

Values for action parameter to OCIDirPathDataSave():

• OCI_DIRPATH_DATASAVE_SAVEONLY - to execute a data savepoint only.
• OCI_DIRPATH_DATASAVE_FINISH - to commit the loaded data and call the direct finishing function.

Comments

A return value of OCI_SUCCESS indicates that the back-end has properly executed a data savepoint or executed the finishing logic.

Executing a data savepoint is not allowed for LOBs.

Executing the finishing logic is not the same as properly terminating the load, because resources allocated are not freed.

Related Functions

OCIDirPathAbort(), OCIDirPathFinish(), OCIDirPathFlushRow(), OCIDirPathPrepare(), OCIDirPathStreamReset()