PDF (US Ltr) - 1.4Mb
PDF (A4) - 1.4Mb
要准备和执行语句，应用程序需要遵循以下步骤：
使用
mysql_stmt_init()创建一个预处理语句句柄。要准备服务器上的语句，请调用mysql_stmt_prepare()并向其传递包含 SQL 语句的字符串。-
使用
mysql_stmt_bind_param()或mysql_stmt_bind_named_param()设置任何参数的值。必须设置所有参数。否则，语句执行将返回错误或产生意外结果。如果要发送大型文本或二进制数据值，可以使用
mysql_stmt_send_long_data()将其分块发送到服务器。 调用
mysql_stmt_execute()执行语句。如果语句是
SELECT或任何其他生成结果集的语句，如果需要获取结果集元数据，请调用mysql_stmt_result_metadata()。此元数据本身采用MYSQL_RES结果集的形式，尽管它与包含查询返回的行的结果集是分开的。元数据结果集指示结果中的列数，并包含每列的信息。如果语句生成结果集，请通过调用
mysql_stmt_bind_result()绑定用于检索行值的数据缓冲区。通过重复调用
mysql_stmt_fetch()将数据逐行提取到缓冲区中，直到找不到更多行为止。根据需要重复步骤 3 到 6。您可以重复
mysql_stmt_execute()以通过更改通过mysql_stmt_bind_param()或mysql_stmt_bind_named_param()提供的相应缓冲区中的参数值来重新执行语句。语句执行完成后，使用
mysql_stmt_close()关闭语句句柄，以便释放与其关联的所有资源。此时，句柄将变为无效，并且不应再使用。如果通过调用
mysql_stmt_result_metadata()获取了SELECT语句的结果集元数据，则还应使用mysql_free_result()释放元数据。
调用 mysql_stmt_prepare() 时，MySQL 客户端/服务器协议将执行以下操作：
服务器解析语句并通过分配语句 ID 将成功状态发送回客户端。如果它是面向结果集的语句，它还会发送参数总数、列数及其元数据。服务器在此调用期间检查语句的所有语法和语义。
客户端将此语句 ID 用于进一步的操作，以便服务器可以从其语句池中识别该语句。
调用 mysql_stmt_execute() 时，MySQL 客户端/服务器协议将执行以下操作：
客户端使用语句句柄并将参数数据发送到服务器。
服务器使用客户端提供的 ID 标识语句，将参数标记替换为新提供的数据，然后执行语句。如果语句生成结果集，服务器会将数据发送回客户端。否则，它将发送成功状态以及更改、删除或插入的行数。
调用 mysql_stmt_fetch() 时，MySQL 客户端/服务器协议将执行以下操作：
客户端从结果集的当前行读取数据，并通过执行必要的转换将其放入应用程序数据缓冲区中。如果应用程序缓冲区类型与服务器返回的字段类型相同，则转换很简单。
如果发生错误，可以使用 mysql_stmt_errno()、mysql_stmt_error() 和 mysql_stmt_sqlstate() 分别获取语句错误号、错误消息和 SQLSTATE 代码。
对于使用 mysql_stmt_prepare() 和 mysql_stmt_execute() C API 函数执行的预处理语句，服务器会将 Prepare 和 Execute 行写入常规查询日志，以便您可以了解语句的准备和执行时间。
假设您准备并执行以下语句：
调用
mysql_stmt_prepare()准备语句字符串"SELECT ?"。调用
mysql_stmt_bind_param()或mysql_stmt_bind_named_param()将值3绑定到预处理语句中的参数。调用
mysql_stmt_execute()执行预处理语句。
由于前面的调用，服务器会将以下行写入常规查询日志：
Prepare [1] SELECT ?
Execute [1] SELECT 3日志中的每行 Prepare 和 Execute 都标记有 [ 语句标识符，以便您可以跟踪正在记录哪个预处理语句。 N]N 是一个正整数。如果客户端同时有多个预处理语句处于活动状态，则 N 可能大于 1。每行 Execute 显示了用数据值替换 ? 参数后的预处理语句。