Mysql 数据库脚本更改规范

1、SQL文件每个月形成一个文件,以日期开头,便于发版执行(如果文件不存在创建一个,文件名格式为:201805.sql)。

2、SQL文件在做数据结构修改前,必须在开头单独起一行备注此次修改做的业务操作和日期。

例如: #=========2018/05/20 添加产品优惠券日期字段,jira #5247 ============。

3、SQL文件在做数据结构操作前,必须判断是否已经存在相应(字段,表,索引)等是否存在,然后再操作,保证幂等性。

4、数据结构更改需单独提交PR修改SQL文件(此PR只包含SQL文件修改),并注明关联的Jira issue,PR内容需注明SQL更改的内容,由指定人员审核通过后方能合并。

相关示例:


  1. /*========== 创建操作日志表,操作日志表用来处理“添加修改数据”这种操作来保证幂等性使用======================*/
  2. create table if not exists sqloperate_log
  3. (
  4. Id varchar(50) not null
  5. primary key,
  6. Descriptions varchar(100) null,
  7. DateTime timestamp default CURRENT_TIMESTAMP not null,
  8. constraint uniq_Id
  9. unique (Id)
  10. );
  11. /*==============示例,添加表=====================*/
  12. create table if not exists sqloperate_log
  13. (
  14. Id varchar(50) not null
  15. );
  16. /*==============示例,添加列(在需要新增列的时候,使用过如下方式进行新增)=====================*/
  17. drop procedure if exists schema_change;
  18. delimiter ';;'
  19. create procedure schema_change() begin
  20. /*add first column for sqloperate_log table */
  21. if not exists (select * from information_schema.columns where table_name = 'sqloperate_log' and column_name = 'test') then
  22. /*this is your sql scripts*/
  23. alter table sqloperate_log add column `test` varchar(255) NULL;
  24. end if;
  25. if not exists (select * from information_schema.columns where table_name = 'sqloperate_log' and column_name = 'test2') then
  26. alter table sqloperate_log add column `test2` varchar(255) NULL;
  27. end if;
  28. end;;
  29. delimiter ';'
  30. call schema_change();
  31. drop procedure if exists schema_change;
  32. /*==============示例,添加索引(如果需要对表中的列添加索引,使用下面的示例脚本)=====================*/
  33. drop procedure if exists schema_change;
  34. delimiter ';;'
  35. create procedure schema_change() begin
  36. if not exists (select * from information_schema.statistics where table_name = 'sqloperate_log' and index_name = 'descriptions_index') then
  37. /*this is your sql scripts*/
  38. create index descriptions_index on sqloperate_log(Descriptions);
  39. end if;
  40. end;;
  41. delimiter ';'
  42. call schema_change();
  43. drop procedure if exists schema_change;
  44. /*==============示例,添加修改数据(在需要进行一些脚本更改数据或者初始化数据的时候,使用下面的脚本示例。其中title为当前的操作的描述)=====================*/
  45. drop procedure if exists sqldata_change;
  46. delimiter ';;'
  47. create procedure sqldata_change() begin
  48. /*this is your sql scripts descriptions*/
  49. set @title = '向表appinfo中更新数据-示例';
  50. if not exists (select * from sqloperate_log where Id = sha1(@title)) then
  51. /*this is your sql scripts*/
  52. insert into appinfo(PhoneName,CreateTime) values('test phone name',now());
  53. /*add operate logs, don't delete*/
  54. insert into sqloperate_log(Id,Descriptions) values(sha1(@title),@title);
  55. end if;
  56. end;;
  57. delimiter ';'
  58. call sqldata_change();
  59. drop procedure if exists sqldata_change;
  60. /*============清理示例数据==========================*/
  61. /* alter table sqloperate_log drop column `test`;
  62. alter table sqloperate_log drop column `test2`;
  63. drop index `descriptions_index` on sqloperate_log;
  64. truncate table sqloperate_log;
  65. drop table sqloperate_log;
  66. */

Mysql 数据库脚本更改规范

相关推荐