背景
如果你是 4.1.3 或者 4.1.4 版本的 Dataway,那么在开启 4.1.5 以后版本之旅之前先要读一下这片 Blog。
4.1.5 版本开始,interface_info、interface_release 两张表各自增加了一个字段。用来保存接口选项参数的。下面是对应的升级脚本:
Mysql升级脚本:
alter table interface_info add api_option mediumtext null comment '扩展配置信息' after api_sample;
alter table interface_release add pub_option mediumtext null comment '扩展配置信息' after pub_sample;
Oracle升级脚本:
alter table interface_info add api_option clob /
comment on column interface_info.api_option is '扩展配置信息' /
alter table interface_release add pub_option clob /
comment on column interface_release.pub_option is '扩展配置信息' /
升级过程
1. 在准备升级之前,首先要先把数据库表进行升级。 这时候运行的程序中可以先不用更新依赖。 4.1.3 和 4.1.4 版本中对于新增列并不会主动处理,而且新的列是允许为空的。
2. 紧接着升级程序的依赖到最新版本 4.1.6 。然后部署应用就好了。
可能会遇到的问题
分为两种情况来讨论:
1,数据库没有升级,程序先升级了
如果程序先升级了,由于option字段并没有存在。相关 4.1.5 和 4.1.6 的新特性都不会生效,已经发布的接口不会受到任何影响。
但是由于数据库没有对应的字段,程序先升级了。在进行接口保存、发布操作时候会遇到错误如下图。这个时候只需要再把数据库表升级掉就一切正常了。
2,程序没有升级,数据库先升级了
这种是正常的升级过程,不会引发任何问题。
2,版本升级跨度太大怎么办
1. 先参考这片文章升级到 4.1.5 ,然后在继续升级。通常遇到不兼容升级官方会有对应到 Blog 文章发布出来。
2. 重新引入 Dataway 并重新配置接口(暴力,但是干脆利索)
新版本特性
4.1.5 除了 Bug Fix 之外,最大的看点就是。返回结构完全自定义。
- Dataway 官方手册:https://www.hasor.net/web/dataway/about.html
- Dataway 在 OSC 上的项目地址,欢迎收藏:https://www.oschina.net/p/dataway
- DataQL 手册地址:https://www.hasor.net/web/dataql/what_is_dataql.html
- Hasor 项目的首页:https://www.hasor.net/web/index.html