小米开源自研智能SQL优化与改写工具SOAR使用指南

本文简述了SOAR的下载安装和使用方法，并介绍了SOAR的基础设置和应用的四个场景。
上篇文章回顾： 基于线性回归的故障恢复时间预测

在10月20日的开源先锋日（OSCAR）上，小米开源了自研的SOAR（SQL Optimizer And Rewriter），点击查看“开源地址”。这是一款智能SQL优化和改写工具，开发人员能够直接经过此工具快速的对本身的SQL进行质量检查，生成评估报告，防止将问题SQL带到线上从而致使服务质量降低。它不只可以尽量地提升线上代码质量，还能避免一些因为人为疏漏而带来的隐患。

下载安装

SOAR使用Go语言编写，自然具有操做系统跨平台属性，您能够在Github上的Release版本按照对应操做系统直接下载编译好的二进制文件使用。若是您是资深定制用户也能够“点击此处”下载代码，按下图所示编译安装。

二进制安装

源码安装

使用指南

快速上手

安装完成以后无需进行任何配置，只须要执行下面这条命令，就能够马上生成一份Markdown格式的SQL评审报告，根据报告中的建议对SQL进行修改。

使用配置

SOAR提供了丰富的配置参数，能够根据不一样的使用场景指定不一样的配置项来定制私有的评审建议。不过您也无须担忧这些配置会对使用带来困扰，大部分配置选项是为有特殊需求用户准备的，即便不作任何配置也可以体验到SOAR的基础的功能。

SOAR的配置文件为YAML[1]格式，在通常状况下只须要配置online-dsn, test-dsn, log-output等少数几个参数，您就能够体验到SOAR提供的绝大部分的功能了。

下面我将介绍一下SOAR中经常使用的一些基础配置。

一、配置环境

因为不少的功能须要数据库的元数据来进行辅助判断，因此当不指定数据库环境的时候，不少功能将会采起降级的策略，因此咱们强烈建议您在配置文件中指定相关数据库环境。为了保护线上数据库的安全，咱们将数据库环境区分为线上和测试两种环境，可是这并不意味着您必定须要两个数据库环境，但至少建议您指定一个测试环境。

这里须要注意的是，由于咱们会在测试环境中作一些风险相对较高的操做，为了防止用户因为配置疏忽致使线上数据受损，咱们添加了allow-online-as-test参数来保证您确实是但愿将线上环境作为测试环境来使用。因此当您指定的两个集成环境相同时，请指定allow-online-as-test为true，不然SOAR将不会进行评审。

二、输出格式

SOAR自身支持了很是丰富的输出格式，除了默认的Markdown格式之外，SOAR还支持以 HTML或JSON的格式进行输出。

SOAR自带的一些工具也会以report-type的形式提供。好比SQL重写，EXPLAIN分析，SQL 指纹，SQL美化等15种输出格式，每一种report-type都对应着不一样的功能。你能够经过以下命令查看SOAR支持的输出类型。

三、获取帮助

除了上述提到的这些功能，SOAR还提供了不少其余的配置项，因为篇幅所限，具体详情您能够到SOAR项目文档中查看。使用上若是碰到疑问，能够到这里[2]提交Issue，或在Gitter[3]中联系咱们。

场景介绍

场景	线上环境	测试环境	应用类型
场景一	有	有	平常优化，完整的建议，推荐
场景二	无	有	新申请资源，环境初始化测试
场景三	无	无	盲测，试用，无EXPLAN和索引建议
场景四	有	无	用线上环境当测试环境，不推荐

场景一

这个场景是咱们平常工做中最多见的场景，它主要应用于线上服务平常建立表或表结构表更。

SOAR对SQL进行分析时，会先从SQL语句中获取基本信息，而后将全部涉及到的库表结构元数据从线上环境中获取，并同步到测试环境中进行更进一步的分析。在这个场景下，SOAR能提供最全面的功能支持。不只可以输出110多项SQL检查，还可以对涉及到的库表进行索引分析，并且还能够输出EXPLAIN、PROFILE等信息来辅助DBA或开发者进行性能调优和问题定位。SQL改写也会依赖元数据的支持，在此场景下的功能是支持的最全面的。

场景二

这个场景适用于首次申请数据库资源的状况，此时尚未已经存在的线上环境与之相对应。

在这个场景下，SQL文件主要包含的是建库建表语句，SOAR会根据DDL生成相应的测试环境，并从该环境中获取元数据进行优化分析。

场景三

在这一场景下因为没有配置线上环境和测试环境依赖，缺乏不少分析时必要的元数据，且没法获取EXPLAIN等信息，在这种状况下SOAR将会进行功能降级，只给予部分不依赖数据库环境才能给出的建议（绝大部分的启发式建议和小部分SQL改写）。

虽然在这个场景下服务的功能并不全面，但执行速度也是最快的，这种场景依然能提供110多种启发式建议，特别适合于对SQL自己的检测，好比做为一个本地化的SQL Linter IDE插件。

场景四

这一场景其实与场景二是同样的，在这一场景下只配置了线上环境，且开启了容许线上环境做为测试环境。那么在不指定测试环境的状况下SOAR将会把测试环境也指向线上环境。

SOAR在进行评审时，为了保证多个客户端可以同时在一个环境内进行评审，会在测试环境中生成一个临时数据库，评审正常结束后再将该临时数据库删除。因此咱们很是不建议将线上数据库环境作为测试环境，防止在某些未知的极端条件下对数据库产生严重影响。

参考

[1]https://en.wikipedia.org/wiki/YAML

[2]https://github.com/XiaoMi/soar/issues

[3]https://gitter.im/xiaomi-dba/soar

本文首发于公众号“小米运维”，点击查看原文