MySQL Server では、一般クエリーログおよびスロークエリーログが有効になっている場合は、それらのログに書き込まれる出力先を柔軟に制御できます。 ログエントリに使用可能な宛先は、ログファイル、または mysql システムデータベース内の general_log テーブルと slow_log テーブルです。 ファイル出力またはテーブル出力、あるいはその両方を選択できます。
log_output システム変数は、ログ出力の出力先を指定します。 この変数を単独で設定してもログは有効になりません。個別に有効にする必要があります。
起動時に
log_outputが指定されていない場合、デフォルトのロギング先はFILEです。起動時に
log_outputが指定された場合、その値はTABLE(テーブルに記録)、FILE(ファイルに記録) またはNONE(テーブルまたはファイルに記録しない) から選択されたカンマ区切りの単語のリストです。NONEがある場合は、ほかの指定子よりも優先されます。
general_log システム変数は、選択されたログ出力先についての一般クエリーログへのロギングを制御します。 サーバー起動時に指定された場合、general_log は、ログを有効化または無効化するためのオプション引数 1 または 0 を取ります。 ファイルロギングについて、デフォルト以外のファイル名を指定するには、general_log_file 変数を設定します。 同様に、slow_query_log 変数は、選択された出力先についてのスロークエリーログへのロギングを制御し、slow_query_log_file の設定は、ファイルロギングのためのファイル名を指定します。 いずれかのログが有効化された場合、サーバーは対応するログファイルを開き、ログファイルに起動メッセージを書き込みます。 ただし、FILE ログの出力先が選択されないかぎり、ファイルに対するそれ以上のクエリーのロギングは実行されません。
例:
一般クエリーログエントリをログテーブルおよびログファイルに書き込むには、
--log_output=TABLE,FILEを使用してログの宛先と--general_logの両方を選択し、一般クエリーログを有効にします。一般クエリーログエントリとスロークエリーログエントリのみをログテーブルに書き込むには、
--log_output=TABLEを使用してログの宛先としてテーブルを選択し、--general_logと--slow_query_logを使用して両方のログを有効にします。スロークエリーログエントリをログファイルにのみ書き込むには、
--log_output=FILEを使用してログの宛先としてファイルを選択し、--slow_query_logを使用してスロークエリーログを有効にします。 この場合、デフォルトのログ保存先はFILEであるため、log_output設定を省略できます。
ログテーブルおよびファイルに関連付けられたシステム変数によって、ロギングへの実行時制御が可能になります。
log_output変数は、現在のロギング先を示します。 出力先を変更するために、これを実行時に変更できます。general_logおよびslow_query_log変数は、一般クエリーログとスロークエリーログが有効 (ON) か無効 (OFF) かを示します。 これらの変数を実行時に設定して、ログを有効化するかどうかを制御することができます。general_log_fileおよびslow_query_log_file変数は、一般クエリーログおよびスロークエリーログファイルの名前を示します。 これらの変数をサーバー起動時または実行時に設定して、ログファイルの名前を変更することができます。現在のセッションの一般クエリーロギングを無効または有効にするには、セッション
sql_log_off変数をONまたはOFFに設定します。 (これは、一般クエリーログ自体が有効になっていることを前提としています。)
ログ出力用のテーブルを使用することには、次の利点があります。
-
ログエントリが標準形式を持ちます。 ログテーブルの現在の構造を表示するには、次のステートメントを使用します。
SHOW CREATE TABLE mysql.general_log; SHOW CREATE TABLE mysql.slow_log; ログ内容に SQL ステートメントを使用してアクセスできます。 これにより、特定の基準を満たすログエントリのみ選択するクエリーを使用することができます。 たとえば、特定のクライアントに関連したログ内容を選択するには (そのクライアントからの問題のあるクエリーを特定するために役立つことがあります)、ログファイルよりもログテーブルを使用して行う方が簡単です。
サーバーに接続してクエリーを発行できるすべてのクライアントを介して、ログにリモートからアクセスできます (クライアントが適切なログテーブル権限を持つ場合)。 サーバーホストにログインしてファイルシステムに直接アクセスする必要はありません。
ログテーブルの実装には次の特徴があります。
一般的に、ログテーブルの主な目的は、サーバーのランタイム実行を観察するユーザーにインタフェースを提供することで、サーバーのランタイム実行を妨げません。
CREATE TABLE、ALTER TABLE、およびDROP TABLEはログテーブル上での有効な操作です。ALTER TABLEおよびDROP TABLEの場合、ログテーブルは使用中であってはならず、あとで説明するように無効にする必要があります。-
デフォルトでは、ログテーブルは、カンマ区切り値形式でデータを書き込む
CSVストレージエンジンを使用します。 ログテーブルデータを含む.CSVファイルにアクセスするユーザーの場合、CSV 入力を処理できるスプレッドシートなどのほかのプログラムにファイルを簡単にインポートできます。ログテーブルは、
MyISAMストレージエンジンを使用するように変更することができます。 使用中のログテーブルを変更するために、ALTER TABLEを使用することはできません。 ログを最初に無効にする必要があります。CSVまたはMyISAM以外のすべてのエンジンは、ログテーブルについて適正ではありません。ログテーブルおよび「「開いているファイルが多すぎます」」エラー. ログの宛先として
TABLEを選択し、ログテーブルがCSVストレージエンジンを使用している場合、一般クエリーログまたはスロークエリーログを実行時に繰り返し無効にして有効にすると、.CSVファイル用に多数のオープンファイル記述子が生成され、「「開いているファイルが多すぎます」」エラーが発生する可能性があります。 この問題を回避するには、FLUSH TABLESを実行するか、open_files_limitの値がtable_open_cache_instancesの値より大きいことを確認します。 -
ログテーブルを変更 (または削除) できるようにロギングを無効化するには、次の方法を使用することができます。 この例では一般クエリーログを使用しており、スロークエリーログについての手順も類似していますが、
slow_logテーブルおよびslow_query_logシステム変数を使用します。SET @old_log_state = @@GLOBAL.general_log; SET GLOBAL general_log = 'OFF'; ALTER TABLE mysql.general_log ENGINE = MyISAM; SET GLOBAL general_log = @old_log_state; TRUNCATE TABLEは、ログテーブル上での有効な操作です。 ログエントリを期限切れにするために使用できます。-
RENAME TABLEは、ログテーブル上での有効な操作です。 次の方法を使用して、(たとえばログローテーションを実行するために) ログテーブルを原子的に名前変更できます。USE mysql; DROP TABLE IF EXISTS general_log2; CREATE TABLE general_log2 LIKE general_log; RENAME TABLE general_log TO general_log_backup, general_log2 TO general_log; CHECK TABLEは、ログテーブル上での有効な操作です。LOCK TABLESをログテーブル上で使用することはできません。INSERT、DELETE、およびUPDATEをログテーブル上で使用することはできません。 これらの操作は、サーバー自体の内部でのみ許可されます。FLUSH TABLES WITH READ LOCKおよびread_onlyシステム変数の状態は、ログテーブルには影響しません。 サーバーは常にログテーブルに書き込むことができます。ログテーブルに書き込まれたエントリはバイナリログに書き込まれないため、複製に複製されません。
ログテーブルまたはログファイルをフラッシュするには、
FLUSH TABLESまたはFLUSH LOGSをそれぞれ使用します。ログテーブルのパーティション化は許可されません。
mysqldump ダンプには、ダンプファイルのリロード後に欠落しないように、これらのテーブルを再作成するステートメントが含まれています。 ログテーブルの内容はダンプされません。