文档主页
MySQL 9.0 参考手册
相关文档 下载本手册
PDF (美国信纸) - 40.0Mb
PDF (A4) - 40.1Mb
手册页 (TGZ) - 258.2Kb
手册页 (Zip) - 365.3Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 9.0 参考手册  /  ...  /  PreparedStatement 对象

27.3.6.7 PreparedStatement 对象

The PreparedStatement 对象代表预处理语句执行的句柄。它支持以下方法

  • bind(Value data):注册一个或多个要在执行 SQL 语句时绑定的值列表。参数按列出的顺序绑定,并且是特定于类型的;请参阅 第 27.3.4 节,“JavaScript 存储程序数据类型和参数处理”,以获取支持的数据类型列表。

    在预处理语句的首次执行之前,必须将其所有参数绑定到值;否则,在尝试调用 PreparedStatement.execute() 时将引发错误。预处理语句的后续执行可以使用比语句中的参数标记更少的绑定参数;在这种情况下,丢失参数将保留其在上次执行中的值。

    尝试绑定比参数标记更多的参数或绑定到类型不正确的参数将被错误拒绝。在对该预处理语句调用 deallocate() 之后调用此方法也会引发错误。

    返回对其调用的同一个 PreparedStatement 对象的引用。

  • deallocate():关闭预处理语句并释放关联的资源。在此之后不应再进行任何 PreparedStatementSqlResult 方法调用。

    调用此方法等效于在 mysql 客户端中执行 DEALLOCATE PREPARE 语句。

  • execute():执行预处理查询并返回相应的 SqlResult

    调用此方法等效于在 mysql 客户端中运行 EXECUTE 语句。

  • getOption(String optionName):获取此语句的 optionName 选项的值。仅支持 passResultToClientcharsetName 值。

请参阅 第 27.3.7.2 节,“预处理语句”,以获取更多信息和示例。