在 ODBC 3.8 和 Windows 7 SDK 之前, 是仅在语句函数上允许异步操作。 有关详细信息,请参阅以异步方式执行语句操作,本主题中更高版本。
Windows 7 SDK 中的 ODBC 3.8 引入了异步执行与连接相关的操作。 有关详细信息,请参阅以异步方式执行连接操作本主题后面的部分。
在 Windows 7 SDK 中,为异步语句或连接操作,将异步操作已完成使用轮询方法确定应用程序。 从 Windows 8 SDK 开始,您可以确定异步操作已完成使用的通知方法。 有关详细信息,请参阅异步执行 (通知方法)。
默认情况下,驱动程序执行 ODBC 函数以同步方式;也就是说,应用程序调用的函数和驱动程序才会返回控制对应用程序完成执行函数。 不过,可以以异步方式; 执行某些函数也就是说,应用程序调用该函数和驱动程序,最小处理后返回控制应用程序。 第一个函数仍在执行时,应用程序然后可以调用其他函数。
异步执行支持很大程度上在数据源上执行的大多数功能,如要建立的连接、 准备和执行 SQL 语句的函数检索元数据,提取数据,并提交事务。 数据源上当前正在执行任务所用较长的时间,如登录过程或复杂查询针对大型数据库时,它是最有用。
当应用程序执行的函数与语句或进行异步处理的连接时,驱动程序执行最少量的处理 (如检查有错误的参数)、 将传递到数据源,处理并返回控制对 SQL_STILL_EXECUTING 返回代码的应用程序。 然后,应用程序执行其他任务。 若要确定异步函数完成时,应用程序轮询该驱动程序按固定间隔通过调用具有作为其最初使用的相同参数的函数。 如果该函数仍在执行,它将返回 SQL_STILL_EXECUTING;如果它已完成执行,它将返回它具有它以同步方式执行,比如 SQL_SUCCESS、 SQL_ERROR 或 SQL_NEED_DATA 返回的代码。
函数执行同步或异步是特定的驱动程序。 例如,假设在驱动程序中缓存的结果集元数据。 在这种情况下,需要很少的时间来执行SQLDescribeCol和驱动程序应只需执行该函数而不是人为延迟执行。 另一方面,如果驱动程序需要从数据源检索元数据,它应返回控制应用程序时它执行此操作。 因此,应用程序必须能够处理 SQL_STILL_EXECUTING 之外的返回代码,首先以异步方式执行函数时。
以异步方式执行语句的操作
以下语句功能对数据源执行操作,并且能够以异步方式执行:
异步语句执行控制每个语句或在每个连接基础,具体取决于数据源上。 也就是说,应用程序不指定将特定的函数是以异步方式执行,但在特定语句上执行任何函数是以异步方式执行。 若要查找支持的一个扩展,应用程序调用SQLGetInfo SQL_ASYNC_MODE 的选项。 如果支持连接级别 (适用于语句句柄) 的异步执行,则,返回 SQL_AM_CONNECTION如果支持语句级异步执行,SQL_AM_STATEMENT。
若要指定使用特定的语句执行的函数是要以异步方式执行,则应用程序调用SQLSetStmtAttr与 SQL_ATTR_ASYNC_ENABLE 属性并将其设置为 SQL_ASYNC_ENABLE_ON。 如果支持连接级别异步处理,则将 sql_attr_async_enable 设置语句属性是只读的其值为已分配该语句的连接的连接属性相同。 它是特定于驱动程序的语句属性的值是否设置在语句分配时或更高版本。 尝试设置它将返回 SQL_ERROR 并且 SQLSTATE HYC00 (未实现的可选功能)。
若要指定与特定连接执行的函数是要以异步方式执行,则应用程序调用SQLSetConnectAttr与 SQL_ATTR_ASYNC_ENABLE 属性并将其设置为 SQL_ASYNC_ENABLE_ON。 将为在连接上分配的所有将来的语句句柄启用异步执行;它是驱动程序定义将通过此操作是否启用现有的语句句柄。 如果 SQL_ATTR_ASYNC_ENABLE 设置为 SQL_ASYNC_ENABLE_OFF,在连接上的所有语句都都在同步模式。 如果在连接上的活动语句时,启用异步执行,则返回错误。
若要确定在该驱动程序可以支持对给定连接的异步模式下的活动并发语句的最大数目,应用程序调用SQLGetInfo SQL_MAX_ASYNC_CONCURRENT_STATEMENTS 选项。
下面的代码演示了轮询模型的工作原理:
SQLHSTMT hstmt1;
SQLRETURN rc;
// Specify that the statement is to be executed asynchronously.
SQLSetStmtAttr(hstmt1, SQL_ATTR_ASYNC_ENABLE, SQL_ASYNC_ENABLE_ON, 0);
// Execute a SELECT statement asynchronously.
while ((rc=SQLExecDirect(hstmt1,"SELECT * FROM Orders",SQL_NTS))==SQL_STILL_EXECUTING) {
// While the statement is still executing, do something else.
// Do not use hstmt1, because it is being used asynchronously.
}
// When the statement has finished executing, retrieve the results.
函数以异步方式执行,而应用程序可以对任何其他语句调用函数。 应用程序也可以只与异步语句相关联的任何连接上调用函数。 但应用程序只能调用原始函数和 (不带语句句柄或其关联的连接,环境句柄) 的以下函数语句操作完成后返回 SQL_STILL_EXECUTING:
-
SQLCancelHandle (对语句句柄)
如果应用程序调用任何其他函数使用异步语句或者使用与该语句相关联的连接,则该函数将返回 SQLSTATE HY010 (函数序列错误),例如。
SQLHDBC hdbc1, hdbc2;
SQLHSTMT hstmt1, hstmt2, hstmt3;
SQLCHAR * SQLStatement = "SELECT * FROM Orders";
SQLUINTEGER InfoValue;
SQLRETURN rc;
SQLAllocHandle(SQL_HANDLE_STMT, hdbc1, &hstmt1);
SQLAllocHandle(SQL_HANDLE_STMT, hdbc1, &hstmt2);
SQLAllocHandle(SQL_HANDLE_STMT, hdbc2, &hstmt3);
// Specify that hstmt1 is to be executed asynchronously.
SQLSetStmtAttr(hstmt1, SQL_ATTR_ASYNC_ENABLE, SQL_ASYNC_ENABLE_ON, 0);
// Execute hstmt1 asynchronously.
while ((rc = SQLExecDirect(hstmt1, SQLStatement, SQL_NTS)) == SQL_STILL_EXECUTING) {
// The following calls return HY010 because the previous call to
// SQLExecDirect is still executing asynchronously on hstmt1. The
// first call uses hstmt1 and the second call uses hdbc1, on which
// hstmt1 is allocated.
SQLExecDirect(hstmt1, SQLStatement, SQL_NTS); // Error!
SQLGetInfo(hdbc1, SQL_UNION, (SQLPOINTER) &InfoValue, 0, NULL); // Error!
// The following calls do not return errors. They use a statement
// handle other than hstmt1 or a connection handle other than hdbc1.
SQLExecDirect(hstmt2, SQLStatement, SQL_NTS); // OK
SQLTables(hstmt3, NULL, 0, NULL, 0, NULL, 0, NULL, 0); // OK
SQLGetInfo(hdbc2, SQL_UNION, (SQLPOINTER) &InfoValue, 0, NULL); // OK
}
当应用程序调用一个函数来确定是否仍在执行以异步方式时,它必须使用原始语句句柄。 这是因为在每个语句的基础上跟踪异步执行。 应用程序还必须提供有效的其他自变量的值 — 原始参数将执行操作,获取过去的错误检查驱动程序管理器中。 但是,该驱动程序检查语句句柄,并确定以异步方式执行该语句后,它会忽略所有其他参数。
以异步方式执行函数时,使用 — 也就是说,它返回 SQL_STILL_EXECUTING 之后,并在它返回不同的代码 — 应用程序可以将其取消通过调用SQLCancel或SQLCancelHandle具有相同的语句句柄。 这不保证取消函数执行。 例如,该函数可能具有已完成。 此外,通过返回的代码SQLCancel或SQLCancelHandle仅指示尝试取消该函数成功,不是它真正取消函数。 若要确定是否已取消该函数,该应用程序再次调用此函数。 如果该函数已被取消,则返回 SQL_ERROR 并且 SQLSTATE HY008 (已取消的操作)。 如果未取消该函数,则返回另一个代码,比如 SQL_SUCCESS、 SQL_STILL_EXECUTING 或使用不同的 SQLSTATE SQL_ERROR。
若要禁用特定语句的异步执行时的驱动程序支持语句级异步处理,应用程序调用SQLSetStmtAttr sql_attr_async_enable 设置与特性,并将其设置为 SQL_ASYNC_ENABLE_OFF。 如果该驱动程序支持连接级别异步处理,应用程序调用SQLSetConnectAttr将 SQL_ATTR_ASYNC_ENABLE 设置为 SQL_ASYNC_ENABLE_OFF,禁用异步执行的所有语句连接。
应用程序应处理原始函数在重复循环中的诊断记录。 如果SQLGetDiagField或SQLGetDiagRec时执行的异步函数,调用它将返回当前列表的诊断记录。 每次重复的原始函数调用,它会清除以前的诊断记录。
以异步方式执行连接操作
ODBC 3.8 之前, 允许异步执行,用于与语句相关的操作如准备、 执行和提取,也与目录元数据操作。 从 ODBC 3.8,异步执行也可能是为与连接相关的操作,如连接、 断开、 commit 和 rollback。
有关 ODBC 3.8 的详细信息,请参阅What's New in ODBC 3.8。
以异步方式执行连接操作可在以下方案中:
-
当少量的线程管理大量设备非常高的数据费率。 若要最大程度提高响应能力和可伸缩性最好的是异步的所有操作。
-
当你想要通过多个连接,以减少已用的传输时间重叠数据库操作。
-
高效的异步 ODBC 调用和取消连接操作的功能使应用程序能够允许用户取消任何速度慢的操作而无需等待超时。
以下函数,对连接句柄,以异步方式执行:
| SQLBrowseConnect | SQLConnect | SQLDisconnect |
| SQLDriverConnect | SQLEndTran | SQLSetConnectAttr |
若要确定驱动程序是否支持对这些函数的异步操作,应用程序调用SQLGetInfo SQL_ASYNC_DBC_FUNCTIONS 使用。 如果支持异步操作,则返回 SQL_ASYNC_DBC_CAPABLE。 如果不支持异步操作,则返回 SQL_ASYNC_DBC_NOT_CAPABLE。
若要指定与特定连接执行的函数是要以异步方式执行,则应用程序调用SQLSetConnectAttr和 SQL_ATTR_ASYNC_DBC_FUNCTIONS_ENABLE 属性设置为 SQL_ASYNC_DBC_ENABLE_ON。 将连接属性设置之前建立的连接始终以同步方式执行。 此外,设置连接的操作属性与 SQL_ATTR_ASYNC_DBC_FUNCTIONS_ENABLE SQLSetConnectAttr始终以同步方式执行。
应用程序可以启用异步操作,然后再进行连接。 由于驱动程序管理器无法确定要建立连接之前,请使用的驱动程序,驱动程序管理器将始终返回成功SQLSetConnectAttr。 但是,它可能无法连接如果 ODBC 驱动程序不支持异步操作。
一般情况下,可以有最多一个以异步方式执行函数与特定的连接句柄或语句句柄相关联。 但是,连接句柄可以有多个相关联的语句句柄。 如果没有连接句柄上执行异步操作,相关联的语句句柄可以执行异步操作。 同样,如果有任何相关联的语句句柄上无异步操作正在进行中可以具有连接句柄上的异步操作。 尝试执行异步操作使用句柄当前正在执行异步操作将返回 HY010,"函数序列错误"。
如果连接操作返回 SQL_STILL_EXECUTING,应用程序可以只调用原始函数,下列功能为该连接句柄:
-
SQLCancelHandle (在连接句柄)
-
SQLGetDiagField
-
SQLGetDiagRec
-
SQLAllocHandle (分配 ENV/DBC)
-
SQLAllocHandleStd (分配 ENV/DBC)
-
SQLGetEnvAttr
-
SQLGetConnectAttr
-
SQLDataSources
-
SQLDrivers
-
SQLGetInfo
-
SQLGetFunctions
应用程序应处理原始函数在重复循环中的诊断记录。 如果执行异步函数时调用 SQLGetDiagField 或 SQLGetDiagRec,它将返回当前列表的诊断记录。 每次重复的原始函数调用,它会清除以前的诊断记录。
如果正在连接时,应用程序收到 SQL_SUCCESS 或 SQL_SUCCESS_WITH_INFO 原始函数调用中打开或关闭以异步方式,该操作已完成。
一个新的函数已添加到 ODBC 3.8 SQLCancelHandle。 此函数取消六个连接函数 (SQLBrowseConnect, SQLConnect, SQLDisconnect, SQLDriverConnect,SQLEndTran,并SQLSetConnectAttr)。 应用程序应调用SQLGetFunctions若要确定驱动程序是否支持SQLCancelHandle。 如同SQLCancel,则SQLCancelHandle返回成功,它并不意味着操作已取消。 应用程序应调用再次用于确定该操作已取消的原始函数。 SQLCancelHandle使您可以取消连接句柄或语句句柄上的异步操作。 使用SQLCancelHandle取消操作语句句柄是调用相同SQLCancel。
不需要支持这两个SQLCancelHandle和在同一时间的异步连接操作。 驱动程序可以支持异步连接操作,但不是SQLCancelHandle,反之亦然。
异步连接操作并SQLCancelHandle也可由 ODBC 3.x 和 ODBC 2.x 应用程序使用 ODBC 3.8 驱动程序和 ODBC 3.8 驱动程序管理器。 有关如何启用旧的应用程序以使用更高版本的 ODBC 版本中的新增功能信息,请参阅兼容性矩阵。
连接池
只要启用了连接池,仅在最低程度来建立的连接支持异步操作 (与SQLConnect并SQLDriverConnect) 和关闭与的连接SQLDisconnect。 应用程序应仍将能够处理来自 SQL_STILL_EXECUTING 返回值,但是SQLConnect, SQLDriverConnect,并SQLDisconnect。
启用连接池后, SQLEndTran并SQLSetConnectAttr支持异步操作。
示例
Description
下面的示例演示如何使用SQLSetConnectAttr若要启用异步执行的与连接相关的函数。
代码
BOOL AsyncConnect (SQLHANDLE hdbc)
{
SQLRETURN r;
SQLHANDLE hdbc;
// Enable asynchronous execution of connection functions.
// This must be executed synchronously, that is r != SQL_STILL_EXECUTING
r = SQLSetConnectAttr(
hdbc,
SQL_ATTR_ASYNC_DBC_FUNCTIONS_ENABLE,
reinterpret_cast<SQLPOINTER> (SQL_ASYNC_DBC_ENABLE_ON),
0);
if (r != SQL_SUCCESS && r != SQL_SUCCESS_WITH_INFO)
{
return FALSE;
}
TCHAR szConnStrIn[256] = _T("DSN=AsyncDemo");
r = SQLDriverConnect(hdbc, NULL, (SQLTCHAR *) szConnStrIn, SQL_NTS, NULL, 0, NULL, SQL_DRIVER_NOPROMPT);
if (r == SQL_ERROR)
{
// Use SQLGetDiagRec to process the error.
// If SQLState is HY114, the driver does not support asynchronous execution.
return FALSE;
}
while (r == SQL_STILL_EXECUTING)
{
// Do something else.
// Check for completion, with the same set of arguments.
r = SQLDriverConnect(hdbc, NULL, (SQLTCHAR *) szConnStrIn, SQL_NTS, NULL, 0, NULL, SQL_DRIVER_NOPROMPT);
}
if (r != SQL_SUCCESS && r != SQL_SUCCESS_WITH_INFO)
{
return FALSE;
}
return TRUE;
}
示例
Description
此示例演示使用异步提交操作。 此外可以执行回滚操作这种方式。
代码
BOOL AsyncCommit ()
{
SQLRETURN r;
// Assume that SQL_ATTR_ASYNC_DBC_FUNCTIONS_ENABLE is SQL_ASYNC_DBC_ENABLE_ON.
r = SQLEndTran(SQL_HANDLE_DBC, hdbc, SQL_COMMIT);
while (r == SQL_STILL_EXECUTING)
{
// Do something else.
// Check for completion with the same set of arguments.
r = SQLEndTran(SQL_HANDLE_DBC, hdbc, SQL_COMMIT);
}
if (r != SQL_SUCCESS && r != SQL_SUCCESS_WITH_INFO)
{
return FALSE;
}
return TRUE;
}
请参阅
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 MightyPen)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
