Product Documentation

c-treeDB API API for C

Previous Topic

Next Topic

ctdbSetFieldHotAlterCallbackFunction

Set the field hot alter table callback function.

Declaration

CTDBRET ctdbDECL ctdbSetFieldHotAlterCallbackFunction(CTHANDLE Handle, cpTEXT functionName)

Description

FairCom DB now supports passing the names of a shared library and a field conversion function to the hot alter table function. This permits application developers to set a user-defined field conversion function to convert field values from one version of a schema to another version.

We now extend our c-treeDB API API to specify the conversion callback library at a table level and the callback conversion function name at a field level. If the callback library name at table level is not specified, we retrieve the last one used. If no callback library has ever been specified, we return an error.

Returns

ctdbSetFieldHotAlterCallbackFunction() returns CTDBRET_OK on success, or a c-treeDB API API C API error code on failure.

See also

c-treeDB API API Functions for User-Defined Hot Alter Table Field Conversion Callback

ctdbGetTableHotAlterCallbackLib

ctdbSetTableHotAlterCallbackLib

TOCIndex