Beta Draft: 2016-08-25
This module searches processes on a server and optionally kills either the query or the connection for all matches.
Processes are matched by searching the fields of the
table (which is available only for servers from MySQL 5.1.7 and
later). Internally, the module operates by constructing a
SELECT statement for
finding matching processes, and then sending it to the server.
Instead of performing the search, the module can return the SQL
code that performs the query. This can be useful if you want to
execute the query later or feed it to some other program that
processes SQL queries further.
The following constants correspond to fields in the
table. They indicate which columns to examine when searching for
processes matching the search conditions.
The following constants indicate actions to perform on processes that match the search conditions.
Kill the process query
Kill the process connection
Print the processes
class mysql.utilities.command.proc.ProcessGrep(matches, actions=, use_regexp=False)
This class searches the
for processes on MySQL servers and optionally kills them. It can
be used to perform a search (and optionally kill), or to generate
the SQL statement for doing the same.
For example, to kill all queries with user 'mats', use the following code:
>>> from mysql.utilities.command.proc import * >>> grep = ProcessGrep(matches=[(USER, "mats")], actions=[KILL_QUERY]) >>> grep.execute("email@example.com", "firstname.lastname@example.org")
Return the SQL code for executing the search (and optionally, the kill).
If only_body is
the body of the function is shown. This is useful if the SQL code
is to be used with other utilities that generate the routine
declaration. If only_body is
False, a complete procedure will be generated
if there is any kill action supplied, and just a SELECT statement
if it is a plain search.
SQL code for executing the operation specified by the options.
execute(connections, ...[, output=sys.stdout, connector=mysql.connector])
Execute the search on each of the connections supplied. If
output is not
value is treated as a file object and the result of the execution
is printed on that stream. Note that the output and connector
arguments must be supplied as keyword
arguments. All other arguments are treated as connection