SHOW 構文

20. SHOW PLUGINS 構文

SHOW PLUGINS

SHOW PLUGINS は既知のプラグインの情報を表示します。

mysql> SHOW PLUGINS;
+------------+--------+----------------+---------+
| Name       | Status | Type           | Library |
+------------+--------+----------------+---------+
| MEMORY     | ACTIVE | STORAGE ENGINE | NULL    |
| MyISAM     | ACTIVE | STORAGE ENGINE | NULL    |
| InnoDB     | ACTIVE | STORAGE ENGINE | NULL    |
| ARCHIVE    | ACTIVE | STORAGE ENGINE | NULL    |
| CSV        | ACTIVE | STORAGE ENGINE | NULL    |
| BLACKHOLE  | ACTIVE | STORAGE ENGINE | NULL    |
| FEDERATED  | ACTIVE | STORAGE ENGINE | NULL    |
| MRG_MYISAM | ACTIVE | STORAGE ENGINE | NULL    |
+------------+--------+----------------+---------+

SHOW PLUGIN は MySQL 5.1.5 で追加され、5.1.9 で SHOW PLUGINS という名前に変わりました。(5.1.9 では SHOW PLUGIN は廃止予定で、警告を発します。)

21. SHOW PRIVILEGES 構文

SHOW PRIVILEGES

SHOW PRIVILEGES は MySQL サーバがサポートするシステム権限のリストを表示します。権限リストの詳細内容は、使用サーバのバージョンによって決まります。

mysql> SHOW PRIVILEGES\G
*************************** 1. row ***************************
Privilege: Alter
Context: Tables
Comment: To alter the table
*************************** 2. row ***************************
Privilege: Alter routine
Context: Functions,Procedures
Comment: To alter or drop stored functions/procedures
*************************** 3. row ***************************
Privilege: Create
Context: Databases,Tables,Indexes
Comment: To create new databases and tables
*************************** 4. row ***************************
Privilege: Create routine
Context: Functions,Procedures
Comment: To use CREATE FUNCTION/PROCEDURE
*************************** 5. row ***************************
Privilege: Create temporary tables
Context: Databases
Comment: To use CREATE TEMPORARY TABLE
...

22. SHOW PROCEDURE CODE と SHOW FUNCTION CODE 構文

SHOW {PROCEDURE | FUNCTION} CODE sp_name

これらのステートメントは、デバッグ サポートを利用して構築されたサーバに対してだけ有効な MySQL 拡張子です。それらは名づけられたルーチンの内部インプリメンテーション表現を表示します。そのステートメントは、あなたがそのルーチンの持ち主になるか、mysql.proc テーブルに SELECT アクセスを持つ事を要求します。

もし名づけられたルーチンが有効なら、各ステートメントは結果セットを作成します。結果セット内の各行は、ルーチン内の1つの 「instruction」 に対応します。最初のカラムは、0で始まる序数 Pos です。2つ目のカラムは、SQL ステートメントや(通常元のソースから変更された物)ストアド ルーチン ヘッダに対してだけ意味を持つコマンドを含む Instruction です。

mysql> DELIMITER //
mysql> CREATE PROCEDURE p1 ()
    -> BEGIN
    ->   DECLARE fanta INT DEFAULT 55;
    ->   DROP TABLE t2;
    ->   LOOP
    ->     INSERT INTO t3 VALUES (fanta);
    ->     END LOOP;
    ->   END//
Query OK, 0 rows affected (0.00 sec)

mysql> SHOW PROCEDURE CODE p1//
+-----+----------------------------------------+
| Pos | Instruction                            |
+-----+----------------------------------------+
|   0 | set fanta@0 55                         |
|   1 | stmt 9 "DROP TABLE t2"                 |
|   2 | stmt 5 "INSERT INTO t3 VALUES (fanta)" |
|   3 | jump 2                                 |
+-----+----------------------------------------+
4 rows in set (0.00 sec)

この例の中では、非実行可能 BEGIN と END ステートメントは無くなっており、DECLARE variable_name ステートメントに対しては、実行可能な部分だけが現れています。(デフォルトが割り当てられている部分)ソースから取り出された各ステートメントに対しては、後にタイプが続くコード文字 stmt があります。(9は DROP、5は INSERT を意味する、という感じの物です。)最終行は、GOTO instruction #2 という意味を持つ jump 2 指示を含んでいます。

これらのステートメントは、MySQL 5.1.3 で追加されました。

23. SHOW PROCEDURE STATUS と SHOW FUNCTION STATUS 構文

SHOW {PROCEDURE | FUNCTION} STATUS [LIKE 'pattern']

これらのステートメントは MySQL 拡張子です。これらは、データベース、名前タイプ、作成者、そして作成日と変更日などのような、ルーチンの性質を返します。もしパターンが指定されなければ、どのステートメントを利用しているかによって、全てのストアド プロシージャや全てのストアド ファンクションの情報がリストされます。

mysql> SHOW FUNCTION STATUS LIKE 'hello'\G
*************************** 1. row ***************************
           Db: test
         Name: hello
         Type: FUNCTION
      Definer: testuser@localhost
     Modified: 2004-08-03 15:29:37
      Created: 2004-08-03 15:29:37
Security_type: DEFINER
      Comment:

INFORMATION_SCHEMA 内の ROUTINES テーブルからストアド ルーチンに関する情報を得る事もできます。詳しくは 項21.14. 「INFORMATION_SCHEMA ROUTINES テーブル」 を参照してください。

24. SHOW PROCESSLIST 構文

SHOW [FULL] PROCESSLIST

SHOW PROCESSLIST はどのスレッドが起動しているかを表示します。mysqladmin processlist コマンドを利用してこの情報を手に入れる事もできます。

もし PROCESS 権限を持っていれば、全てのスレッドを見る事ができます。そうでなければ、自分自身のスレッドのみ見る事ができます。（使用中のMySQL アカウントと関連しているスレッド）詳しくは 項3. 「KILL 構文」 を参照してください。もし FULL キーワードを利用しなければ、各ステートメントの最初の100文字だけが Info フィールドに表示されます。

MySQL Enterprise MySQL ネットワーク モニタリングとアドバイス サービス の読者は、プロセスが多すぎる時には、即時通知と専門家のアドバイスを受け取ります。追加情報については http://www-jp.mysql.com/products/enterprise/advisors.html を参照してください。

このステートメントは、「too many connections」 エラー メッセージを受け取り、何が起こっているのを確認したい時に大変役に立ちます。MySQL は、管理者がいつでもシステムに接続して確認できる事を保証する為、SUPER 権限を持つアカウントに利用される事ができる接続を1つ余分に確保します。(この権限を全てのユーザには与えていないと仮定しています。)

SHOW PROCESSLIST のアウトプットは、次のようになるでしょう。

mysql> SHOW FULL PROCESSLIST\G
*************************** 1. row ***************************
Id: 1
User: system user
Host:
db: NULL
Command: Connect
Time: 1030455
State: Waiting for master to send event
Info: NULL
*************************** 2. row ***************************
Id: 2
User: system user
Host:
db: NULL
Command: Connect
Time: 1004
State: Has read all relay log; waiting for the slave »
       I/O thread to update it
Info: NULL
*************************** 3. row ***************************
Id: 3112
User: replikator
Host: artemis:2204
db: NULL
Command: Binlog Dump
Time: 2144
State: Has sent all binlog to slave; waiting for binlog to be updated
Info: NULL
*************************** 4. row ***************************
Id: 3113
User: replikator
Host: iconnect2:45781
db: NULL
Command: Binlog Dump
Time: 2086
State: Has sent all binlog to slave; waiting for binlog to be updated
Info: NULL
*************************** 5. row ***************************
Id: 3123
User: stefan
Host: localhost
db: apollon
Command: Query
Time: 0
State: NULL
Info: SHOW FULL PROCESSLIST
5 rows in set (0.00 sec)

アウトプット カラムは次の意味を持っています。

SHOW PROCESSLIST からのアウトプット内で主に見られるいくつかの State 値

ほとんどのステートが大変速い操作に対応します。もしスレッドがこれらのステートのどれかに何秒間も留まれば、調査が必要な問題があるかもしれません。

25. SHOW SCHEDULER STATUS 構文

SHOW SCHEDULER STATUS

このステートメントは、イベント スケジューラの状態に関連したでバグ情報を提供します。これは、MySQL 5.1.11 の -debug 構造内でだけサポートされ、5.1.12 とそれ以降のリリースでは削除されました。

アウトプット例がここに表示されています。

+--------------------------------+---------------------+
| Name                           | Value               |
+--------------------------------+---------------------+
| scheduler state                | INITIALIZED         |
| thread_id                      | NULL                |
| scheduler last locked at       | init_scheduler::313 |
| scheduler last unlocked at     | init_scheduler::318 |
| scheduler waiting on condition | 0                   |
| scheduler workers count        | 0                   |
| scheduler executed events      | 0                   |
| scheduler data locked          | 0                   |
| queue element count            | 1                   |
| queue data locked              | 0                   |
| queue data attempting lock     | 0                   |
| queue last locked at           | create_event::218   |
| queue last unlocked at         | create_event::222   |
| queue last attempted lock at   | ::0                 |
| queue waiting on condition     | 0                   |
| next activation at             |    0-00-00 00:00:00 |
+--------------------------------+---------------------+

MySQL 5.1.12 以降の物では、この情報は mysqladmin debug を利用して得る事ができます。（詳しくは 項7.9. 「mysqladmin — MySQL サーバの管理を行うクライアント」 をご確認ください。）イベント スケジューラ ステート情報を得る事に関する情報については、項19.4. 「Event Scheduler Status」 を参照してください。

26. SHOW STATUS 構文

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

SHOW STATUS はサーバ ステータス情報を提供します。この情報は、mysqladmin extended-status コマンドを利用して得る事もできます。

部分的なアウトプットがここに表示されています。名前と値のリストは、お使いのサーバとは異なる場合があります。各変数の意味は 項 「ステータス変数」 で説明しています。

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 修飾子を利用すると、SHOW STATUS は MySQL への全ての接続のステータス値を表示します。SESSION を利用すると、現在の接続のステータス値を表示します。 もし修飾子が無ければ、デフォルトは SESSION です。LOCAL は SESSION の同義語です。

いくつかのステータス変数は、グローバル値しか持っていません。それらに対しては、GLOBAL と SESSION の両方に同じ値を得ます。

27. SHOW TABLE STATUS 構文

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

SHOW TABLE STATUS は SHOW TABLES のように機能しますが、各テーブルに関する多くの情報を提供します。mysqlshow --status db_name コマンドを利用してこのリストを得る事もできます。

このステートメントもまたビューの情報を表示します。

SHOW TABLE STATUS は次のフィールドを返します。

InnoDB テーブルは、テーブル コメントの中で、 それが属する所にテーブルスペースのフリー スペースを報告します。共有テーブルスペースの中にあるテーブルには、これが共有テーブルスペースの空きスペースです。もし複数のテーブルスペースを利用していて、そのテーブルが専用のテーブルスペースを所有していたら、そのフリー スペースはそのテーブルだけの物です。

MEMORY テーブルに対して、Data_length、Max_data_length、そして Index_length 値は割り当てられたメモリの実際の量を概算します。割り当てアルゴリズムは、割り当て操作の数を減らす為に、大量のメモリを確保します。

NDB Cluster テーブルに対して、BLOB カラムは考慮されないという例外はありますが、このステートメントのアウトプットは Avg_row_length と Data_length カラムのおおよその値を表します。 さらに、レプリカの数が Comment カラム内に表示されます。(number_of_replicas として)

ビューに関しては、Name がビュー名を指示し、Comment が view と言う事以外、SHOW TABLE STATUS に表示される全てのフィールドは NULL です。

28. SHOW TABLES 構文

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

SHOW TABLES は、与えられたテーブル内で非 TEMPORARY テーブルをリストします。mysqlshow db_name コマンドを利用してこのリストを得る事もできます。

このステートメントはデータベース内のビューもリストします。FULL 修飾子は SHOW FULL TABLES が第2のアウトプット カラムを表示するようにサポートされています。第2カラムの値は、テーブルに対しては BASE TABLE で、ビューに対しては VIEW です。

注意:もしテーブルに権限を持っていなかったら、テーブルは SHOW TABLES か mysqlshow db_name からのアウトプット内に現れません。

29. SHOW TRIGGERS 構文

SHOW TRIGGERS [FROM db_name] [LIKE expr]

SHOW TRIGGERS は最近 MySQL サーバ上で定義されたトリガをリストします。このステートメントは SUPER 権限を必要とします。

項18.3. 「トリガの使用」 内で定義されている、トリガ ins_sum に対しては、このステートメントのアウトプットはここに表されているようになります。

mysql> SHOW TRIGGERS LIKE 'acc%'\G
*************************** 1. row ***************************
  Trigger: ins_sum
    Event: INSERT
    Table: account
Statement: SET @sum = @sum + NEW.amount
   Timing: BEFORE
  Created: NULL
 sql_mode:
  Definer: myname@localhost

注意:LIKE 条項を SHOW TRIGGERS と利用する時、一致する式(expr) は、トリガ名ではなく、トリガが宣言されたテーブル名と比較されます。

mysql> SHOW TRIGGERS LIKE 'ins%';
Empty set (0.01 sec)

このステートメントのアウトプット内のカラムに関する簡単な説明はここに表されています。

項21.16. 「INFORMATION_SCHEMA TRIGGERS テーブル」 もご参照ください。

30. SHOW VARIABLES 構文

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

SHOW VARIABLES は MySQL システム変数の値を表示します。mysqladmin variables コマンドを利用してこの情報を得る事もできます。

GLOBAL 修飾子を利用すると、SHOW VARIABLES は MySQL への新しい接続に利用される値を表示します。SESSION を利用すると、現在の接続に有効な値を表示します。 もし修飾子が無ければ、デフォルトは SESSION です。LOCAL は SESSION の同義語です。

もしデフォルトのシステム変数が不適切であれば、mysqld がスタートした時にコマンド オプションを利用してそれらを設定する事ができ、また SET ステートメントを利用してほとんどの物をランタイムに変更できます。項 「システム変数の使用」 と 項 「SET 構文」 を参照して下さい。

部分的なアウトプットがここに表示されています。名前と値のリストは、お使いのサーバとは異なる場合があります。項 「システム変数」 で各変数の意味が説明されており、項 「サーバパラメータのチューニング」 にはそれらを調整する為の情報が紹介されています。

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.6-alpha-log           |
| version_comment                 | Source distribution       |
| version_compile_machine         | i686                      |
| version_compile_os              | suse-linux                |
| wait_timeout                    | 28800                     |
+---------------------------------+---------------------------+

LIKE 条項を利用すると、パターンと一致する名前を持つ変数の行のみを表示します。

特定の変数に行を得る為には、次に表示されているように LIKE 条項を利用してください。

SHOW VARIABLES LIKE 'max_join_size';
SHOW SESSION VARIABLES LIKE 'max_join_size';

名前がパターンと一致する変数のリストを得るには、LIKE 条項内の ‘%’ ワイルドカード文字を利用してください。

SHOW VARIABLES LIKE '%size%';
SHOW GLOBAL VARIABLES LIKE '%size%';

ワイルドカード文字は、一致するパターン内のどの場所でも利用する事ができます。厳密に言うと、‘_’ は全ての単一文字と一致するワイルドカードなので、完全に一致させる為に ‘\_’ の時は拡張する必要があります。実際には、これはほとんど必要ありません。

31. SHOW WARNINGS 構文

SHOW WARNINGS [LIMIT [offset,] row_count]
SHOW COUNT(*) WARNINGS

SHOW WARNINGS は、メッセージを作成した最後のステートメントから生じたエラー、警告、そしてノート メッセージを表示、または、もしテーブルを利用した最後のステートメントが何のメッセージも作成しなければ、何も表示しません。関連ステートメントである SHOW ERRORS はエラーだけを表示します。詳しくは 項14. 「SHOW ERRORS 構文」 を参照してください。

テーブルを利用するそれぞれの新ステートメントに対して、メッセージのリストはリセットされます。

SHOW COUNT(*) WARNINGS ステートメントはエラー、警告、そしてノートの総数を表示します。warning_count 変数からもこの数字を検索する事ができます。

SHOW COUNT(*) WARNINGS;
SELECT @@warning_count;

もし max_error_count システム変数が、全てのメッセージの格納ができないほど低く設定されると、warning_count の値は SHOW WARNINGS によって表示されるメッセージ数よりも大きくなります。このセクションの後の方で表示される例で、これがどのように起きるのか紹介しています。

LIMIT 条項は SELECT ステートメントに対するのと同じ構文を持っています。詳しくは 項 「SELECT 構文」 を参照してください。

MySQL サーバは、最後のステートメントから生じたエラー、警告、そしてノートの総数を送り返します。もし C API を利用していれば、この値は mysql_warning_count() をコールする事で得る事ができます。詳しくは 項72. 「mysql_warning_count()」 を参照してください。

警告は、LOAD DATA INFILE や、また DML 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 ステートメントは3つの警告メッセージを発生しますが、max_error_count が1に設定されている為、そのうちの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に設定して、Note レベルの警告が記録されないようにできます。