稽核日誌外掛程式支援函數，這些函數提供一個 SQL 介面，用於讀取 JSON 格式的稽核日誌檔案。（此功能不適用於以其他格式寫入的日誌檔案。）

當稽核日誌外掛程式初始化並設定為 JSON 記錄時，它會使用包含目前稽核日誌檔案的目錄作為搜尋可讀取稽核日誌檔案的位置。外掛程式會從 audit_log_file 系統變數的值判斷檔案位置、基本名稱和後綴，然後搜尋名稱符合下列模式的檔案，其中 [...] 表示選用的檔案名稱部分

basename[.timestamp].suffix[.gz][[.pwd_id].enc]

如果檔案名稱以 .enc 結尾，則該檔案會被加密，並且讀取其未加密的內容需要從金鑰環取得解密密碼。稽核日誌外掛程式會如下決定解密密碼的金鑰環 ID

如需有關加密稽核日誌檔案的詳細資訊，請參閱加密稽核日誌檔案。

外掛程式會忽略已手動重新命名且不符合模式的檔案，以及使用金鑰環中不再可用的密碼加密的檔案。外掛程式會開啟每個剩餘的候選檔案，驗證檔案實際上包含 JSON 稽核事件，並使用每個檔案的第一個事件的時間戳記對檔案進行排序。結果是可以使用記錄讀取函數存取的一系列檔案

audit_log_read() 接受一個可選的 JSON 字串引數，而且成功呼叫任一函式所傳回的結果都是 JSON 字串。

若要使用這些函式讀取稽核日誌，請遵循以下原則

若要指定位置給 audit_log_read()，請包含一個引數，指示從何處開始讀取。例如，傳遞一個書籤，該書籤是一個 JSON 雜湊，其中包含可唯一識別特定事件的 timestamp 和 id 元素。以下是一個透過呼叫 audit_log_read_bookmark() 函式取得的書籤範例

mysql> SELECT audit_log_read_bookmark();
+-------------------------------------------------+
| audit_log_read_bookmark()                       |
+-------------------------------------------------+
| { "timestamp": "2020-05-18 21:03:44", "id": 0 } |
+-------------------------------------------------+

將目前的書籤傳遞給 audit_log_read() 會初始化從書籤位置開始的事件讀取

mysql> SELECT audit_log_read(audit_log_read_bookmark());
+-----------------------------------------------------------------------+
| audit_log_read(audit_log_read_bookmark())                             |
+-----------------------------------------------------------------------+
| [ {"timestamp":"2020-05-18 22:41:24","id":0,"class":"connection", ... |
+-----------------------------------------------------------------------+

audit_log_read() 的引數是可選的。如果存在，它可以是 JSON null 值以關閉讀取序列，或是一個 JSON 雜湊。

在 audit_log_read() 的雜湊引數中，項目是可選的，並控制讀取作業的各個方面，例如開始讀取的位置或要讀取的事件數量。以下項目很重要（其他項目會被忽略）

若要指定開始位置給 audit_log_read()，請傳遞一個雜湊引數，其中包含 start 項目或由 timestamp 和 id 項目組成的書籤。如果雜湊引數同時包含 start 項目和書籤，則會發生錯誤。

如果雜湊引數未指定開始位置，則會從目前位置繼續讀取。

如果時間戳記值不包含時間部分，則會假設時間部分為 00:00:00。

audit_log_read() 接受的引數範例

可以根據需要操作任一記錄讀取函式傳回的 JSON 字串。假設呼叫以取得書籤會產生此值

mysql> SET @mark := audit_log_read_bookmark();
mysql> SELECT @mark;
+-------------------------------------------------+
| @mark                                           |
+-------------------------------------------------+
| { "timestamp": "2020-05-18 16:10:28", "id": 2 } |
+-------------------------------------------------+

使用該引數呼叫 audit_log_read() 可以傳回多個事件。若要限制 audit_log_read() 最多讀取 N 個事件，請在字串中新增一個具有該值的 max_array_length 項目。例如，若要讀取單個事件，請如下修改字串

mysql> SET @mark := JSON_SET(@mark, '$.max_array_length', 1);
mysql> SELECT @mark;
+----------------------------------------------------------------------+
| @mark                                                                |
+----------------------------------------------------------------------+
| {"id": 2, "timestamp": "2020-05-18 16:10:28", "max_array_length": 1} |
+----------------------------------------------------------------------+

修改後的字串在傳遞給 audit_log_read() 時，會產生一個最多包含一個事件的結果，無論有多少事件可用。

如果從 mysql 用戶端內叫用稽核日誌函式，二進位字串結果會使用十六進位表示法顯示，具體取決於 --binary-as-hex 的值。有關該選項的更多資訊，請參閱第 6.5.1 節「mysql — MySQL 命令列用戶端」。

若要設定 audit_log_read() 讀取的位元組數限制，請設定 audit_log_read_buffer_size 系統變數。此變數的預設值為 32KB，可以在執行階段設定。每個用戶端都應針對其 audit_log_read() 的使用情況適當地設定其工作階段值 audit_log_read_buffer_size。

每次呼叫 audit_log_read() 都會傳回緩衝區大小內可容納的盡可能多的事件。不符合緩衝區大小的事件將會被跳過並產生警告。考慮到這種行為，請在評估應用程式的適當緩衝區大小時考慮以下因素

如需有關稽核日誌讀取函式的更多資訊，請參閱稽核日誌函式。