Dataway 4.1.5 以上版本升级指南

背景

如果你是 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，程序没有升级，数据库先升级了

这种是正常的升级过程，不会引发任何问题。

新版本特性

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