达梦(DM)数据库相关方法DM_CREATE_CHANGE_DATA_CAPTURE

DM_CREATE_CHANGE_DATA_CAPTURE

定义：

DMBOOL DM_CREATE_CHANGE_DATA_CAPTURE(

#IF CPT_WITH_API

DHCON CON_HDBC,

#ELSE

VOID *PIDAO_CONNECTION,

#ENDIF

SDBYTE* SCHNAME,

SDBYTE* TVNAME,

SDBYTE* WHERES,

CPT_COL_DEF_T* COL_DEFS,

UDINT2 N_COLS,

SDBYTE* CDC_ID,

UDINT4 CDC_ID_LEN,

SDBYTE* CDC_BLOB_ID,

UDINT4 CDC_BLOB_ID_LEN,

CPT_ERROR_INFO_T* ERROR_INFO

);

功能说明：

打开数据捕获的 DPI 接口。

参数说明：

CON_HDBC：输入参数，数据库连接句柄。

PIDAO_CONNECTION：输入参数，IDAO_CONNECTION 接口指针。

SCHNAME：输入参数，捕获对象所属模式，不允许使用带有下划线的模式名，否则会

出现错误。

TVNAME：输入参数，捕获表/视图名。

WHERES：输入参数，捕获条件，条件中需明确指定新值或旧值作为条件，若没有条

件，则设为空串”  ”。如何使用 WHERE 条件？视图捕获，允许指定 WHERE 条件，但是不

允许指定新值旧值的指定，视图中没有没有这些概念。举例如下：

例 1：监控 C1 列中，为 20 的数据变化（新值或者旧值为 20）；

WHERE  为：’C1 = 20’；

例 2：监控 C2 列中，大于 20 同时小于 60 的值（新值旧值在区间(20,60)）；

WHERE  为：’C2 > 20 AND C2 < 60’  ；

例 3：监控 C1 列中，旧值>100 的数据变化并且 C2  为零的数据变化；

WHERE  为：’OLD.C1 > 100 AND C2 = 0’；

COL_DEFS：输入参数，字段描述。

N_COLS：输入参数，捕获字段数。n_cols 和 col_defs 必须一致，否则可能发生不可预

知的错误

CDC_ID：输出参数，捕获请求标识，对应变化表名。

CDC_ID_LEN：输入参数，标识缓冲区长度，建议需大于等于 129。

CDC_BLOB_ID：输出参数，捕获请求标识，对应变化大字段表表名。

CDC_BLOB_ID_LEN：输入参数，大字段标识缓冲区长度，建议需大于等于 129。

ERROR_INFO：输出参数，操作产生错误的原因。