MySQL客戶端顯示binary字符代碼改造

作者：指北君 2022-08-01 08:04:58

MySQL客戶端字符顯示依賴charset_for_protocol()函數(shù)，可以根據(jù)自己的需求修改該函數(shù)的顯示方式，方便自己的使用。

一、客戶端顯示字符背景介紹

MySQL最新版本有一個(gè)新功能，在使用客戶端的時(shí)候，最后加上--skip-binary-as-hex選項(xiàng)可以直接顯示二進(jìn)制值對應(yīng)的字符串，不加該選項(xiàng)就可以按照原來的設(shè)置格式顯示。先來看一下以下的varbaniry的顯示例子。

#建表：
create table varb(id int,bb varbinary(1000));
insert into varb values(1,'abcd');
#登錄：
mysql -h 127.0.0.1 -P3307 -uroot  --skip-binary-as-hex
mysql> select * from varb;
+------+------+
| id   | bb   |
+------+------+
|    1 | abcd |
+------+------+
1 row in set (0.00 sec)

如果不加--skip-binary-as-hex選項(xiàng)的顯示如下：

mysql -h 127.0.0.1 -P3307 -uroot
mysql> select * from varb;
+------+------------+
| id   | bb         |
+------+------------+
|    1 | 0x61626364 |
+------+------------+
1 row in set (0.01 sec)

這個(gè)功能對于用慣了舊版本的同學(xué)們有的會(huì)覺得不方便，今天這里動(dòng)手改造一下都顯示成字符格式而不用通過--skip-binary-as-hex選項(xiàng)設(shè)置。

二、代碼跟蹤

沿用上面的表查詢一下哪段代碼決定字符的顯示格式，代碼解析如下：

輸入該命令后找到相關(guān)字符顯示的代碼：

mysql> select * from varb;

class Item_field的成員函數(shù)如下：

const CHARSET_INFO *charset_for_protocol(void) override {
    return field->charset_for_protocol(); 
    #表字段的字符顯示取決于field的字符設(shè)置。
  }

繼續(xù)找到class Field的成員函數(shù)如下：

const CHARSET_INFO *charset_for_protocol() const {
    return binary() ? &my_charset_bin : charset(); 
    #field的字符設(shè)置取決于是否binary類型。
  }

輸入以上命令GDB跟蹤一下代碼堆棧：

Thread 47 "mysqld" hit Breakpoint 3, Item_field::charset_for_protocol (this=0x7fff340bc1f0)
    at /home/greatdb/sql/item.h:4373
4373   const CHARSET_INFO *charset_for_protocol(void) override {
(gdb) bt
#0  Item_field::charset_for_protocol (this=0x7fff340bc1f0)
    at /home/greatdb/sql/item.h:4373#1  0x0000555558e60ca8 in THD::send_result_metadata (this=0x7fff34000c00, list=..., flags=5)
    at /home/greatdb/sql/sql_class.cc:2831
#2  0x0000555558d9fe59 in Query_result_send::send_result_set_metadata (this=0x7fff3429cfa0, 
    thd=0x7fff34000c00, list=..., flags=5)
    at /home/greatdb/sql/query_result.cc:74
#3  0x0000555559093d1b in Query_expression::ExecuteIteratorQuery (this=0x7fff3429ae08, 
    thd=0x7fff34000c00) at /home/greatdb/sql/sql_union.cc:1169
#4  0x0000555559094452 in Query_expression::execute (this=0x7fff3429ae08, thd=0x7fff34000c00)
    at /home/greatdb/sql/sql_union.cc:1305
#5  0x0000555558fd4b18 in Sql_cmd_dml::execute_inner (this=0x7fff3429cf68, thd=0x7fff34000c00)
    at /home/greatdb/sql/sql_select.cc:810
#6  0x0000555558fd3f24 in Sql_cmd_dml::execute (this=0x7fff3429cf68, thd=0x7fff34000c00)
    at /home/greatdb/sql/sql_select.cc:578
#7  0x0000555558f4ac03 in mysql_execute_command (thd=0x7fff34000c00, first_level=true)
    at /home/greatdb/sql/sql_parse.cc:4784
#8  0x0000555558f4cd80 in dispatch_sql_command (thd=0x7fff34000c00, parser_state=0x7fffe82ab990, 
    update_userstat=false) at /home/greatdb/sql/sql_parse.cc:5384
#9  0x0000555558f42257 in dispatch_command (thd=0x7fff34000c00, com_data=0x7fffe82acb70, 
    command=COM_QUERY) at /home/greatdb/sql/sql_parse.cc:1992
#10 0x0000555558f405c7 in do_command (thd=0x7fff34000c00)
    at /home/greatdb/sql/sql_parse.cc:1440
#11 0x0000555559163f7e in handle_connection (arg=0x55556091c920)
    at /home/greatdb/sql/conn_handler/connection_handler_per_thread.cc:307
#12 0x000055555ad85edf in pfs_spawn_thread (arg=0x5555607808c0)
    at /home/greatdb/storage/perfschema/pfs.cc:2899
#13 0x00007ffff77a6609 in start_thread (arg=<optimized out>) at pthread_create.c:477
#14 0x00007ffff76cb163 in clone () at ../sysdeps/unix/sysv/linux/x86_64/clone.S:95

對于非表字段的內(nèi)容顯示格式取決于什么呢？繼續(xù)找：

mysql> select 'abcd' from varb;

輸入該命令后找到相關(guān)字符顯示的代碼,對于非表字段的內(nèi)容取決于結(jié)果是否STRING_RESULT，'abcd'屬于Item_string，result_type()=STRING_RESULT，所以顯示字符格式是collation.collation。

class Item的成員函數(shù)如下：

virtual const CHARSET_INFO *charset_for_protocol() {
    return result_type() == STRING_RESULT ? collation.collation
                                          : &my_charset_bin; 
  }

三、代碼改造

針對上面介紹的第一種情況改造代碼如下：

mysql> select * from varb;
#class Field的成員函數(shù)改成如下，其中system_charset_info=my_charset_utf8_general_ci：
  const CHARSET_INFO *charset_for_protocol() const {
    return system_charset_info;
  }

登錄客戶端，可以看到結(jié)果已經(jīng)自動(dòng)顯示成字符格式而不是剛才看到的baniry格式。

mysql -h 127.0.0.1 -P3307 -uroot
mysql> select * from varb;
+------+------+
| id   | bb   |
+------+------+
|    1 | abcd |
+------+------+
1 row in set (0.00 sec)

四、總結(jié)

MySQL客戶端字符顯示依賴charset_for_protocol()函數(shù)，可以根據(jù)自己的需求修改該函數(shù)的顯示方式，方便自己的使用。如果未來新定義Item或者Field記得也要相應(yīng)修改該函數(shù)來正確顯示數(shù)據(jù)。

責(zé)任編輯：武曉燕來源： Java技術(shù)指北

MySQL 客戶端字符