Dataphin数据服务系列之--API 配置、管理和消费 阿里巴巴postgresql配置管理mongodb
程序员文章站
2022-03-21 11:42:49
...
作者:张尘初
![image](https://yqfile.alicdn.com/48baa62eb7fad1b625d397ea23581b64b0a3ebf7.png)
研发小哥哥还在为公司里大量 API 只上不下,不可查不可用, 想找的 API 找不到而苦恼吗?业务方小姐姐还在为 API 开发时间长,业务相应不及时而抱怨吐槽吗? 铛铛铛,Dataphin 数据服务 -- API 配置管理,闪亮登场!助力研发小哥哥五分钟搞定 API,提升业务响应速度,同时大大提升 API 复用能力!
**Dataphin 数据服务**
Dataphin 是阿里巴巴数据中台(OneData - OneModel、OneID、OneService)方法论的产品载体。Dataphin 数据服务是其中 OneService 部分的载体,是 Dataphin 产品的组成部分,是数据中台的价值出口。连接数据和业务,主要解决数据最后一公里使用的问题。包括 API 管理、主题式即席查询等能力。本次主要为大家带来数据服务中 API 配置、管理、和使用的相关产品功能介绍~
**API 配置 - 五分钟生成 API**
配置生成主要有三大步骤:服务单元配置->API 配置->API 测试
**服务单元配置**
服务单元是数据服务产品中的概念,可以理解为一个逻辑表,可以是下挂单个物理表或下挂多个物理表,也可以是 Dataphin 逻辑表。配置人员根据需要选择字段,并进行字段的相关信息(字段名称和字段类型)配置。下图是单物理表服务单元截图。API 基于服务单元生成。服务单元跟 API 是一对多的关系。
目前数据源类型已支持:MySQL、ElasticSearch、AnalyticDB、HBase,8 月 30 即将支持 PostgreSQL、Oracle、MongoDB。更多数据源持续接入中。
![image](https://yqfile.alicdn.com/041a6ef0526679a3c0fdc57944374584ce47d90a.png)
**API 配置**
基于上文中配置好的服务单元,通过简单的 SQL 脚本,配置 API 的请求参数和返回参数,选择调用方法(支持 GET 和 LIST 两种调用方法),选择 API 更新频率配置,即可快速生成 API。配置界面如下图:
![image](https://yqfile.alicdn.com/746282eb1b4120bb7c02ef95cecb527943019e24.png)
**API 测试 **
API 配置完成后,可以快速进行测试,通过配置请求参数,可以测试 API 的响应时间,以及返回内容详情,等。如下图:
![image](https://yqfile.alicdn.com/7b2d304124f41cc38fc128f5096b317f44e2d3fc.png)
**API 管理 - 可上可下可维护**
**\- API 上下线**
在 API 管理界面,可以清晰的看到 API 的使用情况,被调用次数,发布更新时间,等。同时可以对新增 API 发布上线,也可以对已经存在的 API 下线和删除。让 API 的管理变得简单。
![image](https://yqfile.alicdn.com/54f910aac3a629d12df1b178c2b67dfbbd57351c.png)
**\- API 监控运维**
API 生成后,可以进行 API 的监控和运维,包括 授权应用数、平均响应时长、调用次数、错误率、offline 百分比等指标的监控。
![image](https://yqfile.alicdn.com/bd146eb71c360438eed4897377d8fec8e7778d59.png)
**API 消费 - 好找好拿**
API 申请使用主要有三大步骤:API 服务市场查找->API申请和调试->API 使用
**\- API 服务市场查找**
API 市场里包含了企业内所有已经发布的 API 信息,支持按分组查看,支持按 API 名称查找。可以在 API 市场里查看具体 API 的文档详情,也可以直接申请使用 API。
![image](https://yqfile.alicdn.com/675609a38aced99042c4d4b416a7517c9ffbe172.png)
**\- API 申请调试**
```
在上文 API 市场中,找到需要的 API 后,点击立即申请即可进入 API 的权限申请界面,入下图。数据服务中 API 的权限管理依托 Dataphin 的公共权限体系能力,做到了 API 字段级别的权限申请管控。当 API 申请通过后,在个人的后台,既可以看到申请通过的 API。通过配置 API 的入参,可以进行 API 调试,获取当前 API 的返回值,查看是否符合预期。API 调试界面可以对焦 API 测试界面,功能相同,多了 appkey 和 secret 传参。
```
![](data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)![](data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== "点击并拖拽以移动")
![image](https://yqfile.alicdn.com/5ce791460c23b3fb7c733844564522ce1d96f2c1.png)
**\- API 使用**
数据服务提供了统一的调用 SDK,系统工程师可以在自己的系统中调用使用。
写在最后
经过上述简单的几步操作后,以往需要花几周的 API 在弹指一挥间就开发完成并在系统中成功使用上了~而且企业内的 API 管理变得轻松简单~从此,API 好找、好配、好管理~
![image](https://yqfile.alicdn.com/f804da4cdd79f954ffd1dcbc25f9423003aad70b.png)
结语:
阿里巴巴数据中台团队,致力于输出阿里云数据智能的最佳实践,助力每个企业建设自己的数据中台,进而共同实现新时代下的智能商业!
[原文链接](https://yq.aliyun.com/articles/726132?utm_content=g_1000088924)
本文为云栖社区原创内容,未经允许不得转载。
![image](https://yqfile.alicdn.com/48baa62eb7fad1b625d397ea23581b64b0a3ebf7.png)
研发小哥哥还在为公司里大量 API 只上不下,不可查不可用, 想找的 API 找不到而苦恼吗?业务方小姐姐还在为 API 开发时间长,业务相应不及时而抱怨吐槽吗? 铛铛铛,Dataphin 数据服务 -- API 配置管理,闪亮登场!助力研发小哥哥五分钟搞定 API,提升业务响应速度,同时大大提升 API 复用能力!
**Dataphin 数据服务**
Dataphin 是阿里巴巴数据中台(OneData - OneModel、OneID、OneService)方法论的产品载体。Dataphin 数据服务是其中 OneService 部分的载体,是 Dataphin 产品的组成部分,是数据中台的价值出口。连接数据和业务,主要解决数据最后一公里使用的问题。包括 API 管理、主题式即席查询等能力。本次主要为大家带来数据服务中 API 配置、管理、和使用的相关产品功能介绍~
**API 配置 - 五分钟生成 API**
配置生成主要有三大步骤:服务单元配置->API 配置->API 测试
**服务单元配置**
服务单元是数据服务产品中的概念,可以理解为一个逻辑表,可以是下挂单个物理表或下挂多个物理表,也可以是 Dataphin 逻辑表。配置人员根据需要选择字段,并进行字段的相关信息(字段名称和字段类型)配置。下图是单物理表服务单元截图。API 基于服务单元生成。服务单元跟 API 是一对多的关系。
目前数据源类型已支持:MySQL、ElasticSearch、AnalyticDB、HBase,8 月 30 即将支持 PostgreSQL、Oracle、MongoDB。更多数据源持续接入中。
![image](https://yqfile.alicdn.com/041a6ef0526679a3c0fdc57944374584ce47d90a.png)
**API 配置**
基于上文中配置好的服务单元,通过简单的 SQL 脚本,配置 API 的请求参数和返回参数,选择调用方法(支持 GET 和 LIST 两种调用方法),选择 API 更新频率配置,即可快速生成 API。配置界面如下图:
![image](https://yqfile.alicdn.com/746282eb1b4120bb7c02ef95cecb527943019e24.png)
**API 测试 **
API 配置完成后,可以快速进行测试,通过配置请求参数,可以测试 API 的响应时间,以及返回内容详情,等。如下图:
![image](https://yqfile.alicdn.com/7b2d304124f41cc38fc128f5096b317f44e2d3fc.png)
**API 管理 - 可上可下可维护**
**\- API 上下线**
在 API 管理界面,可以清晰的看到 API 的使用情况,被调用次数,发布更新时间,等。同时可以对新增 API 发布上线,也可以对已经存在的 API 下线和删除。让 API 的管理变得简单。
![image](https://yqfile.alicdn.com/54f910aac3a629d12df1b178c2b67dfbbd57351c.png)
**\- API 监控运维**
API 生成后,可以进行 API 的监控和运维,包括 授权应用数、平均响应时长、调用次数、错误率、offline 百分比等指标的监控。
![image](https://yqfile.alicdn.com/bd146eb71c360438eed4897377d8fec8e7778d59.png)
**API 消费 - 好找好拿**
API 申请使用主要有三大步骤:API 服务市场查找->API申请和调试->API 使用
**\- API 服务市场查找**
API 市场里包含了企业内所有已经发布的 API 信息,支持按分组查看,支持按 API 名称查找。可以在 API 市场里查看具体 API 的文档详情,也可以直接申请使用 API。
![image](https://yqfile.alicdn.com/675609a38aced99042c4d4b416a7517c9ffbe172.png)
**\- API 申请调试**
```
在上文 API 市场中,找到需要的 API 后,点击立即申请即可进入 API 的权限申请界面,入下图。数据服务中 API 的权限管理依托 Dataphin 的公共权限体系能力,做到了 API 字段级别的权限申请管控。当 API 申请通过后,在个人的后台,既可以看到申请通过的 API。通过配置 API 的入参,可以进行 API 调试,获取当前 API 的返回值,查看是否符合预期。API 调试界面可以对焦 API 测试界面,功能相同,多了 appkey 和 secret 传参。
```
![](data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)![](data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== "点击并拖拽以移动")
![image](https://yqfile.alicdn.com/5ce791460c23b3fb7c733844564522ce1d96f2c1.png)
**\- API 使用**
数据服务提供了统一的调用 SDK,系统工程师可以在自己的系统中调用使用。
写在最后
经过上述简单的几步操作后,以往需要花几周的 API 在弹指一挥间就开发完成并在系统中成功使用上了~而且企业内的 API 管理变得轻松简单~从此,API 好找、好配、好管理~
![image](https://yqfile.alicdn.com/f804da4cdd79f954ffd1dcbc25f9423003aad70b.png)
结语:
阿里巴巴数据中台团队,致力于输出阿里云数据智能的最佳实践,助力每个企业建设自己的数据中台,进而共同实现新时代下的智能商业!
[原文链接](https://yq.aliyun.com/articles/726132?utm_content=g_1000088924)
本文为云栖社区原创内容,未经允许不得转载。