27.7.6.39 mysql_kill()
int mysql_kill(MYSQL *mysql, unsigned long pid)
Description
Note
从 MySQL 5.7.11 开始,不推荐使用mysql_kill()
,并将在以后的 MySQL 版本中将其删除。而是使用mysql_query()执行KILL语句。
要求服务器终止pid
指定的线程。
不推荐使用此功能。请使用mysql_query()发出 SQL KILL语句。
mysql_kill()无法处理大于 32 位的值,但是在以下情况下,要防止杀死错误的线程会返回错误:
-
如果给定的 ID 大于 32 位,则mysql_kill()返回CR_INVALID_CONN_HANDLE错误。
-
服务器的内部线程 ID 计数器的值大于 32 位后,对于任何mysql_kill()调用,它都会返回ER_DATA_OUT_OF_RANGE错误,并且mysql_kill()失败。
Return Values
零成功。如果发生错误,则为非零值。
Errors
命令执行 Sequences 不正确。
pid
大于 32 位。
MySQL 服务器已经消失了。
在查询期间与服务器的连接已丢失。
出现未知错误。
服务器的内部线程 ID 计数器的值已大于 32 位,这时它将拒绝所有mysql_kill()调用。