名称 | 描述 |
DDL | DDL是英文data definition language的缩写，意思是：数据定义语言，主要的命令有alter、create、drop、truncate，ddl主要用在定义或者改变表的结构。 |
DML | DML是英文data manipulation language的缩写，意思是：数据操纵语言，主要的命令有select、update、delete、insert，dml主要用来操作数据库中的数据。 |
1、制作SQL脚本
1.1、从数据库导出SQL脚本
DDL一般包含：增加单据使用到的表、索引新增语句，扩展单据增加的字段添加语句
DML包括菜单、编码规则、系统参数
菜单表：t_bas_homepage_menu
编码规则： t_cr_coderule t_cr_coderule_l t_cr_coderuleentry
系统参数：t_bas_sysparaconsole t_bas_sysparameter
可根据开发使用的情况选择性导出自己的数据制作sql脚本。
例如：
有扩展单据并增加字段，那需要导出增加字段的DDL；
有增加新单据的，需要导出新单据相关的表DDL；
有在首页新增自己的应用菜单的，则需要从菜单表中导出该应用对应的insert SQL；
有新建了编码规则的，则需要导出自己新建的编码规则insert sql；
有使用到系统参数，则需要导出自己新增的那条系统参数insert sql；
1.1.1、导出DDL
1.1.2、导出DML
1.2、修改SQL脚本为星辰可执行脚本
sql语句必须可重复执行，每句sql结束必须加【;】
1.2.1、修改DML SQL
将导出的sql做成可重复执行sql，插入前先删除。
例如：
导出来的Insert类sql：
| INSERT INTO kd_1620359504142044323.t_bas_homepage_menu (fid, fseq, fnumber, fvisible, fpermission, fvectorvalue, fappid, fisv, fname, fappname, fsourceappid, fforkref) VALUES(1221608250227602432, 85, 'wfyx_001', '1', ' ', 'kdfont kdfont-tongyongzijin', '1LAJXX6CV9TV', ' ', '工资管理', '工资管理', ' ', '0'); |
改造后：
| DELETE FROM t_bas_homepage_menu where fid=1221608250227602432;INSERT INTO t_bas_homepage_menu (fid, fseq, fnumber, fvisible, fpermission, fvectorvalue, fappid, fisv, fname, fappname, fsourceappid, fforkref) VALUES(1221608250227602432, 85, 'wfyx_001', '1', ' ', 'kdfont kdfont-tongyongzijin', '1LAJXX6CV9TV', ' ', '工资管理', '工资管理', ' ', '0'); |
1.2.2、修改DDL SQL
在导出的sql中， Sql语句添加固定头：/#dialect-simple#/ ,表名前添加固定#SCHEMANAME#.表名，字段名必须小写
例如：
导出来的建表sql：
| CREATE TABLE wfyx_shangpingongxu (fid int8 NOT NULL,fentryid int8 NOT NULL,fseq int4 NOT NULL DEFAULT 0,fbasedatafield int8 NOT NULL DEFAULT 0,fpricefield numeric(23,10) NOT NULL DEFAULT 0,CONSTRAINT pk_yx_shangpingongxu PRIMARY KEY (fentryid)); |
改造后：
| /#dialect-simple#/CREATE TABLE IF NOT EXISTS #SCHEMANAME#.wfyx_shangpingongxu (fid int8 NOT NULL,fentryid int8 NOT NULL,fseq int4 NOT NULL DEFAULT 0,fbasedatafield int8 NOT NULL DEFAULT 0,fpricefield numeric(23,10) NOT NULL DEFAULT 0,CONSTRAINT pk_yx_shangpingongxu PRIMARY KEY (fentryid)); |
导出来的建索引sql:
| CREATE INDEX idx_yx_shangpingongxu_fk ON kd_wfyx_shangpingongxu USING btree (fid); |
改造后：
| /#dialect-simple#/CREATE INDEX IF NOT EXISTS idx_yx_shangpingongxu_fk ON #SCHEMANAME#.wfyx_shangpingongxu USING btree (fid); |
导出来的增加字段sql:
| ALTER TABLE kd_1618065434286742045.t_sal_invbillentry ADD wfyx_fileda citext NOT NULL DEFAULT ' '::citext; |
改造后
| /#dialect-simple#/ALTER TABLE IF EXISTS ONLY #SCHEMANAME#.t_sal_invbillentry ADD COLUMN IF NOT EXISTS wfyx_fileda citext NOT NULL DEFAULT ' '::citext; |
2、保存SQL脚本
脚本文件编码为UTF-8
文件命名格式为：#{伙伴isv标识}_${版本号}_${应用编码}_${脚本说明关键字}_${SQLTYPE后缀}.sql
例如：isvnumber _1.0 _sal_createorder_table.sql
伙伴isv标识：扩展或者新建应用时，应用编码自动生成的前缀字符串，例如 销售管理 sal 扩展后编码为 xxxx_sal_fork_0001,则xxxx就是isv标识
脚本说明关键字：描述脚本的作用，例如是销售订单的脚本 则可描述为 salbill
DDL脚本（包括表创建、字段修改、索引增删等脚本）的后缀: _table.sql
例如：isvnumber _1.0 _sal_outbound_table.sql
DML脚本（包括与插入的菜单、编码规则等脚本）的后缀: _data.sql
例如：isvnumber _1.0 _sal_outbound_data.sql
2.1、拉下git xcmaster分支
查看git仓库地址:
将xcmaster分支拉到本地、文件结构大概如下:
若是需增加要dbschema sql或者 preinsdata sql则增加dbschema、preinsdata这两个文件夹，凡是增加了文件则必须增加 {应用编码}.xml 文件，如上图中的 bgp_sal_fork.xml，xml文件名称必须问应用编码，否则发布无效。
2.2、DML脚本放到${应用}/preinsdata文件夹下
2.3、DDL脚本放到${应用}/dbschema文件夹下
2.4、把脚本添加到配置文件中
2.5、新增sql
注意：若是sql发布成功，则不语允许修改已经发布成功的sql文件。
新增的sql应该新增加一个sql文件，将新的sql放入文件中并将文件路径和名称配置到xml文件中。
Sql发布原理：
1、发布时解析xml中配置的文件，按xml配置顺序执行，所以创建表的文件需要保证放在修改该表sql文件的前面。
2、每个sql文件发布成功后，系统记录sql文件名，发布失败则不记录。
下次发布更新，系统检查该sql文件名是否在系统中，存在则跳过不执行，不存在则执行文件中的sql。
3、提交SQL脚本
将修改完成的脚本提交到git 仓库xcmaster分支
推荐阅读