这篇文章将为大家详细讲解有关如何进行SOAR IDE插件的安装与使用,文章内容质量较高,因此小编分享给大家做个参考,希望大家阅读完这篇文章后对相关知识有一定的了解。
创新互联建站主营安次网站建设的网络公司,主营网站建设方案,成都app开发,安次h5微信小程序搭建,安次网站营销推广欢迎安次等地区企业咨询
下面将介绍SOAR插件的基本实现以及现在已经实现的插件的安装与使用。
SOAR(SQL Optimizer And Rewriter)是小米近期开源的SQL智能优化改写工具,开源第一周就取得了2000+星的成绩。我们开发SOAR的目的并不仅仅希望对DBA能够提供帮助,也希望能够协助广大的SQL开发者更容易的写出高质量的SQL。SOAR借鉴了其他SQLint[1]的思路,也提供了三种编辑器插件,可以用来集成到Vim,Sublime Text,VS Code等代码编辑器中。
将report-type指定为lint时,SOAR会将评审内容以SQLint的样形输出。为了便于展示,lint模式下只保留了文件名、行号、建议类型和建议摘要等少数信息。下面是一个简单的例子。
$ cat file.sql select * from test $ soar -report-type lint -query file.sql file.sql:1:CLA.001
最外层SELECT未指定WHERE条件 file.sql:1:COL.001 不建议使用SELECT * 类型查询
Vim插件Vim插件我们选择了在知名的Syntastic[2]插件基础上进行增补,这就要求用户首先安装Syntastic插件,它的安装方法在官方文档[3]中有详细描述,这里不再过多赘述。让我们来直接看看要怎样配置SOAR生效。
确保soar二进制文件在可执行文件查找路径$PATH下
确保soar二进制文件具有可执行权限,chmod a+x soar
将源码中的doc/example/soar.vim文件拷贝至${SyntasticInstalledPath}/syntax_checkers/sql目录下,例如笔者使用bundle来管理Vim插件,于是将soar.vim文件拷贝至~/.vim/bundle/pristine/syntastic/syntax_checkers/sql目录
修改${SyntasticInstalledPath}/plugin/syntastic/registry.vim注册文件,增加sql类型文件的检查工具,如'sql':['soar','sqlint']
更新Vim配置~/.vimrc,允许Syntastic默认弹窗
set statusline+=%#warningmsg# set statusline+=%{SyntasticStatuslineFlag()} set statusline+=%* let g:syntastic_always_populate_loc_list = 1
let g:syntastic_auto_loc_list = 1
let g:syntastic_check_on_open = 1
let g:syntastic_check_on_wq = 0
一切顺利的话使用Vim打开一个文件每次保存时您就能看到SOAR给出的建议了。
Sublime Text3插件
与Vim插件的思路相同,在Sublime Text3中,我们选择在SublimeLinter[4]的基础上进行拓展。由于代码刚刚开源,SublimeLinter-soar[5]在PackageControlChannel相关Pull Request[6]尚未被合并完成,所以目前暂时不能通过Sublime Text3自带的PackageControl进行安装。
虽然不能使用简便的方式进行安装,但是如果您想立刻体验SOAR的Sublime Text3插件,可以按照下列方式手动进行安装:
确保soar二进制文件具有可执行权限,chmod a+x soar
根据官方文档[7]安装SublimeLinter
打开Sublime Text3的插件相关目录:Preferences -> Browse Packages…
在该目录下载代码
git clone https://github.com/liipx/SublimeLinter-soar.git
配置个人相关参数:点击 Preferences -> PackageSettings -> SublimeLinter -> Settings,将下列内容修改后加入到个人配置中
// SublimeLinter Settings - User{ "linters": { "soar": { "soar_path":"your_soar_path" }, }, }
重新启动Sublim Text3后,打开一个SQL文件就看到SOAR给出的建议了。
VS Code插件
VS Code的插件功能十分强大,对于语言类的功能拓展,微软采用了一种称为Language Server Protocol(LSP)的实现方式。这种协议标准化了语言工具和代码编辑器之间的通信方式,感兴趣的同学可以通过官方文档[8]进行更深入的了解。
SOAR的VS Code插件目前在Github[9]上管理,尚未发布到微软的应用市场,无法直接在微软官方网页上点击安装。想尝鲜且拥有TypeScript及VS Code插件开发相关经验的同学可以通过以下方式来手动安装体验该插件。其他同学可以静静等待微软应用市场审批通过即可享受一键安装的便利了。
确保soar二进制文件具有可执行权限,chmod a+x soar
确保soar二进制文件在可执行文件查找路径$PATH下
找到VS Code插件安装路径,Mac/Linux用户一般为${HOME}/.vscode/extensions,Windows用户一般为%USERPROFILE%\.vscode\extensions
进入该路径下载代码
git clone https://github.com/liipx/vscode-extension-soar
参考项目README[10]编译Client与Server目录下的TypeScript程序
重启VS Code,打开一个SQL文件查看是否生效
关于如何进行SOAR IDE插件的安装与使用就分享到这里了,希望以上内容可以对大家有一定的帮助,可以学到更多知识。如果觉得文章不错,可以把它分享出去让更多的人看到。