MySQL :: MySQL 9.0 參考手冊 :: 6.6.9.2 mysqlbinlog 列事件顯示

版本 9.0

8.4 目前
8.0
5.7

8.0 日文

MySQL 9.0 參考手冊 / ... / mysqlbinlog 列事件顯示

6.6.9.2 mysqlbinlog 列事件顯示

以下範例說明 mysqlbinlog 如何顯示指定資料修改的列事件。這些對應於類型代碼為 WRITE_ROWS_EVENT、UPDATE_ROWS_EVENT 和 DELETE_ROWS_EVENT 的事件。--base64-output=DECODE-ROWS 和 --verbose 選項可用於影響列事件輸出。

假設伺服器正在使用基於列的二進位記錄，並且您執行以下陳述式序列

CREATE TABLE t
(
  id   INT NOT NULL,
  name VARCHAR(20) NOT NULL,
  date DATE NULL
) ENGINE = InnoDB;

START TRANSACTION;
INSERT INTO t VALUES(1, 'apple', NULL);
UPDATE t SET name = 'pear', date = '2009-01-01' WHERE id = 1;
DELETE FROM t WHERE id = 1;
COMMIT;

預設情況下，mysqlbinlog 使用 BINLOG 陳述式顯示編碼為 base-64 字串的列事件。省略無關的行，前面陳述式序列產生的列事件的輸出如下所示

$> mysqlbinlog log_file
...
# at 218
#080828 15:03:08 server id 1  end_log_pos 258   Write_rows: table id 17 flags: STMT_END_F

BINLOG '
fAS3SBMBAAAALAAAANoAAAAAABEAAAAAAAAABHRlc3QAAXQAAwMPCgIUAAQ=
fAS3SBcBAAAAKAAAAAIBAAAQABEAAAAAAAEAA//8AQAAAAVhcHBsZQ==
'/*!*/;
...
# at 302
#080828 15:03:08 server id 1  end_log_pos 356   Update_rows: table id 17 flags: STMT_END_F

BINLOG '
fAS3SBMBAAAALAAAAC4BAAAAABEAAAAAAAAABHRlc3QAAXQAAwMPCgIUAAQ=
fAS3SBgBAAAANgAAAGQBAAAQABEAAAAAAAEAA////AEAAAAFYXBwbGX4AQAAAARwZWFyIbIP
'/*!*/;
...
# at 400
#080828 15:03:08 server id 1  end_log_pos 442   Delete_rows: table id 17 flags: STMT_END_F

BINLOG '
fAS3SBMBAAAALAAAAJABAAAAABEAAAAAAAAABHRlc3QAAXQAAwMPCgIUAAQ=
fAS3SBkBAAAAKgAAALoBAAAQABEAAAAAAAEAA//4AQAAAARwZWFyIbIP
'/*!*/;

若要以「偽 SQL」陳述式的形式將列事件視為註解，請使用 mysqlbinlog 和 --verbose 或 -v 選項執行。此輸出層級也會顯示適用的表格分割區資訊。輸出包含以 ### 開頭的行

$> mysqlbinlog -v log_file
...
# at 218
#080828 15:03:08 server id 1  end_log_pos 258   Write_rows: table id 17 flags: STMT_END_F

BINLOG '
fAS3SBMBAAAALAAAANoAAAAAABEAAAAAAAAABHRlc3QAAXQAAwMPCgIUAAQ=
fAS3SBcBAAAAKAAAAAIBAAAQABEAAAAAAAEAA//8AQAAAAVhcHBsZQ==
'/*!*/;
### INSERT INTO test.t
### SET
###   @1=1
###   @2='apple'
###   @3=NULL
...
# at 302
#080828 15:03:08 server id 1  end_log_pos 356   Update_rows: table id 17 flags: STMT_END_F

BINLOG '
fAS3SBMBAAAALAAAAC4BAAAAABEAAAAAAAAABHRlc3QAAXQAAwMPCgIUAAQ=
fAS3SBgBAAAANgAAAGQBAAAQABEAAAAAAAEAA////AEAAAAFYXBwbGX4AQAAAARwZWFyIbIP
'/*!*/;
### UPDATE test.t
### WHERE
###   @1=1
###   @2='apple'
###   @3=NULL
### SET
###   @1=1
###   @2='pear'
###   @3='2009:01:01'
...
# at 400
#080828 15:03:08 server id 1  end_log_pos 442   Delete_rows: table id 17 flags: STMT_END_F

BINLOG '
fAS3SBMBAAAALAAAAJABAAAAABEAAAAAAAAABHRlc3QAAXQAAwMPCgIUAAQ=
fAS3SBkBAAAAKgAAALoBAAAQABEAAAAAAAEAA//4AQAAAARwZWFyIbIP
'/*!*/;
### DELETE FROM test.t
### WHERE
###   @1=1
###   @2='pear'
###   @3='2009:01:01'

指定 --verbose 或 -v 兩次，以同時顯示每個欄位的資料類型和一些中繼資料，以及資訊記錄事件（例如，如果 binlog_rows_query_log_events 系統變數設定為 TRUE，則顯示列查詢記錄事件）。輸出會在每次欄位變更後包含額外的註解

$> mysqlbinlog -vv log_file
...
# at 218
#080828 15:03:08 server id 1  end_log_pos 258   Write_rows: table id 17 flags: STMT_END_F

BINLOG '
fAS3SBMBAAAALAAAANoAAAAAABEAAAAAAAAABHRlc3QAAXQAAwMPCgIUAAQ=
fAS3SBcBAAAAKAAAAAIBAAAQABEAAAAAAAEAA//8AQAAAAVhcHBsZQ==
'/*!*/;
### INSERT INTO test.t
### SET
###   @1=1 /* INT meta=0 nullable=0 is_null=0 */
###   @2='apple' /* VARSTRING(20) meta=20 nullable=0 is_null=0 */
###   @3=NULL /* VARSTRING(20) meta=0 nullable=1 is_null=1 */
...
# at 302
#080828 15:03:08 server id 1  end_log_pos 356   Update_rows: table id 17 flags: STMT_END_F

BINLOG '
fAS3SBMBAAAALAAAAC4BAAAAABEAAAAAAAAABHRlc3QAAXQAAwMPCgIUAAQ=
fAS3SBgBAAAANgAAAGQBAAAQABEAAAAAAAEAA////AEAAAAFYXBwbGX4AQAAAARwZWFyIbIP
'/*!*/;
### UPDATE test.t
### WHERE
###   @1=1 /* INT meta=0 nullable=0 is_null=0 */
###   @2='apple' /* VARSTRING(20) meta=20 nullable=0 is_null=0 */
###   @3=NULL /* VARSTRING(20) meta=0 nullable=1 is_null=1 */
### SET
###   @1=1 /* INT meta=0 nullable=0 is_null=0 */
###   @2='pear' /* VARSTRING(20) meta=20 nullable=0 is_null=0 */
###   @3='2009:01:01' /* DATE meta=0 nullable=1 is_null=0 */
...
# at 400
#080828 15:03:08 server id 1  end_log_pos 442   Delete_rows: table id 17 flags: STMT_END_F

BINLOG '
fAS3SBMBAAAALAAAAJABAAAAABEAAAAAAAAABHRlc3QAAXQAAwMPCgIUAAQ=
fAS3SBkBAAAAKgAAALoBAAAQABEAAAAAAAEAA//4AQAAAARwZWFyIbIP
'/*!*/;
### DELETE FROM test.t
### WHERE
###   @1=1 /* INT meta=0 nullable=0 is_null=0 */
###   @2='pear' /* VARSTRING(20) meta=20 nullable=0 is_null=0 */
###   @3='2009:01:01' /* DATE meta=0 nullable=1 is_null=0 */

您可以告知 mysqlbinlog 使用 --base64-output=DECODE-ROWS 選項來隱藏列事件的 BINLOG 陳述式。這與 --base64-output=NEVER 類似，但如果找到列事件，則不會以錯誤退出。--base64-output=DECODE-ROWS 和 --verbose 的組合提供了一種僅將列事件視為 SQL 陳述式的便捷方式

$> mysqlbinlog -v --base64-output=DECODE-ROWS log_file
...
# at 218
#080828 15:03:08 server id 1  end_log_pos 258   Write_rows: table id 17 flags: STMT_END_F
### INSERT INTO test.t
### SET
###   @1=1
###   @2='apple'
###   @3=NULL
...
# at 302
#080828 15:03:08 server id 1  end_log_pos 356   Update_rows: table id 17 flags: STMT_END_F
### UPDATE test.t
### WHERE
###   @1=1
###   @2='apple'
###   @3=NULL
### SET
###   @1=1
###   @2='pear'
###   @3='2009:01:01'
...
# at 400
#080828 15:03:08 server id 1  end_log_pos 442   Delete_rows: table id 17 flags: STMT_END_F
### DELETE FROM test.t
### WHERE
###   @1=1
###   @2='pear'
###   @3='2009:01:01'

注意

如果您打算重新執行 mysqlbinlog 輸出，則不應隱藏 BINLOG 陳述式。

針對列事件，--verbose 產生的 SQL 陳述式比對應的 BINLOG 陳述式更具可讀性。但是，它們與產生事件的原始 SQL 陳述式不完全對應。以下限制適用

原始欄位名稱遺失，並由 @N 取代，其中 N 是欄位編號。
二進位記錄中沒有字元集資訊，這會影響字串欄位的顯示
- 對應的二進位和非二進位字串類型之間沒有區別（BINARY 和 CHAR、VARBINARY 和 VARCHAR、BLOB 和 TEXT）。輸出對固定長度字串使用 STRING 資料類型，對可變長度字串使用 VARSTRING。
- 對於多位元組字元集，二進位記錄中不存在每個字元的最大位元組數，因此字串類型的長度會以位元組而非字元顯示。例如，STRING(4) 用作來自以下任一欄位類型的值的資料類型
```
CHAR(4) CHARACTER SET latin1
CHAR(2) CHARACTER SET ucs2
```
- 由於類型為 UPDATE_ROWS_EVENT 的事件的儲存格式，UPDATE 陳述式會顯示 WHERE 子句在 SET 子句之前。

正確解譯列事件需要二進位記錄開頭的格式描述事件中的資訊。由於 mysqlbinlog 事先不知道記錄的其餘部分是否包含列事件，因此預設情況下，它會在輸出的初始部分使用 BINLOG 陳述式顯示格式描述事件。

如果已知二進位記錄不包含任何需要 BINLOG 陳述式的事件（也就是說，沒有列事件），則可以使用 --base64-output=NEVER 選項來防止寫入此標頭。

上一步首頁上一層下一步