变更合辑(2023年)
版本:v1.7.0
新增功能
1.报警规则的通知人支持报警组。
功能介绍:
- 创建报警规则时,通知人支持选择报警组。
2.传输加密算法支持RSA+AES的方式。
功能介绍:
- 创建API时,若开启传输加密,支持选择RSA+AES算法。
3.API绑定应用时,若开启行级权限,支持配置单值精准匹配或者多值匹配。
功能介绍:
- 在API详情页或API集市中绑定应用时,若开启行级权限,支持选择行权限值传参配置,可选择单个权限值精准匹配或任务权限值的组合。
功能使用注意事项:
- 任意权限值的组合目前只适用于入参绑定了in或者between的操作符,且行级权限的入参参数类型为字符串;
- 当选择任意权限值的组合传参方式时,传递多个值可以使用英文逗号分隔。
4.添加参数弹窗中支持字段名称或描述搜索定位。
功能介绍:
- 创建API时,在添加参数的弹窗中,支持按照字段名称或描述进行搜索定位。
功能优化
1.在API集市申请绑定应用时,若绑定同一个应用申请了多个工单,优化在流协侧审批工单的问题。
功能介绍:
- 在API集市申请API时,若绑定同一个应用生成了多个工单,在流协侧审批工单时,优化工单审批流程,默认可通过不报错。
版本:v1.6.9
新增功能
1.配合发布中心,API支持根据资源名称批量查询资源。
功能介绍:
- 配合发布中心,在发布中心侧支持根据资源名称批量查询API资源。
2.配合发布中心,数据服务API由支持发布到线上环境更改为仅支持发布到开发环境。
功能介绍:
- 配合发布中心,在发布中心,针对API资源,仅支持发布到开发环境。
版本:v1.6.8
新增功能
1.服务编排的UDF节点,支持获取开始节点的参数使用。
功能介绍:
- 服务编排的UDF节点,支持选择是否启用开始节点的参数,可通过在UDF中使用"systemstart参数名称"的方式获取开始节点的参数在当前节点中复用。
功能优化
1.入参的参数名长度限制扩展
功能介绍:
- 创建入参时,参数名称从最多支持32个字符扩展为支持64个字符。
2.发布中心侧支持在资源列表点击API名称跳转
功能介绍:
- 发布中心的资源列表,数据服务API支持点击名称,可跳转至对应API详情页。
3.发布中心的资源列表,数据服务API资源信息中增加环境类型字段
功能介绍:
- 发布中心的资源列表,有关数据服务API中的资源信息增加环境类型字段,用于区分不同环境下的API。
4.新建API时,在脚本模式下,若数据源为hive/doris/greenplum时,若使用分页参数,SQL语句中必须要有order by才可正确分页,增加提示内容
功能介绍:
- 脚本模式下,当数据源类型为hive/doris/greenplum时,增加提示内容,若使用分页参数,SQL语句中必须要有order by字段才可正确分页。
5.日志分析模块,根据API ID进行搜索的提示优化
功能介绍:
- 日志分析模块,若选择根据API ID进行搜索,当输入内容非整型字符时的报错内容优化。
6.解除API绑定的报警策略时的提示文案优化
功能介绍:
- API绑定报警策略,在进行策略解除时,二次确认弹窗的文案优化。
版本:v1.6.7
新增功能
1.测试页面支持展示参数描述内容。
功能介绍:
- 测试页面可查看对应参数的描述内容,若数据较多,可hover查看全部。
2.支持starRocks数据源创建API。
功能介绍:
- 脚本或者向导模式下,支持选择starRocks数据源生成API。
3.服务编排,支持获取开始节点定义的参数使用。。
功能介绍:
- 服务编排,若在下游节点需要使用在开始节点定义的参数,支持绑定或者启用开始节点参数。
功能使用注意事项:
- 若开始节点参数为非必填,而API节点的参数为必填,则不支持API节点绑定开始节点;且建议绑定字段的参数类型保持一致。
4.支持页面清除缓存的逻辑。
功能介绍:
- 对于发布过的API,支持详情页面上选择是否清除缓存。
功能优化
1.API下载为excel文件,总览页面新增字段
功能介绍:
- API下载为excel文件时,总览页面增加数据源类型、状态、测试状态等字段。
功能使用注意事项:
- PDF格式由于排版问题,暂未新增创建人等字段。
2.脚本模式下的解析返回参数优化
功能介绍:
- 脚本模式下,支持点击解析返回参数功能,系统会将脚本中的字段填充至右侧的"返回参数"列表,支持按照用户脚本中字段顺序进行解析填充(目前仅MySQL、Oracle、SQLServer数据源类型支持有序解析且可填充字段描述,其他数据源类型暂保持当前现状)。
3.API经后置返回参数处理后的逻辑优化
功能介绍:
- API经后置返回参数处理,包括对参数内容或者数量等进行处理,若jar包或UDF中对数量进行了处理,同样支持返回处理后的数据量。
4.API详情页面排版优化
功能介绍:
- API详情页面,包括API列表和API集市的详情页,页面排版优化,支持在最顶部展示API名称、描述和环境等内容。
5.服务编排日志优化
功能介绍:
- 服务编排API的入参内容支持输出至日志,便于用户查询日志定位分析。
6.注册API是否必填增加功能提示
功能介绍:
- 由于注册API功能仅做透传功能,对于用户配置的默认值仅作为展示使用,不作为请求参数实际生效,故不支持默认值传递的功能。注册API页面增加提示。
功能使用注意事项:
- 注册功能用于托管第三方API,参数是否必填仅作为给调用者的展示信息,平台不传递默认值参与计算。
7.版本历史功能优化
功能介绍:
- 更正版本历史列表中的修改时间;更新版本历史弹窗中的文案提示。
8.服务编排支持同步域名
功能介绍:
- 若在Ops侧配置了新的域名地址,支持原子API和服务编排API的域名同步。
9.创建API,MySQL数据源库表选择逻辑优化
功能介绍:
- 对于MySQL数据源,数据库下拉支持获取登记的数据源下所有的DB。
10.细粒度监控下,数据写入逻辑优化
功能介绍:
- 在细粒度监控下,修复部分脚本模式下的SQL写入到NTSDB中因为换行符导致写入失败而无法查看监控数据的问题。
11.API导出的Excel文档排版优化
功能介绍:
- API导出为Excel文件,优化响应示例中多余的换行符。
12.hive数据源支持库搜索
功能介绍:
- 修复hive数据源创建API,库无法搜索定位的问题。
13.支持数据地图的inner API
功能介绍:
- 配合数据地图需求,支持API血缘推送时增加表字段信息、支持批量获取API负责人的inner API。
版本:v1.6.6
新增功能
1.对接发布中心支持导出功能。
功能介绍:
- 对接发布中心,支持在发布中心选择API进行异构环境的导入导出。
功能使用注意事项:
- (1)API默认仅可导入到线上模式,但不会将接收方的线上已有的API进行覆盖,对于发布中心中"导入到开发模式"的功能不支持;
(2)根据接收方API不同采取不同的发布策略,若接收方为非发布态,则发布方将覆盖接收方API配置;若接收方为发布态,则发布方的API将作为接收方API的升级版本;
(3)由于数据服务以项目为管理单位,若发布方和接收方为同一个平台下的同一个项目下的API,执行发布操作时将被忽略不执行发布;
(4)为保证API调用地址和API集合、名称等的一致性,API集合名称和集合path均需保持一致才可成功发布;
(5)支持在发布中心配置数据源映射,若未配置数据源映射,则根据发布方和接收方的数据源名称,按照同名规则进行替换;
(6)资源组暂不支持配置映射关系,将根据发布方和接收方的资源组名称,按照同名规则进行替换,否则置空资源组;
(7)发布方和接收方API处于相同集合(集合名称和集合path均相同),且API的名称和API path也均相同,则支持导入,且根据接收方的API状态,选择进行覆盖或者作为升级版本;
(8)发布方和接收方API处于不同集合,均支持导入;
(9)若导入的是服务编排类型的API,由于引用的原子API基于API ID进行判断,异构环境下无法保证一致,故编排中原子API需在接收方重新选择;
(10)若导入的API含有后置参数处理,若通过jar包的方式,则支持将Jar包一并导入到接收方,若通过UDF Studio的方式,则UDF函数将置空,需在接收方重新选择。
(11)在数据服务侧,若API有升级/回滚版本,支持在列表中通过点击最前面的收起、展开按钮查看,可对升级/回滚版本进行编辑或者删除。
2.报警规则支持配置错误数报警。
功能介绍:
- 新建报警策略,增加调用失败次数的报警类型,支持配置xx分钟内出现yyy次调用失败的报警规则。
功能使用注意事项:
- 若数据服务开启了细粒度监控,统计时间为1分钟内,调用失败次数可配置大于1分钟的时间;若数据服务未开启细粒度监控,仍使用的是粗粒度的监控,统计时间默认为5分钟,则调用失败次数默认仅可配置5分钟内出现yyy次调用失败。
3.对接安全中心,支持转交API负责人功能
功能介绍:
- 支持数据服务API负责人字段,且对接安全中心权限治理模块,支持对API负责人进行转交。
功能使用注意事项:
数据服务API增加负责人字段,相对应调整的内容包括:
(1)API集市的审批人默认由原本的创建人变为API的负责人,且由于在流协侧支持修改画布可能会更改审批人,故API集市中申请弹窗不显示审批人,可至流协工单中查看;
(2)默认权限需要注意的是,原本API的创建人默认对自己创建的API有全部权限,若负责人没有转交,负责人同创建人,仍有全部权限,但若将API的负责人进行了转交,则API的负责人对API有全部权限。
版本:v1.6.5
新增功能
1.对接安全中心访问控制权限。
功能介绍:
- 在安全中心的项目级别,数据服务对接访问控制权限,只有赋权访问权限后,才可查看数据服务相关页面。
功能使用注意事项:
- 若没有赋权访问控制权限,直接点击"数据服务"导航栏将提示无权限,在授权API新建、编辑等权限前,需要先赋权数据服务访问权限。
功能优化
1.数据源引用详情,由项目级别调整为项目组级别
功能介绍:
- 在控制台查看引用详情时,若该数据源被API所使用,由原本只返回当前项目下的引用信息,变更为返回整个项目组下所有项目的引用信息。
版本:v1.6.4.1
功能优化
1.API血缘功能完善。
功能介绍:
- API血缘接口完善,API创建成功推送血缘,API删除则同步删除血缘,API升级/回滚更新血缘,对应在数据地图侧可查看API血缘信息。
2.修复引用UDF Studio中的函数后,重新编辑函数名变为ID的问题
功能介绍:
- 引用UDF Studio中的函数后,重新编辑会出现函数名称变为了ID的问题修复。
版本:v1.6.4
新增功能
1.支持日志分析功能
功能介绍:
- 新增日志分析功能模块,可查看最近3个月的API调用记录。
功能使用注意事项:
- 日志分析功能模块默认不可见,需在安全中心-角色管理的项目级别,针对数据服务"模块"中选择日志分析,授权可见;
- 日志分析模块默认保留最近3个月的调用记录,可查看基础信息、调用内容和返回内容。
2.Hive数据源类型,支持选择公开给当前项目下的库表创建API
功能介绍:
- 在安全中心数据权限管理中,可将当前项目下的hive库表公开给其他项目使用,数据服务通过Hive创建API时,支持选择公开给当前项目的其他项目的库表创建API。
3.标签画像API,排序参数列表增加字段名称显示
功能介绍:
- 创建标签画像API时,排序参数列表增加字段名称,标明排序参数绑定的真实字段名称内容。
功能优化
1.功能权限和操作审计功能优化
功能介绍:
- 操作审计中增加下载和测试的事件审计。
2.服务编排结束节点,参数名称校验规则优化
功能介绍:
- 服务编排的结束节点,参数名称校验规则优化,保持和原子API的返回参数规则一致.
3.资源组创建时,若资源组名称在easydata下重名的提示内容优化
功能介绍:
- 在整个easydata环境下,资源组名称不可重复,创建资源组时,若名称重复给出提示内容。
4.针对API和应用的流控策略优化
功能介绍:
- 针对API和应用的调用次数限制,增加提示说明,且后端向上取整,优化限流次数。
版本:v1.6.3
新增功能
1.数据服务支持TDSQL数据源创建API
功能介绍:
- 新建API,向导和脚本模式支持TDSQL数据源创建API,列表支持TDSQL数据源筛选
2.数据服务支持达梦数据源创建API
功能介绍:
- 新建标签画像API,可选择标签API或者群组API,第一步的基本配置同其他API配置,第二步需要选择标签画像侧对应项目组-集群下的工作组对应的标签或者群组,第三步同样支持测试。标签画像API详情页增加标签相关信息,包括工作组、对象等。新建API,向导和脚本模式支持达梦数据源创建API,列表支持达梦数据源筛选。
3.编排API若引用了原子API,支持在下线原子API时提示判断
功能介绍:
- 若编排API引用了原子API,在将原子API进行下线时,支持弹窗提示,无法下线。
功能优化
1.API绑定了其他项目下的应用时,下线API的提示优化
功能介绍:
- 当前项目的API绑定了同项目组下其他项目的应用,在下线API时弹窗优化,支持提示API被哪些项目的应用绑定。
2.标签画像API功能完善
功能介绍:
- 支持标签画像API下载、修正标签画像API创建时的文案内容。
3.未加入项目的用户访问数据服务,页面提示优化
功能介绍:
- 未加入项目的用户访问数据服务产品,统一使用Easydata提示页面,支持加入项目申请。
版本:v1.6.2
新增功能
1.数据服务支持新建标签画像API功能
功能介绍:
- API列表模块,新建操作下拉可选择标签画像API
2.标签画像API,支持标签或者群组类型
功能介绍:
- 新建标签画像API,可选择标签API或者群组API,第一步的基本配置同其他API配置,第二步需要选择标签画像侧对应项目组-集群下的工作组对应的标签或者群组,第三步同样支持测试。标签画像API详情页增加标签相关信息,包括工作组、对象等。
注意事项:
标签API,支持在第一步配置入参;群组API,只需要在第二步配置返回参数即可。
新建标签画像API功能,权限统一在安全中心配置,"新建"操作包含新建标签画像API和其他API类型。
3.API列表支持标签画像API的展示和筛选定位
功能介绍:
- API列表中,API类型支持筛选标签画像API,快速定位标签画像API
版本:v1.6.1
功能优化
1.修复因功能权限迁移导致的新建权限丢失的问题
版本:v1.6.0
新增功能
1.API生命周期管理支持审批
功能介绍:
- 对于API生命周期管理支持设置审批,涉及到API发布、下线、升级、回滚和删除,若开启了审批,则对API进行发布等操作默认需要项目管理员和项目负责人进行审批,统一新流协承载工单。
功能使用注意事项:
- 兼容之前的使用方式,默认API生命周期管理不支持审批,可在安全中心精细化控制API权限;
- 若对API生命周期管理需要审批,可在数据服务-配置管理中开启,开启后,默认由当前项目管理员和项目负责人进行审批;
- 若一开始打开了审批功能,并且产生了部分已经在审批中的工单,此时关闭了审批功能,则工单的响应结果不会影响数据服务的API使用。
- 对某个API的某些操作审批仅生效一次,比如申请API升级,若未操作,后续仍可点击API升级,但若升级完成,再次对API进行升级,会再次生成审批工单。
2.项目集群的切换支持显示项目描述
版本:v1.5.9
新增功能
1.ES数据源创建API支持DSL模式,可通过DSL语法匹配更多语法场景
功能介绍:
- ES创建API原本使用的是ES sql插件,可以将SQL转化为DSL查询,但用户在使用过程中反馈,并不是所有的SQL都会转为DSL,比如分词匹配、短语匹配等场景不支持,故需要支持原生ES的DSL语法,无需转义,满足更多的使用场景。
功能使用注意事项:
在选择了ES数据源构建API时,支持选择开发模式,默认为SQL模式,可切换为DSL模式;
切换为DSL模式后,需要选择ES中的索引,元数据信息展示处会呈现索引中的元数据信息;
代码编辑区支持json格式化功能。
由于DSL语法无法识别返回参数,完全按照ES查询的数据返回,故在DSL模式下,脚本编辑和返回参数侧无返回参数字段列表。
2.入参定义支持复制操作,简化入参创建步骤。
3.数据服务首次部署时,初始化报警通道ID的逻辑,支持动态的获取报警系统的通道ID信息。
4.报警邮件通知内容支持展示中文名称
5.新建、编辑、升级等步骤,支持取消操作,点击取消后,默认回到API列表页面
功能优化
1.增强API服务监控指标,包括请求数、GC耗时和次数等内容,可通过OPS采集并在ops侧统一查看监控指标信息。
2.API生成方式支持向导和脚本模式,文案进行变更
3.后端server优化,包括连接池统一使用Hikri,异常分大类管理,代码整理等内容;
4.API查询优化,查询语句和count语句由串行执行优化为并行,提高查询效率;
5.编排自定义代码区优化,扩大自定义代码区内容,将系统代码和自定义代码展示在同一区域内
6.应用管理页面交互视觉优化,统一icon等
7.API标签内容较多时的展示优化,Hover可展示全部内容
8.API入参支持空态展示
9.交互视觉优化,按钮操作位置保持统一
版本:v1.5.8
新增功能
1.支持修改超时时间
功能介绍:
- 可以在API详情页面修改API超时时间,不影响API在线使用
2.hive数据源类型,支持切换为个人账号执行。若通过安全中心,对数据字段配置了脱敏,创建hive API时,需要选择以个人账号执行,以达到字段脱敏的目的。
3.支持api path和描述内容搜索,其中api path指的是集合path+api path,方便快速定位;同时增加表头过滤,默认列表展示全部。
4.支持缓存清除的openapi,可以在缓存失效情况下,清除缓存内容。
功能优化
1.资源组功能完善,创建成功且已启用的资源组,支持在详情页查看实例IP详情,便于问题定位。
版本:v1.5.7
新增功能
1.支持数据源权限判断和源系统账号鉴权功能
功能介绍:
- 控制台登记数据源,支持"使用授权"功能,可针对当前数据源开放给项目组使用或只赋权某个项目使用,且数据源使用权限可以通过安全中心或数据权限功能进行管控,故在通过数据服务构建API时需要对当前项目可使用的数据源、创建者可使用的数据源进行管控,实现数据的安全开放
功能使用注意事项:
在选择数据源时,只有在登记数据源时"使用授权"配置了当前项目的数据源才可被选择,否则数据源不可见;
增加对当前用户是否对数据源有读权限的判断,对于平台自带的hive数据源,在安全中心"数据授权"模块管理读权限;对于非hive数据源,在安全中心-角色管理-项目级别的功能权限中,“数据源管理”中管理数据源读权限;
目前仅MySQL、Oracle、GreenPlum、Vertica和ES有源系统账号鉴权的功能,为了保证不影响线上已使用的API场景,源系统账号鉴权功能默认关闭,以满足以下场景:在该版本之前用户已经创建了API,没有开启源系统账号鉴权功能,使用的是登记时的用户名和密码执行的查询,在当前版本支持了源系统账号鉴权功能,且该用户也配置了源系统账号,但该用户对数据源没有读权限,此时会导致API报错,故该功能默认关闭
2.支持MongoDB数据源创建API
3.API详情页面展示优化,将基础信息、授权信息、绑定策略、监控管理、响应示例、调用示例分为不同的tab展示,包括API列表详情页和API集市的详情页
4.策略管理页面合并,将流控策略、访问策略、报警策略和行级权限策略分为了不同的tab展示
5.创建API过程的步骤优化,支持两列展示,包括新建API、注册API和新建服务编排
6.增加审计信息详情,在安全中心操作审计功能模块,针对API操作增加审计详情
7.对接新版功能权限,统一在角色管理中管理权限
8.对于测试成功的API,支持在测试页面直接发布,而不需要在列表中再执行发布操作
9.API详情页增加发布和下线的操作按钮,不需要额外到API列表再执行操作
10.服务编排API,结束节点,返回参数支持自定义形式
11.服务编排API,支持列级权限功能
12.API列表支持API ID的内容展示和筛选,支持在查看Kong网关监控中,通过api id唯一定位API需求
功能优化
1.服务编排节点支持delete快捷键删除。
2.SQL模式下,返回参数列表展示优化
3.服务编排,代码编辑框展示优化。
4.列表页增加分页,解决接口响应不及时的问题,包括资源组引用详情页面、API绑定的策略弹窗、应用详情、流控策略、访问策略、报警策略和行级权限策略,绑定API的列表均支持分页优化