DB2 CLI 函数摘要

表 29 是有关 DB2 Everyplace 支持的 DB2 CLI 函数的摘要,包括每个函数的用途以及 DB2 Everyplace 支持的 DB2 CLI 函数与标准 DB2 CLI 函数之间差异的摘要。

表 29. DB2 CLI 函数列表

函数名 用途 差别摘要
SQLAllocConnect 获取连接句柄。
SQLAllocEnv 获取环境句柄。
SQLAllocHandle 获取句柄。
SQLAllocStmt 分配语句句柄。
SQLBindCol 指定结果列的存储器并指定数据类型。 目标类型限制为支持的数据类型。不支持 LOB 定位器。
SQLBindParameter 在 SQL 语句中为参数指定存储器。 不支持绑定至应用程序变量或 LOB 定位器的数组。因为不支持 SQLPutData(),所以在调用 SQLExecute() 之前应用程序应将参数的值放在 ParameterValuePtr 中。因为不支持存储过程,所以参数类型只被限定为 INPUT。
SQLColumns 返回指定表中的列名列表。 CatalogNameNameLength1SchemaNameNameLength2 被忽略。返回的结果集的第 2、12 和 15 列总是 NULL。不支持返回码 SQL_STILL_EXECUTING。
SQLConnect 按数据源名、用户标识和密码连接特定驱动程序。
SQLDescribeCol 描述结果集中的列。 列信息由支持的列数据类型限制。
SQLDisconnect 关闭连接。
SQLEndTran 在与连接相关联的所有语句上为所有操作请求 COMMIT 或 ROLLBACK。 在调用 SQLEndTran() 之前,必须将连接属性 SQL_ATTR_AUTOCOMMIT 设置为 SQL_AUTOCOMMIT_OFF。
SQLError 返回其它错误或状态信息。
SQLExecDirect 执行语句。 不支持返回码 SQL_STILL_EXECUTING 和 SQL_NEED_DATA。不支持异步 CLI 调用。
SQLExecute 执行已准备的语句。 在调用 SQLExecute() 之前必须绑定所有参数。不支持 SQL 调用的异步执行。
SQLFetch 返回结果行。 结果每次取装一行,而不是按行集取装。不支持语句描述符。不支持返回码 SQL_STILL_EXECUTING。
SQLFetchScroll 返回结果行集。 按行集取装结果。不支持返回码 SQL_STILL_EXECUTING。
SQLForeignKeys 返回关于指定表的外键的信息。 忽略 PKCatalogNameNameLength1PKSchemaNameNameLength2FKCatalogNameNameLength4FKSchemaNameNameLength5。返回的结果集的第 1、2、5、6、12 和 13 列总是长度为零的字符串。返回的结果集的第 10、11和 14 列总是零。不支持返回码 SQL_STILL_EXECUTING。
SQLFreeConnect 释放连接句柄。
SQLFreeEnv 释放环境句柄。
SQLFreeHandle 释放句柄资源。
SQLFreeStmt 结束语句处理,废弃暂挂结果,并可选择释放与语句句柄相关联的所有资源。 仅支持 SQL_DROP 和 SQL_RESET_PARAMS 选项。
SQLGetConnectAttr 返回连接属性的当前设置。 DB2 Everyplace 支持 DB2 支持的连接属性的子集。DB2 Everyplace 还支持一些 DB2 不支持的连接属性。
SQLGetCursorName 返回与语句句柄相关联的游标名。 内部生成的游标名总是以 CUR 开头。
SQLGetData 返回结果集一行中一列的部分或全部。 目标类型限制为支持的数据类型。不支持 LOB 定位器。不支持返回码 SQL_STILL_EXECUTING。
SQLGetDiagRec 获取诊断数据的多个字段。 仅支持与语句句柄或连接句柄相关联的诊断记录。仅支持单个诊断记录。
SQLGetInfo 返回有关特定驱动程序和数据源的信息。 DB2 Everyplace 支持 DB2 支持的信息类型的子集。
SQLGetStmtAttr 返回语句属性的当前设置。 DB2 Everyplace 支持 DB2 支持的语句属性的子集。DB2 Everyplace 还支持一些 DB2 不支持的语句属性。
SQLNumParams 返回 SQL 语句中的参数标记的数目。 不支持返回码 SQL_STILL_EXECUTING。
SQLNumResultCols 返回结果集中的列数。
SQLPrepare 为稍后的执行准备 SQL 语句。
SQLPrimaryKeys 返回由表的主键组成的列名的列表。 CatalogNameNameLength1SchemaNameNameLength2 被忽略。返回的结果集的第 1、2 和 6 列总是长度为零的字符串。不支持返回码 SQL_STILL_EXECUTING。
SQLRowCount 返回受插入、更新或删除请求影响的行数。
SQLSetConnectAttr 设置与连接相关的选项。 DB2 Everyplace 支持 DB2 支持的连接属性的子集。DB2 Everyplace 还支持一些 DB2 不支持的连接属性。
SQLSetStmtAttr 设置与语句相关的选项。 DB2 Everyplace 支持 DB2 支持的语句属性的子集。DB2 Everyplace 还支持一些 DB2 不支持的语句属性。
SQLTables 返回存储在特定数据源中的表名的列表。 将忽略 CatalogNameNameLength1SchemaNameNameLength2TableTypeNameLength4。DB2 Everyplace 仅支持类型“TABLE”。不支持返回码 SQL_STILL_EXECUTING。

相关参考