have_query_cache というサーバーのシステム変数は、クエリキャッシュの利用可能にします。

mysql> SHOW VARIABLES LIKE 'have_query_cache';
+------------------+-------+
| Variable_name    | Value |
+------------------+-------+
| have_query_cache | YES   |
+------------------+-------+

MySQL 標準バイナリを使用しているときは、この値は常に、YES です。クエリキャッシュを無効化している場合も同様です。

システム変数によっては、クエリキャッシュのオペレーション制御を行います。mysqld 起動時に、オプションファイルやコマンドラインで指定できます。クエリキャッシュのシステム変数名はすべて、query_cache_ という文字で始まります。これに関する簡単な説明を Server System Variables で参照してください。この節では、設定に関する情報を提供します。

クエリキャッシュのサイズを設定するには、query_cache_size システム変数を使用します。値を 0 にすると、クエリキャッシュは無効化します。デフォルトは 0 で設定しています。

query_cache_size の値がゼロではない場合は、構造の割り当てにおよそ 40KB を必要とするため、クエリーキャッシュのサイズを最低 40KB で設定してください。正確なサイズは、システムのアーキテクチャーによります。サイズが小さすぎると、警告がでます。

mysql> SET GLOBAL query_cache_size = 40000;
Query OK, 0 rows affected, 1 warning (0.00 sec)
mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 1282
Message: Query cache failed to set size 39936;
         new query cache size is 0
mysql> SET GLOBAL query_cache_size = 41984;
Query OK, 0 rows affected (0.00 sec)
mysql> SHOW VARIABLES LIKE 'query_cache_size';
+------------------+-------+
| Variable_name    | Value |
+------------------+-------+
| query_cache_size | 41984 |
+------------------+-------+

クエリキャッシュでクエリー結果を維持するには、サイズを大きく設定してください。

mysql> SET GLOBAL query_cache_size = 1000000;
Query OK, 0 rows affected (0.04 sec)
mysql> SHOW VARIABLES LIKE 'query_cache_size';
+------------------+--------+
| Variable_name    | Value  |
+------------------+--------+
| query_cache_size | 999424 |
+------------------+--------+
1 row in set (0.00 sec)

query_cache_size の値は、もっとも近い 1024 バイトの倍数に揃えられます。そのため、報告される値は、設定したものとは異なる可能性があります。

クエリキャッシュのサイズが 0 より大きい場合、query_cache_type 変数がその機能に影響します。この変数は次のような値に設定できます。

GLOBAL query_cache_type の値を設定すると、変更後に接続するクライアントに対するクエリキャッシュの動作を指定できます。SESSION query_cache_type の値を設定すると、それぞれのクライアントで接続時のキャッシュ動作を制御できます。たとえば、クライアントは自分のクエリーに対するクエリキャッシュの使用を無効化します。そのクエリーは次のようなものです。

mysql> SET SESSION query_cache_type = OFF;

query_cache_type を (実行時に SET ステートメントで設定するのではなく) サーバーの起動時に設定した場合は、数値のみ使用できます。

キャッシュしたそれぞれのクエリー結果の最大サイズの制御は、query_cache_limit 変数で行います。デフォルトの値は 1MB です。

クエリーをキャッシュする設定である場合、その結果 (クライアントに送信したデータ) を、結果の読み出し中に、クエリキャッシュに格納します。そのため、データの扱いは、ひとまとめではありません。つまり、クエリキャッシュで、データをブロックに分割するため、1 つのブロックが埋まれば、次のブロックを埋めることになります。これは、メモリーの割り当てに時間がかかるため、クエリキャッシュではブロックにします。そのときのブロックのサイズを決定するのが、query_cache_min_res_unit 変数です。そして、クエリー実行毎に、ブロックはサイズでトリムすることになるので、メモリーを節約できます。サーバーで実行するクエリーの種類によっては、query_cache_min_res_unit の値を調整すると効果が高まります。