常規查詢日誌是關於 **mysqld** 正在做什麼的常規記錄。當客戶端連線或斷開連線時，伺服器將資訊寫入該日誌，並記錄從客戶端接收的每個SQL語句。當您懷疑客戶端出現錯誤並想要確切地知道客戶端傳送給 **mysqld** 的內容時，常規查詢日誌可能非常有用。

顯示客戶機何時連線的每一行還包括使用 connection_type 來指示用於建立連線的協議。connection_type 是TCP/IP（不使用 SSL 建立的 TCP/IP 連線）、SSL/TLS（使用 SSL 建立的 TCP/IP 連線）、Socket（Unix套接字檔案連線）、Named Pipe（Windows命名管道連線）或Shared Memory（Windows共享記憶體連線）中的一種。

**mysqld** 按照接收到語句的順序將語句寫入查詢日誌，這個順序可能與語句執行的順序不同。這種日誌記錄順序與二進位制日誌的順序相反，二進位制日誌的順序是在執行語句之後，但在釋放任何鎖之前寫入語句。此外，查詢日誌可能包含只選擇資料的語句，而這些語句永遠不會寫入二進位制日誌。

在複製源伺服器上使用基於語句的二進位制日誌記錄時，其副本接收到的語句被寫入每個副本的查詢日誌。如果客戶機使用 **mysqlbinlog** 實用程式讀取事件並將其傳遞給伺服器，則將語句寫入源的查詢日誌。

然而，當使用基於行的二進位制日誌記錄時，更新是作為行更改而不是 SQL 語句傳送的，因此當 binlog_format 為 row 時，這些語句永遠不會寫入查詢日誌。當該變數設定為 MIXED 時，給定的更新也可能不會寫入查詢日誌，具體取決於所使用的語句。

預設情況下，常規查詢日誌是關閉的。要顯式指定初始通用查詢日誌狀態，請使用`--general_log[={0|1}]`。如果不帶引數或引數為 1，`--general_log` 將啟用日誌。如果引數為 0，該選項將禁用日誌。要指定日誌檔名，使用`--general_log_file=file_name`。要指定日誌目的地，請使用 `log_output` 系統變數。

如果未指定通用查詢日誌檔案的名稱，則預設名稱為 host_name.log。伺服器將在資料目錄中建立檔案，除非給出了絕對路徑名來指定不同的目錄。

要禁用或啟用通用查詢日誌或在執行時更改日誌檔名，請使用全域性 general_log 和 general_log_file 系統變數。將 general_log 設定為 0（或 OFF）以禁用日誌，將 general_log 設定為 1（或 ON）以啟用日誌。設定general_log_file 指定日誌檔案的名稱。如果一個日誌檔案已經開啟，它將被關閉，並開啟新檔案。

啟用常規查詢日誌後，伺服器將輸出寫到 log_output 系統變數指定的任何目的地。如果啟用日誌，伺服器將開啟日誌檔案並向其寫入啟動訊息。但是，除非選擇了 FILE 日誌目的地，否則不會對檔案的查詢進行進一步的日誌記錄。如果目標為 NONE，則即使啟用了常規日誌，伺服器也不寫入查詢。如果日誌目的值不包含 FILE，則設定日誌檔名對日誌記錄沒有影響。

伺服器重啟和日誌重新整理不會導致生成新的常規查詢日誌檔案（儘管重新整理會關閉並重新開啟該檔案）。要重新命名檔案並建立新檔案，使用以下命令：

```terminal
$> mv host_name.log host_name-old.log
$> mysqladmin flush-logs general
$> mv host_name-old.log backup-directory
```

在 Windows 上，使用 **rename** 而不是 **mv**.

您還可以在執行時透過禁用日誌來重新命名常規查詢日誌檔案：

```sql
SET GLOBAL general_log = 'OFF';
```

在禁用日誌的情況下，從外部（例如，從命令列）重新命名日誌檔案。然後再次啟用日誌：

```sql
SET GLOBAL general_log = 'ON';
```

此方法適用於任何平臺，並且不需要重新啟動伺服器。

要禁用或啟用當前會話的常規查詢日誌記錄，請將會話 sql_log_off 變數設定為 ON 或 OFF。(這假定啟用了常規查詢日誌本身。)

寫入常規查詢日誌的語句中的密碼由伺服器重寫，而不是以純文字形式出現。透過使用 `--log-raw` 選項啟動伺服器，可以抑制常規查詢日誌的密碼重寫。此選項對於診斷目的可能很有用，可以檢視伺服器接收到的語句的確切文字，但出於安全原因，不建議在生產環境中使用。

密碼重寫的一個含義是，無法解析的語句（例如，由於語法錯誤）不會被寫入常規查詢日誌，因為無法知道它們是否與密碼無關。需要記錄所有語句（包括那些有錯誤的語句）的用例應該使用 `--log-raw` 選項，記住這也繞過了密碼重寫。

密碼重寫僅在期望使用純文字密碼時發生。對於語法需要密碼雜湊值的語句，不會進行重寫。如果為這種語法錯誤地提供了純文字密碼，則按照給定的方式記錄密碼，而不會重寫。

`log_timestamps` 系統變數控制寫入常規查詢日誌檔案（以及慢查詢日誌檔案和錯誤日誌）的訊息中時間戳的時區。它不會影響寫入日誌表的常規查詢日誌和慢速查詢日誌訊息的時區，但是可以使用 CONVERT_TZ() 或透過設定會話 time_zone 系統變數，將從這些表檢索到的行從本地系統時區轉換為所需的任何時區。

MySQL8.0：The General Query Log

相關文章