符合性
版本引入了: ODBC 1.0 标准符合性: ISO 92
摘要
SQLExecute执行已准备的语句,使用参数标记变量的当前值,如果在语句中存在任何参数标记。
语法
SQLRETURN SQLExecute(
SQLHSTMT StatementHandle);
参数
StatementHandle
[输入]语句句柄。
返回
SQL_SUCCESS、 SQL_SUCCESS_WITH_INFO、 SQL_NEED_DATA、 SQL_STILL_EXECUTING、 SQL_ERROR、 SQL_NO_DATA、 SQL_INVALID_HANDLE 或 SQL_PARAM_DATA_AVAILABLE。
诊断
当SQLExecute返回 SQL_ERROR 或 SQL_SUCCESS_WITH_INFO,可以通过调用获取关联的 SQLSTATE 值SQLGetDiagRec与HandleType的SQL_HANDLE_STMT 和一个处理的StatementHandle。 下表列出了通常返回的 SQLSTATE 值SQLExecute ,并解释了此函数; 每个上下文中的表示法"(数据挖掘)"之前 SQLSTATEs 返回由驱动程序管理器的说明。 与每个 SQLSTATE 值关联的返回代码是 SQL_ERROR,除非另有说明。
| SQLSTATE | 错误 | Description |
|---|---|---|
| 01000 | 常规警告 | 特定于驱动程序的信息性消息。 (函数返回 SQL_SUCCESS_WITH_INFO。) |
| 01001 | 游标操作冲突 | 已准备的语句与相关联StatementHandle包含定位的 update 或 delete 语句,并且没有行或多个行未更新或删除。 (有关对多个行的更新的详细信息,请参阅说明 SQL_ATTR_SIMULATE_CURSOR特性中SQLSetStmtAttr。) (函数返回 SQL_SUCCESS_WITH_INFO。) |
| 01003 | Set 函数中消除了空值 | 已准备的语句与相关联StatementHandle包含一个集函数 (如AVG,最大, MIN,依此类推),但不是计数设置函数,并且 NULL 参数值在应用函数之前已被消除。 (函数返回 SQL_SUCCESS_WITH_INFO。) |
| 01004 | 字符串数据,右截断 | 字符串或二进制数据返回为输出参数时截断了非空白字符或非 NULL 的二进制数据。 如果它是一个字符串值,它是右侧被截断。 (函数返回 SQL_SUCCESS_WITH_INFO。) |
| 01006 | 未撤消特权 | 已准备的语句与相关联StatementHandle已撤消语句,并且用户不具有指定的特权。 (函数返回 SQL_SUCCESS_WITH_INFO。) |
| 01007 | 未授予特权 | 已准备的语句与相关联StatementHandle已授予语句,并且用户可能不授予指定的特权。 |
| 01S02 | 选项值已更改 | 指定的语句属性实现运行情况,由于无效,因此已暂时替换一个相近的值。 (SQLGetStmtAttr可以调用以确定暂时被替换的值是什么。)替换值是否为有效StatementHandle直到关闭游标,此时语句属性将恢复为以前的值。 可以更改的语句属性有: SQL_ATTR_CONCURRENCY、 SQL_ATTR_CURSOR_TYPE、 SQL_ATTR_KEYSET_SIZE、 SQL_ATTR_MAX_LENGTH、 SQL_ATTR_MAX_ROWS、 SQL_ATTR_QUERY_TIMEOUT 和 SQL_ATTR_SIMULATE_CURSOR。 (函数返回 SQL_SUCCESS_WITH_INFO。) |
| 01S07 | 截断小数部分 | 用于输入/输出返回的数据或输出参数已被截断数值数据类型的小数部分被截断或时间部分的时间、 时间戳或时间间隔的数据类型的小数部分被截断。 (函数返回 SQL_SUCCESS_WITH_INFO。) |
| 07002 | COUNT 字段不正确 | 在指定的参数数目SQLBindParameter中包含的 SQL 语句中的参数数量小于* StatementText。 SQLBindParameter调用时使用ParameterValuePtr设置为 null 指针StrLen_or_IndPtr未设置为 SQL_NULL_DATA 或 SQL_DATA_AT_EXEC,和InputOutputType不将设置为 SQL_PARAM_OUTPUT,以便在指定的参数数目SQLBindParameter大于中包含的 SQL 语句中的参数数目 *StatementText. |
| 07006 | 受限制的数据类型属性冲突 | 标识的数据值ValueType中的参数SQLBindParameter无法为数据类型由标识转换绑定的参数为ParameterType中的参数SQLBindParameter。 参数绑定为 SQL_PARAM_INPUT_OUTPUT 或 SQL_PARAM_OUTPUT 不无法转换为标识的数据类型返回的数据值ValueType中的参数SQLBindParameter。 (如果无法转换为一个或多个行的数据值,但没有成功返回一个或多个行,此函数返回 SQL_SUCCESS_WITH_INFO。) |
| 07007 | 受限制的参数值冲突 | 参数类型 SQL_PARAM_INPUT_OUTPUT_STREAM 仅用于发送和接收数据部分中的参数。 输入此参数类型不允许绑定的缓冲区。 参数类型是 SQL_PARAM_INPUT_OUTPUT,以及时,将发生此错误* StrLen_or_IndPtr中指定SQLBindParameter不等于 SQL_NULL_DATA,SQL_DEFAULT_PARAM、 SQL_LEN_DATA_AT_EXEC(len) 或 SQL_DATA_AT_EXEC。 |
| 07S01 | 默认参数的使用无效 | 参数值,设置SQLBindParameter、 是 SQL_DEFAULT_PARAM,和相应的参数不是 ODBC 规范的过程调用的参数。 |
| 08S01 | 通讯链接失败 | 该驱动程序和驱动程序已连接到数据源之间的通信链接失败之前函数已完成处理。 |
| 21S02 | 派生表等级与列列表不匹配 | 已准备的语句与相关联StatementHandle包含CREATE VIEW语句和非限定的列列表 (图中指定的列数列标识符SQL 语句的参数) 包含定义的派生表中的列数与多个名称,查询规范SQL 语句的参数。 |
| 22001 | 字符串数据,右截断 | 字符或二进制值的列分配导致非空白 (字符) 或非 null (二进制) 字符或字节数的截断。 |
| 22002 | 需要指示器变量,但未提供 | NULL 数据被绑定到一个输出参数,其StrLen_or_IndPtr设置SQLBindParameter是空指针。 |
| 22003 | 数值超出范围 | 已准备的语句与相关联StatementHandle包含绑定的数值参数,并且参数值导致要分配给关联时被截断的数字的整个 (而不是小数) 部分表的列。 返回一个数字值 (数值或字符串) 的一个或多个输入/输出参数或输出参数将导致要截断的数字的整个 (而不是小数) 部分。 |
| 22007 | 日期时间格式无效 | 已准备的语句与相关联StatementHandle包含 SQL 语句包含日期、 时间戳结构作为绑定参数,并且是该参数,分别、 无效的日期、 时间,或时间戳。 输入/输出或输出参数绑定到日期、 时间或时间戳 C 结构,返回的参数中的值时,分别,无效的日期、 时间戳。 (函数返回 SQL_SUCCESS_WITH_INFO。) |
| 22008 | 日期时间字段溢出 | 已准备的语句与相关联StatementHandle包含包含日期时间表达式,计算,产生的日期时间戳结构的 SQL 语句无效。 日期时间表达式计算的输入/输出或输出参数导致了日期、 时间或时间戳 C 结构无效。 |
| 22012 | 被零除 | 已准备的语句与相关联StatementHandle包含导致被零除的算术表达式。 算术表达式计算的输入/输出或输出参数导致除零。 |
| 22015 | 间隔字段溢出 | *StatementText包含一个确切的数值或时间间隔参数,当转换到 SQL 数据类型的时间间隔,导致重要数字丢失。 *StatementText包含多个字段是间隔参数,当转换为数值数据类型列中,没有表示形式具有数值数据类型。 *StatementText包含已分配到的时间间隔 SQL 类型的参数数据,并且在时间间隔内 SQL 类型的 C 类型的值没有表示形式。 分配为精确数字或间隔时导致重要数字丢失 C 间隔类型到 SQL 类型的输入/输出或输出参数。 输入/输出或输出参数分配给一个 C 间隔结构,间隔数据结构中的数据没有表示形式。 |
| 22018 | 转换指定的字符值无效 | *StatementText包含 C 类型的为准确或近似数值、 日期时间或间隔数据类型; 该列的 SQL 类型是字符数据类型; 和列中的值不是有效的绑定 C 类型的文本。 SQL 类型时返回的输入/输出或输出参数,已准确或近似数值、 日期时间或间隔数据类型;C 类型为 SQL_C_CHAR;和列中的值不是有效的绑定的 SQL 类型的文本。 |
| 22019 | 无效的转义字符 | 已准备的语句与相关联StatementHandle包含等谓词以及转义中其中子句,并之后的转义字符的长度转义不是等于 1。 |
| 22025 | 无效的转义序列 | 已准备的语句与相关联StatementHandle包含"等模式值转义转义字符"中其中子句和后面的模式值中的转义字符的字符不是之一"%"或"_"。 |
| 23000 | 完整性约束冲突 | 已准备的语句与相关联StatementHandle包含参数。 参数值为空的定义为 NOT NULL 列关联的表中的列、 列约束为仅包含唯一值,却提供了重复的值或违反了某个其他的完整性约束。 |
| 24000 | 游标状态无效 | 在光标StatementHandle通过SQLFetch或SQLFetchScroll。 如果此错误返回由驱动程序管理器SQLFetch或SQLFetchScroll未返回 SQL_NO_DATA,和如果驱动程序返回SQLFetch或SQLFetchScroll已返回 sql_no_data 为止。 在打开游标的StatementHandle。 已准备的语句与相关联StatementHandle包含定位的更新或删除 statemen、 t 和光标所处的结果集或结果集的末尾之后在开始之前。 |
| 40001 | 序列化失败 | 事务已回滚,由于其他事务与资源死锁。 |
| 40003 | 语句完成情况未知 | 此函数中,在执行期间失败关联的连接,无法确定事务的状态。 |
| 42000 | 语法错误或访问冲突 | 用户没有执行已准备的语句与关联的权限StatementHandle。 |
| 44000 | WITH CHECK OPTION 冲突 | 已准备的语句与相关联StatementHandle包含插入上查看的表执行的语句或派生自创建通过指定查看表的表WITH CHECK OPTION,这样,受影响的一个或多个行插入语句无法再查看表中存在。 已准备的语句与相关联StatementHandle包含更新上查看的表执行的语句或派生自创建通过指定查看表的表WITH CHECK OPTION,这样,受影响的一个或多个行更新语句无法再查看表中存在。 |
| HY000 | 常规错误 | 有关其中没有任何特定的 SQLSTATE 和为其定义任何特定于实现的 SQLSTATE 出错。 返回的错误消息SQLGetDiagRec中 *MessageText缓冲区描述错误以及其原因。 |
| HY001 | 内存分配错误 | 该驱动程序无法分配支持执行或完成该函数所需的内存。 |
| HY008 | 操作已取消 | 异步处理的已启用StatementHandle。 调用该函数,和之前执行完毕SQLCancel或SQLCancelHandle上调用了StatementHandle。 然后在再次调用该函数StatementHandle。 调用该函数,和之前执行完毕SQLCancel或SQLCancelHandle上调用了StatementHandle来自不同线程中多线程应用程序。 |
| HY010 | 函数序列错误 | (DM) 为与之关联的连接句柄调用以异步方式执行的函数StatementHandle。 此异步函数仍在执行时SQLExecute调用函数。 (数据挖掘) SQLExecute, SQLExecDirect,或SQLMoreResults曾为StatementHandle和返回 SQL_PARAM_DATA_可用。 数据已检索到的所有经过流处理参数之前调用此函数。 (DM) 的调用以异步方式执行的函数 (不是此类似) StatementHandle和仍在执行时调用此函数。 (数据挖掘) SQLExecute, SQLExecDirect, SQLBulkOperations,或者SQLSetPos曾为StatementHandle和返回 SQL_NEED_DATA。 数据已发送的所有执行时数据参数或列之前调用此函数。 (数据挖掘) StatementHandle未准备好。 |
| HY013 | 内存管理错误 | 无法处理函数调用,因为基础内存对象无法访问,可能是由于内存不足的情况。 |
| HY090 | 字符串或缓冲区长度无效 | 参数值,设置SQLBindParameter、 是空指针和参数长度值不是 0,SQL_NULL_DATA,SQL_DATA_AT_EXEC,SQL_DEFAULT_PARAM,或小于或等于 SQL_LEN_DATA_AT_EXEC_OFFSET。 参数值,设置SQLBindParameter、 不是空指针; C 数据类型为 SQL_C_BINARY 或 SQL_C_CHAR; 和参数长度值是小于 0,但不是 SQL_NTS、 SQL_NULL_DATA、 SQL_DEFAULT_PARAM 或 SQL_DATA_AT_EXEC,或小于或等于 SQL_LEN_DATA_AT_EXEC_OFFSET。 参数长度值受SQLBindParameter为设置为 SQL_DATA_AT_EXEC; 的 SQL 类型为 SQL_LONGVARCHAR、 SQL_LONGVARBINARY、 或 long 数据源特定于数据类型; 和 SQL_NEED_LONG_DATA_LEN 信息在键入SQLGetInfo是"Y"。 |
| HY105 | 无效的参数类型 | 为参数指定的值InputOutputType中SQLBindParameter SQL_PARAM_OUTPUT,而该参数是输入的参数。 |
| HY109 | 无效的游标位置 | 已准备的语句已定位的 update 或 delete 语句和光标定位已 (通过SQLSetPos或SQLFetchScroll) 上的行已删除或无法提取。 |
| HY117 | 由于未知的事务状态而挂起连接。 仅断开连接,并允许使用只读的函数。 | (DM) 有关挂起状态的详细信息,请参阅SQLEndTran 函数。 |
| HYC00 | 未实现的可选功能 | 驱动程序或数据源不支持 SQL_ATTR_CONCURRENCY 和 SQL_ATTR_CURSOR_TYPE 语句属性的当前设置的组合。 SQL_ATTR_USE_BOOKMARKS 语句属性设置为 SQL_UB_VARIABLE,并且 SQL_ATTR_CURSOR_TYPE 语句属性设置为游标类型,该驱动程序不支持书签。 |
| HYT00 | 超时时间已到 | 查询超时期限过期之前的数据源返回的结果集。 通过设置超时期限SQLSetStmtAttr,SQL_ATTR_QUERY_TIMEOUT。 |
| HYT01 | 连接超时时间已到 | 连接超时期限过期之前的数据源响应此请求。 通过设置连接超时期SQLSetConnectAttr,SQL_ATTR_CONNECTION_TIMEOUT。 |
| IM001 | 驱动程序不支持此函数 | (DM) 驱动程序与相关联StatementHandle不支持该函数。 |
| IM017 | 轮询异步通知模式中禁用 | 只要使用通知模型,将禁用轮询。 |
| IM018 | SQLCompleteAsync尚未调用以完成此句柄上以前的异步操作。 | 如果句柄上的上一个函数调用返回 SQL_STILL_EXECUTING,如果启用通知模式,则SQLCompleteAsync必须要对其进行后期处理并完成该操作的句柄上调用。 |
SQLExecute可以返回任何可由返回的 SQLSTATE SQLPrepare基于当数据源的计算结果与语句相关联的 SQL 语句。
注释
SQLExecute执行准备的语句SQLPrepare。 应用程序处理或放弃对的调用的结果后SQLExecute,应用程序可以调用SQLExecute再次使用新的参数值。 准备好的执行有关的详细信息,请参阅准备好执行。
若要执行选择语句不止一次,应用程序必须调用SQLCloseCursor继续重新执行选择语句。
如果数据源在手动提交模式下 (需要显式事务启动),并且尚未启动事务,驱动程序将启动一个事务发送的 SQL 语句之前。 有关详细信息,请参阅事务。
如果应用程序使用SQLPrepare准备并SQLExecute提交提交或回滚语句,它不是DBMS 产品之间互操作。 若要提交或回滚事务,调用SQLEndTran。
如果SQLExecute遇到执行时数据参数,它将返回 SQL_NEED_DATA。 应用程序发送的数据使用SQLParamData并SQLPutData。 请参阅SQLBindParameter, SQLParamData, SQLPutData,以及发送长数据。
如果SQLExecute执行搜索的 update、 insert 或 delete 语句,但不影响任何行在数据源,调用SQLExecute返回 sql_no_data 为止。
如果将 SQL_ATTR_PARAMSET_SIZE 语句属性的值大于 1,并且 SQL 语句中包含至少一个参数标记, SQLExecute数组中执行的每组参数值一次的 SQL 语句指向 *ParameterValuePtr调用中的自变量SQLBindParameter。 有关详细信息,请参阅参数值数组。
如果启用了书签和执行的查询不能支持书签,则驱动程序应尝试强制为通过更改属性值并返回 SQLSTATE 01S02 支持书签环境 (选项值已更改)。 如果不能更改的属性,则驱动程序应返回 SQLSTATE 为 HY024 (无效的属性值)。
Note:
当使用连接池时,应用程序必须执行 SQL 语句,如更改数据库或数据库的上下文使用数据库语句在 SQL Server 中,这会更改使用数据源的目录。
代码示例
请参阅SQLBindParameter, SQLBulkOperations, SQLPutData,以及SQLSetPos。
相关函数
| 有关信息 | 请参阅 |
|---|---|
| 将缓冲区绑定到结果集中的列 | SQLBindCol 函数 |
| 取消语句处理 | SQLCancel 函数 |
| 关闭游标 | SQLCloseCursor 函数 |
| 执行提交或回滚操作 | SQLEndTran 函数 |
| 执行 SQL 语句 | SQLExecDirect 函数 |
| 正在提取多行数据 | SQLFetch 函数 |
| 提取的数据块或滚动浏览结果集 | SQLFetchScroll 函数 |
| 释放语句句柄 | SQLFreeStmt 函数 |
| 返回游标名称 | SQLGetCursorName 函数 |
| 正在提取部分或全部的数据列 | SQLGetData 函数 |
| 返回下一个参数将数据发送用于 | SQLParamData 函数 |
| 准备执行的语句 | SQLPrepare 函数 |
| 在执行时发送参数数据 | SQLPutData 函数 |
| 设置游标名称 | SQLSetCursorName 函数 |
| 设置语句属性 | SQLSetStmtAttr 函数 |
请参阅
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 MightyPen)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
