Skip to content

FEATURE.md

Latest commit

 

History

History
189 lines (131 loc) · 8.02 KB

FEATURE.md

File metadata and controls

189 lines (131 loc) · 8.02 KB

既往回顾

新增功能：

  1. 订阅接口前置后置钩子支持
  2. Rest数据源支持上传接口解析成graphql
  3. Rest数据源支持additionalProperties解析成Map
  4. 添加指令@whereInput用于注入参数构造查询条件
  5. Proxy钩子支持上传/下载功能
  6. Graphql跨源关联添加_join_mutation用于跨源变更操作
  7. 添加支持多数据源事务管理(仅数据库类型)
  8. 实现opentracing链路追踪并接入Prisma实现接口和SQL可观测的链路(jaegertracing/all-in-one:latest)
  9. 指令@Skip和@include添加参数ifRule使用表达式跳过或包含selection
  10. 指令@export可以导出任何非空字段为true值参数
  11. 添加指令@injectRuleValue用于注入参数可替换前置钩子功能
  12. 新增接口并发控制，允许通过设置tickets和timeout来控制接口的同时请求数量
  13. 添加queryRaw配合指令@customizedField实现返回字段自动补全功能，支持数组字段
  14. 调整包含依赖@export导出值的参数的selection执行顺序，跨源关联现在将自动保证执行顺序
  15. 实现Prisma引擎查询/内省部分错误的汉化功能，支持嵌套错误
  16. 添加optional_queryRaw实现SQL片段可选的查询&{}直接替换, ${}参数占位符
  17. JSON类型入参可以直接传递JSON对象，无需再使用JSON.stringify()
  18. 新增指令@skipVariable用于自定义规则跳过参数，例如当A参数为空时跳过B参数
  19. 支持不带前端资源的精简部署，下载命令行添加--without-web参数，镜像末尾添加_without-web
  20. 指令@injectCurrentDateTime新增toUnix用于注入当前时间戳，offset新增format用于偏移后重新格式化时间
  21. 新增指令@firstRawResult用于获取RawQuery查询结果中的第一个元素，实现totalCount功能

破坏变更：

  1. 修改JSON返回值不再是JSON字符串，而是JSON对象，方便前端使用，同时也支持@export指令导出JSON字段

Golang-sdk:

  1. 添加支持手动管理事务函数
  2. 添加调用上传接口，支持多文件上传
  3. 优化自定义数据源内省结果比较，解决重复更新内省文件问题
  4. 新增生成time.time和geometry(Postgres)字段类型
  5. 添加支持根据struct构建Graphql的Args和Type
  6. 解决MutatingPreResolve钩子丢失零值入参问题
  7. 解决time.Time零值入参未被清除的问题

版本v2.2.0

新增功能:

  1. 新增 Graphql 内置解析指令 @transform，替换原有根据 jsonpath 从根节点替换的功能
  2. 全局 operation 和单个 operation 通过 graphqlTransformEnabled 切换新旧解析逻辑
  3. Web 页面 Mock 执行 Graphql 新增按钮用于查看 @transform 指令解析后的数据
  4. 端口 9123 新增接口 /api/storageClient/{dataName}/presignUpload 返回带签名认证的上传地址，用于前端直接上传文件
  5. 新增指令 @asyncResolve 用于并行解析数组 selectionField，当数据量大时效果明显

升级功能:

  1. 指令 @jsonschema 支持 format 和 enum 用于修改参数的类型，和指令 @hookVariable 结合更佳
  2. 指令 @transform 新增参数 math(SUM/AVG/MAX/MIN/COUNT/FIRST/LAST)用于对数组元素进行计算，SUM/AVG/MAX/MIN 仅支持数字，FIRST 常用于取首个元素，针对一对多查询但只需取首个元素时使用
  3. 指令 @customizedField 可以作用于 JSON 字段，实现自定义字段的返回值

破坏变更:

  1. query_raw 和 optional_query_raw 查询默认均解析成数组，可以通过 @firstRawResult 改变内省且取首个元素（计算 total 时常用）

问题修复:

  1. 解决 Prisma Error P2024 错误未正确翻译的问题
  2. 解决读取超长文件行错误的问题（当 schema definitions 非常大时出现）
  3. 解决 Prisma 数据源为空时未能生成内省文件的问题（因为翻译错误内容但原有判断逻辑未修改导致）
  4. Web 页面 Graphql Mock 预览数据时，修复以下被错误清除的 Variable/Selection, 指令 @hookVariable 修饰参数但参数有被 Graphql 使用，指令 @customizedField 修饰 Selection 但字段存在定义中

版本v2.2.2

新增功能:

  1. 现在可以使用相同字段来实现关联查询/统计并通过别名区分，举例如下( Identity和_count.Card分别是关联查询和关联统计，并且通过别名实现不同条件下的数据返回)：
query($username: String!) {
  findManyUser(where: {username: {equals: $username}}) {
    id
    username
    nickname
    createdAt
    header: Identity(take: 1, where: {type: {equals: header}}) {id}
    member: Identity(take: 1, where: {type: {equals: member}}) {id}
    enabledCardCount: _count @transform(get: "enabled") {
      enabled: Card(where: {enabled: {equals: true}})
    }
    disabledCardCount: _count @transform(get: "disabled") {
      disabled: Card(where: {enabled: {equals: false}})
    }
  }
}

版本v2.2.6

新增功能:

  1. 添加operation历史控制，开发模式可以无感切换接口版本
  2. Query 引擎执行超时以及引擎关闭超时配置提取到环境变量中（默认10s和30s）

重大变更:

  1. 简化 optional_queryRaw 的使用，使用字符串代替对象，同时变量占位符使用$name，模板占位符使用${name}

功能优化:

  1. 重写 prisma schema engine 调用逻辑，针对不同方法提供范型约束输入输出

版本v2.2.7

新增功能:

  1. 数据建模页面表列表显示表注释，数据查询、数据编辑/新增显示字段注释
  2. 支持x-enum-varnames用以置换枚举变量名，通过enumRealValue标识真实值并在SDK生成真实值

问题修复:

  1. 数据建模页面在切换到表普通视图，且使用Prisma数据源时，未获取真实数据库类型的问题
  2. 修复枚举值为数字时GraphQL解析错误问题
  3. 增量编译现与全量编译共用锁

版本v2.2.8

新增功能:

  1. graphql订阅新增logger输出，使用zap.L()并与全局日志等级保持一致
  2. 增加普通视图下表和字段注释显示/编辑功能，数据预览下的表注释显示

重大变更:

  1. rest数据源的数字枚举值现在SDK中会生成实际的数字枚举
  2. opentracing链路输入输出由原本日志DEBUG控制改为配置withSpanInout
  3. authentication/datasource/operation/sdk/role/storage逻辑删除改为有启动命令和环境变量控制，且默认关闭

问题修复:

  1. 解决不存在的operation参数导致编译崩溃
  2. 解决SDK中定义的Graphql访问地址错误在编译时确定为静态地址的问题
  3. 解决增量编译时 runtime 和更新接口顺序错误导致的 schema 错误问题

版本v2.2.9

新增功能:

  1. 服务启动参数支持从环境变量中读取配置(需要将横线改成下划线)
  2. 修改 Rest 数据源以适配 Dify SSE 接口，支持在 text/event-stream 定义schema以及x-done-data
  3. 前端 Graphql 代码提示优化，左右符号高亮，错误地方浅红色提示
  4. 前端 Graphql 参数添加checkbox，用于控制参数是否携带

问题修复:

  1. 前端Graphql页面特殊参数输入框导致白屏问题

版本v2.2.10

新增功能:

  1. 钩子健康探测添加enable-hook-report参数，用于钩子在开发环境中跳过首次探测时初始化访问9991端口

重大变更:

  1. RBAC权限判断不通过时状态码返回403，而不是401，并提示Permission not enough
  2. Token失效和无效现在会在401状态码基础上增加错误提示

版本v2.2.11

问题修复:

  1. 前端限制@export指令导出的参数不可输入，且从jsonschema中移除

重大变更:

  1. 删除SpanInout控制，改为IsGlobalTracerRegistered控制

版本未发布

问题修复:

  1. 解决解析Rest数据源中API错误将*/*响应解析成订阅operation
  2. 解决operation钩子及上传钩子在重命名/移动时未移除原有空目录的问题
  3. 修复生成上传钩子代码时读取模板文件路径错误问题

新增功能:

  1. 指令@customizedField支持属性additional用以生成map
  2. 新增--workdir参数用于切换工作目录，方便管理多个项目
  3. 初步实现MCP，9123所有接口封装支持MCP，调试通过