PDF (Ltr)- 5.2 mb
PDF (A4)- 5.2 mb
本节根据功能分类,总结ODBC例程。
有关完整的ODBC API参考,请参阅ODBC程序员参考http://msdn.microsoft.com/en-us/library/ms714177.aspx.
应用程序可以调用SQLGetInfo
函数获取有关Connector/ODBC的一致性信息。要获得驱动程序中特定功能的支持信息,应用程序可以调用sqlget函数
.
请注意
为了向后兼容,Connector/ODBC驱动程序支持所有已弃用的功能。
下表列出了按任务分组的连接器/ODBC API调用:
表5.5连接数据源的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
SQLAllocHandle |
是的 | ISO 92 | 获取环境、连接、语句或描述符句柄。 |
SQLConnect |
是的 | ISO 92 | 通过数据源名称、用户ID和密码连接到特定驱动程序。 |
SQLDriverConnect |
是的 | ODBC | 通过连接字符串或要求驱动程序管理器和驱动程序为用户显示连接对话框连接到特定的驱动程序。 |
SQLAllocEnv |
是的 | 弃用 | 获取从驱动程序分配的环境句柄。 |
SQLAllocConnect |
是的 | 弃用 | 获取连接句柄 |
表5.6获取驱动程序和数据源信息的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
SQLDataSources |
没有 | ISO 92 | 返回由驱动程序管理器处理的可用数据源列表 |
SQLDrivers |
没有 | ODBC | 返回已安装驱动程序及其属性的列表,由驱动程序管理器处理 |
SQLGetInfo |
是的 | ISO 92 | 返回有关特定驱动程序和数据源的信息。 |
sqlget函数 |
是的 | ISO 92 | 返回支持的驱动程序函数。 |
SQLGetTypeInfo |
是的 | ISO 92 | 返回有关支持的数据类型的信息。 |
表5.7设置和检索驱动程序属性的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
SQLSetConnectAttr |
是的 | ISO 92 | 设置连接属性。 |
SQLGetConnectAttr |
是的 | ISO 92 | 返回连接属性的值。 |
SQLSetConnectOption |
是的 | 弃用 | 设置连接选项 |
SQLGetConnectOption |
是的 | 弃用 | 返回连接选项的值 |
SQLSetEnvAttr |
是的 | ISO 92 | 设置环境属性。 |
SQLGetEnvAttr |
是的 | ISO 92 | 返回环境属性的值。 |
SQLSetStmtAttr |
是的 | ISO 92 | 设置语句属性。 |
SQLGetStmtAttr |
是的 | ISO 92 | 返回语句属性的值。 |
SQLSetStmtOption |
是的 | 弃用 | 设置语句选项 |
SQLGetStmtOption |
是的 | 弃用 | 返回语句选项的值 |
表5.8准备SQL请求的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
SQLAllocStmt |
是的 | 弃用 | 分配语句句柄 |
SQLPrepare |
是的 | ISO 92 | 准备SQL语句以供以后执行。 |
SQLBindParameter |
是的 | ODBC | 为SQL语句中的参数分配存储空间。Connector/ODBC 5.2增加了对”出”而且”inout”参数,通过SQL_PARAM_OUTPUT 或SQL_PARAM_INPUT_OUTPUT 类型说明符。(”出”而且”inout”参数不支持量变 而且LONGBLOB 列。) |
SQLGetCursorName |
是的 | ISO 92 | 返回与语句句柄关联的游标名称。 |
SQLSetCursorName |
是的 | ISO 92 | 指定游标名称。 |
SQLSetScrollOptions |
是的 | ODBC | 设置控制游标行为的选项。 |
表5.9提交请求的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
SQLExecute |
是的 | ISO 92 | 执行一个准备好的语句。 |
SQLExecDirect |
是的 | ISO 92 | 执行一个语句 |
SQLNativeSql |
是的 | ODBC | 返回由驱动程序翻译的SQL语句的文本。 |
SQLDescribeParam |
没有 | ODBC | 返回语句中特定参数的说明。Connector/ odbc不支持—返回的结果不可信。 |
SQLNumParams |
是的 | ISO 92 | 返回语句中参数的数量。 |
SQLParamData |
是的 | ISO 92 | 与SQLPutData 在执行时提供参数数据。(对于长数据值很有用。) |
SQLPutData |
是的 | ISO 92 | 发送参数的部分或全部数据值。(对于长数据值很有用。) |
表5.10检索结果和关于结果的信息的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
SQLRowCount |
是的 | ISO 92 | 返回受插入、更新或删除请求影响的行数。 |
SQLNumResultCols |
是的 | ISO 92 | 返回结果集中的列数。 |
SQLDescribeCol |
是的 | ISO 92 | 描述结果集中的列。 |
SQLColAttribute |
是的 | ISO 92 | 描述结果集中列的属性。 |
SQLColAttributes |
是的 | 弃用 | 描述结果集中列的属性。 |
SQLFetch |
是的 | ISO 92 | 返回多个结果行。 |
SQLFetchScroll |
是的 | ISO 92 | 返回可滚动的结果行。 |
SQLExtendedFetch |
是的 | 弃用 | 返回可滚动的结果行。 |
SQLSetPos |
是的 | ODBC | 在获取的数据块中定位游标,并使应用程序能够刷新行集中的数据或更新或删除结果集中的数据。 |
SQLBulkOperations |
是的 | ODBC | 执行大容量插入和大容量书签操作,包括按书签更新、删除和获取。 |
表5.11检索错误或诊断信息的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
SQLError |
是的 | 弃用 | 返回附加的错误或状态信息 |
SQLGetDiagField |
是的 | ISO 92 | 返回附加的诊断信息(诊断数据结构的单个字段)。 |
SQLGetDiagRec |
是的 | ISO 92 | 返回附加的诊断信息(诊断数据结构的多个字段)。 |
表5.12获取数据源系统表(目录函数)信息的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
SQLColumnPrivileges |
是的 | ODBC | 返回一个或多个表的列列表和关联特权。 |
SQLColumns |
是的 | X /开放 | 返回指定表中的列名列表。 |
SQLForeignKeys |
是的 | ODBC | 返回组成外键的列名列表(如果外键对于指定表存在)。 |
SQLPrimaryKeys |
是的 | ODBC | 返回构成表主键的列名列表。 |
SQLSpecialColumns |
是的 | X /开放 | 返回关于惟一标识指定表中一行的最佳列集的信息,或者当事务更新行中的任何值时自动更新的列的信息。 |
SQLStatistics |
是的 | ISO 92 | 返回关于单个表和与该表关联的索引列表的统计信息。 |
SQLTablePrivileges |
是的 | ODBC | 返回表的列表以及与每个表相关的特权。 |
SQLTables |
是的 | X /开放 | 返回存储在特定数据源中的表名列表。 |
表5.14终止语句的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
SQLFreeStmt |
是的 | ISO 92 | 结束语句处理,丢弃挂起的结果,并可选地释放与语句句柄关联的所有资源。 |
SQLCloseCursor |
是的 | ISO 92 | 关闭已在语句句柄上打开的游标。 |
SQLCancel |
是的 | ISO 92 | 取消SQL语句。 |
表5.15终止连接的ODBC API调用
函数名 | 连接器/ ODBC支持吗? | 标准 | 目的 |
---|---|---|---|
柄 |
是的 | ISO 92 | 关闭连接。 |
SQLFreeHandle |
是的 | ISO 92 | 释放环境、连接、语句或描述符句柄。 |
SQLFreeConnect |
是的 | 弃用 | 释放连接句柄。 |
SQLFreeEnv |
是的 | 弃用 | 释放一个环境句柄。 |