MySQL数据库Inception工具学习与测试 笔记

mysql语句的审核，在业界都已经基本被认同了，实际上也是对mysql语句写法的统一化，标准化，而之前的人工审核，针对标准这个问题其实是很吃力的，标准越多，dba越累，开发也越累。 那么在这个都追求自动化运维的时代，审核也必须要跟上步伐，因此inception诞生了。而inception可以做的工作远不止是一个自动化审核工具，同时还具备执行，生成对影响数据的回滚语句（类似闪回的功能），这样一条龙服务的工具，将会给dba的工作带来翻天覆地的变化，dba从此就从繁重的审核、登上去执行，出错了很难回滚（如果提前没有备份的话）的被动局面解放了出来，突然发现，做dba原来可以这么轻松，工作可以不饱和了，那就有更多的*时间学习、进一步向自动化运维平台的实现等更智能化的方向去发展，是具有里程碑意义的。 

1.inception架构原理

inception是集审核、执行、回滚于一体的一个自动化运维系统。它是根据mysql代码修改过来的。

相对于应用程序（上层审核流程系统等）而言，它是一个服务器，在连接时需要指定

2.inception安装

2.1 环境配置

安装依赖项

yum install cmake ncurses-devel gcc gcc-c++ openssl-devel

移除bison较新的版本

yum remove bison –y

从 路径，下载 bison-2.6.1.tar.gz 指定版本。下载后，上传至服务器。

解压并安装bison

tar zxvf bison-2.6.1.tar.gz

cd bison-2.6.1

./configure && make && make install

2.2 下载安装inception

下载

 wget https://github.com/qunarcorp/inception/archive/master.zip

解压

unzip master.zip

cd inception-master

./inception_build.sh debug [xcode]

指定路径下创建inc.cnf

touch /data/inception/inc.cnf

初始化

/data/inception/inception-master/debug/mysql/bin/inception --defaults-file=/data/inception/inc.cnf &

（##inception 最佳启动方式是通过nohup后台启动

nohup /data/inception/inception-master/debug/mysql/bin/inception --defaults-file=/data/inception/inc.cnf &
） 

2.3 关闭inception

找到初始化后的inception

 关闭inception

kill -9 7927

 2.4 修改增加配置项

[inception]
general_log=1
general_log_file=inc.log
port=6669
socket=/tmp/inc.socket
character-set-client-handshake=0
character-set-server=utf8
inception_remote_system_password=备份库密码
inception_remote_system_user=备份库账号
inception_remote_backup_port=备份库实例端口
inception_remote_backup_host=备份库ip
inception_support_charset=utf8mb4,utf8,latin1
inception_enable_nullable=0
inception_check_primary_key=1
inception_check_column_comment=1
inception_check_table_comment=1
inception_osc_min_table_size=1
inception_osc_bin_dir=/data/temp
inception_osc_chunk_time=0.1
inception_ddl_support=1
inception_enable_blob_type=1
inception_check_column_default_value=1

（如果执行 ./inception_build.sh debug [xcode] 命令报错，可将inception-master目录删除，重新解压，然后用

./inception_build.sh build linux 替代。更多的安装知识，可参阅 ）

2.5 连接验证

通过mysql 客户端连接

执行 代码验证

 inception get variables;

 

2.6 inception的选项支持

参数名	是否需要参数	是否可选	功能描述
--host	是	否	需要操作的这部分语句块对应的数据库地址。指定方式可以是ip地址、机器名或dns域名等，只能唯一解析到这个机器即可。
--port	是	否	与上面的--host选项对应，指定机器名，必然要再指定一个mysql实例的端口。
--user	是	否	通过--user指定的用户名来连接需要操作sql语句的mysql实例。
--password	是	否	与上面的--user选项对应。
--sleep	是	是	这个参数用来指定在执行完每一条语句后，暂停多少毫秒，这样可以适当控制对线上数据库的冲击，特别是针对大量的写入操作， 单位是毫秒，最小值为0，也就是不暂停，最大值为100秒，也就是100000毫秒。如果设置的值超过了100000毫秒， inception会自动将其设置为100000毫秒。这个参数可以和其他参数一起设置，但是只有在--enable-execute为1的情况下，才起作用。
--enable-check	否	否	告诉inception当前要做什么操作，是审核还是执行，这个参数与下面的--enable-execute智能指定一个。enable-check就是要告诉inception， 当前的请求是要做审核操作，审核完成后就返回结果集。
--enable-execute	否	否	如果执行的选项是--enable-execute，则inception在执行前还会做一次实时的审核，这个审核和前面指定的--enable-check时的 审核是基本相同的，这是这次在审核完成后，还会继续进行。因为相同的语句在不同的时间审核可能会产生不同的审核结果（环境有可能变了）， 所以有必要再做一次审核。如果审核发现了错误（而不是警告），就不会被执行，此时会提前返回告知错误；如果审核发现的是警告， 并且没有指定--enable-ignore-warnings，则有警告也不会执行。
--enable-ignore-warnings	否	是	inception采取严格的分阶段处理方式，先对所有的语句进行审核，审核完成之后，会执行所有的语句，之后再会执行所有语句的备份操作。 在三个阶段的过渡过程中，如果审核有问题则不会继续进行，此时如果人为确定想要跳过这些警告，则可以选择这个参数， 告诉inception跳过这个警告的检查，继续执行。
--enable-force	否	是	批量导入时，有可能会报主键冲突的问题，而dba可以确定的是，出现主键冲突不是问题，可以继续执行，那么此时可以通过选项 --enable-force告诉inception,在执行过程中碰到一个错误时，可以先保存错误信息并继续下一条语句。此参数需谨慎使用。
--enable-remote-back	否	是	inception支持备份并生成对应的回滚语句，这是默认的，但当有些影响行数很多且明确不需要回滚的时候，为了提高执行效率， 可以指定在执行时不做备份，指定方式是通过disable来禁用它，即disable-remote-backup。
--enable-split	否	是	这个参数用来拆分要执行的语句块。如果在语句块中存在对同一个表的ddl操作和dml操作，那么在分析binlog来生成回滚语句时， 由于表结构已经发生改变，会导致inception没有办法处理，所以使用这个参数将这些语句分成多批，然后再分别执行。这是在执行前 必须要做的一个操作，不然可能会产生不可预知的错误。当然在执行前的最后一次审核中，如果检查到这样的混用情况， 则会返回报错，而不是警告。
--enable-query-print	否	是	这个参数用来打印sql语句在被inception分析之后的执行树结构，已json的形式提供，目的是为了可以在inception的基础上， 对已经结构化的（json）语句再次分析，可以对inception内置支持的规则进行扩展，做个性化定制，比如使用到哪些列、 哪些语句类型等信息。

2.7 inception结构集导读

返回列	详细描述
id	用来表示结果集中记录序号的，也就是被审核的语句在语句块中的序号，按位置排序，计数从1开始。
stage	显示当前语句已经进行到哪一步了，包括四个值：checked、executed、rerun和none。checked表示这个语句只做审核，而没有再进行下一步操作；executed表示已经执行过， 如果执行失败，也是用这个状态表示，rerun表示的是，对于影响上下文的语句，已经执行成功了，但是为了与executed区分，用rerun表示，主要是因为在执行过程中，如果某一条语句 执行失败了，则上层可能需要将没有执行的语句提取出来，再次执行，那么影响上下文的语句就是需要加上的，所以用rerun来表示。inception目前支持两种影响上下文的语句，分别是 set names charset 语句和use database语句。none表示没有做过任何处理，有可能前面有语法错误直接提前返回。
errlevel	总共有三个值，分别是0、1、2。如果为0，则说明当前语句审核没有任何问题；如果为1，则说明当前语句审核时发现有些写法不符合inception定义的内置规则，属于警告；如果值为2，则说明 当前语句审核时，发现了严重错误，无论如何都不能通过的。
stagestatus	该列用来描述当前语句的阶段结果，与列stage对应。如果是审核阶段，并且完成，则返回audit completed。如果是执行阶段，并且执行成功则返回execute successfully，否则返回execute failed。如果是备份阶段，并且备份成功，则在执行描述信息后面追加backup successfully，否则追加backup failed。
errormessage	用来表示出错的错误信息，这里包括一条语句中的所有错误信息，用换行符分隔，但有时候如果某一个错误导致不能继续分析了，比如表不存在等问题，在这种情况下，如果语句还有其他错误， 就不能被审核出来了。如果当前语句没有任何错误，则这个列值为none。对于执行及备份操作，因为对于一条语句，这样的错误只会有一次，那么执行错误会在执行后面追加：“execute：具体 的执行错误原因”，如果是备份出错，则在后面追加“backup：具体的错误原因”。在执行时，有时候还会出现warning。
sql	用来表示当前检查的是那条sql语句，这一列存储的值就是这条sql语句的文本内容。
affected_rows	审核时，用来表示当前语句预计影响的行数，这个行数一般是通过explain来获取的。在执行时，该列输出的是执行时真实影响的行数。
sequence	该列与inception备份功能有关，其实就是与$_$inception_backup_information$_$表中的列opid_time一一对应，这就为自动化运维平台针对某一条语句做回滚操作找到了入口。
backup_dbname	该列表示的是当前语句产生的备份信息，存储在备份服务器的那个数据库中。如果是不需要备份的语句，则返回字符串none。
excute_time	该列表示当前语句的执行时间，单位是秒，精确到小数点后两位。列类型是字符串。如果只是审核而不执行，则该列返回的值为0.
sqlsha1	这一列用来存储当前这条语句的一个hash值，用来标识这个语句是否会使用osc功能，如果返回信息中有值，则表示这条语句在执行时会使用osc。

 

3.inception 备份功能

inception在做dml操作时，具有备份功能。它会将所有当前语句修改的行对应生成回滚语句并备份下来，同时也会将所有操作的任务备份下来，一起存储到一个指定的库中。

3.1 配置项中关于备份主要有4个参数

参数	说明
inception_remote_backup_host	指定远程备份mysql实例的地址。
inception_remote_backup_port	指定远程备份mysql实例的端口。
inception_remote_system_user	备份时，连接备份mysql实例时所需的用户名，这个用户需要有相应的权限，一般包括create、insert和select权限。
inception_remote_system_password	备份时，连接备份库时所需要的用户对于的密码。

3.2 备份数据库命名规则

因为线上机器有很多，而备份机器只有一台，所以为了防止在备份数据库实例中存在库名冲突的问题，备份机器的库名是将线上机器ip地址的点换成下划线，再加上端口号及库名。

例如：

169_169_167_167_3306_testdb.

3.3 备份库上的表

主要有两类，一种针对线上每一个表生产一个备份表，即与线上的表是一一对应的，表名相同，但是表结构不一样。备份表主要用来存储所有对表修改的回滚语句。

主要有以下3列：

列名	说明
id	标识列
rollback_statement	当某一行被修改后，生成的对应的回滚语句。因为binlog必须为row模式，所以，不管是什么语句，产生的回滚语句都是针对被修改的行记录的。 如果一条语句的执行，影响了多行，那么这里就会有多条回滚语句。
opid_time	执行sql语句时获取的一个序列号。序列号由三部分组成：timestamp（int值，是语句执行的时间点）、线上服务器执行时所产生的thread_id及 当前这条语句在所有被执行语句块中的一个序号。序列号在指定的备库中是唯一的。针对同一条语句影响多行的情况、在产生的多行回滚语句中， 该列的值是相同的。

还有一类表，其实这个表每个库中只有一个，$_$inception_backup_information$_$。该表主要用来记录所有对当前库的操作，它是为该库中所有表服务的，对线上这个库的所有的表的操作，都会被存储在这里面。

 

参数	说明
opid_time	该列与上面备份表中的列opid_time是一一对应的，因为这个表中的每一行对应的是在线上执行的实际的一条sql语句。 opid_time从各个备份表中查找这条语句对应的回滚语句，是一对多的关系。
start_binlog_file	表示执行这条语句前binlog所在的位置的文件名。这个值是通过 show master status 获取的，在数据库并发比较高的情况下， 这个值不一定准确。这个值只能是这条语句产生binlog前面的某个位置。同理。下面三个位置信息也是一样。
start_binlog_pos	该列与上面的列对应，表示的是上面指定文件的位置信息。
end_binlog_file	该列表示的是执行当前语句之后，binlog所在的文件名。
end_binlog_pos	该列与上面的列对应，表示执行完成后，binlog在文件end_binlog_file中的偏移位置。
sql_statement	该列存储的是当前这个被执行的sql语句。
host	表示在线上的哪个数据库实例上执行了该语句。
dbname	表示执行当前语句时所处的环境变量，指的是数据库名。
tablename	表示当前语句影响的表的表名，通过这个名字对应到备份表名。
port	与host对应，表示执行时数据库的端口号。
time	表示当前语句的执行时间
type	表示操作类型，现在只支持insert、update、ddelete、createdb、createtable、altertable、droptable等类型。

 

3.4线上库表结构与备份库表结构的对应关系如下图：

 3.5 通过python脚本验证

测试环境

类别	serverip	port
线上数据库	xxx.xxx.xxx.9	3306
inception	xxx.xxx.xxx.8	6669
备份数据库	xxx.xxx.xxx.9	3307

 测试python脚本

#!/usr/bin/python
#-*- coding:utf-8 -*-
import mysqldb

sql='''/*--user=数据库账号;--password=相应密码;--host=xxx.xxx.xxx.9;--execute=1;--port=3306;*/\
    inception_magic_start;\
    use dbtest;\
    create table table_test(id int comment 'test' primary key) engine=innodb default charset=utf8mb4 comment '测试';\
    inception_magic_commit;'''
try:
       conn=mysqldb.connect(host='xxx.xxx.xxx.8',user='',passwd='',db='',port=6669)
       cur=conn.cursor()
       ret=cur.execute(sql)
       result=cur.fetchall()
       num_fields = len(cur.description)
       field_names = [i[0] for i in cur.description]
       print field_names
       for row in result:
                print row[0], "|",row[1],"|",row[2],"|",row[3],"|",row[4],"|",row[5],"|",row[6],"|",row[7],"|",row[8],"|",row[9],"|",row[10]
       cur.close()
       conn.close()
except mysqldb.error as e:
       print "mysql error %d: %s" % (e.args[0], e.args[1])

执行结果如下：

去备份库上查看，备份情况如下：

3.6 备份所需的条件

如果在测试的过程中，发现没有实现备份，可以从以下几个方面去检查

（1）线上服务器必须要打开binlog，在启动时需要设置参数log_bin、log_bin_index等关于binlog的参数。不然不会备份及生成回滚语句，因为inception的生成回滚语句是通过解析binlog来做的。

 

（2）参数必须binlog_format必须设置为mixed或者row模式。如果是statement模式，则不做备份及回滚语句的生成。可通过语句set global binlog_format=row来设置。

（3）将binlog_row_image设置为full ，该配置项默认为 full ，但是如果为了减少binlog的size改成minimal的话，则inception无法生成回滚语句。

（4）参数server_id必须设置为非0非1，通过语句set global server_id=server_id;来设置，不然在备份时报错。因为在获取binlog时，需要通过server_id在主库上注册inception。

（5）被修改表需要有主键：执行时，被影响的表如果没有主键的话，就不会做备份了。这样更简单并且备份时间及数据都会少一点，不然回滚语句的where条件就会将所有列写进去，这样会影响性能且没有太大意义，所以在where条件中，只需要主键即可。

（6）备份相关的四个参数需要设置好，并且对应的用户在备份数据库实例中有足够的权限。

3.7 在进行验证时可能遇到的错误。

1执行 python验证，报错信息。

importerror: no module named mysqldb

解决方案：

yum install mysql-python

 2.有时候执行python脚本报错：invalid source infomation。

这时候需要去检查inception连接数据库的参数配置。

 4.inception常见关于审核规范的变量参数

5.inception统计功能

其数据存储在备份实例上的inception数据库上statistic表中，此库自动生成。

主要字段的说明如下：

列名	字段描述
deleting	包括普通的删除操作及多表删除操作。
inserting	包括单行插入、多行插入及查询插入。
updating	包括普通单表更新及多表的更新。
renaming	指的是alter table语句中的rename操作。
createindex	指的是alter table语句中的add index操作。
dropindex	指的是alter table语句中的drop index操作。
alteroption	指的是alter table语句中的修改表属性的操作，比如存储引擎、自增值及字符集中操作。
alterconvert	指的是alter table语句中修改表字符集的操作。

 

 

-----主要内容参考梳理于网络知识和《mysql运维内参》，此短文仅为学习笔记，在此原创作者感谢！