连接转换
ODBC 连接具有以下状态。
| 状态 | 说明 |
|---|---|
| C0 | 未分配的环境、未分配的连接 |
| C1 | 分配的环境，未分配的连接 |
| C2 | 分配的环境，已分配的连接 |
| C3 | 连接函数需要数据 |
| C4 | 连接连接 |
| C5 | 连接的连接，已分配的语句 |
| C6 | 已连接连接，正在进行事务。 连接可能处于状态 C6，且未在连接上分配任何语句。 例如，假设连接处于手动提交模式，并且处于状态 C4。 如果分配了语句（启动事务），然后释放该事务，则该事务将保持活动状态，但连接上没有语句。 |
下表显示了每个 ODBC 函数如何影响连接状态。
SQLAllocHandle
| C0 无 Env。 |
C1 未分配 | C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| C1[1] | --[5] | --[5] | --[5] | --[5] | --[5] | --[5] |
| （IH）[2] | C2 | --[5] | --[5] | --[5] | --[5] | --[5] |
| （IH）[3] | （IH） | (08003) | (08003) | C5 | --[5] | --[5] |
| （IH）[4] | （IH） | (08003) | (08003) | --[5] | --[5] | --[5] |
[1] 此行显示 HandleType SQL_HANDLE_ENV时的转换。
[2] 此行显示 HandleType SQL_HANDLE_DBC时的转换。
[3] 当 HandleType SQL_HANDLE_STMT时，此行显示转换。
[4] 此行显示 HandleType SQL_HANDLE_DESC时的转换。
[5] 使用 OutputHandlePtr 调用 SQLAllocHandle，该句柄指向有效句柄会覆盖该句柄，而不考虑以前处理的内容，并可能导致 ODBC 驱动程序出现问题。 ODBC 应用程序编程不正确，使用为 *OutputHandlePtr 定义的同一应用程序变量调用 SQLAllocHandle 两次，而无需调用 SQLFreeHandle 释放句柄，然后再重新分配它。 以这种方式覆盖 ODBC 句柄可能会导致 ODBC 驱动程序的行为或错误不一致。
SQLBrowseConnect
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | C3 [d] C4 [s] | -- [d] C2 [e] C4 [s] | (08002) | (08002) | (08002) |
SQLCloseCursor
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | （IH） | （IH） | （IH） | -- | --[1] C5[2] |
[1] 连接处于手动提交模式。
[2] 连接处于自动提交模式。
SQLColumnPrivileges、SQLColumns、SQLForeignKeys、SQLGetTypeInfo、SQLPrimaryKeys、SQLProcedureColumns、SQLProcedures、SQLSpecialColumns、SQLStatistics、SQLTablePrivileges 和 SQLTables
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | （IH） | （IH） | （IH） | --[1] C6[2] | -- |
[1] 连接处于自动提交模式，或者数据源未开始事务。
[2] 连接处于手动提交模式，数据源开始事务。
SQLConnect
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | C4 | (08002) | (08002) | (08002) | (08002) |
SQLCopyDesc、SQLGetDescField、SQLGetDescRec、SQLSetDescField 和 SQLSetDescRec
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | （IH） | （IH） | --[1] | -- | -- |
[1] 在此状态下，应用程序可用的唯一描述符是显式分配的描述符。
SQLDataSources 和 SQLDrivers
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | -- | -- | -- | -- | -- | -- |
SQLDisconnect
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | (08003) | C2 | C2 | C2 | 25000 |
SQLDriverConnect
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | C4 s -- n[f] | (08002) | (08002) | (08002) | (08002) |
SQLEndTran
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH）[1] | --[3] | --[3] | --[3] | -- | -- | --[4] or （[5]， [6]， [8]） C4[5] 和 [7] C5[5]， [6]， 和 [9] |
| （IH）[2] | （IH） | (08003) | (08003) | -- | -- | C5 |
[1] 此行显示 HandleType SQL_HANDLE_ENV时的转换。
[2] 此行显示 HandleType SQL_HANDLE_DBC时的转换。
[3] 由于连接未处于连接状态，因此该连接不受事务影响。
[4] 连接上的提交或回滚失败。 在本例中，该函数返回SQL_ERROR。
[5] 连接上的提交或回滚成功。 如果提交或回滚在另一个连接上失败，则函数返回SQL_ERROR;如果提交或回滚在所有连接上成功，该函数将返回SQL_SUCCESS。
[6] 连接上至少分配了一个语句。
[7] 连接上没有分配任何语句。
[8] 连接至少有一条语句存在打开的游标，并且数据源在提交或回滚事务时保留游标，无论适用者（具体取决于 CompletionType 是SQL_COMMIT还是SQL_ROLLBACK）。 有关详细信息，请参阅 SQLGetInfo 中的SQL_CURSOR_COMMIT_BEHAVIOR和SQL_CURSOR_ROLLBACK_BEHAVIOR属性。
[9] 如果连接有任何语句存在打开的游标，则提交或回滚事务时不会保留游标。
SQLExecDirect 和 SQLExecute
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | （IH） | （IH） | （IH） | --[1] C6[2] C6[3] | -- |
[1] 连接处于自动提交模式，执行的语句不是游标规范（例如 SELECT 语句）;或者连接处于手动提交模式，并且执行的语句未开始事务。
[2] 连接处于自动提交模式，执行的语句是游标规范（如 SELECT 语句）。
[3] 连接处于手动提交模式，数据源开始事务。
SQLFreeHandle
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH）[1] | C0 | （HY010） | （HY010） | （HY010） | （HY010） | （HY010） |
| （IH）[2] | （IH） | （C1） | （HY010） | （HY010） | （HY010） | （HY010） |
| （IH）[3] | （IH） | （IH） | （IH） | （IH） | C4[5] --[6] | --[7] C4[5] 和 [8] C5[6] 和 [8] |
| （IH）[4] | （IH） | （IH） | （IH） | -- | -- | -- |
[1] 此行显示 HandleType SQL_HANDLE_ENV时的转换。
[2] 此行显示 HandleType SQL_HANDLE_DBC时的转换。
[3] 当 HandleType SQL_HANDLE_STMT时，此行显示转换。
[4] 此行显示 HandleType SQL_HANDLE_DESC时的转换。
[5] 连接上只分配了一个语句。
[6] 连接上分配了多个语句。
[7] 连接处于手动提交模式。
[8] 连接处于自动提交模式。
SQLFreeStmt
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH）[1] | （IH） | （IH） | （IH） | （IH） | -- | C5[3] --[4] |
| （IH）[2] | （IH） | （IH） | （IH） | （IH） | -- | -- |
[1] 当 Option 参数SQL_CLOSE时，此行显示事务。
[2] 当 Option 参数SQL_UNBIND或SQL_RESET_PARAMS时，此行显示事务。
[3] 连接处于自动提交模式，并且除了此语句之外的任何语句上都没有打开游标。
[4] 连接处于手动提交模式，或者处于自动提交模式，并且游标在至少一条其他语句上处于打开状态。
SQLGetConnectAttr
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| IH | IH | --[1] 08003[2] | HY010 | -- | -- | -- |
[1] 属性参数已SQL_ATTR_ACCESS_MODE、SQL_ATTR_AUTOCOMMIT、SQL_ATTR_LOGIN_TIMEOUT、SQL_ATTR_ODBC_CURSORS、SQL_ATTR_TRACE或SQL_ATTR_TRACEFILE，或者已为连接属性设置值。
[2] 属性 参数未SQL_ATTR_ACCESS_MODE、SQL_ATTR_AUTOCOMMIT、SQL_ATTR_LOGIN_TIMEOUT、SQL_ATTR_ODBC_CURSORS、SQL_ATTR_TRACE或SQL_ATTR_TRACEFILE，并且尚未为连接属性设置值。
SQLGetDiagField 和 SQLGetDiagRec
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH）[1] | -- | -- | -- | -- | -- | -- |
| （IH）[2] | （IH） | -- | -- | -- | -- | -- |
| （IH）[3] | （IH） | （IH） | （IH） | （IH） | -- | -- |
| （IH）[4] | （IH） | （IH） | （IH） | -- | -- | -- |
[1] 此行显示 HandleType SQL_HANDLE_ENV时的转换。
[2] 此行显示 HandleType SQL_HANDLE_DBC时的转换。
[3] 当 HandleType SQL_HANDLE_STMT时，此行显示转换。
[4] 此行显示 HandleType SQL_HANDLE_DESC时的转换。
SQLGetEnvAttr
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| IH | -- | -- | -- | -- | -- | -- |
SQLGetFunctions
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| IH | IH | HY010 | HY010 | -- | -- | -- |
SQLGetInfo
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| IH | IH | --[1] 08003[2] | 08003 | -- | -- | -- |
[1] InfoType 参数已SQL_ODBC_VER。
[2] InfoType 参数未SQL_ODBC_VER。
SQLMoreResults
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | （IH） | （IH） | （IH） | --[1] C6[2] | --[3] C5[1] |
[1] 连接处于自动提交模式，并且对 SQLMoreResults 的 调用尚未初始化游标规范的结果集的处理。
[2] 连接处于自动提交模式，对 SQLMoreResults 的调用已初始化游标规范的结果集的处理。
[3] 连接处于手动提交模式。
SQLNativeSql
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | (08003) | (08003) | -- | -- | -- |
SQLPrepare
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | （IH） | （IH） | （IH） | --[1] C6[2] | -- |
[1] 连接处于自动提交模式，或者数据源未开始事务。
[2] 连接处于手动提交模式，数据源开始事务。
SQLSetConnectAttr
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| IH | IH | --[1] 08003[2] | HY010 | --[3] 08002[4] HY011[5] | --[3] 08002[4] HY011[5] | --[3] 和 [6] C5[8] 08002[4] HY011[5] 或 [7] |
[1] Attribute 参数未SQL_ATTR_TRANSLATE_LIB或SQL_ATTR_TRANSLATE_OPTION。
[2] 属性参数SQL_ATTR_TRANSLATE_LIB或SQL_ATTR_TRANSLATE_OPTION。
[3] Attribute 参数未SQL_ATTR_ODBC_CURSORS或SQL_ATTR_PACKET_SIZE。
[4] 属性参数SQL_ATTR_ODBC_CURSORS。
[5] 属性参数SQL_ATTR_PACKET_SIZE。
[6] Attribute 参数未SQL_ATTR_AUTOCOMMIT，或者 Attribute 参数SQL_ATTR_AUTOCOMMIT设置此属性未提交事务。
[7] 属性参数SQL_ATTR_TXN_ISOLATION。
[8] 属性参数SQL_ATTR_AUTOCOMMIT，并设置此属性提交事务。
SQLSetEnvAttr
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | -- | -- | （HY010） | -- | -- | -- |
所有其他 ODBC 函数
| C0 无 Env。 |
C1 未分配 |
C2 已分配 |
C3 需要数据 |
C4 已连接 |
C5 语句 |
C6 事务 |
|---|---|---|---|---|---|---|
| （IH） | （IH） | （IH） | （IH） | （IH） | -- | -- |