Oracle 19c给我的启示:RESTful API

这是学习笔记的第 2113 篇文章

最近Oracle发布了19c,而且随着Openworld的到来，官网也提前做了更新，打开Oracle官网，让我一脸懵逼，鼠标不知道该往哪儿点。

整个页面是这样的风格，也没有了原本的导航等。

认真看了下标题介绍，那我就选择一个和我贴近的吧，就点击了Infrastructure,按照这个定义，现在已然是2.0时代了。

不过随着这些链接点进去，看到了一系列的关于自治数据库的介绍和说明，其实我是想找一下19c的软件下载目录，看看最新版有哪些更新，尝尝鲜。

还好，总算找到了这个导航入口，想了想也是，毕竟和云比起来，软件下载安装的优先级确实没有那么高了。

看到这个界面，让我开始有一些踏实。

19c带给了哪些新鲜的特性呢，首先吸引到我的就是关于API的部分，当然你如果看到Books的推荐足够仔细，会发现第一个文档是Java开发者的。

所以我们接下来不讲关于19c的数据库功能相关的特性，而是着重在API方向上。

潜台词就是，19c已经大踏步开始在开发方向铺展开来了，如果我们还在传统运维上面，拉开的差距就实在太大了。

在开始之前，我们可以试想一下：假设你是Oracle的首席应用架构师，让你来设计相关的API体系，你该如何设计？

带着这个问题来纵览整个API的设计，会发现这样一个体系设计，有基础的数据字典部分，环境部署和查看，补丁和升级，通用功能（比如查看表空间，段，datapump任务等），监控（会话监控，锁监控等），性能（SQL性能），PDB的生命周期管理（创建，修改，删除PDB等）。

比如数据字典的部分，我们选择表相关的API,右侧的部分是集成了swagger,

对于参数的输入输出都有详细的定义，包括整个API的整体逻辑（这里可以看到是从dba_tables里面提取数据）。

到了这里我们其实会发现没有想象的复杂，因为这些基础信息我们基本都掌握了，所以API开发对于熟悉系统，业务层面的同学来说就是纸老虎。

可以想象很多同学希望做自动化相关的工作，势必会用到运维开发层面的API,而在以往我们需要自己封装API服务。

而现在是一站式打包服务。

整个API的设计主要是基于如下的方法，相比于标准的REST方法，多了PATCH方法，其他的增删改查分别对应（POST,DELETE,PUT,GET）

如下是API相关的返回编码。

一种很不规范的方式就是API设计中要么没有返回码，要不无论对错返回码都为200.

至于API的调用，这里给出的例子是基于cURL，如果需要调用，基本可以实现命令行级别的调用模式。

curl -v -i -H "Content-Type: application/json"http:
//xxxxx.com/database/objects/tables/{owner},{table_name}

当然这里还是推荐使用Postman这样的工具来进行调试，更加方便快捷。

这个体系设计整体是很不错的，很清晰，而且还提供了基于JSON的swagger配置文件，感兴趣的同学可以做下对接调试。

个人新书 《MySQL DBA工作笔记》

个人公众号：jianrong-notes