Release date: 2022年05月21日

代码变更: https://github.com/hhyo/Archery/compare/v1.8.4...v1.8.5
贡献者: @hhyo, @Nick and @peter

• 解决action构建失败的问题 @hys (#1534)
• 处理clickhouse特殊数据类型序列化问题 @Nick (#1525)
• 修复密码含特殊字符使用plugins报错问题 @Nick (#1519)
• 更新docker settings @Nick (#1502)
• 修复已登录用户不能配置2FA问题 @Nick (#1500)
• 修复获取oracle回退sql时，有概率在拼合sql函数格式校验时抛出异常。 @peter (#1499)
• 修复开启LDAP后2FA认证报错问题 @Nick (#1494)
• 新增强制全局2FA开关 @Nick (#1490)
• 修复oracle的sql上线，单条回退sql超过4000长度被强制截断成多条的问题 @peter (#1488)

升级步骤

• https://github.com/hhyo/archery/wiki/upgrade

Release date: 2022年05月04日

代码变更: https://github.com/hhyo/Archery/compare/v1.8.3...v1.8.4
贡献者: @cpzt, @cslingjun, @gj19910723, @hhyo, @nick2wang, @unknowissue, @肉丝蒜薹 and @weideguo

新增

• Archery Restful API @Nick (#1475)
• 新增水印功能 @cslingjun (#1466)
• 登录支持2FA @Nick (#1481)

优化

• 脱敏解析替换为goInception，移除Inception依赖 @unknowissue (#1483)
• 支持配置自动审核数据库类型 @Nick (#1452)
• mysql账号管理优化，新增锁定/解锁账号 @Nick (#1436)

修复

• 修复binlog2sql中使用日期过滤报错 @gj19910723 (#1485)
• 修复odps查询不可用问题, 实例测试无效问题, 添加odps测试用例 @chim (#1454)
• oracle规避对象名大小写敏感 @肉丝蒜薹 (#1438)
• 修复下载权限名字错误 @weideguo (#1440)
• 修复查询结果缺失空格问题 @Nick (#1449)
• 修复clickhouse上线审核版本兼容性问题 @Nick (#1428)

升级步骤

• https://github.com/hhyo/archery/wiki/upgrade

Release date: 2022年03月27日

代码变更: https://github.com/hhyo/Archery/compare/v1.8.2...v1.8.3
贡献者: @AceAttorney, @CrusM, @LeoQuote, @blylei, @cpzt, @dependabot, @dependabot[bot], @heisaman, @hhyo, @issacmark, @lijingeng, @nick2wang, @ningyu1, @ocpeng, @quanbisen, @unknowissue and @weideguo

新增

• 支持ClickHouse上线、查询 @Nick (#1384 #1403)
• 支持ODPS查询 @chim (#1363)
• 新增独立的审计模块 @weideguo (#1251 #1342)
• 新增my2sql工具插件模块 #1224 @Nick (#1314)
• 新增mssql、oracle的数据字典支持 (#1351 #1402)
• mysql账号管理支持回收权限(REVOKE) @Nick (#1341)
• redis支持集群模式 @Nick (#1392)

优化

• SQL工单通知支持分阶段控制 @Nick (#1406)
• 增加数据查询下载的权限(hhyo#1367) @weideguo (#1369)
• 为ajax请求的返回错误进行分类报错 (hhyo#1346) @weideguo (#1365)
• Archery Kubernetes Helm Chart 维护 @Aceattorney (#1334)
• oracle执行DDL时备份原始定义 @unknowissue (#1332)
• oracle查看表结构增加注释列 @unknowissue (#1320)
• oracle脱敏更换函数 @unknowissue (#1306)
• 对实例列表进行排序(支持汉字排序) #1290 @Nick (#1322)
• 添加redis/pg创建连接时的超时参数 (hhyo#1311) @weideguo (#1321)
• redis查询结果json格式化显示 #1376 @Nick (#1382)
• SSH隧道连接新增选择本地文件上传密钥，上传后将密钥信息保存到数据库，连接时从数据库读取 @issacmark (#1303)
• SQL上线时可执行时间范围前端优化，要求时间间隔必须大于60分钟 (hhyo#1259) @weideguo (#1279)

修复

• 修复实例检测返回连接状态错误bug fix #1179 @Nick (#1407)
• 修复mongodb表名带-和.符号无法申请上线的问题 @CrusM (#1372 #1381)
• 修复调用shell执行mongodb命令时出现WARNING的问题 (hhyo#1237) @weideguo (#1348)
• 修复插件shell命令注入漏洞 @Nick (#1316)
• 修复Redis hgetall结果不展示的问题 @chim (#1315)
• 修复手动执行完成的工单没有发送通知的问题#1284 @Nick (#1304)
• 修复缩略SQL乱码问题 @ocpeng (#1305)
• 修复会话管理存在的sql注入风险 #1299 @Nick (#1300)
• 修复创建mongodb原生连接时的错误 (hhyo#1291) @weideguo (#1294)
• 修复pgsql获取表结构没有增加schame过滤的问题 @lijingeng (#1285)
• 修复admin.sh中SQL路径错误的问题 @blylei (#1276)

升级步骤

• https://github.com/hhyo/archery/wiki/upgrade
• 本次升级涉及较多的数据模型变更，升级前请注意数据备份
• ssh隧道管理连接存在不兼容的变更，请参考：https://github.com/hhyo/Archery/pull/1303#discussion_r779257350

Release date: 2021年12月05日

代码变更: https://github.com/hhyo/Archery/compare/v1.8.1...v1.8.2
贡献者: @DB-wang2, @GloomyNAN, @LeoQuote, @Linuxgt, @Nexpro, @cpzt, @dependabot, @dependabot[bot], @hhyo, @mxlxm, @nick2wang, @swords1999, @txmzzl, @weideguo and taochao

变更说明

• 修复oracle审核正则匹配问题 #1169 @Nick (#1194)
• mongodb查询优化 (hhyo#1252) @weideguo (#1253)
• 发送企业微信消息带有url的优化 (hhyo#1244) @weideguo (#1247)
• 禁止普通账号查询mysql.user (hhyo#1202) @weideguo (#1222)
• 问题:表名带-符号无法正常解析，原因:\w只匹配[a-zA-Z0-9_]，修正:(\w*) -> ([\w-]*) @txmzzl (#1197)
• mongdb查询的结果集中缺少字段 @chim (#1192)
• docker安装默认映射出goinception的4000端口 @DB-wang2 (#1186)
• 解决查询DECIMAL类型展示精度丢失的问题 fix #1250
• Bump django from 3.1.12 to 3.1.13 @dependabot (#1185)
• support offset @mxlxm (#1172)
• fix sql.trx_view and MaskingColumns column_comment @Gloomy楠 (#1175)
• 修改快捷键绕过表单验证问题 @DB-wang2 (#1178)
• fix mongo connction @LeoQuote (#1168)
• Update extend_json_encoder.py @Nexpro (#1131)
• Bump django from 3.1.9 to 3.1.12 @dependabot (#1114)
• donnot set auto_now_add for ArchiveLog.start_time @swords1999 (#1113)
• Bump django from 3.1.8 to 3.1.9 @dependabot (#1111)
• Update docs.md @刘玄罡 (#1103)
• Bump django from 3.1.6 to 3.1.8 @dependabot (#1070)

升级步骤

• https://github.com/hhyo/archery/wiki/upgrade

Release date: 2021年03月27日

变更说明

• 移除对 Inception 的审核支持，仅作为脱敏语句解析使用
• 在线查询，pg数据库增加会话超时设定，支持查询脱敏
• 慢查日志和明细列表支持按表头字段进行服务端排序
• 默认资源组、权限组支持多选，优化系统配置下拉选项

修复说明

• 解决数据库区分大小写时查看事务信息报错的问题
• 解决 memoryview is not JSON serializable
• PG脱敏-查询语句中带有别名脱敏处理
• 解决查询结果不展示json对象的问题
• 调整启动方式为wsgi，解决上版本出现访问阻塞的问题
• 企业微信消息推送,如果消息接受者ID为空,则不会调用企业微信官方API.
• fix(sendmsg/feishu): fix #1016 支持新版飞书 webhook 接口 )
• Bump django from 3.1.2 to 3.1.6
• add pycryptodome to requirements

易用性调整

• 手动执行按钮改名为“已手动完成”

安全性调整

• 对接受入参的SQL拼接增加参数转义，规避注入风险
• 使用shlex.quote()对插件参数进行过滤，规避注入风险

升级步骤

• https://archerydms.com/installation/upgrade/

Release date: 2020年11月01日

贡献者: @Alenx58, @LeoQuote, @dongqianzheng, @exqlnet, @fancy-lee, @hhyo, @johnliu2008, @lidaobing and @yuandajn578

注意事项

本次版本变更，Django 版本由 2.2 升级为 3.1，容器镜像中的 Python 版本由 3.6.5 升级为 3.8.6（ci测试结果显示兼容3.6、3.7、3.8），还涉及其他依赖库的更新，请在本地充分测试后进行升级，升级注意事项请查看下方升级说明

变更说明

• 升级 Django 版本至 3.1.2，增加 python 3.7、3.8 的构建测试，以及其他依赖库的升级
• 加入 mongodb 审核和上线支持，重写 mongodb 查询，支持原生语法
• 移除配置信息的缓存依赖，直接读取 DB
• SQL 工单列表默认只展示最近 30 天的记录

修复说明

• 解决 mysql 跨库查询时表权限的校验问题
• 修复会话管理-事务信息页面不显示阻塞源事务内容的问题
• 调整整 sql 查询 mysql 表信息解析方法，支持嵌套子查询
• goInception 默认配置 lock_wait_timeout=10，避免长时间的元数据锁对生产环境造成影响
• 指定 pymysql==0.9.3，修复binlog2sql不可用的问题
• 解决检查 pg 连接提示数据库不存在的问题
• 修复初始化脚本中的慢日志
• 解决 DML语句包含头部注释会绕过自动审批判断的问题
• 解決 SQL 分析页面，当 SQL 中包含 != 的时候，会导致查看按钮显示异常，无法展示相应的 SQL 建议的问题
• fix: typo in helm charts values
• Update docs.md

易用性调整

• 没有查询权限时，增加申请链接
• 注册用户默认打开管理后台权限，支持修改密码
• 通过 goInception 执行时，增对阿里云 RDS 自动开启aliyun_rds参数
• 实例连接隧道信息在后台管理编辑时加密展示
• 使企业微信机器人推送的消息中的工单地址支持超链接

升级步骤

• Django和Django-q的版本升级涉及数据migrate，请在服务部署完成后执行 python manage.py migrate
• 其他注意事项查看：https://github.com/hhyo/archery/wiki/upgrade

Release date: 2020年08月30日

变更说明

• 添加隧道管理页面
• redis支持zset相关命令 @dongqianzheng
• dashboard增加最近24小时慢查询统计
• 实例编辑时隐藏密码信息
• fix field name error

修复说明

• 修复sql优化不支持转义符的问题
• 解决 MySQL 数据库区分大小写时，SQL优化解析表信息失败的问题
• 修复inception/goinception 连接ssh隧道bug
• 移除sql_completer，修复ci
• 解决 ios 横向滚动失效的问题

升级步骤

• https://archerydms.com/installation/upgrade/

Release date: 2020年07月17日

变更说明

• 增加企业微信群机器人通知(webhook) @kulokai
• 添加跳板机连接数据库功能 @EliasChiang
• 升级wiki 位置调整 @LeoQuote

修复说明

• use self.db_name when getting db list @LeoQuote

升级步骤

• https://archerydms.com/installation/upgrade/

Release date: 2020年05月30日

变更说明

• 针对MongoDB查询进行了多方面的优化

1. 支持集合列名的查看和补全提示
2. 支持aggregate、count、sort、fields等语法
3. 支持查询语句格式化

• 支持配置多个阿里云认证信息，关联不同的RDS实例
• 修复审核流程中权限组选择框状态残留问题
• Oracle insert all语法审核的支持
• optimize_sqltuning拦截非查询SQL，防止线上数据被误修改

修复说明

• 解决mariadb查询报错的问题
• 解决执行redis命令不能包含空格的问题

易用性改进

• ace编辑器启用快捷搜索功能，可使用command+f/ctrl+f 搜索编辑内容

升级步骤

• https://gitee.com/rtttte/Archery/wiki/升级

Release date: 2020年05月05日

变更说明

• Oracle 功能增强和 bugfix

 1.SQL工单支持数据修改备份和查看回滚信息
 2.SQL优化工具新增sql tuning advisor
 3.在线查询支持执行计划查看
 4.支持update/insert/delete/create table/create index的语法审核

修复说明

• 回滚 django-q 版本，解决任务重复调度的问题
• 简化 inc 初始化操作，移除Inception的部分前置检测，提升检测效率
• SQL上线工单增加排队状态，解决工单可能重复执行的问题
• 修复 SQL 检测结果未开启转义的问题

易用性改进

• 优化系统配置检测按钮位置
• 等待审批的 SQL 工单详情展示当前全部审批人
• fix the template of inception and goinception

升级步骤

• https://archerydms.com/installation/upgrade/

Release date: 2020年04月11日

变更说明

• 提供Oracle相关支持

修复说明

• 修复取消定时执行无效的问题，影响v1.7.4~v1.7.8，请使用关联版本的用户升级
• 调整归档字符集的设置，兼容utf8mb4数据归档
• 修复申请归档不传入sleep值报错的bug
• 获取redis数据库列表时增加容错，失败后默认展示16个db

升级步骤

• https://archerydms.com/installation/upgrade/

Release date: 2020年03月21日

变更说明

• 支持飞书群推/单推
• 归档 schedule 配置支持传入配置 id
• 针对 MySQL 5.7.8以上版本使用 session max_execution_time 控制在线查询执行时长

修复说明

• 修复 common/utils/ding_api.py 的 get_access_token 返回 bytes 导致钉钉 url 拼接不正确
• 修复审批流程钉钉通知个人无响应问题
• 修复工单驳回无消息通知的问题
• 修复 oracle 查看表信息过滤schema

易用性改进

• SQL 上线仅在SQL文本内容为空的时候才展示提示信息
• SQL 工单审核备注支持换行展示，加大工单操作内容长度
• 增加 binlog2sql 异步任务失败通知，SQL工单执行结束消息内容完善
• 增加一体初始化脚本
• 系统配置保存时去除空格信息

升级步骤

• https://archerydms.com/installation/upgrade/

Release date: 2020年02月09日

变更说明

• MongoDB 支持指定库连接
• 增加归档任务手动触发逻辑
• 移除schemasync配置项，新增为项目依赖 ，感谢SchemaSync项目

修复说明

• 归档时动态获取表字符集信息，避免字符集不匹配导致归档失败
• 解决归档菜单无权限和归档实例未过滤类型的问题
• 仅审核通过的归档配置显示启用按钮

易用性改进

• 调整资源组和实例标签的多对多模型，后台配置更直观
• 初始化数据增加几个默认权限组

升级步骤

• https://archerydms.com/installation/upgrade/

Release date: 2020年02月03日

修复说明

• 解决消息通知的几个问题

Release date: 2020年02月02日

变更说明

• 增加 MySQL 数据归档模块，可以使用 pt-archiver 归档数据

修复说明

• 解决 MsSQL 禁止*查询无效的问题
• 解决部分页面 SQL 内容未转义，导致展示异常的问题
• 修复企业微信发送消息失败的bug
• 回滚按钮展示逻辑修复，未开启备份的不展示回滚按钮
• 解决清空可执行时间无效的问题

易用性改进

• SQL 上线输入框补充部分说明信息，仅 MySQL 和 Redis
• 只读检测兼容 tidb 的 read_only 返回值信息
• SQL 上线工单详情增加导出以及快速展开、折叠内容按钮，同时增加隐藏的完整SQL列

安全性修复

• 移除 binlog2sql 异步 task 中的敏感信息
• 解决部分页面SQL内容未转义，导致展示异常的问题
• Upgrade Django to version 2.2.9

升级步骤

• https://gitee.com/rtttte/Archery/wiki/升级

Release date: 2019年12月21日

本次更新主要是bug修复和易用性改进，无功能新增

修复说明

• 解决执行回调可能出现DB超时，导致工单一直执行中的问题
• binlog2sql 异步超时时间设置，避免解析未结束就终止
• goInception 连接字符处理，兼容特殊字符信息
• mssql、oracle 的查询脱敏仅应用实例关联的脱敏规则
• 解决表名是 mysql 关键字时查看表结构报错的问题

易用性改进

• 上线工单需求链接修改为可选项
• 修改企业微信推送通知为纯文本格式
• django-q task 增加自定义名称，方便问题排查
• 增加自定义错误页面
• 调整日志信息和等级，减少敏感信息输出

移除功能

• 隐藏 SQL 上线的可选通知人选项

升级步骤

• https://gitee.com/rtttte/Archery/wiki/升级

Release date: 2019年12月08日

变更说明

• 使用 goInception 作为 MySQL 查询表权限的解析工具，兼容更多查询场景
• SQL上线工单增加需求链接，方便追溯变更需求信息
• 会话管理增加实例事务信息展示
• 调整日志文件路径到项目根目录
• 更新 django 版本到 2.2.8，同时升级其他依赖库

修复说明

• fixed bug, when we change group_name select element, the optgroup of
• 解决 binlog2sql 模块 back-interval 传值问题
• 修复工具插件菜单不显示的问题
• 解决 MySQL 查询 time 类型数据序列化为秒的问题
• Dashboard 使用模板片段缓存替换 view 缓存
• 资源组列表和用户实例列表增加伪删除过滤

易用性改进

• dockerfile优化
• 容器化部署增加sql migrations数据持久化支持
• DDL工单结束和创建数据库后主动清空实例资源缓存
• 简化项目启动脚本，gunicorn使用gevent工作模式

安全性改进

• 针对SQL工单详情和回滚信息做权限校验，和列表过滤逻辑保存一致

Release date: 2019年11月17日

变更说明

• 增加数据字典导出功能 @hys (#511)
• 优化回滚查询，支持下载回滚语句，方便回滚 @hys (#518)
• 管理员新增查看系统信息入口，便于故障排除 @hys (#216)

修复说明

• 解决 MySQL 在线查询 bit 类型字段查询展示异常的问题 @hys (#495)
• 修复工单提醒页工单类型过滤无效的问题 @hujingguang (#504)
• 解决资源组对象列表无法模糊搜索关联实例的问题 @hhyo(#512)
• fix analysis_slow_query.sh, add lacked of ‘fi’ end of the file @zusie (#515)

其他说明

• 工单详情基础信息表格样式修改，不换行展示
• 移除moz_sql_parser相关解析代码

Release date: 2019年11月02日

注意

• 本次升级统一了敏感数据的加密方式，在升级完成后需要迁移旧的加密数据，否则实例连接会提示密码错误，迁移步骤为管理员登录后访问/api/do_once/mirage，如演示环境访问：http://139.199.0.191/api/do_once/mirage
• 本次升级删除了阿里云AK配置表，转移到系统配置中，使用RDS管理的请到系统配置中重新配置相关信息

变更说明

• 集成企业微信应用通知
• SQL 上线自动审批支持按照实例标签过滤

易用性改进

• 增加 archery charts
• 优化 redis 查询体验
• 获取实例数据库、表、列信息的接口增加缓存，缓存时间为5分钟
• SQL工单详情增加备份耗时展示
• 会话管理新增完整INFO展示
• 慢日志列表增加完整语句项

安全性调整

• 统一数据加密方式
• 服务端对用户操作的实例进行二次鉴权

Release date: 2019年09月29日

注意

• 本次升级涉及较多的数据和结构变更，升级前请注意备份数据，请使用master分支的变更脚本，release中脚本有部分语句遗漏
• MySQL审核默认切换为goInception，升级后请注意在系统配置中重新修改保存配置
• 配置文件和依赖均有调整，手工部署升级的请注意相关依赖变更，重新替换配置，升级依赖

变更说明

• 增加 MySQL 实例数据库管理模块
• 完善 MySQL 账号管理模块，支持账号新增、授权、改密和删除
• 增加钉钉个人通知功能(需要创建微应用)
• Dashboard展现布局修改
• 增加对Phoenix的查询支持
• MySQL审核默认切换为goInception
• 增加资源组粒度的查询权限
• 慢查询详情支持展示该SQL的历史执行趋势
• RDS依赖更新以及utc时间转换方法调整

修复说明

• 全局解决下拉筛选项被表格遮挡的问题
• 为 failed_login_count 增加范围限制, 强制限制在 0-127
• 修复脱敏异常时将权限校验标记为跳过的问题
• 调整JSON序列化的时间格式，在线查询时结果展示可达到微秒
• 在线查询结果为null时显示为 (null) 并且置灰显示
• 修复SQL查询达到超时时间没有主动终止的问题

易用性调整

• 慢日志支持前端导出，最多展示1000条
• 查询权限申请限制行数支持手动输入
• 执行工单时判断实例read_only状态，实例只读时禁止执行
• 部分二级菜单页面增加面包屑导航，方便跳转
• 增加请求压缩，针对大结果集查询和SQL提交可提升效率
• 允许自行替换docs.md文件，展示相关文档信息

安全性调整

• docker-compose默认将除了web端外的所有app从port改为expose,不再向外暴露对应端口, 降低安全风险，Redis连接增加密码
• 会话终止功能忽略外部传入的SQL，后端自己构建执行语句
• 系统配置信息使用django-mirage-field加密(其他旧字段在将下个版本调整)

移除说明

• 整体移除Themis模块，binlog2sql和schemasync合并到工具插件菜单下