OCI编程高级篇（十五） 设置字段数据入口

设置完字段信息之后，就要设置字段数据的入口，这里用到的函数叫做OCIDirPathColArrayEntrySet()，在这之前要进行直接路径装载准备工作，用到的函数为OCIDirPathPrepare()，我们分别来看一下这两个函数。

sword OCIDirPathPrepare ( OCIDirPathCtx *dpctx,
    OCISvcCtx  *svchp,
    OCIError     *errhp );

dpctx是一个输入参数，是直接路径装载的上下文句柄。

svchp是一个输入参数，是OCI服务句柄。

errhp是一个输入/输出参数，错误句柄，用于返回错误码和错误信息文本。

sword OCIDirPathColArrayEntrySet ( OCIDirPathColArray *dpca,
    OCIError *errhp,
    ub4          rownum,
    ub2          colIdx,
    ub1          *cvalp,
    ub4          clen,
    ub1          cflg );

dpca是一个输入/输出参数，是直接路径装载字段数组句柄。

errhp是一个输入参数，错误句柄，返回错误码和错误信息文本。

rownum是一个输入参数，数据的行号，从0开始计数。

colIdx是一个输入参数，列的索引，用于构建列参数列表，从0开始。

cvalp是一个输入参数，指向列的数值。

clen是一个输入参数，列数据长度。

cflg是一个输入参数，列的标志位，OCI_DIRPATH_COL_COMPLETE表示提供了整列数据，OCI_DIRPATH_COL_NULL表示列数据为NULL，OCI_DIRPATH_COL_PARTIAL表示提供了部分列数据。

OCIDirPathPrepare()函数很好理解，就是为列数据到流数据的转换做准备。

OCIDirPathColArrayEntrySet()函数从参数中看到，它把数据在这里就划分好了行和列，就是表的结构，等于把表格中的每一格都用一个数据入口对应起来。

我们还是用上面创建的表为例，看看怎样设置数据入口。

​OCIEnv		*envhp = NULL;
OCIError	*errhp = NULL;
OCIServer	*svrhp = NULL;
OCISession	*usrhp = NULL;
OCISvcCtx	*svchp = NULL;


int set_dp_data(void)
{
    int                  i;
    OCIDirPathCtx        *dpctx;
    OCIDirPathColArray   *dpca;
    OCIDirPathStream     *dpstr;
    ub4                  id[10];
    char                 name[10][32];
    char                 addr[10][256];


    /* 在这里生成数据，10行 */
    for (i=0; i<10; i++) {
        id[i] = i + 100;
        strcpy(name[i], "AAAAAAAA");
        strcpy(addr[i], "BBBBBBBBBBB");
    }

    /* 通过for循环设置每行每个字段的数据入口 */
    for (i=0; i<10; i++) {
        /* 设置每行ID字段的数据地址 */
        if (check_oci_error(errhp,
            OCIDirPathColArrayEntrySet(dpca, errhp, (ub4)i, (ub2)0,
                (ub1*)&id[i], 4, OCI_DIRPATH_COL_COMPLETE)
            ) < 0)
            return (-1);

        /* 设置每行NAME字段的数据地址 */
        if (check_oci_error(errhp,
            OCIDirPathColArrayEntrySet(dpca, errhp, (ub4)i, (ub2)1,
                (ub1 *)name[i], (ub4)strlen(name[i]), OCI_DIRPATH_COL_COMPLETE)
            ) < 0)
            return (-1);

        /* 设置每行ADDR字段的数据地址 */
        if (check_oci_error(errhp,
            OCIDirPathColArrayEntrySet(dpca, errhp, (ub4)i, (ub2)2,
                (ub1 *)addr[i], (ub4)strlen(addr[i]), OCI_DIRPATH_COL_COMPLETE)
            ) < 0)
            return (-1);
    }

    /* 到这里，字段数据入口就设置好了，下一节继续 */


    return (0);
}

​

设置完数据入口，直接路径装载中几个复杂的部分就操作完了，剩下的就是转换数据，装载数据，提交数据了，下一节我们会介绍这些函数。到最后我们会总结一下整个的直接路径装载过程，然后通过一个完整的例子，用代码演示装载的过程。