MySQL 5.1参考手册 :: 13. SQL语句语法(9)

SHOW [FULL] PROCESSLIST

SHOW PROCESSLIST显示哪些线程正在运行。您也可以使用mysqladmin processlist语句得到此信息。如果您有SUPER权限，您可以看到所有线程。否则，您只能看到您自己的线程（也就是，与您正在使用的MySQL账户相关的线程）。请参见13.5.5.3节，“KILL语法”。如果您不使用FULL关键词，则只显示每个查询的前100个字符。

本语句报告TCP/IP连接的主机名称（采用host_name:client_port格式），以方便地判定哪个客户端正在做什么。

如果您得到“too many connections”错误信息，并且想要了解正在发生的情况，本语句是非常有用的。MySQL保留一个额外的连接，让拥有SUPER权限的 账户使用，以确保管理员能够随时连接和检查系统（假设您没有把此权限给予所有的用户）。

在来自SHOW PROCESSLIST的输出中常见的一些状态：

·         Checking table

线程正在执行（自动）表格检查。

·         Closing tables

意味着线程正在刷新更改后的表数据，并正在关闭使用过的表。这应该是一个快速的操作。如果不快，则您应该验证您的磁盘没有充满，并且磁盘没有被超负荷使用。

·         Connect Out

连接到主服务器上的从属服务器。

·         Copying to tmp table on disk

临时结果集合大于tmp_table_size。线程把临时表从存储器内部格式改变为磁盘模式，以节约存储器。

·         Creating tmp table

线程正在创建一个临时表，以保持部分结果。

·         deleting from main table

服务器正在执行多表删除的第一部分，只从第一个表中删除。

·         deleting from reference tables

服务器正在执行多表删除的第二部分，从其它表中删除匹配的行。

·         Flushing tables

线程正在执行FLUSH TABLES，并正在等待所有线程，以关闭表。

·         FULLTEXT initialization

服务器正在准备执行一个自然语言全文本搜索。

·         Killed

有人已经向线程发送了一个KILL命令。在下一次检查终止标记时，应放弃。该标记在MySQL的每个大循环中都检查，但是在有些情况下，线程终止只需要较短的时间。如果该线程被其它线程锁定，则只要其它线程接触锁定，终止操作就会生效。

·         Locked

该查询被其它查询锁定。

·         Sending data

线程正在为SELECT语句处理行，同时正在向客户端发送数据。

·         Sorting for group

线程正在进行分类，以满足GROUP BY要求。

·         Sorting for order

线程正在进行分类，以满足ORDER BY要求。

·         Opening tables

线程正在试图打开一个表。这应该是非常快的过程，除非打开操作受到阻止。例如，一个ALTER TABLE或一个LOCK TABLE语句可以阻止打开一个表，直到语句完成为止。

·         Removing duplicates

查询正在使用SELECT DISTINCT。使用时，在早期阶段，MySQL不能优化不同的操作。因此，MySQL要求一个额外的阶段，以便在把结果发送给客户端之前取消所有的复制行。

·         Reopen table

线程得到一个表锁定，但是在得到锁定后被通知带下方的表结构已更改了。它已经释放了锁定，关闭了表，并试图重新打开它。

·         Repair by sorting

修复代码正在使用一个分类来创建索引。

·         Repair with keycache

修复代码正在通过关键缓存一个接一个地使用创建关键字。这比通过分类修复要慢很多。

·         Searching rows for update

线程正在进行第一阶段，以在更新之前，查找所有匹配的行。如果UPDATE正在更改用于查找相关行的索引，则必须这么做。

·         Sleeping

线程正在等待客户端，以向它发送一个新语句。

·         System lock

线程正在等待得到一个用于表的外部系统锁定。如果您没有正在使用多个正在访问同一个表的mysqld服务器，则您可以使用--skip-external-locking选项禁用系统锁定。

·         Upgrading lock

INSERT DELAYED管理程序正在试图得到一个表锁定，以插入行。

·         Updating

线程正在搜索行，并正在更新这些行。

·         User Lock

线程正在等待GET_LOCK()。

·         Waiting for tables

线程得到一个通知，表的底层结构已经改变，需要重新打开表以得到新的结构。但是，为了能重新打开表，必须等待，直到所有其它的线程已经关闭了正在被质询的表。

如果其它线程已经对正在被质询的表使用了FLUSH TABLES或以下语句之一：FLUSH TABLES tbl_name, ALTER TABLE, RENAME TABLE, REPAIR TABLE, ANALYZE TABLE或OPTIMIZE TABLE；则会出现通知。

·         waiting for handler insert

INSERT DELAYED管理程序已经处理了所有处于等待状态的插入，并正在等待新插入。

多数状态对应于非常快的操作。如果一个线程在这些状态下停留了数秒，则可能是有问题，需要进行调查。

有一些其它的状态，在前面的清单中没有提及，但是其中有很多状态对于查找服务器中的程序错误是有用的。

SHOW [GLOBAL | SESSION] STATUS [LIKE 'pattern']

SHOW STATUS提供服务器状态信息。此信息也可以使用mysqladmin extended-status命令获得。

此处显示了局部的输出。对于您的服务器，变量和值的清单可以是不同的。在5.3.4节，“服务器状态变量”中给出了每个变量的意义。

mysql> SHOW STATUS;

+--------------------------+------------+

| Variable_name            | Value      |

+--------------------------+------------+

| Aborted_clients          | 0          |

| Aborted_connects         | 0          |

| Bytes_received           | 155372598  |

| Bytes_sent               | 1176560426 |

| Connections              | 30023      |

| Created_tmp_disk_tables  | 0          |

| Created_tmp_tables       | 8340       |

| Created_tmp_files        | 60         |

...                       ...          ...

| Open_tables              | 1          |

| Open_files               | 2          |

| Open_streams             | 0          |

| Opened_tables            | 44600      |

| Questions                | 2026873    |

...                       ...          ...

| Table_locks_immediate    | 1920382    |

| Table_locks_waited       | 0          |

| Threads_cached           | 0          |

| Threads_created          | 30022      |

| Threads_connected        | 1          |

| Threads_running          | 1          |

| Uptime                   | 80380      |

+--------------------------+------------+

使用LIKE子句，该语句只显示匹配该样式的那些变量：

mysql> SHOW STATUS LIKE 'Key%';

+--------------------+----------+

| Variable_name      | Value    |

+--------------------+----------+

| Key_blocks_used    | 14955    |

| Key_read_requests  | 96854827 |

| Key_reads          | 162040   |

| Key_write_requests | 7589728  |

| Key_writes         | 3813196  |

+--------------------+----------+

使用GLOBAL选项，您可以得到所有MySQL连接的状态值。使用SESSION，您可以得到所有当前连接的状态值。如果您两个选项都不使用，则默认值为SESSION。LOCAL是SESSION的同义词。

注意，有些状态变量只有一个全局值。对于这些变量，使用GLOBAL和SESSION会得到同样的值。

SHOW TABLE STATUS [FROM db_name] [LIKE 'pattern']

SHOW TABLE STATUS的性质与SHOW TABLE类似，不过，可以提供每个表的大量信息。您也可以使用mysqlshow --status db_name命令得到此清单。

本语句也显示视图信息。

对于NDB Cluster表，本语句的输出显示Avg_row_length和Data_length列的适当值，不过BLOB列没有被考虑进来。另外，复制数量在Comment列中显示（作为number_of_replicas）。

SHOW TABLE STATUS会返回以下字段：

·         Name

表的名称。

·         Engine

表的存储引擎。在MySQL 4.1.2之前，本值被标记为Type。请参见第15章：存储引擎和表类型。

·         Version

表的.frm文件的版本号。

·         Row_format

行存储格式（Fixed, Dynamic, Compressed, Redundant, Compact）。InnoDB表的格式被报告为Redundant或Compact。

·         Rows

行的数目。部分存储引擎，如MyISAM，存储精确的数目。

对于其它存储引擎，比如InnoDB，本值是一个大约的数，与实际值相差可达40到50％。在这些情况下，使用SELECT COUNT(*)来获得准确的数目。

对于在INFORMATION_SCHEMA数据库中的表，Rows值为NULL。

·         Avg_row_length

平均的行长度。

·         Data_length

数据文件的长度。

·         Max_data_length

数据文件的最大长度。如果给定了数据指针的大小，这是可以被存储在表中的数据的字节总数。

·         Index_length

索引文件的长度。

·         Data_free

被整序，但是未使用的字节的数目。

·         Auto_increment

下一个AUTO_INCREMENT值。

·         Create_time

什么时候表被创建。

·         Update_time

什么时候数据文件被最后一次更新。

·         Check_time

什么时候表被最后一次检查。不是所有的存储引擎此时都更新，在此情况下，值为NULL。

·         Collation

表的字符集和整序。

·         Checksum

活性校验和值。

·         Create_options

和CREATE TABLE同时使用的额外选项。

·         Comment

创建表时使用的评注（或者有关为什么MySQL可以访问表信息的说明）。

在表评注中，InnoDB表报告表所属的表空间的空闲空间。对于一个位于共享表空间中的表，这是共享表空间中的空闲空间。如果您正在使用多个表空间，并且该表有自己的表空间，则空闲空间只用于此表。

对于MEMORY (HEAP)表，Data_length, Max_data_length和Index_length值近似于被整序的存储器的实际值。整序算法预留了大量的存储器，以减少整序操作的数量。

对于视图，由SHOW TABLE STATUS显示的所有字段均为NULL。例外情况是Name指示为视图名称同时Comment称为视图。

SHOW [FULL] TABLES [FROM db_name] [LIKE 'pattern']

SHOW TRIGGERS [FROM db_name] [LIKE expr]

SHOW TRIGGERS列出了目前被MySQL服务器定义的触发程序。

对于在21.3节，“使用触发程序”中定义的触发程序ins_sum，本语句的输出显示如下：

mysql> SHOW TRIGGERS LIKE 'acc%';

+---------+--------+---------+-------------------------------+--------+---------+

| Trigger | Event  | Table   | Statement                     | Timing | Created |

+---------+--------+---------+-------------------------------+--------+---------+

| ins_sum | INSERT | account |  SET @sum = @sum + NEW.amount | BEFORE | NULL    |

+---------+--------+---------+-------------------------------+--------+---------+

注释：当使用一个含有SHOW TRIGGERS的LIKE子句时，待匹配的表达式（expr）会与触发程序定义时所在的表的名称相比较，而不与触发程序的名称相比较：

mysql> SHOW TRIGGERS LIKE 'ins%';

Empty set (0.01 sec)

对本语句输出中的各列的简要解释如下：

·         Trigger: 触发程序的名称。

·         Event: 调用触发程序的时间。必须为'INSERT', 'UPDATE'或 'DELETE'.之一。

·         Table: 触发程序定义时对应的表。

·         Statement: 当触发程序被调用时执行的语句。这与在INFORMATION_SCHEMA.TRIGGERS的ACTION_STATEMENT列中显示的文本一样。

·         Timing: 'BEFORE'或'AFTER'两个值之一。

·         Created: 目前，本列的值为NULL。

为了执行SHOW TRIGGERS，您必须拥有SUPER权限。

同时也见23.1.16节，“INFORMATION_SCHEMA TRIGGERS表”。

SHOW [GLOBAL | SESSION] VARIABLES [LIKE 'pattern']

SHOW VARIABLES显示了部门MySQL系统变量的值。本信息也可以使用mysqladmin variables命令获得。

使用GLOBAL选项，您可以获得被用于MySQL新连接的值。使用SESSION，您可以得到对于当前连接起效的值。如果您两个选项都不使用，默认值为SESSION。

LOCAL是SESSION的同义词。

如果默认值不合适，当mysqld启动时或在SET语句运行过程中，您可以使用命令行选项设置多数的这类变量。请参见5.3.1节，“mysqld命令行选项”和13.5.3节，“SET语法。

此处显示了部分的输出。对于您的服务器，变量和值的清单会有所不同。在5.3.3节，“服务器系统变量”中给出了每个变量的意义。在7.5.2节，“调节服务器参数”中提供了有关调整变量的信息。

mysql> SHOW VARIABLES;

+---------------------------------+-----------------------------------------------+

| Variable_name                   | Value                                         |

+---------------------------------+-----------------------------------------------+

| auto_increment_increment        | 1                                             |

| auto_increment_offset           | 1                                             |

| automatic_sp_privileges         | ON                                            |

| back_log                        | 50                                            |

| basedir                         | /home/jon/bin/mysql-5.1/                      |

| binlog_cache_size               | 32768                                         |

| bulk_insert_buffer_size         | 8388608                                       |

| character_set_client            | latin1                                        |

| character_set_connection        | latin1                                        |

...                               ...                                              

| max_user_connections            | 0                                             |

| max_write_lock_count            | 4294967295                                    |

| multi_range_count               | 256                                           |

| myisam_data_pointer_size        | 6                                             |

| myisam_max_sort_file_size       | 2147483647                                    |

| myisam_recover_options          | OFF                                           |

| myisam_repair_threads           | 1                                             |

| myisam_sort_buffer_size         | 8388608                                       |

| ndb_autoincrement_prefetch_sz   | 32                                            |

| ndb_cache_check_time            | 0                                             |

| ndb_force_send                  | ON                                            |

...                               ...                                                       ...    

| time_zone                       | SYSTEM                                        |

| timed_mutexes                   | OFF                                           |

| tmp_table_size                  | 33554432                                      |

| tmpdir                          |                                               |

| transaction_alloc_block_size    | 8192                                          |

| transaction_prealloc_size       | 4096                                          |

| tx_isolation                    | REPEATABLE-READ                               |

| updatable_views_with_limit      | YES                                           |

| version                         | 5.1.2-alpha-log                               |

| version_comment                 | Source distribution                           |

| version_compile_machine         | i686                                          |

| version_compile_os              | suse-linux                                    |

| wait_timeout                    | 28800                                         |

+---------------------------------+-----------------------------------------------+

使用LIKE子句，本语句只显示与样式相匹配的变量：

mysql> SHOW VARIABLES LIKE 'have%';

+-----------------------+----------+

| Variable_name         | Value    |

+-----------------------+----------+

| have_archive          | YES      |

| have_bdb              | NO       |

| have_blackhole_engine | YES      |

| have_compress         | YES      |

| have_crypt            | YES      |

| have_csv              | YES      |

| have_example_engine   | NO       |

| have_federated_engine | NO       |

| have_geometry         | YES      |

| have_innodb           | YES      |

| have_isam             | NO       |

| have_ndbcluster       | DISABLED |

| have_openssl          | NO       |

| have_partition_engine | YES      |

| have_query_cache      | YES      |

| have_raid             | NO       |

| have_rtree_keys       | YES      |

| have_symlink          | YES      |

+-----------------------+----------+

SHOW WARNINGS [LIMIT [offset,] row_count]

SHOW COUNT(*) WARNINGS

SHOW WARNINGS显示由上一个生成消息的语句导致的错误、警告和注意消息。如果上一个使用表的语句未生成消息，则什么也不显示。SHOW ERRORS是其相关语句，只显示错误。请参见13.5.4.9节，“SHOW ERRORS语法”。

对于使用一个表的每个新语句，消息清单均重新设置。

SHOW COUNT(*) WARNINGS语句显示错误、警告和注意的总数。您也可以从warning_count变量中找回此数目。

SHOW COUNT(*) WARNINGS;

SELECT @@warning_count;

如果max_error_count系统变量设置得过低，以致于有的消息没有被存储，则warning_count值可能比由SHOW WARNINGS显示的消息数目要大。本节后部显示的例子展示了这类情况是如何发生的。

LIMIT子句具有与SELECT语句相同的语法。请参见13.2.7节，“SELECT语法”。

MySQL服务器会发回由上一个语句引起的错误、警告和注意的总数。如果您正在使用C API，则此值可以通过调用mysql_warning_count()来获得。请参见25.2.3.69节，“mysql_warning_count()”。

对于如LOAD DATA INFILE等语句和如INSERT, UPDATE, CREATE TABLE和ALTER TABLE等DML语句，会生成警告。

以下DROP TABLE语句会导致一个注意：

mysql> DROP TABLE IF EXISTS no_such_table;

mysql> SHOW WARNINGS;

+-------+------+-------------------------------+

| Level | Code | Message                       |

+-------+------+-------------------------------+

| Note  | 1051 | Unknown table 'no_such_table' |

+-------+------+-------------------------------+

以下是一个简单的例子，显示了对于CREATE TABLE的一个语法警告，和对于INSERT的转换警告：

mysql> CREATE TABLE t1 (a TINYINT NOT NULL, b CHAR(4)) TYPE=MyISAM;

Query OK, 0 rows affected, 1 warning (0.00 sec)

mysql> SHOW WARNINGS\G

*************************** 1. row ***************************

  Level: Warning

   Code: 1287

Message: 'TYPE=storage_engine' is deprecated, use

         'ENGINE=storage_engine' instead

1 row in set (0.00 sec)

mysql> INSERT INTO t1 VALUES(10,'mysql'),(NULL,'test'),

    -> (300,'Open Source');

Query OK, 3 rows affected, 4 warnings (0.01 sec)

Records: 3  Duplicates: 0  Warnings: 4

mysql> SHOW WARNINGS\G

*************************** 1. row ***************************

  Level: Warning

   Code: 1265

Message: Data truncated for column 'b' at row 1

*************************** 2. row ***************************

  Level: Warning

   Code: 1263

Message: Data truncated, NULL supplied to NOT NULL column 'a' at row 2

*************************** 3. row ***************************

  Level: Warning

   Code: 1264

Message: Data truncated, out of range for column 'a' at row 3

*************************** 4. row ***************************

  Level: Warning

   Code: 1265

Message: Data truncated for column 'b' at row 3

4 rows in set (0.00 sec)

要存储的错误、警告和注意消息的最大数目由max_error_count系统变量控制。默认情况下，该值为64。要更改您想要存储的信息的数目，需更改max_error_count值。在下面的例子中，ALTER TABLE语句会产生三个警告消息，但是只有一个被存储，因为max_error_count被设置为1：

mysql> SHOW VARIABLES LIKE 'max_error_count';

+-----------------+-------+

| Variable_name   | Value |

+-----------------+-------+

| max_error_count | 64    |

+-----------------+-------+

1 row in set (0.00 sec)

mysql> SET max_error_count=1;

Query OK, 0 rows affected (0.00 sec)

mysql> ALTER TABLE t1 MODIFY b CHAR;

Query OK, 3 rows affected, 3 warnings (0.00 sec)

Records: 3  Duplicates: 0  Warnings: 3

mysql> SELECT @@warning_count;

+-----------------+

| @@warning_count |

+-----------------+

|               3 |

+-----------------+

1 row in set (0.01 sec)

mysql> SHOW WARNINGS;

+---------+------+----------------------------------------+

| Level   | Code | Message                                |

+---------+------+----------------------------------------+

| Warning | 1263 | Data truncated for column 'b' at row 1 |

+---------+------+----------------------------------------+

1 row in set (0.00 sec)

要禁用警告，需把max_error_count设置为0。在此情况下，warning_count仍然指示有多少警告已经发生，但是这些消息不被存储。

您可以把SQL_NOTES会话变量设置为0，使“注意”级别的警告不被记录。

STOP SLAVE [thread_type [, thread_type] ... ]

thread_type: IO_THREAD | SQL_THREAD

MySQL 5.1对服务器一方的预制语句提供支持。如果您使用合适的客户端编程界面，则这种支持可以发挥在MySQL 4.1中实施的高效客户端/服务器二进制协议的优势。候选界面包括MySQL C API客户端库（用于C程序）、MySQL Connector/J（用于Java程序）和MySQL Connector/NET。例如，C API可以提供一套能组成预制语句API的函数调用。请参见25.2.4节，“C API预处理语句”。其它语言界面可以对使用了二进制协议（通过在C客户端库中链接）的预制语句提供支持。有一个例子是PHP 5.0中的mysqli扩展。

对预制语句，还有一个SQL界面可以利用。与在整个预制语句API中使用二进制协议相比，本界面效率没有那么高，但是它不要求编程，因为在SQL层级，可以直接利用本界面：

·         当您无法利用编程界面时，您可以使用本界面。

·         有些程序允许您发送SQL语句到将被执行的服务器中，比如mysql客户端程序。您可以从这些程序中使用本界面。

·         即使客户端正在使用旧版本的客户端库，您也可以使用本界面。唯一的要求是，您能够连接到一个支持预制语句SQL语法的服务器上。

预制语句的SQL语法在以下情况下使用：

·         在编代码前，您想要测试预制语句在您的应用程序中运行得如何。或者也许一个应用程序在执行预制语句时有问题，您想要确定问题是什么。

·         您想要创建一个测试案例，该案例描述了您使用预制语句时出现的问题，以便您编制程序错误报告。

·         您需要使用预制语句，但是您无法使用支持预制语句的编程API。

预制语句的SQL语法基于三个SQL语句：

PREPARE stmt_name FROM preparable_stmt;

EXECUTE stmt_name [USING @var_name [, @var_name] ...];

{DEALLOCATE | DROP} PREPARE stmt_name;

PREPARE语句用于预备一个语句，并赋予它名称stmt_name，借此在以后引用该语句。语句名称对案例不敏感。preparable_stmt可以是一个文字字符串，也可以是一个包含了语句文本的用户变量。该文本必须展现一个单一的SQL语句，而不是多个语句。使用本语句，‘?’字符可以被用于制作参数，以指示当您执行查询时，数据值在哪里与查询结合在一起。‘?’字符不应加引号，即使您想要把它们与字符串值结合在一起，也不要加引号。参数制作符只能被用于数据值应该出现的地方，不用于SQL关键词和标识符等。

如果带有此名称的预制语句已经存在，则在新的语言被预备以前，它会被隐含地解除分配。这意味着，如果新语句包含一个错误并且不能被预备，则会返回一个错误，并且不存在带有给定名称语句。

预制语句的范围是客户端会话。在此会话内，语句被创建。其它客户端看不到它。

在预备了一个语句后，您可使用一个EXECUTE语句（该语句引用了预制语句名称）来执行它。如果预制语句包含任何参数制造符，则您必须提供一个列举了用户变量（其中包含要与参数结合的值）的USING子句。参数值只能有用户变量提供，USING子句必须准确地指明用户变量。用户变量的数目与语句中的参数制造符的数量一样多。

您可以多次执行一个给定的预制语句，在每次执行前，把不同的变量传递给它，或把变量设置为不同的值。

要对一个预制语句解除分配，需使用DEALLOCATE PREPARE语句。尝试在解除分配后执行一个预制语句会导致错误。

如果您终止了一个客户端会话，同时没有对以前已预制的语句解除分配，则服务器会自动解除分配。

以下SQL语句可以被用在预制语句中：CREATE TABLE, DELETE, DO, INSERT, REPLACE, SELECT, SET, UPDATE和多数的SHOW语句。目前不支持其它语句。

以下例子显示了预备一个语句的两种方法。该语句用于在给定了两个边的长度时，计算三角形的斜边。

第一个例子显示如何通过使用文字字符串来创建一个预制语句，以提供语句的文本：

mysql> PREPARE stmt1 FROM 'SELECT SQRT(POW(?,2) + POW(?,2)) AS hypotenuse';

mysql> SET @a = 3;

mysql> SET @b = 4;

mysql> EXECUTE stmt1 USING @a, @b;

+------------+

| hypotenuse |

+------------+

|          5 |

+------------+

mysql> DEALLOCATE PREPARE stmt1;

第二个例子是相似的，不同的是提供了语句的文本，作为一个用户变量：

mysql> SET @s = 'SELECT SQRT(POW(?,2) + POW(?,2)) AS hypotenuse';

mysql> PREPARE stmt2 FROM @s;

mysql> SET @a = 6;

mysql> SET @b = 8;

mysql> EXECUTE stmt2 USING @a, @b;

+------------+

| hypotenuse |

+------------+

|         10 |

+------------+

mysql> DEALLOCATE PREPARE stmt2;

预制语句的SQL语法不能被用于带嵌套的风格中。也就是说，被传递给PREPARE的语句本身不能是一个PREPARE, EXECUTE或DEALLOCATE PREPARE语句。

预制语句的SQL语法与使用预制语句API调用不同。例如，您不能使用mysql_stmt_prepare() C API函数来预备一个PREPARE, EXECUTE或DEALLOCATE PREPARE语句。

预制语句的SQL语法可以在已存储的过程中使用，但是不能在已存储的函数或触发程序中使用。

当使用预制语句时，可以在LIMIT子句中使用占位符。请参见13.2.7节，“SELECT语法”。

这是MySQL参考手册的翻译版本，关于MySQL参考手册，请访问dev.mysql.com。 原始参考手册为英文版，与英文版参考手册相比，本翻译版可能不是最新的。