Repository: XiaoMi/soar Branch: dev Commit: 5ed8574ae59f Files: 229 Total size: 1.9 MB Directory structure: gitextract_vewet1zv/ ├── .editorconfig ├── .github/ │ ├── ISSUE_TEMPLATE/ │ │ ├── bug_report.md │ │ ├── feature_request.md │ │ └── question.md │ └── pull_request_template.md ├── .gitignore ├── .travis.yml ├── CHANGES.md ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── LICENSE ├── Makefile ├── NOTICE.txt ├── README.md ├── README_EN.md ├── VERSION ├── advisor/ │ ├── doc.go │ ├── explainer.go │ ├── explainer_test.go │ ├── heuristic.go │ ├── heuristic_test.go │ ├── index.go │ ├── index_test.go │ ├── rules.go │ ├── rules_test.go │ └── testdata/ │ ├── TestDigestExplainText.golden │ ├── TestIndexAdviseNoEnv.golden │ ├── TestListHeuristicRules.golden │ ├── TestListTestSQLs.golden │ └── TestMergeConflictHeuristicRules.golden ├── ast/ │ ├── doc.go │ ├── meta.go │ ├── meta_test.go │ ├── node_array.go │ ├── pretty.go │ ├── pretty_test.go │ ├── rewrite.go │ ├── rewrite_test.go │ ├── testdata/ │ │ ├── TestCompress.golden │ │ ├── TestFormat.golden │ │ ├── TestGetQuotedString.golden │ │ ├── TestLeftNewLines.golden │ │ ├── TestListRewriteRules.golden │ │ ├── TestMergeAlterTables.golden │ │ ├── TestNewLines.golden │ │ ├── TestPretty.golden │ │ ├── TestPrintPrettyStmtNode.golden │ │ ├── TestPrintPrettyVitessStmtNode.golden │ │ ├── TestQueryType.golden │ │ ├── TestSchemaMetaInfo.golden │ │ ├── TestSplitStatement.golden │ │ ├── TestStmtNode2JSON.golden │ │ ├── TestTokenize.golden │ │ ├── TestTokenizer.golden │ │ └── TestVitessStmtNode2JSON.golden │ ├── tidb.go │ ├── tidb_test.go │ ├── token.go │ ├── token_test.go │ ├── vitess.go │ └── vitess_test.go ├── cmd/ │ └── soar/ │ ├── doc.go │ ├── soar.go │ ├── soar_test.go │ ├── testdata/ │ │ ├── Test_Main.golden │ │ └── Test_Main_verboseInfo.golden │ └── tool.go ├── common/ │ ├── cases.go │ ├── chardet.go │ ├── chardet_test.go │ ├── config.go │ ├── config_test.go │ ├── doc.go │ ├── example_test.go │ ├── logger.go │ ├── logger_test.go │ ├── markdown.go │ ├── markdown_test.go │ ├── meta.go │ ├── meta_test.go │ ├── signal.go │ ├── signal_test.go │ ├── testdata/ │ │ ├── TestJSONFind.golden │ │ ├── TestListReportTypes.golden │ │ ├── TestMarkdown2Html.golden │ │ ├── TestMarkdown2Html.md │ │ ├── TestMarkdownHTMLHeader.golden │ │ ├── TestParseDSN.golden │ │ ├── TestPrintConfiguration.golden │ │ ├── TestRemoveBOM.golden │ │ ├── TestStringStorageReq.golden │ │ ├── UTF-8.bom.sql │ │ ├── chardet_BIG5.txt │ │ ├── chardet_GB-18030.txt │ │ └── chardet_UTF-8.txt │ ├── tricks.go │ ├── tricks_test.go │ └── version.go ├── database/ │ ├── doc.go │ ├── explain.go │ ├── explain_test.go │ ├── mysql.go │ ├── mysql_test.go │ ├── privilege.go │ ├── privilege_test.go │ ├── profiling.go │ ├── profiling_test.go │ ├── sampling.go │ ├── show.go │ ├── show_test.go │ ├── testdata/ │ │ ├── TestEscape.golden │ │ ├── TestExplain.golden │ │ ├── TestExplainInfoTranslator.golden │ │ ├── TestFindColumn.golden │ │ ├── TestFormatProfiling.golden │ │ ├── TestFormatTrace.golden │ │ ├── TestMySQLExplainQueryCost.golden │ │ ├── TestMySQLExplainWarnings.golden │ │ ├── TestPrintMarkdownExplainTable.golden │ │ ├── TestRemoveSQLComments.golden │ │ ├── TestShowColumns.golden │ │ ├── TestShowCreateDatabase.golden │ │ ├── TestShowCreateTable.golden │ │ ├── TestShowIndex.golden │ │ ├── TestShowReference.golden │ │ ├── TestShowTables.golden │ │ └── TestTrace.golden │ ├── trace.go │ └── trace_test.go ├── deps.sh ├── doc/ │ ├── FAQ.md │ ├── FAQ_en.md │ ├── cheatsheet.md │ ├── cheatsheet_en.md │ ├── comparison.md │ ├── comparison_en.md │ ├── config.md │ ├── editor_plugin.md │ ├── environment.md │ ├── example/ │ │ ├── digest_pt.py │ │ ├── metalinter.json │ │ ├── metalinter.sh │ │ ├── metalinter.txt │ │ ├── revive.toml │ │ ├── slow.log.digest │ │ └── soar.vim │ ├── explain.md │ ├── heuristic.md │ ├── images/ │ │ └── logo.ascii │ ├── indexing.md │ ├── install.md │ ├── install_en.md │ ├── js/ │ │ └── pretty.js │ ├── report_type.md │ ├── rewrite.md │ ├── roadmap.md │ ├── structure.md │ ├── thanks.md │ ├── thanks_en.md │ └── themes/ │ ├── foghorn.css │ ├── ghostwriter.css │ ├── github-dark.css │ ├── github.css │ ├── godspeed.css │ ├── markdown-alt.css │ ├── markdown.css │ ├── markdown5.css │ ├── markdown6.css │ ├── markdown7.css │ ├── markdown8.css │ ├── markdown9.css │ ├── markedapp-byword.css │ ├── new-modern.css │ ├── radar.css │ ├── screen.css │ ├── solarized-dark.css │ ├── solarized-light.css │ ├── torpedo.css │ └── vostok.css ├── doc.go ├── env/ │ ├── doc.go │ ├── env.go │ ├── env_test.go │ └── testdata/ │ └── TestNewVirtualEnv.golden ├── etc/ │ ├── soar.blacklist │ └── soar.yaml ├── genver.sh ├── go.mod ├── go.sum ├── retool-install.sh ├── revive.toml ├── test/ │ ├── env.bats │ ├── fixture/ │ │ ├── test_Check_Max_Join_Table_Count_Default.golden │ │ ├── test_Check_Max_Join_Table_Count_Overflow.golden │ │ ├── test_Check_Soar_Delimiter.golden │ │ ├── test_Check_Soar_Max_Column_Count.golden │ │ ├── test_Check_Soar_SQL_Fingerprint.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Alwaystrue_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Countstar_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Delimiter_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Distinctstar_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Dml2select_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Dmlorderby_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Having_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Mergealter_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Or2in_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Orderbynull_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Rmparenthesis_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Standard_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Star2columns_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Truncate_.golden │ │ ├── test_Check_Soar_SQL_Rewrite_Unionall_.golden │ │ ├── test_Check_Soar_SQL_pretty_And_Compress_.golden │ │ ├── test_Check_get_tables_from_SQL.golden │ │ ├── test_Check_soar_for_pipe_input.golden │ │ ├── test_Check_soar_query_for_input_file.golden │ │ ├── test_Check_soar_report_for_html.golden │ │ ├── test_Check_soar_report_for_json.golden │ │ ├── test_Check_soar_report_for_markdown.golden │ │ ├── test_Check_the_default_config_of_the_changes.golden │ │ ├── test_Run_all_test_cases.golden │ │ ├── test_Run_default_printconfig_cases.golden │ │ └── test_Simple_Query_Optimizer.golden │ ├── main.bats │ ├── other.bats │ ├── query.bats │ ├── sql/ │ │ └── README.md │ └── test_helper.bash └── tools.json ================================================ FILE CONTENTS ================================================ ================================================ FILE: .editorconfig ================================================ [*] end_of_line = lf insert_final_newline = true charset = utf-8 # tab_size = 4 spaces [*.go] indent_style = tab indent_size = 4 trim_trailing_whitespace = true ================================================ FILE: .github/ISSUE_TEMPLATE/bug_report.md ================================================ --- name: Bug Report about: You're experiencing an issue with SOAR that is different than the documented behavior. --- Please answer these questions before submitting your issue. Thanks! 1. What did you do? If possible, provide a recipe for reproducing the error. 2. What did you expect to see? 3. What did you see instead? 4. What version of are you using (`soar -version`)? ================================================ FILE: .github/ISSUE_TEMPLATE/feature_request.md ================================================ --- name: Feature Request about: If you have something you think SOAR could improve or add support for. --- Please search the existing issues for relevant feature requests, add upvotes to pre-existing requests. #### Feature Description A written overview of the feature. #### Use Case(s) Any relevant use-cases that you see. ================================================ FILE: .github/ISSUE_TEMPLATE/question.md ================================================ --- name: Question about: If you have a question, please check out our other community resources instead of opening an issue. --- Issues on GitHub are intended to be related to bugs or feature requests, so we recommend using our other community resources instead of asking here. - [SOAR Doc](http://github.com/XiaoMi/soar/blob/master/README.md) - Any other questions can be asked in the community [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/xiaomi-dba/soar) ================================================ FILE: .github/pull_request_template.md ================================================ ### What problem does this PR solve? ### What is changed and how it works? ### Check List Tests - Unit test - Integration test - Manual test (add detailed scripts or steps below) - No code Code changes - Has exported function/method change - Has exported variable/fields change - Has interface methods change - Has persistent data change Side effects - Possible performance regression - Increased code complexity - Breaking backward compatibility ================================================ FILE: .gitignore ================================================ bin/ release/ test/tmp/ doc/blueprint/ *.iml *.swp *.log coverage.* y.output .DS_Store .vscode/ .idea _tools/ TestMarkdown2Html.html ================================================ FILE: .travis.yml ================================================ language: go go: - "1.12.x" - "1.13.x" sudo: required go_import_path: github.com/XiaoMi/soar dist: xenial services: - docker before_install: - docker pull mysql - sudo add-apt-repository ppa:duggan/bats --yes - sudo apt-get update -qq - sudo apt-get install -qq bats script: - make build - make docker - make cover - make test-cli ================================================ FILE: CHANGES.md ================================================ # CHANGELOG ## 2019-08 - Fix RuleImplicitConversion(ARG.003) with INT and DECIMAL - Fix RuleImplicitConversion duplicate suggest when use IN () operator ## 2019-07 - Fix #213 CLA.001 NO WHERE CONDITION - Fix PRIMARY key append to multi column index - fingerprint verbose mode add id ## 2019-05 - Fix issue #208 14c19f4 regression bug - Add max_execution_time hint for explain query - Fix #205 create index rewrite error ## 2019-04 - Add test case for STA.004 - RuleSpaceWithQuote add list range check - Fix #199 -report-type=json add score - Fix #98 JSON result format - Fix index col compare case sensitive bug - Fix ARG.008 cases: col = 1 OR col IS NULL - Fix tokenize bug with multi type of quote ## 2019-02 - add go.mod for go1.11 - add new -report-type query-type - add new heuristic rule SEC.004 - fix #196 wrong ip/password will cause soar -check-config hangup ## 2019-01 - add mysql environment verbose info - add JSONFind function, which support JSON iterate - add new test database `world_x` - SplitStatement support optimizer hint `/*+xxx */` - include [bats](https://github.com/bats-core/bats-core) bash auto test framework - fix #173 with JSONFind `WHERE col = col = '' and col1 = 'xx'` - fix #184 table status field datatype overflow - fix explain result with multi rows error - fix #178 JSON datatype only support utf8mb4 ## 2018-12 - replace mysql database driver mymysql with go-sql-driver - add new -report-type [ast-json, tiast-json] - command line dsn args support '@', '/', ':' in password - add new heuristic rule RES.009, "SELECT * FROM tbl WHERE col = col = 'abc'" - add new heuristic rule RuleColumnNotAllowType COL.018 - add string escape function for security - fix #122 single table select * don't auto-complete table name - fix #171 support socket access type - fix #58 sampling not deal with NULL able string - fix #172 compatible with mysql 5.1, which explain has no Index_Comment column - fix #163 column.Tp may be nil, which may raise panic - fix #151 bit type not config as int, when two columns compare will give ARG.003 suggestion. - ## 2018-11 - add all third-party lib into vendor - support `-report-type chardet` - add more heuristic rules: TBL.008, KEY.010, ARG.012, KWR.004 - add -cleanup-test-database command-line arg - add -check-config parameter - fix #146 pretty cause syntax error - fix #140 COL.012, COL.015 NULL type about TEXT/BLOB - fix #141 empty output when query execute failed on mysql - fix #89 index advisor give wrong database name, `optimizer_xx` - fix #121 RemoveSQLComment trim space - fix #120 trimspace before check single line comment - fix mac os stdout print buffer truncate - fix -config arg load file error - fix #116 SplitStatement check if single comment line is in multi-line sql. - fix #112 multi-line comment will cause line counter error, when -report-type=lint - fix #110 remove bom before auditing - fix #104 case insensitive regex @ CLA.009 - fix #87 RuleImplicitConversion value type mismatch check bug - fix #38 always true where condition check - abandon stdin terminal interactive mod, which may seems like hangup ## 2018-10 - Fix SplitStatement multistatement eof bug #66 - Fix pretty func hangup issue #47 - Fix some foolish code spell error - Use travis for CI - Fix Go 1.8 default GOPATH compatible issue BUG #5 - 2018-10-20 开源先锋日(OSCAR)对外正式开源发布代码 ## 2018-09 - 修复多个启发式建议不准确BUG,优化部分建议文案使得建议更清晰 - 基于 TiDB Parser 完善多个 DDL 类型语句的建议 - 新增lint report-type类型,支持Vim Plugin优化建议输出 - 更新整理项目文档,开源准备 - 2018-09-21 Gdevops SOAR首次对外进行技术分享宣传 ## 2018-08 - 利用 docker 临时容器进行 daily 测试 - 添加main_test全功能回归测试 - 修复在测试中发现的问题 - mymysql 合并 MySQL8.0 相关PR,修改vendor依赖 - 改善HeuristicRule中的文案 - 持续集成Vitess Parser的改进 - NewQuery4Audit 结构体中引入 TiDB Parser - 通过TiAST完成大量与 DDL 相关的TODO - 修改heuristic rules检查的返回值,提升拓展性 - 建议中引入Position,用于表示建议产生于SQL的位置 - 新增多个HeuristicRule - Makefile中添加依赖检查,优化Makefile中逻辑,添加新功能 - 优化gometalinter性能,引入新的代码质量检测工具,提升代码质量 - 引入 retool 用于管理依赖的工具 - 优化 doc 文档 ## 2018-07 - 补充文档,添加项目LOGO - 改善代码质量提升测试覆盖度 - mymysql升级,支持MySQL 8.0 - 提供remove-comment小工具 - 提供索引重复检查小工具 - HeuristicRule 新增 RuleSpaceAfterDot - 支持字符集和Collation不相同时的隐式数据类型转换的检查 ## 2018-06 - 支持更多的SQL Rewrite规则 - 添加SQL执行超时限制 - 索引优化建议支持对约束的检查 - 修复数据采样中 NULL 值处理不正确的问题 - Explain 支持 last_query_cost ## 2018-05 - 添加数据采样功能 - 添加语句执行安全检查 - 支持DDL语法检查 - 支持DDL在测试环境的执行 - 支持隐式数据类型转换检查 - 支持索引去重 - 索引优化建议支持前缀索引 - 支持SQL Pretty输出 ## 2018-04 - 支持语法检查 - 支持测试环境 - 支持MySQL原数据的获取 - 支持基于数据库环境信息给予索引优化建议 - 支持不依赖数据库原信息的简单索引优化建议 - 添加日志模块 - 引入配置文件 ## 2018-03 - 基本架构设计 - 添加大量底层函数用于处理AST - 添加Insert、Delete、Update 转写成 Select 的基本函数 - 支持MySQL Explain信息输出 ================================================ FILE: CODE_OF_CONDUCT.md ================================================ # Contributor Covenant Code of Conduct ## Our Pledge In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. ## Our Standards Examples of behavior that contributes to creating a positive environment include: * Using welcoming and inclusive language * Being respectful of differing viewpoints and experiences * Gracefully accepting constructive criticism * Focusing on what is best for the community * Showing empathy towards other community members Examples of unacceptable behavior by participants include: * The use of sexualized language or imagery and unwelcome sexual attention or advances * Trolling, insulting/derogatory comments, and personal or political attacks * Public or private harassment * Publishing others' private information, such as a physical or electronic address, without explicit permission * Other conduct which could reasonably be considered inappropriate in a professional setting ## Our Responsibilities Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful. ## Scope This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. ## Enforcement Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at zhangliang3@xiaomi.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. ## Attribution This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version] [homepage]: http://contributor-covenant.org [version]: http://contributor-covenant.org/version/1/4/ ================================================ FILE: CONTRIBUTING.md ================================================ Ask questions at [Gitter](https://gitter.im/xiaomi-dba/soar). [Open an issue](https://github.com/xiaomi/soar/issues/new) to discuss your plans before doing any work on SOAR. ================================================ FILE: LICENSE ================================================ Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ================================================ FILE: Makefile ================================================ # This how we want to name the binary output # # use checkmake linter https://github.com/mrtazz/checkmake # $ checkmake Makefile # BINARY=soar GOPATH ?= $(shell go env GOPATH) GO111MODULE:=auto export GO111MODULE # Ensure GOPATH is set before running build process. ifeq "$(GOPATH)" "" $(error Please set the environment variable GOPATH before running `make`) endif PATH := ${GOPATH}/bin:$(PATH) GCFLAGS=-gcflags "all=-trimpath=${GOPATH}" VERSION_TAG := $(shell git describe --tags --always) VERSION_VERSION := $(shell git log --date=iso --pretty=format:"%cd" -1) $(VERSION_TAG) VERSION_COMPILE := $(shell date +"%F %T %z") by $(shell go version) VERSION_BRANCH := $(shell git rev-parse --abbrev-ref HEAD) VERSION_GIT_DIRTY := $(shell git diff --no-ext-diff 2>/dev/null | wc -l | awk '{print $1}') VERSION_DEV_PATH:= $(shell pwd) LDFLAGS=-ldflags="-s -w -X 'github.com/XiaoMi/soar/common.Version=$(VERSION_VERSION)' -X 'github.com/XiaoMi/soar/common.Compile=$(VERSION_COMPILE)' -X 'github.com/XiaoMi/soar/common.Branch=$(VERSION_BRANCH)' -X 'github.com/XiaoMi/soar/common.GitDirty=$(VERSION_GIT_DIRTY)' -X 'github.com/XiaoMi/soar/common.DevPath=$(VERSION_DEV_PATH)'" # These are the values we want to pass for VERSION and BUILD BUILD_TIME=`date +%Y%m%d%H%M` COMMIT_VERSION=`git rev-parse HEAD` # colors compatible setting CRED:=$(shell tput setaf 1 2>/dev/null) CGREEN:=$(shell tput setaf 2 2>/dev/null) CYELLOW:=$(shell tput setaf 3 2>/dev/null) CEND:=$(shell tput sgr0 2>/dev/null) # Add mysql version for testing `MYSQL_RELEASE=percona MYSQL_VERSION=5.7 make docker` # MySQL 5.1 `MYSQL_RELEASE=vsamov/mysql-5.1.73 make docker` # MYSQL_RELEASE: mysql, percona, mariadb ... # MYSQL_VERSION: latest, 8.0, 5.7, 5.6, 5.5 ... # use mysql:latest as default MYSQL_RELEASE := $(or ${MYSQL_RELEASE}, ${MYSQL_RELEASE}, mysql) MYSQL_VERSION := $(or ${MYSQL_VERSION}, ${MYSQL_VERSION}, latest) .PHONY: all all: | fmt build .PHONY: go_version_check GO_VERSION_MIN=1.12 # Parse out the x.y or x.y.z version and output a single value x*10000+y*100+z (e.g., 1.9 is 10900) # that allows the three components to be checked in a single comparison. VER_TO_INT:=awk '{split(substr($$0, match ($$0, /[0-9\.]+/)), a, "."); print a[1]*10000+a[2]*100+a[3]}' go_version_check: @echo "$(CGREEN)Go version check ...$(CEND)" @if test $(shell go version | $(VER_TO_INT) ) -lt \ $(shell echo "$(GO_VERSION_MIN)" | $(VER_TO_INT)); \ then printf "go version $(GO_VERSION_MIN)+ required, found: "; go version; exit 1; \ else echo "go version check pass"; fi # Dependency check .PHONY: deps deps: @echo "$(CGREEN)Dependency check ...$(CEND)" @bash ./deps.sh # The retool tools.json is setup from retool-install.sh # some packages download need more open internet access retool sync #retool do gometalinter.v2 --install # Code format .PHONY: fmt fmt: go_version_check @echo "$(CGREEN)Run gofmt on all source files ...$(CEND)" @echo "gofmt -l -s -w ..." @ret=0 && for d in $$(go list -f '{{.Dir}}' ./... | grep -v /vendor/); do \ gofmt -l -s -w $$d/*.go || ret=$$? ; \ done ; exit $$ret # Run golang test cases .PHONY: test test: @echo "$(CGREEN)Run all test cases ...$(CEND)" @go test $(LDFLAGS) -timeout 10m -race ./... @echo "test Success!" # Rule golang test cases with `-update` flag .PHONY: test-update test-update: @echo "$(CGREEN)Run all test cases with -update flag ...$(CEND)" @go test $(LDFLAGS) ./... -update @echo "test-update Success!" # Using bats test framework run all cli test cases # https://github.com/sstephenson/bats .PHONY: test-cli test-cli: build @echo "$(CGREEN)Run all cli test cases ...$(CEND)" bats ./test @echo "test-cli Success!" # Code Coverage # colorful coverage numerical >=90% GREEN, <80% RED, Other YELLOW .PHONY: cover cover: test @echo "$(CGREEN)Run test cover check ...$(CEND)" @go test $(LDFLAGS) -coverpkg=./... -coverprofile=coverage.data ./... | column -t @go tool cover -html=coverage.data -o coverage.html @go tool cover -func=coverage.data -o coverage.txt @tail -n 1 coverage.txt | awk '{sub(/%/, "", $$NF); \ if($$NF < 80) \ {print "$(CRED)"$$0"%$(CEND)"} \ else if ($$NF >= 90) \ {print "$(CGREEN)"$$0"%$(CEND)"} \ else \ {print "$(CYELLOW)"$$0"%$(CEND)"}}' # Builds the project build: fmt @echo "$(CGREEN)Building ...$(CEND)" @mkdir -p bin @ret=0 && for d in $$(go list -f '{{if (eq .Name "main")}}{{.ImportPath}}{{end}}' ./...); do \ b=$$(basename $${d}) ; \ go build ${LDFLAGS} ${GCFLAGS} -o bin/$${b} $$d || ret=$$? ; \ done ; exit $$ret @echo "build Success!" # Installs our project: copies binaries install: build @echo "$(CGREEN)Install ...$(CEND)" go install ./... @echo "install Success!" # Generate doc use -list* command .PHONY: doc doc: build @echo "$(CGREEN)Auto generate doc ...$(CEND)" ./bin/soar -list-heuristic-rules > doc/heuristic.md ./bin/soar -list-rewrite-rules > doc/rewrite.md ./bin/soar -list-report-types > doc/report_type.md # Add or change a heuristic rule .PHONY: heuristic heuristic: doc @echo "$(CGREEN)Update Heuristic rule golden files ...$(CEND)" go test github.com/XiaoMi/soar/advisor -v -update -run TestListHeuristicRules go test github.com/XiaoMi/soar/advisor -v -update -run TestMergeConflictHeuristicRules docker stop soar-mysql 2>/dev/null || true # Update all vendor .PHONY: vendor vendor: vitess pingcap-parser # gometalinter .PHONY: lint lint: build @echo "$(CGREEN)Run linter check ...$(CEND)" CGO_ENABLED=0 GOMODULE111=off retool do gometalinter.v2 -j 1 --config doc/example/metalinter.json ./... GOMODULE111=off retool do revive -formatter friendly --exclude vendor/... -config doc/example/revive.toml ./... GOMODULE111=off retool do golangci-lint --tests=false run @echo "gometalinter check your code is pretty good" .PHONY: release release: build @echo "$(CGREEN)Cross platform building for release ...$(CEND)" @mkdir -p release @for GOOS in linux windows; do \ for GOARCH in amd64; do \ for d in $$(go list -f '{{if (eq .Name "main")}}{{.ImportPath}}{{end}}' ./...); do \ b=$$(basename $${d}) ; \ echo "Building $${b}.$${GOOS}-$${GOARCH} ..."; \ CGO_ENABLED=0 GOOS=$${GOOS} GOARCH=$${GOARCH} go build ${GCFLAGS} ${LDFLAGS} -v -o release/$${b}.$${GOOS}-$${GOARCH} $$d 2>/dev/null ; \ done ; \ done ;\ done @for GOOS in darwin; do \ for GOARCH in arm64 amd64; do \ for d in $$(go list -f '{{if (eq .Name "main")}}{{.ImportPath}}{{end}}' ./...); do \ b=$$(basename $${d}) ; \ echo "Building $${b}.$${GOOS}-$${GOARCH} ..."; \ CGO_ENABLED=0 GOOS=$${GOOS} GOARCH=$${GOARCH} go build ${GCFLAGS} ${LDFLAGS} -v -o release/$${b}.$${GOOS}-$${GOARCH} $$d 2>/dev/null ; \ done ; \ done ;\ done .PHONY: docker docker: @echo "$(CGREEN)Build mysql test environment ...$(CEND)" @docker stop soar-mysql 2>/dev/null || true @docker wait soar-mysql 2>/dev/null >/dev/null || true @echo "docker run --name soar-mysql $(MYSQL_RELEASE):$(MYSQL_VERSION)" @docker run --name soar-mysql --rm -d \ -e MYSQL_ROOT_PASSWORD=1tIsB1g3rt \ -e MYSQL_DATABASE=sakila \ -p 3306:3306 \ -v `pwd`/test/sql/init.sql.gz:/docker-entrypoint-initdb.d/init.sql.gz \ $(MYSQL_RELEASE):$(MYSQL_VERSION) \ --sql-mode "" @echo "waiting for sakila database initializing " @timeout=180; while [ $${timeout} -gt 0 ] ; do \ if ! docker exec soar-mysql mysql --user=root --password=1tIsB1g3rt --host "127.0.0.1" --silent -NBe "do 1" >/dev/null 2>&1 ; then \ timeout=`expr $$timeout - 1`; \ printf '.' ; sleep 1 ; \ else \ echo "." ; echo "mysql test environment is ready!" ; break ; \ fi ; \ if [ $$timeout = 0 ] ; then \ echo "." ; echo "$(CRED)docker soar-mysql start timeout(180 s)!$(CEND)" ; exit 1 ; \ fi ; \ done .PHONY: docker-connect docker-connect: @docker exec -it soar-mysql mysql --user=root --password=1tIsB1g3rt --host "127.0.0.1" sakila # attach docker container with bash interactive mode .PHONY: docker-it docker-it: docker exec -it soar-mysql /bin/bash .PHONY: daily daily: | deps fmt vendor docker cover doc lint release install test-cli clean logo @echo "$(CGREEN)daily build finished ...$(CEND)" # vendor, docker will cost long time, if all those are ready, daily-quick will much more fast. .PHONY: daily-quick daily-quick: | deps fmt cover test-cli doc lint logo @echo "$(CGREEN)daily-quick build finished ...$(CEND)" .PHONY: logo logo: @echo "$(CYELLOW)" @cat doc/images/logo.ascii @echo "$(CEND)" # Cleans our projects: deletes binaries .PHONY: clean clean: @echo "$(CGREEN)Cleanup ...$(CEND)" go clean @for GOOS in darwin linux windows; do \ for GOARCH in 386 amd64; do \ rm -f ${BINARY}.$${GOOS}-$${GOARCH} ;\ done ;\ done rm -f ${BINARY} coverage.* test/tmp/* find . -name "*.log" -delete git clean -fi docker stop soar-mysql 2>/dev/null || true ================================================ FILE: NOTICE.txt ================================================ Copyright 2018 Xiaomi, Inc. All Rights Reserved. This product includes software developed by Xiaomi, Inc. (http://www.mi.com/). This product is licensed to you under the Apache License, Version 2.0 (the "License"). You may not use this product except in compliance with the License. ================================================ FILE: README.md ================================================ # ![SOAR](https://raw.githubusercontent.com/XiaoMi/soar/master/doc/images/logo.png) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/xiaomi-dba/soar) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](http://github.com/XiaoMi/soar/blob/master/LICENSE) [![Go Report Card](https://goreportcard.com/badge/github.com/XiaoMi/soar)](https://goreportcard.com/report/github.com/XiaoMi/soar) [![Build Status](https://travis-ci.org/XiaoMi/soar.svg?branch=master)](https://travis-ci.org/XiaoMi/soar) [![GoDoc](https://godoc.org/github.com/XiaoMi/soar?status.svg)](https://godoc.org/github.com/XiaoMi/soar) [文档](http://github.com/XiaoMi/soar/tree/master/doc) | [FAQ](http://github.com/XiaoMi/soar/blob/master/doc/FAQ.md) | [变更记录](http://github.com/XiaoMi/soar/blob/master/CHANGES.md) | [路线图](http://github.com/XiaoMi/soar/blob/master/doc/roadmap.md) | [English](http://github.com/XiaoMi/soar/blob/master/README_EN.md) ## SOAR SOAR(SQL Optimizer And Rewriter) 是一个对 SQL 进行优化和改写的自动化工具。 由小米人工智能与云平台的数据库团队开发与维护。 ## 功能特点 * 跨平台支持(支持 Linux, Mac 环境,Windows 环境理论上也支持,不过未全面测试) * 目前只支持 MySQL 语法族协议的 SQL 优化 * 支持基于启发式算法的语句优化 * 支持复杂查询的多列索引优化(UPDATE, INSERT, DELETE, SELECT) * 支持 EXPLAIN 信息丰富解读 * 支持 SQL 指纹、压缩和美化 * 支持同一张表多条 ALTER 请求合并 * 支持自定义规则的 SQL 改写 ## 快速入门 * [安装使用](http://github.com/XiaoMi/soar/blob/master/doc/install.md) * [体系架构](http://github.com/XiaoMi/soar/blob/master/doc/structure.md) * [配置文件](http://github.com/XiaoMi/soar/blob/master/doc/config.md) * [常用命令](http://github.com/XiaoMi/soar/blob/master/doc/cheatsheet.md) * [产品对比](http://github.com/XiaoMi/soar/blob/master/doc/comparison.md) * [路线图](http://github.com/XiaoMi/soar/blob/master/doc/roadmap.md) ## 交流与反馈 * 欢迎通过 Github Issues 提交问题报告与建议 * QQ 群:779359816(未满) 758940447(已满) * [Gitter](https://gitter.im/xiaomi-dba/soar) 推荐 ![xiaomi_sa](https://raw.githubusercontent.com/XiaoMi/soar/master/doc/images/xiaomi_sa.png) ## License [Apache License 2.0](https://github.com/XiaoMi/soar/blob/master/LICENSE). ================================================ FILE: README_EN.md ================================================ # ![SOAR](https://raw.githubusercontent.com/XiaoMi/soar/master/doc/images/logo.png) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/xiaomi-dba/soar) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](http://github.com/XiaoMi/soar/blob/master/LICENSE) [![Go Report Card](https://goreportcard.com/badge/github.com/XiaoMi/soar)](https://goreportcard.com/report/github.com/XiaoMi/soar) [![Build Status](https://travis-ci.org/XiaoMi/soar.svg?branch=master)](https://travis-ci.org/XiaoMi/soar) [![GoDoc](https://godoc.org/github.com/XiaoMi/soar?status.svg)](https://godoc.org/github.com/XiaoMi/soar) [Docs](http://github.com/XiaoMi/soar/tree/master/doc) | [FAQ](http://github.com/XiaoMi/soar/blob/master/doc/FAQ_en.md) | [中文](http://github.com/XiaoMi/soar/blob/master/README.md) ## SOAR SOAR (SQL Optimizer And Rewriter) is a tool, which can help SQL optimization and rewrite. It's developed and maintained by the DBA Team of Xiaomi AI&Cloud. ## Features * Cross-platform support, such as Linux, Mac, and Windows * Support Heuristic Rules Suggestion * Support Complicate SQL Indexing Optimize * Support EXPLAIN analyze for query plan * Support SQL fingerprint, compress and built-in pretty print * Support merge multi ALTER query into one SQL * Support self-config rewrite rules from SQL Rewrite * Suggestions were written in Chinese. But SOAR also gives many tools, which can be used without understanding Chinese. ## QuickStart * [Install](http://github.com/XiaoMi/soar/blob/master/doc/install_en.md) * [CheatSheet](http://github.com/XiaoMi/soar/blob/master/doc/cheatsheet_en.md) * [Related works](http://github.com/XiaoMi/soar/blob/master/doc/comparison_en.md) ## Communication * GitHub issues: bug reports, usage issues, feature requests * [Gitter](https://gitter.im/xiaomi-dba/soar) * IM QQ Group: 779359816 ## License [Apache License 2.0](https://github.com/XiaoMi/soar/blob/master/LICENSE). ================================================ FILE: VERSION ================================================ 0.11.0 ================================================ FILE: advisor/doc.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ // Package advisor contain heuristic rules, index rules and explain translator. package advisor ================================================ FILE: advisor/explainer.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package advisor import ( "fmt" "strings" "github.com/XiaoMi/soar/common" "github.com/XiaoMi/soar/database" ) var explainRuleID int // [EXP.XXX]Rule var explainRules map[string]Rule // [table_name]"suggest text" var tablesSuggests map[string][]string // explain建议的形式 // Item: EXP.XXX // Severity: L[0-8] // Summary: full table scan, not use index, full index scan... // Content: XX TABLE xxx // checkExplainSelectType func checkExplainSelectType(exp *database.ExplainInfo) { // 判断是否跳过不检查 if len(common.Config.ExplainWarnSelectType) == 1 { if common.Config.ExplainWarnSelectType[0] == "" { return } } else if len(common.Config.ExplainWarnSelectType) < 1 { return } if exp.ExplainFormat == database.JSONFormatExplain { // TODO // JSON 形式遍历分析不方便,转成 Row 格式也没有 SelectType 暂不处理 return } for _, v := range common.Config.ExplainWarnSelectType { for _, row := range exp.ExplainRows { if row.SelectType == v && v != "" { tablesSuggests[row.TableName] = append(tablesSuggests[row.TableName], fmt.Sprintf("SelectType:%s", row.SelectType)) } } } } // checkExplainAccessType 用户可以设置AccessType的建议级别,匹配到的查询会给出建议 func checkExplainAccessType(exp *database.ExplainInfo) { // 判断是否跳过不检查 if len(common.Config.ExplainWarnAccessType) == 1 { if common.Config.ExplainWarnAccessType[0] == "" { return } } else if len(common.Config.ExplainWarnAccessType) < 1 { return } rows := exp.ExplainRows if exp.ExplainFormat == database.JSONFormatExplain { // JSON形式遍历分析不方便,转成Row格式统一处理 rows = database.ConvertExplainJSON2Row(exp.ExplainJSON) } for _, v := range common.Config.ExplainWarnAccessType { for _, row := range rows { if row.AccessType == v && v != "" { tablesSuggests[row.TableName] = append(tablesSuggests[row.TableName], fmt.Sprintf("Scalability:%s", row.Scalability)) } } } } /* // TODO: func checkExplainPossibleKeys(exp *database.ExplainInfo) { } func checkExplainKeyLen(exp *database.ExplainInfo) { } func checkExplainKey(exp *database.ExplainInfo) { // 小于最小使用试用key数量 //return intval($explainResult) < intval($userCond); //explain-min-keys int } func checkExplainExtra(exp *database.ExplainInfo) { // 包含用户配置的逗号分隔关键词之一则提醒 // return self::contains($explainResult, $userCond); // explain-warn-extra []string } */ // checkExplainRef ... func checkExplainRef(exp *database.ExplainInfo) { rows := exp.ExplainRows if exp.ExplainFormat == database.JSONFormatExplain { // JSON形式遍历分析不方便,转成Row格式统一处理 rows = database.ConvertExplainJSON2Row(exp.ExplainJSON) } for i, row := range rows { if strings.Join(row.Ref, "") == "NULL" || strings.Join(row.Ref, "") == "" { if i == 0 && len(rows) > 1 { continue } tablesSuggests[row.TableName] = append(tablesSuggests[row.TableName], fmt.Sprintf("Ref:null")) } } } // checkExplainRows ... func checkExplainRows(exp *database.ExplainInfo) { // 判断是否跳过不检查 if common.Config.ExplainMaxRows <= 0 { return } rows := exp.ExplainRows if exp.ExplainFormat == database.JSONFormatExplain { // JSON形式遍历分析不方便,转成Row格式统一处理 rows = database.ConvertExplainJSON2Row(exp.ExplainJSON) } for _, row := range rows { if row.Rows >= common.Config.ExplainMaxRows { tablesSuggests[row.TableName] = append(tablesSuggests[row.TableName], fmt.Sprintf("Rows:%d", row.Rows)) } } } // checkExplainFiltered ... func checkExplainFiltered(exp *database.ExplainInfo) { // 判断是否跳过不检查 if common.Config.ExplainMaxFiltered <= 0.001 { return } rows := exp.ExplainRows if exp.ExplainFormat == database.JSONFormatExplain { // JSON形式遍历分析不方便,转成Row格式统一处理 rows = database.ConvertExplainJSON2Row(exp.ExplainJSON) } for i, row := range rows { if i == 0 && len(rows) > 1 { continue } if row.Filtered >= common.Config.ExplainMaxFiltered { tablesSuggests[row.TableName] = append(tablesSuggests[row.TableName], fmt.Sprintf("Filtered:%.2f%s", row.Filtered, "%")) } } } // ExplainAdvisor 基于explain信息给出建议 func ExplainAdvisor(exp *database.ExplainInfo) map[string]Rule { common.Log.Debug("ExplainAdvisor SQL: %v", exp.SQL) explainRuleID = 0 explainRules = make(map[string]Rule) tablesSuggests = make(map[string][]string) checkExplainSelectType(exp) checkExplainAccessType(exp) checkExplainFiltered(exp) checkExplainRef(exp) checkExplainRows(exp) // 打印explain table content := database.PrintMarkdownExplainTable(exp) if common.Config.ShowWarnings { content += "\n" + database.MySQLExplainWarnings(exp) } // 对explain table中各项难于理解的值做解释 cases := database.ExplainInfoTranslator(exp) // 添加last_query_cost if common.Config.ShowLastQueryCost { content += "\n" + database.MySQLExplainQueryCost(exp) } if content != "" { explainRules["EXP.000"] = Rule{ Item: "EXP.000", Severity: "L0", Summary: "Explain信息", Content: content, Case: cases, Func: (*Query4Audit).RuleOK, } } // TODO: 检查explain对应的表是否需要跳过,如dual,空表等 return explainRules } // DigestExplainText 分析用户输入的EXPLAIN信息 func DigestExplainText(text string) { // explain信息就不要显示完美了,美不美自己看吧。 common.Config.IgnoreRules = append(common.Config.IgnoreRules, "OK") if !IsIgnoreRule("EXP.") { explainInfo, err := database.ParseExplainText(text) if err != nil { common.Log.Error("main ParseExplainText Error: %v", err) return } expSuggest := ExplainAdvisor(explainInfo) _, output := FormatSuggest("", "", common.Config.ReportType, expSuggest) if common.Config.ReportType == "html" { fmt.Println(common.MarkdownHTMLHeader()) fmt.Println(common.Markdown2HTML(output)) } else { fmt.Println(output) } } } ================================================ FILE: advisor/explainer_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package advisor import ( "testing" "github.com/XiaoMi/soar/common" ) func TestDigestExplainText(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) var text = `+----+-------------+---------+-------+---------------------------------------------------------+-------------------+---------+---------------------------+------+-------------+ | id | select_type | table | type | possible_keys | key | key_len | ref | rows | Extra | +----+-------------+---------+-------+---------------------------------------------------------+-------------------+---------+---------------------------+------+-------------+ | 1 | SIMPLE | country | index | PRIMARY,country_id | country | 152 | NULL | 109 | Using index | | 1 | SIMPLE | city | ref | idx_fk_country_id,idx_country_id_city,idx_all,idx_other | idx_fk_country_id | 2 | sakila.country.country_id | 2 | Using index | +----+-------------+---------+-------+---------------------------------------------------------+-------------------+---------+---------------------------+------+-------------+` common.Config.ReportType = "explain-digest" err := common.GoldenDiff(func() { DigestExplainText(text) orgReportType := common.Config.ReportType common.Config.ReportType = "html" DigestExplainText(text) common.Config.ReportType = orgReportType }, t.Name(), update) if nil != err { t.Fatal(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: advisor/heuristic.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package advisor import ( "bytes" "fmt" "regexp" "strconv" "strings" "unicode/utf8" "github.com/XiaoMi/soar/ast" "github.com/XiaoMi/soar/common" "github.com/XiaoMi/soar/database" "github.com/gedex/inflector" "github.com/percona/go-mysql/query" tidb "github.com/pingcap/parser/ast" "github.com/pingcap/parser/format" "github.com/pingcap/parser/mysql" "github.com/tidwall/gjson" "vitess.io/vitess/go/vt/sqlparser" ) // RuleOK OK func (q *Query4Audit) RuleOK() Rule { return HeuristicRules["OK"] } // RuleImplicitAlias ALI.001 func (q *Query4Audit) RuleImplicitAlias() Rule { var rule = q.RuleOK() tkns := ast.Tokenizer(q.Query) if len(tkns) == 0 { return rule } if tkns[0].Type != sqlparser.SELECT { return rule } for i, tkn := range tkns { if tkn.Type == sqlparser.ID && i+1 < len(tkns) && tkn.Type == tkns[i+1].Type { rule = HeuristicRules["ALI.001"] break } } return rule } // RuleStarAlias ALI.002 func (q *Query4Audit) RuleStarAlias() Rule { var rule = q.RuleOK() tkns := ast.Tokenizer(q.Query) for i, tkn := range tkns { if strings.HasSuffix(tkn.Val, "*") && i+1 < len(tkns) && strings.ToLower(tkns[i+1].Val) == "as" { rule = HeuristicRules["ALI.002"] } } return rule } // RuleSameAlias ALI.003 func (q *Query4Audit) RuleSameAlias() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.AliasedExpr: switch n := expr.Expr.(type) { case *sqlparser.ColName: if n.Name.String() == expr.As.String() { rule = HeuristicRules["ALI.003"] return false, nil } } case *sqlparser.AliasedTableExpr: switch n := expr.Expr.(type) { case sqlparser.TableName: if n.Name.String() == expr.As.String() { rule = HeuristicRules["ALI.003"] return false, nil } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RulePrefixLike ARG.001 func (q *Query4Audit) RulePrefixLike() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.ComparisonExpr: if strings.ToLower(expr.Operator) == "like" { switch sqlval := expr.Right.(type) { case *sqlparser.SQLVal: // prefix like with '%', '_' if sqlval.Type == 0 && (sqlval.Val[0] == 0x25 || sqlval.Val[0] == 0x5f) { rule = HeuristicRules["ARG.001"] return false, nil } } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleEqualLike ARG.002 func (q *Query4Audit) RuleEqualLike() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.ComparisonExpr: if strings.ToLower(expr.Operator) == "like" { switch sqlval := expr.Right.(type) { case *sqlparser.SQLVal: // 1. string that not contain '%', '_' // 2. int, bit, float without wildcard var hasWildCard bool if sqlval.Type == 0 { for _, sqlElem := range sqlval.Val { if sqlElem == 0x25 || sqlElem == 0x5f { hasWildCard = true } } } if !hasWildCard { rule = HeuristicRules["ARG.002"] return false, nil } } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleImplicitConversion ARG.003 // 隐式类型转换检查:该项检查一定是在开启测试环境或线上环境情境下下进行的 func (idxAdv *IndexAdvisor) RuleImplicitConversion() Rule { /* * 两个参数至少有一个是 NULL 时,比较的结果也是 NULL,例外是使用 <=> 对两个 NULL 做比较时会返回 1,这两种情况都不需要做类型转换 * 两个参数都是字符串,会按照字符串来比较,不做类型转换 * 两个参数都是整数,按照整数来比较,不做类型转换 * 十六进制的值和非数字做比较时,会被当做二进制串 * 有一个参数是 TIMESTAMP 或 DATETIME,并且另外一个参数是常量,常量会被转换为 timestamp * 有一个参数是 decimal 类型,如果另外一个参数是 decimal 或者整数,会将整数转换为 decimal 后进行比较,如果另外一个参数是浮点数,则会把 decimal 转换为浮点数进行比较 * 所有其他情况下,两个参数都会被转换为浮点数再进行比较 */ rule := HeuristicRules["OK"] // 未开启测试环境不进行检查 if common.Config.TestDSN.Disable { return rule } var content []string conditions := ast.FindAllCondition(idxAdv.Ast) for _, cond := range conditions { var colList []*common.Column var values []*sqlparser.SQLVal // condition 左右两侧有且只有如下几种可能: // 1. 列与列比较,如: col1 = col2 // 2. 列与值比较,如: col = val // 3. 值与值比较,如: val1 = val2 暂不处理 // 如果列包含在一个函数中,认为这个条件为值,如: col = func(col) 认定为 列与值比较 switch node := cond.(type) { case *sqlparser.ComparisonExpr: // 获取 condition 左侧的信息 switch nLeft := node.Left.(type) { case *sqlparser.SQLVal, sqlparser.ValTuple: err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch val := node.(type) { case *sqlparser.SQLVal: values = append(values, val) } return true, nil }, nLeft) common.LogIfError(err, "") case *sqlparser.ColName: left := &common.Column{Name: nLeft.Name.String()} if !nLeft.Qualifier.Name.IsEmpty() { left.Table = nLeft.Qualifier.Name.String() } colList = append(colList, left) } // 获取 condition 右侧的信息 switch nRight := node.Right.(type) { case *sqlparser.SQLVal, sqlparser.ValTuple: err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch val := node.(type) { case *sqlparser.SQLVal: values = append(values, val) } return true, nil }, nRight) common.LogIfError(err, "") case *sqlparser.ColName: right := &common.Column{Name: nRight.Name.String()} if !nRight.Qualifier.Name.IsEmpty() { right.Table = nRight.Qualifier.Name.String() } colList = append(colList, right) } if len(colList) == 0 { continue } // 补全列信息 colList = CompleteColumnsInfo(idxAdv.Ast, colList, idxAdv.vEnv) // 列与列比较 if len(colList) == 2 { // 列信息补全后如果依然没有表信息,说明在该数据库中不存在该列 // 如果列信息获取异常,可能会存在无法获取到数据类型的情况,对于这种情况将不会给予建议。 needBreak := false for _, col := range colList { if col.Table == "" { common.Log.Warning("Column %s not exists", col.Name) needBreak = true } if col.DataType == "" { common.Log.Warning("Can't get column %s data type", col.Name) needBreak = true } } if needBreak { break } // 检查数据类型不一致导致的隐式数据转换 type1 := common.GetDataTypeBase(colList[0].DataType) type2 := common.GetDataTypeBase(colList[1].DataType) common.Log.Debug("DataType: `%s`.`%s` (%s) VS `%s`.`%s` (%s)", colList[0].Table, colList[0].Name, type1, colList[1].Table, colList[1].Name, type2) // case-insensitive check type1, type2 if !strings.EqualFold(type1, type2) { content = append(content, fmt.Sprintf("`%s`.`%s` (%s) VS `%s`.`%s` (%s) datatype not match", colList[0].Table, colList[0].Name, type1, colList[1].Table, colList[1].Name, type2)) continue } // 检查字符集不一致导致的隐式数据转换 common.Log.Debug("Charset: `%s`.`%s` (%s) VS `%s`.`%s` (%s)", colList[0].Table, colList[0].Name, colList[0].Character, colList[1].Table, colList[1].Name, colList[1].Character) if colList[0].Character != colList[1].Character { content = append(content, fmt.Sprintf("`%s`.`%s` (%s) VS `%s`.`%s` (%s) charset not match", colList[0].Table, colList[0].Name, colList[0].Character, colList[1].Table, colList[1].Name, colList[1].Character)) continue } // 检查 collation 排序不一致导致的隐式数据转换 common.Log.Debug("Collation: `%s`.`%s` (%s) VS `%s`.`%s` (%s)", colList[0].Table, colList[0].Name, colList[0].Collation, colList[1].Table, colList[1].Name, colList[1].Collation) if colList[0].Collation != colList[1].Collation { content = append(content, fmt.Sprintf("`%s`.`%s` (%s) VS `%s`.`%s` (%s) collation not match", colList[0].Table, colList[0].Name, colList[0].Collation, colList[1].Table, colList[1].Name, colList[1].Collation)) continue } } typMap := map[sqlparser.ValType][]string{ // date, time, datetime, timestamp, year sqlparser.StrVal: { "char", "varchar", "tinytext", "text", "mediumtext", "longtext", "date", "time", "datetime", "timestamp", "year", "tinyint", "smallint", "mediumint", "int", "integer", "bigint", "float", "double", "real", "decimal", }, sqlparser.IntVal: { "tinyint", "smallint", "mediumint", "int", "integer", "bigint", "timestamp", "year", "bit", "decimal", }, sqlparser.FloatVal: { "float", "double", "real", "decimal", }, } typNameMap := map[sqlparser.ValType]string{ sqlparser.StrVal: "string", sqlparser.IntVal: "int", sqlparser.FloatVal: "float", } // 列与值比较 for _, val := range values { if colList[0].DataType == "" { common.Log.Warn("Can't get %s data type", colList[0].Name) break } isCovered := true if tps, ok := typMap[val.Type]; ok { for _, tp := range tps { // colList[0].DataType, eg. year(4) if strings.HasPrefix(colList[0].DataType, tp) { isCovered = false } } } if isCovered { if colList[0].Table == "" { common.Log.Warning("Column %s not exists", colList[0].Name) continue } c := fmt.Sprintf("%s表中列%s的定义是 %s 而不是 %s。", colList[0].Table, colList[0].Name, colList[0].DataType, typNameMap[val.Type]) common.Log.Debug("Implicit data type conversion: %s", c) content = append(content, c) } else { // 检查时间格式,如:"", "2020-0a-01" switch strings.Split(colList[0].DataType, "(")[0] { case "date", "time", "datetime", "timestamp", "year": if !timeFormatCheck(string(val.Val)) { c := fmt.Sprintf("%s 表中列 %s 的时间格式错误,%s。", colList[0].Table, colList[0].Name, string(val.Val)) common.Log.Debug("Implicit data type conversion: %s", c) content = append(content, c) } // TODO: 各种数据类型格式检查 default: } } } case *sqlparser.RangeCond: // TODO case *sqlparser.IsExpr: // TODO } } if len(content) > 0 { rule = HeuristicRules["ARG.003"] rule.Content = strings.Join(common.RemoveDuplicatesItem(content), " ") } return rule } // timeFormatCheck 时间格式检查,格式正确返回 true,格式错误返回 false func timeFormatCheck(t string) bool { // 不允许为空,但允许时间前后有空格 t = strings.TrimSpace(t) // 仅允许 数字、减号、冒号、空格 allowChars := regexp.MustCompile(`^[\-0-9:. ]+$`) return allowChars.MatchString(t) } // RuleNoWhere CLA.001 & CLA.014 & CLA.015 func (q *Query4Audit) RuleNoWhere() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.Select: for _, f := range n.From { switch f.(type) { case *sqlparser.JoinTableExpr: return false, nil } } if n.Where == nil && sqlparser.String(n.From) != "dual" { rule = HeuristicRules["CLA.001"] return false, nil } case *sqlparser.Delete: if n.Where == nil { rule = HeuristicRules["CLA.014"] return false, nil } case *sqlparser.Update: if n.Where == nil { rule = HeuristicRules["CLA.015"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleOrderByRand CLA.002 func (q *Query4Audit) RuleOrderByRand() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case sqlparser.OrderBy: for _, order := range n { switch expr := order.Expr.(type) { case *sqlparser.FuncExpr: if strings.ToLower(expr.Name.String()) == "rand" { rule = HeuristicRules["CLA.002"] return false, nil } } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleOffsetLimit CLA.003 func (q *Query4Audit) RuleOffsetLimit() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.Limit: if n != nil && n.Offset != nil { switch v := n.Offset.(type) { case *sqlparser.SQLVal: offset, err := strconv.Atoi(string(v.Val)) // TODO: 检查一下Offset阈值,太小了给这个建议也没什么用,阈值写死了没加配置 if err == nil && offset > 1000 { rule = HeuristicRules["CLA.003"] return false, nil } } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleGroupByConst CLA.004 func (q *Query4Audit) RuleGroupByConst() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case sqlparser.GroupBy: for _, group := range n { switch group.(type) { case *sqlparser.SQLVal: rule = HeuristicRules["CLA.004"] return false, nil } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleGroupByConst GRP.001 func (idxAdv *IndexAdvisor) RuleGroupByConst() Rule { rule := HeuristicRules["OK"] // 非GroupBy语句 if len(idxAdv.groupBy) == 0 || len(idxAdv.whereEQ) == 0 { return rule } for _, groupByCols := range idxAdv.groupBy { for _, whereEQCols := range idxAdv.whereEQ { if (groupByCols.Name == whereEQCols.Name) && (groupByCols.DB == whereEQCols.DB) && (groupByCols.Table == whereEQCols.Table) { rule = HeuristicRules["GRP.001"] break } } } return rule } // RuleOrderByConst CLA.005 func (q *Query4Audit) RuleOrderByConst() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case sqlparser.OrderBy: for _, order := range n { switch order.Expr.(type) { case *sqlparser.SQLVal: rule = HeuristicRules["CLA.005"] return false, nil } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleOrderByConst CLA.005 // TODO: SELECT col FROM tbl WHERE col IN('NEWS') ORDER BY col; func (idxAdv *IndexAdvisor) RuleOrderByConst() Rule { rule := HeuristicRules["OK"] // 非GroupBy语句 if len(idxAdv.orderBy) == 0 || len(idxAdv.whereEQ) == 0 { return rule } for _, groupbyCols := range idxAdv.orderBy { for _, whereEQCols := range idxAdv.whereEQ { if (groupbyCols.Name == whereEQCols.Name) && (groupbyCols.DB == whereEQCols.DB) && (groupbyCols.Table == whereEQCols.Table) { rule = HeuristicRules["CLA.005"] break } } } return rule } // RuleDiffGroupByOrderBy CLA.006 func (q *Query4Audit) RuleDiffGroupByOrderBy() Rule { var rule = q.RuleOK() var groupbyTbls []sqlparser.TableIdent var orderbyTbls []sqlparser.TableIdent err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case sqlparser.GroupBy: // 检查group by涉及到表的个数 for _, group := range n { switch g := group.(type) { case *sqlparser.ColName: tblExist := false for _, t := range groupbyTbls { if t.String() == g.Qualifier.Name.String() { tblExist = true } } if !tblExist { groupbyTbls = append(groupbyTbls, g.Qualifier.Name) if len(groupbyTbls) > 1 { rule = HeuristicRules["CLA.006"] return false, nil } } } } case sqlparser.OrderBy: // 检查order by涉及到表的个数 for _, order := range n { switch o := order.Expr.(type) { case *sqlparser.ColName: tblExist := false for _, t := range orderbyTbls { if t.String() == o.Qualifier.Name.String() { tblExist = true } } if !tblExist { orderbyTbls = append(orderbyTbls, o.Qualifier.Name) if len(orderbyTbls) > 1 { rule = HeuristicRules["CLA.006"] return false, nil } } } } } return true, nil }, q.Stmt) common.LogIfError(err, "") if rule.Item == "OK" { // 检查group by, order by涉及到表的个数 for _, g := range groupbyTbls { tblExist := false for _, o := range orderbyTbls { if g.String() == o.String() { tblExist = true } } if !tblExist && len(orderbyTbls) > 0 { rule = HeuristicRules["CLA.006"] return rule } } } return rule } // RuleExplicitOrderBy CLA.008 func (q *Query4Audit) RuleExplicitOrderBy() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.Select: // 有group by,但没有order by if n.GroupBy != nil && n.OrderBy == nil { rule = HeuristicRules["CLA.008"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleOrderByExpr CLA.009 func (q *Query4Audit) RuleOrderByExpr() Rule { var rule = q.RuleOK() var orderByCols []string var selectCols []string funcExp := regexp.MustCompile(`(?i)[a-z0-9]\(`) allowExp := regexp.MustCompile("(?i)[a-z0-9_,.` ()]") err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case sqlparser.OrderBy: orderBy := sqlparser.String(n) // 函数名方式,如:from_unixtime(col) if funcExp.MatchString(orderBy) { rule = HeuristicRules["CLA.009"] return false, nil } // 运算符方式,如:colA - colB trim := allowExp.ReplaceAllFunc([]byte(orderBy), func(s []byte) []byte { return []byte("") }) if string(trim) != "" { rule = HeuristicRules["CLA.009"] return false, nil } for _, o := range strings.Split(strings.TrimPrefix(orderBy, " order by "), ",") { orderByCols = append(orderByCols, strings.TrimSpace(strings.Split(o, " ")[0])) } case *sqlparser.Select: for _, s := range n.SelectExprs { selectCols = append(selectCols, sqlparser.String(s)) } } return true, nil }, q.Stmt) common.LogIfError(err, "") // AS情况,如:SELECT colA-colB a FROM tbl ORDER BY a; for _, o := range orderByCols { if o == "" { continue } for _, s := range selectCols { if strings.HasSuffix(s, " as "+o) { buf := strings.TrimSuffix(s, " as "+o) // 运算符 trim := allowExp.ReplaceAllFunc([]byte(buf), func(s []byte) []byte { return []byte("") }) if string(trim) != "" { rule = HeuristicRules["CLA.009"] } // 函数 if funcExp.MatchString(s) { rule = HeuristicRules["CLA.009"] } } } } return rule } // RuleGroupByExpr CLA.010 func (q *Query4Audit) RuleGroupByExpr() Rule { var rule = q.RuleOK() var groupByCols []string var selectCols []string funcExp := regexp.MustCompile(`(?i)[a-z0-9]\(`) allowExp := regexp.MustCompile("(?i)[a-z0-9_,.` ()]") err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case sqlparser.GroupBy: groupBy := sqlparser.String(n) // 函数名方式,如:from_unixtime(col) if funcExp.MatchString(groupBy) { rule = HeuristicRules["CLA.010"] return false, nil } // 运算符方式,如:colA - colB trim := allowExp.ReplaceAllFunc([]byte(groupBy), func(s []byte) []byte { return []byte("") }) if string(trim) != "" { rule = HeuristicRules["CLA.010"] return false, nil } for _, o := range strings.Split(strings.TrimPrefix(groupBy, " group by "), ",") { groupByCols = append(groupByCols, strings.TrimSpace(strings.Split(o, " ")[0])) } case *sqlparser.Select: for _, s := range n.SelectExprs { selectCols = append(selectCols, sqlparser.String(s)) } } return true, nil }, q.Stmt) common.LogIfError(err, "") // AS情况,如:SELECT colA-colB a FROM tbl GROUP BY a; for _, g := range groupByCols { if g == "" { continue } for _, s := range selectCols { if strings.HasSuffix(s, " as "+g) { buf := strings.TrimSuffix(s, " as "+g) // 运算符 trim := allowExp.ReplaceAllFunc([]byte(buf), func(s []byte) []byte { return []byte("") }) if string(trim) != "" { rule = HeuristicRules["CLA.010"] } // 函数 if funcExp.MatchString(s) { rule = HeuristicRules["CLA.010"] } } } } return rule } // RuleTblCommentCheck CLA.011 func (q *Query4Audit) RuleTblCommentCheck() Rule { var rule = q.RuleOK() switch node := q.Stmt.(type) { case *sqlparser.DDL: if strings.ToLower(node.Action) != "create" { return rule } if node.TableSpec == nil { return rule } if options := node.TableSpec.Options; options == "" { rule = HeuristicRules["CLA.011"] } else { reg := regexp.MustCompile("(?i)comment") if !reg.MatchString(options) { rule = HeuristicRules["CLA.011"] } } } return rule } // RuleSelectStar COL.001 func (q *Query4Audit) RuleSelectStar() Rule { var rule = q.RuleOK() // 先把count(*)替换为count(1) re := regexp.MustCompile(`(?i)count\s*\(\s*\*\s*\)`) sql := re.ReplaceAllString(q.Query, "count(1)") stmt, err := sqlparser.Parse(sql) if err != nil { common.Log.Debug("RuleSelectStar sqlparser.Parse Error: %v", err) return rule } err = sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node.(type) { case *sqlparser.StarExpr: rule = HeuristicRules["COL.001"] return false, nil } return true, nil }, stmt) common.LogIfError(err, "") return rule } // RuleInsertColDef COL.002 func (q *Query4Audit) RuleInsertColDef() Rule { var rule = q.RuleOK() switch node := q.Stmt.(type) { case *sqlparser.Insert: if node.Columns == nil { rule = HeuristicRules["COL.002"] return rule } } return rule } // RuleAddDefaultValue COL.004 func (q *Query4Audit) RuleAddDefaultValue() Rule { var rule = q.RuleOK() for _, node := range q.TiStmt { switch n := node.(type) { case *tidb.CreateTableStmt: for _, c := range n.Cols { colDefault := false for _, o := range c.Options { // 忽略AutoIncrement类型的默认值检查 if o.Tp == tidb.ColumnOptionDefaultValue || o.Tp == tidb.ColumnOptionAutoIncrement { colDefault = true } } switch c.Tp.Tp { case mysql.TypeBlob, mysql.TypeTinyBlob, mysql.TypeMediumBlob, mysql.TypeLongBlob, mysql.TypeJSON: colDefault = true } if !colDefault { rule = HeuristicRules["COL.004"] break } } case *tidb.AlterTableStmt: for _, s := range n.Specs { switch s.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableChangeColumn, tidb.AlterTableModifyColumn: for _, c := range s.NewColumns { colDefault := false for _, o := range c.Options { // 忽略AutoIncrement类型的默认值检查 if o.Tp == tidb.ColumnOptionDefaultValue || o.Tp == tidb.ColumnOptionAutoIncrement { colDefault = true } } switch c.Tp.Tp { case mysql.TypeBlob, mysql.TypeTinyBlob, mysql.TypeMediumBlob, mysql.TypeLongBlob, mysql.TypeJSON: colDefault = true } if !colDefault { rule = HeuristicRules["COL.004"] break } } } } } } return rule } // RuleColCommentCheck COL.005 func (q *Query4Audit) RuleColCommentCheck() Rule { var rule = q.RuleOK() for _, node := range q.TiStmt { switch n := node.(type) { case *tidb.CreateTableStmt: for _, c := range n.Cols { colComment := false for _, o := range c.Options { if o.Tp == tidb.ColumnOptionComment { colComment = true } } if !colComment { rule = HeuristicRules["COL.005"] break } } case *tidb.AlterTableStmt: for _, s := range n.Specs { switch s.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableChangeColumn, tidb.AlterTableModifyColumn: for _, c := range s.NewColumns { colComment := false for _, o := range c.Options { if o.Tp == tidb.ColumnOptionComment { colComment = true } } if !colComment { rule = HeuristicRules["COL.005"] break } } } } } } return rule } // RuleIPString LIT.001 func (q *Query4Audit) RuleIPString() Rule { var rule = q.RuleOK() for _, stmt := range q.TiStmt { switch stmt.(type) { case *tidb.AlterUserStmt, *tidb.CreateUserStmt, *tidb.GrantStmt, *tidb.GrantRoleStmt, *tidb.RevokeRoleStmt, *tidb.RevokeStmt, *tidb.DropUserStmt: return rule } } re := regexp.MustCompile(`['"]\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}`) if re.FindString(q.Query) != "" { rule = HeuristicRules["LIT.001"] if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } } return rule } // RuleDateNotQuote LIT.002 func (q *Query4Audit) RuleDateNotQuote() Rule { var rule = q.RuleOK() // by pass insert except, insert select switch n := q.Stmt.(type) { case *sqlparser.Insert: var insertSelect bool switch n.Rows.(type) { case *sqlparser.Select: insertSelect = true } if !insertSelect { return rule } } // 2010-01-01 re := regexp.MustCompile(`.\d{4}\s*-\s*\d{1,2}\s*-\s*\d{1,2}\b`) sqls := re.FindAllString(q.Query, -1) for _, sql := range sqls { re = regexp.MustCompile(`^['"\w-].*`) if re.FindString(sql) == "" { rule = HeuristicRules["LIT.002"] if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } return rule } } // 10-01-01 re = regexp.MustCompile(`.\d{2}\s*-\s*\d{1,2}\s*-\s*\d{1,2}\b`) sqls = re.FindAllString(q.Query, -1) for _, sql := range sqls { re = regexp.MustCompile(`^['"\w-].*`) if re.FindString(sql) == "" { if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } rule = HeuristicRules["LIT.002"] } } return rule } // RuleSQLCalcFoundRows KWR.001 func (q *Query4Audit) RuleSQLCalcFoundRows() Rule { var rule = q.RuleOK() tkns := ast.Tokenizer(q.Query) for _, tkn := range tkns { if strings.ToLower(tkn.Val) == "sql_calc_found_rows" { rule = HeuristicRules["KWR.001"] break } } return rule } // RuleCommaAnsiJoin JOI.001 func (q *Query4Audit) RuleCommaAnsiJoin() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.Select: ansiJoin := false commaJoin := false for _, f := range n.From { switch f.(type) { case *sqlparser.JoinTableExpr: ansiJoin = true case *sqlparser.AliasedTableExpr: commaJoin = true } } if ansiJoin && commaJoin { rule = HeuristicRules["JOI.001"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleDupJoin JOI.002 func (q *Query4Audit) RuleDupJoin() Rule { var rule = q.RuleOK() var tables []string switch q.Stmt.(type) { // TODO: 这里未检查UNION SELECT case *sqlparser.Union: return rule default: err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.AliasedTableExpr: switch table := n.Expr.(type) { case sqlparser.TableName: for _, t := range tables { if t == table.Name.String() { rule = HeuristicRules["JOI.002"] return false, nil } } tables = append(tables, table.Name.String()) } } return true, nil }, q.Stmt) common.LogIfError(err, "") } return rule } // RuleImpossibleOuterJoin JOI.003 // TODO: 未实现完 func (idxAdv *IndexAdvisor) RuleImpossibleOuterJoin() Rule { rule := HeuristicRules["OK"] var joinTables []string // JOIN相关表名 var whereEQTables []string // WHERE等值判断条件表名 var joinNotWhereTables []string // 是JOIN相关表,但未出现在WHERE等值判断条件中的表名 // 非JOIN语句 if len(idxAdv.joinCond) == 0 || len(idxAdv.whereEQ) == 0 { return rule } for _, l1 := range idxAdv.joinCond { for _, l2 := range l1 { if l2.Table != "" && strings.ToLower(l2.Table) != "dual" { joinTables = append(joinTables, l2.Table) } } } for _, w := range idxAdv.whereEQ { whereEQTables = append(whereEQTables, w.Table) } for _, j := range joinTables { found := false for _, w := range whereEQTables { if j == w { found = true } } if !found { joinNotWhereTables = append(joinNotWhereTables, j) } } // TODO: fmt.Println(joinNotWhereTables) /* if len(joinNotWhereTables) == 0 { rule = HeuristicRules["JOI.003"] } */ rule = HeuristicRules["JOI.003"] return rule } // TODO: JOI.004 // RuleNoDeterministicGroupby RES.001 func (q *Query4Audit) RuleNoDeterministicGroupby() Rule { var rule = q.RuleOK() var groupbyCols []*common.Column var selectCols []*common.Column err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.Select: // 过滤select列 selectCols = ast.FindColumn(n.SelectExprs) // 过滤group by列 groupbyCols = ast.FindColumn(n.GroupBy) // `select *`, but not `select count(*)` if strings.Contains(sqlparser.String(n), " * ") && len(groupbyCols) > 0 { rule = HeuristicRules["RES.001"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") // TODO:暂时只检查了列名,未对库表名进行检查,也未处理AS for _, s := range selectCols { // 无group by退出 if len(groupbyCols) == 0 { break } found := false for _, g := range groupbyCols { if g.Name == s.Name { found = true } } if !found { rule = HeuristicRules["RES.001"] break } } return rule } // RuleNoDeterministicLimit RES.002 func (q *Query4Audit) RuleNoDeterministicLimit() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.Select: if n.Limit != nil && n.OrderBy == nil { rule = HeuristicRules["RES.002"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleUpdateDeleteWithLimit RES.003 func (q *Query4Audit) RuleUpdateDeleteWithLimit() Rule { var rule = q.RuleOK() switch s := q.Stmt.(type) { case *sqlparser.Update: if s.Limit != nil { rule = HeuristicRules["RES.003"] } } return rule } // RuleUpdateDeleteWithOrderby RES.004 func (q *Query4Audit) RuleUpdateDeleteWithOrderby() Rule { var rule = q.RuleOK() switch s := q.Stmt.(type) { case *sqlparser.Update: if s.OrderBy != nil { rule = HeuristicRules["RES.004"] } } return rule } // RuleUpdateSetAnd RES.005 func (q *Query4Audit) RuleUpdateSetAnd() Rule { var rule = q.RuleOK() switch s := q.Stmt.(type) { case *sqlparser.Update: for _, c := range s.Exprs { switch c.Expr.(type) { case *sqlparser.Subquery: default: if strings.Contains(sqlparser.String(c), " and ") { rule = HeuristicRules["RES.005"] } } } } return rule } // RuleImpossibleWhere RES.006 func (q *Query4Audit) RuleImpossibleWhere() Rule { var rule = q.RuleOK() // BETWEEN 10 AND 5 err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.RangeCond: if strings.ToLower(n.Operator) == "between" { from := 0 to := 0 switch s := n.From.(type) { case *sqlparser.SQLVal: from, _ = strconv.Atoi(string(s.Val)) } switch s := n.To.(type) { case *sqlparser.SQLVal: to, _ = strconv.Atoi(string(s.Val)) } if from > to { rule = HeuristicRules["RES.006"] return false, nil } } case *sqlparser.ComparisonExpr: factor := false switch n.Operator { case "!=", "<>": case "=", "<=>": factor = true default: return true, nil } var left []byte var right []byte // left switch l := n.Left.(type) { case *sqlparser.SQLVal: left = l.Val default: return true, nil } // right switch r := n.Right.(type) { case *sqlparser.SQLVal: right = r.Val default: return true, nil } // compare if (!bytes.Equal(left, right) && factor) || (bytes.Equal(left, right) && !factor) { rule = HeuristicRules["RES.006"] } return false, nil } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleMeaninglessWhere RES.007 func (q *Query4Audit) RuleMeaninglessWhere() Rule { var rule = q.RuleOK() var where *sqlparser.Where switch n := q.Stmt.(type) { case *sqlparser.Select: where = n.Where case *sqlparser.Update: where = n.Where case *sqlparser.Delete: where = n.Where } if where != nil { switch v := where.Expr.(type) { // WHERE 1 case *sqlparser.SQLVal: switch string(v.Val) { case "0", "false": default: rule = HeuristicRules["RES.007"] return rule } // WHERE true case sqlparser.BoolVal: if v { rule = HeuristicRules["RES.007"] return rule } } } err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { // WHERE id = 1 or 2 case *sqlparser.OrExpr: // right always true switch v := n.Right.(type) { case *sqlparser.SQLVal: switch string(v.Val) { case "0", "false": default: rule = HeuristicRules["RES.007"] } case sqlparser.BoolVal: if v { rule = HeuristicRules["RES.007"] } } // left always true switch v := n.Left.(type) { case *sqlparser.SQLVal: switch string(v.Val) { case "0", "false": default: rule = HeuristicRules["RES.007"] } case sqlparser.BoolVal: if v { rule = HeuristicRules["RES.007"] } } // 1=1, 0=0 case *sqlparser.ComparisonExpr: factor := false switch n.Operator { case "!=", "<>": factor = true case "=", "<=>": default: return true, nil } var left []byte var right []byte // left switch l := n.Left.(type) { case *sqlparser.SQLVal: left = l.Val default: return true, nil } // right switch r := n.Right.(type) { case *sqlparser.SQLVal: right = r.Val default: return true, nil } // compare if (bytes.Equal(left, right) && !factor) || (!bytes.Equal(left, right) && factor) { rule = HeuristicRules["RES.007"] } // TODO: // 2 > 1 // true = 1 // false != 1 return false, nil } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleLoadFile RES.008 func (q *Query4Audit) RuleLoadFile() Rule { var rule = q.RuleOK() // 去除注释 sql := database.RemoveSQLComments(q.Query) // 去除多余的空格和回车 sql = strings.Join(strings.Fields(sql), " ") tks := ast.Tokenize(sql) for i, tk := range tks { // 注意:每个关键字token的结尾是带空格的,这里偷懒没trimspace直接加空格比较 // LOAD DATA... if strings.ToLower(tk.Val) == "load " && i+1 < len(tks) && strings.ToLower(tks[i+1].Val) == "data " { rule = HeuristicRules["RES.008"] break } // SELECT ... INTO OUTFILE if strings.ToLower(tk.Val) == "into " && i+1 < len(tks) && (strings.ToLower(tks[i+1].Val) == "outfile " || strings.ToLower(tks[i+1].Val) == "dumpfile ") { rule = HeuristicRules["RES.008"] break } } return rule } // RuleMultiCompare RES.009 func (q *Query4Audit) RuleMultiCompare() Rule { var rule = q.RuleOK() if q.TiStmt != nil { json := ast.StmtNode2JSON(q.Query, "", "") whereJSON := common.JSONFind(json, "Where") for _, where := range whereJSON { conds := []string{where} conds = append(conds, common.JSONFind(where, "L")...) conds = append(conds, common.JSONFind(where, "R")...) for _, cond := range conds { if gjson.Get(cond, "Op").Int() == 7 && gjson.Get(cond, "L.Op").Int() == 7 { rule = HeuristicRules["RES.009"] return rule } } } } return rule } // RuleCreateOnUpdate RES.010 func (q *Query4Audit) RuleCreateOnUpdate() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } for _, op := range col.Options { if op.Tp == tidb.ColumnOptionOnUpdate { rule = HeuristicRules["RES.010"] return rule } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableModifyColumn, tidb.AlterTableChangeColumn: for _, col := range spec.NewColumns { if col.Tp == nil { continue } for _, op := range col.Options { if op.Tp == tidb.ColumnOptionOnUpdate { rule = HeuristicRules["RES.010"] return rule } } } } } } } } return rule } // RuleUpdateOnUpdate RES.011 func (idxAdv *IndexAdvisor) RuleUpdateOnUpdate() Rule { rule := HeuristicRules["OK"] // 未开启测试环境不进行检查 if common.Config.TestDSN.Disable { return rule } err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch stmt := node.(type) { case *sqlparser.Update: for _, tbExpr := range stmt.TableExprs { ddl, err := idxAdv.vEnv.ShowCreateTable(sqlparser.String(tbExpr)) if err != nil { common.Log.Error("RuleMaxTextColsCount create statement got failed: %s", err.Error()) return false, err } if strings.Contains(ddl, "ON UPDATE") { rule = HeuristicRules["RES.011"] break } } for _, setExpr := range stmt.Exprs { tup := strings.Split(sqlparser.String(setExpr), " = ") if len(tup) == 2 && tup[0] == tup[1] { rule = HeuristicRules["OK"] } } } return true, nil }, idxAdv.Ast) common.LogIfError(err, "") return rule } // RuleStandardINEQ STA.001 func (q *Query4Audit) RuleStandardINEQ() Rule { var rule = q.RuleOK() re := regexp.MustCompile(`(!=)`) if re.FindString(q.Query) != "" { rule = HeuristicRules["STA.001"] if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } } return rule } // RuleUseKeyWord KWR.002 func (q *Query4Audit) RuleUseKeyWord() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: if q.TiStmt == nil { common.Log.Error("TiStmt is nil, SQL: %s", q.Query) return rule } for _, tiStmtNode := range q.TiStmt { switch stmt := tiStmtNode.(type) { case *tidb.AlterTableStmt: // alter for _, spec := range stmt.Specs { for _, column := range spec.NewColumns { if ast.IsMysqlKeyword(column.Name.String()) { return HeuristicRules["KWR.002"] } } } case *tidb.CreateTableStmt: // create if ast.IsMysqlKeyword(stmt.Table.Name.String()) { return HeuristicRules["KWR.002"] } for _, col := range stmt.Cols { if ast.IsMysqlKeyword(col.Name.String()) { return HeuristicRules["KWR.002"] } } } } } return rule } // RulePluralWord KWR.003 // Reference: https://en.wikipedia.org/wiki/English_plurals func (q *Query4Audit) RulePluralWord() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: if q.TiStmt == nil { common.Log.Error("TiStmt is nil, SQL: %s", q.Query) return rule } for _, tiStmtNode := range q.TiStmt { switch stmt := tiStmtNode.(type) { case *tidb.AlterTableStmt: // alter for _, spec := range stmt.Specs { for _, column := range spec.NewColumns { if inflector.Singularize(column.Name.String()) != column.Name.String() { return HeuristicRules["KWR.003"] } } } case *tidb.CreateTableStmt: // create if inflector.Singularize(stmt.Table.Name.String()) != stmt.Table.Name.String() { return HeuristicRules["KWR.003"] } for _, col := range stmt.Cols { if inflector.Singularize(col.Name.String()) != col.Name.String() { return HeuristicRules["KWR.003"] } } } } } return rule } // RuleMultiBytesWord KWR.004 func (q *Query4Audit) RuleMultiBytesWord() Rule { // TODO: 目前使用 utf8 字符集检查,其他字符集输入可能会有问题 var rule = q.RuleOK() for _, tk := range ast.Tokenize(q.Query) { switch tk.Type { case ast.TokenTypeBacktickQuote, ast.TokenTypeWord: if utf8.RuneCountInString(tk.Val) != len(tk.Val) { rule = HeuristicRules["KWR.004"] } default: } } return rule } // RuleInvisibleUnicode KWR.005 func (q *Query4Audit) RuleInvisibleUnicode() Rule { var rule = q.RuleOK() for _, tk := range ast.Tokenizer(q.Query) { // 多字节的肉眼不可见字符经过 Tokenizer 后被切成了单字节字符。 // strings.Contains 中的内容也肉眼不可见,需要使用 cat -A 查看代码 switch tk.Val { case string([]byte{194}), string([]byte{160}): // non-broken-space C2 A0 if strings.Contains(q.Query, ` `) { rule = HeuristicRules["KWR.005"] return rule } case string([]byte{226}), string([]byte{128}), string([]byte{139}): // zero-width space E2 80 8B if strings.Contains(q.Query, `​`) { rule = HeuristicRules["KWR.005"] return rule } default: } } return rule } // RuleInsertSelect LCK.001 func (q *Query4Audit) RuleInsertSelect() Rule { var rule = q.RuleOK() switch n := q.Stmt.(type) { case *sqlparser.Insert: switch n.Rows.(type) { case *sqlparser.Select: rule = HeuristicRules["LCK.001"] } } return rule } // RuleInsertOnDup LCK.002 func (q *Query4Audit) RuleInsertOnDup() Rule { var rule = q.RuleOK() switch n := q.Stmt.(type) { case *sqlparser.Insert: if n.OnDup != nil { rule = HeuristicRules["LCK.002"] return rule } } return rule } // RuleInSubquery SUB.001 func (q *Query4Audit) RuleInSubquery() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node.(type) { case *sqlparser.Subquery: rule = HeuristicRules["SUB.001"] return false, nil } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleSubqueryDepth SUB.004 func (q *Query4Audit) RuleSubqueryDepth() Rule { var rule = q.RuleOK() if depth := ast.GetSubqueryDepth(q.Stmt); depth > common.Config.MaxSubqueryDepth { rule = HeuristicRules["SUB.004"] } return rule } // RuleSubQueryLimit SUB.005 // 只有 IN 的 SUBQUERY 限制了 LIMIT, FROM 子句中的 SUBQUERY 并未限制 LIMIT func (q *Query4Audit) RuleSubQueryLimit() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.ComparisonExpr: if n.Operator == "in" { switch r := n.Right.(type) { case *sqlparser.Subquery: switch s := r.Select.(type) { case *sqlparser.Select: if s.Limit != nil { rule = HeuristicRules["SUB.005"] return false, nil } } } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleSubQueryFunctions SUB.006 func (q *Query4Audit) RuleSubQueryFunctions() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node.(type) { case *sqlparser.Subquery: err = sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node.(type) { case *sqlparser.FuncExpr: rule = HeuristicRules["SUB.006"] return false, nil } return true, nil }, node) common.LogIfError(err, "") } if rule.Item == "OK" { return true, nil } return false, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleUNIONLimit SUB.007 func (q *Query4Audit) RuleUNIONLimit() Rule { var rule = q.RuleOK() for _, tiStmtNode := range q.TiStmt { switch stmt := tiStmtNode.(type) { // SetOprStmt represents "union/except/intersect statement" case *tidb.SetOprStmt: if stmt.Limit != nil { for _, sel := range stmt.SelectList.Selects { switch n := sel.(type) { case *tidb.SelectStmt: if n.Limit == nil { rule = HeuristicRules["SUB.007"] } case *tidb.SetOprSelectList: for _, s := range n.Selects { switch s1 := s.(type) { case *tidb.SelectStmt: if s1.Limit == nil { rule = HeuristicRules["SUB.007"] } } } } } } } } return rule } // RuleMultiValueAttribute LIT.003 func (q *Query4Audit) RuleMultiValueAttribute() Rule { var rule = q.RuleOK() re := regexp.MustCompile(`(?i)(id\s+regexp)`) if re.FindString(q.Query) != "" { rule = HeuristicRules["LIT.003"] if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } } return rule } // RuleAddDelimiter LIT.004 func (q *Query4Audit) RuleAddDelimiter() Rule { var rule = q.RuleOK() re := regexp.MustCompile(`(?i)(^use\s+[0-9a-z_-]*)|(^show\s+databases)`) if re.FindString(q.Query) != "" && !strings.HasSuffix(q.Query, common.Config.Delimiter) { rule = HeuristicRules["LIT.004"] if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } } return rule } // RuleRecursiveDependency KEY.003 func (q *Query4Audit) RuleRecursiveDependency() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: // create statement for _, ref := range node.Constraints { if ref != nil && ref.Tp == tidb.ConstraintForeignKey { rule = HeuristicRules["KEY.003"] } } case *tidb.AlterTableStmt: // alter table statement for _, spec := range node.Specs { if spec.Constraint != nil && spec.Constraint.Tp == tidb.ConstraintForeignKey { rule = HeuristicRules["KEY.003"] } } } } } if rule.Item == "KEY.003" { re := regexp.MustCompile(`(?i)(\s+references\s+)`) if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } } return rule } // RuleImpreciseDataType COL.009 func (q *Query4Audit) RuleImpreciseDataType() Rule { var rule = q.RuleOK() if q.TiStmt != nil { for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: // Create table statement for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeFloat, mysql.TypeDouble, mysql.TypeNewDecimal: rule = HeuristicRules["COL.009"] } } case *tidb.AlterTableStmt: // Alter table statement for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableChangeColumn, tidb.AlterTableModifyColumn: for _, col := range spec.NewColumns { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeFloat, mysql.TypeDouble, mysql.TypeNewDecimal: rule = HeuristicRules["COL.009"] } } } } case *tidb.InsertStmt: // Insert statement for _, values := range node.Lists { for _, value := range values { switch value.GetType().Tp { case mysql.TypeNewDecimal, mysql.TypeFloat: rule = HeuristicRules["COL.009"] } } } case *tidb.SelectStmt: // Select statement switch where := node.Where.(type) { case *tidb.BinaryOperationExpr: switch where.R.GetType().Tp { case mysql.TypeNewDecimal, mysql.TypeFloat: rule = HeuristicRules["COL.009"] } } } } } return rule } // RuleValuesInDefinition COL.010 func (q *Query4Audit) RuleValuesInDefinition() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeSet, mysql.TypeEnum, mysql.TypeBit: rule = HeuristicRules["COL.010"] } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableChangeColumn, tidb.AlterTableModifyColumn: for _, col := range spec.NewColumns { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeSet, mysql.TypeEnum, mysql.TypeBit: rule = HeuristicRules["COL.010"] } } } } } } } return rule } // RuleIndexAttributeOrder KEY.004 func (q *Query4Audit) RuleIndexAttributeOrder() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateIndexStmt: if len(node.IndexPartSpecifications) > 1 { rule = HeuristicRules["KEY.004"] break } case *tidb.CreateTableStmt: for _, constraint := range node.Constraints { // 当一条索引中包含多个列的时候给予建议 if len(constraint.Keys) > 1 { rule = HeuristicRules["KEY.004"] break } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { if spec.Tp == tidb.AlterTableAddConstraint && len(spec.Constraint.Keys) > 1 { rule = HeuristicRules["KEY.004"] break } } } } } return rule } // RuleNullUsage COL.011 func (q *Query4Audit) RuleNullUsage() Rule { var rule = q.RuleOK() re := regexp.MustCompile(`(?i)(\s+null\s+)`) if re.FindString(q.Query) != "" { rule = HeuristicRules["COL.011"] if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } } return rule } // RuleStringConcatenation FUN.003 func (q *Query4Audit) RuleStringConcatenation() Rule { var rule = q.RuleOK() // 匹配 or 关键字 matchF := func(s string) bool { // 状态:进入下一状态要匹配的字符 path := map[int]rune{ -1: '\'', // 特殊状态,左侧有单引号,等待匹配单引号 0: ' ', // 初始态 1: 'o', 2: 'r', 3: ' ', } status := 0 skip := false for _, c := range s { if skip { skip = false continue } switch c { case '\\': skip = true case path[status]: status += 1 // next status case '\'': status = -1 default: // 碰到其他字符,如果status = -1,说明在引号中间,保持不变 if status != -1 { status = 0 } } if status == 4 { return true } } return false } err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.Select: for _, expr := range n.SelectExprs { if matchF(sqlparser.String(expr)) { rule = HeuristicRules["FUN.003"] return false, nil } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleSysdate FUN.004 func (q *Query4Audit) RuleSysdate() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.FuncExpr: if strings.ToLower(n.Name.String()) == "sysdate" { rule = HeuristicRules["FUN.004"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleCountConst FUN.005 func (q *Query4Audit) RuleCountConst() Rule { var rule = q.RuleOK() fingerprint := query.Fingerprint(q.Query) countReg := regexp.MustCompile(`(?i)count\(\s*[0-9a-z?]*\s*\)`) if countReg.MatchString(fingerprint) { rule = HeuristicRules["FUN.005"] if position := countReg.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } } return rule } // RuleSumNPE FUN.006 func (q *Query4Audit) RuleSumNPE() Rule { var rule = q.RuleOK() fingerprint := query.Fingerprint(q.Query) // TODO: https://github.com/XiaoMi/soar/issues/143 // https://dev.mysql.com/doc/refman/8.0/en/group-by-functions.html sumReg := regexp.MustCompile(`(?i)sum\(\s*[0-9a-z?]*\s*\)`) isnullReg := regexp.MustCompile(`(?i)isnull\(sum\(\s*[0-9a-z?]*\s*\)\)`) if sumReg.MatchString(fingerprint) && !isnullReg.MatchString(fingerprint) { // TODO: check wether column define with not null flag rule = HeuristicRules["FUN.006"] if position := isnullReg.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } } return rule } // RuleForbiddenTrigger FUN.007 func (q *Query4Audit) RuleForbiddenTrigger() Rule { var rule = q.RuleOK() // 由于vitess对某些语法的支持不完善,使得如创建临时表等语句无法通过语法检查 // 所以这里使用正则对触发器、临时表、存储过程等进行匹配 // 但是目前支持的也不是非常全面,有待完善匹配规则 // TODO TiDB 目前还不支持触发器、存储过程、自定义函数、外键 forbidden := []*regexp.Regexp{ regexp.MustCompile(`(?i)CREATE\s+TRIGGER\s+`), } for _, reg := range forbidden { if reg.MatchString(q.Query) { rule = HeuristicRules["FUN.007"] if position := reg.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } break } } return rule } // RuleForbiddenProcedure FUN.008 func (q *Query4Audit) RuleForbiddenProcedure() Rule { var rule = q.RuleOK() // 由于vitess对某些语法的支持不完善,使得如创建临时表等语句无法通过语法检查 // 所以这里使用正则对触发器、临时表、存储过程等进行匹配 // 但是目前支持的也不是非常全面,有待完善匹配规则 // TODO TiDB 目前还不支持触发器、存储过程、自定义函数、外键 forbidden := []*regexp.Regexp{ regexp.MustCompile(`(?i)CREATE\s+PROCEDURE\s+`), } for _, reg := range forbidden { if reg.MatchString(q.Query) { rule = HeuristicRules["FUN.008"] if position := reg.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } break } } return rule } // RuleForbiddenFunction FUN.009 func (q *Query4Audit) RuleForbiddenFunction() Rule { var rule = q.RuleOK() // 由于vitess对某些语法的支持不完善,使得如创建临时表等语句无法通过语法检查 // 所以这里使用正则对触发器、临时表、存储过程等进行匹配 // 但是目前支持的也不是非常全面,有待完善匹配规则 // TODO TiDB 目前还不支持触发器、存储过程、自定义函数、外键 forbidden := []*regexp.Regexp{ regexp.MustCompile(`(?i)CREATE\s+FUNCTION\s+`), } for _, reg := range forbidden { if reg.MatchString(q.Query) { rule = HeuristicRules["FUN.009"] if position := reg.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } break } } return rule } // RulePatternMatchingUsage ARG.007 func (q *Query4Audit) RulePatternMatchingUsage() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.Select: re := regexp.MustCompile(`(?i)(\bregexp\b)|(\bsimilar to\b)`) if re.FindString(q.Query) != "" { rule = HeuristicRules["ARG.007"] } } return rule } // RuleSpaghettiQueryAlert CLA.012 func (q *Query4Audit) RuleSpaghettiQueryAlert() Rule { var rule = q.RuleOK() if len(query.Fingerprint(q.Query)) > common.Config.SpaghettiQueryLength { rule = HeuristicRules["CLA.012"] } return rule } // RuleReduceNumberOfJoin JOI.005 func (q *Query4Audit) RuleReduceNumberOfJoin() Rule { var rule = q.RuleOK() var tables []string switch q.Stmt.(type) { // TODO: UNION有可能有多张表,这里未检查UNION SELECT case *sqlparser.Union: return rule default: err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.AliasedTableExpr: switch table := n.Expr.(type) { case sqlparser.TableName: exist := false for _, t := range tables { if t == table.Name.String() { exist = true break } } if !exist { tables = append(tables, table.Name.String()) } } } return true, nil }, q.Stmt) common.LogIfError(err, "") } if len(tables) > common.Config.MaxJoinTableCount { rule = HeuristicRules["JOI.005"] } return rule } // RuleDistinctUsage DIS.001 func (q *Query4Audit) RuleDistinctUsage() Rule { // Distinct var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.Select: re := regexp.MustCompile(`(?i)(\bdistinct\b)`) if len(re.FindAllString(q.Query, -1)) > common.Config.MaxDistinctCount { rule = HeuristicRules["DIS.001"] } } return rule } // RuleCountDistinctMultiCol DIS.002 func (q *Query4Audit) RuleCountDistinctMultiCol() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.FuncExpr: str := strings.ToLower(sqlparser.String(n)) if strings.HasPrefix(str, "count") && strings.Contains(str, ",") { rule = HeuristicRules["DIS.002"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleDistinctStar DIS.003 func (q *Query4Audit) RuleDistinctStar() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.Select: meta := ast.GetMeta(q.Stmt, nil) for _, m := range meta { if len(m.Table) == 1 { // distinct tbl.* from tbl和 distinct * re := regexp.MustCompile(`(?i)((\s+distinct\s*\*)|(\s+distinct\s+[0-9a-z_` + "`" + `]*\.\*))`) if re.MatchString(q.Query) { rule = HeuristicRules["DIS.003"] } } break } } return rule } // RuleHavingClause CLA.013 func (q *Query4Audit) RuleHavingClause() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.Select: if expr.Having != nil { rule = HeuristicRules["CLA.013"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleUpdatePrimaryKey CLA.016 func (idxAdv *IndexAdvisor) RuleUpdatePrimaryKey() Rule { rule := HeuristicRules["OK"] switch node := idxAdv.Ast.(type) { case *sqlparser.Update: var setColumns []*common.Column err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node.(type) { case *sqlparser.UpdateExpr: // 获取 set 操作的全部 column setColumns = append(setColumns, ast.FindAllCols(node)...) } return true, nil }, node) common.LogIfError(err, "") setColumns = idxAdv.calcCardinality(CompleteColumnsInfo(idxAdv.Ast, setColumns, idxAdv.vEnv)) for _, col := range setColumns { idxMeta := idxAdv.IndexMeta[idxAdv.vEnv.DBHash(col.DB)][col.Table] if idxMeta == nil { return rule } for _, idx := range idxMeta.Rows { if strings.ToLower(idx.KeyName) == "primary" { if col.Name == idx.ColumnName { rule = HeuristicRules["CLA.016"] return rule } continue } } } } return rule } // RuleNestedSubQueries JOI.006 func (q *Query4Audit) RuleNestedSubQueries() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node.(type) { case *sqlparser.Subquery: rule = HeuristicRules["JOI.006"] return false, nil } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleMultiDeleteUpdate JOI.007 func (q *Query4Audit) RuleMultiDeleteUpdate() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.Delete, *sqlparser.Update: err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node.(type) { case *sqlparser.JoinTableExpr: rule = HeuristicRules["JOI.007"] return false, nil } return true, nil }, q.Stmt) common.LogIfError(err, "") } return rule } // RuleMultiDBJoin JOI.008 func (q *Query4Audit) RuleMultiDBJoin() Rule { var rule = q.RuleOK() meta := ast.GetMeta(q.Stmt, nil) dbCount := 0 for range meta { dbCount++ } if dbCount > 1 { err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node.(type) { case *sqlparser.JoinTableExpr: rule = HeuristicRules["JOI.008"] return false, nil } return true, nil }, q.Stmt) common.LogIfError(err, "") } return rule } // RuleORUsage ARG.008 func (q *Query4Audit) RuleORUsage() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.Select: err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.OrExpr: switch n.Left.(type) { case *sqlparser.IsExpr: // IS TRUE|FALSE|NULL eg. a = 1 or a IS NULL 这种情况也需要考虑 return true, nil } switch n.Right.(type) { case *sqlparser.IsExpr: // IS TRUE|FALSE|NULL eg. a = 1 or a IS NULL 这种情况也需要考虑 return true, nil } if strings.Fields(sqlparser.String(n.Left))[0] != strings.Fields(sqlparser.String(n.Right))[0] { // 不同字段需要区分开,不同字段的 OR 不能改写为 IN return true, nil } rule = HeuristicRules["ARG.008"] return false, nil } return true, nil }, q.Stmt) common.LogIfError(err, "") } return rule } // RuleSpaceWithQuote ARG.009 func (q *Query4Audit) RuleSpaceWithQuote() Rule { var rule = q.RuleOK() for _, tk := range ast.Tokenize(q.Query) { if tk.Type == ast.TokenTypeQuote { if len(tk.Val) >= 2 { // 序列化的Val是带引号,所以要取第2个和倒数第二个,这样也就不用担心len<2了。 switch tk.Val[1] { case ' ': rule = HeuristicRules["ARG.009"] } switch tk.Val[len(tk.Val)-2] { case ' ': rule = HeuristicRules["ARG.009"] } } } } return rule } // RuleHint ARG.010 // TODO: sql_no_cache, straight join func (q *Query4Audit) RuleHint() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.IndexHints: if n != nil { rule = HeuristicRules["ARG.010"] } return false, nil } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleNot ARG.011 func (q *Query4Audit) RuleNot() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.ComparisonExpr: if strings.HasPrefix(strings.ToLower(n.Operator), "not") { rule = HeuristicRules["ARG.011"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleInsertValues ARG.012 func (q *Query4Audit) RuleInsertValues() Rule { var rule = q.RuleOK() switch s := q.Stmt.(type) { case *sqlparser.Insert: switch val := s.Rows.(type) { case sqlparser.Values: if len(val) > common.Config.MaxValueCount { rule = HeuristicRules["ARG.012"] } } } return rule } // RuleFullWidthQuote ARG.013 func (q *Query4Audit) RuleFullWidthQuote() Rule { var rule = q.RuleOK() for _, node := range q.TiStmt { switch n := node.(type) { case *tidb.CreateTableStmt, *tidb.AlterTableStmt: var sb strings.Builder ctx := format.NewRestoreCtx(format.DefaultRestoreFlags, &sb) if err := n.Restore(ctx); err == nil { if strings.Contains(sb.String(), `“”`) || strings.Contains(sb.String(), `‘’`) { rule = HeuristicRules["ARG.013"] } } } } return rule } // RuleUNIONUsage SUB.002 func (q *Query4Audit) RuleUNIONUsage() Rule { var rule = q.RuleOK() switch s := q.Stmt.(type) { case *sqlparser.Union: if strings.ToLower(s.Type) == "union" { rule = HeuristicRules["SUB.002"] } } return rule } // RuleDistinctJoinUsage SUB.003 func (q *Query4Audit) RuleDistinctJoinUsage() Rule { var rule = q.RuleOK() switch expr := q.Stmt.(type) { case *sqlparser.Select: if expr.Distinct != "" { if expr.From != nil { if len(expr.From) > 1 { rule = HeuristicRules["SUB.003"] } } } } return rule } // RuleReadablePasswords SEC.002 func (q *Query4Audit) RuleReadablePasswords() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: re := regexp.MustCompile(`(?i)(password)|(password)|(pwd)`) for _, tiStmt := range q.TiStmt { // create table stmt switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeString, mysql.TypeVarchar, mysql.TypeVarString, mysql.TypeBlob, mysql.TypeTinyBlob, mysql.TypeMediumBlob: if re.FindString(q.Query) != "" { return HeuristicRules["SEC.002"] } } } case *tidb.AlterTableStmt: // alter table stmt for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableModifyColumn, tidb.AlterTableChangeColumn, tidb.AlterTableAddColumns: for _, col := range spec.NewColumns { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeString, mysql.TypeVarchar, mysql.TypeVarString, mysql.TypeBlob, mysql.TypeTinyBlob, mysql.TypeMediumBlob: if re.FindString(q.Query) != "" { return HeuristicRules["SEC.002"] } } } } } } } } return rule } // RuleDataDrop SEC.003 func (q *Query4Audit) RuleDataDrop() Rule { var rule = q.RuleOK() switch s := q.Stmt.(type) { case *sqlparser.DBDDL: if strings.ToLower(s.Action) == "drop" { rule = HeuristicRules["SEC.003"] } case *sqlparser.DDL: if strings.ToLower(s.Action) == "drop" || strings.ToLower(s.Action) == "truncate" { rule = HeuristicRules["SEC.003"] } case *sqlparser.Delete: rule = HeuristicRules["SEC.003"] } return rule } // RuleInjection SEC.004 func (q *Query4Audit) RuleInjection() Rule { var rule = q.RuleOK() if q.TiStmt != nil { json := ast.StmtNode2JSON(q.Query, "", "") fs := common.JSONFind(json, "FnName") for _, f := range fs { functionName := gjson.Get(f, "L") switch functionName.String() { case "sleep", "benchmark", "get_lock", "release_lock": // Ref: https://www.k0rz3n.com/2019/02/01/一篇文章带你深入理解%20SQL%20盲注/ rule = HeuristicRules["SEC.004"] } } } return rule } // RuleCompareWithFunction FUN.001 func (q *Query4Audit) RuleCompareWithFunction() Rule { var rule = q.RuleOK() // `select id from t where num/2 = 100`, err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { // Vitess 中有些函数进行了单独定义不在 FuncExpr 中,如: substring。所以不能直接用 FuncExpr 判断。 switch n := node.(type) { case *sqlparser.ComparisonExpr: switch n.Left.(type) { case *sqlparser.SQLVal, *sqlparser.ColName: default: rule = HeuristicRules["FUN.001"] return false, nil } } return true, nil }, q.Stmt) common.LogIfError(err, "") // select id from t where substring(name,1,3)='abc'; for _, tiStmt := range q.TiStmt { switch tiStmt.(type) { case *tidb.SelectStmt, *tidb.UpdateStmt, *tidb.DeleteStmt: json := ast.StmtNode2JSON(q.Query, "", "") whereJSON := common.JSONFind(json, "Where") for _, where := range whereJSON { if len(common.JSONFind(where, "FnName")) > 0 { rule = HeuristicRules["FUN.001"] } break } } } return rule } // RuleCountStar FUN.002 func (q *Query4Audit) RuleCountStar() Rule { var rule = q.RuleOK() switch n := q.Stmt.(type) { case *sqlparser.Select: // count(N), count(col), count(*) re := regexp.MustCompile(`(?i)(count\(\s*[*0-9a-z_` + "`" + `]*\s*\))`) if re.FindString(q.Query) != "" && n.Where != nil { rule = HeuristicRules["FUN.002"] } } return rule } // RuleTruncateTable SEC.001 func (q *Query4Audit) RuleTruncateTable() Rule { var rule = q.RuleOK() switch s := q.Stmt.(type) { case *sqlparser.DDL: if strings.ToLower(s.Action) == "truncate" { rule = HeuristicRules["SEC.001"] } } return rule } // RuleIn ARG.005 && ARG.004 && ARG.014 func (q *Query4Audit) RuleIn() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case *sqlparser.ComparisonExpr: switch strings.ToLower(n.Operator) { case "in": switch r := n.Right.(type) { case *sqlparser.Subquery: // by pass sub query // id in (select id from tb where xxx) break case sqlparser.ValTuple: // IN (NULL) for _, v := range r { switch v.(type) { case *sqlparser.NullVal: rule = HeuristicRules["ARG.004"] return false, nil case *sqlparser.ColName: // id in (1, 2, id), always true. rule = HeuristicRules["ARG.014"] return false, nil } } if len(r) > common.Config.MaxInCount { rule = HeuristicRules["ARG.005"] return false, nil } //default: // debug // fmt.Println("Type: ", reflect.TypeOf(n.Right).String()) } case "not in": switch r := n.Right.(type) { case sqlparser.ValTuple: // NOT IN (NULL) for _, v := range r { switch v.(type) { case *sqlparser.NullVal: rule = HeuristicRules["ARG.004"] return false, nil } } } } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleIsNullIsNotNull ARG.006 func (q *Query4Audit) RuleIsNullIsNotNull() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.Select: re := regexp.MustCompile(`(?i)is\s*(not)?\s+null\b`) if re.FindString(q.Query) != "" { rule = HeuristicRules["ARG.006"] } } return rule } // RuleVarcharVSChar COL.008 func (q *Query4Audit) RuleVarcharVSChar() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { // 在 TiDB 的 AST 中,char 和 binary 的 type 都是 mysql.TypeString // 只是 binary 数据类型的 character 和 collate 是 binary case mysql.TypeString: rule = HeuristicRules["COL.008"] } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableChangeColumn, tidb.AlterTableModifyColumn: for _, col := range spec.NewColumns { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeString: rule = HeuristicRules["COL.008"] } } } } } } } return rule } // RuleCreateDualTable TBL.003 func (q *Query4Audit) RuleCreateDualTable() Rule { var rule = q.RuleOK() switch s := q.Stmt.(type) { case *sqlparser.DDL: if s.Table.Name.String() == "dual" { rule = HeuristicRules["TBL.003"] } } return rule } // RuleAlterCharset ALT.001 func (q *Query4Audit) RuleAlterCharset() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableOption: for _, option := range spec.Options { if option.Tp == tidb.TableOptionCharset || option.Tp == tidb.TableOptionCollate { //增加CONVERT TO的判断 convertReg, _ := regexp.Compile("convert\\b\\s+to") if convertReg.Match([]byte(strings.ToLower(q.Query))) { break } else { rule = HeuristicRules["ALT.001"] break } } } } if rule.Item == "ALT.001" { break } } } } } return rule } // RuleAlterDropColumn ALT.003 func (q *Query4Audit) RuleAlterDropColumn() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableDropColumn: rule = HeuristicRules["ALT.003"] } } } } if rule.Item == "ALT.003" { re := regexp.MustCompile(`(?i)(drop\s+column)`) if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } } } return rule } // RuleAlterDropKey ALT.004 func (q *Query4Audit) RuleAlterDropKey() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableDropPrimaryKey, tidb.AlterTableDropIndex, tidb.AlterTableDropForeignKey: rule = HeuristicRules["ALT.004"] } } } } } return rule } // RuleBLOBNotNull COL.012 func (q *Query4Audit) RuleBLOBNotNull() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeBlob, mysql.TypeTinyBlob, mysql.TypeMediumBlob, mysql.TypeLongBlob, mysql.TypeJSON: for _, opt := range col.Options { if opt.Tp == tidb.ColumnOptionNotNull { rule = HeuristicRules["COL.012"] break } } if mysql.HasNotNullFlag(col.Tp.Flag) { rule = HeuristicRules["COL.012"] break } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableModifyColumn, tidb.AlterTableChangeColumn: for _, col := range spec.NewColumns { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeBlob, mysql.TypeTinyBlob, mysql.TypeMediumBlob, mysql.TypeLongBlob, mysql.TypeJSON: for _, opt := range col.Options { if opt.Tp == tidb.ColumnOptionNotNull { rule = HeuristicRules["COL.012"] break } } if mysql.HasNotNullFlag(col.Tp.Flag) { rule = HeuristicRules["COL.012"] break } } } } } } } } return rule } // RuleTooManyKeys KEY.005 func (q *Query4Audit) RuleTooManyKeys() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: if len(node.Constraints) > common.Config.MaxIdxCount { rule = HeuristicRules["KEY.005"] } } } } return rule } // RuleTooManyKeyParts KEY.006 func (q *Query4Audit) RuleTooManyKeyParts() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, constraint := range node.Constraints { if len(constraint.Keys) > common.Config.MaxIdxColsCount { return HeuristicRules["KEY.006"] } if constraint.Refer != nil && len(constraint.Refer.IndexPartSpecifications) > common.Config.MaxIdxColsCount { return HeuristicRules["KEY.006"] } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddConstraint: if spec.Constraint != nil { if len(spec.Constraint.Keys) > common.Config.MaxIdxColsCount { return HeuristicRules["KEY.006"] } if spec.Constraint.Refer != nil { if len(spec.Constraint.Refer.IndexPartSpecifications) > common.Config.MaxIdxColsCount { return HeuristicRules["KEY.006"] } } } } } } } } return rule } // RulePKNotInt KEY.007 && KEY.001 func (q *Query4Audit) RulePKNotInt() Rule { var rule = q.RuleOK() var pk sqlparser.ColIdent switch s := q.Stmt.(type) { case *sqlparser.DDL: if strings.ToLower(s.Action) == "create" { if s.TableSpec == nil { return rule } for _, idx := range s.TableSpec.Indexes { if strings.ToLower(idx.Info.Type) == "primary key" { if len(idx.Columns) == 1 { pk = idx.Columns[0].Column break } } } // 未指定主键 if pk.String() == "" { rule = HeuristicRules["KEY.007"] return rule } // 主键非int, bigint类型 for _, col := range s.TableSpec.Columns { if pk.String() == col.Name.String() { switch strings.ToLower(col.Type.Type) { case "int", "bigint", "integer": if !col.Type.Unsigned { rule = HeuristicRules["KEY.007"] } if !col.Type.Autoincrement { rule = HeuristicRules["KEY.001"] } default: rule = HeuristicRules["KEY.007"] } } } } } return rule } // RuleOrderByMultiDirection KEY.008 func (q *Query4Audit) RuleOrderByMultiDirection() Rule { var rule = q.RuleOK() err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch n := node.(type) { case sqlparser.OrderBy: order := "" for _, col := range strings.Split(sqlparser.String(n), ",") { orders := strings.Split(col, " ") if order != "" && order != orders[len(orders)-1] { rule = HeuristicRules["KEY.008"] return false, nil } order = orders[len(orders)-1] } } return true, nil }, q.Stmt) common.LogIfError(err, "") return rule } // RuleUniqueKeyDup KEY.009 // TODO: 目前只是给建议,期望能够实现自动检查 func (q *Query4Audit) RuleUniqueKeyDup() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateIndexStmt: // create index if node.KeyType == tidb.IndexKeyTypeUnique { re := regexp.MustCompile(`(?i)(create\s+(unique)\s)`) rule = HeuristicRules["KEY.009"] if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } return rule } case *tidb.AlterTableStmt: // alter table add constraint for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddConstraint: if spec.Constraint == nil { continue } switch spec.Constraint.Tp { case tidb.ConstraintPrimaryKey, tidb.ConstraintUniq, tidb.ConstraintUniqKey, tidb.ConstraintUniqIndex: re := regexp.MustCompile(`(?i)(add\s+(unique)\s)`) rule = HeuristicRules["KEY.009"] if position := re.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } return rule } } } } } } return rule } // RuleFulltextIndex KEY.010 func (q *Query4Audit) RuleFulltextIndex() Rule { var rule = q.RuleOK() /* // TiDB parser for _, tiStmt := range q.TiStmt { switch tiStmt.(type) { case *tidb.CreateTableStmt, *tidb.AlterTableStmt: default: return rule } } */ switch q.Stmt.(type) { case *sqlparser.DDL: default: return rule } tks := ast.Tokenize(q.Query) for _, tk := range tks { switch tk.Type { case ast.TokenTypeWord: if strings.TrimSpace(strings.ToLower(tk.Val)) == "fulltext" { rule = HeuristicRules["KEY.010"] } default: } } return rule } // RuleTimestampDefault COL.013 func (q *Query4Audit) RuleTimestampDefault() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeTimestamp, mysql.TypeDate, mysql.TypeDatetime, mysql.TypeNewDate: hasDefault := false var sb strings.Builder ctx := format.NewRestoreCtx(format.DefaultRestoreFlags, &sb) for _, option := range col.Options { if option.Tp == tidb.ColumnOptionDefaultValue { hasDefault = true if err := option.Restore(ctx); err == nil { if strings.HasPrefix(strings.ToLower(sb.String()), `default '0`) || strings.HasPrefix(strings.ToLower(sb.String()), `default 0`) { hasDefault = false } } } } if !hasDefault { rule = HeuristicRules["COL.013"] break } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableModifyColumn, tidb.AlterTableChangeColumn, tidb.AlterTableAlterColumn: for _, col := range spec.NewColumns { if col.Tp == nil { continue } var sb strings.Builder ctx := format.NewRestoreCtx(format.DefaultRestoreFlags, &sb) switch col.Tp.Tp { case mysql.TypeTimestamp, mysql.TypeDate, mysql.TypeDatetime, mysql.TypeNewDate: hasDefault := false for _, option := range col.Options { if option.Tp == tidb.ColumnOptionDefaultValue { hasDefault = true if err := option.Restore(ctx); err == nil { if strings.HasPrefix(strings.ToLower(sb.String()), `default '0`) || strings.HasPrefix(strings.ToLower(sb.String()), `default 0`) || strings.HasPrefix(strings.ToLower(sb.String()), `default _utf8mb4'0`) || strings.HasPrefix(strings.ToLower(sb.String()), `default _utf8'0`) { hasDefault = false } } } } if !hasDefault { rule = HeuristicRules["COL.013"] break } } } } } } } } return rule } // RuleAutoIncrementInitNotZero TBL.004 func (q *Query4Audit) RuleAutoIncrementInitNotZero() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, opt := range node.Options { if opt.Tp == tidb.TableOptionAutoIncrement && opt.UintValue > 1 { rule = HeuristicRules["TBL.004"] } } } } } return rule } // RuleColumnWithCharset COL.014 func (q *Query4Audit) RuleColumnWithCharset() Rule { var rule = q.RuleOK() tks := ast.Tokenize(q.Query) for _, tk := range tks { if tk.Type == ast.TokenTypeWord { switch strings.TrimSpace(strings.ToLower(tk.Val)) { //character移到后面检查 case "national", "nvarchar", "nchar", "nvarchar(", "nchar(": rule = HeuristicRules["COL.014"] return rule } } } switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } if col.Tp.Charset != "" || col.Tp.Collate != "" { if col.Tp.Charset == "binary" || col.Tp.Collate == "binary" { continue } else { rule = HeuristicRules["COL.014"] break } } //在这里检查character characterReg, _ := regexp.Compile("character set") if characterReg.Match([]byte(strings.ToLower(q.Query))) { rule = HeuristicRules["COL.014"] break } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAlterColumn, tidb.AlterTableChangeColumn, tidb.AlterTableModifyColumn, tidb.AlterTableAddColumns: for _, col := range spec.NewColumns { if col.Tp == nil { continue } if col.Tp.Charset != "" || col.Tp.Collate != "" { if col.Tp.Charset == "binary" || col.Tp.Collate == "binary" { continue } else { rule = HeuristicRules["COL.014"] break } } characterReg, _ := regexp.Compile("character set") if characterReg.Match([]byte(strings.ToLower(q.Query))) { rule = HeuristicRules["COL.014"] break } } } } } } } return rule } // RuleTableCharsetCheck TBL.005 func (q *Query4Audit) RuleTableCharsetCheck() Rule { var rule = q.RuleOK() var allow bool var hasCharset bool switch q.Stmt.(type) { case *sqlparser.DDL, *sqlparser.DBDDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, opt := range node.Options { if opt.Tp == tidb.TableOptionCharset { hasCharset = true for _, ch := range common.Config.AllowCharsets { if strings.TrimSpace(strings.ToLower(ch)) == strings.TrimSpace(strings.ToLower(opt.StrValue)) { allow = true break } } } } case *tidb.CreateDatabaseStmt: for _, opt := range node.Options { if opt.Tp == tidb.DatabaseOptionCharset { hasCharset = true for _, ch := range common.Config.AllowCharsets { if strings.TrimSpace(strings.ToLower(ch)) == strings.TrimSpace(strings.ToLower(opt.Value)) { allow = true break } } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableOption: for _, opt := range spec.Options { if opt.Tp == tidb.TableOptionCharset { hasCharset = true for _, ch := range common.Config.AllowCharsets { if strings.TrimSpace(strings.ToLower(ch)) == strings.TrimSpace(strings.ToLower(opt.StrValue)) { allow = true break } } } } } } } } } // 未指定字符集使用MySQL默认配置字符集,我们认为MySQL的配置是被优化过的。 if hasCharset && !allow { rule = HeuristicRules["TBL.005"] } return rule } // RuleForbiddenView TBL.006 func (q *Query4Audit) RuleForbiddenView() Rule { var rule = q.RuleOK() // 由于vitess对某些语法的支持不完善,使得如创建临时表等语句无法通过语法检查 // 所以这里使用正则对触发器、临时表、存储过程等进行匹配 // 但是目前支持的也不是非常全面,有待完善匹配规则 // TODO TiDB 目前还不支持触发器、存储过程、自定义函数、外键 forbidden := []*regexp.Regexp{ regexp.MustCompile(`(?i)CREATE\s+VIEW\s+`), regexp.MustCompile(`(?i)REPLACE\s+VIEW\s+`), } for _, reg := range forbidden { if reg.MatchString(q.Query) { rule = HeuristicRules["TBL.006"] if position := reg.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } break } } return rule } // RuleForbiddenTempTable TBL.007 func (q *Query4Audit) RuleForbiddenTempTable() Rule { var rule = q.RuleOK() // 由于vitess对某些语法的支持不完善,使得如创建临时表等语句无法通过语法检查 // 所以这里使用正则对触发器、临时表、存储过程等进行匹配 // 但是目前支持的也不是非常全面,有待完善匹配规则 // TODO TiDB 目前还不支持触发器、存储过程、自定义函数、外键 forbidden := []*regexp.Regexp{ regexp.MustCompile(`(?i)CREATE\s+TEMPORARY\s+TABLE\s+`), } for _, reg := range forbidden { if reg.MatchString(q.Query) { rule = HeuristicRules["TBL.007"] if position := reg.FindIndex([]byte(q.Query)); len(position) > 0 { rule.Position = position[0] } break } } return rule } // RuleTableCollateCheck TBL.008 func (q *Query4Audit) RuleTableCollateCheck() Rule { var rule = q.RuleOK() var allow bool var hasCollate bool switch q.Stmt.(type) { case *sqlparser.DDL, *sqlparser.DBDDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, opt := range node.Options { if opt.Tp == tidb.TableOptionCollate { hasCollate = true for _, ch := range common.Config.AllowCollates { if strings.TrimSpace(strings.ToLower(ch)) == strings.TrimSpace(strings.ToLower(opt.StrValue)) { allow = true break } } } } case *tidb.CreateDatabaseStmt: for _, opt := range node.Options { if opt.Tp == tidb.DatabaseOptionCollate { hasCollate = true for _, ch := range common.Config.AllowCollates { if strings.TrimSpace(strings.ToLower(ch)) == strings.TrimSpace(strings.ToLower(opt.Value)) { allow = true break } } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableOption: for _, opt := range spec.Options { if opt.Tp == tidb.TableOptionCollate { hasCollate = true for _, ch := range common.Config.AllowCollates { if strings.TrimSpace(strings.ToLower(ch)) == strings.TrimSpace(strings.ToLower(opt.StrValue)) { allow = true break } } } } } } } } } // 未指定字符集使用MySQL默认配置COLLATE,我们认为MySQL的配置是被优化过的。 if hasCollate && !allow { rule = HeuristicRules["TBL.008"] } return rule } // RuleBlobDefaultValue COL.015 func (q *Query4Audit) RuleBlobDefaultValue() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeBlob, mysql.TypeMediumBlob, mysql.TypeTinyBlob, mysql.TypeLongBlob, mysql.TypeJSON: for _, opt := range col.Options { if opt.Tp == tidb.ColumnOptionDefaultValue && opt.Expr.GetType().Tp != mysql.TypeNull { rule = HeuristicRules["COL.015"] break } } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableModifyColumn, tidb.AlterTableAlterColumn, tidb.AlterTableChangeColumn, tidb.AlterTableAddColumns: for _, col := range spec.NewColumns { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeBlob, mysql.TypeMediumBlob, mysql.TypeTinyBlob, mysql.TypeLongBlob, mysql.TypeJSON: for _, opt := range col.Options { if opt.Tp == tidb.ColumnOptionDefaultValue && opt.Expr.GetType().Tp != mysql.TypeNull { rule = HeuristicRules["COL.015"] break } } } } } } } } } return rule } // RuleIntPrecision COL.016 func (q *Query4Audit) RuleIntPrecision() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeLong: if (col.Tp.Flen < 10 || col.Tp.Flen > 11) && col.Tp.Flen > 0 { // 有些语言 ORM 框架会生成 int(11),有些语言的框架生成 int(10) rule = HeuristicRules["COL.016"] break } case mysql.TypeLonglong: if (col.Tp.Flen != 20) && col.Tp.Flen > 0 { rule = HeuristicRules["COL.016"] break } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableChangeColumn, tidb.AlterTableAlterColumn, tidb.AlterTableModifyColumn: for _, col := range spec.NewColumns { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeLong: if (col.Tp.Flen < 10 || col.Tp.Flen > 11) && col.Tp.Flen > 0 { // 有些语言 ORM 框架会生成 int(11),有些语言的框架生成 int(10) rule = HeuristicRules["COL.016"] break } case mysql.TypeLonglong: if col.Tp.Flen != 20 && col.Tp.Flen > 0 { rule = HeuristicRules["COL.016"] break } } } } } } } } return rule } // RuleVarcharLength COL.017 func (q *Query4Audit) RuleVarcharLength() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeVarchar, mysql.TypeVarString: if col.Tp.Flen > common.Config.MaxVarcharLength { rule = HeuristicRules["COL.017"] break } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableAddColumns, tidb.AlterTableChangeColumn, tidb.AlterTableAlterColumn, tidb.AlterTableModifyColumn: for _, col := range spec.NewColumns { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeVarchar, mysql.TypeVarString: if col.Tp.Flen > common.Config.MaxVarcharLength { rule = HeuristicRules["COL.017"] break } } } } } } } } return rule } // RuleColumnNotAllowType COL.018 func (q *Query4Audit) RuleColumnNotAllowType() Rule { var rule = q.RuleOK() if len(common.Config.ColumnNotAllowType) == 0 { return rule } switch s := q.Stmt.(type) { case *sqlparser.DDL: switch strings.ToLower(s.Action) { case "create", "alter": tks := ast.Tokenize(q.Query) for _, tk := range tks { if tk.Type == ast.TokenTypeWord { for _, tp := range common.Config.ColumnNotAllowType { if len(tk.Val) <= len(tp)+1 && strings.HasPrefix(strings.ToLower(tk.Val), strings.ToLower(tp)) { rule = HeuristicRules["COL.018"] break } } } if rule.Item != "OK" { break } } } } return rule } // RuleTimePrecision COL.019 func (q *Query4Audit) RuleTimePrecision() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeDatetime, mysql.TypeTimestamp, mysql.TypeDuration: if col.Tp.Decimal > 0 { rule = HeuristicRules["COL.019"] } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableChangeColumn, tidb.AlterTableAlterColumn, tidb.AlterTableModifyColumn, tidb.AlterTableAddColumns: for _, col := range spec.NewColumns { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeDatetime, mysql.TypeTimestamp, mysql.TypeDuration: if col.Tp.Decimal > 0 { rule = HeuristicRules["COL.019"] } } } } } } } } return rule } // RuleNoOSCKey KEY.002 func (q *Query4Audit) RuleNoOSCKey() Rule { var rule = q.RuleOK() switch s := q.Stmt.(type) { case *sqlparser.DDL: if strings.ToLower(s.Action) == "create" { pkReg := regexp.MustCompile(`(?i)(primary\s+key)`) if !pkReg.MatchString(q.Query) { ukReg := regexp.MustCompile(`(?i)(unique\s+((key)|(index)))`) if !ukReg.MatchString(q.Query) { rule = HeuristicRules["KEY.002"] } } } } return rule } // RuleTooManyFields COL.006 func (q *Query4Audit) RuleTooManyFields() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: if len(node.Cols) > common.Config.MaxColCount { rule = HeuristicRules["COL.006"] } } } } return rule } // RuleMaxTextColsCount COL.007 func (q *Query4Audit) RuleMaxTextColsCount() Rule { var textColsCount int var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } switch col.Tp.Tp { case mysql.TypeBlob, mysql.TypeLongBlob, mysql.TypeMediumBlob, mysql.TypeTinyBlob: textColsCount++ } } } } } if textColsCount > common.Config.MaxTextColsCount { rule = HeuristicRules["COL.007"] } return rule } // RuleMaxTextColsCount COL.007 checking for existed table func (idxAdv *IndexAdvisor) RuleMaxTextColsCount() Rule { rule := HeuristicRules["OK"] // 未开启测试环境不进行检查 if common.Config.TestDSN.Disable { return rule } err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch stmt := node.(type) { case *sqlparser.DDL: if strings.ToLower(stmt.Action) != "alter" { return true, nil } // 添加字段的语句会在初始化环境的时候被执行 // 只需要获取该标的 CREATE 语句,后再对该语句进行检查即可 ddl, err := idxAdv.vEnv.ShowCreateTable(stmt.Table.Name.String()) if err != nil { common.Log.Error("RuleMaxTextColsCount create statement got failed: %s", err.Error()) return false, err } q, err := NewQuery4Audit(ddl) if err != nil { return false, err } r := q.RuleMaxTextColsCount() if r.Item != "OK" { rule = r return false, nil } } return true, nil }, idxAdv.Ast) common.LogIfError(err, "") return rule } // RuleAllowEngine TBL.002 func (q *Query4Audit) RuleAllowEngine() Rule { var rule = q.RuleOK() var hasDefaultEngine bool var allowedEngine bool switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, opt := range node.Options { if opt.Tp == tidb.TableOptionEngine { hasDefaultEngine = true // 使用了非推荐的存储引擎 for _, engine := range common.Config.AllowEngines { if strings.EqualFold(opt.StrValue, engine) { allowedEngine = true } } // common.Config.AllowEngines 为空时不给予建议 if !allowedEngine && len(common.Config.AllowEngines) > 0 { rule = HeuristicRules["TBL.002"] break } } } // 建表语句未指定表的存储引擎 if !hasDefaultEngine { rule = HeuristicRules["TBL.002"] break } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableOption: for _, opt := range spec.Options { if opt.Tp == tidb.TableOptionEngine { // 使用了非推荐的存储引擎 for _, engine := range common.Config.AllowEngines { if strings.EqualFold(opt.StrValue, engine) { allowedEngine = true } } // common.Config.AllowEngines 为空时不给予建议 if !allowedEngine && len(common.Config.AllowEngines) > 0 { rule = HeuristicRules["TBL.002"] break } } } } } } } } return rule } // RulePartitionNotAllowed TBL.001 func (q *Query4Audit) RulePartitionNotAllowed() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: if node.Partition != nil { rule = HeuristicRules["TBL.001"] break } case *tidb.AlterTableStmt: for _, spec := range node.Specs { if len(spec.PartDefinitions) > 0 { rule = HeuristicRules["TBL.001"] break } } } } } return rule } // RuleAutoIncUnsigned COL.003: func (q *Query4Audit) RuleAutoIncUnsigned() Rule { var rule = q.RuleOK() switch q.Stmt.(type) { case *sqlparser.DDL: for _, tiStmt := range q.TiStmt { switch node := tiStmt.(type) { case *tidb.CreateTableStmt: for _, col := range node.Cols { if col.Tp == nil { continue } for _, opt := range col.Options { if opt.Tp == tidb.ColumnOptionAutoIncrement { if !mysql.HasUnsignedFlag(col.Tp.Flag) { rule = HeuristicRules["COL.003"] break } } if rule.Item == "COL.003" { break } } } case *tidb.AlterTableStmt: for _, spec := range node.Specs { switch spec.Tp { case tidb.AlterTableChangeColumn, tidb.AlterTableAlterColumn, tidb.AlterTableModifyColumn, tidb.AlterTableAddColumns: for _, col := range spec.NewColumns { if col.Tp == nil { continue } for _, opt := range col.Options { if opt.Tp == tidb.ColumnOptionAutoIncrement { if !mysql.HasUnsignedFlag(col.Tp.Flag) { rule = HeuristicRules["COL.003"] break } } if rule.Item == "COL.003" { break } } } } } } } } return rule } // RuleSpaceAfterDot STA.002 func (q *Query4Audit) RuleSpaceAfterDot() Rule { var rule = q.RuleOK() tks := ast.Tokenize(q.Query) for i, tk := range tks { switch tk.Type { // SELECT * FROM db. tbl // SELECT tbl. col FROM tbl case ast.TokenTypeWord: if len(tks) > i+1 && tks[i+1].Type == ast.TokenTypeWhitespace && strings.HasSuffix(tk.Val, ".") { common.Log.Debug("RuleSpaceAfterDot: ", tk.Val, tks[i+1].Val) rule = HeuristicRules["STA.002"] return rule } default: } } return rule } // RuleIdxPrefix STA.003 func (q *Query4Audit) RuleIdxPrefix() Rule { var rule = q.RuleOK() for _, node := range q.TiStmt { switch n := node.(type) { case *tidb.CreateTableStmt: for _, c := range n.Constraints { switch c.Tp { case tidb.ConstraintIndex, tidb.ConstraintKey: if !strings.HasPrefix(c.Name, common.Config.IdxPrefix) { rule = HeuristicRules["STA.003"] } case tidb.ConstraintUniq, tidb.ConstraintUniqKey, tidb.ConstraintUniqIndex: if !strings.HasPrefix(c.Name, common.Config.UkPrefix) { rule = HeuristicRules["STA.003"] } } } case *tidb.AlterTableStmt: for _, s := range n.Specs { switch s.Tp { case tidb.AlterTableAddConstraint: switch s.Constraint.Tp { case tidb.ConstraintIndex, tidb.ConstraintKey: if !strings.HasPrefix(s.Constraint.Name, common.Config.IdxPrefix) { rule = HeuristicRules["STA.003"] } case tidb.ConstraintUniq, tidb.ConstraintUniqKey, tidb.ConstraintUniqIndex: if !strings.HasPrefix(s.Constraint.Name, common.Config.UkPrefix) { rule = HeuristicRules["STA.003"] } } } } } } return rule } // RuleStandardName STA.004 func (q *Query4Audit) RuleStandardName() Rule { var rule = q.RuleOK() allowReg := regexp.MustCompile(`(?i)[a-z0-9_` + "`" + `]`) for _, tk := range ast.Tokenize(q.Query) { if tk.Val == "``" { rule = HeuristicRules["STA.004"] } switch tk.Type { // 反引号中可能有乱七八糟的东西 case ast.TokenTypeBacktickQuote: // 特殊字符,连续下划线 if allowReg.ReplaceAllString(tk.Val, "") != "" || strings.Contains(tk.Val, "__") { rule = HeuristicRules["STA.004"] } // 统一大小写 if !(strings.ToLower(tk.Val) == tk.Val || strings.ToUpper(tk.Val) == tk.Val) { rule = HeuristicRules["STA.004"] } case ast.TokenTypeWord: // TOKEN_TYPE_WORD 中处理连续下划线的情况,其他情况容易误伤 if strings.Contains(tk.Val, "__") { rule = HeuristicRules["STA.004"] } default: } } return rule } // MergeConflictHeuristicRules merge conflict rules func MergeConflictHeuristicRules(rules map[string]Rule) map[string]Rule { // KWR.001 VS ERR.000 // select sql_calc_found_rows * from film if _, ok := rules["KWR.001"]; ok { delete(rules, "ERR.000") } // SUB.001 VS OWN.004 VS JOI.006 if _, ok := rules["SUB.001"]; ok { delete(rules, "ARG.005") delete(rules, "JOI.006") } // SUB.004 VS SUB.001 if _, ok := rules["SUB.004"]; ok { delete(rules, "SUB.001") } // KEY.007 VS KEY.002 if _, ok := rules["KEY.007"]; ok { delete(rules, "KEY.002") } // JOI.002 VS JOI.006 if _, ok := rules["JOI.002"]; ok { delete(rules, "JOI.006") } // JOI.008 VS JOI.007 if _, ok := rules["JOI.008"]; ok { delete(rules, "JOI.007") } return rules } // RuleMySQLError ERR.XXX func RuleMySQLError(item string, err error) Rule { type MySQLError struct { ErrCode string ErrString string } // tidb parser 语法检查出错返回的是ERR.000 switch item { case "ERR.000": return Rule{ Item: item, Summary: "No available MySQL environment, build-in sql parse failed: " + err.Error(), Severity: "L8", Content: err.Error(), } } errStr := err.Error() // Error 1071: Specified key was too long; max key length is 3072 bytes errReg := regexp.MustCompile(`(?i)Error ([0-9]+): (.*)`) if strings.HasPrefix(errStr, "Received") { // Received #1146 error from MySQL server: "table xxx doesn't exist" errReg = regexp.MustCompile(`(?i)Received #([0-9]+) error from MySQL server: ['"](.*)['"]`) } msg := errReg.FindStringSubmatch(errStr) var mysqlError MySQLError if len(msg) == 3 { if msg[1] != "" && msg[2] != "" { mysqlError = MySQLError{ ErrCode: msg[1], ErrString: msg[2], } } } else { var errcode string if strings.HasPrefix(err.Error(), "syntax error at position") { errcode = "1064" } mysqlError = MySQLError{ ErrCode: errcode, ErrString: err.Error(), } } switch mysqlError.ErrCode { // 1146 ER_NO_SUCH_TABLE case "", "1146": return Rule{ Item: item, Summary: "MySQL execute failed: ", Severity: "L0", Content: "", } default: return Rule{ Item: item, Summary: "MySQL execute failed", Severity: "L8", Content: mysqlError.ErrString, } } } ================================================ FILE: advisor/heuristic_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package advisor import ( "errors" "sort" "testing" "github.com/XiaoMi/soar/common" "github.com/XiaoMi/soar/env" "github.com/kr/pretty" "vitess.io/vitess/go/vt/sqlparser" ) // ALI.001 func TestRuleImplicitAlias(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "select col c from tbl where id < 1000", "select col from tbl tb where id < 1000", }, { "select 1", }, } for _, sql := range sqls[0] { q, _ := NewQuery4Audit(sql) rule := q.RuleImplicitAlias() if rule.Item != "ALI.001" { t.Error("Rule not match:", rule.Item, "Expect : ALI.001") } } for _, sql := range sqls[1] { q, _ := NewQuery4Audit(sql) rule := q.RuleImplicitAlias() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ALI.002 func TestRuleStarAlias(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "select tbl.* AS c1,c2,c3 from tbl where id < 1000", "SELECT * as", }, { `SELECT c1, c2, c3, FROM tb WHERE id < 1000 AND content="mytest* as test"`, `select *`, }, } for _, sql := range sqls[0] { q, _ := NewQuery4Audit(sql) rule := q.RuleStarAlias() if rule.Item != "ALI.002" { t.Error("Rule not match:", rule.Item, "Expect : ALI.002") } } for _, sql := range sqls[1] { q, _ := NewQuery4Audit(sql) rule := q.RuleStarAlias() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ALI.003 func TestRuleSameAlias(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select col as col from tbl where id < 1000", "select col from tbl as tbl where id < 1000", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSameAlias() if rule.Item != "ALI.003" { t.Error("Rule not match:", rule.Item, "Expect : ALI.003") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.001 func TestRulePrefixLike(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select col from tbl where id like '%abc'", "select col from tbl where id like '_abc'", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RulePrefixLike() if rule.Item != "ARG.001" { t.Error("Rule not match:", rule.Item, "Expect : ARG.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.002 func TestRuleEqualLike(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "select col from tbl where id like 'abc'", "select col from tbl where id like 1", }, { "select col from tbl where id like 'abc%'", "select col from tbl where id like '%abc'", "select col from tbl where id like 'a%c'", // issue #273 }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleEqualLike() if rule.Item != "ARG.002" { t.Error("Rule not match:", rule.Item, "Expect : ARG.002") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleEqualLike() if rule.Item == "ARG.002" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.003 // TODO: func TestTimeFormatError(t *testing.T) { rightTimes := []string{ `2020-01-01`, `2020-01-01 23:59:59`, `2020-01-01 23:59:59.0`, // 0ms `2020-01-01 23:59:59.123`, // 123ms } for _, rt := range rightTimes { if !timeFormatCheck(rt) { t.Error("wrong time format") } } wrongTimes := []string{ ``, // 空时间 `2020-01-01 abc`, // 含英文字符 `2020–02-15 23:59:59`, // 2020 后面的不是减号,是个 连接符 } for _, wt := range wrongTimes { if timeFormatCheck(wt) { t.Error("wrong time format") } } } // CLA.001 func TestRuleNoWhere(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ {"select col from tbl", "delete from tbl", "update tbl set col=1", "insert into city (country_id) select country_id from country", }, { `select 1;`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNoWhere() if rule.Item != "CLA.001" && rule.Item != "CLA.014" && rule.Item != "CLA.015" { t.Error("Rule not match:", rule.Item, "Expect : CLA.001/CLA.014/CLA.015") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNoWhere() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.002 func TestRuleOrderByRand(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select col from tbl where id = 1 order by rand()", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleOrderByRand() if rule.Item != "CLA.002" { t.Error("Rule not match:", rule.Item, "Expect : CLA.002") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.003 func TestRuleOffsetLimit(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select c1,c2 from tbl where name=xx order by number limit 1 offset 2000", "select c1,c2 from tbl where name=xx order by number limit 2000,1", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleOffsetLimit() if rule.Item != "CLA.003" { t.Error("Rule not match:", rule.Item, "Expect : CLA.003") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.004 func TestRuleGroupByConst(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select col1,col2 from tbl where col1='abc' group by 1", "select col1,col2 from tbl group by 1", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleGroupByConst() if rule.Item != "CLA.004" { t.Error("Rule not match:", rule.Item, "Expect : CLA.004") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.005 func TestRuleOrderByConst(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ // "select id from test where id=1 order by id", "select id from test where id=1 order by 1", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleOrderByConst() if rule.Item != "CLA.005" { t.Error("Rule not match:", rule.Item, "Expect : CLA.005") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.006 func TestRuleDiffGroupByOrderBy(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select tb1.col, tb2.col from tb1, tb2 where id=1 group by tb1.col, tb2.col", "select tb1.col, tb2.col from tb1, tb2 where id=1 order by tb1.col, tb2.col", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleDiffGroupByOrderBy() if rule.Item != "CLA.006" { t.Error("Rule not match:", rule.Item, "Expect : CLA.006") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.008 func TestRuleExplicitOrderBy(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select c1,c2,c3 from t1 where c1='foo' group by c2", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleExplicitOrderBy() if rule.Item != "CLA.008" { t.Error("Rule not match:", rule.Item, "Expect : CLA.008") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.009 func TestRuleOrderByExpr(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "SELECT col FROM tbl order by cola - cl;", // order by 列运算 "SELECT cola - cl col FROM tbl order by col;", // 别名为列运算 "SELECT cola FROM tbl order by from_unixtime(col);", // order by 函数运算 "SELECT from_unixtime(col) cola FROM tbl order by cola;", // 别名为函数运算 }, { `SELECT tbl.col FROM tbl ORDER BY col`, "SELECT sum(col) AS col FROM tbl ORDER BY dt", "SELECT tbl.col FROM tb, tbl WHERE tbl.tag_id = tb.id ORDER BY tbl.col", "SELECT col FROM tbl order by `timestamp`;", // 列名为关键字 "select col from tb where cl = 1 order by APPLY_TIME", // issue #104 case sensitive }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleOrderByExpr() if rule.Item != "CLA.009" { t.Error("Rule not match:", rule.Item, "Expect : CLA.009") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleOrderByExpr() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.010 func TestRuleGroupByExpr(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "SELECT col FROM tbl GROUP by cola - col;", "SELECT cola - col col FROM tbl GROUP by col;", "SELECT cola FROM tbl GROUP by from_unixtime(col);", "SELECT from_unixtime(col) cola FROM tbl GROUP by cola;", // 反面例子 // `SELECT tbl.col FROM tbl GROUP BY col`, // "SELECT dt, sum(col) AS col FROM tbl GROUP BY dt", // "SELECT tbl.col FROM tb, tbl WHERE tbl.tag_id = tb.id GROUP BY tbl.col", // "SELECT col FROM tbl GROUP by `timestamp`;", // 列名为关键字 } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleGroupByExpr() if rule.Item != "CLA.010" { t.Error("Rule not match:", rule.Item, "Expect : CLA.010") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.011 func TestRuleTblCommentCheck(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "CREATE TABLE `test1`( `ID` bigint(20) NOT NULL AUTO_INCREMENT," + " `c1` varchar(128) DEFAULT NULL, `c2` varchar(300) DEFAULT NULL," + " `c3` varchar(32) DEFAULT NULL, `c4` int(11) NOT NULL, `c5` double NOT NULL," + " `c6` text NOT NULL, PRIMARY KEY (`ID`), KEY `idx_c3_c2_c4_c5_c6` " + "(`c3`,`c2`(255),`c4`,`c5`,`c6`(255)), KEY `idx_c3_c2_c4` (`c3`,`c2`,`c4`)) " + "ENGINE = InnoDB DEFAULT CHARSET=utf8", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTblCommentCheck() if rule.Item != "CLA.011" { t.Error("Rule not match:", rule.Item, "Expect : CLA.011") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.001 func TestRuleSelectStar(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select * from tbl where id=1", "select col, * from tbl where id=1", // 反面例子 // "select count(*) from film where id=1", // `select count(* ) from film where id=1`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSelectStar() if rule.Item != "COL.001" { t.Error("Rule not match:", rule.Item, "Expect : COL.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.002 func TestRuleInsertColDef(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "insert into tbl values(1,'name')", "replace into tbl values(1,'name')", }, { "insert into tb (col) values ('hello world')", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInsertColDef() if rule.Item != "COL.002" { t.Error("Rule not match:", rule.Item, "Expect : COL.002") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInsertColDef() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.004 func TestRuleAddDefaultValue(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "create table test(id int)", `ALTER TABLE test change id id varchar(10);`, `ALTER TABLE test modify id varchar(10);`, }, { `ALTER TABLE test modify id varchar(10) DEFAULT '';`, `ALTER TABLE test CHANGE id id varchar(10) DEFAULT '';`, "create table test(id int not null default 0 comment '用户id')", `create table tb (a text)`, `alter table tb add a text`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAddDefaultValue() if rule.Item != "COL.004" { t.Error("Rule not match:", rule.Item, "Expect : COL.004") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAddDefaultValue() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.005 func TestRuleColCommentCheck(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "create table test(id int not null default 0)", `alter table test add column a int`, `ALTER TABLE t1 CHANGE b b INT NOT NULL;`, }, { "create table test(id int not null default 0 comment '用户id')", `alter table test add column a int comment 'test'`, `ALTER TABLE t1 AUTO_INCREMENT = 13;`, `ALTER TABLE t1 CHANGE b b INT NOT NULL COMMENT 'test';`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleColCommentCheck() if rule.Item != "COL.005" { t.Error("Rule not match:", rule.Item, "Expect : COL.005") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleColCommentCheck() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // LIT.001 func TestRuleIPString(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "insert into tbl (IP,name) values('10.20.306.122','test')", }, { `CREATE USER IF NOT EXISTS 'test'@'1.1.1.1';`, "ALTER USER 'test'@'1.1.1.1' IDENTIFIED WITH 'mysql_native_password' AS '*xxxxx' REQUIRE NONE PASSWORD EXPIRE DEFAULT ACCOUNT UNLOCK;", "GRANT SELECT ON `test`.* TO 'test'@'1.1.1.1';", `GRANT USAGE ON *.* TO 'test'@'1.1.1.1';`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleIPString() if rule.Item != "LIT.001" { t.Error("Rule not match:", rule.Item, "Expect : LIT.001") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleIPString() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // LIT.002 func TestRuleDateNotQuote(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "select col1,col2 from tbl where time < 2018-01-10", "select col1,col2 from tbl where time < 18-01-10", "INSERT INTO tb1 SELECT * FROM tb2 WHERE time < 2020-01-10", `select * from tb where col < ' 2022-01-10'`, }, { "select col1,col2 from tbl where time < '2018-01-10'", "INSERT INTO `tb` (`col`) VALUES ('timestamp=2019-12-16')", "insert into tb (col) values (' 2020-09-15 ')", "replace into tb (col) values (' 2020-09-15 ')", "INSERT INTO tb1 SELECT * FROM tb2 WHERE time < '2020-01-10'", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleDateNotQuote() if rule.Item != "LIT.002" { t.Error("Rule not match:", rule.Item, "Expect : LIT.002") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleDateNotQuote() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KWR.001 func TestRuleSQLCalcFoundRows(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select SQL_CALC_FOUND_ROWS col from tbl where id>1000", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSQLCalcFoundRows() if rule.Item != "KWR.001" { t.Error("Rule not match:", rule.Item, "Expect : KWR.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // JOI.001 func TestRuleCommaAnsiJoin(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select c1,c2,c3 from t1,t2 join t3 on t1.c1=t2.c1 and t1.c3=t3.c1 where id>1000;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCommaAnsiJoin() if rule.Item != "JOI.001" { t.Error("Rule not match:", rule.Item, "Expect : JOI.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // JOI.002 func TestRuleDupJoin(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select tb1.col from (tb1, tb2) join tb2 on tb1.id=tb.id where tb1.id=1;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleDupJoin() if rule.Item != "JOI.002" { t.Error("Rule not match:", rule.Item, "Expect : JOI.002") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.001 func TestRuleNoDeterministicGroupby(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ // 正面CASE { "select c1,c2,c3 from t1 where c2='foo' group by c2", "select col, col2, sum(col1) from tb group by col", "select col, col1 from tb group by col,sum(col1)", "select * from tb group by col", }, // 反面CASE { "select id from film", "select col, sum(col1) from tb group by col", "select * from file", "SELECT COUNT(*) AS cnt, language_id FROM film GROUP BY language_id;", "SELECT COUNT(*) AS cnt FROM film GROUP BY language_id;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNoDeterministicGroupby() if rule.Item != "RES.001" { t.Error("Rule not match:", rule.Item, "Expect : RES.001") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNoDeterministicGroupby() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.002 func TestRuleNoDeterministicLimit(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select col1,col2 from tbl where name='tony' limit 10", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNoDeterministicLimit() if rule.Item != "RES.002" { t.Error("Rule not match:", rule.Item, "Expect : RES.002") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.003 func TestRuleUpdateDeleteWithLimit(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "UPDATE film SET length = 120 WHERE title = 'abc' LIMIT 1;", }, { "UPDATE film SET length = 120 WHERE title = 'abc';", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUpdateDeleteWithLimit() if rule.Item != "RES.003" { t.Error("Rule not match:", rule.Item, "Expect : RES.003") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUpdateDeleteWithLimit() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.004 func TestRuleUpdateDeleteWithOrderby(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "UPDATE film SET length = 120 WHERE title = 'abc' ORDER BY title;", }, { "UPDATE film SET length = 120 WHERE title = 'abc';", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUpdateDeleteWithOrderby() if rule.Item != "RES.004" { t.Error("Rule not match:", rule.Item, "Expect : RES.004") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUpdateDeleteWithOrderby() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.005 func TestRuleUpdateSetAnd(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "update tbl set col = 1 AND cl = 2 where col=3;", "update table1 set a = ( select a from table2 where b=1 and c=2) and b=1 where d=2", }, { "update tbl set col = 1 ,cl = 2 where col=3;", // https://github.com/XiaoMi/soar/issues/226 "update table1 set a = ( select a from table2 where b=1 and c=2), b=1, c=2 where d=2", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUpdateSetAnd() if rule.Item != "RES.005" { t.Error("Rule not match:", rule.Item, "Expect : RES.005") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUpdateSetAnd() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.006 func TestRuleImpossibleWhere(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "select * from tbl where 1 != 1;", "select * from tbl where 'a' != 'a';", "select * from tbl where col between 10 AND 5;", }, { "select * from tbl where 1 = 1;", "select * from tbl where 'a' != 1;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleImpossibleWhere() if rule.Item != "RES.006" { t.Error("Rule not match:", rule.Item, "Expect : RES.006, SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleImpossibleWhere() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK, SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.007 func TestRuleMeaninglessWhere(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "select * from tbl where 1 = 1;", "select * from tbl where 'a' = 'a';", "select * from tbl where 'a' != 1;", "select * from tbl where 'a';", "select * from tbl where 'a' limit 1;", "select * from tbl where 1;", "select * from tbl where 1 limit 1;", "select * from tbl where id = 1 or 2;", "select * from tbl where true;", "select * from tbl where 'true';", }, { "select * from tbl where false;", "select * from tbl where 'false';", "select * from tbl where 0;", "select * from tbl where '0';", "select * from tbl where 2 = 1;", "select * from tbl where 'b' = 'a';", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMeaninglessWhere() if rule.Item != "RES.007" { t.Error("Rule not match:", rule.Item, "Expect : RES.007, SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMeaninglessWhere() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK, SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.008 func TestRuleLoadFile(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "LOAD DATA INFILE 'data.txt' INTO TABLE db2.my_table;", "LOAD DATA INFILE 'data.txt' INTO TABLE db2.my_table;", "LOAD /*COMMENT*/DATA INFILE 'data.txt' INTO TABLE db2.my_table;", `SELECT a,b,a+b INTO OUTFILE '/tmp/result.txt' FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"' LINES TERMINATED BY '\n' FROM test_table;`, }, { "SELECT id, data INTO @x, @y FROM test.t1 LIMIT 1;", }, } for _, sql := range sqls[0] { q := &Query4Audit{Query: sql} rule := q.RuleLoadFile() if rule.Item != "RES.008" { t.Error("Rule not match:", rule.Item, "Expect : RES.008, SQL: ", sql) } } for _, sql := range sqls[1] { q := &Query4Audit{Query: sql} rule := q.RuleLoadFile() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK, SQL: ", sql) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.009 func TestRuleMultiCompare(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "SELECT * FROM tbl WHERE col = col = 'abc'", "SELECT * FROM tbl WHERE col = 'def' and col = col = 'abc'", "SELECT * FROM tbl WHERE col = 'def' or col = col = 'abc'", "SELECT * FROM tbl WHERE col = col = 'abc' and col = 'def'", "UPDATE tbl set col = 1 WHERE col = col = 'abc'", "DELETE FROM tbl WHERE col = col = 'abc'", }, { "SELECT * FROM tbl WHERE col = 'abc'", // https://github.com/XiaoMi/soar/issues/169 "SELECT * FROM tbl WHERE col = 'abc' and c = 1", "update tb set c = 1 where a = 2 and b = 3", "delete from tb where a = 2 and b = 3", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMultiCompare() if rule.Item != "RES.009" { t.Error("Rule not match:", rule.Item, "Expect : RES.009, SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMultiCompare() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK, SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.010 func TestRuleCreateOnUpdate(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `CREATE TABLE category ( category_id TINYINT UNSIGNED NOT NULL AUTO_INCREMENT, name VARCHAR(25) NOT NULL, last_update TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (category_id) )`, }, { `CREATE TABLE category ( category_id TINYINT UNSIGNED NOT NULL AUTO_INCREMENT, name VARCHAR(25) NOT NULL, last_update TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (category_id) )`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCreateOnUpdate() if rule.Item != "RES.010" { t.Error("Rule not match:", rule.Item, "Expect : RES.010, SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCreateOnUpdate() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK, SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // RES.011 func TestRuleUpdateOnUpdate(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `UPDATE category SET name='ActioN' WHERE category_id=1`, }, { `select * from film limit 1`, "UPDATE category SET name='ActioN', last_update=last_update WHERE category_id=1", }, } for _, sql := range sqls[0] { vEnv.BuildVirtualEnv(rEnv, sql) stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { t.Error(syntaxErr) } q := &Query4Audit{Query: sql, Stmt: stmt} idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleUpdateOnUpdate() if rule.Item != "RES.011" { t.Error("Rule not match:", rule.Item, "Expect : RES.011, SQL:", sql) } } } for _, sql := range sqls[1] { vEnv.BuildVirtualEnv(rEnv, sql) stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { t.Error(syntaxErr) } q := &Query4Audit{Query: sql, Stmt: stmt} idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleUpdateOnUpdate() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK, SQL:", sql) } } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // STA.001 func TestRuleStandardINEQ(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select col1,col2 from tbl where type!=0", // "select col1,col2 from tbl where type<>0", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleStandardINEQ() if rule.Item != "STA.001" { t.Error("Rule not match:", rule.Item, "Expect : STA.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KWR.002 func TestRuleUseKeyWord(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE tbl (`select` int)", "CREATE TABLE `select` (a int)", "ALTER TABLE tbl ADD COLUMN `select` varchar(10)", }, { "CREATE TABLE tbl (a int)", "ALTER TABLE tbl ADD COLUMN col varchar(10)", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUseKeyWord() if rule.Item != "KWR.002" { t.Error("Rule not match:", rule.Item, "Expect : KWR.002") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUseKeyWord() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KWR.003 func TestRulePluralWord(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE tbl (`people` int)", "CREATE TABLE people (a int)", "ALTER TABLE tbl ADD COLUMN people varchar(10)", }, { "CREATE TABLE tbl (`person` int)", "ALTER TABLE tbl ADD COLUMN person varchar(10)", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RulePluralWord() if rule.Item != "KWR.003" { t.Error("Rule not match:", rule.Item, "Expect : KWR.003") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RulePluralWord() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KWR.004 func TestRuleMultiBytesWord(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "select col as 列 from tb", "select col as `列` from tb", }, { "select col as c from tb", "select '列'", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMultiBytesWord() if rule.Item != "KWR.004" { t.Error("Rule not match:", rule.Item, "Expect : KWR.004") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMultiBytesWord() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KWR.005 func TestRuleInvisibleUnicode(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) // 不可见的 unicode 可以通过 https://unicode-table.com 复制得到 sqls := [][]string{ { `select 1`, // SQL 中包含 non-broken-space `select​ 1;`, // SQL 中包含 zero-width space }, { "select 1", // 正常 SQL `select "1 "`, // 值中包含 non-broken-space `select "1​"`, // 值中包含 zero-width space }, } for _, sql := range sqls[0] { q, _ := NewQuery4Audit(sql) // 含有特殊 unicode 字符的 SQL 语法肯定是不通过的 rule := q.RuleInvisibleUnicode() if rule.Item != "KWR.005" { t.Error("Rule not match:", rule.Item, "Expect : KWR.005") } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInvisibleUnicode() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // LCK.001 func TestRuleInsertSelect(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `INSERT INTO tbl SELECT * FROM tbl2;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInsertSelect() if rule.Item != "LCK.001" { t.Error("Rule not match:", rule.Item, "Expect : LCK.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // LCK.002 func TestRuleInsertOnDup(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `INSERT INTO t1(a,b,c) VALUES (1,2,3) ON DUPLICATE KEY UPDATE c=c+1;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInsertOnDup() if rule.Item != "LCK.002" { t.Error("Rule not match:", rule.Item, "Expect : LCK.002") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SUB.001 func TestRuleInSubquery(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select col1,col2,col3 from table1 where col2 in(select col from table2)", "SELECT col1,col2,col3 from table1 where col2 =(SELECT col2 FROM `table1` limit 1)", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInSubquery() if rule.Item != "SUB.001" { t.Error("Rule not match:", rule.Item, "Expect : SUB.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // LIT.003 func TestRuleMultiValueAttribute(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select c1,c2,c3,c4 from tab1 where col_id REGEXP '[[:<:]]12[[:>:]]'", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMultiValueAttribute() if rule.Item != "LIT.003" { t.Error("Rule not match:", rule.Item, "Expect : LIT.003") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // LIT.003 func TestRuleAddDelimiter(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `use sakila select * from film`, `use sakila`, `show databases`, }, { `use sakila;`, }, } for _, sql := range sqls[0] { q, _ := NewQuery4Audit(sql) rule := q.RuleAddDelimiter() if rule.Item != "LIT.004" { t.Error("Rule not match:", rule.Item, "Expect : LIT.004") } } for _, sql := range sqls[1] { q, _ := NewQuery4Audit(sql) rule := q.RuleAddDelimiter() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KEY.003 func TestRuleRecursiveDependency(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `CREATE TABLE tab2 ( p_id BIGINT UNSIGNED NOT NULL, a_id BIGINT UNSIGNED NOT NULL, PRIMARY KEY (p_id, a_id), FOREIGN KEY (p_id) REFERENCES tab1(p_id), FOREIGN KEY (a_id) REFERENCES tab3(a_id) );`, `ALTER TABLE tbl2 add FOREIGN KEY (p_id) REFERENCES tab1(p_id);`, }, { `ALTER TABLE tbl2 ADD KEY p_id (p_id);`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleRecursiveDependency() if rule.Item != "KEY.003" { t.Error("Rule not match:", rule.Item, "Expect : KEY.003") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleRecursiveDependency() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.009 func TestRuleImpreciseDataType(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `CREATE TABLE tab2 ( p_id BIGINT UNSIGNED NOT NULL, a_id BIGINT UNSIGNED NOT NULL, hours float NOT null, PRIMARY KEY (p_id, a_id) );`, `alter table tbl add column c float not null;`, `insert into tb (col) values (0.00001);`, `select * from tb where col = 0.00001;`, }, { "REPLACE INTO `storage` (`hostname`,`storagehost`, `filename`, `starttime`, `binlogstarttime`, `uploadname`, `binlogsize`, `filesize`, `md5`, `status`) VALUES (1, 1, 1, 1, 1, 1, ?, ?);", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleImpreciseDataType() if rule.Item != "COL.009" { t.Error("Rule not match:", rule.Item, "Expect : COL.009") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleImpreciseDataType() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.010 func TestRuleValuesInDefinition(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `create table tab1(status ENUM('new', 'in progress', 'fixed'))`, `alter table tab1 add column status ENUM('new', 'in progress', 'fixed')`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleValuesInDefinition() if rule.Item != "COL.010" { t.Error("Rule not match:", rule.Item, "Expect : COL.010") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KEY.004 func TestRuleIndexAttributeOrder(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `create index idx1 on tab(last_name,first_name);`, `alter table tab add index idx1 (last_name,first_name);`, `CREATE TABLE test (id int,blob_col BLOB, INDEX(blob_col(10),id));`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleIndexAttributeOrder() if rule.Item != "KEY.004" { t.Error("Rule not match:", rule.Item, "Expect : KEY.004") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.011 func TestRuleNullUsage(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select c1,c2,c3 from tab where c4 is null or c4 <> 1;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNullUsage() if rule.Item != "COL.011" { t.Error("Rule not match:", rule.Item, "Expect : COL.011") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // FUN.003 func TestRuleStringConcatenation(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select c1 || coalesce(' ' || c2 || ' ', ' ') || c3 as c from tab;`, `update t1 set c1 = v1 where id in (select id || 1 from t2)`, `update t1 set c1 = v1 where id in (select id || 1 from t2)`, `update t1 set c1 = v1 where id in (select id || 1 from t2)`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleStringConcatenation() if rule.Item != "FUN.003" { t.Error("Rule not match:", rule.Item, "Expect : FUN.003", "SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } okSqls := []string{ `select "a || b" from tab;`, `update t1 set c1 = "{\"key\":\"text or text\"}" where id = 1`, `update t1 set c1 = "{\"key\":\"text||text\"}" where id = 1`, `select " ' or ' " from tab;`, `select " or ' " from tab;`, `select "a or b" from tab;`, "INSERT INTO `order` VALUES (8, \"test\", \"order.salesType==200||order.salesType==201||order.salesType==202\")", } for _, sql := range okSqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleStringConcatenation() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK", "SQL: ", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // FUN.004 func TestRuleSysdate(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select sysdate();`, `select Sysdate();`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSysdate() if rule.Item != "FUN.004" { t.Error("Rule not match:", rule.Item, "Expect : FUN.004") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // FUN.005 func TestRuleCountConst(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `select count(1) from tbl;`, `select count(col) from tbl;`, }, { `select count(*) from tbl`, `select count(DISTINCT col) from tbl`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCountConst() if rule.Item != "FUN.005" { t.Error("Rule not match:", rule.Item, "Expect : FUN.005") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCountConst() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // FUN.006 func TestRuleSumNPE(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `select sum(1) from tbl;`, `select sum(col) from tbl;`, }, { `SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSumNPE() if rule.Item != "FUN.006" { t.Error("Rule not match:", rule.Item, "Expect : FUN.006") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSumNPE() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.007 func TestRulePatternMatchingUsage(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select c1,c2,c3,c4 from tab1 where col_id REGEXP '[[:<:]]12[[:>:]]';`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RulePatternMatchingUsage() if rule.Item != "ARG.007" { t.Error("Rule not match:", rule.Item, "Expect : ARG.007") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.012 func TestRuleSpaghettiQueryAlert(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select 1`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { common.Config.SpaghettiQueryLength = 1 rule := q.RuleSpaghettiQueryAlert() if rule.Item != "CLA.012" { t.Error("Rule not match:", rule.Item, "Expect : CLA.012") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // JOI.005 func TestRuleReduceNumberOfJoin(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select bp1.p_id, b1.d_d as l, b1.b_id from b1 join bp1 on (b1.b_id = bp1.b_id) left outer join (b1 as b2 join bp2 on (b2.b_id = bp2.b_id)) on (bp1.p_id = bp2.p_id ) join bp21 on (b1.b_id = bp1.b_id) join bp31 on (b1.b_id = bp1.b_id) join bp41 on (b1.b_id = bp1.b_id) where b2.b_id = 0; `, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleReduceNumberOfJoin() if rule.Item != "JOI.005" { t.Error("Rule not match:", rule.Item, "Expect : JOI.005") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // DIS.001 func TestRuleDistinctUsage(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `SELECT DISTINCT c.c_id,count(DISTINCT c.c_name),count(DISTINCT c.c_e),count(DISTINCT c.c_n),count(DISTINCT c.c_me),c.c_d FROM (select distinct id, name from B) as e WHERE e.country_id = c.country_id;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleDistinctUsage() if rule.Item != "DIS.001" { t.Error("Rule not match:", rule.Item, "Expect : DIS.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // DIS.002 func TestRuleCountDistinctMultiCol(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "SELECT COUNT(DISTINCT col, col2) FROM tbl;", }, { "SELECT COUNT(DISTINCT col) FROM tbl;", `SELECT JSON_OBJECT( "key", p.id, "title", p.name, "manufacturer", p.manufacturer, "price", p.price, "specifications", JSON_OBJECTAGG(a.name, v.value)) as product FROM product as p JOIN value as v ON p.id = v.prod_id JOIN attribute as a ON a.id = v.attribute_id GROUP BY v.prod_id`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCountDistinctMultiCol() if rule.Item != "DIS.002" { t.Error("Rule not match:", rule.Item, "Expect : DIS.002") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCountDistinctMultiCol() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // DIS.003 // RuleDistinctStar func TestRuleDistinctStar(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "SELECT DISTINCT * FROM film;", "SELECT DISTINCT film.* FROM film;", }, { "SELECT DISTINCT col FROM film;", "SELECT DISTINCT film.* FROM film, tbl;", "SELECT DISTINCT * FROM film, tbl;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleDistinctStar() if rule.Item != "DIS.003" { t.Error("Rule not match:", rule.Item, "Expect : DIS.003") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleDistinctStar() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.013 func TestRuleHavingClause(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `SELECT s.c_id,count(s.c_id) FROM s where c = test GROUP BY s.c_id HAVING s.c_id <> '1660' AND s.c_id <> '2' order by s.c_id;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleHavingClause() if rule.Item != "CLA.013" { t.Error("Rule not match:", rule.Item, "Expect : CLA.013") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // FUN.007 func TestRuleForbiddenTrigger(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `CREATE TRIGGER t1 AFTER INSERT ON work FOR EACH ROW INSERT INTO time VALUES(NOW());`, } for _, sql := range sqls { q, _ := NewQuery4Audit(sql) rule := q.RuleForbiddenTrigger() if rule.Item != "FUN.007" { t.Error("Rule not match:", rule.Item, "Expect : FUN.007") } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // FUN.008 func TestRuleForbiddenProcedure(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `CREATE PROCEDURE simpleproc (OUT param1 INT)`, } for _, sql := range sqls { q, _ := NewQuery4Audit(sql) rule := q.RuleForbiddenProcedure() if rule.Item != "FUN.008" { t.Error("Rule not match:", rule.Item, "Expect : FUN.008") } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // FUN.009 func TestRuleForbiddenFunction(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `CREATE FUNCTION hello (s CHAR(20));`, } for _, sql := range sqls { q, _ := NewQuery4Audit(sql) rule := q.RuleForbiddenFunction() if rule.Item != "FUN.009" { t.Error("Rule not match:", rule.Item, "Expect : FUN.009") } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // TBL.006 func TestRuleForbiddenView(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `create view v_today (today) AS SELECT CURRENT_DATE;`, `CREATE VIEW v (col) AS SELECT 'abc';`, } for _, sql := range sqls { q, _ := NewQuery4Audit(sql) rule := q.RuleForbiddenView() if rule.Item != "TBL.006" { t.Error("Rule not match:", rule.Item, "Expect : TBL.006") } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // TBL.007 func TestRuleForbiddenTempTable(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "CREATE TEMPORARY TABLE `work` (`time` time DEFAULT NULL) ENGINE=InnoDB;", } for _, sql := range sqls { q, _ := NewQuery4Audit(sql) rule := q.RuleForbiddenTempTable() if rule.Item != "TBL.007" { t.Error("Rule not match:", rule.Item, "Expect : TBL.007") } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // JOI.006 func TestRuleNestedSubQueries(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `SELECT s,p,d FROM tab WHERE p.p_id = (SELECT s.p_id FROM tab WHERE s.c_id = 100996 AND s.q = 1 );`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNestedSubQueries() if rule.Item != "JOI.006" { t.Error("Rule not match:", rule.Item, "Expect : JOI.006") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // JOI.007 func TestRuleMultiDeleteUpdate(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `DELETE u FROM users u LEFT JOIN hobby tna ON u.id = tna.uid WHERE tna.hobby = 'piano'; `, `UPDATE users u LEFT JOIN hobby h ON u.id = h.uid SET u.name = 'pianoboy' WHERE h.hobby = 'piano';`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMultiDeleteUpdate() if rule.Item != "JOI.007" { t.Error("Rule not match:", rule.Item, "Expect : JOI.007") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // JOI.008 func TestRuleMultiDBJoin(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `SELECT s,p,d FROM db1.tb1 join db2.tb2 on db1.tb1.a = db2.tb2.a where db1.tb1.a > 10;`, `SELECT s,p,d FROM db1.tb1 join tb2 on db1.tb1.a = tb2.a where db1.tb1.a > 10;`, // `SELECT s,p,d FROM db1.tb1 join db1.tb2 on db1.tb1.a = db1.tb2.a where db1.tb1.a > 10;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMultiDBJoin() if rule.Item != "JOI.008" { t.Error("Rule not match:", rule.Item, "Expect : JOI.008") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.008 func TestRuleORUsage(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `SELECT c1,c2,c3 FROM tab WHERE c1 = 14 OR c1 = 14;`, }, { `SELECT c1,c2,c3 FROM tab WHERE c1 = 14 OR c2 = 17;`, `SELECT c1,c2,c3 FROM tab WHERE c1 = 14 OR c1 IS NULL;`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleORUsage() if rule.Item != "ARG.008" { t.Error("Rule not match:", rule.Item, "Expect : ARG.008") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleORUsage() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.009 func TestRuleSpaceWithQuote(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `SELECT 'a ';`, `SELECT ' a';`, `SELECT "a ";`, `SELECT " a";`, `create table tb ( a varchar(10) default ' ');`, }, { `select ''`, `select 'a'`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSpaceWithQuote() if rule.Item != "ARG.009" { t.Error("Rule not match:", rule.Item, "Expect : ARG.009") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSpaceWithQuote() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.010 func TestRuleHint(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `SELECT * FROM t1 USE INDEX (i1) ORDER BY a;`, `SELECT * FROM t1 IGNORE INDEX (i1) ORDER BY (i2);`, // TODO: vitess syntax not support now // `SELECT * FROM t1 USE INDEX (i1,i2) IGNORE INDEX (i2);`, // `SELECT * FROM t1 USE INDEX (i1) IGNORE INDEX (i2) USE INDEX (i2);`, }, { `select ''`, `select 'a'`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleHint() if rule.Item != "ARG.010" { t.Error("Rule not match:", rule.Item, "Expect : ARG.010") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleHint() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.011 func TestRuleNot(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `select id from t where num not in(1,2,3);`, `select id from t where num not like "a%"`, }, { `select id from t where num in(1,2,3);`, `select id from t where num like "a%"`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNot() if rule.Item != "ARG.011" { t.Error("Rule not match:", rule.Item, "Expect : ARG.011") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNot() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.012 func TestRuleInsertValues(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `INSERT INTO tb VALUES (1), (2)`, `REPLACE INTO tb VALUES (1), (2)`, }, { `INSERT INTO tb VALUES (1)`, }, } oldMaxValueCount := common.Config.MaxValueCount common.Config.MaxValueCount = 1 for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInsertValues() if rule.Item != "ARG.012" { t.Error("Rule not match:", rule.Item, "Expect : ARG.012") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInsertValues() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Config.MaxValueCount = oldMaxValueCount common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.013 func TestRuleFullWidthQuote(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `CREATE TABLE tb (a varchar(10) default '“”')`, `CREATE TABLE tb (a varchar(10) default '‘’')`, `ALTER TABLE tb ADD COLUMN a VARCHAR(10) DEFAULT "“”"`, }, { `CREATE TABLE tb (a varchar(10) default '""')`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleFullWidthQuote() if rule.Item != "ARG.013" { t.Error("Rule not match:", rule.Item, "Expect : ARG.013") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleFullWidthQuote() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SUB.002 func TestRuleUNIONUsage(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select teacher_id as id,people_name as name from t1,t2 where t1.teacher_id=t2.people_id union select student_id as id,people_name as name from t1,t2 where t1.student_id=t2.people_id;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUNIONUsage() if rule.Item != "SUB.002" { t.Error("Rule not match:", rule.Item, "Expect : SUB.002") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SUB.003 func TestRuleDistinctJoinUsage(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `SELECT DISTINCT c.c_id, c.c_name FROM c,e WHERE e.c_id = c.c_id;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleDistinctJoinUsage() if rule.Item != "SUB.003" { t.Error("Rule not match:", rule.Item, "Expect : SUB.003") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SUB.005 func TestRuleSubQueryLimit(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `SELECT * FROM staff WHERE name IN (SELECT NAME FROM customer ORDER BY name LIMIT 1)`, }, { `select * from (select id from tbl limit 3) as foo`, `select * from tbl where id in (select t.id from (select * from tbl limit 3)as t)`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSubQueryLimit() if rule.Item != "SUB.005" { t.Error("Rule not match:", rule.Item, "Expect : SUB.005") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSubQueryLimit() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SUB.006 func TestRuleSubQueryFunctions(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `SELECT * FROM staff WHERE name IN (SELECT max(NAME) FROM customer)`, }, { `select * from (select id from tbl limit 3) as foo`, `select * from tbl where id in (select t.id from (select * from tbl limit 3)as t)`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSubQueryFunctions() if rule.Item != "SUB.006" { t.Error("Rule not match:", rule.Item, "Expect : SUB.006") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSubQueryFunctions() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SUB.007 func TestRuleUNIONLimit(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `(SELECT * FROM tb1 ORDER BY name) UNION ALL (SELECT * FROM tb2 ORDER BY name) LIMIT 20;`, `(SELECT * FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT * FROM tb2 ORDER BY name) LIMIT 20;`, `(SELECT * FROM tb1 ORDER BY name) UNION ALL (SELECT * FROM tb2 ORDER BY name LIMIT 20) LIMIT 20;`, }, { `(SELECT * FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT * FROM tb2 ORDER BY name LIMIT 20) LIMIT 20;`, `SELECT * FROM tb1 ORDER BY name LIMIT 20`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUNIONLimit() if rule.Item != "SUB.007" { t.Error("Rule not match:", rule.Item, "Expect : SUB.007", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUNIONLimit() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SEC.002 func TestRuleReadablePasswords(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `create table test(id int,name varchar(20) not null,password varchar(200)not null);`, `alter table test add column password varchar(200) not null;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleReadablePasswords() if rule.Item != "SEC.002" { t.Error("Rule not match:", rule.Item, "Expect : SEC.002") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SEC.003 func TestRuleDataDrop(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `delete from tb where a = b;`, `truncate table tb;`, `drop table tb;`, `drop database db;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleDataDrop() if rule.Item != "SEC.003" { t.Error("Rule not match:", rule.Item, "Expect : SEC.003") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SEC.004 func TestRuleInjection(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `select benchmark(10, rand())`, `select sleep(1)`, `select Sleep(1)`, `select get_lock('lock_name', 1)`, `select release_lock('lock_name')`, }, { "select * from `sleep`", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInjection() if rule.Item != "SEC.004" { t.Error("Rule not match:", rule.Item, "Expect : SEC.004") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleInjection() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // FUN.001 func TestCompareWithFunction(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `select id from t where substring(name,1,3)='abc';`, `SELECT * FROM tbl WHERE UNIX_TIMESTAMP(loginTime) BETWEEN UNIX_TIMESTAMP('2018-11-16 09:46:00 +0800 CST') AND UNIX_TIMESTAMP('2018-11-22 00:00:00 +0800 CST')`, `select id from t where num/2 = 100`, `select id from t where num/2 < 100`, // 时间 builtin 函数 `SELECT * FROM tb WHERE DATE '2020-01-01'`, `DELETE FROM tb WHERE DATE '2020-01-01'`, `UPDATE tb SET col = 1 WHERE DATE '2020-01-01'`, `SELECT * FROM tb WHERE TIME '10:01:01'`, `SELECT * FROM tb WHERE TIMESTAMP '1587181360'`, `select * from mysql.user where user = "root" and date '2020-02-01'`, // 右侧使用函数比较 `select id from t where 'abc'=substring(name,1,3);`, }, // 正常 SQL { `select id from t where col = (select 1)`, `select id from t where col = 1`, }, } for i, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCompareWithFunction() if rule.Item != "FUN.001" { t.Errorf("SQL: %d, Rule not match: %s Expect : FUN.001", i, rule.Item) } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCompareWithFunction() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // FUN.002 func TestRuleCountStar(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `SELECT c3, COUNT(*) AS accounts FROM tab where c2 < 10000 GROUP BY c3 ORDER BY num;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCountStar() if rule.Item != "FUN.002" { t.Error("Rule not match:", rule.Item, "Expect : FUN.002") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // SEC.001 func TestRuleTruncateTable(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `TRUNCATE TABLE tbl_name;`, `truncate TABLE tbl_name;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTruncateTable() if rule.Item != "SEC.001" { t.Error("Rule not match:", rule.Item, "Expect : SEC.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.005 func TestRuleIn(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select id from t where num in(1,2,3);`, `SELECT * FROM tbl WHERE col IN (NULL)`, `SELECT * FROM tbl WHERE col NOT IN (NULL)`, } common.Config.MaxInCount = 0 for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleIn() if rule.Item != "ARG.005" && rule.Item != "ARG.004" { t.Error("Rule not match:", rule.Item, "Expect : ARG.005 OR ARG.004") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ARG.006 func TestRuleIsNullIsNotNull(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select id from t where num is null;`, `select id from t where num is not null;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleIsNullIsNotNull() if rule.Item != "ARG.006" { t.Error("Rule not match:", rule.Item, "Expect : ARG.006") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.008 func TestRuleVarcharVSChar(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `create table t1(id int,name char(20),last_time date);`, `create table t1(id int,name binary(20),last_time date);`, `alter table t1 add column id int, add column name binary(20), add column last_time date;`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleVarcharVSChar() if rule.Item != "COL.008" { t.Error("Rule not match:", rule.Item, "Expect : COL.008") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // TBL.003 func TestRuleCreateDualTable(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "create table `dual`(id int, primary key (id));", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleCreateDualTable() if rule.Item != "TBL.003" { t.Error("Rule not match:", rule.Item, "Expect : TBL.003") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ALT.001 func TestRuleAlterCharset(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `alter table tbl default character set 'utf8';`, `alter table tbl default character set='utf8';`, `ALTER TABLE t1 CHANGE a b BIGINT NOT NULL, default character set utf8`, `ALTER TABLE t1 CHANGE a b BIGINT NOT NULL,default character set utf8`, `ALTER TABLE t1 CHANGE a b BIGINT NOT NULL, character set utf8`, `ALTER TABLE t1 CHANGE a b BIGINT NOT NULL,character set utf8`, `alter table t1 default collate = utf8_unicode_ci;`, `ALTER TABLE tbl_name CHARACTER SET 'utf8';`, // `ALTER TABLE tbl_name CHARACTER SET charset_name;`, // FIXME: unknown CHARACTER SET // `alter table t1 convert to character set utf8 collate utf8_unicode_ci;`, // FIXME: syntax not compatible }, { // 反面的例子 `ALTER TABLE t MODIFY latin1_text_col TEXT CHARACTER SET utf8`, `ALTER TABLE t1 CHANGE c1 c1 TEXT CHARACTER SET utf8;`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAlterCharset() if rule.Item != "ALT.001" { t.Error(sql, " Rule not match:", rule.Item, "Expect : ALT.001") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAlterCharset() if rule.Item != "OK" { t.Error(sql, " Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ALT.003 func TestRuleAlterDropColumn(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `alter table film drop column title;`, }, { // 反面的例子 `ALTER TABLE t1 CHANGE c1 c1 TEXT CHARACTER SET utf8;`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAlterDropColumn() if rule.Item != "ALT.003" { t.Error(sql, " Rule not match:", rule.Item, "Expect : ALT.003") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAlterDropColumn() if rule.Item != "OK" { t.Error(sql, " Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // ALT.004 func TestRuleAlterDropKey(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `alter table film drop primary key`, `alter table film drop foreign key fk_film_language`, }, { // 反面的例子 `ALTER TABLE t1 CHANGE c1 c1 TEXT CHARACTER SET utf8;`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAlterDropKey() if rule.Item != "ALT.004" { t.Error(sql, " Rule not match:", rule.Item, "Expect : ALT.004") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAlterDropKey() if rule.Item != "OK" { t.Error(sql, " Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.012 func TestRuleCantBeNull(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE `tb`(`c` longblob NOT NULL);", }, { "CREATE TABLE `tbl` (`c` longblob);", "alter TABLE `tbl` add column `c` longblob;", "alter TABLE `tbl` add column `c` text;", "alter TABLE `tbl` add column `c` blob;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleBLOBNotNull() if rule.Item != "COL.012" { t.Error("Rule not match:", rule.Item, "Expect : COL.012") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleBLOBNotNull() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KEY.006 func TestRuleTooManyKeyParts(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `c` longblob NOT NULL DEFAULT '', PRIMARY KEY (`id`));", "alter TABLE `tb` add index idx_idx (`id`);", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { common.Config.MaxIdxColsCount = 0 rule := q.RuleTooManyKeyParts() if rule.Item != "KEY.006" { t.Error("Rule not match:", rule.Item, "Expect : KEY.006") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KEY.005 func TestRuleTooManyKeys(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "create table tbl ( a char(10), b int, primary key (`a`)) engine=InnoDB;", "create table tbl ( a varchar(64) not null, b int, PRIMARY KEY (`a`), key `idx_a_b` (`a`,`b`)) engine=InnoDB", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { common.Config.MaxIdxCount = 0 rule := q.RuleTooManyKeys() if rule.Item != "KEY.005" { t.Error("Rule not match:", rule.Item, "Expect : KEY.005") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KEY.007 func TestRulePKNotInt(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "create table tbl ( a char(10), b int, primary key (`a`)) engine=InnoDB;", "create table tbl ( a int, b int, primary key (`a`)) engine=InnoDB;", "create table tbl ( a bigint, b int, primary key (`a`)) engine=InnoDB;", "create table tbl ( a int unsigned, b int, primary key (`a`)) engine=InnoDB;", "create table tbl ( a bigint unsigned, b int, primary key (`a`)) engine=InnoDB;", }, { "CREATE TABLE tbl (a int unsigned auto_increment, b int, primary key(`a`)) engine=InnoDB;", "CREATE TABLE `tb` ( `id` Bigint unsigned NOT NULL AUTO_INCREMENT COMMENT 'auto id', Primary key (`id`) ) ENGINE = InnoDB COMMENT 'comment'", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RulePKNotInt() if rule.Item != "KEY.007" && rule.Item != "KEY.001" { t.Error("Rule not match:", rule.Item, "Expect : KEY.007 OR KEY.001") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RulePKNotInt() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KEY.008 func TestRuleOrderByMultiDirection(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `SELECT col FROM tbl order by col desc, col2 asc`, `SELECT col FROM tbl order by col desc, col2`, `SELECT col FROM tbl order by col, col2 desc`, }, { `SELECT col FROM tbl order by col, col2`, `SELECT col FROM tbl order by col desc, col2 desc`, `SELECT col FROM tbl order by col asc, col2 asc`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleOrderByMultiDirection() if rule.Item != "KEY.008" { t.Error("Rule not match:", rule.Item, "Expect : KEY.008") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleOrderByMultiDirection() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KEY.009 func TestRuleUniqueKeyDup(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `ALTER TABLE customer ADD UNIQUE INDEX part_of_name (name(10));`, `CREATE UNIQUE INDEX part_of_name ON customer (name(10));`, }, { `ALTER TABLE tbl add INDEX idx_col (col);`, `CREATE INDEX part_of_name ON customer (name(10));`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUniqueKeyDup() if rule.Item != "KEY.009" { t.Error("Rule not match:", rule.Item, "Expect : KEY.009") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleUniqueKeyDup() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KEY.010 func TestRuleFulltextIndex(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `ALTER TABLE tb ADD FULLTEXT INDEX ip (ip);`, // `CREATE FULLTEXT INDEX ft_ip ON tb (ip);`, // TODO: tidb not support yet `CREATE TABLE tb ( id int(10) unsigned NOT NULL AUTO_INCREMENT, ip varchar(255) NOT NULL DEFAULT '', PRIMARY KEY (id), FULLTEXT KEY ip (ip) ) ENGINE=InnoDB;`, }, { `ALTER TABLE tbl add INDEX idx_col (col);`, `CREATE INDEX part_of_name ON customer (name(10));`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleFulltextIndex() if rule.Item != "KEY.010" { t.Error("Rule not match:", rule.Item, "Expect : KEY.010") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleFulltextIndex() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.013 func TestRuleTimestampDefault(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE tbl( `id` bigint not null, `create_time` timestamp) ENGINE=InnoDB DEFAULT CHARSET=utf8;", "ALTER TABLE t1 MODIFY b timestamp NOT NULL;", `ALTER TABLE t1 ADD c_time timestamp NOT NULL default "0000-00-00"`, `ALTER TABLE t1 ADD c_time timestamp NOT NULL default '0'`, `ALTER TABLE t1 ADD c_time timestamp NOT NULL default 0`, `ALTER TABLE t1 ADD c_time datetime NOT NULL default 0`, }, { "CREATE TABLE tbl (`id` bigint not null, `update_time` timestamp default current_timestamp)", "ALTER TABLE t1 MODIFY b timestamp NOT NULL default current_timestamp;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTimestampDefault() if rule.Item != "COL.013" { t.Error("Rule not match:", rule.Item, "Expect : COL.013", sql) } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTimestampDefault() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // TBL.004 func TestRuleAutoIncrementInitNotZero(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ // 正面的例子 { "CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `pad` char(60) NOT NULL DEFAULT '', PRIMARY KEY (`id`)) ENGINE=InnoDB AUTO_INCREMENT=13", }, // 反面的例子 { "CREATE TABLE `test1` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `pad` char(60) NOT NULL DEFAULT '', PRIMARY KEY (`id`))", "CREATE TABLE `test1` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `pad` char(60) NOT NULL DEFAULT '', PRIMARY KEY (`id`)) auto_increment = 1", "CREATE TABLE `test1` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `pad` char(60) NOT NULL DEFAULT '', PRIMARY KEY (`id`)) auto_increment = 1 DEFAULT CHARSET=latin1", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAutoIncrementInitNotZero() if rule.Item != "TBL.004" { t.Error("Rule not match:", rule.Item, "Expect : TBL.004") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAutoIncrementInitNotZero() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.014 func TestRuleColumnWithCharset(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ // 正面的例子 { "CREATE TABLE `tb2` ( `id` int(11) DEFAULT NULL, `col` char(10) CHARACTER SET utf8 DEFAULT NULL)", "alter table tb2 change col col char(10) CHARACTER SET utf8 DEFAULT NULL;", "CREATE TABLE tb (a nvarchar(10))", "CREATE TABLE tb (a nchar(10))", }, // 反面的例子 { "CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `c` char(120) NOT NULL DEFAULT '', PRIMARY KEY (`id`))", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleColumnWithCharset() if rule.Item != "COL.014" { t.Error("Rule not match:", rule.Item, "Expect : COL.014") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleColumnWithCharset() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // TBL.005 func TestRuleTableCharsetCheck(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { //"CREATE DATABASE sbtest /*!40100 DEFAULT CHARACTER SET latin1 */;", // FIXME: "create table tbl (a int) DEFAULT CHARSET=latin1;", "ALTER TABLE tbl CONVERT TO CHARACTER SET latin1;", }, { "create table tlb (a int);", "ALTER TABLE `tbl` add column a int, add column b int ;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTableCharsetCheck() if rule.Item != "TBL.005" { t.Error("Rule not match:", rule.Item, "Expect : TBL.005") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTableCharsetCheck() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // TBL.008 func TestRuleTableCollateCheck(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE DATABASE sbtest /*!40100 DEFAULT COLLATE latin1_bin */;", "create table tbl (a int) DEFAULT COLLATE=latin1_bin;", }, { "create table tlb (a int);", "ALTER TABLE `tbl` add column a int, add column b int ;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTableCollateCheck() if rule.Item != "TBL.008" { t.Error("Rule not match:", rule.Item, "Expect : TBL.008") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTableCollateCheck() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.015 func TestRuleBlobDefaultValue(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `c` blob NOT NULL DEFAULT '', PRIMARY KEY (`id`));", "CREATE TABLE `tb` (`id` int(10) unsigned NOT NULL AUTO_INCREMENT, `c` json NOT NULL DEFAULT '', PRIMARY KEY (`id`));", "alter table `tb` add column `c` blob NOT NULL DEFAULT '';", "alter table `tb` add column `c` json NOT NULL DEFAULT '';", }, { "CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `c` blob NOT NULL, PRIMARY KEY (`id`));", "CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `c` json NOT NULL, PRIMARY KEY (`id`));", "CREATE TABLE `tb` (`col` text NOT NULL);", "alter table `tb` add column `c` blob NOT NULL;", "alter table `tb` add column `c` json NOT NULL;", "ALTER TABLE tb ADD COLUMN a BLOB DEFAULT NULL", "ALTER TABLE tb ADD COLUMN a JSON DEFAULT NULL", "CREATE TABLE tb ( a BLOB DEFAULT NULL)", "CREATE TABLE tb ( a JSON DEFAULT NULL)", "alter TABLE `tbl` add column `c` longblob;", "alter TABLE `tbl` add column `c` text;", "alter TABLE `tbl` add column `c` blob;", "alter TABLE `tbl` add column `c` json;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleBlobDefaultValue() if rule.Item != "COL.015" { t.Error("Rule not match:", rule.Item, "Expect : COL.015") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleBlobDefaultValue() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.016 func TestRuleIntPrecision(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE `tb` ( `id` int(1) );", "CREATE TABLE `tb` ( `id` bigint(1) );", "alter TABLE `tb` add column `id` bigint(1);", "alter TABLE `tb` add column `id` int(1);", }, { "CREATE TABLE `tb` ( `id` int(10));", "CREATE TABLE `tb` ( `id` bigint(20));", "alter TABLE `tb` add column `id` bigint(20);", "alter TABLE `tb` add column `id` int(10);", "CREATE TABLE `tb` ( `id` int);", "alter TABLE `tb` add column `id` bigint;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleIntPrecision() if rule.Item != "COL.016" { t.Error("Rule not match:", rule.Item, "Expect : COL.016") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleIntPrecision() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.017 func TestRuleVarcharLength(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE `tb` ( `id` varchar(4000) );", "CREATE TABLE `tb` ( `id` varchar(3500) );", "alter TABLE `tb` add column `id` varchar(3500);", }, { "CREATE TABLE `tb` ( `id` varchar(1024));", "CREATE TABLE `tb` ( `id` varchar(20));", "alter TABLE `tb` add column `id` varchar(35);", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleVarcharLength() if rule.Item != "COL.017" { t.Error("Rule not match:", rule.Item, "Expect : COL.017") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleVarcharLength() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.018 func TestRuleColumnNotAllowType(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE tab (a BOOLEAN);", "CREATE TABLE tab (a BOOLEAN );", "ALTER TABLE `tb` add column `a` BOOLEAN;", }, { "CREATE TABLE `tb` ( `id` varchar(1024));", "ALTER TABLE `tb` add column `id` varchar(35);", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleColumnNotAllowType() if rule.Item != "COL.018" { t.Error("Rule not match:", rule.Item, "Expect : COL.018") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleColumnNotAllowType() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.019 func TestRuleTimePrecision(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ // 正面的例子 { "CREATE TABLE t1 (t TIME(3), dt DATETIME(6));", "ALTER TABLE t1 add t TIME(3);", }, // 反面的例子 { "CREATE TABLE t1 (t TIME, dt DATETIME);", "ALTER TABLE t1 add t TIME;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTimePrecision() if rule.Item != "COL.019" { t.Error("Rule not match:", rule.Item, "Expect : COL.019") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTimePrecision() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // KEY.002 func TestRuleNoOSCKey(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ // 正面的例子 { "CREATE TABLE tbl (a int, b int)", }, // 反面的例子 { "CREATE TABLE tbl (a int, primary key(`a`))", "CREATE TABLE tbl (a int, unique key(`a`))", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNoOSCKey() if rule.Item != "KEY.002" { t.Error("Rule not match:", rule.Item, "Expect : KEY.002") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleNoOSCKey() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.006 func TestRuleTooManyFields(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "create table tbl (a int);", } common.Config.MaxColCount = 0 for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleTooManyFields() if rule.Item != "COL.006" { t.Error("Rule not match:", rule.Item, "Expect : COL.006") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.007 func TestRuleMaxTextColsCount(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "create table tbl (a int, b text, c blob, d text);", } common.Config.MaxColCount = 0 for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleMaxTextColsCount() if rule.Item != "COL.007" { t.Error("Rule not match:", rule.Item, "Expect : COL.007") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.007 func TestRuleMaxTextColsCountWithEnv(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgMaxTextColsCount := common.Config.MaxTextColsCount common.Config.MaxTextColsCount = 1 vEnv, rEnv := env.BuildEnv() defer vEnv.CleanUp() initSQLs := []string{ `CREATE TABLE t1 (id int, title text);`, `CREATE TABLE t2 (id int, title text);`, } for _, sql := range initSQLs { vEnv.BuildVirtualEnv(rEnv, sql) } sqls := [][]string{ { "alter table t1 add column other text;", }, { "alter table t2 add column col varchar(10);", }, } for _, sql := range sqls[0] { vEnv.BuildVirtualEnv(rEnv, sql) stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { t.Error(syntaxErr) } q := &Query4Audit{Query: sql, Stmt: stmt} idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleMaxTextColsCount() if rule.Item != "COL.007" { t.Error("Rule not match:", rule, "Expect : COL.007, SQL:", sql) } } } for _, sql := range sqls[1] { vEnv.BuildVirtualEnv(rEnv, sql) stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { t.Error(syntaxErr) } q := &Query4Audit{Query: sql, Stmt: stmt} idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleMaxTextColsCount() if rule.Item != "OK" { t.Error("Rule not match:", rule, "Expect : OK, SQL:", sql) } } } common.Config.MaxTextColsCount = orgMaxTextColsCount common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // TBL.002 func TestRuleAllowEngine(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE tbl (a int) engine=MyISAM;", "ALTER TABLE tbl engine=MyISAM;", "CREATE TABLE tbl (a int);", }, { "CREATE TABLE tbl (a int) engine = InnoDB;", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAllowEngine() if rule.Item != "TBL.002" { t.Error("Rule not match:", rule.Item, "Expect : TBL.002") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAllowEngine() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // TBL.001 func TestRulePartitionNotAllowed(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `CREATE TABLE trb3 (id INT, name VARCHAR(50), purchased DATE) PARTITION BY RANGE( YEAR(purchased) ) ( PARTITION p0 VALUES LESS THAN (1990), PARTITION p1 VALUES LESS THAN (1995), PARTITION p2 VALUES LESS THAN (2000), PARTITION p3 VALUES LESS THAN (2005) );`, `ALTER TABLE t1 ADD PARTITION (PARTITION p3 VALUES LESS THAN (2002));`, } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RulePartitionNotAllowed() if rule.Item != "TBL.001" { t.Error("Rule not match:", rule.Item, "Expect : TBL.001") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // COL.003 func TestRuleAutoIncUnsigned(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "CREATE TABLE `tb` ( `id` int(10) NOT NULL AUTO_INCREMENT, `c` longblob, PRIMARY KEY (`id`));", "ALTER TABLE `tbl` ADD COLUMN `id` int(10) NOT NULL AUTO_INCREMENT;", } for _, sql := range sqls { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleAutoIncUnsigned() if rule.Item != "COL.003" { t.Error("Rule not match:", rule.Item, "Expect : COL.003") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // STA.003 func TestRuleIdxPrefix(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE tbl (a int, unique key `xx_a` (`a`));", "CREATE TABLE tbl (a int, key `xx_a` (`a`));", `ALTER TABLE tbl ADD INDEX xx_a (a)`, `ALTER TABLE tbl ADD UNIQUE INDEX xx_a (a)`, }, { `ALTER TABLE tbl ADD INDEX idx_a (a)`, `ALTER TABLE tbl ADD UNIQUE INDEX uk_a (a)`, }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleIdxPrefix() if rule.Item != "STA.003" { t.Error("Rule not match:", rule.Item, "Expect : STA.003") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleIdxPrefix() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // STA.004 func TestRuleStandardName(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "CREATE TABLE `tbl-name` (a int);", "CREATE TABLE `tbl `(a int)", "CREATE TABLE t__bl (a int);", "SELECT `dataType` FROM tb;", }, { "CREATE TABLE tbl (a int)", "CREATE TABLE `tbl`(a int)", "CREATE TABLE `tbl` (a int) ENGINE=InnoDB DEFAULT CHARSET=utf8", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleStandardName() if rule.Item != "STA.004" { t.Error("Rule not match:", rule.Item, "Expect : STA.004") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleStandardName() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // STA.002 func TestRuleSpaceAfterDot(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { "SELECT * FROM sakila. film", "SELECT film. length FROM film", }, { "SELECT * FROM sakila.film", "SELECT film.length FROM film", "SELECT * FROM t1, t2 WHERE t1.title = t2.title", }, } for _, sql := range sqls[0] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSpaceAfterDot() if rule.Item != "STA.002" { t.Error("Rule not match:", rule.Item, "Expect : STA.002") } } else { t.Error("sqlparser.Parse Error:", err) } } for _, sql := range sqls[1] { q, err := NewQuery4Audit(sql) if err == nil { rule := q.RuleSpaceAfterDot() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK") } } else { t.Error("sqlparser.Parse Error:", err) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestRuleMySQLError(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) err := errors.New(`received #1146 error from MySQL server: "can't xxxx"`) if RuleMySQLError("ERR.002", err).Content != "" { t.Error("Want: '', Bug get: ", err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestMergeConflictHeuristicRules(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) tmpRules := make(map[string]Rule) for item, val := range HeuristicRules { tmpRules[item] = val } err := common.GoldenDiff(func() { suggest := MergeConflictHeuristicRules(tmpRules) var sortedSuggest []string for item := range suggest { sortedSuggest = append(sortedSuggest, item) } sort.Strings(sortedSuggest) for _, item := range sortedSuggest { pretty.Println(suggest[item]) } }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: advisor/index.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package advisor import ( "fmt" "sort" "strings" "github.com/XiaoMi/soar/ast" "github.com/XiaoMi/soar/common" "github.com/XiaoMi/soar/database" "github.com/XiaoMi/soar/env" "github.com/dchest/uniuri" "vitess.io/vitess/go/vt/sqlparser" ) const ( // IndexNameMaxLength Ref. https://dev.mysql.com/doc/refman/8.0/en/identifiers.html IndexNameMaxLength = 64 ) // IndexAdvisor 索引建议需要使用到的所有信息 type IndexAdvisor struct { vEnv *env.VirtualEnv // 线下虚拟测试环境(测试环境) rEnv database.Connector // 线上真实环境 Ast sqlparser.Statement // Vitess Parser生成的抽象语法树 where []*common.Column // 所有where条件中用到的列 whereEQ []*common.Column // where条件中可以加索引的等值条件列 whereINEQ []*common.Column // where条件中可以加索引的非等值条件列 groupBy []*common.Column // group by可以加索引列 orderBy []*common.Column // order by可以加索引列 joinCond [][]*common.Column // 由于join condition跨层级间索引不可共用,需要多一个维度用来维护层级关系 IndexMeta map[string]map[string]*database.TableIndexInfo } // IndexInfo 创建一条索引需要的信息 type IndexInfo struct { Name string `json:"name"` // 索引名称 Database string `json:"database"` // 数据库名 Table string `json:"table"` // 表名 DDL string `json:"ddl"` // ALTER, CREATE 等类型的 DDL 语句 ColumnDetails []*common.Column `json:"column_details"` // 列详情 } // IndexAdvises IndexAdvises列表 type IndexAdvises []IndexInfo // mergeAdvices 合并索引建议 func mergeAdvices(dst []IndexInfo, src ...IndexInfo) IndexAdvises { if len(src) == 0 { return dst } for _, newIdx := range src { has := false for _, idx := range dst { if newIdx.DDL == idx.DDL { common.Log.Debug("merge index %s and %s", idx.Name, newIdx.Name) has = true } } if !has { dst = append(dst, newIdx) } } return dst } // NewAdvisor 构造一个 IndexAdvisor 的时候就会对其本身结构初始化 // 获取 condition 中的等值条件、非等值条件,以及group by 、 order by信息 func NewAdvisor(env *env.VirtualEnv, rEnv database.Connector, q Query4Audit) (*IndexAdvisor, error) { common.Log.Debug("Enter: NewAdvisor(), Caller: %s", common.Caller()) if common.Config.TestDSN.Disable { return nil, fmt.Errorf("TestDSN is Disabled: %s", common.Config.TestDSN.Addr) } // DDL 检测 switch stmt := q.Stmt.(type) { case *sqlparser.DDL: // 获取ast中用到的库表 sqlMeta := ast.GetMeta(q.Stmt, nil) for db := range sqlMeta { dbRef := db if db == "" { dbRef = rEnv.Database } // DDL 在 Env 初始化的时候已经执行过了 if _, ok := env.TableMap[dbRef]; !ok { env.TableMap[dbRef] = make(map[string]string) } for _, tb := range sqlMeta[db].Table { env.TableMap[dbRef][tb.TableName] = tb.TableName } } return &IndexAdvisor{ vEnv: env, rEnv: rEnv, Ast: q.Stmt, }, nil case *sqlparser.DBDDL: // 忽略建库语句 return nil, nil case *sqlparser.Use: // 如果是use,切基础环境 env.Database = env.DBHash(stmt.DBName.String()) return nil, nil } return &IndexAdvisor{ vEnv: env, rEnv: rEnv, Ast: q.Stmt, // 所有的FindXXXXCols尽最大可能先排除不需要加索引的列,但由于元数据在此阶段尚未补齐,给出的列有可能也无法添加索引 // 后续需要通过CompleteColumnsInfo + calcCardinality补全后再进一步判断 joinCond: ast.FindJoinCols(q.Stmt), whereEQ: ast.FindWhereEQ(q.Stmt), whereINEQ: ast.FindWhereINEQ(q.Stmt), groupBy: ast.FindGroupByCols(q.Stmt), orderBy: ast.FindOrderByCols(q.Stmt), where: ast.FindAllCols(q.Stmt, ast.WhereExpression), IndexMeta: make(map[string]map[string]*database.TableIndexInfo), }, nil } /* 关于如何添加索引: 在《Relational Database Index Design and the Optimizers》一书中,作者提出著名的的三星索引理论(Three-Star Index) To Qualify for the First Star: Pick the columns from all equal predicates (WHERE COL = . . .). Make these the first columns of the index—in any order. For CURSOR41, the three-star index will begin with columns LNAME, CITY or CITY, LNAME. In both cases the index slice that must be scanned will be as thin as possible. To Qualify for the Second Star: Add the ORDER BY columns. Do not change the order of these columns, but ignore columns that were already picked in step 1. For example, if CURSOR41 had redundant columns in the ORDER BY, say ORDER BY LNAME, FNAME or ORDER BY FNAME, CITY, only FNAME would be added in this step. When FNAME is the third index column, the result table will be in the right order without sorting. The first FETCH call will return the row with the smallest FNAME value. To Qualify for the Third Star: Add all the remaining columns from the SELECT statement. The order of the columns added in this step has no impact on the performance of the SELECT, but the cost of updates should be reduced by placing volatile columns at the end. Now the index contains all the columns required for an index-only access path. 索引添加算法正是以这个理想化索策略添为基础,尽可能的给予"三星"索引建议。 但又如《High Performance MySQL》一书中所说,索引并不总是最好的工具。只有当索引帮助存储引擎快速查找到记录带来的好处大于其 带来的额外工作时,索引才是有效的。 因此,在三星索引理论的基础上引入启发式索引算法,在第二颗星的实现上做了部分改进,对于非等值条件只会添加散粒度最高的一列到索引中, 并基于总体列的使用情况作出判断,按需对order by、group by添加索引,由此来想`增强索引建议的通用性。 */ // IndexAdvise 索引优化建议算法入口主函数 // TODO 索引顺序该如何确定 func (idxAdv *IndexAdvisor) IndexAdvise() IndexAdvises { // 支持不依赖DB的索引建议分析 if common.Config.TestDSN.Disable { // 未开启Env原数据依赖,信息不全的情况下可能会给予错误的索引建议,请人工进行核查。 common.Log.Warn("TestDSN.Disable = true") } // 检查否是否含有子查询 subQueries := ast.FindSubquery(0, idxAdv.Ast) var subQueryAdvises []IndexInfo // 含有子查询对子查询进行单独评审,子查询评审建议报错忽略 if len(subQueries) > 0 { for _, subSQL := range subQueries { stmt, err := sqlparser.Parse(subSQL) if err != nil { continue } q := Query4Audit{ Query: subSQL, Stmt: stmt, } subIdxAdv, _ := NewAdvisor(idxAdv.vEnv, idxAdv.rEnv, q) subQueryAdvises = append(subQueryAdvises, subIdxAdv.IndexAdvise()...) } } // 变量初始化,用于存放索引信息,按照db.tb.[cols]组织 indexList := make(map[string]map[string][]*common.Column) // 为用到的每一列填充库名,表名等信息 var joinCond [][]*common.Column for _, joinCols := range idxAdv.joinCond { joinCond = append(joinCond, CompleteColumnsInfo(idxAdv.Ast, joinCols, idxAdv.vEnv)) } idxAdv.joinCond = joinCond idxAdv.where = CompleteColumnsInfo(idxAdv.Ast, idxAdv.where, idxAdv.vEnv) idxAdv.whereEQ = CompleteColumnsInfo(idxAdv.Ast, idxAdv.whereEQ, idxAdv.vEnv) idxAdv.whereINEQ = CompleteColumnsInfo(idxAdv.Ast, idxAdv.whereINEQ, idxAdv.vEnv) idxAdv.groupBy = CompleteColumnsInfo(idxAdv.Ast, idxAdv.groupBy, idxAdv.vEnv) idxAdv.orderBy = CompleteColumnsInfo(idxAdv.Ast, idxAdv.orderBy, idxAdv.vEnv) // 只要在开启使用env元数据的时候才会计算散粒度 if !common.Config.TestDSN.Disable { // 计算joinCond, whereEQ, whereINEQ用到的每一列的散粒度,并排序,方便后续添加复合索引 // groupBy, orderBy列按书写顺序给索引建议,不需要按散粒度排序 idxAdv.calcCardinality(idxAdv.whereEQ) idxAdv.calcCardinality(idxAdv.whereINEQ) idxAdv.calcCardinality(idxAdv.orderBy) idxAdv.calcCardinality(idxAdv.groupBy) for i, joinCols := range idxAdv.joinCond { idxAdv.calcCardinality(joinCols) joinCols = common.ColumnSort(joinCols) idxAdv.joinCond[i] = joinCols } // 根据散粒度进行排序 // 对所有列进行排序,按散粒度由大到小排序 idxAdv.whereEQ = common.ColumnSort(idxAdv.whereEQ) idxAdv.whereINEQ = common.ColumnSort(idxAdv.whereINEQ) idxAdv.orderBy = common.ColumnSort(idxAdv.orderBy) idxAdv.groupBy = common.ColumnSort(idxAdv.groupBy) } // 是否指定Where条件,打标签 hasWhere := false err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch where := node.(type) { case *sqlparser.Subquery: return false, nil case *sqlparser.Where: if where != nil { hasWhere = true } } return true, nil }, idxAdv.Ast) common.LogIfError(err, "") // 获取哪些列被忽略 var ignore []*common.Column usedCols := append(idxAdv.whereINEQ, idxAdv.whereEQ...) for _, whereCol := range idxAdv.where { isUsed := false for _, used := range usedCols { if whereCol.Equal(used) { isUsed = true } } if !isUsed { common.Log.Debug("column %s in `%s`.`%s` will ignore when adding index", whereCol.DB, whereCol.Table, whereCol.Name) ignore = append(ignore, whereCol) } } // 索引优化算法入口,从这里开始放大招 if hasWhere { // 有Where条件的先分析 等值条件 for _, index := range idxAdv.whereEQ { // 对应列在前面已经按散粒度由大到小排序好了 idxAdv.mergeIndex(indexList, index) } // 若存在非等值查询条件,可以给第一个非等值条件添加索引 if len(idxAdv.whereINEQ) > 0 { idxAdv.mergeIndex(indexList, idxAdv.whereINEQ[0]) } // 有WHERE条件,但 WHERE 条件未能给出索引建议就不能再加 GROUP BY 和 ORDER BY 建议了 if len(ignore) == 0 { // 没有非等值查询条件时可以再为 GroupBy 和 OrderBy 添加索引 for _, index := range idxAdv.groupBy { idxAdv.mergeIndex(indexList, index) } // OrderBy // 没有 GroupBy 时可以为 OrderBy 加索引 if len(idxAdv.groupBy) == 0 { for _, index := range idxAdv.orderBy { idxAdv.mergeIndex(indexList, index) } } } } else { // 未指定 Where 条件的,只需要 GroupBy 和 OrderBy 的索引建议 for _, index := range idxAdv.groupBy { idxAdv.mergeIndex(indexList, index) } // OrderBy // 没有GroupBy 时可以为 OrderBy 加索引 // 没有 where 条件时 OrderBy 的索引仅能够在索引覆盖的情况下被使用 // if len(idxAdv.groupBy) == 0 { // for _, index := range idxAdv.orderBy { // mergeIndex(indexList, index) // } // } } // 开始整合索引信息,添加索引 var indexes []IndexInfo // 为join添加索引 // 获取 join condition 中需要加索引的表有哪些 defaultDB := "" if !common.Config.TestDSN.Disable { defaultDB = idxAdv.vEnv.RealDB(idxAdv.vEnv.Database) } if !common.Config.OnlineDSN.Disable { defaultDB = idxAdv.rEnv.Database } // 根据join table的信息给予优化建议 joinTableMeta := ast.FindJoinTable(idxAdv.Ast, nil).SetDefault(idxAdv.rEnv.Database).SetDefault(defaultDB) indexes = mergeAdvices(indexes, idxAdv.buildJoinIndex(joinTableMeta)...) if common.Config.TestDSN.Disable || common.Config.OnlineDSN.Disable { // 无 env 环境下只提供单列索引,无法确定 table 时不给予优化建议 // 仅有 table 信息时给出的建议不包含 DB 信息 indexes = mergeAdvices(indexes, idxAdv.buildIndexWithNoEnv(indexList)...) } else { // 给出尽可能详细的索引建议 indexes = mergeAdvices(indexes, idxAdv.buildIndex(indexList)...) } indexes = mergeAdvices(indexes, subQueryAdvises...) // 在开启 env 的情况下,检查数据库版本,字段类型,索引总长度 indexes = idxAdv.idxColsTypeCheck(indexes) // 在开启 env 的情况下,会对索引进行检查,对全索引进行过滤 // 在前几步都不会对 idx 生成 DDL 语句,DDL语句在这里生成 return idxAdv.mergeIndexes(indexes) } // idxColsTypeCheck 对超长的字段添加前缀索引,剔除无法添索引字段的列 // TODO: 暂不支持 fulltext 索引, func (idxAdv *IndexAdvisor) idxColsTypeCheck(idxList []IndexInfo) []IndexInfo { if common.Config.TestDSN.Disable { return rmSelfDupIndex(idxList) } var indexes []IndexInfo for _, idx := range idxList { var newCols []*common.Column var newColInfo []string // 索引总长度 idxBytesTotal := 0 isOverFlow := false for _, col := range idx.ColumnDetails { // 获取字段 bytes bytes := col.GetDataBytes(common.Config.OnlineDSN.Version) tmpCol := col.Name overFlow := 0 // 加上该列后是否索引长度过长 if bytes < 0 { // bytes < 0 说明字段的长度是无法计算的 common.Log.Warning("%s.%s data type not support %s, can't add index", col.Table, col.Name, col.DataType) continue } // idx bytes over flow if total := idxBytesTotal + bytes; total > common.Config.MaxIdxBytes { common.Log.Debug("bytes: %d, idxBytesTotal: %d, total: %d, common.Config.MaxIdxBytes: %d", bytes, idxBytesTotal, total, common.Config.MaxIdxBytes) overFlow = total - common.Config.MaxIdxBytes isOverFlow = true } else { idxBytesTotal = total } // common.Config.MaxIdxColBytes 默认大小 767 if bytes > common.Config.MaxIdxBytesPerColumn || isOverFlow { // In 5.6, you may not include a column that equates to // bigger than 767 bytes: VARCHAR(255) CHARACTER SET utf8 or VARCHAR(191) CHARACTER SET utf8mb4. // In 5.7 you may not include a column that equates to // bigger than 3072 bytes. // v : 在 col.Character 字符集下每个字符占用 v bytes v, ok := common.CharSets[strings.ToLower(col.Character)] if !ok { // 找不到对应字符集,不添加索引 // 如果出现不认识的字符集,认为每个字符占用4个字节 common.Log.Warning("%s.%s(%s) charset not support yet %s, use default 4 bytes length", col.Table, col.Name, col.DataType, col.Character) v = 4 } // 保留两个字节的安全余量 length := (common.Config.MaxIdxBytesPerColumn - 2) / v if isOverFlow { // 在索引中添加该列会导致索引长度过长,建议根据需求转换为合理的前缀索引 // _OPR_SPLIT_ 是自定的用于后续处理的特殊分隔符 common.Log.Warning("adding index '%s(%s)' to table '%s' causes the index to be too long, overflow is %d", col.Name, col.DataType, col.Table, overFlow) tmpCol += fmt.Sprintf("_OPR_SPLIT_(N)") } else { // 索引没有过长,可以加一个最长的前缀索引 common.Log.Warning("index column too large: %s.%s --> %s.%s(%d), data type: %s", col.Table, col.Name, col.Table, tmpCol, length, col.DataType) tmpCol += fmt.Sprintf("_OPR_SPLIT_(%d)", length) } } newCols = append(newCols, col) newColInfo = append(newColInfo, tmpCol) } // 为新索引重建索引语句 idxName := "idx_" idxCols := "" for i, newCol := range newColInfo { // 对名称和可能存在的长度进行拼接 // 用等号进行分割 tmp := strings.Split(newCol, "_OPR_SPLIT_") idxName += tmp[0] if len(tmp) > 1 { idxCols += tmp[0] + "`" + tmp[1] } else { idxCols += tmp[0] + "`" } if i+1 < len(newColInfo) { idxName += "_" idxCols += ",`" } } // 索引名称最大长度64 if len(idxName) > IndexNameMaxLength { common.Log.Warn("index '%s' name large than IndexNameMaxLength", idxName) idxName = strings.TrimRight(idxName[:IndexNameMaxLength], "_") } // 新的alter语句 newDDL := fmt.Sprintf("alter table `%s`.`%s` add index `%s` (`%s)", idxAdv.vEnv.RealDB(idx.Database), idx.Table, idxName, idxCols) // 将筛选改造后的索引信息信息加入到新的索引列表中 idx.ColumnDetails = newCols idx.DDL = newDDL indexes = append(indexes, idx) } return indexes } // mergeIndexes 与线上环境对比,将给出的索引建议进行去重 func (idxAdv *IndexAdvisor) mergeIndexes(idxList []IndexInfo) []IndexInfo { // TODO 暂不支持前缀索引去重 if common.Config.TestDSN.Disable { return rmSelfDupIndex(idxList) } var indexes []IndexInfo for _, idx := range idxList { // 将 DB 替换成 vEnv 中的数据库名称 dbInVEnv := idx.Database if _, ok := idxAdv.vEnv.DBRef[idx.Database]; ok { dbInVEnv = idxAdv.vEnv.DBRef[idx.Database] } // 检测索引添加的表是否是视图 if idxAdv.vEnv.IsView(idx.Table) { common.Log.Info("%s.%s is a view. no need indexed", idx.Database, idx.Table) continue } // 检测是否存在重复索引 indexMeta := idxAdv.IndexMeta[dbInVEnv][idx.Table] isExisted := false // 检测无索引列的情况 if len(idx.ColumnDetails) < 1 { continue } if existedIndexes := indexMeta.FindIndex(database.IndexColumnName, idx.ColumnDetails[0].Name); len(existedIndexes) > 0 { for _, existedIdx := range existedIndexes { // flag: 用于标记已存在的索引是否是约束条件 isConstraint := false var cols []string var colsDetail []*common.Column // 把已经存在的 key 摘出来遍历一遍对比是否是包含关系 for _, col := range indexMeta.FindIndex(database.IndexKeyName, existedIdx.KeyName) { cols = append(cols, col.ColumnName) colsDetail = append(colsDetail, &common.Column{ Name: col.ColumnName, Table: idx.Table, DB: idx.ColumnDetails[0].DB, }) } // 判断已存在的索引是否属于约束条件(唯一索引、主键) // 这里可以忽略是否含有外键的情况,因为索引已经重复了,添加了新索引后原先重复的索引是可以删除的。 if existedIdx.NonUnique == 0 { common.Log.Debug("%s.%s表%s为约束条件", dbInVEnv, idx.Table, existedIdx.KeyName) isConstraint = true } // 如果已存在的索引与索引建议存在重叠,则说明无需添加新索引或可能需要给出删除索引的建议 if common.IsColsPart(colsDetail, idx.ColumnDetails) { idxName := existedIdx.KeyName // 如果已经存在的索引包含需要添加的索引,则无需添加 if len(colsDetail) >= len(idx.ColumnDetails) { common.Log.Info(" `%s`.`%s` %s already had a index `%s`", idx.Database, idx.Table, strings.Join(cols, ","), idxName) isExisted = true continue } // 库、表、列名需要用反撇转义 // TODO: 关于外键索引去重的优雅解决方案 if !isConstraint { if common.Config.AllowDropIndex { alterSQL := fmt.Sprintf("alter table `%s`.`%s` drop index `%s`", idx.Database, idx.Table, idxName) indexes = append(indexes, IndexInfo{ Name: idxName, Database: idx.Database, Table: idx.Table, DDL: alterSQL, ColumnDetails: colsDetail, }) } else { common.Log.Warning("In table `%s`, the new index of column `%s` contains index `%s`,"+ " maybe you could drop one of them.", existedIdx.Table, strings.Join(cols, ","), idxName) } } } } } if !isExisted { // 检测索引名称是否重复? if existedIndexes := indexMeta.FindIndex(database.IndexKeyName, idx.Name); len(existedIndexes) > 0 { var newName string idxSuffix := getRandomIndexSuffix() if len(idx.Name) < IndexNameMaxLength-len(idxSuffix) { newName = idx.Name + idxSuffix } else { newName = idx.Name[:IndexNameMaxLength-len(idxSuffix)] + idxSuffix } common.Log.Warning("duplicate index name '%s', new name is '%s'", idx.Name, newName) idx.DDL = strings.Replace(idx.DDL, idx.Name, newName, -1) idx.Name = newName } // 添加合并 indexes = mergeAdvices(indexes, idx) } } // 对索引进行去重 return rmSelfDupIndex(indexes) } // getRandomIndexSuffix format: _xxxx, length: 5 func getRandomIndexSuffix() string { return fmt.Sprintf("_%s", uniuri.New()[:4]) } // rmSelfDupIndex 去重传入的[]IndexInfo中重复的索引 func rmSelfDupIndex(indexes []IndexInfo) []IndexInfo { var resultIndex []IndexInfo tmpIndexList := indexes for _, a := range indexes { tmp := a for i, b := range tmpIndexList { if common.IsColsPart(tmp.ColumnDetails, b.ColumnDetails) && tmp.Name != b.Name { if len(b.ColumnDetails) > len(tmp.ColumnDetails) { common.Log.Debug("remove duplicate index: %s", tmp.Name) tmp = b } if i < len(tmpIndexList) { tmpIndexList = append(tmpIndexList[:i], tmpIndexList[i+1:]...) } else { tmpIndexList = tmpIndexList[:i] } } } resultIndex = mergeAdvices(resultIndex, tmp) } return resultIndex } // buildJoinIndex 检查Join中使用的库表是否需要添加索引并给予索引建议 func (idxAdv *IndexAdvisor) buildJoinIndex(meta common.Meta) []IndexInfo { var indexes []IndexInfo for _, IndexCols := range idxAdv.joinCond { // 如果该列的库表为join condition中需要添加索引的库表 indexColsList := make(map[string]map[string][]*common.Column) for _, col := range IndexCols { idxAdv.mergeIndex(indexColsList, col) } if common.Config.TestDSN.Disable || common.Config.OnlineDSN.Disable { indexes = mergeAdvices(indexes, idxAdv.buildIndexWithNoEnv(indexColsList)...) continue } indexes = mergeAdvices(indexes, idxAdv.buildIndex(indexColsList)...) } return indexes } // buildIndex 尽可能的将 map[string]map[string][]*common.Column 转换成 []IndexInfo // 此处不判断索引是否重复 func (idxAdv *IndexAdvisor) buildIndex(idxList map[string]map[string][]*common.Column) []IndexInfo { var indexes []IndexInfo for db, tbs := range idxList { for tb, cols := range tbs { // 单个索引中含有的列收 config 中参数限制 if len(cols) > common.Config.MaxIdxColsCount { cols = cols[:common.Config.MaxIdxColsCount] } var colNames []string for _, col := range cols { if col.DB == "" || col.Table == "" { common.Log.Warn("can not get the meta info of column '%s'", col.Name) continue } colNames = append(colNames, col.Name) } if len(colNames) == 0 { continue } idxName := common.Config.IdxPrefix + strings.Join(colNames, "_") // 索引名称最大长度64 if len(idxName) > IndexNameMaxLength { common.Log.Warn("index '%s' name large than IndexNameMaxLength", idxName) idxName = strings.TrimRight(idxName[:IndexNameMaxLength], "_") } alterSQL := fmt.Sprintf("alter table `%s`.`%s` add index `%s` (`%s`)", idxAdv.vEnv.RealDB(db), tb, idxName, strings.Join(colNames, "`,`")) indexes = append(indexes, IndexInfo{ Name: idxName, Database: idxAdv.vEnv.RealDB(db), Table: tb, DDL: alterSQL, ColumnDetails: cols, }) } } return indexes } // buildIndexWithNoEnv 忽略原数据,给予最基础的索引 func (idxAdv *IndexAdvisor) buildIndexWithNoEnv(indexList map[string]map[string][]*common.Column) []IndexInfo { // 如果不获取数据库原信息,则不去判断索引是否重复,且只给单列加索引 var indexes []IndexInfo for _, tableIndex := range indexList { for _, indexCols := range tableIndex { for _, col := range indexCols { if col.Table == "" { common.Log.Warn("can not get the meta info of column '%s'", col.Name) continue } idxName := common.Config.IdxPrefix + col.Name // 库、表、列名需要用反撇转义 alterSQL := fmt.Sprintf("alter table `%s`.`%s` add index `%s` (`%s`)", idxAdv.vEnv.RealDB(col.DB), col.Table, idxName, col.Name) if col.DB == "" { alterSQL = fmt.Sprintf("alter table `%s` add index `%s` (`%s`)", col.Table, idxName, col.Name) } indexes = append(indexes, IndexInfo{ Name: idxName, Database: idxAdv.vEnv.RealDB(col.DB), Table: col.Table, DDL: alterSQL, ColumnDetails: []*common.Column{col}, }) } } } return indexes } // mergeIndex 将索引用到的列去重后合并到一起 func (idxAdv *IndexAdvisor) mergeIndex(idxList map[string]map[string][]*common.Column, column *common.Column) { // 散粒度低于阈值将不会添加索引 if common.Config.MinCardinality/100 > column.Cardinality { return } db := column.DB tb := column.Table if idxList[db] == nil { idxList[db] = make(map[string][]*common.Column) } if idxList[db][tb] == nil { idxList[db][tb] = make([]*common.Column, 0) } // 去除重复列Append exist := false for _, cl := range idxList[db][tb] { if cl.Name == column.Name { exist = true } } // 将 DB 替换成 vEnv 中的数据库名称 dbInVEnv := db if _, ok := idxAdv.vEnv.DBRef[db]; ok { dbInVEnv = idxAdv.vEnv.DBRef[db] } indexMeta := idxAdv.IndexMeta[dbInVEnv][tb] // 主键列不需要追加 pr := indexMeta.FindIndex(database.IndexKeyName, "PRIMARY") for _, c := range pr { if c.ColumnName == column.Name { exist = true } } if !exist { idxList[db][tb] = append(idxList[db][tb], column) } } // CompleteColumnsInfo 补全索引可能会用到列的所属库名、表名等信息 func CompleteColumnsInfo(stmt sqlparser.Statement, cols []*common.Column, env *env.VirtualEnv) []*common.Column { // 如果传过来的列是空的,没必要跑逻辑 if len(cols) == 0 { return cols } // 从 Ast 中拿到 DBStructure,包含所有表的相关信息 dbs := ast.GetMeta(stmt, nil) // 此处生成的 meta 信息中不应该含有""db的信息,若 DB 为空则认为是已传入的 db 为默认 db 并进行信息补全 // BUG Fix: // 修补 dbs 中空 DB 的导致后续补全列信息时无法获取正确 table 名称的问题 if _, ok := dbs[""]; ok { dbs[env.Database] = dbs[""] delete(dbs, "") } tableCount := 0 for db := range dbs { for tb := range dbs[db].Table { if tb != "" { tableCount++ } } } var noEnvTmp []*common.Column for _, col := range cols { for db := range dbs { // 对每一列进行比对,将别名转换为正确的名称 find := false for _, tb := range dbs[db].Table { for _, tbAlias := range tb.TableAliases { if col.Table != "" && col.Table == tbAlias { common.Log.Debug("column '%s' prefix change: %s --> %s", col.Name, col.Table, tb.TableName) find = true col.Table = tb.TableName col.DB = db break } } if find { break } } // 如果不依赖env环境,利用ast中包含的信息推理列的库表信息 if common.Config.TestDSN.Disable { if tableCount == 1 { for _, tb := range dbs[db].Table { col.Table = tb.TableName // 因为tableMeta是按照库表组织的树状结构,db变量贯穿全局 // 只有在最终赋值前才能根据逻辑变更补全 if db == "" { db = env.Database } col.DB = db } } // 如果SQL中含有的表大于一个,则使用的列中必须含有前缀,不然无法判断该列属于哪个表 // 如果某一列未含有前缀信息,则认为两张表中都含有该列,需要由人去判断 if tableCount > 1 { if col.Table == "" { for _, tb := range dbs[db].Table { if tb.TableName == "" { common.Log.Warn("can not get the meta info of column '%s'", col.Name) } if db == "" { db = env.RealDB(env.Database) } col.Table = tb.TableName col.DB = db tmp := *col tmp.Table = tb.TableName tmp.DB = db noEnvTmp = append(noEnvTmp, &tmp) } } if col.DB == "" { if db == "" { db = env.Database } col.DB = db } } break } // 将已经获取到正确表信息的列信息带入到env中,利用show columns where table 获取库表信息 // 此出会传入之前从ast中,该 db 下获取的所有表来作为where限定条件, // 防止与SQL无关的库表信息干扰准确性 // 此处传入的是测试环境,DB 是经过变换的,所以在寻找列名的时候需要将 DB 名称转换成测试环境中经过 hash 的 DB 名称 // 不然会找不到col的信息 realCols, err := env.FindColumn(col.Name, env.DBHash(db), dbs.Tables(db)...) if err != nil { common.Log.Warn("%v", err) continue } // 对比 column 信息中的表名与从 env 中获取的库表名的一致性 for _, realCol := range realCols { if col.Name == realCol.Name { // 如果查询到了列名一致,但从 ast 中获取的列的前缀与 env 中的表信息不符 // 1.存在一个同名列,但不同表,该情况下忽略 // 2.存在一个未正确转换的别名(如表名为),该情况下修正,大概率是正确的 if col.Table != "" && col.Table != realCol.Table { has, _ := env.FindColumn(col.Name, env.DBHash(db), col.Table) if len(has) > 0 { realCol = has[0] } } col.DataType = realCol.DataType col.Table = realCol.Table col.DB = env.RealDB(realCol.DB) col.Character = realCol.Character col.Collation = realCol.Collation } } } } // 如果不依赖env环境,将可能存在的列也加入到索引预处理列表中 if common.Config.TestDSN.Disable { cols = append(cols, noEnvTmp...) } return cols } // calcCardinality 计算每一列的散粒度 // 这个函数需要在补全列的库表信息之后再调用,否则无法确定要计算列的归属 func (idxAdv *IndexAdvisor) calcCardinality(cols []*common.Column) []*common.Column { common.Log.Debug("Enter: calcCardinality(), Caller: %s", common.Caller()) tmpDB := *idxAdv.vEnv for _, col := range cols { // 补全对应列的库->表->索引信息到IndexMeta // 这将在后面用于判断某一列是否为主键或单列唯一索引,快速返回散粒度 if col.DB == "" { col.DB = idxAdv.vEnv.Database } realDB := idxAdv.vEnv.DBHash(col.DB) if idxAdv.IndexMeta[realDB] == nil { idxAdv.IndexMeta[realDB] = make(map[string]*database.TableIndexInfo) } if idxAdv.IndexMeta[realDB][col.Table] == nil { tmpDB.Database = realDB indexInfo, err := tmpDB.ShowIndex(col.Table) if err != nil { // 如果是不存在的表就会报错,报错的可能性有三个: // 1.数据库错误 2.表不存在 3.临时表 // 而这三种错误都是不需要在这一层关注的,直接跳过 common.Log.Warn("calcCardinality error: %v", err) continue } // 将获取的索引信息以db.tb 维度组织到 IndexMeta 中 idxAdv.IndexMeta[realDB][col.Table] = indexInfo } // 检查对应列是否为主键或单列唯一索引,如果满足直接返回1,不再重复计算,提高效率 // 多列复合唯一索引不能跳过计算,单列普通索引不能跳过计算 for _, index := range idxAdv.IndexMeta[realDB][col.Table].Rows { // 根据索引的名称判断该索引包含的列数,列数大于1即为复合索引 columnCount := len(idxAdv.IndexMeta[realDB][col.Table].FindIndex(database.IndexKeyName, index.KeyName)) if col.Name == index.ColumnName { // 主键、唯一键 无需计算散粒度 if (index.KeyName == "PRIMARY" || index.NonUnique == 0) && columnCount == 1 { common.Log.Debug("column '%s' is PK or UK, no need to calculate cardinality.", col.Name) col.Cardinality = 1 break } } } // 给非 PRIMARY、UNIQUE 的列计算散粒度 if col.Cardinality != 1 { col.Cardinality = idxAdv.vEnv.ColumnCardinality(col.Table, col.Name) } } return cols } // Format 用于格式化输出索引建议 func (idxAdvs IndexAdvises) Format() map[string]Rule { rulesMap := make(map[string]Rule) number := 1 rules := make(map[string]*Rule) sqls := make(map[string][]string) for _, advise := range idxAdvs { advKey := advise.Database + advise.Table if _, ok := sqls[advKey]; !ok { sqls[advKey] = make([]string, 0) } sqls[advKey] = append(sqls[advKey], advise.DDL) if _, ok := rules[advKey]; !ok { summary := fmt.Sprintf("为%s库的%s表添加索引", advise.Database, advise.Table) if advise.Database == "" { summary = fmt.Sprintf("为%s表添加索引", advise.Table) } rules[advKey] = &Rule{ Summary: summary, Content: "", Severity: "L2", } } for _, col := range advise.ColumnDetails { // 为了更好地显示效果 if common.Config.Sampling { cardinal := fmt.Sprintf("%0.2f", col.Cardinality*100) if cardinal != "0.00" { rules[advKey].Content += fmt.Sprintf("为列%s添加索引,散粒度为: %s%%; ", col.Name, cardinal) } } else { rules[advKey].Content += fmt.Sprintf("为列%s添加索引;", col.Name) } } if !common.Config.Sampling && len(rules[advKey].Content) > 5 { rules[advKey].Content += " 由于未开启数据采样,各列在索引中的顺序需要自行调整。" } // 清理多余的标点 rules[advKey].Content = strings.Trim(rules[advKey].Content, common.Config.Delimiter) } var sortAdvs []string for adv := range rules { sortAdvs = append(sortAdvs, adv) } sort.Strings(sortAdvs) for _, adv := range sortAdvs { key := fmt.Sprintf("IDX.%03d", number) ddl := ast.MergeAlterTables(sqls[adv]...) // 由于传入合并的SQL都是一张表的,所以一定只会输出一条ddl语句 for _, v := range ddl { rules[adv].Case = v } // set item rules[adv].Item = key rulesMap[key] = *rules[adv] number++ } return rulesMap } // HeuristicCheck 依赖数据字典的启发式检查 // IndexAdvisor会构建测试环境和数据字典,所以放在这里实现 func (idxAdv *IndexAdvisor) HeuristicCheck(q Query4Audit) map[string]Rule { var rule Rule heuristicSuggest := make(map[string]Rule) if common.Config.OnlineDSN.Disable && common.Config.TestDSN.Disable { return heuristicSuggest } ruleFuncs := []func(*IndexAdvisor) Rule{ (*IndexAdvisor).RuleMaxTextColsCount, // COL.007 (*IndexAdvisor).RuleImplicitConversion, // ARG.003 (*IndexAdvisor).RuleGroupByConst, // CLA.004 (*IndexAdvisor).RuleOrderByConst, // CLA.005 (*IndexAdvisor).RuleUpdatePrimaryKey, // CLA.016 // (*IndexAdvisor).RuleImpossibleOuterJoin, // TODO: JOI.003, JOI.004 } for _, f := range ruleFuncs { rule = f(idxAdv) if rule.Item != "OK" { heuristicSuggest[rule.Item] = rule } } return heuristicSuggest } // DuplicateKeyChecker 对所有用到的库表检查是否存在重复索引 func DuplicateKeyChecker(conn *database.Connector, databases ...string) map[string]Rule { common.Log.Debug("Enter: DuplicateKeyChecker, Caller: %s", common.Caller()) // 复制一份online connector,防止环境切换影响其他功能的使用 tmpOnline := *conn ruleMap := make(map[string]Rule) number := 1 // 错误处理,用于汇总所有的错误 funcErrCheck := func(err error) { if err != nil { if sug, ok := ruleMap["ERR.003"]; ok { sug.Content += fmt.Sprintf("; %s", err.Error()) } else { ruleMap["ERR.003"] = Rule{ Item: "ERR.003", Severity: "L8", Content: err.Error(), } } } } // 不指定 DB 的时候检查 online dsn 中的 DB if len(databases) == 0 { databases = append(databases, tmpOnline.Database) } for _, db := range databases { // 获取所有的表 tmpOnline.Database = db tables, err := tmpOnline.ShowTables() if err != nil { funcErrCheck(err) if !common.Config.DryRun { return ruleMap } } for _, tb := range tables { // 获取表中所有的索引 idxMap := make(map[string][]*common.Column) idxInfo, err := tmpOnline.ShowIndex(tb) if err != nil { funcErrCheck(err) if !common.Config.DryRun { return ruleMap } } // 枚举所有的索引信息,提取用到的列 for _, idx := range idxInfo.Rows { if _, ok := idxMap[idx.KeyName]; !ok { idxMap[idx.KeyName] = make([]*common.Column, 0) for _, col := range idxInfo.FindIndex(database.IndexKeyName, idx.KeyName) { idxMap[idx.KeyName] = append(idxMap[idx.KeyName], &common.Column{ Name: col.ColumnName, Table: tb, DB: db, }) } } } // 对索引进行重复检查 hasDup := false content := "" for k1, cl1 := range idxMap { for k2, cl2 := range idxMap { if k1 != k2 && common.IsColsPart(cl1, cl2) { // by pass primary key if k1 == "PRIMARY" || k2 == "PRIMARY" { continue } hasDup = true col1Str := common.JoinColumnsName(cl1, ", ") col2Str := common.JoinColumnsName(cl2, ", ") content += fmt.Sprintf("索引%s(%s)与%s(%s)重复;", k1, col1Str, k2, col2Str) common.Log.Debug(" %s.%s has duplicate index %s(%s) <--> %s(%s)", db, tb, k1, col1Str, k2, col2Str) } } delete(idxMap, k1) } // TODO 重复索引检查添加对约束及索引的判断,提供重复索引的删除功能 if hasDup { tmpOnline.Database = db ddl, _ := tmpOnline.ShowCreateTable(tb) key := fmt.Sprintf("IDX.%03d", number) ruleMap[key] = Rule{ Item: key, Severity: "L2", Summary: fmt.Sprintf("%s.%s存在重复的索引", db, tb), Content: content, Case: ddl, } number++ } } } return ruleMap } ================================================ FILE: advisor/index_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package advisor import ( "flag" "fmt" "os" "path/filepath" "runtime" "strings" "testing" "github.com/XiaoMi/soar/common" "github.com/XiaoMi/soar/database" "github.com/XiaoMi/soar/env" "github.com/kr/pretty" "vitess.io/vitess/go/vt/sqlparser" ) var update = flag.Bool("update", false, "update .golden files") var vEnv *env.VirtualEnv var rEnv *database.Connector func TestMain(m *testing.M) { // 初始化 init if common.DevPath == "" { _, file, _, _ := runtime.Caller(0) common.DevPath, _ = filepath.Abs(filepath.Dir(filepath.Join(file, ".."+string(filepath.Separator)))) } common.BaseDir = common.DevPath err := common.ParseConfig("") common.LogIfError(err, "init ParseConfig") common.Log.Debug("advisor_test init") vEnv, rEnv = env.BuildEnv() if _, err = vEnv.Version(); err != nil { fmt.Println(err.Error(), ", By pass all advisor test cases") os.Exit(0) } if _, err := rEnv.Version(); err != nil { fmt.Println(err.Error(), ", By pass all advisor test cases") os.Exit(0) } // 分割线 flag.Parse() m.Run() // 环境清理 vEnv.CleanUp() } // ARG.003 func TestRuleImplicitConversion(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) dsn := common.Config.OnlineDSN common.Config.OnlineDSN = common.Config.TestDSN initSQLs := []string{ `CREATE TABLE t1 (id int, title varchar(255) CHARSET utf8 COLLATE utf8_general_ci);`, `CREATE TABLE t2 (id int, title varchar(255) CHARSET utf8mb4);`, `CREATE TABLE t3 (id int, title varchar(255) CHARSET utf8 COLLATE utf8_bin);`, `CREATE TABLE t4 (id int, col bit(1));`, } for _, sql := range initSQLs { vEnv.BuildVirtualEnv(rEnv, sql) } sqls := [][]string{ // ARG.003 { "SELECT * FROM t1 WHERE title >= 60;", "SELECT * FROM t1, t2 WHERE t1.title = t2.title;", "SELECT * FROM t1, t3 WHERE t1.title = t3.title;", "SELECT * FROM t1 WHERE title in (60, '60');", "SELECT * FROM t1 WHERE title in (60);", "SELECT * FROM t1 WHERE title in (60, 60);", "SELECT * FROM t1 WHERE title = 1", }, // OK { "SELECT * FROM t1 WHERE id = '1'", // string -> int can use index "SELECT * FROM t1 WHERE id = 1", "SELECT * FROM t4 WHERE col = 1", // https://github.com/XiaoMi/soar/issues/151 "SELECT * FROM sakila.film WHERE rental_rate > 1", }, } for _, sql := range sqls[0] { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleImplicitConversion() if rule.Item != "ARG.003" { t.Error("Rule not match:", rule.Item, "Expect : ARG.003, SQL:", sql) } } } for _, sql := range sqls[1] { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleImplicitConversion() if rule.Item != "OK" { t.Error("Rule not match:", rule.Item, "Expect : OK, SQL:", sql) } } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) common.Config.OnlineDSN = dsn common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // JOI.003 & JOI.004 func TestRuleImpossibleOuterJoin(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select city_id, city, country from city left outer join country using(country_id) WHERE city.city_id=59 and country.country='Algeria'`, `select city_id, city, country from city left outer join country using(country_id) WHERE country.country='Algeria'`, `select city_id, city, country from city left outer join country on city.country_id=country.country_id WHERE city.city_id IS NULL`, } for _, sql := range sqls { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleImpossibleOuterJoin() if rule.Item != "JOI.003" && rule.Item != "JOI.004" { t.Error("Rule not match:", rule, "Expect : JOI.003 || JOI.004") } } } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // GRP.001 func TestIndexAdvisorRuleGroupByConst(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `select film_id, title from film where release_year='2006' group by release_year`, `select film_id, title from film where release_year in ('2006') group by release_year`, }, { // 反面的例子 `select film_id, title from film where release_year in ('2006', '2007') group by release_year`, }, } for _, sql := range sqls[0] { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleGroupByConst() if rule.Item != "GRP.001" { t.Error("Rule not match:", rule, "Expect : GRP.001") } } } } for _, sql := range sqls[1] { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleGroupByConst() if rule.Item != "OK" { t.Error("Rule not match:", rule, "Expect : OK") } } } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.005 func TestIndexAdvisorRuleOrderByConst(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `select film_id, title from film where release_year='2006' order by release_year;`, `select film_id, title from film where release_year in ('2006') order by release_year;`, }, { // 反面的例子 `select film_id, title from film where release_year in ('2006', '2007') order by release_year;`, }, } for _, sql := range sqls[0] { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleOrderByConst() if rule.Item != "CLA.005" { t.Error("Rule not match:", rule, "Expect : CLA.005") } } } } for _, sql := range sqls[1] { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleOrderByConst() if rule.Item != "OK" { t.Error("Rule not match:", rule, "Expect : OK") } } } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } // CLA.016 func TestRuleUpdatePrimaryKey(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := [][]string{ { `update film set film_id = 1 where title='a';`, }, { // 反面的例子 `select film_id, title from film where release_year in ('2006', '2007') order by release_year;`, }, } for _, sql := range sqls[0] { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleUpdatePrimaryKey() if rule.Item != "CLA.016" { t.Error("Rule not match:", rule.Item, "Expect : CLA.016") } } } } for _, sql := range sqls[1] { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.RuleUpdatePrimaryKey() if rule.Item != "OK" { t.Error("Rule not match:", rule, "Expect : OK") } } } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestIndexAdvise(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgMinCardinality := common.Config.MinCardinality common.Config.MinCardinality = 20 for _, sql := range common.TestSQLs { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.IndexAdvise().Format() if len(rule) > 0 { _, _ = pretty.Println(rule) } } } } common.Config.MinCardinality = orgMinCardinality common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestIndexAdviseNoEnv(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgOnlineDSNStatus := common.Config.OnlineDSN.Disable common.Config.OnlineDSN.Disable = true for _, sql := range common.TestSQLs { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } if idxAdvisor != nil { rule := idxAdvisor.IndexAdvise().Format() if len(rule) > 0 { pretty.Println(rule) } } } } common.Config.OnlineDSN.Disable = orgOnlineDSNStatus common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestDuplicateKeyChecker(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) rule := DuplicateKeyChecker(rEnv, "sakila") if len(rule) != 0 { t.Errorf("got rules: %s", pretty.Sprint(rule)) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestMergeAdvices(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) dst := []IndexInfo{ { Name: "test", Database: "db", Table: "tb", ColumnDetails: []*common.Column{ { Name: "test", }, }, }, } src := dst[0] advise := mergeAdvices(dst, src) if len(advise) != 1 { t.Error(pretty.Sprint(advise)) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestIdxColsTypeCheck(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `select city_id, city, country from city left outer join country using(country_id) WHERE city.city_id=59 and country.country='Algeria'`, } for _, sql := range sqls { stmt, syntaxErr := sqlparser.Parse(sql) if syntaxErr != nil { common.Log.Critical("Syntax Error: %v, SQL: %s", syntaxErr, sql) } q := &Query4Audit{Query: sql, Stmt: stmt} if vEnv.BuildVirtualEnv(rEnv, q.Query) { idxAdvisor, err := NewAdvisor(vEnv, *rEnv, *q) if err != nil { t.Error("NewAdvisor Error: ", err, "SQL: ", sql) } idxList := []IndexInfo{ { Name: "idx_fk_country_id", Database: "sakila", Table: "city", ColumnDetails: []*common.Column{ { Name: "country_id", Character: "utf8", DataType: "varchar(3000)", }, }, }, } if idxAdvisor != nil { rule := idxAdvisor.idxColsTypeCheck(idxList) if !(len(rule) > 0 && rule[0].DDL == "alter table `sakila`.`city` add index `idx_country_id` (`country_id`(N))") { t.Error(pretty.Sprint(rule)) } } } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestGetRandomIndexSuffix(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) for i := 0; i < 5; i++ { r := getRandomIndexSuffix() if !(strings.HasPrefix(r, "_") && len(r) == 5) { t.Errorf("getRandomIndexSuffix should return a string with prefix `_` and 5 length, but got:%s", r) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: advisor/rules.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package advisor import ( "encoding/json" "fmt" "regexp" "sort" "strconv" "strings" "github.com/XiaoMi/soar/ast" "github.com/XiaoMi/soar/common" "github.com/kr/pretty" "github.com/percona/go-mysql/query" tidb "github.com/pingcap/parser/ast" "vitess.io/vitess/go/vt/sqlparser" ) // Query4Audit 待评审的SQL结构体,由原SQL和其对应的抽象语法树组成 type Query4Audit struct { Query string // 查询语句 Stmt sqlparser.Statement // 通过Vitess解析出的抽象语法树 TiStmt []tidb.StmtNode // 通过TiDB解析出的抽象语法树 } // NewQuery4Audit return a struct for Query4Audit func NewQuery4Audit(sql string, options ...string) (*Query4Audit, error) { var err, vErr error var charset string var collation string if len(options) > 0 { charset = options[0] } if len(options) > 1 { collation = options[1] } q := &Query4Audit{Query: sql} // vitess 语法解析不上报,以 tidb parser 为主 q.Stmt, vErr = sqlparser.Parse(sql) if vErr != nil { common.Log.Warn("NewQuery4Audit vitess parse Error: %s, Query: %s", vErr.Error(), sql) } // TODO: charset, collation // tidb parser 语法解析 q.TiStmt, err = ast.TiParse(sql, charset, collation) return q, err } // Rule 评审规则元数据结构 type Rule struct { Item string `json:"Item"` // 规则代号 Severity string `json:"Severity"` // 危险等级:L[0-8], 数字越大表示级别越高 Summary string `json:"Summary"` // 规则摘要 Content string `json:"Content"` // 规则解释 Case string `json:"Case"` // SQL示例 Position int `json:"Position"` // 建议所处SQL字符位置,默认0表示全局建议 Func func(*Query4Audit) Rule `json:"-"` // 函数名 } /* ## Item单词缩写含义 * ALI Alias(AS) * ALT Alter * ARG Argument * CLA Classic * COL Column * DIS Distinct * ERR Error, 特指MySQL执行返回的报错信息, ERR.000为vitess语法错误,ERR.001为执行错误,ERR.002为EXPLAIN错误 * EXP Explain, 由explain模块给 * FUN Function * IDX Index, 由index模块给 * JOI Join * KEY Key * KWR Keyword * LCK Lock * LIT Literal * PRO Profiling, 由profiling模块给 * RES Result * SEC Security * STA Standard * SUB Subquery * TBL TableName * TRA Trace, 由trace模块给 */ // HeuristicRules 启发式规则列表 var HeuristicRules map[string]Rule func init() { InitHeuristicRules() } // InitHeuristicRules ... func InitHeuristicRules() { HeuristicRules = map[string]Rule{ "OK": { Item: "OK", Severity: "L0", Summary: "OK", Content: `OK`, Case: "OK", Func: (*Query4Audit).RuleOK, }, "ALI.001": { Item: "ALI.001", Severity: "L0", Summary: "建议使用 AS 关键字显示声明一个别名", Content: `在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。`, Case: "select name from tbl t1 where id < 1000", Func: (*Query4Audit).RuleImplicitAlias, }, "ALI.002": { Item: "ALI.002", Severity: "L8", Summary: "不建议给列通配符'*'设置别名", Content: `例: "SELECT tbl.* col1, col2"上面这条 SQL 给列通配符设置了别名,这样的SQL可能存在逻辑错误。您可能意在查询 col1, 但是代替它的是重命名的是 tbl 的最后一列。`, Case: "select tbl.* as c1,c2,c3 from tbl where id < 1000", Func: (*Query4Audit).RuleStarAlias, }, "ALI.003": { Item: "ALI.003", Severity: "L1", Summary: "别名不要与表或列的名字相同", Content: `表或列的别名与其真实名称相同, 这样的别名会使得查询更难去分辨。`, Case: "select name from tbl as tbl where id < 1000", Func: (*Query4Audit).RuleSameAlias, }, "ALT.001": { Item: "ALT.001", Severity: "L4", Summary: "修改表的默认字符集不会改表各个字段的字符集", Content: `很多初学者会将 ALTER TABLE tbl_name [DEFAULT] CHARACTER SET 'UTF8' 误认为会修改所有字段的字符集,但实际上它只会影响后续新增的字段不会改表已有字段的字符集。如果想修改整张表所有字段的字符集建议使用 ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name;`, Case: "ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name;", Func: (*Query4Audit).RuleAlterCharset, }, "ALT.002": { Item: "ALT.002", Severity: "L2", Summary: "同一张表的多条 ALTER 请求建议合为一条", Content: `每次表结构变更对线上服务都会产生影响,即使是能够通过在线工具进行调整也请尽量通过合并 ALTER 请求的试减少操作次数。`, Case: "ALTER TABLE tbl ADD COLUMN col int, ADD INDEX idx_col (`col`);", Func: (*Query4Audit).RuleOK, // 该建议在indexAdvisor中给 }, "ALT.003": { Item: "ALT.003", Severity: "L0", Summary: "删除列为高危操作,操作前请注意检查业务逻辑是否还有依赖", Content: `如业务逻辑依赖未完全消除,列被删除后可能导致数据无法写入或无法查询到已删除列数据导致程序异常的情况。这种情况下即使通过备份数据回滚也会丢失用户请求写入的数据。`, Case: "ALTER TABLE tbl DROP COLUMN col;", Func: (*Query4Audit).RuleAlterDropColumn, }, "ALT.004": { Item: "ALT.004", Severity: "L0", Summary: "删除主键和外键为高危操作,操作前请与 DBA 确认影响", Content: `主键和外键为关系型数据库中两种重要约束,删除已有约束会打破已有业务逻辑,操作前请业务开发与 DBA 确认影响,三思而行。`, Case: "ALTER TABLE tbl DROP PRIMARY KEY;", Func: (*Query4Audit).RuleAlterDropKey, }, "ARG.001": { Item: "ARG.001", Severity: "L4", Summary: "不建议使用前项通配符查找", Content: `例如 "%foo",查询参数有一个前项通配符的情况无法使用已有索引。`, Case: "select c1,c2,c3 from tbl where name like '%foo'", Func: (*Query4Audit).RulePrefixLike, }, "ARG.002": { Item: "ARG.002", Severity: "L1", Summary: "没有通配符的 LIKE 查询", Content: `不包含通配符的 LIKE 查询可能存在逻辑错误,因为逻辑上它与等值查询相同。`, Case: "select c1,c2,c3 from tbl where name like 'foo'", Func: (*Query4Audit).RuleEqualLike, }, "ARG.003": { Item: "ARG.003", Severity: "L4", Summary: "参数比较包含隐式转换,无法使用索引", Content: "隐式类型转换有无法命中索引的风险,在高并发、大数据量的情况下,命不中索引带来的后果非常严重。", Case: "SELECT * FROM sakila.film WHERE length >= '60';", Func: (*Query4Audit).RuleOK, // 该建议在IndexAdvisor中给,RuleImplicitConversion }, "ARG.004": { Item: "ARG.004", Severity: "L4", Summary: "IN (NULL)/NOT IN (NULL) 永远非真", Content: "正确的作法是 col IN ('val1', 'val2', 'val3') OR col IS NULL", Case: "SELECT * FROM tb WHERE col IN (NULL);", Func: (*Query4Audit).RuleIn, }, "ARG.005": { Item: "ARG.005", Severity: "L1", Summary: "IN 要慎用,元素过多会导致全表扫描", Content: ` 如:select id from t where num in(1,2,3)对于连续的数值,能用 BETWEEN 就不要用 IN 了:select id from t where num between 1 and 3。而当 IN 值过多时 MySQL 也可能会进入全表扫描导致性能急剧下降。`, Case: "select id from t where num in(1,2,3)", Func: (*Query4Audit).RuleIn, }, "ARG.006": { Item: "ARG.006", Severity: "L1", Summary: "应尽量避免在 WHERE 子句中对字段进行 NULL 值判断", Content: `使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0;`, Case: "select id from t where num is null", Func: (*Query4Audit).RuleIsNullIsNotNull, }, "ARG.007": { Item: "ARG.007", Severity: "L3", Summary: "避免使用模式匹配", Content: `性能问题是使用模式匹配操作符的最大缺点。使用 LIKE 或正则表达式进行模式匹配进行查询的另一个问题,是可能会返回意料之外的结果。最好的方案就是使用特殊的搜索引擎技术来替代 SQL,比如 Apache Lucene。另一个可选方案是将结果保存起来从而减少重复的搜索开销。如果一定要使用SQL,请考虑在 MySQL 中使用像 FULLTEXT 索引这样的第三方扩展。但更广泛地说,您不一定要使用SQL来解决所有问题。`, Case: "select c_id,c2,c3 from tbl where c2 like 'test%'", Func: (*Query4Audit).RulePatternMatchingUsage, }, "ARG.008": { Item: "ARG.008", Severity: "L1", Summary: "OR 查询索引列时请尽量使用 IN 谓词", Content: `IN-list 谓词可以用于索引检索,并且优化器可以对 IN-list 进行排序,以匹配索引的排序序列,从而获得更有效的检索。请注意,IN-list 必须只包含常量,或在查询块执行期间保持常量的值,例如外引用。`, Case: "SELECT c1,c2,c3 FROM tbl WHERE c1 = 14 OR c1 = 17", Func: (*Query4Audit).RuleORUsage, }, "ARG.009": { Item: "ARG.009", Severity: "L1", Summary: "引号中的字符串开头或结尾包含空格", Content: `如果 VARCHAR 列的前后存在空格将可能引起逻辑问题,如在 MySQL 5.5中 'a' 和 'a ' 可能会在查询中被认为是相同的值。`, Case: "SELECT 'abc '", Func: (*Query4Audit).RuleSpaceWithQuote, }, "ARG.010": { Item: "ARG.010", Severity: "L1", Summary: "不要使用 hint,如:sql_no_cache, force index, ignore key, straight join等", Content: `hint 是用来强制 SQL 按照某个执行计划来执行,但随着数据量变化我们无法保证自己当初的预判是正确的。`, Case: "SELECT * FROM t1 USE INDEX (i1) ORDER BY a;", Func: (*Query4Audit).RuleHint, }, "ARG.011": { Item: "ARG.011", Severity: "L3", Summary: "不要使用负向查询,如:NOT IN/NOT LIKE", Content: `请尽量不要使用负向查询,这将导致全表扫描,对查询性能影响较大。`, Case: "select id from t where num not in(1,2,3);", Func: (*Query4Audit).RuleNot, }, "ARG.012": { Item: "ARG.012", Severity: "L2", Summary: "一次性 INSERT/REPLACE 的数据过多", Content: "单条 INSERT/REPLACE 语句批量插入大量数据性能较差,甚至可能导致从库同步延迟。为了提升性能,减少批量写入数据对从库同步延时的影响,建议采用分批次插入的方法。", Case: "INSERT INTO tb (a) VALUES (1), (2)", Func: (*Query4Audit).RuleInsertValues, }, "ARG.013": { Item: "ARG.013", Severity: "L0", Summary: "DDL 语句中使用了中文全角引号", Content: "DDL 语句中使用了中文全角引号“”或‘’,这可能是书写错误,请确认是否符合预期。", Case: "CREATE TABLE tb (a varchar(10) default '“”'", Func: (*Query4Audit).RuleFullWidthQuote, }, "ARG.014": { Item: "ARG.014", Severity: "L4", Summary: "IN 条件中存在列名,可能导致数据匹配范围扩大", Content: `如:delete from t where id in(1, 2, id) 可能会导致全表数据误删除。请仔细检查 IN 条件的正确性。`, Case: "select id from t where id in(1, 2, id)", Func: (*Query4Audit).RuleIn, }, "CLA.001": { Item: "CLA.001", Severity: "L4", Summary: "最外层 SELECT 未指定 WHERE 条件", Content: `SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。`, Case: "select id from tbl", Func: (*Query4Audit).RuleNoWhere, }, "CLA.002": { Item: "CLA.002", Severity: "L3", Summary: "不建议使用 ORDER BY RAND()", Content: `ORDER BY RAND() 是从结果集中检索随机行的一种非常低效的方法,因为它会对整个结果进行排序并丢弃其大部分数据。`, Case: "select name from tbl where id < 1000 order by rand(number)", Func: (*Query4Audit).RuleOrderByRand, }, "CLA.003": { Item: "CLA.003", Severity: "L2", Summary: "不建议使用带 OFFSET 的LIMIT 查询", Content: `使用 LIMIT 和 OFFSET 对结果集分页的复杂度是 O(n^2),并且会随着数据增大而导致性能问题。采用“书签”扫描的方法实现分页效率更高。`, Case: "select c1,c2 from tbl where name=xx order by number limit 1 offset 20", Func: (*Query4Audit).RuleOffsetLimit, }, "CLA.004": { Item: "CLA.004", Severity: "L2", Summary: "不建议对常量进行 GROUP BY", Content: `GROUP BY 1 表示按第一列进行 GROUP BY。如果在 GROUP BY 子句中使用数字,而不是表达式或列名称,当查询列顺序改变时,可能会导致问题。`, Case: "select col1,col2 from tbl group by 1", Func: (*Query4Audit).RuleGroupByConst, }, "CLA.005": { Item: "CLA.005", Severity: "L2", Summary: "ORDER BY 常数列没有任何意义", Content: `SQL 逻辑上可能存在错误; 最多只是一个无用的操作,不会更改查询结果。`, Case: "select id from test where id=1 order by id", Func: (*Query4Audit).RuleOrderByConst, }, "CLA.006": { Item: "CLA.006", Severity: "L4", Summary: "在不同的表中 GROUP BY 或 ORDER BY", Content: `这将强制使用临时表和 filesort,可能产生巨大性能隐患,并且可能消耗大量内存和磁盘上的临时空间。`, Case: "select tb1.col, tb2.col from tb1, tb2 where id=1 group by tb1.col, tb2.col", Func: (*Query4Audit).RuleDiffGroupByOrderBy, }, "CLA.008": { Item: "CLA.008", Severity: "L2", Summary: "请为 GROUP BY 显示添加 ORDER BY 条件", Content: `默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。`, Case: "select c1,c2,c3 from t1 where c1='foo' group by c2", Func: (*Query4Audit).RuleExplicitOrderBy, }, "CLA.009": { Item: "CLA.009", Severity: "L2", Summary: "ORDER BY 的条件为表达式", Content: `当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。`, Case: "select description from film where title ='ACADEMY DINOSAUR' order by length-language_id;", Func: (*Query4Audit).RuleOrderByExpr, }, "CLA.010": { Item: "CLA.010", Severity: "L2", Summary: "GROUP BY 的条件为表达式", Content: `当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。`, Case: "select description from film where title ='ACADEMY DINOSAUR' GROUP BY length-language_id;", Func: (*Query4Audit).RuleGroupByExpr, }, "CLA.011": { Item: "CLA.011", Severity: "L1", Summary: "建议为表添加注释", Content: `为表添加注释能够使得表的意义更明确,从而为日后的维护带来极大的便利。`, Case: "CREATE TABLE `test1` (`ID` bigint(20) NOT NULL AUTO_INCREMENT,`c1` varchar(128) DEFAULT NULL,PRIMARY KEY (`ID`)) ENGINE=InnoDB DEFAULT CHARSET=utf8", Func: (*Query4Audit).RuleTblCommentCheck, }, "CLA.012": { Item: "CLA.012", Severity: "L2", Summary: "将复杂的裹脚布式查询分解成几个简单的查询", Content: `SQL是一门极具表现力的语言,您可以在单个SQL查询或者单条语句中完成很多事情。但这并不意味着必须强制只使用一行代码,或者认为使用一行代码就搞定每个任务是个好主意。通过一个查询来获得所有结果的常见后果是得到了一个笛卡儿积。当查询中的两张表之间没有条件限制它们的关系时,就会发生这种情况。没有对应的限制而直接使用两张表进行联结查询,就会得到第一张表中的每一行和第二张表中的每一行的一个组合。每一个这样的组合就会成为结果集中的一行,最终您就会得到一个行数很多的结果集。重要的是要考虑这些查询很难编写、难以修改和难以调试。数据库查询请求的日益增加应该是预料之中的事。经理们想要更复杂的报告以及在用户界面上添加更多的字段。如果您的设计很复杂,并且是一个单一查询,要扩展它们就会很费时费力。不论对您还是项目来说,时间花在这些事情上面不值得。将复杂的意大利面条式查询分解成几个简单的查询。当您拆分一个复杂的SQL查询时,得到的结果可能是很多类似的查询,可能仅仅在数据类型上有所不同。编写所有的这些查询是很乏味的,因此,最好能够有个程序自动生成这些代码。SQL代码生成是一个很好的应用。尽管SQL支持用一行代码解决复杂的问题,但也别做不切实际的事情。`, Case: "这是一条很长很长的 SQL,案例略。", Func: (*Query4Audit).RuleSpaghettiQueryAlert, }, /* https://www.datacamp.com/community/tutorials/sql-tutorial-query The HAVING Clause The HAVING clause was originally added to SQL because the WHERE keyword could not be used with aggregate functions. HAVING is typically used with the GROUP BY clause to restrict the groups of returned rows to only those that meet certain conditions. However, if you use this clause in your query, the index is not used, which -as you already know- can result in a query that doesn't really perform all that well. If you’re looking for an alternative, consider using the WHERE clause. Consider the following queries: SELECT state, COUNT(*) FROM Drivers WHERE state IN ('GA', 'TX') GROUP BY state ORDER BY state SELECT state, COUNT(*) FROM Drivers GROUP BY state HAVING state IN ('GA', 'TX') ORDER BY state The first query uses the WHERE clause to restrict the number of rows that need to be summed, whereas the second query sums up all the rows in the table and then uses HAVING to throw away the sums it calculated. In these types of cases, the alternative with the WHERE clause is obviously the better one, as you don’t waste any resources. You see that this is not about limiting the result set, rather about limiting the intermediate number of records within a query. Note that the difference between these two clauses lies in the fact that the WHERE clause introduces a condition on individual rows, while the HAVING clause introduces a condition on aggregations or results of a selection where a single result, such as MIN, MAX, SUM,… has been produced from multiple rows. */ "CLA.013": { Item: "CLA.013", Severity: "L3", Summary: "不建议使用 HAVING 子句", Content: `将查询的 HAVING 子句改写为 WHERE 中的查询条件,可以在查询处理期间使用索引。`, Case: "SELECT s.c_id,count(s.c_id) FROM s where c = test GROUP BY s.c_id HAVING s.c_id <> '1660' AND s.c_id <> '2' order by s.c_id", Func: (*Query4Audit).RuleHavingClause, }, "CLA.014": { Item: "CLA.014", Severity: "L2", Summary: "删除全表时建议使用 TRUNCATE 替代 DELETE", Content: `删除全表时建议使用 TRUNCATE 替代 DELETE`, Case: "delete from tbl", Func: (*Query4Audit).RuleNoWhere, }, "CLA.015": { Item: "CLA.015", Severity: "L4", Summary: "UPDATE 未指定 WHERE 条件", Content: `UPDATE 不指定 WHERE 条件一般是致命的,请您三思后行`, Case: "update tbl set col=1", Func: (*Query4Audit).RuleNoWhere, }, "CLA.016": { Item: "CLA.016", Severity: "L2", Summary: "不要 UPDATE 主键", Content: `主键是数据表中记录的唯一标识符,不建议频繁更新主键列,这将影响元数据统计信息进而影响正常的查询。`, Case: "update tbl set col=1", Func: (*Query4Audit).RuleOK, // 该建议在indexAdvisor中给 RuleUpdatePrimaryKey }, "COL.001": { Item: "COL.001", Severity: "L1", Summary: "不建议使用 SELECT * 类型查询", Content: `当表结构变更时,使用 * 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。`, Case: "select * from tbl where id=1", Func: (*Query4Audit).RuleSelectStar, }, "COL.002": { Item: "COL.002", Severity: "L2", Summary: "INSERT/REPLACE 未指定列名", Content: `当表结构发生变更,如果 INSERT 或 REPLACE 请求不明确指定列名,请求的结果将会与预想的不同; 建议使用 “INSERT INTO tbl(col1,col2)VALUES ...” 代替。`, Case: "insert into tbl values(1,'name')", Func: (*Query4Audit).RuleInsertColDef, }, "COL.003": { Item: "COL.003", Severity: "L2", Summary: "建议修改自增 ID 为无符号类型", Content: `建议修改自增 ID 为无符号类型`, Case: "create table test(`id` int(11) NOT NULL AUTO_INCREMENT)", Func: (*Query4Audit).RuleAutoIncUnsigned, }, "COL.004": { Item: "COL.004", Severity: "L1", Summary: "请为列添加默认值", Content: `请为列添加默认值,如果是 ALTER 操作,请不要忘记将原字段的默认值写上。字段无默认值,当表较大时无法在线变更表结构。`, Case: "CREATE TABLE tbl (col int) ENGINE=InnoDB;", Func: (*Query4Audit).RuleAddDefaultValue, }, "COL.005": { Item: "COL.005", Severity: "L1", Summary: "列未添加注释", Content: `建议对表中每个列添加注释,来明确每个列在表中的含义及作用。`, Case: "CREATE TABLE tbl (col int) ENGINE=InnoDB;", Func: (*Query4Audit).RuleColCommentCheck, }, "COL.006": { Item: "COL.006", Severity: "L3", Summary: "表中包含有太多的列", Content: `表中包含有太多的列`, Case: "CREATE TABLE tbl ( cols ....);", Func: (*Query4Audit).RuleTooManyFields, }, "COL.007": { Item: "COL.007", Severity: "L3", Summary: "表中包含有太多的 text/blob 列", Content: fmt.Sprintf(`表中包含超过%d个的 text/blob 列`, common.Config.MaxTextColsCount), Case: "CREATE TABLE tbl ( cols ....);", Func: (*Query4Audit).RuleTooManyFields, }, "COL.008": { Item: "COL.008", Severity: "L1", Summary: "可使用 VARCHAR 代替 CHAR, VARBINARY 代替 BINARY", Content: `为首先变长字段存储空间小,可以节省存储空间。其次对于查询来说,在一个相对较小的字段内搜索效率显然要高些。`, Case: "create table t1(id int,name char(20),last_time date)", Func: (*Query4Audit).RuleVarcharVSChar, }, "COL.009": { Item: "COL.009", Severity: "L2", Summary: "建议使用精确的数据类型", Content: `实际上,任何使用 FLOAT, REAL 或 DOUBLE PRECISION 数据类型的设计都有可能是反模式。大多数应用程序使用的浮点数的取值范围并不需要达到IEEE 754标准所定义的最大/最小区间。在计算总量时,非精确浮点数所积累的影响是严重的。使用 SQL 中的 NUMERIC 或 DECIMAL 类型来代替 FLOAT 及其类似的数据类型进行固定精度的小数存储。这些数据类型精确地根据您定义这一列时指定的精度来存储数据。尽可能不要使用浮点数。`, Case: "CREATE TABLE tab2 (p_id BIGINT UNSIGNED NOT NULL,a_id BIGINT UNSIGNED NOT NULL,hours float not null,PRIMARY KEY (p_id, a_id))", Func: (*Query4Audit).RuleImpreciseDataType, }, "COL.010": { Item: "COL.010", Severity: "L2", Summary: "不建议使用 ENUM/BIT/SET 数据类型", Content: `ENUM 定义了列中值的类型,使用字符串表示 ENUM 里的值时,实际存储在列中的数据是这些值在定义时的序数。因此,这列的数据是字节对齐的,当您进行一次排序查询时,结果是按照实际存储的序数值排序的,而不是按字符串值的字母顺序排序的。这可能不是您所希望的。没有什么语法支持从 ENUM 或者 check 约束中添加或删除一个值;您只能使用一个新的集合重新定义这一列。如果您打算废弃一个选项,您可能会为历史数据而烦恼。作为一种策略,改变元数据——也就是说,改变表和列的定义——应该是不常见的,并且要注意测试和质量保证。有一个更好的解决方案来约束一列中的可选值:创建一张检查表,每一行包含一个允许在列中出现的候选值;然后在引用新表的旧表上声明一个外键约束。`, Case: "create table tab1(status ENUM('new','in progress','fixed'))", Func: (*Query4Audit).RuleValuesInDefinition, }, // 这个建议从sqlcheck迁移来的,实际生产环境每条建表SQL都会给这条建议,看多了会不开心。 "COL.011": { Item: "COL.011", Severity: "L0", Summary: "当需要唯一约束时才使用 NULL,仅当列不能有缺失值时才使用 NOT NULL", Content: `NULL 和0是不同的,10乘以 NULL 还是 NULL。NULL 和空字符串是不一样的。将一个字符串和标准 SQL 中的 NULL 联合起来的结果还是 NULL。NULL 和 FALSE 也是不同的。AND、OR 和 NOT 这三个布尔操作如果涉及 NULL,其结果也让很多人感到困惑。当您将一列声明为 NOT NULL 时,也就是说这列中的每一个值都必须存在且是有意义的。使用 NULL 来表示任意类型不存在的空值。 当您将一列声明为 NOT NULL 时,也就是说这列中的每一个值都必须存在且是有意义的。`, Case: "select c1,c2,c3 from tbl where c4 is null or c4 <> 1", Func: (*Query4Audit).RuleNullUsage, }, "COL.012": { Item: "COL.012", Severity: "L5", Summary: "TEXT、BLOB 和 JSON 类型的字段不建议设置为 NOT NULL", Content: `TEXT、BLOB 和 JSON 类型的字段无法指定非 NULL 的默认值,如果添加了 NOT NULL 限制,写入数据时又未对该字段指定值可能导致写入失败。`, Case: "CREATE TABLE `tb`(`c` longblob NOT NULL);", Func: (*Query4Audit).RuleBLOBNotNull, }, "COL.013": { Item: "COL.013", Severity: "L4", Summary: "TIMESTAMP 类型默认值检查异常", Content: `TIMESTAMP 类型建议设置默认值,且不建议使用 0 或 0000-00-00 00:00:00 作为默认值。可以考虑使用 1970-08-02 01:01:01`, Case: "CREATE TABLE tbl( `id` bigint not null, `create_time` timestamp);", Func: (*Query4Audit).RuleTimestampDefault, }, "COL.014": { Item: "COL.014", Severity: "L5", Summary: "为列指定了字符集", Content: `建议列与表使用同一个字符集,不要单独指定列的字符集。`, Case: "CREATE TABLE `tb2` ( `id` int(11) DEFAULT NULL, `col` char(10) CHARACTER SET utf8 DEFAULT NULL)", Func: (*Query4Audit).RuleColumnWithCharset, }, // https://stackoverflow.com/questions/3466872/why-cant-a-text-column-have-a-default-value-in-mysql "COL.015": { Item: "COL.015", Severity: "L4", Summary: "TEXT、BLOB 和 JSON 类型的字段不可指定非 NULL 的默认值", Content: `MySQL 数据库中 TEXT、BLOB 和 JSON 类型的字段不可指定非 NULL 的默认值。TEXT最大长度为2^16-1个字符,MEDIUMTEXT最大长度为2^32-1个字符,LONGTEXT最大长度为2^64-1个字符。`, Case: "CREATE TABLE `tbl` (`c` blob DEFAULT NULL);", Func: (*Query4Audit).RuleBlobDefaultValue, }, "COL.016": { Item: "COL.016", Severity: "L1", Summary: "整型定义建议采用 INT(10) 或 BIGINT(20)", Content: `INT(M) 在 integer 数据类型中,M 表示最大显示宽度。 在 INT(M) 中,M 的值跟 INT(M) 所占多少存储空间并无任何关系。 INT(3)、INT(4)、INT(8) 在磁盘上都是占用 4 bytes 的存储空间。高版本 MySQL 已经不推荐设置整数显示宽度。`, Case: "CREATE TABLE tab (a INT(1));", Func: (*Query4Audit).RuleIntPrecision, }, "COL.017": { Item: "COL.017", Severity: "L2", Summary: "VARCHAR 定义长度过长", Content: fmt.Sprintf(`varchar 是可变长字符串,不预先分配存储空间,长度不要超过%d,如果存储长度过长 MySQL 将定义字段类型为 text,独立出来一张表,用主键来对应,避免影响其它字段索引效率。`, common.Config.MaxVarcharLength), Case: "CREATE TABLE tab (a varchar(3500));", Func: (*Query4Audit).RuleVarcharLength, }, "COL.018": { Item: "COL.018", Severity: "L9", Summary: "建表语句中使用了不推荐的字段类型", Content: "以下字段类型不被推荐使用:" + strings.Join(common.Config.ColumnNotAllowType, ", "), Case: "CREATE TABLE tab (a BOOLEAN);", Func: (*Query4Audit).RuleColumnNotAllowType, }, "COL.019": { Item: "COL.019", Severity: "L1", Summary: "不建议使用精度在秒级以下的时间数据类型", Content: "使用高精度的时间数据类型带来的存储空间消耗相对较大;MySQL 在5.6.4以上才可以支持精确到微秒的时间数据类型,使用时需要考虑版本兼容问题。", Case: "CREATE TABLE t1 (t TIME(3), dt DATETIME(6));", Func: (*Query4Audit).RuleTimePrecision, }, "DIS.001": { Item: "DIS.001", Severity: "L1", Summary: "消除不必要的 DISTINCT 条件", Content: `太多DISTINCT条件是复杂的裹脚布式查询的症状。考虑将复杂查询分解成许多简单的查询,并减少DISTINCT条件的数量。如果主键列是列的结果集的一部分,则DISTINCT条件可能没有影响。`, Case: "SELECT DISTINCT c.c_id,count(DISTINCT c.c_name),count(DISTINCT c.c_e),count(DISTINCT c.c_n),count(DISTINCT c.c_me),c.c_d FROM (select distinct id, name from B) as e WHERE e.country_id = c.country_id", Func: (*Query4Audit).RuleDistinctUsage, }, "DIS.002": { Item: "DIS.002", Severity: "L3", Summary: "COUNT(DISTINCT) 多列时结果可能和你预想的不同", Content: `COUNT(DISTINCT col) 计算该列除NULL之外的不重复行数,注意 COUNT(DISTINCT col, col2) 如果其中一列全为 NULL 那么即使另一列有不同的值,也返回0。`, Case: "SELECT COUNT(DISTINCT col, col2) FROM tbl;", Func: (*Query4Audit).RuleCountDistinctMultiCol, }, // DIS.003 灵感来源于如下链接 // http://www.ijstr.org/final-print/oct2015/Query-Optimization-Techniques-Tips-For-Writing-Efficient-And-Faster-Sql-Queries.pdf "DIS.003": { Item: "DIS.003", Severity: "L3", Summary: "DISTINCT * 对有主键的表没有意义", Content: `当表已经有主键时,对所有列进行 DISTINCT 的输出结果与不进行 DISTINCT 操作的结果相同,请不要画蛇添足。`, Case: "SELECT DISTINCT * FROM film;", Func: (*Query4Audit).RuleDistinctStar, }, "FUN.001": { Item: "FUN.001", Severity: "L2", Summary: "避免在 WHERE 条件中使用函数或其他运算符", Content: `虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。`, Case: "select id from t where substring(name,1,3)='abc'", Func: (*Query4Audit).RuleCompareWithFunction, }, "FUN.002": { Item: "FUN.002", Severity: "L1", Summary: "指定了 WHERE 条件或非 MyISAM 引擎时使用 COUNT(*) 操作性能不佳", Content: `COUNT(*) 的作用是统计表行数,COUNT(COL) 的作用是统计指定列非 NULL 的行数。MyISAM 表对于 COUNT(*) 统计全表行数进行了特殊的优化,通常情况下非常快。但对于非 MyISAM 表或指定了某些 WHERE 条件,COUNT(*) 操作需要扫描大量的行才能获取精确的结果,性能也因此不佳。有时候某些业务场景并不需要完全精确的 COUNT 值,此时可以用近似值来代替。EXPLAIN 出来的优化器估算的行数就是一个不错的近似值,执行 EXPLAIN 并不需要真正去执行查询,所以成本很低。`, Case: "SELECT c3, COUNT(*) AS accounts FROM tab where c2 < 10000 GROUP BY c3 ORDER BY num", Func: (*Query4Audit).RuleCountStar, }, "FUN.003": { Item: "FUN.003", Severity: "L3", Summary: "使用了合并为可空列的字符串连接", Content: `在一些查询请求中,您需要强制让某一列或者某个表达式返回非 NULL 的值,从而让查询逻辑变得更简单,但又不想将这个值存下来。可以使用 COALESCE() 函数来构造连接的表达式,这样即使是空值列也不会使整表达式变为 NULL。`, Case: "select c1 || coalesce(' ' || c2 || ' ', ' ') || c3 as c from tbl", Func: (*Query4Audit).RuleStringConcatenation, }, "FUN.004": { Item: "FUN.004", Severity: "L4", Summary: "不建议使用 SYSDATE() 函数", Content: `SYSDATE() 函数可能导致主从数据不一致,请使用 NOW() 函数替代 SYSDATE()。`, Case: "SELECT SYSDATE();", Func: (*Query4Audit).RuleSysdate, }, "FUN.005": { Item: "FUN.005", Severity: "L1", Summary: "不建议使用 COUNT(col) 或 COUNT(常量)", Content: `不要使用 COUNT(col) 或 COUNT(常量) 来替代 COUNT(*), COUNT(*) 是 SQL92 定义的标准统计行数的方法,跟数据无关,跟 NULL 和非 NULL 也无关。`, Case: "SELECT COUNT(1) FROM tbl;", Func: (*Query4Audit).RuleCountConst, }, "FUN.006": { Item: "FUN.006", Severity: "L1", Summary: "使用 SUM(COL) 时需注意 NPE 问题", Content: `当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl`, Case: "SELECT SUM(COL) FROM tbl;", Func: (*Query4Audit).RuleSumNPE, }, "FUN.007": { Item: "FUN.007", Severity: "L1", Summary: "不建议使用触发器", Content: `触发器的执行没有反馈和日志,隐藏了实际的执行步骤,当数据库出现问题是,不能通过慢日志分析触发器的具体执行情况,不易发现问题。在MySQL中,触发器不能临时关闭或打开,在数据迁移或数据恢复等场景下,需要临时drop触发器,可能影响到生产环境。`, Case: "CREATE TRIGGER t1 AFTER INSERT ON work FOR EACH ROW INSERT INTO time VALUES(NOW());", Func: (*Query4Audit).RuleForbiddenTrigger, }, "FUN.008": { Item: "FUN.008", Severity: "L1", Summary: "不建议使用存储过程", Content: `存储过程无版本控制,配合业务的存储过程升级很难做到业务无感知。存储过程在拓展和移植上也存在问题。`, Case: "CREATE PROCEDURE simpleproc (OUT param1 INT);", Func: (*Query4Audit).RuleForbiddenProcedure, }, "FUN.009": { Item: "FUN.009", Severity: "L1", Summary: "不建议使用自定义函数", Content: `不建议使用自定义函数`, Case: "CREATE FUNCTION hello (s CHAR(20));", Func: (*Query4Audit).RuleForbiddenFunction, }, "GRP.001": { Item: "GRP.001", Severity: "L2", Summary: "不建议对等值查询列使用 GROUP BY", Content: `GROUP BY 中的列在前面的 WHERE 条件中使用了等值查询,对这样的列进行 GROUP BY 意义不大。`, Case: "select film_id, title from film where release_year='2006' group by release_year", Func: (*Query4Audit).RuleOK, // 该建议在indexAdvisor中给 RuleGroupByConst }, "JOI.001": { Item: "JOI.001", Severity: "L2", Summary: "JOIN 语句混用逗号和 ANSI 模式", Content: `表连接的时候混用逗号和 ANSI JOIN 不便于人类理解,并且MySQL不同版本的表连接行为和优先级均有所不同,当 MySQL 版本变化后可能会引入错误。`, Case: "select c1,c2,c3 from t1,t2 join t3 on t1.c1=t2.c1,t1.c3=t3,c1 where id>1000", Func: (*Query4Audit).RuleCommaAnsiJoin, }, "JOI.002": { Item: "JOI.002", Severity: "L4", Summary: "同一张表被连接两次", Content: `相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。`, Case: "select tb1.col from (tb1, tb2) join tb2 on tb1.id=tb.id where tb1.id=1", Func: (*Query4Audit).RuleDupJoin, }, "JOI.003": { Item: "JOI.003", Severity: "L4", Summary: "OUTER JOIN 失效", Content: `由于 WHERE 条件错误使得 OUTER JOIN 的外部表无数据返回,这会将查询隐式转换为 INNER JOIN 。如:select c from L left join R using(c) where L.a=5 and R.b=10。这种 SQL 逻辑上可能存在错误或程序员对 OUTER JOIN 如何工作存在误解,因为 LEFT/RIGHT JOIN 是 LEFT/RIGHT OUTER JOIN 的缩写。`, Case: "select c1,c2,c3 from t1 left outer join t2 using(c1) where t1.c2=2 and t2.c3=4", Func: (*Query4Audit).RuleOK, // TODO }, "JOI.004": { Item: "JOI.004", Severity: "L4", Summary: "不建议使用排它 JOIN", Content: `只在右侧表为 NULL 的带 WHERE 子句的 LEFT OUTER JOIN 语句,有可能是在WHERE子句中使用错误的列,如:“... FROM l LEFT OUTER JOIN r ON l.l = r.r WHERE r.z IS NULL”,这个查询正确的逻辑可能是 WHERE r.r IS NULL。`, Case: "select c1,c2,c3 from t1 left outer join t2 on t1.c1=t2.c1 where t2.c2 is null", Func: (*Query4Audit).RuleOK, // TODO }, "JOI.005": { Item: "JOI.005", Severity: "L2", Summary: "减少 JOIN 的数量", Content: `太多的 JOIN 是复杂的裹脚布式查询的症状。考虑将复杂查询分解成许多简单的查询,并减少 JOIN 的数量。`, Case: "select bp1.p_id, b1.d_d as l, b1.b_id from b1 join bp1 on (b1.b_id = bp1.b_id) left outer join (b1 as b2 join bp2 on (b2.b_id = bp2.b_id)) on (bp1.p_id = bp2.p_id ) join bp21 on (b1.b_id = bp1.b_id) join bp31 on (b1.b_id = bp1.b_id) join bp41 on (b1.b_id = bp1.b_id) where b2.b_id = 0", Func: (*Query4Audit).RuleReduceNumberOfJoin, }, "JOI.006": { Item: "JOI.006", Severity: "L4", Summary: "将嵌套查询重写为 JOIN 通常会导致更高效的执行和更有效的优化", Content: `一般来说,非嵌套子查询总是用于关联子查询,最多是来自FROM子句中的一个表,这些子查询用于 ANY, ALL 和 EXISTS 的谓词。如果可以根据查询语义决定子查询最多返回一个行,那么一个不相关的子查询或来自FROM子句中的多个表的子查询就被压平了。`, Case: "SELECT s,p,d FROM tbl WHERE p.p_id = (SELECT s.p_id FROM tbl WHERE s.c_id = 100996 AND s.q = 1 )", Func: (*Query4Audit).RuleNestedSubQueries, }, "JOI.007": { Item: "JOI.007", Severity: "L4", Summary: "不建议使用联表删除或更新", Content: `当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。`, Case: "UPDATE users u LEFT JOIN hobby h ON u.id = h.uid SET u.name = 'pianoboy' WHERE h.hobby = 'piano';", Func: (*Query4Audit).RuleMultiDeleteUpdate, }, "JOI.008": { Item: "JOI.008", Severity: "L4", Summary: "不要使用跨数据库的 JOIN 查询", Content: `一般来说,跨数据库的 JOIN 查询意味着查询语句跨越了两个不同的子系统,这可能意味着系统耦合度过高或库表结构设计不合理。`, Case: "SELECT s,p,d FROM tbl WHERE p.p_id = (SELECT s.p_id FROM tbl WHERE s.c_id = 100996 AND s.q = 1 )", Func: (*Query4Audit).RuleMultiDBJoin, }, // TODO: 跨库事务的检查,目前SOAR未对事务做处理 "KEY.001": { Item: "KEY.001", Severity: "L2", Summary: "建议使用自增列作为主键,如使用联合自增主键时请将自增键作为第一列", Content: `建议使用自增列作为主键,如使用联合自增主键时请将自增键作为第一列`, Case: "create table test(`id` int(11) NOT NULL PRIMARY KEY (`id`))", Func: (*Query4Audit).RulePKNotInt, }, "KEY.002": { Item: "KEY.002", Severity: "L4", Summary: "无主键或唯一键,无法在线变更表结构", Content: `无主键或唯一键,无法在线变更表结构`, Case: "create table test(col varchar(5000))", Func: (*Query4Audit).RuleNoOSCKey, }, "KEY.003": { Item: "KEY.003", Severity: "L4", Summary: "避免外键等递归关系", Content: `存在递归关系的数据很常见,数据常会像树或者以层级方式组织。然而,创建一个外键约束来强制执行同一表中两列之间的关系,会导致笨拙的查询。树的每一层对应着另一个连接。您将需要发出递归查询,以获得节点的所有后代或所有祖先。解决方案是构造一个附加的闭包表。它记录了树中所有节点间的关系,而不仅仅是那些具有直接的父子关系。您也可以比较不同层次的数据设计:闭包表,路径枚举,嵌套集。然后根据应用程序的需要选择一个。`, Case: "CREATE TABLE tab2 (p_id BIGINT UNSIGNED NOT NULL,a_id BIGINT UNSIGNED NOT NULL,PRIMARY KEY (p_id, a_id),FOREIGN KEY (p_id) REFERENCES tab1(p_id),FOREIGN KEY (a_id) REFERENCES tab3(a_id))", Func: (*Query4Audit).RuleRecursiveDependency, }, // TODO: 新增复合索引,字段按散粒度是否由大到小排序,区分度最高的在最左边 "KEY.004": { Item: "KEY.004", Severity: "L0", Summary: "提醒:请将索引属性顺序与查询对齐", Content: `如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。`, Case: "create index idx1 on tbl (last_name,first_name)", Func: (*Query4Audit).RuleIndexAttributeOrder, }, "KEY.005": { Item: "KEY.005", Severity: "L2", Summary: "表建的索引过多", Content: `表建的索引过多`, Case: "CREATE TABLE tbl ( a int, b int, c int, KEY idx_a (`a`),KEY idx_b(`b`),KEY idx_c(`c`));", Func: (*Query4Audit).RuleTooManyKeys, }, "KEY.006": { Item: "KEY.006", Severity: "L4", Summary: "主键中的列过多", Content: `主键中的列过多`, Case: "CREATE TABLE tbl ( a int, b int, c int, PRIMARY KEY(`a`,`b`,`c`));", Func: (*Query4Audit).RuleTooManyKeyParts, }, "KEY.007": { Item: "KEY.007", Severity: "L4", Summary: "未指定主键或主键非 int 或 bigint", Content: `未指定主键或主键非 int 或 bigint,建议将主键设置为 int unsigned 或 bigint unsigned。`, Case: "CREATE TABLE tbl (a int);", Func: (*Query4Audit).RulePKNotInt, }, "KEY.008": { Item: "KEY.008", Severity: "L4", Summary: "ORDER BY 多个列但排序方向不同时可能无法使用索引", Content: `在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。`, Case: "SELECT * FROM tbl ORDER BY a DESC, b ASC;", Func: (*Query4Audit).RuleOrderByMultiDirection, }, "KEY.009": { Item: "KEY.009", Severity: "L0", Summary: "添加唯一索引前请注意检查数据唯一性", Content: `请提前检查添加唯一索引列的数据唯一性,如果数据不唯一在线表结构调整时将有可能自动将重复列删除,这有可能导致数据丢失。`, Case: "CREATE UNIQUE INDEX part_of_name ON customer (name(10));", Func: (*Query4Audit).RuleUniqueKeyDup, }, "KEY.010": { Item: "KEY.010", Severity: "L0", Summary: "全文索引不是银弹", Content: `全文索引主要用于解决模糊查询的性能问题,但需要控制好查询的频率和并发度。同时注意调整 ft_min_word_len, ft_max_word_len, ngram_token_size 等参数。`, Case: "CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `ip` varchar(255) NOT NULL DEFAULT '', PRIMARY KEY (`id`), FULLTEXT KEY `ip` (`ip`) ) ENGINE=InnoDB;", Func: (*Query4Audit).RuleFulltextIndex, }, "KWR.001": { Item: "KWR.001", Severity: "L2", Summary: "SQL_CALC_FOUND_ROWS 效率低下", Content: `因为 SQL_CALC_FOUND_ROWS 不能很好地扩展,所以可能导致性能问题; 建议业务使用其他策略来替代 SQL_CALC_FOUND_ROWS 提供的计数功能,比如:分页结果展示等。`, Case: "select SQL_CALC_FOUND_ROWS col from tbl where id>1000", Func: (*Query4Audit).RuleSQLCalcFoundRows, }, "KWR.002": { Item: "KWR.002", Severity: "L2", Summary: "不建议使用 MySQL 关键字做列名或表名", Content: `当使用关键字做为列名或表名时程序需要对列名和表名进行转义,如果疏忽被将导致请求无法执行。`, Case: "CREATE TABLE tbl ( `select` int )", Func: (*Query4Audit).RuleUseKeyWord, }, "KWR.003": { Item: "KWR.003", Severity: "L1", Summary: "不建议使用复数做列名或表名", Content: `表名应该仅仅表示表里面的实体内容,不应该表示实体数量,对应于 DO 类名也是单数形式,符合表达习惯。`, Case: "CREATE TABLE tbl ( `books` int )", Func: (*Query4Audit).RulePluralWord, }, "KWR.004": { Item: "KWR.004", Severity: "L1", Summary: "不建议使用使用多字节编码字符(中文)命名", Content: `为库、表、列、别名命名时建议使用英文,数字,下划线等字符,不建议使用中文或其他多字节编码字符。`, Case: "select col as 列 from tb", Func: (*Query4Audit).RuleMultiBytesWord, }, "KWR.005": { Item: "KWR.005", Severity: "L1", Summary: "SQL 中包含 unicode 特殊字符", Content: "部分 IDE 会自动在 SQL 插入肉眼不可见的 unicode 字符。如:non-break space, zero-width space 等。Linux 下可使用 `cat -A file.sql` 命令查看不可见字符。", Case: "update tb set status = 1 where id = 1;", Func: (*Query4Audit).RuleInvisibleUnicode, }, "LCK.001": { Item: "LCK.001", Severity: "L3", Summary: "INSERT INTO xx SELECT 加锁粒度较大请谨慎", Content: `INSERT INTO xx SELECT 加锁粒度较大请谨慎`, Case: "INSERT INTO tbl SELECT * FROM tbl2;", Func: (*Query4Audit).RuleInsertSelect, }, "LCK.002": { Item: "LCK.002", Severity: "L3", Summary: "请慎用 INSERT ON DUPLICATE KEY UPDATE", Content: `当主键为自增键时使用 INSERT ON DUPLICATE KEY UPDATE 可能会导致主键出现大量不连续快速增长,导致主键快速溢出无法继续写入。极端情况下还有可能导致主从数据不一致。`, Case: "INSERT INTO t1(a,b,c) VALUES (1,2,3) ON DUPLICATE KEY UPDATE c=c+1;", Func: (*Query4Audit).RuleInsertOnDup, }, "LIT.001": { Item: "LIT.001", Severity: "L2", Summary: "用字符类型存储IP地址", Content: `字符串字面上看起来像IP地址,但不是 INET_ATON() 的参数,表示数据被存储为字符而不是整数。将IP地址存储为整数更为有效。`, Case: "insert into tbl (IP,name) values('10.20.306.122','test')", Func: (*Query4Audit).RuleIPString, }, "LIT.002": { Item: "LIT.002", Severity: "L4", Summary: "日期/时间未使用引号括起", Content: `诸如“WHERE col <2010-02-12”之类的查询是有效的SQL,但可能是一个错误,因为它将被解释为“WHERE col <1996”; 日期/时间文字应该加引号,且引号前后不应有空格。`, Case: "select col1,col2 from tbl where time < 2018-01-10", Func: (*Query4Audit).RuleDateNotQuote, }, "LIT.003": { Item: "LIT.003", Severity: "L3", Summary: "一列中存储一系列相关数据的集合", Content: `将 ID 存储为一个列表,作为 VARCHAR/TEXT 列,这样能导致性能和数据完整性问题。查询这样的列需要使用模式匹配的表达式。使用逗号分隔的列表来做多表联结查询定位一行数据是极不优雅和耗时的。这将使验证 ID 更加困难。考虑一下,列表最多支持存放多少数据呢?将 ID 存储在一张单独的表中,代替使用多值属性,从而每个单独的属性值都可以占据一行。这样交叉表实现了两张表之间的多对多关系。这将更好地简化查询,也更有效地验证ID。`, Case: "select c1,c2,c3,c4 from tab1 where col_id REGEXP '[[:<:]]12[[:>:]]'", Func: (*Query4Audit).RuleMultiValueAttribute, }, "LIT.004": { Item: "LIT.004", Severity: "L1", Summary: "请使用分号或已设定的 DELIMITER 结尾", Content: `USE database, SHOW DATABASES 等命令也需要使用使用分号或已设定的 DELIMITER 结尾。`, Case: "USE db", Func: (*Query4Audit).RuleOK, // TODO: RuleAddDelimiter }, "RES.001": { Item: "RES.001", Severity: "L4", Summary: "非确定性的 GROUP BY", Content: `SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。`, Case: "select c1,c2,c3 from t1 where c2='foo' group by c2", Func: (*Query4Audit).RuleNoDeterministicGroupby, }, "RES.002": { Item: "RES.002", Severity: "L4", Summary: "未使用 ORDER BY 的 LIMIT 查询", Content: `没有 ORDER BY 的 LIMIT 会导致非确定性的结果,这取决于查询执行计划。`, Case: "select col1,col2 from tbl where name=xx limit 10", Func: (*Query4Audit).RuleNoDeterministicLimit, }, "RES.003": { Item: "RES.003", Severity: "L4", Summary: "UPDATE/DELETE 操作使用了 LIMIT 条件", Content: `UPDATE/DELETE 操作使用 LIMIT 条件和不添加 WHERE 条件一样危险,它可将会导致主从数据不一致或从库同步中断。`, Case: "UPDATE film SET length = 120 WHERE title = 'abc' LIMIT 1;", Func: (*Query4Audit).RuleUpdateDeleteWithLimit, }, "RES.004": { Item: "RES.004", Severity: "L4", Summary: "UPDATE/DELETE 操作指定了 ORDER BY 条件", Content: `UPDATE/DELETE 操作不要指定 ORDER BY 条件。`, Case: "UPDATE film SET length = 120 WHERE title = 'abc' ORDER BY title", Func: (*Query4Audit).RuleUpdateDeleteWithOrderby, }, "RES.005": { Item: "RES.005", Severity: "L4", Summary: "UPDATE 语句可能存在逻辑错误,导致数据损坏", Content: "在一条 UPDATE 语句中,如果要更新多个字段,字段间不能使用 AND ,而应该用逗号分隔。", Case: "update tbl set col = 1 and cl = 2 where col=3;", Func: (*Query4Audit).RuleUpdateSetAnd, }, "RES.006": { Item: "RES.006", Severity: "L4", Summary: "永远不真的比较条件", Content: "查询条件永远非真,如果该条件出现在 where 中可能导致查询无匹配到的结果。", Case: "select * from tbl where 1 != 1;", Func: (*Query4Audit).RuleImpossibleWhere, }, "RES.007": { Item: "RES.007", Severity: "L4", Summary: "永远为真的比较条件", Content: "查询条件永远为真,可能导致 WHERE 条件失效进行全表查询。", Case: "select * from tbl where 1 = 1;", Func: (*Query4Audit).RuleMeaninglessWhere, }, "RES.008": { Item: "RES.008", Severity: "L2", Summary: "不建议使用LOAD DATA/SELECT ... INTO OUTFILE", Content: "SELECT INTO OUTFILE 需要授予 FILE 权限,这通过会引入安全问题。LOAD DATA 虽然可以提高数据导入速度,但同时也可能导致从库同步延迟过大。", Case: "LOAD DATA INFILE 'data.txt' INTO TABLE db2.my_table;", Func: (*Query4Audit).RuleLoadFile, }, "RES.009": { Item: "RES.009", Severity: "L2", Summary: "不建议使用连续判断", Content: "类似这样的 SELECT * FROM tbl WHERE col = col = 'abc' 语句可能是书写错误,您可能想表达的含义是 col = 'abc'。如果确实是业务需求建议修改为 col = col and col = 'abc'。", Case: "SELECT * FROM tbl WHERE col = col = 'abc'", Func: (*Query4Audit).RuleMultiCompare, }, "RES.010": { Item: "RES.010", Severity: "L2", Summary: "建表语句中定义为 ON UPDATE CURRENT_TIMESTAMP 的字段不建议包含业务逻辑", Content: "定义为 ON UPDATE CURRENT_TIMESTAMP 的字段在该表其他字段更新时会联动修改,如果包含业务逻辑用户可见会埋下隐患。后续如有批量修改数据却又不想修改该字段时会导致数据错误。", Case: `CREATE TABLE category (category_id TINYINT UNSIGNED NOT NULL AUTO_INCREMENT, name VARCHAR(25) NOT NULL, last_update TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (category_id)`, Func: (*Query4Audit).RuleCreateOnUpdate, }, "RES.011": { Item: "RES.011", Severity: "L2", Summary: "更新请求操作的表包含 ON UPDATE CURRENT_TIMESTAMP 字段", Content: "定义为 ON UPDATE CURRENT_TIMESTAMP 的字段在该表其他字段更新时会联动修改,请注意检查。如不想修改字段的更新时间可以使用如下方法:UPDATE category SET name='ActioN', last_update=last_update WHERE category_id=1", Case: "UPDATE category SET name='ActioN', last_update=last_update WHERE category_id=1", Func: (*Query4Audit).RuleOK, // 该建议在indexAdvisor中给 RuleUpdateOnUpdate }, "SEC.001": { Item: "SEC.001", Severity: "L0", Summary: "请谨慎使用TRUNCATE操作", Content: `一般来说想清空一张表最快速的做法就是使用TRUNCATE TABLE tbl_name;语句。但TRUNCATE操作也并非是毫无代价的,TRUNCATE TABLE无法返回被删除的准确行数,如果需要返回被删除的行数建议使用DELETE语法。TRUNCATE 操作还会重置 AUTO_INCREMENT,如果不想重置该值建议使用 DELETE FROM tbl_name WHERE 1;替代。TRUNCATE 操作会对数据字典添加源数据锁(MDL),当一次需要 TRUNCATE 很多表时会影响整个实例的所有请求,因此如果要 TRUNCATE 多个表建议用 DROP+CREATE 的方式以减少锁时长。`, Case: "TRUNCATE TABLE tbl_name", Func: (*Query4Audit).RuleTruncateTable, }, "SEC.002": { Item: "SEC.002", Severity: "L0", Summary: "不使用明文存储密码", Content: `使用明文存储密码或者使用明文在网络上传递密码都是不安全的。如果攻击者能够截获您用来插入密码的SQL语句,他们就能直接读到密码。另外,将用户输入的字符串以明文的形式插入到纯SQL语句中,也会让攻击者发现它。如果您能够读取密码,黑客也可以。解决方案是使用单向哈希函数对原始密码进行加密编码。哈希是指将输入字符串转化成另一个新的、不可识别的字符串的函数。对密码加密表达式加点随机串来防御“字典攻击”。不要将明文密码输入到SQL查询语句中。在应用程序代码中计算哈希串,只在SQL查询中使用哈希串。`, Case: "create table test(id int,name varchar(20) not null,password varchar(200)not null)", Func: (*Query4Audit).RuleReadablePasswords, }, "SEC.003": { Item: "SEC.003", Severity: "L0", Summary: "使用DELETE/DROP/TRUNCATE等操作时注意备份", Content: `在执行高危操作之前对数据进行备份是十分有必要的。`, Case: "delete from table where col = 'condition'", Func: (*Query4Audit).RuleDataDrop, }, "SEC.004": { Item: "SEC.004", Severity: "L0", Summary: "发现常见 SQL 注入函数", Content: `SLEEP(), BENCHMARK(), GET_LOCK(), RELEASE_LOCK() 等函数通常出现在 SQL 注入语句中,会严重影响数据库性能。`, Case: "SELECT BENCHMARK(10, RAND())", Func: (*Query4Audit).RuleInjection, }, "STA.001": { Item: "STA.001", Severity: "L0", Summary: "'!=' 运算符是非标准的", Content: `"<>"才是标准SQL中的不等于运算符。`, Case: "select col1,col2 from tbl where type!=0", Func: (*Query4Audit).RuleStandardINEQ, }, "STA.002": { Item: "STA.002", Severity: "L1", Summary: "库名或表名点后建议不要加空格", Content: `当使用 db.table 或 table.column 格式访问表或字段时,请不要在点号后面添加空格,虽然这样语法正确。`, Case: "select col from sakila. film", Func: (*Query4Audit).RuleSpaceAfterDot, }, "STA.003": { Item: "STA.003", Severity: "L1", Summary: "索引起名不规范", Content: `建议普通二级索引以` + common.Config.IdxPrefix + `为前缀,唯一索引以` + common.Config.UkPrefix + `为前缀。`, Case: "select col from now where type!=0", Func: (*Query4Audit).RuleIdxPrefix, }, "STA.004": { Item: "STA.004", Severity: "L1", Summary: "起名时请不要使用字母、数字和下划线之外的字符", Content: `以字母或下划线开头,名字只允许使用字母、数字和下划线。请统一大小写,不要使用驼峰命名法。不要在名字中出现连续下划线'__',这样很难辨认。`, Case: "CREATE TABLE ` abc` (a int);", Func: (*Query4Audit).RuleStandardName, }, "SUB.001": { Item: "SUB.001", Severity: "L4", Summary: "MySQL 对子查询的优化效果不佳", Content: `MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。`, Case: "select col1,col2,col3 from table1 where col2 in(select col from table2)", Func: (*Query4Audit).RuleInSubquery, }, "SUB.002": { Item: "SUB.002", Severity: "L2", Summary: "如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION", Content: `与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。`, Case: "select teacher_id as id,people_name as name from t1,t2 where t1.teacher_id=t2.people_id union select student_id as id,people_name as name from t1,t2 where t1.student_id=t2.people_id", Func: (*Query4Audit).RuleUNIONUsage, }, "SUB.003": { Item: "SUB.003", Severity: "L3", Summary: "考虑使用 EXISTS 而不是 DISTINCT 子查询", Content: `DISTINCT 关键字在对元组排序后删除重复。相反,考虑使用一个带有 EXISTS 关键字的子查询,您可以避免返回整个表。`, Case: "SELECT DISTINCT c.c_id, c.c_name FROM c,e WHERE e.c_id = c.c_id", Func: (*Query4Audit).RuleDistinctJoinUsage, }, // TODO: 5.6有了semi join 还要把 in 转成 exists 么? // Use EXISTS instead of IN to check existence of data. // http://www.winwire.com/25-tips-to-improve-sql-query-performance/ "SUB.004": { Item: "SUB.004", Severity: "L3", Summary: "执行计划中嵌套连接深度过深", Content: `MySQL对子查询的优化效果不佳,MySQL将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。`, Case: "SELECT * from tb where id in (select id from (select id from tb))", Func: (*Query4Audit).RuleSubqueryDepth, }, // SUB.005灵感来自 https://blog.csdn.net/zhuocr/article/details/61192418 "SUB.005": { Item: "SUB.005", Severity: "L8", Summary: "子查询不支持LIMIT", Content: `当前 MySQL 版本不支持在子查询中进行 'LIMIT & IN/ALL/ANY/SOME'。`, Case: "SELECT * FROM staff WHERE name IN (SELECT NAME FROM customer ORDER BY name LIMIT 1)", Func: (*Query4Audit).RuleSubQueryLimit, }, "SUB.006": { Item: "SUB.006", Severity: "L2", Summary: "不建议在子查询中使用函数", Content: `MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。`, Case: "SELECT * FROM staff WHERE name IN (SELECT max(NAME) FROM customer)", Func: (*Query4Audit).RuleSubQueryFunctions, }, "SUB.007": { Item: "SUB.007", Severity: "L2", Summary: "外层带有 LIMIT 输出限制的 UNION 联合查询,其内层查询建议也添加 LIMIT 输出限制", Content: `有时 MySQL 无法将限制条件从外层“下推”到内层,这会使得原本可以限制能够限制部分返回结果的条件无法应用到内层查询的优化上。比如:(SELECT * FROM tb1 ORDER BY name) UNION ALL (SELECT * FROM tb2 ORDER BY name) LIMIT 20; MySQL 会将两个子查询的结果放在一个临时表中,然后取出 20 条结果,可以通过在两个子查询中添加 LIMIT 20 来减少临时表中的数据。(SELECT * FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT * FROM tb2 ORDER BY name LIMIT 20) LIMIT 20;`, Case: "(SELECT * FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT * FROM tb2 ORDER BY name LIMIT 20) LIMIT 20;", Func: (*Query4Audit).RuleUNIONLimit, }, "TBL.001": { Item: "TBL.001", Severity: "L4", Summary: "不建议使用分区表", Content: `不建议使用分区表`, Case: "CREATE TABLE trb3(id INT, name VARCHAR(50), purchased DATE) PARTITION BY RANGE(YEAR(purchased)) (PARTITION p0 VALUES LESS THAN (1990), PARTITION p1 VALUES LESS THAN (1995), PARTITION p2 VALUES LESS THAN (2000), PARTITION p3 VALUES LESS THAN (2005) );", Func: (*Query4Audit).RulePartitionNotAllowed, }, "TBL.002": { Item: "TBL.002", Severity: "L4", Summary: "请为表选择合适的存储引擎", Content: `建表或修改表的存储引擎时建议使用推荐的存储引擎,如:` + strings.Join(common.Config.AllowEngines, ","), Case: "create table test(`id` int(11) NOT NULL AUTO_INCREMENT)", Func: (*Query4Audit).RuleAllowEngine, }, "TBL.003": { Item: "TBL.003", Severity: "L8", Summary: "以DUAL命名的表在数据库中有特殊含义", Content: `DUAL表为虚拟表,不需要创建即可使用,也不建议服务以DUAL命名表。`, Case: "create table dual(id int, primary key (id));", Func: (*Query4Audit).RuleCreateDualTable, }, "TBL.004": { Item: "TBL.004", Severity: "L2", Summary: "表的初始AUTO_INCREMENT值不为0", Content: `AUTO_INCREMENT不为0会导致数据空洞。`, Case: "CREATE TABLE tbl (a int) AUTO_INCREMENT = 10;", Func: (*Query4Audit).RuleAutoIncrementInitNotZero, }, "TBL.005": { Item: "TBL.005", Severity: "L4", Summary: "请使用推荐的字符集", Content: `表字符集只允许设置为'` + strings.Join(common.Config.AllowCharsets, ",") + "'", Case: "CREATE TABLE tbl (a int) DEFAULT CHARSET = latin1;", Func: (*Query4Audit).RuleTableCharsetCheck, }, "TBL.006": { Item: "TBL.006", Severity: "L1", Summary: "不建议使用视图", Content: `不建议使用视图`, Case: "create view v_today (today) AS SELECT CURRENT_DATE;", Func: (*Query4Audit).RuleForbiddenView, }, "TBL.007": { Item: "TBL.007", Severity: "L1", Summary: "不建议使用临时表", Content: `不建议使用临时表`, Case: "CREATE TEMPORARY TABLE `work` (`time` time DEFAULT NULL) ENGINE=InnoDB;", Func: (*Query4Audit).RuleForbiddenTempTable, }, "TBL.008": { Item: "TBL.008", Severity: "L4", Summary: "请使用推荐的COLLATE", Content: `COLLATE 只允许设置为'` + strings.Join(common.Config.AllowCollates, ",") + "'", Case: "CREATE TABLE tbl (a int) DEFAULT COLLATE = latin1_bin;", Func: (*Query4Audit).RuleTableCharsetCheck, }, } } // IsIgnoreRule 判断是否是过滤规则 // 支持XXX*前缀匹配,OK规则不可设置过滤 func IsIgnoreRule(item string) bool { for _, ir := range common.Config.IgnoreRules { ir = strings.Trim(ir, "*") if strings.HasPrefix(item, ir) && ir != "OK" && ir != "" { common.Log.Debug("IsIgnoreRule: %s", item) return true } } return false } // InBlackList 判断一条请求是否在黑名单列表中 // 如果在返回true,表示不需要评审 // 注意这里没有做指纹判断,是否用指纹在这个函数的外面处理 func InBlackList(sql string) bool { in := false for _, r := range common.BlackList { if sql == r { in = true break } re, err := regexp.Compile("(?i)" + r) if err == nil { if re.FindString(sql) != "" { common.Log.Debug("InBlackList: true, regexp: %s, sql: %s", "(?i)"+r, sql) in = true break } common.Log.Debug("InBlackList: false, regexp: %s, sql: %s", "(?i)"+r, sql) } } return in } // FormatSuggest 格式化输出优化建议 func FormatSuggest(sql string, currentDB string, format string, suggests ...map[string]Rule) (map[string]Rule, string) { common.Log.Debug("FormatSuggest, Query: %s", sql) var fingerprint, id string var buf []string var score = 100 type Result struct { ID string Fingerprint string Sample string Suggest map[string]Rule } // 生成指纹和ID if sql != "" { fingerprint = query.Fingerprint(sql) id = query.Id(fingerprint) } // 合并重复的建议 suggest := make(map[string]Rule) for _, s := range suggests { for item, rule := range s { suggest[item] = rule } } suggest = MergeConflictHeuristicRules(suggest) // 是否忽略显示OK建议,测试的时候大家都喜欢看OK,线上跑起来的时候OK太多反而容易看花眼 ignoreOK := false for _, r := range common.Config.IgnoreRules { if "OK" == r { ignoreOK = true } } // 先保证suggest中有元素,然后再根据ignore配置删除不需要的项 if len(suggest) < 1 { suggest = map[string]Rule{"OK": HeuristicRules["OK"]} } if ignoreOK || len(suggest) > 1 { delete(suggest, "OK") } for k := range suggest { if IsIgnoreRule(k) { delete(suggest, k) } } common.Log.Debug("FormatSuggest, format: %s", format) switch format { case "json": buf = append(buf, formatJSON(sql, currentDB, suggest)) case "text": for item, rule := range suggest { buf = append(buf, fmt.Sprintln("Query: ", sql)) buf = append(buf, fmt.Sprintln("ID: ", id)) buf = append(buf, fmt.Sprintln("Item: ", item)) buf = append(buf, fmt.Sprintln("Severity: ", rule.Severity)) buf = append(buf, fmt.Sprintln("Summary: ", rule.Summary)) buf = append(buf, fmt.Sprintln("Content: ", rule.Content)) } case "lint": for item, rule := range suggest { // lint 中无需关注 OK 和 EXP if item != "OK" && !strings.HasPrefix(item, "EXP") { buf = append(buf, fmt.Sprintf("%s %s", item, rule.Summary)) } } case "markdown", "html", "explain-digest", "duplicate-key-checker": if sql != "" && len(suggest) > 0 { switch common.Config.ExplainSQLReportType { case "fingerprint": buf = append(buf, fmt.Sprintf("# Query: %s\n", id)) buf = append(buf, fmt.Sprintf("```sql\n%s\n```\n", fingerprint)) case "sample": buf = append(buf, fmt.Sprintf("# Query: %s\n", id)) buf = append(buf, fmt.Sprintf("```sql\n%s\n```\n", sql)) default: buf = append(buf, fmt.Sprintf("# Query: %s\n", id)) buf = append(buf, fmt.Sprintf("```sql\n%s\n```\n", ast.Pretty(sql, format))) } } // MySQL common.Log.Debug("FormatSuggest, start of sortedMySQLSuggest") var sortedMySQLSuggest []string for item := range suggest { if strings.HasPrefix(item, "ERR") { if suggest[item].Content == "" { delete(suggest, item) } else { sortedMySQLSuggest = append(sortedMySQLSuggest, item) } } } sort.Strings(sortedMySQLSuggest) if len(sortedMySQLSuggest) > 0 { buf = append(buf, "## MySQL execute failed\n") } for _, item := range sortedMySQLSuggest { buf = append(buf, fmt.Sprintln(suggest[item].Content)) score = 0 delete(suggest, item) } // Explain common.Log.Debug("FormatSuggest, start of sortedExplainSuggest") if suggest["EXP.000"].Item != "" { buf = append(buf, fmt.Sprintln("## ", suggest["EXP.000"].Summary)) buf = append(buf, fmt.Sprintln(suggest["EXP.000"].Content)) buf = append(buf, fmt.Sprint(suggest["EXP.000"].Case, "\n")) delete(suggest, "EXP.000") } var sortedExplainSuggest []string for item := range suggest { if strings.HasPrefix(item, "EXP") { sortedExplainSuggest = append(sortedExplainSuggest, item) } } sort.Strings(sortedExplainSuggest) for _, item := range sortedExplainSuggest { buf = append(buf, fmt.Sprintln("### ", suggest[item].Summary)) buf = append(buf, fmt.Sprintln(suggest[item].Content)) buf = append(buf, fmt.Sprint(suggest[item].Case, "\n")) } // Profiling common.Log.Debug("FormatSuggest, start of sortedProfilingSuggest") var sortedProfilingSuggest []string for item := range suggest { if strings.HasPrefix(item, "PRO") { sortedProfilingSuggest = append(sortedProfilingSuggest, item) } } sort.Strings(sortedProfilingSuggest) if len(sortedProfilingSuggest) > 0 { buf = append(buf, "## Profiling信息\n") } for _, item := range sortedProfilingSuggest { buf = append(buf, fmt.Sprintln(suggest[item].Content)) delete(suggest, item) } // Trace common.Log.Debug("FormatSuggest, start of sortedTraceSuggest") var sortedTraceSuggest []string for item := range suggest { if strings.HasPrefix(item, "TRA") { sortedTraceSuggest = append(sortedTraceSuggest, item) } } sort.Strings(sortedTraceSuggest) if len(sortedTraceSuggest) > 0 { buf = append(buf, "## Trace信息\n") } for _, item := range sortedTraceSuggest { buf = append(buf, fmt.Sprintln(suggest[item].Content)) delete(suggest, item) } // Index common.Log.Debug("FormatSuggest, start of sortedIdxSuggest") var sortedIdxSuggest []string for item := range suggest { if strings.HasPrefix(item, "IDX") { sortedIdxSuggest = append(sortedIdxSuggest, item) } } sort.Strings(sortedIdxSuggest) for _, item := range sortedIdxSuggest { buf = append(buf, fmt.Sprintln("## ", common.MarkdownEscape(suggest[item].Summary))) buf = append(buf, fmt.Sprintln("* **Item:** ", item)) buf = append(buf, fmt.Sprintln("* **Severity:** ", suggest[item].Severity)) minus, err := strconv.Atoi(strings.Trim(suggest[item].Severity, "L")) if err == nil { score = score - minus*5 } else { common.Log.Debug("FormatSuggest, sortedIdxSuggest, strconv.Atoi, Error: ", err) score = 0 } buf = append(buf, fmt.Sprintln("* **Content:** ", common.MarkdownEscape(suggest[item].Content))) if format == "duplicate-key-checker" { buf = append(buf, fmt.Sprintf("* **原建表语句:** \n```sql\n%s\n```\n", suggest[item].Case), "\n\n") } else { buf = append(buf, fmt.Sprint("* **Case:** ", common.MarkdownEscape(suggest[item].Case), "\n\n")) } } // Heuristic common.Log.Debug("FormatSuggest, start of sortedHeuristicSuggest") var sortedHeuristicSuggest []string for item := range suggest { if !strings.HasPrefix(item, "EXP") && !strings.HasPrefix(item, "IDX") && !strings.HasPrefix(item, "PRO") { sortedHeuristicSuggest = append(sortedHeuristicSuggest, item) } } sort.Strings(sortedHeuristicSuggest) for _, item := range sortedHeuristicSuggest { buf = append(buf, fmt.Sprintln("##", suggest[item].Summary)) if item == "OK" { continue } buf = append(buf, fmt.Sprintln("* **Item:** ", item)) buf = append(buf, fmt.Sprintln("* **Severity:** ", suggest[item].Severity)) minus, err := strconv.Atoi(strings.Trim(suggest[item].Severity, "L")) if err == nil { score = score - minus*5 } else { common.Log.Debug("FormatSuggest, sortedHeuristicSuggest, strconv.Atoi, Error: ", err) score = 0 } buf = append(buf, fmt.Sprintln("* **Content:** ", common.MarkdownEscape(suggest[item].Content))) // buf = append(buf, fmt.Sprint("* **Case:** ", common.MarkdownEscape(suggest[item].Case), "\n\n")) } default: common.Log.Debug("report-type: %s", format) buf = append(buf, fmt.Sprintln("Query: ", sql)) for _, rule := range suggest { buf = append(buf, pretty.Sprint(rule)) } } // 打分 var str string switch common.Config.ReportType { case "markdown", "html": if len(buf) > 1 { str = buf[0] + "\n" + common.Score(score) + "\n\n" + strings.Join(buf[1:], "\n") } default: str = strings.Join(buf, "\n") } return suggest, str } // JSONSuggest json format suggestion type JSONSuggest struct { ID string `json:"ID"` Fingerprint string `json:"Fingerprint"` Score int `json:"Score"` Sample string `json:"Sample"` Explain []Rule `json:"Explain"` HeuristicRules []Rule `json:"HeuristicRules"` IndexRules []Rule `json:"IndexRules"` Tables []string `json:"Tables"` } func formatJSON(sql string, db string, suggest map[string]Rule) string { var id, fingerprint, result string fingerprint = query.Fingerprint(sql) id = query.Id(fingerprint) // Score score := 100 for item := range suggest { l, err := strconv.Atoi(strings.TrimLeft(suggest[item].Severity, "L")) if err != nil { common.Log.Error("formatJSON strconv.Atoi error: %s, item: %s, serverity: %s", err.Error(), item, suggest[item].Severity) } score = score - l*5 // ## MySQL execute failed if strings.HasPrefix(item, "ERR") && suggest[item].Content != "" { score = 0 } } if score < 0 { score = 0 } sug := JSONSuggest{ ID: id, Fingerprint: fingerprint, Sample: sql, Tables: ast.SchemaMetaInfo(sql, db), Score: score, } // Explain info var sortItem []string for item := range suggest { if strings.HasPrefix(item, "EXP") { sortItem = append(sortItem, item) } } sort.Strings(sortItem) for _, i := range sortItem { sug.Explain = append(sug.Explain, suggest[i]) } sortItem = make([]string, 0) // Index advisor for item := range suggest { if strings.HasPrefix(item, "IDX") { sortItem = append(sortItem, item) } } sort.Strings(sortItem) for _, i := range sortItem { sug.IndexRules = append(sug.IndexRules, suggest[i]) } sortItem = make([]string, 0) // Heuristic rules for item := range suggest { if !strings.HasPrefix(item, "EXP") && !strings.HasPrefix(item, "IDX") { if strings.HasPrefix(item, "ERR") && suggest[item].Content == "" { continue } sortItem = append(sortItem, item) } } sort.Strings(sortItem) for _, i := range sortItem { sug.HeuristicRules = append(sug.HeuristicRules, suggest[i]) } sortItem = make([]string, 0) js, err := json.MarshalIndent(sug, "", " ") if err == nil { result = fmt.Sprint(string(js)) } else { common.Log.Error("formatJSON json.Marshal Error: %v", err) } return result } // ListHeuristicRules 打印支持的启发式规则,对应命令行参数-list-heuristic-rules func ListHeuristicRules(rules ...map[string]Rule) { switch common.Config.ReportType { case "json": js, err := json.MarshalIndent(rules, "", " ") if err == nil { fmt.Println(string(js)) } default: fmt.Print("# 启发式规则建议\n\n[toc]\n\n") for _, r := range rules { delete(r, "OK") for _, item := range common.SortedKey(r) { fmt.Print("## ", common.MarkdownEscape(r[item].Summary), "\n\n* **Item**:", r[item].Item, "\n* **Severity**:", r[item].Severity, "\n* **Content**:", common.MarkdownEscape(r[item].Content), "\n* **Case**:\n\n```sql\n", r[item].Case, "\n```\n") } } } } // ListTestSQLs 打印测试用的SQL,方便测试,对应命令行参数-list-test-sqls func ListTestSQLs() { for _, sql := range common.TestSQLs { fmt.Println(sql) } } ================================================ FILE: advisor/rules_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package advisor import ( "strings" "testing" "github.com/XiaoMi/soar/common" ) func TestListTestSQLs(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) for _, sql := range common.TestSQLs { if !strings.HasSuffix(sql, ";") { t.Errorf("%s should end with ';'", sql) } } err := common.GoldenDiff(func() { ListTestSQLs() }, t.Name(), update) if nil != err { t.Fatal(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestListHeuristicRules(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) err := common.GoldenDiff(func() { ListHeuristicRules(HeuristicRules) }, t.Name(), update) if nil != err { t.Fatal(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestInBlackList(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select", "select 1", } common.BlackList = []string{"select"} for _, sql := range sqls { if !InBlackList(sql) { t.Error("should be true") } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestIsIgnoreRule(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) common.Config.IgnoreRules = []string{"test"} if !IsIgnoreRule("test") { t.Error("should be true") } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestNewQuery4Audit(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `SELECT CONVERT("abc" using gbk)`, `SET NAMES gbk`, } for _, sql := range sqls { _, err := NewQuery4Audit(sql) if err != nil { t.Errorf("SQL: %s, Error: %s", sql, err.Error()) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: advisor/testdata/TestDigestExplainText.golden ================================================ ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *country* | NULL | index | PRIMARY,
country\_id | country | 152 | NULL | 0 | 0.00% | ☠️ **O(n)** | Using index | | 1 | SIMPLE | *city* | NULL | ref | idx\_fk\_country\_id,
idx\_country\_id\_city,
idx\_all,
idx\_other | idx\_fk\_country\_id | 2 | sakila.country.country\_id | 0 | 0.00% | O(log n) | Using index | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **index**: 全表扫描, 只是扫描表的时候按照索引次序进行而不是行. 主要优点就是避免了排序, 但是开销仍然非常大. * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. SQL优化分析报告

Explain信息

★ ★ ★ ★ ★ 100分

id select_type table partitions type possible_keys key key_len ref rows filtered scalability Extra
1 SIMPLE country NULL index PRIMARY,
country_id
country 152 NULL 0 0.00% ☠️ O(n) Using index
1 SIMPLE city NULL ref idx_fk_country_id,
idx_country_id_city,
idx_all,
idx_other
idx_fk_country_id 2 sakila.country.country_id 0 0.00% O(log n) Using index

Explain信息解读

SelectType信息解读

Type信息解读

Extra信息解读

================================================ FILE: advisor/testdata/TestIndexAdviseNoEnv.golden ================================================ map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; 为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`), add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; 为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`), add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的address表添加索引", Content:"为列address添加索引,散粒度为: 100.00%; 为列district添加索引,散粒度为: 100.00%; ", Case:"ALTER TABLE `sakila`.`address` add index `idx_address` (`address`), add index `idx_district` (`district`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; 为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`), add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; 为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`), add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; 为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`), add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; 为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`), add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列release_year添加索引,散粒度为: 0.10%; 为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_release_year` (`release_year`), add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; 为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`), add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; 为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`), add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; 为列release_year添加索引,散粒度为: 0.10%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`), add index `idx_release_year` (`release_year`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的country表添加索引", Content:"为列last_update添加索引,散粒度为: 0.92%; ", Case:"ALTER TABLE `sakila`.`country` add index `idx_last_update` (`last_update`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的city表添加索引", Content:"为列last_update添加索引,散粒度为: 0.17%; ", Case:"ALTER TABLE `sakila`.`city` add index `idx_last_update` (`last_update`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的country表添加索引", Content:"为列last_update添加索引,散粒度为: 0.92%; ", Case:"ALTER TABLE `sakila`.`country` add index `idx_last_update` (`last_update`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, "IDX.002": {Item:"", Severity:"L2", Summary:"为sakila库的city表添加索引", Content:"为列last_update添加索引,散粒度为: 0.17%; ", Case:"ALTER TABLE `sakila`.`city` add index `idx_last_update` (`last_update`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的country表添加索引", Content:"为列country添加索引,散粒度为: 100.00%; ", Case:"ALTER TABLE `sakila`.`country` add index `idx_country` (`country`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列length添加索引,散粒度为: 14.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_length` (`length`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的actor表添加索引", Content:"为列last_update添加索引,散粒度为: 0.50%; 为列first_name添加索引,散粒度为: 64.00%; ", Case:"ALTER TABLE `sakila`.`actor` add index `idx_last_update` (`last_update`), add index `idx_first_name` (`first_name`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的city表添加索引", Content:"为列city添加索引,散粒度为: 99.83%; ", Case:"ALTER TABLE `sakila`.`city` add index `idx_city` (`city`) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } map[string]advisor.Rule{ "IDX.001": {Item:"", Severity:"L2", Summary:"为sakila库的film表添加索引", Content:"为列description添加索引,散粒度为: 100.00%; ", Case:"ALTER TABLE `sakila`.`film` add index `idx_description` (`description`(255)) ;\n", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}}, } ================================================ FILE: advisor/testdata/TestListHeuristicRules.golden ================================================ # 启发式规则建议 [toc] ## 建议使用 AS 关键字显示声明一个别名 * **Item**:ALI.001 * **Severity**:L0 * **Content**:在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 * **Case**: ```sql select name from tbl t1 where id < 1000 ``` ## 不建议给列通配符'\*'设置别名 * **Item**:ALI.002 * **Severity**:L8 * **Content**:例: "SELECT tbl.\* col1, col2"上面这条 SQL 给列通配符设置了别名,这样的SQL可能存在逻辑错误。您可能意在查询 col1, 但是代替它的是重命名的是 tbl 的最后一列。 * **Case**: ```sql select tbl.* as c1,c2,c3 from tbl where id < 1000 ``` ## 别名不要与表或列的名字相同 * **Item**:ALI.003 * **Severity**:L1 * **Content**:表或列的别名与其真实名称相同, 这样的别名会使得查询更难去分辨。 * **Case**: ```sql select name from tbl as tbl where id < 1000 ``` ## 修改表的默认字符集不会改表各个字段的字符集 * **Item**:ALT.001 * **Severity**:L4 * **Content**:很多初学者会将 ALTER TABLE tbl\_name [DEFAULT] CHARACTER SET 'UTF8' 误认为会修改所有字段的字符集,但实际上它只会影响后续新增的字段不会改表已有字段的字符集。如果想修改整张表所有字段的字符集建议使用 ALTER TABLE tbl\_name CONVERT TO CHARACTER SET charset\_name; * **Case**: ```sql ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name; ``` ## 同一张表的多条 ALTER 请求建议合为一条 * **Item**:ALT.002 * **Severity**:L2 * **Content**:每次表结构变更对线上服务都会产生影响,即使是能够通过在线工具进行调整也请尽量通过合并 ALTER 请求的试减少操作次数。 * **Case**: ```sql ALTER TABLE tbl ADD COLUMN col int, ADD INDEX idx_col (`col`); ``` ## 删除列为高危操作,操作前请注意检查业务逻辑是否还有依赖 * **Item**:ALT.003 * **Severity**:L0 * **Content**:如业务逻辑依赖未完全消除,列被删除后可能导致数据无法写入或无法查询到已删除列数据导致程序异常的情况。这种情况下即使通过备份数据回滚也会丢失用户请求写入的数据。 * **Case**: ```sql ALTER TABLE tbl DROP COLUMN col; ``` ## 删除主键和外键为高危操作,操作前请与 DBA 确认影响 * **Item**:ALT.004 * **Severity**:L0 * **Content**:主键和外键为关系型数据库中两种重要约束,删除已有约束会打破已有业务逻辑,操作前请业务开发与 DBA 确认影响,三思而行。 * **Case**: ```sql ALTER TABLE tbl DROP PRIMARY KEY; ``` ## 不建议使用前项通配符查找 * **Item**:ARG.001 * **Severity**:L4 * **Content**:例如 "%foo",查询参数有一个前项通配符的情况无法使用已有索引。 * **Case**: ```sql select c1,c2,c3 from tbl where name like '%foo' ``` ## 没有通配符的 LIKE 查询 * **Item**:ARG.002 * **Severity**:L1 * **Content**:不包含通配符的 LIKE 查询可能存在逻辑错误,因为逻辑上它与等值查询相同。 * **Case**: ```sql select c1,c2,c3 from tbl where name like 'foo' ``` ## 参数比较包含隐式转换,无法使用索引 * **Item**:ARG.003 * **Severity**:L4 * **Content**:隐式类型转换有无法命中索引的风险,在高并发、大数据量的情况下,命不中索引带来的后果非常严重。 * **Case**: ```sql SELECT * FROM sakila.film WHERE length >= '60'; ``` ## IN (NULL)/NOT IN (NULL) 永远非真 * **Item**:ARG.004 * **Severity**:L4 * **Content**:正确的作法是 col IN ('val1', 'val2', 'val3') OR col IS NULL * **Case**: ```sql SELECT * FROM tb WHERE col IN (NULL); ``` ## IN 要慎用,元素过多会导致全表扫描 * **Item**:ARG.005 * **Severity**:L1 * **Content**: 如:select id from t where num in(1,2,3)对于连续的数值,能用 BETWEEN 就不要用 IN 了:select id from t where num between 1 and 3。而当 IN 值过多时 MySQL 也可能会进入全表扫描导致性能急剧下降。 * **Case**: ```sql select id from t where num in(1,2,3) ``` ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item**:ARG.006 * **Severity**:L1 * **Content**:使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; * **Case**: ```sql select id from t where num is null ``` ## 避免使用模式匹配 * **Item**:ARG.007 * **Severity**:L3 * **Content**:性能问题是使用模式匹配操作符的最大缺点。使用 LIKE 或正则表达式进行模式匹配进行查询的另一个问题,是可能会返回意料之外的结果。最好的方案就是使用特殊的搜索引擎技术来替代 SQL,比如 Apache Lucene。另一个可选方案是将结果保存起来从而减少重复的搜索开销。如果一定要使用SQL,请考虑在 MySQL 中使用像 FULLTEXT 索引这样的第三方扩展。但更广泛地说,您不一定要使用SQL来解决所有问题。 * **Case**: ```sql select c_id,c2,c3 from tbl where c2 like 'test%' ``` ## OR 查询索引列时请尽量使用 IN 谓词 * **Item**:ARG.008 * **Severity**:L1 * **Content**:IN-list 谓词可以用于索引检索,并且优化器可以对 IN-list 进行排序,以匹配索引的排序序列,从而获得更有效的检索。请注意,IN-list 必须只包含常量,或在查询块执行期间保持常量的值,例如外引用。 * **Case**: ```sql SELECT c1,c2,c3 FROM tbl WHERE c1 = 14 OR c1 = 17 ``` ## 引号中的字符串开头或结尾包含空格 * **Item**:ARG.009 * **Severity**:L1 * **Content**:如果 VARCHAR 列的前后存在空格将可能引起逻辑问题,如在 MySQL 5.5中 'a' 和 'a ' 可能会在查询中被认为是相同的值。 * **Case**: ```sql SELECT 'abc ' ``` ## 不要使用 hint,如:sql\_no\_cache, force index, ignore key, straight join等 * **Item**:ARG.010 * **Severity**:L1 * **Content**:hint 是用来强制 SQL 按照某个执行计划来执行,但随着数据量变化我们无法保证自己当初的预判是正确的。 * **Case**: ```sql SELECT * FROM t1 USE INDEX (i1) ORDER BY a; ``` ## 不要使用负向查询,如:NOT IN/NOT LIKE * **Item**:ARG.011 * **Severity**:L3 * **Content**:请尽量不要使用负向查询,这将导致全表扫描,对查询性能影响较大。 * **Case**: ```sql select id from t where num not in(1,2,3); ``` ## 一次性 INSERT/REPLACE 的数据过多 * **Item**:ARG.012 * **Severity**:L2 * **Content**:单条 INSERT/REPLACE 语句批量插入大量数据性能较差,甚至可能导致从库同步延迟。为了提升性能,减少批量写入数据对从库同步延时的影响,建议采用分批次插入的方法。 * **Case**: ```sql INSERT INTO tb (a) VALUES (1), (2) ``` ## DDL 语句中使用了中文全角引号 * **Item**:ARG.013 * **Severity**:L0 * **Content**:DDL 语句中使用了中文全角引号“”或‘’,这可能是书写错误,请确认是否符合预期。 * **Case**: ```sql CREATE TABLE tb (a varchar(10) default '“”' ``` ## IN 条件中存在列名,可能导致数据匹配范围扩大 * **Item**:ARG.014 * **Severity**:L4 * **Content**:如:delete from t where id in(1, 2, id) 可能会导致全表数据误删除。请仔细检查 IN 条件的正确性。 * **Case**: ```sql select id from t where id in(1, 2, id) ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item**:CLA.001 * **Severity**:L4 * **Content**:SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 * **Case**: ```sql select id from tbl ``` ## 不建议使用 ORDER BY RAND() * **Item**:CLA.002 * **Severity**:L3 * **Content**:ORDER BY RAND() 是从结果集中检索随机行的一种非常低效的方法,因为它会对整个结果进行排序并丢弃其大部分数据。 * **Case**: ```sql select name from tbl where id < 1000 order by rand(number) ``` ## 不建议使用带 OFFSET 的LIMIT 查询 * **Item**:CLA.003 * **Severity**:L2 * **Content**:使用 LIMIT 和 OFFSET 对结果集分页的复杂度是 O(n^2),并且会随着数据增大而导致性能问题。采用“书签”扫描的方法实现分页效率更高。 * **Case**: ```sql select c1,c2 from tbl where name=xx order by number limit 1 offset 20 ``` ## 不建议对常量进行 GROUP BY * **Item**:CLA.004 * **Severity**:L2 * **Content**:GROUP BY 1 表示按第一列进行 GROUP BY。如果在 GROUP BY 子句中使用数字,而不是表达式或列名称,当查询列顺序改变时,可能会导致问题。 * **Case**: ```sql select col1,col2 from tbl group by 1 ``` ## ORDER BY 常数列没有任何意义 * **Item**:CLA.005 * **Severity**:L2 * **Content**:SQL 逻辑上可能存在错误; 最多只是一个无用的操作,不会更改查询结果。 * **Case**: ```sql select id from test where id=1 order by id ``` ## 在不同的表中 GROUP BY 或 ORDER BY * **Item**:CLA.006 * **Severity**:L4 * **Content**:这将强制使用临时表和 filesort,可能产生巨大性能隐患,并且可能消耗大量内存和磁盘上的临时空间。 * **Case**: ```sql select tb1.col, tb2.col from tb1, tb2 where id=1 group by tb1.col, tb2.col ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item**:CLA.008 * **Severity**:L2 * **Content**:默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 * **Case**: ```sql select c1,c2,c3 from t1 where c1='foo' group by c2 ``` ## ORDER BY 的条件为表达式 * **Item**:CLA.009 * **Severity**:L2 * **Content**:当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 * **Case**: ```sql select description from film where title ='ACADEMY DINOSAUR' order by length-language_id; ``` ## GROUP BY 的条件为表达式 * **Item**:CLA.010 * **Severity**:L2 * **Content**:当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 * **Case**: ```sql select description from film where title ='ACADEMY DINOSAUR' GROUP BY length-language_id; ``` ## 建议为表添加注释 * **Item**:CLA.011 * **Severity**:L1 * **Content**:为表添加注释能够使得表的意义更明确,从而为日后的维护带来极大的便利。 * **Case**: ```sql CREATE TABLE `test1` (`ID` bigint(20) NOT NULL AUTO_INCREMENT,`c1` varchar(128) DEFAULT NULL,PRIMARY KEY (`ID`)) ENGINE=InnoDB DEFAULT CHARSET=utf8 ``` ## 将复杂的裹脚布式查询分解成几个简单的查询 * **Item**:CLA.012 * **Severity**:L2 * **Content**:SQL是一门极具表现力的语言,您可以在单个SQL查询或者单条语句中完成很多事情。但这并不意味着必须强制只使用一行代码,或者认为使用一行代码就搞定每个任务是个好主意。通过一个查询来获得所有结果的常见后果是得到了一个笛卡儿积。当查询中的两张表之间没有条件限制它们的关系时,就会发生这种情况。没有对应的限制而直接使用两张表进行联结查询,就会得到第一张表中的每一行和第二张表中的每一行的一个组合。每一个这样的组合就会成为结果集中的一行,最终您就会得到一个行数很多的结果集。重要的是要考虑这些查询很难编写、难以修改和难以调试。数据库查询请求的日益增加应该是预料之中的事。经理们想要更复杂的报告以及在用户界面上添加更多的字段。如果您的设计很复杂,并且是一个单一查询,要扩展它们就会很费时费力。不论对您还是项目来说,时间花在这些事情上面不值得。将复杂的意大利面条式查询分解成几个简单的查询。当您拆分一个复杂的SQL查询时,得到的结果可能是很多类似的查询,可能仅仅在数据类型上有所不同。编写所有的这些查询是很乏味的,因此,最好能够有个程序自动生成这些代码。SQL代码生成是一个很好的应用。尽管SQL支持用一行代码解决复杂的问题,但也别做不切实际的事情。 * **Case**: ```sql 这是一条很长很长的 SQL,案例略。 ``` ## 不建议使用 HAVING 子句 * **Item**:CLA.013 * **Severity**:L3 * **Content**:将查询的 HAVING 子句改写为 WHERE 中的查询条件,可以在查询处理期间使用索引。 * **Case**: ```sql SELECT s.c_id,count(s.c_id) FROM s where c = test GROUP BY s.c_id HAVING s.c_id <> '1660' AND s.c_id <> '2' order by s.c_id ``` ## 删除全表时建议使用 TRUNCATE 替代 DELETE * **Item**:CLA.014 * **Severity**:L2 * **Content**:删除全表时建议使用 TRUNCATE 替代 DELETE * **Case**: ```sql delete from tbl ``` ## UPDATE 未指定 WHERE 条件 * **Item**:CLA.015 * **Severity**:L4 * **Content**:UPDATE 不指定 WHERE 条件一般是致命的,请您三思后行 * **Case**: ```sql update tbl set col=1 ``` ## 不要 UPDATE 主键 * **Item**:CLA.016 * **Severity**:L2 * **Content**:主键是数据表中记录的唯一标识符,不建议频繁更新主键列,这将影响元数据统计信息进而影响正常的查询。 * **Case**: ```sql update tbl set col=1 ``` ## 不建议使用 SELECT \* 类型查询 * **Item**:COL.001 * **Severity**:L1 * **Content**:当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 * **Case**: ```sql select * from tbl where id=1 ``` ## INSERT/REPLACE 未指定列名 * **Item**:COL.002 * **Severity**:L2 * **Content**:当表结构发生变更,如果 INSERT 或 REPLACE 请求不明确指定列名,请求的结果将会与预想的不同; 建议使用 “INSERT INTO tbl(col1,col2)VALUES ...” 代替。 * **Case**: ```sql insert into tbl values(1,'name') ``` ## 建议修改自增 ID 为无符号类型 * **Item**:COL.003 * **Severity**:L2 * **Content**:建议修改自增 ID 为无符号类型 * **Case**: ```sql create table test(`id` int(11) NOT NULL AUTO_INCREMENT) ``` ## 请为列添加默认值 * **Item**:COL.004 * **Severity**:L1 * **Content**:请为列添加默认值,如果是 ALTER 操作,请不要忘记将原字段的默认值写上。字段无默认值,当表较大时无法在线变更表结构。 * **Case**: ```sql CREATE TABLE tbl (col int) ENGINE=InnoDB; ``` ## 列未添加注释 * **Item**:COL.005 * **Severity**:L1 * **Content**:建议对表中每个列添加注释,来明确每个列在表中的含义及作用。 * **Case**: ```sql CREATE TABLE tbl (col int) ENGINE=InnoDB; ``` ## 表中包含有太多的列 * **Item**:COL.006 * **Severity**:L3 * **Content**:表中包含有太多的列 * **Case**: ```sql CREATE TABLE tbl ( cols ....); ``` ## 表中包含有太多的 text/blob 列 * **Item**:COL.007 * **Severity**:L3 * **Content**:表中包含超过2个的 text/blob 列 * **Case**: ```sql CREATE TABLE tbl ( cols ....); ``` ## 可使用 VARCHAR 代替 CHAR, VARBINARY 代替 BINARY * **Item**:COL.008 * **Severity**:L1 * **Content**:为首先变长字段存储空间小,可以节省存储空间。其次对于查询来说,在一个相对较小的字段内搜索效率显然要高些。 * **Case**: ```sql create table t1(id int,name char(20),last_time date) ``` ## 建议使用精确的数据类型 * **Item**:COL.009 * **Severity**:L2 * **Content**:实际上,任何使用 FLOAT, REAL 或 DOUBLE PRECISION 数据类型的设计都有可能是反模式。大多数应用程序使用的浮点数的取值范围并不需要达到IEEE 754标准所定义的最大/最小区间。在计算总量时,非精确浮点数所积累的影响是严重的。使用 SQL 中的 NUMERIC 或 DECIMAL 类型来代替 FLOAT 及其类似的数据类型进行固定精度的小数存储。这些数据类型精确地根据您定义这一列时指定的精度来存储数据。尽可能不要使用浮点数。 * **Case**: ```sql CREATE TABLE tab2 (p_id BIGINT UNSIGNED NOT NULL,a_id BIGINT UNSIGNED NOT NULL,hours float not null,PRIMARY KEY (p_id, a_id)) ``` ## 不建议使用 ENUM/BIT/SET 数据类型 * **Item**:COL.010 * **Severity**:L2 * **Content**:ENUM 定义了列中值的类型,使用字符串表示 ENUM 里的值时,实际存储在列中的数据是这些值在定义时的序数。因此,这列的数据是字节对齐的,当您进行一次排序查询时,结果是按照实际存储的序数值排序的,而不是按字符串值的字母顺序排序的。这可能不是您所希望的。没有什么语法支持从 ENUM 或者 check 约束中添加或删除一个值;您只能使用一个新的集合重新定义这一列。如果您打算废弃一个选项,您可能会为历史数据而烦恼。作为一种策略,改变元数据——也就是说,改变表和列的定义——应该是不常见的,并且要注意测试和质量保证。有一个更好的解决方案来约束一列中的可选值:创建一张检查表,每一行包含一个允许在列中出现的候选值;然后在引用新表的旧表上声明一个外键约束。 * **Case**: ```sql create table tab1(status ENUM('new','in progress','fixed')) ``` ## 当需要唯一约束时才使用 NULL,仅当列不能有缺失值时才使用 NOT NULL * **Item**:COL.011 * **Severity**:L0 * **Content**:NULL 和0是不同的,10乘以 NULL 还是 NULL。NULL 和空字符串是不一样的。将一个字符串和标准 SQL 中的 NULL 联合起来的结果还是 NULL。NULL 和 FALSE 也是不同的。AND、OR 和 NOT 这三个布尔操作如果涉及 NULL,其结果也让很多人感到困惑。当您将一列声明为 NOT NULL 时,也就是说这列中的每一个值都必须存在且是有意义的。使用 NULL 来表示任意类型不存在的空值。 当您将一列声明为 NOT NULL 时,也就是说这列中的每一个值都必须存在且是有意义的。 * **Case**: ```sql select c1,c2,c3 from tbl where c4 is null or c4 <> 1 ``` ## TEXT、BLOB 和 JSON 类型的字段不建议设置为 NOT NULL * **Item**:COL.012 * **Severity**:L5 * **Content**:TEXT、BLOB 和 JSON 类型的字段无法指定非 NULL 的默认值,如果添加了 NOT NULL 限制,写入数据时又未对该字段指定值可能导致写入失败。 * **Case**: ```sql CREATE TABLE `tb`(`c` longblob NOT NULL); ``` ## TIMESTAMP 类型默认值检查异常 * **Item**:COL.013 * **Severity**:L4 * **Content**:TIMESTAMP 类型建议设置默认值,且不建议使用 0 或 0000-00-00 00:00:00 作为默认值。可以考虑使用 1970-08-02 01:01:01 * **Case**: ```sql CREATE TABLE tbl( `id` bigint not null, `create_time` timestamp); ``` ## 为列指定了字符集 * **Item**:COL.014 * **Severity**:L5 * **Content**:建议列与表使用同一个字符集,不要单独指定列的字符集。 * **Case**: ```sql CREATE TABLE `tb2` ( `id` int(11) DEFAULT NULL, `col` char(10) CHARACTER SET utf8 DEFAULT NULL) ``` ## TEXT、BLOB 和 JSON 类型的字段不可指定非 NULL 的默认值 * **Item**:COL.015 * **Severity**:L4 * **Content**:MySQL 数据库中 TEXT、BLOB 和 JSON 类型的字段不可指定非 NULL 的默认值。TEXT最大长度为2^16-1个字符,MEDIUMTEXT最大长度为2^32-1个字符,LONGTEXT最大长度为2^64-1个字符。 * **Case**: ```sql CREATE TABLE `tbl` (`c` blob DEFAULT NULL); ``` ## 整型定义建议采用 INT(10) 或 BIGINT(20) * **Item**:COL.016 * **Severity**:L1 * **Content**:INT(M) 在 integer 数据类型中,M 表示最大显示宽度。 在 INT(M) 中,M 的值跟 INT(M) 所占多少存储空间并无任何关系。 INT(3)、INT(4)、INT(8) 在磁盘上都是占用 4 bytes 的存储空间。高版本 MySQL 已经不推荐设置整数显示宽度。 * **Case**: ```sql CREATE TABLE tab (a INT(1)); ``` ## VARCHAR 定义长度过长 * **Item**:COL.017 * **Severity**:L2 * **Content**:varchar 是可变长字符串,不预先分配存储空间,长度不要超过1024,如果存储长度过长 MySQL 将定义字段类型为 text,独立出来一张表,用主键来对应,避免影响其它字段索引效率。 * **Case**: ```sql CREATE TABLE tab (a varchar(3500)); ``` ## 建表语句中使用了不推荐的字段类型 * **Item**:COL.018 * **Severity**:L9 * **Content**:以下字段类型不被推荐使用:boolean * **Case**: ```sql CREATE TABLE tab (a BOOLEAN); ``` ## 不建议使用精度在秒级以下的时间数据类型 * **Item**:COL.019 * **Severity**:L1 * **Content**:使用高精度的时间数据类型带来的存储空间消耗相对较大;MySQL 在5.6.4以上才可以支持精确到微秒的时间数据类型,使用时需要考虑版本兼容问题。 * **Case**: ```sql CREATE TABLE t1 (t TIME(3), dt DATETIME(6)); ``` ## 消除不必要的 DISTINCT 条件 * **Item**:DIS.001 * **Severity**:L1 * **Content**:太多DISTINCT条件是复杂的裹脚布式查询的症状。考虑将复杂查询分解成许多简单的查询,并减少DISTINCT条件的数量。如果主键列是列的结果集的一部分,则DISTINCT条件可能没有影响。 * **Case**: ```sql SELECT DISTINCT c.c_id,count(DISTINCT c.c_name),count(DISTINCT c.c_e),count(DISTINCT c.c_n),count(DISTINCT c.c_me),c.c_d FROM (select distinct id, name from B) as e WHERE e.country_id = c.country_id ``` ## COUNT(DISTINCT) 多列时结果可能和你预想的不同 * **Item**:DIS.002 * **Severity**:L3 * **Content**:COUNT(DISTINCT col) 计算该列除NULL之外的不重复行数,注意 COUNT(DISTINCT col, col2) 如果其中一列全为 NULL 那么即使另一列有不同的值,也返回0。 * **Case**: ```sql SELECT COUNT(DISTINCT col, col2) FROM tbl; ``` ## DISTINCT \* 对有主键的表没有意义 * **Item**:DIS.003 * **Severity**:L3 * **Content**:当表已经有主键时,对所有列进行 DISTINCT 的输出结果与不进行 DISTINCT 操作的结果相同,请不要画蛇添足。 * **Case**: ```sql SELECT DISTINCT * FROM film; ``` ## 避免在 WHERE 条件中使用函数或其他运算符 * **Item**:FUN.001 * **Severity**:L2 * **Content**:虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。 * **Case**: ```sql select id from t where substring(name,1,3)='abc' ``` ## 指定了 WHERE 条件或非 MyISAM 引擎时使用 COUNT(\*) 操作性能不佳 * **Item**:FUN.002 * **Severity**:L1 * **Content**:COUNT(\*) 的作用是统计表行数,COUNT(COL) 的作用是统计指定列非 NULL 的行数。MyISAM 表对于 COUNT(\*) 统计全表行数进行了特殊的优化,通常情况下非常快。但对于非 MyISAM 表或指定了某些 WHERE 条件,COUNT(\*) 操作需要扫描大量的行才能获取精确的结果,性能也因此不佳。有时候某些业务场景并不需要完全精确的 COUNT 值,此时可以用近似值来代替。EXPLAIN 出来的优化器估算的行数就是一个不错的近似值,执行 EXPLAIN 并不需要真正去执行查询,所以成本很低。 * **Case**: ```sql SELECT c3, COUNT(*) AS accounts FROM tab where c2 < 10000 GROUP BY c3 ORDER BY num ``` ## 使用了合并为可空列的字符串连接 * **Item**:FUN.003 * **Severity**:L3 * **Content**:在一些查询请求中,您需要强制让某一列或者某个表达式返回非 NULL 的值,从而让查询逻辑变得更简单,但又不想将这个值存下来。可以使用 COALESCE() 函数来构造连接的表达式,这样即使是空值列也不会使整表达式变为 NULL。 * **Case**: ```sql select c1 || coalesce(' ' || c2 || ' ', ' ') || c3 as c from tbl ``` ## 不建议使用 SYSDATE() 函数 * **Item**:FUN.004 * **Severity**:L4 * **Content**:SYSDATE() 函数可能导致主从数据不一致,请使用 NOW() 函数替代 SYSDATE()。 * **Case**: ```sql SELECT SYSDATE(); ``` ## 不建议使用 COUNT(col) 或 COUNT(常量) * **Item**:FUN.005 * **Severity**:L1 * **Content**:不要使用 COUNT(col) 或 COUNT(常量) 来替代 COUNT(\*), COUNT(\*) 是 SQL92 定义的标准统计行数的方法,跟数据无关,跟 NULL 和非 NULL 也无关。 * **Case**: ```sql SELECT COUNT(1) FROM tbl; ``` ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item**:FUN.006 * **Severity**:L1 * **Content**:当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl * **Case**: ```sql SELECT SUM(COL) FROM tbl; ``` ## 不建议使用触发器 * **Item**:FUN.007 * **Severity**:L1 * **Content**:触发器的执行没有反馈和日志,隐藏了实际的执行步骤,当数据库出现问题是,不能通过慢日志分析触发器的具体执行情况,不易发现问题。在MySQL中,触发器不能临时关闭或打开,在数据迁移或数据恢复等场景下,需要临时drop触发器,可能影响到生产环境。 * **Case**: ```sql CREATE TRIGGER t1 AFTER INSERT ON work FOR EACH ROW INSERT INTO time VALUES(NOW()); ``` ## 不建议使用存储过程 * **Item**:FUN.008 * **Severity**:L1 * **Content**:存储过程无版本控制,配合业务的存储过程升级很难做到业务无感知。存储过程在拓展和移植上也存在问题。 * **Case**: ```sql CREATE PROCEDURE simpleproc (OUT param1 INT); ``` ## 不建议使用自定义函数 * **Item**:FUN.009 * **Severity**:L1 * **Content**:不建议使用自定义函数 * **Case**: ```sql CREATE FUNCTION hello (s CHAR(20)); ``` ## 不建议对等值查询列使用 GROUP BY * **Item**:GRP.001 * **Severity**:L2 * **Content**:GROUP BY 中的列在前面的 WHERE 条件中使用了等值查询,对这样的列进行 GROUP BY 意义不大。 * **Case**: ```sql select film_id, title from film where release_year='2006' group by release_year ``` ## JOIN 语句混用逗号和 ANSI 模式 * **Item**:JOI.001 * **Severity**:L2 * **Content**:表连接的时候混用逗号和 ANSI JOIN 不便于人类理解,并且MySQL不同版本的表连接行为和优先级均有所不同,当 MySQL 版本变化后可能会引入错误。 * **Case**: ```sql select c1,c2,c3 from t1,t2 join t3 on t1.c1=t2.c1,t1.c3=t3,c1 where id>1000 ``` ## 同一张表被连接两次 * **Item**:JOI.002 * **Severity**:L4 * **Content**:相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。 * **Case**: ```sql select tb1.col from (tb1, tb2) join tb2 on tb1.id=tb.id where tb1.id=1 ``` ## OUTER JOIN 失效 * **Item**:JOI.003 * **Severity**:L4 * **Content**:由于 WHERE 条件错误使得 OUTER JOIN 的外部表无数据返回,这会将查询隐式转换为 INNER JOIN 。如:select c from L left join R using(c) where L.a=5 and R.b=10。这种 SQL 逻辑上可能存在错误或程序员对 OUTER JOIN 如何工作存在误解,因为 LEFT/RIGHT JOIN 是 LEFT/RIGHT OUTER JOIN 的缩写。 * **Case**: ```sql select c1,c2,c3 from t1 left outer join t2 using(c1) where t1.c2=2 and t2.c3=4 ``` ## 不建议使用排它 JOIN * **Item**:JOI.004 * **Severity**:L4 * **Content**:只在右侧表为 NULL 的带 WHERE 子句的 LEFT OUTER JOIN 语句,有可能是在WHERE子句中使用错误的列,如:“... FROM l LEFT OUTER JOIN r ON l.l = r.r WHERE r.z IS NULL”,这个查询正确的逻辑可能是 WHERE r.r IS NULL。 * **Case**: ```sql select c1,c2,c3 from t1 left outer join t2 on t1.c1=t2.c1 where t2.c2 is null ``` ## 减少 JOIN 的数量 * **Item**:JOI.005 * **Severity**:L2 * **Content**:太多的 JOIN 是复杂的裹脚布式查询的症状。考虑将复杂查询分解成许多简单的查询,并减少 JOIN 的数量。 * **Case**: ```sql select bp1.p_id, b1.d_d as l, b1.b_id from b1 join bp1 on (b1.b_id = bp1.b_id) left outer join (b1 as b2 join bp2 on (b2.b_id = bp2.b_id)) on (bp1.p_id = bp2.p_id ) join bp21 on (b1.b_id = bp1.b_id) join bp31 on (b1.b_id = bp1.b_id) join bp41 on (b1.b_id = bp1.b_id) where b2.b_id = 0 ``` ## 将嵌套查询重写为 JOIN 通常会导致更高效的执行和更有效的优化 * **Item**:JOI.006 * **Severity**:L4 * **Content**:一般来说,非嵌套子查询总是用于关联子查询,最多是来自FROM子句中的一个表,这些子查询用于 ANY, ALL 和 EXISTS 的谓词。如果可以根据查询语义决定子查询最多返回一个行,那么一个不相关的子查询或来自FROM子句中的多个表的子查询就被压平了。 * **Case**: ```sql SELECT s,p,d FROM tbl WHERE p.p_id = (SELECT s.p_id FROM tbl WHERE s.c_id = 100996 AND s.q = 1 ) ``` ## 不建议使用联表删除或更新 * **Item**:JOI.007 * **Severity**:L4 * **Content**:当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 * **Case**: ```sql UPDATE users u LEFT JOIN hobby h ON u.id = h.uid SET u.name = 'pianoboy' WHERE h.hobby = 'piano'; ``` ## 不要使用跨数据库的 JOIN 查询 * **Item**:JOI.008 * **Severity**:L4 * **Content**:一般来说,跨数据库的 JOIN 查询意味着查询语句跨越了两个不同的子系统,这可能意味着系统耦合度过高或库表结构设计不合理。 * **Case**: ```sql SELECT s,p,d FROM tbl WHERE p.p_id = (SELECT s.p_id FROM tbl WHERE s.c_id = 100996 AND s.q = 1 ) ``` ## 建议使用自增列作为主键,如使用联合自增主键时请将自增键作为第一列 * **Item**:KEY.001 * **Severity**:L2 * **Content**:建议使用自增列作为主键,如使用联合自增主键时请将自增键作为第一列 * **Case**: ```sql create table test(`id` int(11) NOT NULL PRIMARY KEY (`id`)) ``` ## 无主键或唯一键,无法在线变更表结构 * **Item**:KEY.002 * **Severity**:L4 * **Content**:无主键或唯一键,无法在线变更表结构 * **Case**: ```sql create table test(col varchar(5000)) ``` ## 避免外键等递归关系 * **Item**:KEY.003 * **Severity**:L4 * **Content**:存在递归关系的数据很常见,数据常会像树或者以层级方式组织。然而,创建一个外键约束来强制执行同一表中两列之间的关系,会导致笨拙的查询。树的每一层对应着另一个连接。您将需要发出递归查询,以获得节点的所有后代或所有祖先。解决方案是构造一个附加的闭包表。它记录了树中所有节点间的关系,而不仅仅是那些具有直接的父子关系。您也可以比较不同层次的数据设计:闭包表,路径枚举,嵌套集。然后根据应用程序的需要选择一个。 * **Case**: ```sql CREATE TABLE tab2 (p_id BIGINT UNSIGNED NOT NULL,a_id BIGINT UNSIGNED NOT NULL,PRIMARY KEY (p_id, a_id),FOREIGN KEY (p_id) REFERENCES tab1(p_id),FOREIGN KEY (a_id) REFERENCES tab3(a_id)) ``` ## 提醒:请将索引属性顺序与查询对齐 * **Item**:KEY.004 * **Severity**:L0 * **Content**:如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。 * **Case**: ```sql create index idx1 on tbl (last_name,first_name) ``` ## 表建的索引过多 * **Item**:KEY.005 * **Severity**:L2 * **Content**:表建的索引过多 * **Case**: ```sql CREATE TABLE tbl ( a int, b int, c int, KEY idx_a (`a`),KEY idx_b(`b`),KEY idx_c(`c`)); ``` ## 主键中的列过多 * **Item**:KEY.006 * **Severity**:L4 * **Content**:主键中的列过多 * **Case**: ```sql CREATE TABLE tbl ( a int, b int, c int, PRIMARY KEY(`a`,`b`,`c`)); ``` ## 未指定主键或主键非 int 或 bigint * **Item**:KEY.007 * **Severity**:L4 * **Content**:未指定主键或主键非 int 或 bigint,建议将主键设置为 int unsigned 或 bigint unsigned。 * **Case**: ```sql CREATE TABLE tbl (a int); ``` ## ORDER BY 多个列但排序方向不同时可能无法使用索引 * **Item**:KEY.008 * **Severity**:L4 * **Content**:在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。 * **Case**: ```sql SELECT * FROM tbl ORDER BY a DESC, b ASC; ``` ## 添加唯一索引前请注意检查数据唯一性 * **Item**:KEY.009 * **Severity**:L0 * **Content**:请提前检查添加唯一索引列的数据唯一性,如果数据不唯一在线表结构调整时将有可能自动将重复列删除,这有可能导致数据丢失。 * **Case**: ```sql CREATE UNIQUE INDEX part_of_name ON customer (name(10)); ``` ## 全文索引不是银弹 * **Item**:KEY.010 * **Severity**:L0 * **Content**:全文索引主要用于解决模糊查询的性能问题,但需要控制好查询的频率和并发度。同时注意调整 ft\_min\_word\_len, ft\_max\_word\_len, ngram\_token\_size 等参数。 * **Case**: ```sql CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `ip` varchar(255) NOT NULL DEFAULT '', PRIMARY KEY (`id`), FULLTEXT KEY `ip` (`ip`) ) ENGINE=InnoDB; ``` ## SQL\_CALC\_FOUND\_ROWS 效率低下 * **Item**:KWR.001 * **Severity**:L2 * **Content**:因为 SQL\_CALC\_FOUND\_ROWS 不能很好地扩展,所以可能导致性能问题; 建议业务使用其他策略来替代 SQL\_CALC\_FOUND\_ROWS 提供的计数功能,比如:分页结果展示等。 * **Case**: ```sql select SQL_CALC_FOUND_ROWS col from tbl where id>1000 ``` ## 不建议使用 MySQL 关键字做列名或表名 * **Item**:KWR.002 * **Severity**:L2 * **Content**:当使用关键字做为列名或表名时程序需要对列名和表名进行转义,如果疏忽被将导致请求无法执行。 * **Case**: ```sql CREATE TABLE tbl ( `select` int ) ``` ## 不建议使用复数做列名或表名 * **Item**:KWR.003 * **Severity**:L1 * **Content**:表名应该仅仅表示表里面的实体内容,不应该表示实体数量,对应于 DO 类名也是单数形式,符合表达习惯。 * **Case**: ```sql CREATE TABLE tbl ( `books` int ) ``` ## 不建议使用使用多字节编码字符(中文)命名 * **Item**:KWR.004 * **Severity**:L1 * **Content**:为库、表、列、别名命名时建议使用英文,数字,下划线等字符,不建议使用中文或其他多字节编码字符。 * **Case**: ```sql select col as 列 from tb ``` ## SQL 中包含 unicode 特殊字符 * **Item**:KWR.005 * **Severity**:L1 * **Content**:部分 IDE 会自动在 SQL 插入肉眼不可见的 unicode 字符。如:non-break space, zero-width space 等。Linux 下可使用 \`cat -A file.sql\` 命令查看不可见字符。 * **Case**: ```sql update tb set status = 1 where id = 1; ``` ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item**:LCK.001 * **Severity**:L3 * **Content**:INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Case**: ```sql INSERT INTO tbl SELECT * FROM tbl2; ``` ## 请慎用 INSERT ON DUPLICATE KEY UPDATE * **Item**:LCK.002 * **Severity**:L3 * **Content**:当主键为自增键时使用 INSERT ON DUPLICATE KEY UPDATE 可能会导致主键出现大量不连续快速增长,导致主键快速溢出无法继续写入。极端情况下还有可能导致主从数据不一致。 * **Case**: ```sql INSERT INTO t1(a,b,c) VALUES (1,2,3) ON DUPLICATE KEY UPDATE c=c+1; ``` ## 用字符类型存储IP地址 * **Item**:LIT.001 * **Severity**:L2 * **Content**:字符串字面上看起来像IP地址,但不是 INET\_ATON() 的参数,表示数据被存储为字符而不是整数。将IP地址存储为整数更为有效。 * **Case**: ```sql insert into tbl (IP,name) values('10.20.306.122','test') ``` ## 日期/时间未使用引号括起 * **Item**:LIT.002 * **Severity**:L4 * **Content**:诸如“WHERE col <2010-02-12”之类的查询是有效的SQL,但可能是一个错误,因为它将被解释为“WHERE col <1996”; 日期/时间文字应该加引号,且引号前后不应有空格。 * **Case**: ```sql select col1,col2 from tbl where time < 2018-01-10 ``` ## 一列中存储一系列相关数据的集合 * **Item**:LIT.003 * **Severity**:L3 * **Content**:将 ID 存储为一个列表,作为 VARCHAR/TEXT 列,这样能导致性能和数据完整性问题。查询这样的列需要使用模式匹配的表达式。使用逗号分隔的列表来做多表联结查询定位一行数据是极不优雅和耗时的。这将使验证 ID 更加困难。考虑一下,列表最多支持存放多少数据呢?将 ID 存储在一张单独的表中,代替使用多值属性,从而每个单独的属性值都可以占据一行。这样交叉表实现了两张表之间的多对多关系。这将更好地简化查询,也更有效地验证ID。 * **Case**: ```sql select c1,c2,c3,c4 from tab1 where col_id REGEXP '[[:<:]]12[[:>:]]' ``` ## 请使用分号或已设定的 DELIMITER 结尾 * **Item**:LIT.004 * **Severity**:L1 * **Content**:USE database, SHOW DATABASES 等命令也需要使用使用分号或已设定的 DELIMITER 结尾。 * **Case**: ```sql USE db ``` ## 非确定性的 GROUP BY * **Item**:RES.001 * **Severity**:L4 * **Content**:SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 * **Case**: ```sql select c1,c2,c3 from t1 where c2='foo' group by c2 ``` ## 未使用 ORDER BY 的 LIMIT 查询 * **Item**:RES.002 * **Severity**:L4 * **Content**:没有 ORDER BY 的 LIMIT 会导致非确定性的结果,这取决于查询执行计划。 * **Case**: ```sql select col1,col2 from tbl where name=xx limit 10 ``` ## UPDATE/DELETE 操作使用了 LIMIT 条件 * **Item**:RES.003 * **Severity**:L4 * **Content**:UPDATE/DELETE 操作使用 LIMIT 条件和不添加 WHERE 条件一样危险,它可将会导致主从数据不一致或从库同步中断。 * **Case**: ```sql UPDATE film SET length = 120 WHERE title = 'abc' LIMIT 1; ``` ## UPDATE/DELETE 操作指定了 ORDER BY 条件 * **Item**:RES.004 * **Severity**:L4 * **Content**:UPDATE/DELETE 操作不要指定 ORDER BY 条件。 * **Case**: ```sql UPDATE film SET length = 120 WHERE title = 'abc' ORDER BY title ``` ## UPDATE 语句可能存在逻辑错误,导致数据损坏 * **Item**:RES.005 * **Severity**:L4 * **Content**:在一条 UPDATE 语句中,如果要更新多个字段,字段间不能使用 AND ,而应该用逗号分隔。 * **Case**: ```sql update tbl set col = 1 and cl = 2 where col=3; ``` ## 永远不真的比较条件 * **Item**:RES.006 * **Severity**:L4 * **Content**:查询条件永远非真,如果该条件出现在 where 中可能导致查询无匹配到的结果。 * **Case**: ```sql select * from tbl where 1 != 1; ``` ## 永远为真的比较条件 * **Item**:RES.007 * **Severity**:L4 * **Content**:查询条件永远为真,可能导致 WHERE 条件失效进行全表查询。 * **Case**: ```sql select * from tbl where 1 = 1; ``` ## 不建议使用LOAD DATA/SELECT ... INTO OUTFILE * **Item**:RES.008 * **Severity**:L2 * **Content**:SELECT INTO OUTFILE 需要授予 FILE 权限,这通过会引入安全问题。LOAD DATA 虽然可以提高数据导入速度,但同时也可能导致从库同步延迟过大。 * **Case**: ```sql LOAD DATA INFILE 'data.txt' INTO TABLE db2.my_table; ``` ## 不建议使用连续判断 * **Item**:RES.009 * **Severity**:L2 * **Content**:类似这样的 SELECT \* FROM tbl WHERE col = col = 'abc' 语句可能是书写错误,您可能想表达的含义是 col = 'abc'。如果确实是业务需求建议修改为 col = col and col = 'abc'。 * **Case**: ```sql SELECT * FROM tbl WHERE col = col = 'abc' ``` ## 建表语句中定义为 ON UPDATE CURRENT\_TIMESTAMP 的字段不建议包含业务逻辑 * **Item**:RES.010 * **Severity**:L2 * **Content**:定义为 ON UPDATE CURRENT\_TIMESTAMP 的字段在该表其他字段更新时会联动修改,如果包含业务逻辑用户可见会埋下隐患。后续如有批量修改数据却又不想修改该字段时会导致数据错误。 * **Case**: ```sql CREATE TABLE category (category_id TINYINT UNSIGNED NOT NULL AUTO_INCREMENT, name VARCHAR(25) NOT NULL, last_update TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (category_id) ``` ## 更新请求操作的表包含 ON UPDATE CURRENT\_TIMESTAMP 字段 * **Item**:RES.011 * **Severity**:L2 * **Content**:定义为 ON UPDATE CURRENT\_TIMESTAMP 的字段在该表其他字段更新时会联动修改,请注意检查。如不想修改字段的更新时间可以使用如下方法:UPDATE category SET name='ActioN', last\_update=last\_update WHERE category\_id=1 * **Case**: ```sql UPDATE category SET name='ActioN', last_update=last_update WHERE category_id=1 ``` ## 请谨慎使用TRUNCATE操作 * **Item**:SEC.001 * **Severity**:L0 * **Content**:一般来说想清空一张表最快速的做法就是使用TRUNCATE TABLE tbl\_name;语句。但TRUNCATE操作也并非是毫无代价的,TRUNCATE TABLE无法返回被删除的准确行数,如果需要返回被删除的行数建议使用DELETE语法。TRUNCATE 操作还会重置 AUTO\_INCREMENT,如果不想重置该值建议使用 DELETE FROM tbl\_name WHERE 1;替代。TRUNCATE 操作会对数据字典添加源数据锁(MDL),当一次需要 TRUNCATE 很多表时会影响整个实例的所有请求,因此如果要 TRUNCATE 多个表建议用 DROP+CREATE 的方式以减少锁时长。 * **Case**: ```sql TRUNCATE TABLE tbl_name ``` ## 不使用明文存储密码 * **Item**:SEC.002 * **Severity**:L0 * **Content**:使用明文存储密码或者使用明文在网络上传递密码都是不安全的。如果攻击者能够截获您用来插入密码的SQL语句,他们就能直接读到密码。另外,将用户输入的字符串以明文的形式插入到纯SQL语句中,也会让攻击者发现它。如果您能够读取密码,黑客也可以。解决方案是使用单向哈希函数对原始密码进行加密编码。哈希是指将输入字符串转化成另一个新的、不可识别的字符串的函数。对密码加密表达式加点随机串来防御“字典攻击”。不要将明文密码输入到SQL查询语句中。在应用程序代码中计算哈希串,只在SQL查询中使用哈希串。 * **Case**: ```sql create table test(id int,name varchar(20) not null,password varchar(200)not null) ``` ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item**:SEC.003 * **Severity**:L0 * **Content**:在执行高危操作之前对数据进行备份是十分有必要的。 * **Case**: ```sql delete from table where col = 'condition' ``` ## 发现常见 SQL 注入函数 * **Item**:SEC.004 * **Severity**:L0 * **Content**:SLEEP(), BENCHMARK(), GET\_LOCK(), RELEASE\_LOCK() 等函数通常出现在 SQL 注入语句中,会严重影响数据库性能。 * **Case**: ```sql SELECT BENCHMARK(10, RAND()) ``` ## '!=' 运算符是非标准的 * **Item**:STA.001 * **Severity**:L0 * **Content**:"<>"才是标准SQL中的不等于运算符。 * **Case**: ```sql select col1,col2 from tbl where type!=0 ``` ## 库名或表名点后建议不要加空格 * **Item**:STA.002 * **Severity**:L1 * **Content**:当使用 db.table 或 table.column 格式访问表或字段时,请不要在点号后面添加空格,虽然这样语法正确。 * **Case**: ```sql select col from sakila. film ``` ## 索引起名不规范 * **Item**:STA.003 * **Severity**:L1 * **Content**:建议普通二级索引以idx\_为前缀,唯一索引以uk\_为前缀。 * **Case**: ```sql select col from now where type!=0 ``` ## 起名时请不要使用字母、数字和下划线之外的字符 * **Item**:STA.004 * **Severity**:L1 * **Content**:以字母或下划线开头,名字只允许使用字母、数字和下划线。请统一大小写,不要使用驼峰命名法。不要在名字中出现连续下划线'\_\_',这样很难辨认。 * **Case**: ```sql CREATE TABLE ` abc` (a int); ``` ## MySQL 对子查询的优化效果不佳 * **Item**:SUB.001 * **Severity**:L4 * **Content**:MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 * **Case**: ```sql select col1,col2,col3 from table1 where col2 in(select col from table2) ``` ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item**:SUB.002 * **Severity**:L2 * **Content**:与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 * **Case**: ```sql select teacher_id as id,people_name as name from t1,t2 where t1.teacher_id=t2.people_id union select student_id as id,people_name as name from t1,t2 where t1.student_id=t2.people_id ``` ## 考虑使用 EXISTS 而不是 DISTINCT 子查询 * **Item**:SUB.003 * **Severity**:L3 * **Content**:DISTINCT 关键字在对元组排序后删除重复。相反,考虑使用一个带有 EXISTS 关键字的子查询,您可以避免返回整个表。 * **Case**: ```sql SELECT DISTINCT c.c_id, c.c_name FROM c,e WHERE e.c_id = c.c_id ``` ## 执行计划中嵌套连接深度过深 * **Item**:SUB.004 * **Severity**:L3 * **Content**:MySQL对子查询的优化效果不佳,MySQL将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。 * **Case**: ```sql SELECT * from tb where id in (select id from (select id from tb)) ``` ## 子查询不支持LIMIT * **Item**:SUB.005 * **Severity**:L8 * **Content**:当前 MySQL 版本不支持在子查询中进行 'LIMIT & IN/ALL/ANY/SOME'。 * **Case**: ```sql SELECT * FROM staff WHERE name IN (SELECT NAME FROM customer ORDER BY name LIMIT 1) ``` ## 不建议在子查询中使用函数 * **Item**:SUB.006 * **Severity**:L2 * **Content**:MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。 * **Case**: ```sql SELECT * FROM staff WHERE name IN (SELECT max(NAME) FROM customer) ``` ## 外层带有 LIMIT 输出限制的 UNION 联合查询,其内层查询建议也添加 LIMIT 输出限制 * **Item**:SUB.007 * **Severity**:L2 * **Content**:有时 MySQL 无法将限制条件从外层“下推”到内层,这会使得原本可以限制能够限制部分返回结果的条件无法应用到内层查询的优化上。比如:(SELECT \* FROM tb1 ORDER BY name) UNION ALL (SELECT \* FROM tb2 ORDER BY name) LIMIT 20; MySQL 会将两个子查询的结果放在一个临时表中,然后取出 20 条结果,可以通过在两个子查询中添加 LIMIT 20 来减少临时表中的数据。(SELECT \* FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT \* FROM tb2 ORDER BY name LIMIT 20) LIMIT 20; * **Case**: ```sql (SELECT * FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT * FROM tb2 ORDER BY name LIMIT 20) LIMIT 20; ``` ## 不建议使用分区表 * **Item**:TBL.001 * **Severity**:L4 * **Content**:不建议使用分区表 * **Case**: ```sql CREATE TABLE trb3(id INT, name VARCHAR(50), purchased DATE) PARTITION BY RANGE(YEAR(purchased)) (PARTITION p0 VALUES LESS THAN (1990), PARTITION p1 VALUES LESS THAN (1995), PARTITION p2 VALUES LESS THAN (2000), PARTITION p3 VALUES LESS THAN (2005) ); ``` ## 请为表选择合适的存储引擎 * **Item**:TBL.002 * **Severity**:L4 * **Content**:建表或修改表的存储引擎时建议使用推荐的存储引擎,如:innodb * **Case**: ```sql create table test(`id` int(11) NOT NULL AUTO_INCREMENT) ``` ## 以DUAL命名的表在数据库中有特殊含义 * **Item**:TBL.003 * **Severity**:L8 * **Content**:DUAL表为虚拟表,不需要创建即可使用,也不建议服务以DUAL命名表。 * **Case**: ```sql create table dual(id int, primary key (id)); ``` ## 表的初始AUTO\_INCREMENT值不为0 * **Item**:TBL.004 * **Severity**:L2 * **Content**:AUTO\_INCREMENT不为0会导致数据空洞。 * **Case**: ```sql CREATE TABLE tbl (a int) AUTO_INCREMENT = 10; ``` ## 请使用推荐的字符集 * **Item**:TBL.005 * **Severity**:L4 * **Content**:表字符集只允许设置为'utf8,utf8mb4' * **Case**: ```sql CREATE TABLE tbl (a int) DEFAULT CHARSET = latin1; ``` ## 不建议使用视图 * **Item**:TBL.006 * **Severity**:L1 * **Content**:不建议使用视图 * **Case**: ```sql create view v_today (today) AS SELECT CURRENT_DATE; ``` ## 不建议使用临时表 * **Item**:TBL.007 * **Severity**:L1 * **Content**:不建议使用临时表 * **Case**: ```sql CREATE TEMPORARY TABLE `work` (`time` time DEFAULT NULL) ENGINE=InnoDB; ``` ## 请使用推荐的COLLATE * **Item**:TBL.008 * **Severity**:L4 * **Content**:COLLATE 只允许设置为'' * **Case**: ```sql CREATE TABLE tbl (a int) DEFAULT COLLATE = latin1_bin; ``` ================================================ FILE: advisor/testdata/TestListTestSQLs.golden ================================================ SELECT * FROM film WHERE length = 86; SELECT * FROM film WHERE length IS NULL; SELECT * FROM film HAVING title = 'abc'; SELECT * FROM sakila.film WHERE length >= 60; SELECT * FROM sakila.film WHERE length >= '60'; SELECT * FROM film WHERE length BETWEEN 60 AND 84; SELECT * FROM film WHERE title LIKE 'AIR%'; SELECT * FROM film WHERE title IS NOT NULL; SELECT * FROM film WHERE length = 114 and title = 'ALABAMA DEVIL'; SELECT * FROM film WHERE length > 100 and title = 'ALABAMA DEVIL'; SELECT * FROM film WHERE length > 100 and language_id < 10 and title = 'xyz'; SELECT * FROM film WHERE length > 100 and language_id < 10; SELECT release_year, sum(length) FROM film WHERE length = 123 AND language_id = 1 GROUP BY release_year; SELECT release_year, sum(length) FROM film WHERE length >= 123 GROUP BY release_year; SELECT release_year, language_id, sum(length) FROM film GROUP BY release_year, language_id; SELECT release_year, sum(length) FROM film WHERE length = 123 GROUP BY release_year,(length+language_id); SELECT release_year, sum(film_id) FROM film GROUP BY release_year; SELECT * FROM address GROUP BY address,district; SELECT title FROM film WHERE ABS(language_id) = 3 GROUP BY title; SELECT language_id FROM film WHERE length = 123 GROUP BY release_year ORDER BY language_id; SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year; SELECT * FROM film WHERE length = 123 ORDER BY release_year ASC, language_id DESC; SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year LIMIT 10; SELECT * FROM film WHERE length = 123 ORDER BY release_year LIMIT 10; SELECT * FROM film ORDER BY release_year LIMIT 10; SELECT film_id FROM film ORDER BY release_year LIMIT 10; SELECT * FROM film WHERE length > 100 ORDER BY length LIMIT 10; SELECT * FROM film WHERE length < 100 ORDER BY length LIMIT 10; SELECT * FROM customer WHERE address_id in (224,510) ORDER BY last_name; SELECT * FROM film WHERE release_year = 2016 AND length != 1 ORDER BY title; SELECT title FROM film WHERE release_year = 1995; SELECT title, replacement_cost FROM film WHERE language_id = 5 AND length = 70; SELECT title FROM film WHERE language_id > 5 AND length > 70; SELECT * FROM film WHERE length = 100 and title = 'xyz' ORDER BY release_year; SELECT * FROM film WHERE length > 100 and title = 'xyz' ORDER BY release_year; SELECT * FROM film WHERE length > 100 ORDER BY release_year; SELECT * FROM city a INNER JOIN country b ON a.country_id=b.country_id; SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id; SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id; SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL; SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL; SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id; SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL; SELECT country_id, last_update FROM city NATURAL JOIN country; SELECT country_id, last_update FROM city NATURAL LEFT JOIN country; SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country; SELECT a.country_id, a.last_update FROM city a STRAIGHT_JOIN country b ON a.country_id=b.country_id; SELECT a.address, a.postal_code FROM sakila.address a WHERE a.city_id IN (SELECT c.city_id FROM sakila.city c); SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I.city_id = city.city_id) JOIN country ON (country.country_id = city.country_id) ORDER BY city DESC; DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1; DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL; DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id; DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id; DELETE FROM film WHERE length > 100; UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10; UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10; UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10; UPDATE film SET length = 10 WHERE language_id = 20; INSERT INTO city (country_id) SELECT country_id FROM country; INSERT INTO city (country_id) VALUES (1),(2),(3); INSERT INTO city (country_id) VALUES (10); INSERT INTO city (country_id) SELECT 10 FROM DUAL; REPLACE INTO city (country_id) SELECT country_id FROM country; REPLACE INTO city (country_id) VALUES (1),(2),(3); REPLACE INTO city (country_id) VALUES (10); REPLACE INTO city (country_id) SELECT 10 FROM DUAL; SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film; SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1); SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id; SELECT * FROM (SELECT * FROM actor WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE') t WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE' GROUP BY first_name; SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id; SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id WHERE o.country_id is null union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id WHERE i.city_id is null; SELECT first_name,last_name,email FROM customer STRAIGHT_JOIN address ON customer.address_id=address.address_id; SELECT ID,name FROM (SELECT address FROM customer_list WHERE SID=1 order by phone limit 50,10) a JOIN customer_list l ON (a.address=l.address) JOIN city c ON (c.city=l.city) order by phone desc; SELECT * FROM film WHERE date(last_update)='2006-02-15'; SELECT last_update FROM film GROUP BY date(last_update); SELECT last_update FROM film order by date(last_update); SELECT description FROM film WHERE description IN('NEWS','asd') GROUP BY description; alter table address add index idx_city_id(city_id); alter table inventory add index `idx_store_film` (`store_id`,`film_id`); alter table inventory add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`); SELECT DATE_FORMAT(t.last_update, '%Y-%m-%d'), COUNT(DISTINCT (t.city)) FROM city t WHERE t.last_update > '2018-10-22 00:00:00' AND t.city LIKE '%Chrome%' AND t.city = 'eip' GROUP BY DATE_FORMAT(t.last_update, '%Y-%m-%d') ORDER BY DATE_FORMAT(t.last_update, '%Y-%m-%d'); create table hello.t (id int unsigned); select * from tb where data >= ''; alter table tb alter column id drop default; select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film where last_update > '2016-03-27 02:01:01') as d; select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film) as d; ================================================ FILE: advisor/testdata/TestMergeConflictHeuristicRules.golden ================================================ advisor.Rule{Item:"ALI.001", Severity:"L0", Summary:"建议使用 AS 关键字显示声明一个别名", Content:"在列或表别名(如\"tbl AS alias\")中, 明确使用 AS 关键字比隐含别名(如\"tbl alias\")更易懂。", Case:"select name from tbl t1 where id < 1000", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ALI.002", Severity:"L8", Summary:"不建议给列通配符'*'设置别名", Content:"例: \"SELECT tbl.* col1, col2\"上面这条 SQL 给列通配符设置了别名,这样的SQL可能存在逻辑错误。您可能意在查询 col1, 但是代替它的是重命名的是 tbl 的最后一列。", Case:"select tbl.* as c1,c2,c3 from tbl where id < 1000", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ALI.003", Severity:"L1", Summary:"别名不要与表或列的名字相同", Content:"表或列的别名与其真实名称相同, 这样的别名会使得查询更难去分辨。", Case:"select name from tbl as tbl where id < 1000", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ALT.001", Severity:"L4", Summary:"修改表的默认字符集不会改表各个字段的字符集", Content:"很多初学者会将 ALTER TABLE tbl_name [DEFAULT] CHARACTER SET 'UTF8' 误认为会修改所有字段的字符集,但实际上它只会影响后续新增的字段不会改表已有字段的字符集。如果想修改整张表所有字段的字符集建议使用 ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name;", Case:"ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ALT.002", Severity:"L2", Summary:"同一张表的多条 ALTER 请求建议合为一条", Content:"每次表结构变更对线上服务都会产生影响,即使是能够通过在线工具进行调整也请尽量通过合并 ALTER 请求的试减少操作次数。", Case:"ALTER TABLE tbl ADD COLUMN col int, ADD INDEX idx_col (`col`);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ALT.003", Severity:"L0", Summary:"删除列为高危操作,操作前请注意检查业务逻辑是否还有依赖", Content:"如业务逻辑依赖未完全消除,列被删除后可能导致数据无法写入或无法查询到已删除列数据导致程序异常的情况。这种情况下即使通过备份数据回滚也会丢失用户请求写入的数据。", Case:"ALTER TABLE tbl DROP COLUMN col;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ALT.004", Severity:"L0", Summary:"删除主键和外键为高危操作,操作前请与 DBA 确认影响", Content:"主键和外键为关系型数据库中两种重要约束,删除已有约束会打破已有业务逻辑,操作前请业务开发与 DBA 确认影响,三思而行。", Case:"ALTER TABLE tbl DROP PRIMARY KEY;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.001", Severity:"L4", Summary:"不建议使用前项通配符查找", Content:"例如 \"%foo\",查询参数有一个前项通配符的情况无法使用已有索引。", Case:"select c1,c2,c3 from tbl where name like '%foo'", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.002", Severity:"L1", Summary:"没有通配符的 LIKE 查询", Content:"不包含通配符的 LIKE 查询可能存在逻辑错误,因为逻辑上它与等值查询相同。", Case:"select c1,c2,c3 from tbl where name like 'foo'", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.003", Severity:"L4", Summary:"参数比较包含隐式转换,无法使用索引", Content:"隐式类型转换有无法命中索引的风险,在高并发、大数据量的情况下,命不中索引带来的后果非常严重。", Case:"SELECT * FROM sakila.film WHERE length >= '60';", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.004", Severity:"L4", Summary:"IN (NULL)/NOT IN (NULL) 永远非真", Content:"正确的作法是 col IN ('val1', 'val2', 'val3') OR col IS NULL", Case:"SELECT * FROM tb WHERE col IN (NULL);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.006", Severity:"L1", Summary:"应尽量避免在 WHERE 子句中对字段进行 NULL 值判断", Content:"使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0;", Case:"select id from t where num is null", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.007", Severity:"L3", Summary:"避免使用模式匹配", Content:"性能问题是使用模式匹配操作符的最大缺点。使用 LIKE 或正则表达式进行模式匹配进行查询的另一个问题,是可能会返回意料之外的结果。最好的方案就是使用特殊的搜索引擎技术来替代 SQL,比如 Apache Lucene。另一个可选方案是将结果保存起来从而减少重复的搜索开销。如果一定要使用SQL,请考虑在 MySQL 中使用像 FULLTEXT 索引这样的第三方扩展。但更广泛地说,您不一定要使用SQL来解决所有问题。", Case:"select c_id,c2,c3 from tbl where c2 like 'test%'", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.008", Severity:"L1", Summary:"OR 查询索引列时请尽量使用 IN 谓词", Content:"IN-list 谓词可以用于索引检索,并且优化器可以对 IN-list 进行排序,以匹配索引的排序序列,从而获得更有效的检索。请注意,IN-list 必须只包含常量,或在查询块执行期间保持常量的值,例如外引用。", Case:"SELECT c1,c2,c3 FROM tbl WHERE c1 = 14 OR c1 = 17", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.009", Severity:"L1", Summary:"引号中的字符串开头或结尾包含空格", Content:"如果 VARCHAR 列的前后存在空格将可能引起逻辑问题,如在 MySQL 5.5中 'a' 和 'a ' 可能会在查询中被认为是相同的值。", Case:"SELECT 'abc '", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.010", Severity:"L1", Summary:"不要使用 hint,如:sql_no_cache, force index, ignore key, straight join等", Content:"hint 是用来强制 SQL 按照某个执行计划来执行,但随着数据量变化我们无法保证自己当初的预判是正确的。", Case:"SELECT * FROM t1 USE INDEX (i1) ORDER BY a;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.011", Severity:"L3", Summary:"不要使用负向查询,如:NOT IN/NOT LIKE", Content:"请尽量不要使用负向查询,这将导致全表扫描,对查询性能影响较大。", Case:"select id from t where num not in(1,2,3);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.012", Severity:"L2", Summary:"一次性 INSERT/REPLACE 的数据过多", Content:"单条 INSERT/REPLACE 语句批量插入大量数据性能较差,甚至可能导致从库同步延迟。为了提升性能,减少批量写入数据对从库同步延时的影响,建议采用分批次插入的方法。", Case:"INSERT INTO tb (a) VALUES (1), (2)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.013", Severity:"L0", Summary:"DDL 语句中使用了中文全角引号", Content:"DDL 语句中使用了中文全角引号“”或‘’,这可能是书写错误,请确认是否符合预期。", Case:"CREATE TABLE tb (a varchar(10) default '“”'", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"ARG.014", Severity:"L4", Summary:"IN 条件中存在列名,可能导致数据匹配范围扩大", Content:"如:delete from t where id in(1, 2, id) 可能会导致全表数据误删除。请仔细检查 IN 条件的正确性。", Case:"select id from t where id in(1, 2, id)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.001", Severity:"L4", Summary:"最外层 SELECT 未指定 WHERE 条件", Content:"SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。", Case:"select id from tbl", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.002", Severity:"L3", Summary:"不建议使用 ORDER BY RAND()", Content:"ORDER BY RAND() 是从结果集中检索随机行的一种非常低效的方法,因为它会对整个结果进行排序并丢弃其大部分数据。", Case:"select name from tbl where id < 1000 order by rand(number)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.003", Severity:"L2", Summary:"不建议使用带 OFFSET 的LIMIT 查询", Content:"使用 LIMIT 和 OFFSET 对结果集分页的复杂度是 O(n^2),并且会随着数据增大而导致性能问题。采用“书签”扫描的方法实现分页效率更高。", Case:"select c1,c2 from tbl where name=xx order by number limit 1 offset 20", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.004", Severity:"L2", Summary:"不建议对常量进行 GROUP BY", Content:"GROUP BY 1 表示按第一列进行 GROUP BY。如果在 GROUP BY 子句中使用数字,而不是表达式或列名称,当查询列顺序改变时,可能会导致问题。", Case:"select col1,col2 from tbl group by 1", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.005", Severity:"L2", Summary:"ORDER BY 常数列没有任何意义", Content:"SQL 逻辑上可能存在错误; 最多只是一个无用的操作,不会更改查询结果。", Case:"select id from test where id=1 order by id", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.006", Severity:"L4", Summary:"在不同的表中 GROUP BY 或 ORDER BY", Content:"这将强制使用临时表和 filesort,可能产生巨大性能隐患,并且可能消耗大量内存和磁盘上的临时空间。", Case:"select tb1.col, tb2.col from tb1, tb2 where id=1 group by tb1.col, tb2.col", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.008", Severity:"L2", Summary:"请为 GROUP BY 显示添加 ORDER BY 条件", Content:"默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。", Case:"select c1,c2,c3 from t1 where c1='foo' group by c2", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.009", Severity:"L2", Summary:"ORDER BY 的条件为表达式", Content:"当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。", Case:"select description from film where title ='ACADEMY DINOSAUR' order by length-language_id;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.010", Severity:"L2", Summary:"GROUP BY 的条件为表达式", Content:"当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。", Case:"select description from film where title ='ACADEMY DINOSAUR' GROUP BY length-language_id;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.011", Severity:"L1", Summary:"建议为表添加注释", Content:"为表添加注释能够使得表的意义更明确,从而为日后的维护带来极大的便利。", Case:"CREATE TABLE `test1` (`ID` bigint(20) NOT NULL AUTO_INCREMENT,`c1` varchar(128) DEFAULT NULL,PRIMARY KEY (`ID`)) ENGINE=InnoDB DEFAULT CHARSET=utf8", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.012", Severity:"L2", Summary:"将复杂的裹脚布式查询分解成几个简单的查询", Content:"SQL是一门极具表现力的语言,您可以在单个SQL查询或者单条语句中完成很多事情。但这并不意味着必须强制只使用一行代码,或者认为使用一行代码就搞定每个任务是个好主意。通过一个查询来获得所有结果的常见后果是得到了一个笛卡儿积。当查询中的两张表之间没有条件限制它们的关系时,就会发生这种情况。没有对应的限制而直接使用两张表进行联结查询,就会得到第一张表中的每一行和第二张表中的每一行的一个组合。每一个这样的组合就会成为结果集中的一行,最终您就会得到一个行数很多的结果集。重要的是要考虑这些查询很难编写、难以修改和难以调试。数据库查询请求的日益增加应该是预料之中的事。经理们想要更复杂的报告以及在用户界面上添加更多的字段。如果您的设计很复杂,并且是一个单一查询,要扩展它们就会很费时费力。不论对您还是项目来说,时间花在这些事情上面不值得。将复杂的意大利面条式查询分解成几个简单的查询。当您拆分一个复杂的SQL查询时,得到的结果可能是很多类似的查询,可能仅仅在数据类型上有所不同。编写所有的这些查询是很乏味的,因此,最好能够有个程序自动生成这些代码。SQL代码生成是一个很好的应用。尽管SQL支持用一行代码解决复杂的问题,但也别做不切实际的事情。", Case:"这是一条很长很长的 SQL,案例略。", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.013", Severity:"L3", Summary:"不建议使用 HAVING 子句", Content:"将查询的 HAVING 子句改写为 WHERE 中的查询条件,可以在查询处理期间使用索引。", Case:"SELECT s.c_id,count(s.c_id) FROM s where c = test GROUP BY s.c_id HAVING s.c_id <> '1660' AND s.c_id <> '2' order by s.c_id", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.014", Severity:"L2", Summary:"删除全表时建议使用 TRUNCATE 替代 DELETE", Content:"删除全表时建议使用 TRUNCATE 替代 DELETE", Case:"delete from tbl", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.015", Severity:"L4", Summary:"UPDATE 未指定 WHERE 条件", Content:"UPDATE 不指定 WHERE 条件一般是致命的,请您三思后行", Case:"update tbl set col=1", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"CLA.016", Severity:"L2", Summary:"不要 UPDATE 主键", Content:"主键是数据表中记录的唯一标识符,不建议频繁更新主键列,这将影响元数据统计信息进而影响正常的查询。", Case:"update tbl set col=1", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.001", Severity:"L1", Summary:"不建议使用 SELECT * 类型查询", Content:"当表结构变更时,使用 * 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。", Case:"select * from tbl where id=1", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.002", Severity:"L2", Summary:"INSERT/REPLACE 未指定列名", Content:"当表结构发生变更,如果 INSERT 或 REPLACE 请求不明确指定列名,请求的结果将会与预想的不同; 建议使用 “INSERT INTO tbl(col1,col2)VALUES ...” 代替。", Case:"insert into tbl values(1,'name')", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.003", Severity:"L2", Summary:"建议修改自增 ID 为无符号类型", Content:"建议修改自增 ID 为无符号类型", Case:"create table test(`id` int(11) NOT NULL AUTO_INCREMENT)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.004", Severity:"L1", Summary:"请为列添加默认值", Content:"请为列添加默认值,如果是 ALTER 操作,请不要忘记将原字段的默认值写上。字段无默认值,当表较大时无法在线变更表结构。", Case:"CREATE TABLE tbl (col int) ENGINE=InnoDB;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.005", Severity:"L1", Summary:"列未添加注释", Content:"建议对表中每个列添加注释,来明确每个列在表中的含义及作用。", Case:"CREATE TABLE tbl (col int) ENGINE=InnoDB;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.006", Severity:"L3", Summary:"表中包含有太多的列", Content:"表中包含有太多的列", Case:"CREATE TABLE tbl ( cols ....);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.007", Severity:"L3", Summary:"表中包含有太多的 text/blob 列", Content:"表中包含超过2个的 text/blob 列", Case:"CREATE TABLE tbl ( cols ....);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.008", Severity:"L1", Summary:"可使用 VARCHAR 代替 CHAR, VARBINARY 代替 BINARY", Content:"为首先变长字段存储空间小,可以节省存储空间。其次对于查询来说,在一个相对较小的字段内搜索效率显然要高些。", Case:"create table t1(id int,name char(20),last_time date)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.009", Severity:"L2", Summary:"建议使用精确的数据类型", Content:"实际上,任何使用 FLOAT, REAL 或 DOUBLE PRECISION 数据类型的设计都有可能是反模式。大多数应用程序使用的浮点数的取值范围并不需要达到IEEE 754标准所定义的最大/最小区间。在计算总量时,非精确浮点数所积累的影响是严重的。使用 SQL 中的 NUMERIC 或 DECIMAL 类型来代替 FLOAT 及其类似的数据类型进行固定精度的小数存储。这些数据类型精确地根据您定义这一列时指定的精度来存储数据。尽可能不要使用浮点数。", Case:"CREATE TABLE tab2 (p_id BIGINT UNSIGNED NOT NULL,a_id BIGINT UNSIGNED NOT NULL,hours float not null,PRIMARY KEY (p_id, a_id))", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.010", Severity:"L2", Summary:"不建议使用 ENUM/BIT/SET 数据类型", Content:"ENUM 定义了列中值的类型,使用字符串表示 ENUM 里的值时,实际存储在列中的数据是这些值在定义时的序数。因此,这列的数据是字节对齐的,当您进行一次排序查询时,结果是按照实际存储的序数值排序的,而不是按字符串值的字母顺序排序的。这可能不是您所希望的。没有什么语法支持从 ENUM 或者 check 约束中添加或删除一个值;您只能使用一个新的集合重新定义这一列。如果您打算废弃一个选项,您可能会为历史数据而烦恼。作为一种策略,改变元数据——也就是说,改变表和列的定义——应该是不常见的,并且要注意测试和质量保证。有一个更好的解决方案来约束一列中的可选值:创建一张检查表,每一行包含一个允许在列中出现的候选值;然后在引用新表的旧表上声明一个外键约束。", Case:"create table tab1(status ENUM('new','in progress','fixed'))", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.011", Severity:"L0", Summary:"当需要唯一约束时才使用 NULL,仅当列不能有缺失值时才使用 NOT NULL", Content:"NULL 和0是不同的,10乘以 NULL 还是 NULL。NULL 和空字符串是不一样的。将一个字符串和标准 SQL 中的 NULL 联合起来的结果还是 NULL。NULL 和 FALSE 也是不同的。AND、OR 和 NOT 这三个布尔操作如果涉及 NULL,其结果也让很多人感到困惑。当您将一列声明为 NOT NULL 时,也就是说这列中的每一个值都必须存在且是有意义的。使用 NULL 来表示任意类型不存在的空值。 当您将一列声明为 NOT NULL 时,也就是说这列中的每一个值都必须存在且是有意义的。", Case:"select c1,c2,c3 from tbl where c4 is null or c4 <> 1", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.012", Severity:"L5", Summary:"TEXT、BLOB 和 JSON 类型的字段不建议设置为 NOT NULL", Content:"TEXT、BLOB 和 JSON 类型的字段无法指定非 NULL 的默认值,如果添加了 NOT NULL 限制,写入数据时又未对该字段指定值可能导致写入失败。", Case:"CREATE TABLE `tb`(`c` longblob NOT NULL);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.013", Severity:"L4", Summary:"TIMESTAMP 类型默认值检查异常", Content:"TIMESTAMP 类型建议设置默认值,且不建议使用 0 或 0000-00-00 00:00:00 作为默认值。可以考虑使用 1970-08-02 01:01:01", Case:"CREATE TABLE tbl( `id` bigint not null, `create_time` timestamp);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.014", Severity:"L5", Summary:"为列指定了字符集", Content:"建议列与表使用同一个字符集,不要单独指定列的字符集。", Case:"CREATE TABLE `tb2` ( `id` int(11) DEFAULT NULL, `col` char(10) CHARACTER SET utf8 DEFAULT NULL)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.015", Severity:"L4", Summary:"TEXT、BLOB 和 JSON 类型的字段不可指定非 NULL 的默认值", Content:"MySQL 数据库中 TEXT、BLOB 和 JSON 类型的字段不可指定非 NULL 的默认值。TEXT最大长度为2^16-1个字符,MEDIUMTEXT最大长度为2^32-1个字符,LONGTEXT最大长度为2^64-1个字符。", Case:"CREATE TABLE `tbl` (`c` blob DEFAULT NULL);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.016", Severity:"L1", Summary:"整型定义建议采用 INT(10) 或 BIGINT(20)", Content:"INT(M) 在 integer 数据类型中,M 表示最大显示宽度。 在 INT(M) 中,M 的值跟 INT(M) 所占多少存储空间并无任何关系。 INT(3)、INT(4)、INT(8) 在磁盘上都是占用 4 bytes 的存储空间。高版本 MySQL 已经不推荐设置整数显示宽度。", Case:"CREATE TABLE tab (a INT(1));", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.017", Severity:"L2", Summary:"VARCHAR 定义长度过长", Content:"varchar 是可变长字符串,不预先分配存储空间,长度不要超过1024,如果存储长度过长 MySQL 将定义字段类型为 text,独立出来一张表,用主键来对应,避免影响其它字段索引效率。", Case:"CREATE TABLE tab (a varchar(3500));", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.018", Severity:"L9", Summary:"建表语句中使用了不推荐的字段类型", Content:"以下字段类型不被推荐使用:boolean", Case:"CREATE TABLE tab (a BOOLEAN);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"COL.019", Severity:"L1", Summary:"不建议使用精度在秒级以下的时间数据类型", Content:"使用高精度的时间数据类型带来的存储空间消耗相对较大;MySQL 在5.6.4以上才可以支持精确到微秒的时间数据类型,使用时需要考虑版本兼容问题。", Case:"CREATE TABLE t1 (t TIME(3), dt DATETIME(6));", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"DIS.001", Severity:"L1", Summary:"消除不必要的 DISTINCT 条件", Content:"太多DISTINCT条件是复杂的裹脚布式查询的症状。考虑将复杂查询分解成许多简单的查询,并减少DISTINCT条件的数量。如果主键列是列的结果集的一部分,则DISTINCT条件可能没有影响。", Case:"SELECT DISTINCT c.c_id,count(DISTINCT c.c_name),count(DISTINCT c.c_e),count(DISTINCT c.c_n),count(DISTINCT c.c_me),c.c_d FROM (select distinct id, name from B) as e WHERE e.country_id = c.country_id", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"DIS.002", Severity:"L3", Summary:"COUNT(DISTINCT) 多列时结果可能和你预想的不同", Content:"COUNT(DISTINCT col) 计算该列除NULL之外的不重复行数,注意 COUNT(DISTINCT col, col2) 如果其中一列全为 NULL 那么即使另一列有不同的值,也返回0。", Case:"SELECT COUNT(DISTINCT col, col2) FROM tbl;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"DIS.003", Severity:"L3", Summary:"DISTINCT * 对有主键的表没有意义", Content:"当表已经有主键时,对所有列进行 DISTINCT 的输出结果与不进行 DISTINCT 操作的结果相同,请不要画蛇添足。", Case:"SELECT DISTINCT * FROM film;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"FUN.001", Severity:"L2", Summary:"避免在 WHERE 条件中使用函数或其他运算符", Content:"虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。", Case:"select id from t where substring(name,1,3)='abc'", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"FUN.002", Severity:"L1", Summary:"指定了 WHERE 条件或非 MyISAM 引擎时使用 COUNT(*) 操作性能不佳", Content:"COUNT(*) 的作用是统计表行数,COUNT(COL) 的作用是统计指定列非 NULL 的行数。MyISAM 表对于 COUNT(*) 统计全表行数进行了特殊的优化,通常情况下非常快。但对于非 MyISAM 表或指定了某些 WHERE 条件,COUNT(*) 操作需要扫描大量的行才能获取精确的结果,性能也因此不佳。有时候某些业务场景并不需要完全精确的 COUNT 值,此时可以用近似值来代替。EXPLAIN 出来的优化器估算的行数就是一个不错的近似值,执行 EXPLAIN 并不需要真正去执行查询,所以成本很低。", Case:"SELECT c3, COUNT(*) AS accounts FROM tab where c2 < 10000 GROUP BY c3 ORDER BY num", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"FUN.003", Severity:"L3", Summary:"使用了合并为可空列的字符串连接", Content:"在一些查询请求中,您需要强制让某一列或者某个表达式返回非 NULL 的值,从而让查询逻辑变得更简单,但又不想将这个值存下来。可以使用 COALESCE() 函数来构造连接的表达式,这样即使是空值列也不会使整表达式变为 NULL。", Case:"select c1 || coalesce(' ' || c2 || ' ', ' ') || c3 as c from tbl", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"FUN.004", Severity:"L4", Summary:"不建议使用 SYSDATE() 函数", Content:"SYSDATE() 函数可能导致主从数据不一致,请使用 NOW() 函数替代 SYSDATE()。", Case:"SELECT SYSDATE();", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"FUN.005", Severity:"L1", Summary:"不建议使用 COUNT(col) 或 COUNT(常量)", Content:"不要使用 COUNT(col) 或 COUNT(常量) 来替代 COUNT(*), COUNT(*) 是 SQL92 定义的标准统计行数的方法,跟数据无关,跟 NULL 和非 NULL 也无关。", Case:"SELECT COUNT(1) FROM tbl;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"FUN.006", Severity:"L1", Summary:"使用 SUM(COL) 时需注意 NPE 问题", Content:"当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl", Case:"SELECT SUM(COL) FROM tbl;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"FUN.007", Severity:"L1", Summary:"不建议使用触发器", Content:"触发器的执行没有反馈和日志,隐藏了实际的执行步骤,当数据库出现问题是,不能通过慢日志分析触发器的具体执行情况,不易发现问题。在MySQL中,触发器不能临时关闭或打开,在数据迁移或数据恢复等场景下,需要临时drop触发器,可能影响到生产环境。", Case:"CREATE TRIGGER t1 AFTER INSERT ON work FOR EACH ROW INSERT INTO time VALUES(NOW());", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"FUN.008", Severity:"L1", Summary:"不建议使用存储过程", Content:"存储过程无版本控制,配合业务的存储过程升级很难做到业务无感知。存储过程在拓展和移植上也存在问题。", Case:"CREATE PROCEDURE simpleproc (OUT param1 INT);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"FUN.009", Severity:"L1", Summary:"不建议使用自定义函数", Content:"不建议使用自定义函数", Case:"CREATE FUNCTION hello (s CHAR(20));", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"GRP.001", Severity:"L2", Summary:"不建议对等值查询列使用 GROUP BY", Content:"GROUP BY 中的列在前面的 WHERE 条件中使用了等值查询,对这样的列进行 GROUP BY 意义不大。", Case:"select film_id, title from film where release_year='2006' group by release_year", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"JOI.001", Severity:"L2", Summary:"JOIN 语句混用逗号和 ANSI 模式", Content:"表连接的时候混用逗号和 ANSI JOIN 不便于人类理解,并且MySQL不同版本的表连接行为和优先级均有所不同,当 MySQL 版本变化后可能会引入错误。", Case:"select c1,c2,c3 from t1,t2 join t3 on t1.c1=t2.c1,t1.c3=t3,c1 where id>1000", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"JOI.002", Severity:"L4", Summary:"同一张表被连接两次", Content:"相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。", Case:"select tb1.col from (tb1, tb2) join tb2 on tb1.id=tb.id where tb1.id=1", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"JOI.003", Severity:"L4", Summary:"OUTER JOIN 失效", Content:"由于 WHERE 条件错误使得 OUTER JOIN 的外部表无数据返回,这会将查询隐式转换为 INNER JOIN 。如:select c from L left join R using(c) where L.a=5 and R.b=10。这种 SQL 逻辑上可能存在错误或程序员对 OUTER JOIN 如何工作存在误解,因为 LEFT/RIGHT JOIN 是 LEFT/RIGHT OUTER JOIN 的缩写。", Case:"select c1,c2,c3 from t1 left outer join t2 using(c1) where t1.c2=2 and t2.c3=4", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"JOI.004", Severity:"L4", Summary:"不建议使用排它 JOIN", Content:"只在右侧表为 NULL 的带 WHERE 子句的 LEFT OUTER JOIN 语句,有可能是在WHERE子句中使用错误的列,如:“... FROM l LEFT OUTER JOIN r ON l.l = r.r WHERE r.z IS NULL”,这个查询正确的逻辑可能是 WHERE r.r IS NULL。", Case:"select c1,c2,c3 from t1 left outer join t2 on t1.c1=t2.c1 where t2.c2 is null", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"JOI.005", Severity:"L2", Summary:"减少 JOIN 的数量", Content:"太多的 JOIN 是复杂的裹脚布式查询的症状。考虑将复杂查询分解成许多简单的查询,并减少 JOIN 的数量。", Case:"select bp1.p_id, b1.d_d as l, b1.b_id from b1 join bp1 on (b1.b_id = bp1.b_id) left outer join (b1 as b2 join bp2 on (b2.b_id = bp2.b_id)) on (bp1.p_id = bp2.p_id ) join bp21 on (b1.b_id = bp1.b_id) join bp31 on (b1.b_id = bp1.b_id) join bp41 on (b1.b_id = bp1.b_id) where b2.b_id = 0", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"JOI.008", Severity:"L4", Summary:"不要使用跨数据库的 JOIN 查询", Content:"一般来说,跨数据库的 JOIN 查询意味着查询语句跨越了两个不同的子系统,这可能意味着系统耦合度过高或库表结构设计不合理。", Case:"SELECT s,p,d FROM tbl WHERE p.p_id = (SELECT s.p_id FROM tbl WHERE s.c_id = 100996 AND s.q = 1 )", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KEY.001", Severity:"L2", Summary:"建议使用自增列作为主键,如使用联合自增主键时请将自增键作为第一列", Content:"建议使用自增列作为主键,如使用联合自增主键时请将自增键作为第一列", Case:"create table test(`id` int(11) NOT NULL PRIMARY KEY (`id`))", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KEY.003", Severity:"L4", Summary:"避免外键等递归关系", Content:"存在递归关系的数据很常见,数据常会像树或者以层级方式组织。然而,创建一个外键约束来强制执行同一表中两列之间的关系,会导致笨拙的查询。树的每一层对应着另一个连接。您将需要发出递归查询,以获得节点的所有后代或所有祖先。解决方案是构造一个附加的闭包表。它记录了树中所有节点间的关系,而不仅仅是那些具有直接的父子关系。您也可以比较不同层次的数据设计:闭包表,路径枚举,嵌套集。然后根据应用程序的需要选择一个。", Case:"CREATE TABLE tab2 (p_id BIGINT UNSIGNED NOT NULL,a_id BIGINT UNSIGNED NOT NULL,PRIMARY KEY (p_id, a_id),FOREIGN KEY (p_id) REFERENCES tab1(p_id),FOREIGN KEY (a_id) REFERENCES tab3(a_id))", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KEY.004", Severity:"L0", Summary:"提醒:请将索引属性顺序与查询对齐", Content:"如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。", Case:"create index idx1 on tbl (last_name,first_name)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KEY.005", Severity:"L2", Summary:"表建的索引过多", Content:"表建的索引过多", Case:"CREATE TABLE tbl ( a int, b int, c int, KEY idx_a (`a`),KEY idx_b(`b`),KEY idx_c(`c`));", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KEY.006", Severity:"L4", Summary:"主键中的列过多", Content:"主键中的列过多", Case:"CREATE TABLE tbl ( a int, b int, c int, PRIMARY KEY(`a`,`b`,`c`));", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KEY.007", Severity:"L4", Summary:"未指定主键或主键非 int 或 bigint", Content:"未指定主键或主键非 int 或 bigint,建议将主键设置为 int unsigned 或 bigint unsigned。", Case:"CREATE TABLE tbl (a int);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KEY.008", Severity:"L4", Summary:"ORDER BY 多个列但排序方向不同时可能无法使用索引", Content:"在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。", Case:"SELECT * FROM tbl ORDER BY a DESC, b ASC;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KEY.009", Severity:"L0", Summary:"添加唯一索引前请注意检查数据唯一性", Content:"请提前检查添加唯一索引列的数据唯一性,如果数据不唯一在线表结构调整时将有可能自动将重复列删除,这有可能导致数据丢失。", Case:"CREATE UNIQUE INDEX part_of_name ON customer (name(10));", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KEY.010", Severity:"L0", Summary:"全文索引不是银弹", Content:"全文索引主要用于解决模糊查询的性能问题,但需要控制好查询的频率和并发度。同时注意调整 ft_min_word_len, ft_max_word_len, ngram_token_size 等参数。", Case:"CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `ip` varchar(255) NOT NULL DEFAULT '', PRIMARY KEY (`id`), FULLTEXT KEY `ip` (`ip`) ) ENGINE=InnoDB;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KWR.001", Severity:"L2", Summary:"SQL_CALC_FOUND_ROWS 效率低下", Content:"因为 SQL_CALC_FOUND_ROWS 不能很好地扩展,所以可能导致性能问题; 建议业务使用其他策略来替代 SQL_CALC_FOUND_ROWS 提供的计数功能,比如:分页结果展示等。", Case:"select SQL_CALC_FOUND_ROWS col from tbl where id>1000", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KWR.002", Severity:"L2", Summary:"不建议使用 MySQL 关键字做列名或表名", Content:"当使用关键字做为列名或表名时程序需要对列名和表名进行转义,如果疏忽被将导致请求无法执行。", Case:"CREATE TABLE tbl ( `select` int )", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KWR.003", Severity:"L1", Summary:"不建议使用复数做列名或表名", Content:"表名应该仅仅表示表里面的实体内容,不应该表示实体数量,对应于 DO 类名也是单数形式,符合表达习惯。", Case:"CREATE TABLE tbl ( `books` int )", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KWR.004", Severity:"L1", Summary:"不建议使用使用多字节编码字符(中文)命名", Content:"为库、表、列、别名命名时建议使用英文,数字,下划线等字符,不建议使用中文或其他多字节编码字符。", Case:"select col as 列 from tb", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"KWR.005", Severity:"L1", Summary:"SQL 中包含 unicode 特殊字符", Content:"部分 IDE 会自动在 SQL 插入肉眼不可见的 unicode 字符。如:non-break space, zero-width space 等。Linux 下可使用 `cat -A file.sql` 命令查看不可见字符。", Case:"update\u00a0tb set\u00a0status\u00a0=\u00a01 where\u00a0id\u00a0=\u00a01;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"LCK.001", Severity:"L3", Summary:"INSERT INTO xx SELECT 加锁粒度较大请谨慎", Content:"INSERT INTO xx SELECT 加锁粒度较大请谨慎", Case:"INSERT INTO tbl SELECT * FROM tbl2;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"LCK.002", Severity:"L3", Summary:"请慎用 INSERT ON DUPLICATE KEY UPDATE", Content:"当主键为自增键时使用 INSERT ON DUPLICATE KEY UPDATE 可能会导致主键出现大量不连续快速增长,导致主键快速溢出无法继续写入。极端情况下还有可能导致主从数据不一致。", Case:"INSERT INTO t1(a,b,c) VALUES (1,2,3) ON DUPLICATE KEY UPDATE c=c+1;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"LIT.001", Severity:"L2", Summary:"用字符类型存储IP地址", Content:"字符串字面上看起来像IP地址,但不是 INET_ATON() 的参数,表示数据被存储为字符而不是整数。将IP地址存储为整数更为有效。", Case:"insert into tbl (IP,name) values('10.20.306.122','test')", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"LIT.002", Severity:"L4", Summary:"日期/时间未使用引号括起", Content:"诸如“WHERE col <2010-02-12”之类的查询是有效的SQL,但可能是一个错误,因为它将被解释为“WHERE col <1996”; 日期/时间文字应该加引号,且引号前后不应有空格。", Case:"select col1,col2 from tbl where time < 2018-01-10", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"LIT.003", Severity:"L3", Summary:"一列中存储一系列相关数据的集合", Content:"将 ID 存储为一个列表,作为 VARCHAR/TEXT 列,这样能导致性能和数据完整性问题。查询这样的列需要使用模式匹配的表达式。使用逗号分隔的列表来做多表联结查询定位一行数据是极不优雅和耗时的。这将使验证 ID 更加困难。考虑一下,列表最多支持存放多少数据呢?将 ID 存储在一张单独的表中,代替使用多值属性,从而每个单独的属性值都可以占据一行。这样交叉表实现了两张表之间的多对多关系。这将更好地简化查询,也更有效地验证ID。", Case:"select c1,c2,c3,c4 from tab1 where col_id REGEXP '[[:<:]]12[[:>:]]'", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"LIT.004", Severity:"L1", Summary:"请使用分号或已设定的 DELIMITER 结尾", Content:"USE database, SHOW DATABASES 等命令也需要使用使用分号或已设定的 DELIMITER 结尾。", Case:"USE db", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"OK", Severity:"L0", Summary:"OK", Content:"OK", Case:"OK", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.001", Severity:"L4", Summary:"非确定性的 GROUP BY", Content:"SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo=\"bar\" group by a,该 SQL 返回的结果就是不确定的。", Case:"select c1,c2,c3 from t1 where c2='foo' group by c2", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.002", Severity:"L4", Summary:"未使用 ORDER BY 的 LIMIT 查询", Content:"没有 ORDER BY 的 LIMIT 会导致非确定性的结果,这取决于查询执行计划。", Case:"select col1,col2 from tbl where name=xx limit 10", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.003", Severity:"L4", Summary:"UPDATE/DELETE 操作使用了 LIMIT 条件", Content:"UPDATE/DELETE 操作使用 LIMIT 条件和不添加 WHERE 条件一样危险,它可将会导致主从数据不一致或从库同步中断。", Case:"UPDATE film SET length = 120 WHERE title = 'abc' LIMIT 1;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.004", Severity:"L4", Summary:"UPDATE/DELETE 操作指定了 ORDER BY 条件", Content:"UPDATE/DELETE 操作不要指定 ORDER BY 条件。", Case:"UPDATE film SET length = 120 WHERE title = 'abc' ORDER BY title", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.005", Severity:"L4", Summary:"UPDATE 语句可能存在逻辑错误,导致数据损坏", Content:"在一条 UPDATE 语句中,如果要更新多个字段,字段间不能使用 AND ,而应该用逗号分隔。", Case:"update tbl set col = 1 and cl = 2 where col=3;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.006", Severity:"L4", Summary:"永远不真的比较条件", Content:"查询条件永远非真,如果该条件出现在 where 中可能导致查询无匹配到的结果。", Case:"select * from tbl where 1 != 1;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.007", Severity:"L4", Summary:"永远为真的比较条件", Content:"查询条件永远为真,可能导致 WHERE 条件失效进行全表查询。", Case:"select * from tbl where 1 = 1;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.008", Severity:"L2", Summary:"不建议使用LOAD DATA/SELECT ... INTO OUTFILE", Content:"SELECT INTO OUTFILE 需要授予 FILE 权限,这通过会引入安全问题。LOAD DATA 虽然可以提高数据导入速度,但同时也可能导致从库同步延迟过大。", Case:"LOAD DATA INFILE 'data.txt' INTO TABLE db2.my_table;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.009", Severity:"L2", Summary:"不建议使用连续判断", Content:"类似这样的 SELECT * FROM tbl WHERE col = col = 'abc' 语句可能是书写错误,您可能想表达的含义是 col = 'abc'。如果确实是业务需求建议修改为 col = col and col = 'abc'。", Case:"SELECT * FROM tbl WHERE col = col = 'abc'", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.010", Severity:"L2", Summary:"建表语句中定义为 ON UPDATE CURRENT_TIMESTAMP 的字段不建议包含业务逻辑", Content:"定义为 ON UPDATE CURRENT_TIMESTAMP 的字段在该表其他字段更新时会联动修改,如果包含业务逻辑用户可见会埋下隐患。后续如有批量修改数据却又不想修改该字段时会导致数据错误。", Case:"CREATE TABLE category (category_id TINYINT UNSIGNED NOT NULL AUTO_INCREMENT,\tname VARCHAR(25) NOT NULL, last_update TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (category_id)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"RES.011", Severity:"L2", Summary:"更新请求操作的表包含 ON UPDATE CURRENT_TIMESTAMP 字段", Content:"定义为 ON UPDATE CURRENT_TIMESTAMP 的字段在该表其他字段更新时会联动修改,请注意检查。如不想修改字段的更新时间可以使用如下方法:UPDATE category SET name='ActioN', last_update=last_update WHERE category_id=1", Case:"UPDATE category SET name='ActioN', last_update=last_update WHERE category_id=1", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SEC.001", Severity:"L0", Summary:"请谨慎使用TRUNCATE操作", Content:"一般来说想清空一张表最快速的做法就是使用TRUNCATE TABLE tbl_name;语句。但TRUNCATE操作也并非是毫无代价的,TRUNCATE TABLE无法返回被删除的准确行数,如果需要返回被删除的行数建议使用DELETE语法。TRUNCATE 操作还会重置 AUTO_INCREMENT,如果不想重置该值建议使用 DELETE FROM tbl_name WHERE 1;替代。TRUNCATE 操作会对数据字典添加源数据锁(MDL),当一次需要 TRUNCATE 很多表时会影响整个实例的所有请求,因此如果要 TRUNCATE 多个表建议用 DROP+CREATE 的方式以减少锁时长。", Case:"TRUNCATE TABLE tbl_name", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SEC.002", Severity:"L0", Summary:"不使用明文存储密码", Content:"使用明文存储密码或者使用明文在网络上传递密码都是不安全的。如果攻击者能够截获您用来插入密码的SQL语句,他们就能直接读到密码。另外,将用户输入的字符串以明文的形式插入到纯SQL语句中,也会让攻击者发现它。如果您能够读取密码,黑客也可以。解决方案是使用单向哈希函数对原始密码进行加密编码。哈希是指将输入字符串转化成另一个新的、不可识别的字符串的函数。对密码加密表达式加点随机串来防御“字典攻击”。不要将明文密码输入到SQL查询语句中。在应用程序代码中计算哈希串,只在SQL查询中使用哈希串。", Case:"create table test(id int,name varchar(20) not null,password varchar(200)not null)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SEC.003", Severity:"L0", Summary:"使用DELETE/DROP/TRUNCATE等操作时注意备份", Content:"在执行高危操作之前对数据进行备份是十分有必要的。", Case:"delete from table where col = 'condition'", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SEC.004", Severity:"L0", Summary:"发现常见 SQL 注入函数", Content:"SLEEP(), BENCHMARK(), GET_LOCK(), RELEASE_LOCK() 等函数通常出现在 SQL 注入语句中,会严重影响数据库性能。", Case:"SELECT BENCHMARK(10, RAND())", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"STA.001", Severity:"L0", Summary:"'!=' 运算符是非标准的", Content:"\"<>\"才是标准SQL中的不等于运算符。", Case:"select col1,col2 from tbl where type!=0", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"STA.002", Severity:"L1", Summary:"库名或表名点后建议不要加空格", Content:"当使用 db.table 或 table.column 格式访问表或字段时,请不要在点号后面添加空格,虽然这样语法正确。", Case:"select col from sakila. film", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"STA.003", Severity:"L1", Summary:"索引起名不规范", Content:"建议普通二级索引以idx_为前缀,唯一索引以uk_为前缀。", Case:"select col from now where type!=0", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"STA.004", Severity:"L1", Summary:"起名时请不要使用字母、数字和下划线之外的字符", Content:"以字母或下划线开头,名字只允许使用字母、数字和下划线。请统一大小写,不要使用驼峰命名法。不要在名字中出现连续下划线'__',这样很难辨认。", Case:"CREATE TABLE ` abc` (a int);", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SUB.002", Severity:"L2", Summary:"如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION", Content:"与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。", Case:"select teacher_id as id,people_name as name from t1,t2 where t1.teacher_id=t2.people_id union select student_id as id,people_name as name from t1,t2 where t1.student_id=t2.people_id", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SUB.003", Severity:"L3", Summary:"考虑使用 EXISTS 而不是 DISTINCT 子查询", Content:"DISTINCT 关键字在对元组排序后删除重复。相反,考虑使用一个带有 EXISTS 关键字的子查询,您可以避免返回整个表。", Case:"SELECT DISTINCT c.c_id, c.c_name FROM c,e WHERE e.c_id = c.c_id", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SUB.004", Severity:"L3", Summary:"执行计划中嵌套连接深度过深", Content:"MySQL对子查询的优化效果不佳,MySQL将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。", Case:"SELECT * from tb where id in (select id from (select id from tb))", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SUB.005", Severity:"L8", Summary:"子查询不支持LIMIT", Content:"当前 MySQL 版本不支持在子查询中进行 'LIMIT & IN/ALL/ANY/SOME'。", Case:"SELECT * FROM staff WHERE name IN (SELECT NAME FROM customer ORDER BY name LIMIT 1)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SUB.006", Severity:"L2", Summary:"不建议在子查询中使用函数", Content:"MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。", Case:"SELECT * FROM staff WHERE name IN (SELECT max(NAME) FROM customer)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"SUB.007", Severity:"L2", Summary:"外层带有 LIMIT 输出限制的 UNION 联合查询,其内层查询建议也添加 LIMIT 输出限制", Content:"有时 MySQL 无法将限制条件从外层“下推”到内层,这会使得原本可以限制能够限制部分返回结果的条件无法应用到内层查询的优化上。比如:(SELECT * FROM tb1 ORDER BY name) UNION ALL (SELECT * FROM tb2 ORDER BY name) LIMIT 20; MySQL 会将两个子查询的结果放在一个临时表中,然后取出 20 条结果,可以通过在两个子查询中添加 LIMIT 20 来减少临时表中的数据。(SELECT * FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT * FROM tb2 ORDER BY name LIMIT 20) LIMIT 20;", Case:"(SELECT * FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT * FROM tb2 ORDER BY name LIMIT 20) LIMIT 20;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"TBL.001", Severity:"L4", Summary:"不建议使用分区表", Content:"不建议使用分区表", Case:"CREATE TABLE trb3(id INT, name VARCHAR(50), purchased DATE) PARTITION BY RANGE(YEAR(purchased)) (PARTITION p0 VALUES LESS THAN (1990), PARTITION p1 VALUES LESS THAN (1995), PARTITION p2 VALUES LESS THAN (2000), PARTITION p3 VALUES LESS THAN (2005) );", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"TBL.002", Severity:"L4", Summary:"请为表选择合适的存储引擎", Content:"建表或修改表的存储引擎时建议使用推荐的存储引擎,如:innodb", Case:"create table test(`id` int(11) NOT NULL AUTO_INCREMENT)", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"TBL.003", Severity:"L8", Summary:"以DUAL命名的表在数据库中有特殊含义", Content:"DUAL表为虚拟表,不需要创建即可使用,也不建议服务以DUAL命名表。", Case:"create table dual(id int, primary key (id));", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"TBL.004", Severity:"L2", Summary:"表的初始AUTO_INCREMENT值不为0", Content:"AUTO_INCREMENT不为0会导致数据空洞。", Case:"CREATE TABLE tbl (a int) AUTO_INCREMENT = 10;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"TBL.005", Severity:"L4", Summary:"请使用推荐的字符集", Content:"表字符集只允许设置为'utf8,utf8mb4'", Case:"CREATE TABLE tbl (a int) DEFAULT CHARSET = latin1;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"TBL.006", Severity:"L1", Summary:"不建议使用视图", Content:"不建议使用视图", Case:"create view v_today (today) AS SELECT CURRENT_DATE;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"TBL.007", Severity:"L1", Summary:"不建议使用临时表", Content:"不建议使用临时表", Case:"CREATE TEMPORARY TABLE `work` (`time` time DEFAULT NULL) ENGINE=InnoDB;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} advisor.Rule{Item:"TBL.008", Severity:"L4", Summary:"请使用推荐的COLLATE", Content:"COLLATE 只允许设置为''", Case:"CREATE TABLE tbl (a int) DEFAULT COLLATE = latin1_bin;", Position:0, Func:func(*advisor.Query4Audit) advisor.Rule {...}} ================================================ FILE: ast/doc.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ // Package ast is an interface for Abstract Syntax Tree parser package ast ================================================ FILE: ast/meta.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package ast import ( "fmt" "strings" "github.com/XiaoMi/soar/common" "vitess.io/vitess/go/vt/sqlparser" ) // GetTableFromExprs 从sqlparser.Exprs中获取所有的库表 func GetTableFromExprs(exprs sqlparser.TableExprs, metas ...common.Meta) common.Meta { meta := make(map[string]*common.DB) if len(metas) >= 1 { meta = metas[0] } err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.AliasedTableExpr: switch table := expr.Expr.(type) { case sqlparser.TableName: db := table.Qualifier.String() tb := table.Name.String() if meta[db] == nil { meta[db] = common.NewDB(db) } meta[db].Table[tb] = common.NewTable(tb) // alias去重 aliasExist := false for _, existedAlias := range meta[db].Table[tb].TableAliases { if existedAlias == expr.As.String() { aliasExist = true } } if !aliasExist { meta[db].Table[tb].TableAliases = append(meta[db].Table[tb].TableAliases, expr.As.String()) } } } return true, nil }, exprs) common.LogIfWarn(err, "") return meta } // GetMeta 获取元数据信息,构建到db->table层级。 // 从 SQL 或 Statement 中获取表信息,并返回。当 meta 不为 nil 时,返回值会将新老 meta 合并去重 func GetMeta(stmt sqlparser.Statement, meta common.Meta) common.Meta { // 初始化meta if meta == nil { meta = make(map[string]*common.DB) } err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.DDL: // 如果 SQL 是一个 DDL,则不需要继续遍历语法树了 for _, tb := range expr.FromTables { appendTable(tb, "", meta) } for _, tb := range expr.ToTables { appendTable(tb, "", meta) } appendTable(expr.Table, "", meta) return false, nil case *sqlparser.AliasedTableExpr: // 非 DDL 情况下处理 TableExpr // 在 sqlparser 中存在三种 TableExpr: AliasedTableExpr,ParenTableExpr 以及 JoinTableExpr。 // 其中 AliasedTableExpr 是其他两种 TableExpr 的基础组成,SQL中的 表信息(别名、前缀)在这个结构体中。 switch table := expr.Expr.(type) { // 获取表名、别名与前缀名(数据库名) // 表名存放在 AST 中 TableName 里,包含表名与表前缀名。 // 当与 As 相对应的 Expr 为 TableName 的时候,别名才是一张实体表的别名,否则为结果集的别名。 case sqlparser.TableName: appendTable(table, expr.As.String(), meta) default: // 如果 AliasedTableExpr 中的 Expr 不是 TableName 结构体,则表示该表为一个查询结果集(子查询或临时表)。 // 在这里记录一下别名,但将列名制空,用来保证在其他环节中判断列前缀的时候不会有遗漏 // 最终结果为所有的子查询别名都会归于 ""(空) 数据库 ""(空) 表下,对于空数据库,空表后续在索引优化时直接PASS if meta == nil { meta = make(map[string]*common.DB) } if meta[""] == nil { meta[""] = common.NewDB("") } meta[""].Table[""] = common.NewTable("") meta[""].Table[""].TableAliases = append(meta[""].Table[""].TableAliases, expr.As.String()) } } return true, nil }, stmt) common.LogIfWarn(err, "") return meta } // appendTable 将 sqlparser.TableName 中的库表信息提取后放到 meta 中 // @tb 为 sqlparser.TableName 对象 // @as 为该表的别名,无别名时为空 // @meta 为信息集合 func appendTable(tb sqlparser.TableName, as string, meta map[string]*common.DB) map[string]*common.DB { if meta == nil { return meta } dbName := tb.Qualifier.String() tbName := tb.Name.String() if tbName == "" { return meta } if meta[dbName] == nil { meta[dbName] = common.NewDB(dbName) } meta[dbName].Table[tbName] = common.NewTable(tbName) mergeAlias(dbName, tbName, as, meta) return meta } // mergeAlias 将所有的表别名归并到一个表下 func mergeAlias(db, tb, as string, meta map[string]*common.DB) { if meta == nil || as == "" { return } aliasExist := false for _, existedAlias := range meta[db].Table[tb].TableAliases { if existedAlias == as { aliasExist = true } } if !aliasExist { meta[db].Table[tb].TableAliases = append(meta[db].Table[tb].TableAliases, as) } } // eqOperators 等值条件判断关键字 var eqOperators = map[string]string{ "=": "eq", "<=>": "eq", "is true": "eq", "is false": "eq", "is not true": "eq", "is not false": "eq", "is null": "eq", "in": "eq", // 单值的in属于等值条件 } // inEqOperators 非等值条件判断关键字 var inEqOperators = map[string]string{ "<": "inEq", ">": "inEq", "<=": "inEq", ">=": "inEq", "!=": "inEq", "is not null": "inEq", "like": "inEq", "not like": "inEq", "->": "inEq", "->>": "inEq", "between": "inEq", "not between": "inEq", "in": "inEq", // 多值in属于非等值条件 // 某些非等值条件无需添加索引,所以忽略即可 // 比如"not in",比如"exists"、 "not exists"等 } // FindColumn 从传入的 node 中获取所有可能加索引的的 column 信息 func FindColumn(node sqlparser.SQLNode) []*common.Column { common.Log.Debug("Enter: FindColumn, Caller: %s", common.Caller()) var result []*common.Column err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch col := node.(type) { case *sqlparser.FuncExpr: // 忽略function return false, nil case *sqlparser.ColName: result = common.MergeColumn(result, &common.Column{ Name: col.Name.String(), Table: col.Qualifier.Name.String(), DB: col.Qualifier.Qualifier.String(), Alias: make([]string, 0), }) } return true, nil }, node) common.LogIfWarn(err, "") return result } // inEqIndexAble 判断非等值查询条件是否可以复用到索引 // Output: true 可以考虑添加索引, false 不需要添加索引 func inEqIndexAble(node sqlparser.SQLNode) bool { common.Log.Debug("Enter: inEqIndexAble(), Caller: %s", common.Caller()) var indexAble bool switch expr := node.(type) { case *sqlparser.ComparisonExpr: // like前百分号查询无法使用索引 // TODO: date 类型的 like 属于隐式数据类型转换,会导致无法使用索引 if expr.Operator == "like" || expr.Operator == "not like" { switch right := expr.Right.(type) { case *sqlparser.SQLVal: return !(strings.HasPrefix(string(right.Val), "%")) } } // 如果是in查询,则需要判断in查询是否是多值查询 if expr.Operator == "in" { switch right := expr.Right.(type) { case sqlparser.ValTuple: // 若是单值查询则应该属于等值条件而非非等值条件 return len(right) > 1 } } _, indexAble = inEqOperators[expr.Operator] case *sqlparser.IsExpr: _, indexAble = inEqOperators[expr.Operator] case *sqlparser.RangeCond: _, indexAble = inEqOperators[expr.Operator] default: indexAble = false } return indexAble } // FindWhereEQ 找到Where中的等值条件 func FindWhereEQ(node sqlparser.SQLNode) []*common.Column { common.Log.Debug("Enter: FindWhereEQ(), Caller: %s", common.Caller()) return append(FindEQColsInWhere(node), FindEQColsInJoinCond(node)...) } // FindWhereINEQ 找到Where条件中的非等值条件 func FindWhereINEQ(node sqlparser.SQLNode) []*common.Column { common.Log.Debug("Enter: FindWhereINEQ(), Caller: %s", common.Caller()) return append(FindINEQColsInWhere(node), FindINEQColsInJoinCond(node)...) } // FindEQColsInWhere 获取等值条件信息 // 将所有值得加索引的condition条件信息进行过滤 func FindEQColsInWhere(node sqlparser.SQLNode) []*common.Column { common.Log.Debug("Enter: FindEQColsInWhere(), Caller: %s", common.Caller()) var columns []*common.Column err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node := node.(type) { // 对AST中所有节点进行扫描 case *sqlparser.Subquery, *sqlparser.JoinTableExpr, *sqlparser.BinaryExpr, *sqlparser.OrExpr, *sqlparser.CaseExpr, *sqlparser.FuncExpr: // 忽略子查询,join condition,数值计算,or condition return false, nil case *sqlparser.ComparisonExpr: var newCols []*common.Column // ComparisonExpr中可能含有等值查询列条件 switch node.Operator { case "in": // 对in进行特别判断,只有单值的in条件才算做是等值查询 switch right := node.Right.(type) { case sqlparser.ValTuple: if len(right) == 1 { newCols = FindColumn(node) } } default: switch node.Left.(type) { case *sqlparser.ColName: if _, ok := eqOperators[node.Operator]; ok { newCols = FindColumn(node) } } } // operator两边都为列的情况不提供索引建议 // 如果该列位于function中则不予提供索引建议 if len(newCols) == 1 { columns = common.MergeColumn(columns, newCols[0]) } case *sqlparser.IsExpr: // IsExpr中可能含有等值查询列条件 if _, ok := eqOperators[node.Operator]; ok { newCols := FindColumn(node) if len(newCols) == 1 { columns = common.MergeColumn(columns, newCols[0]) } } } return true, nil }, node) common.LogIfWarn(err, "") return columns } // FindINEQColsInWhere 获取非等值条件中可能需要加索引的列 // 将所有值得加索引的condition条件信息进行过滤 // TODO: 将 where 条件中隐含的 join 条件合并到 join condition中 func FindINEQColsInWhere(node sqlparser.SQLNode) []*common.Column { common.Log.Debug("Enter: FindINEQColsInWhere(), Caller: %s", common.Caller()) var columns []*common.Column err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node := node.(type) { // 对AST中所有节点进行扫描 case *sqlparser.Subquery, *sqlparser.JoinTableExpr, *sqlparser.BinaryExpr, *sqlparser.OrExpr: // 忽略子查询,join condition,数值计算,or condition return false, nil case *sqlparser.ComparisonExpr: // ComparisonExpr中可能含有非等值查询列条件 if inEqIndexAble(node) { newCols := FindColumn(node) // operator两边都为列的情况不提供索引建议 if len(newCols) == 1 { columns = common.MergeColumn(columns, newCols[0]) } } case *sqlparser.IsExpr: // IsExpr中可能含有非等值查询列条件 if inEqIndexAble(node) { newCols := FindColumn(node) if len(newCols) == 1 { columns = common.MergeColumn(columns, newCols[0]) } } case *sqlparser.RangeCond: // RangeCond中只存在非等值条件查询 if inEqIndexAble(node) { columns = common.MergeColumn(columns, FindColumn(node)...) } } return true, nil }, node) common.LogIfWarn(err, "") return columns } // FindGroupByCols 获取groupBy中可能需要加索引的列信息 func FindGroupByCols(node sqlparser.SQLNode) []*common.Column { common.Log.Debug("Enter: FindGroupByCols(), Caller: %s", common.Caller()) isIgnore := false var columns []*common.Column err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case sqlparser.GroupBy: err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node := node.(type) { case *sqlparser.BinaryExpr, *sqlparser.FuncExpr: // 如果group by中出现数值计算、函数等 isIgnore = true return false, nil default: columns = common.MergeColumn(columns, FindColumn(node)...) } return true, nil }, expr) common.LogIfWarn(err, "") case *sqlparser.Subquery, *sqlparser.JoinTableExpr, *sqlparser.BinaryExpr: // 忽略子查询,join condition以及数值计算 return false, nil } return true, nil }, node) common.LogIfWarn(err, "") if isIgnore { return []*common.Column{} } return columns } // FindOrderByCols 为索引优化获取orderBy中可能添加索引的列信息 func FindOrderByCols(node sqlparser.SQLNode) []*common.Column { common.Log.Debug("Enter: FindOrderByCols(), Caller: %s", common.Caller()) var columns []*common.Column lastDirection := "" directionNotEq := false err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.Order: // MySQL对于排序顺序不同的查询无法使用索引(8.0后支持) if lastDirection != "" && expr.Direction != lastDirection { directionNotEq = true return false, nil } lastDirection = expr.Direction columns = common.MergeColumn(columns, FindColumn(expr)...) case *sqlparser.Subquery, *sqlparser.JoinTableExpr, *sqlparser.BinaryExpr: // 忽略子查询,join condition以及数值计算 return false, nil } return true, nil }, node) common.LogIfWarn(err, "") if directionNotEq { // 当发现Order by中排序顺序不同时,即放弃Oder by条件中的字段 return []*common.Column{} } return columns } // FindJoinTable 获取 Join 中需要添加索引的表 // join 优化添加索引分为三种类型:1. inner join, 2. left join, 3.right join // 针对三种优化类型,需要三种不同的索引添加方案: // 1. inner join 需要对 join 左右的表添加索引 // 2. left join 由于左表为全表扫描,需要对右表的关联列添加索引。 // 3. right join 与 left join 相反,需要对左表的关联列添加索引。 // 以上添加索引的策略前提为join的表为实体表而非临时表。 func FindJoinTable(node sqlparser.SQLNode, meta common.Meta) common.Meta { common.Log.Debug("Enter: FindJoinTable(), Caller: %s", common.Caller()) if meta == nil { meta = make(common.Meta) } err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.JoinTableExpr: switch expr.Join { case sqlparser.JoinStr, sqlparser.NaturalJoinStr: // 两边表都需要 findJoinTable(expr.LeftExpr, meta) findJoinTable(expr.RightExpr, meta) case sqlparser.LeftJoinStr, sqlparser.NaturalLeftJoinStr, sqlparser.StraightJoinStr: // 只需要右表 findJoinTable(expr.RightExpr, meta) case sqlparser.RightJoinStr, sqlparser.NaturalRightJoinStr: // 只需要左表 findJoinTable(expr.LeftExpr, meta) } } return true, nil }, node) common.LogIfWarn(err, "") return meta } // findJoinTable 获取join table func findJoinTable(expr sqlparser.TableExpr, meta common.Meta) { common.Log.Debug("Enter: findJoinTable(), Caller: %s", common.Caller()) if meta == nil { meta = make(common.Meta) } switch tableExpr := expr.(type) { case *sqlparser.AliasedTableExpr: switch table := tableExpr.Expr.(type) { // 获取表名、别名与前缀名(数据库名) // 表名存放在 AST 中 TableName 里,包含表名与表前缀名。 // 当与 As 相对应的 Expr 为 TableName 的时候,别名才是一张实体表的别名,否则为结果集的别名。 case sqlparser.TableName: db := table.Qualifier.String() tb := table.Name.String() if meta == nil { meta = make(map[string]*common.DB) } if meta[db] == nil { meta[db] = common.NewDB(db) } meta[db].Table[tb] = common.NewTable(tb) // alias去重 aliasExist := false for _, existedAlias := range meta[db].Table[tb].TableAliases { if existedAlias == tableExpr.As.String() { aliasExist = true } } if !aliasExist { meta[db].Table[tb].TableAliases = append(meta[db].Table[tb].TableAliases, tableExpr.As.String()) } } case *sqlparser.ParenTableExpr: // join 时可能会同时 join 多张表 for _, tbExpr := range tableExpr.Exprs { findJoinTable(tbExpr, meta) } default: // 如果是如上两种类型都没有命中,说明join的表为临时表,递归调用 FindJoinTable 继续下探查找。 // NOTE: 这里需要注意的是,如果不递归寻找,如果存在子查询结果集的join表,subquery也会把这个查询提取出。 // 所以针对default这一段理论上可以忽略处理(待测试) FindJoinTable(tableExpr, meta) } } // FindJoinCols 获取 join condition 中使用到的列(必须是 `列 operator 列` 的情况。 // 如果列对应的值或是 function,则应该移到where condition中) // 某些 where 条件隐含在 join 条件中(INNER JOIN) func FindJoinCols(node sqlparser.SQLNode) [][]*common.Column { common.Log.Debug("Enter: FindJoinCols(), Caller: %s", common.Caller()) var columns [][]*common.Column err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.JoinTableExpr: // on if on := expr.Condition.On; on != nil { cols := FindColumn(expr.Condition.On) if len(cols) > 1 { columns = append(columns, cols) } } // using if using := expr.Condition.Using; using != nil { left := "" right := "" switch tableExpr := expr.LeftExpr.(type) { case *sqlparser.AliasedTableExpr: switch table := tableExpr.Expr.(type) { case sqlparser.TableName: left = table.Name.String() } } switch tableExpr := expr.RightExpr.(type) { case *sqlparser.AliasedTableExpr: switch table := tableExpr.Expr.(type) { case sqlparser.TableName: right = table.Name.String() } } var cols []*common.Column for _, col := range using { if left != "" { cols = append(cols, &common.Column{ Name: col.String(), Table: left, Alias: make([]string, 0), }) } if right != "" { cols = append(cols, &common.Column{ Name: col.String(), Table: right, Alias: make([]string, 0), }) } } columns = append(columns, cols) } } return true, nil }, node) common.LogIfWarn(err, "") return columns } // FindEQColsInJoinCond 获取 join condition 中应转为whereEQ条件的列 func FindEQColsInJoinCond(node sqlparser.SQLNode) []*common.Column { common.Log.Debug("Enter: FindEQColsInJoinCond(), Caller: %s", common.Caller()) var columns []*common.Column err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case sqlparser.JoinCondition: columns = append(columns, FindEQColsInWhere(expr)...) } return true, nil }, node) common.LogIfWarn(err, "") return columns } // FindINEQColsInJoinCond 获取 join condition 中应转为whereINEQ条件的列 func FindINEQColsInJoinCond(node sqlparser.SQLNode) []*common.Column { common.Log.Debug("Enter: FindINEQColsInJoinCond(), Caller: %s", common.Caller()) var columns []*common.Column err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case sqlparser.JoinCondition: columns = append(columns, FindINEQColsInWhere(expr)...) } return true, nil }, node) common.LogIfWarn(err, "") return columns } // FindSubquery 拆分subquery,获取最深层的subquery // 为索引优化获取subquery中包含的列信息 func FindSubquery(depth int, node sqlparser.SQLNode, queries ...string) []string { common.Log.Debug("Enter: FindSubquery(), Caller: %s", common.Caller()) if queries == nil { queries = make([]string, 0) } err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { // 查找SQL中的子查询 case *sqlparser.Subquery: noSub := true // 查看子查询中是否还包含子查询,如果包含,递归找到最深层的子查询 err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch sub := node.(type) { case *sqlparser.Subquery: noSub = false // 查找深度depth,超过最大深度后不再向下查找 depth = depth + 1 if depth < common.Config.MaxSubqueryDepth { queries = append(queries, FindSubquery(depth, sub.Select)...) } } return true, nil }, expr.Select) common.LogIfWarn(err, "") // 如果没有嵌套的子查询了,返回子查询的SQL if noSub { sql := sqlparser.String(expr) // 去除SQL前后的括号 queries = append(queries, sql[1:len(sql)-1]) } } return true, nil }, node) common.LogIfWarn(err, "") return queries } // FindAllCondition 获取 AST 中所有的 condition 条件 func FindAllCondition(node sqlparser.SQLNode) []interface{} { common.Log.Debug("Enter: FindAllCondition(), Caller: %s", common.Caller()) var conditions []interface{} err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node := node.(type) { case *sqlparser.ComparisonExpr, *sqlparser.RangeCond, *sqlparser.IsExpr: conditions = append(conditions, node) } return true, nil }, node) common.LogIfWarn(err, "") return conditions } // Expression describe sql expression type type Expression string const ( // WhereExpression 用于标记 where WhereExpression Expression = "where" // JoinExpression 用于标记 join JoinExpression Expression = "join" // GroupByExpression 用于标记 group by GroupByExpression Expression = "group by" // OrderByExpression 用于标记 order by OrderByExpression Expression = "order by" ) // FindAllCols 获取 AST 中某个节点下所有的 columns func FindAllCols(node sqlparser.SQLNode, targets ...Expression) []*common.Column { var result []*common.Column // 获取节点内所有的列 f := func(node sqlparser.SQLNode) { err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch col := node.(type) { case *sqlparser.ColName: result = common.MergeColumn(result, &common.Column{ Name: col.Name.String(), Table: col.Qualifier.Name.String(), DB: col.Qualifier.Qualifier.String(), Alias: make([]string, 0), }) } return true, nil }, node) common.LogIfWarn(err, "") } if len(targets) == 0 { // 如果不指定具体节点类型,则获取全部的column f(node) } else { // 根据target获取所有的节点 for _, target := range targets { err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node := node.(type) { case *sqlparser.Subquery: // 忽略子查询 case *sqlparser.JoinTableExpr: if target == JoinExpression { f(node) } case *sqlparser.Where: if target == WhereExpression { f(node) } case sqlparser.GroupBy: if target == GroupByExpression { f(node) } case sqlparser.OrderBy: if target == OrderByExpression { f(node) } } return true, nil }, node) common.LogIfWarn(err, "") } } return result } // GetSubqueryDepth 获取一条SQL的嵌套深度 func GetSubqueryDepth(node sqlparser.SQLNode) int { depth := 1 err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch node.(type) { case *sqlparser.Subquery: depth++ } return true, nil }, node) common.LogIfWarn(err, "") return depth } // getColumnName 获取 node 中 column 具体的定义以及名称 func getColumnName(node sqlparser.SQLNode) (*sqlparser.ColName, string) { var colName *sqlparser.ColName str := "" switch c := node.(type) { case *sqlparser.ColName: if c.Qualifier.Name.IsEmpty() { str = fmt.Sprintf("`%s`", c.Name.String()) } else { if c.Qualifier.Qualifier.IsEmpty() { str = fmt.Sprintf("`%s`.`%s`", c.Qualifier.Name.String(), c.Name.String()) } else { str = fmt.Sprintf("`%s`.`%s`.`%s`", c.Qualifier.Qualifier.String(), c.Qualifier.Name.String(), c.Name.String()) } } colName = c } return colName, str } ================================================ FILE: ast/meta_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package ast import ( "flag" "fmt" "path/filepath" "runtime" "testing" "github.com/XiaoMi/soar/common" "github.com/kr/pretty" "vitess.io/vitess/go/vt/sqlparser" ) var update = flag.Bool("update", false, "update .golden files") func TestMain(m *testing.M) { // 初始化 init if common.DevPath == "" { _, file, _, _ := runtime.Caller(0) common.DevPath, _ = filepath.Abs(filepath.Dir(filepath.Join(file, ".."+string(filepath.Separator)))) } common.BaseDir = common.DevPath err := common.ParseConfig("") common.LogIfError(err, "init ParseConfig") common.Log.Debug("ast_test init") // 分割线 flag.Parse() m.Run() // 环境清理 // } func TestGetTableFromExprs(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) tbExprs := sqlparser.TableExprs{ &sqlparser.AliasedTableExpr{ Expr: sqlparser.TableName{ Name: sqlparser.NewTableIdent("table"), Qualifier: sqlparser.NewTableIdent("db"), }, As: sqlparser.NewTableIdent("as"), }, } meta := GetTableFromExprs(tbExprs) if tb, ok := meta["db"]; !ok { t.Errorf("no table qualifier, meta: %s", pretty.Sprint(tb)) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestGetParseTableWithStmt(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) for _, sql := range common.TestSQLs { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) if err != nil { t.Errorf("SQL Parsed error: %v", err) } meta := GetMeta(stmt, nil) pretty.Println(meta) fmt.Println() } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindCondition(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ `SELECT * FROM film WHERE length % 20 = 4;`, `select * from actor where actor_id = 1 order by if(first_name="PENELOPE", last_name, "") desc`, } for _, sql := range append(sqls, common.TestSQLs...) { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) // pretty.Println(stmt) if err != nil { panic(err) } eq := FindEQColsInWhere(stmt) inEq := FindINEQColsInWhere(stmt) fmt.Println("WhereEQ:") pretty.Println(eq) fmt.Println("WhereINEQ:") pretty.Println(inEq) fmt.Println() } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindGroupBy(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "select a from t group by c", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) if err != nil { panic(err) } res := FindGroupByCols(stmt) pretty.Println(res) fmt.Println() } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindOrderBy(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "select a from t group by c order by d, c desc", "select a from t group by c order by d desc", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) if err != nil { panic(err) } res := FindOrderByCols(stmt) pretty.Println(res) fmt.Println() } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindSubquery(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "SELECT * FROM t1 WHERE column1 = (SELECT column1 FROM (SELECT column1 FROM t2) a);", "select column1 from t2", "SELECT * FROM t1 WHERE column1 = (SELECT column1 FROM t2);", "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) if err != nil { panic(err) } subquery := FindSubquery(0, stmt) fmt.Println(len(subquery)) pretty.Println(subquery) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindJoinTable(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "SELECT * FROM t1 LEFT JOIN (t2 CROSS JOIN t3 CROSS JOIN t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", "SELECT * FROM t1 LEFT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT * FROM t1 RIGHT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT left_tbl.* FROM left_tbl LEFT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", "SELECT left_tbl.* FROM left_tbl RIGHT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) // pretty.Println(stmt) if err != nil { panic(err) } joinMeta := FindJoinTable(stmt, nil) pretty.Println(joinMeta) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindJoinCols(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "SELECT * FROM t1 LEFT JOIN (t2 CROSS JOIN t3 CROSS JOIN t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "select t from a LEFT JOIN b USING (c1, c2, c3)", "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", "SELECT * FROM t1 LEFT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT * FROM t1 RIGHT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT left_tbl.* FROM left_tbl LEFT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", "SELECT left_tbl.* FROM left_tbl RIGHT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) // pretty.Println(stmt) if err != nil { panic(err) } columns := FindJoinCols(stmt) pretty.Println(columns) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindJoinColBeWhereEQ(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", "SELECT * FROM t1 LEFT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT * FROM t1 RIGHT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT left_tbl.* FROM left_tbl LEFT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", "SELECT left_tbl.* FROM left_tbl RIGHT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) // pretty.Println(stmt) if err != nil { panic(err) } columns := FindEQColsInJoinCond(stmt) pretty.Println(columns) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindJoinColBeWhereINEQ(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", "SELECT * FROM t1 LEFT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT * FROM t1 RIGHT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b > 'b' AND t4.c = t1.c)", "SELECT left_tbl.* FROM left_tbl LEFT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", "SELECT left_tbl.* FROM left_tbl RIGHT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) // pretty.Println(stmt) if err != nil { panic(err) } columns := FindINEQColsInJoinCond(stmt) pretty.Println(columns) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindAllCondition(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "SELECT * FROM t1 LEFT JOIN (t2 CROSS JOIN t3 CROSS JOIN t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "select t from a LEFT JOIN b USING (c1, c2, c3)", "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", "SELECT * FROM t1 LEFT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT * FROM t1 RIGHT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT left_tbl.* FROM left_tbl LEFT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", "SELECT left_tbl.* FROM left_tbl RIGHT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", "SELECT * FROM t1 where a in ('a','b')", "SELECT * FROM t1 where a BETWEEN 'bar' AND 'foo'", "SELECT * FROM t1 where a = sum(a,b)", "SELECT distinct a FROM t1 where a = '2001-01-01 01:01:01'", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) // pretty.Println(stmt) if err != nil { panic(err) } columns := FindAllCondition(stmt) pretty.Println(columns) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindColumn(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "select col, col2, sum(col1) from tb group by col", "select col from tb group by col,sum(col1)", "select col, sum(col1) from tb group by col", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) // pretty.Println(stmt) if err != nil { panic(err) } columns := FindColumn(stmt) pretty.Println(columns) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindAllCols(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "select * from tb where a = '1' order by c", "select * from tb where a = '1' group by c", "select * from tb where c = '1' group by a", "select * from tb join tb2 on c = c where c = '1' group by a", } targets := []Expression{ OrderByExpression, GroupByExpression, WhereExpression, JoinExpression, } for i, sql := range sqlList { stmt, err := sqlparser.Parse(sql) if err != nil { t.Error(err) return } columns := FindAllCols(stmt, targets[i]) if columns[0].Name != "c" { fmt.Println(sql) t.Error(fmt.Errorf("want 'c' got %v", columns)) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestGetSubqueryDepth(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "SELECT * FROM t1 LEFT JOIN (t2 CROSS JOIN t3 CROSS JOIN t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "select t from a LEFT JOIN b USING (c1, c2, c3)", "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", "SELECT * FROM t1 LEFT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT * FROM t1 RIGHT JOIN (t2, t3, t4) ON (t2.a = t1.a AND t3.b = t1.b AND t4.c = t1.c)", "SELECT left_tbl.* FROM left_tbl LEFT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", "SELECT left_tbl.* FROM left_tbl RIGHT JOIN right_tbl ON left_tbl.id = right_tbl.id WHERE right_tbl.id IS NULL;", "SELECT * FROM t1 where a in ('a','b')", "SELECT * FROM t1 where a BETWEEN 'bar' AND 'foo'", "SELECT * FROM t1 where a = sum(a,b)", "SELECT distinct a FROM t1 where a = '2001-01-01 01:01:01'", } for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) if err != nil { t.Error("syntax check error.") } dep := GetSubqueryDepth(stmt) fmt.Println(dep) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestAppendTable(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqlList := []string{ "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", } meta := make(map[string]*common.DB) for _, sql := range sqlList { fmt.Println(sql) stmt, err := sqlparser.Parse(sql) if err != nil { t.Error("syntax check error.") } err = sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { switch expr := node.(type) { case *sqlparser.AliasedTableExpr: switch table := expr.Expr.(type) { case sqlparser.TableName: appendTable(table, expr.As.String(), meta) default: if meta == nil { meta = make(map[string]*common.DB) } if meta[""] == nil { meta[""] = common.NewDB("") } meta[""].Table[""] = common.NewTable("") meta[""].Table[""].TableAliases = append(meta[""].Table[""].TableAliases, expr.As.String()) } } return true, nil }, stmt) if err != nil { t.Error(err) } } // 仅对第一条测试SQL进行测试,验证别名正确性 if meta[""].Table["customer_list"].TableAliases[0] != "l" || meta[""].Table["city"].TableAliases[0] != "c" { t.Error("alias filed\n", pretty.Sprint(meta)) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: ast/node_array.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package ast import ( "errors" "github.com/XiaoMi/soar/common" "vitess.io/vitess/go/vt/sqlparser" ) // 该文件用于构造一个存储AST生成节点的链表 // 以能够更好的对AST中的每个节点进行查询、跳转、重建等 // NodeItem 链表节点 type NodeItem struct { ID int // NodeItem 在 List 中的编号,与顺序有关 Prev *NodeItem // 前一个节点 Self sqlparser.SQLNode // 自身指向的AST Node Next *NodeItem // 后一个节点 Array *NodeList // 指针指向所在的链表,用于快速跳转node } // NodeList 链表结构体 type NodeList struct { Length int Head *NodeItem NodeMap map[int]*NodeItem } // NewNodeList 从抽象语法树中构造一个链表 func NewNodeList(statement sqlparser.Statement) *NodeList { // 将AST构造成链表 l := &NodeList{NodeMap: make(map[int]*NodeItem)} err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) { l.Add(node) return true, nil }, statement) common.LogIfWarn(err, "") return l } // Add 将会把一个sqlparser.SQLNode添加到节点中 func (l *NodeList) Add(node sqlparser.SQLNode) *NodeItem { if l.Length == 0 { l.Head = &NodeItem{ ID: 0, Self: node, Next: nil, Prev: nil, Array: l, } l.NodeMap[l.Length] = l.Head } else { if n, ok := l.NodeMap[l.Length-1]; ok { n.Next = &NodeItem{ ID: l.Length - 1, Prev: n, Self: node, Next: nil, Array: l, } l.NodeMap[l.Length] = n.Next } } l.Length++ return l.NodeMap[l.Length-1] } // Remove 从链表中移除一个节点 func (l *NodeList) Remove(node *NodeItem) error { var err error defer func() { err := recover() if err != nil { common.Log.Error("func (l *NodeList) Remove recovered: %v", err) } }() if node.Array != l { return errors.New("node not belong to this array") } if node.Prev == nil { // 如果是头结点 node.Next.Prev = nil } else if node.Next == nil { // 如果是尾节点 node.Prev.Next = nil } else { // 删除节点,连接断开的链表 node.Prev.Next = node.Next node.Next.Prev = node.Prev delete(l.NodeMap, node.ID) } return err } // First 返回链表头结点 func (l *NodeList) First() *NodeItem { return l.Head } // Last 返回链表末尾节点 func (l *NodeList) Last() *NodeItem { return l.NodeMap[l.Length-1] } ================================================ FILE: ast/pretty.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package ast import ( "container/list" "regexp" "strings" "github.com/XiaoMi/soar/common" "github.com/percona/go-mysql/query" ) // Pretty 格式化输出SQL func Pretty(sql string, method string) (output string) { common.Log.Debug("Pretty, Query: %s, method: %s", sql, method) // 超出 Config.MaxPrettySQLLength 长度的 SQL 会对其指纹进行 pretty if len(sql) > common.Config.MaxPrettySQLLength { fingerprint := query.Fingerprint(sql) // 超出 Config.MaxPrettySQLLength 长度的指纹不会进行pretty if len(fingerprint) > common.Config.MaxPrettySQLLength { return sql } sql = fingerprint } switch method { case "builtin", "markdown": return format(sql) default: return sql } } // format the whitespace in a SQL string to make it easier to read. // @param string $query The SQL string // @return String The SQL string with HTML styles and formatting wrapped in a
 tag
func format(query string) string {
	// This variable will be populated with formatted html
	result := ""
	// Use an actual tab while formatting and then switch out with self::$tab at the end
	tab := "  "
	indentLevel := 0
	var newline bool
	var inlineParentheses bool
	var increaseSpecialIndent bool
	var increaseBlockIndent bool
	var addedNewline bool
	var inlineCount int
	var inlineIndented bool
	var clauseLimit bool
	indentTypes := list.New()

	// Tokenize String
	originalTokens := Tokenize(query)

	// Remove existing whitespace//
	var tokens []Token
	for i, token := range originalTokens {
		if token.Type != TokenTypeWhitespace {
			token.i = i
			tokens = append(tokens, token)
		}
	}

	for i, token := range tokens {
		highlighted := token.Val

		// If we are increasing the special indent level now
		if increaseSpecialIndent {
			indentLevel++
			increaseSpecialIndent = false
			indentTypes.PushFront("special")
		}

		// If we are increasing the block indent level now
		if increaseBlockIndent {
			indentLevel++
			increaseBlockIndent = false
			indentTypes.PushFront("block")
		}

		// If we need a new line before the token
		if newline {
			result += "\n" + strings.Repeat(tab, indentLevel)
			newline = false
			addedNewline = true
		} else {
			addedNewline = false
		}

		// Display comments directly where they appear in the source
		if token.Type == TokenTypeComment || token.Type == TokenTypeBlockComment {
			if token.Type == TokenTypeBlockComment {
				indent := strings.Repeat(tab, indentLevel)
				result += "\n" + indent
				highlighted = strings.Replace(highlighted, "\n", "\n"+indent, -1)
			}

			result += highlighted
			newline = true
			continue
		}

		if inlineParentheses {
			// End of inline parentheses
			if token.Val == ")" {
				result = strings.TrimRight(result, " ")

				if inlineIndented {
					indentTypes.Remove(indentTypes.Front())
					if indentLevel > 0 {
						indentLevel--
					}
					result += strings.Repeat(tab, indentLevel)
				}

				inlineParentheses = false

				result += highlighted + " "
				continue
			}

			if token.Val == "," {
				if inlineCount >= 30 {
					inlineCount = 0
					newline = true
				}
			}

			inlineCount += len(token.Val)
		}

		// Opening parentheses increase the block indent level and start a new line
		if token.Val == "(" {
			// First check if this should be an inline parentheses block
			// Examples are "NOW()", "COUNT(*)", "int(10)", key(`somecolumn`), DECIMAL(7,2)
			// Allow up to 3 non-whitespace tokens inside inline parentheses
			length := 0
			for j := 1; j <= 250; j++ {
				// Reached end of string
				if i+j >= len(tokens) {
					break
				}

				next := tokens[i+j]

				// Reached closing parentheses, able to inline it
				if next.Val == ")" {
					inlineParentheses = true
					inlineCount = 0
					inlineIndented = false
					break
				}

				// Reached an invalid token for inline parentheses
				if next.Val == ";" || next.Val == "(" {
					break
				}

				// Reached an invalid token type for inline parentheses
				if next.Type == TokenTypeReservedToplevel ||
					next.Type == TokenTypeReservedNewline ||
					next.Type == TokenTypeComment ||
					next.Type == TokenTypeBlockComment {
					break
				}

				length += len(next.Val)
			}

			if inlineParentheses && length > 30 {
				increaseBlockIndent = true
				inlineIndented = true
				newline = true
			}

			// Take out the preceding space unless there was whitespace there in the original query
			if token.i != 0 && (token.i-1) > len(originalTokens)-1 &&
				originalTokens[token.i-1].Type != TokenTypeWhitespace {

				result = strings.TrimRight(result, " ")
			}

			if inlineParentheses {
				increaseBlockIndent = true
				// Add a newline after the parentheses
				newline = true
			}

		} else if token.Val == ")" {
			// Closing parentheses decrease the block indent level
			// Remove whitespace before the closing parentheses
			result = strings.TrimRight(result, " ")

			if indentLevel > 0 {
				indentLevel--
			}

			// Reset indent level
			for j := indentTypes.Front(); indentTypes.Len() > 0; indentTypes.Remove(j) {
				if j.Value.(string) == "special" {
					if indentLevel > 0 {
						indentLevel--
					} else {
						break
					}
				} else {
					break
				}
			}

			if indentLevel < 0 {
				// This is an error
				indentLevel = 0
			}

			// Add a newline before the closing parentheses (if not already added)
			if !addedNewline {
				result += "\n" + strings.Repeat(tab, indentLevel)
			}

		} else if token.Type == TokenTypeReservedToplevel {
			// Top level reserved words start a new line and increase the special indent level
			increaseSpecialIndent = true

			// If the last indent type was 'special', decrease the special indent for this round
			if indentTypes.Len() > 0 && indentTypes.Front().Value.(string) == "special" {
				if indentLevel > 0 {
					indentLevel--
				}
				indentTypes.Remove(indentTypes.Front())
			}

			// Add a newline after the top level reserved word
			newline = true
			// Add a newline before the top level reserved word (if not already added)
			if !addedNewline {
				result += "\n" + strings.Repeat(tab, indentLevel)
			} else {
				// If we already added a newline, redo the indentation since it may be different now
				result = strings.TrimSuffix(result, tab) + strings.Repeat(tab, indentLevel)
			}

			// If the token may have extra whitespace
			if strings.Index(token.Val, " ") != 0 ||
				strings.Index(token.Val, "\n") != 0 ||
				strings.Index(token.Val, "\t") != 0 {

				re, _ := regexp.Compile(`\s+`)
				highlighted = re.ReplaceAllString(highlighted, " ")

			}

			//if SQL 'LIMIT' clause, start variable to reset newline
			if token.Val == "LIMIT" && inlineParentheses {
				clauseLimit = true
			}

		} else if clauseLimit && token.Val != "," &&
			token.Type != TokenTypeNumber &&
			token.Type != TokenTypeWhitespace {
			// Checks if we are out of the limit clause

			clauseLimit = false

		} else if token.Val == "," && !inlineParentheses {
			// Commas start a new line (unless within inline parentheses or SQL 'LIMIT' clause)
			if clauseLimit {
				newline = false
				clauseLimit = false
			} else {
				// All other cases of commas
				newline = true
			}

		} else if token.Type == TokenTypeReservedNewline {
			// Newline reserved words start a new line
			// Add a newline before the reserved word (if not already added)
			if !addedNewline {
				result += "\n" + strings.Repeat(tab, indentLevel)
			}

			// If the token may have extra whitespace
			if strings.Index(token.Val, " ") != 0 ||
				strings.Index(token.Val, "\n") != 0 ||
				strings.Index(token.Val, "\t") != 0 {

				re, _ := regexp.Compile(`\s+`)
				highlighted = re.ReplaceAllString(highlighted, " ")
			}

		} else if token.Type == TokenTypeBoundary {
			// Multiple boundary characters in a row should not have spaces between them (not including parentheses)
			if i != 0 && i < len(tokens) &&
				tokens[i-1].Type == TokenTypeBoundary {

				if token.i != 0 && token.i < len(originalTokens) &&
					originalTokens[token.i-1].Type != TokenTypeWhitespace {

					result = strings.TrimRight(result, " ")
				}
			}
		}

		// If the token shouldn't have a space before it
		if token.Val == "." || token.Val == "," || token.Val == ";" {
			result = strings.TrimRight(result, " ")
		}

		result += highlighted + " "

		// If the token shouldn't have a space after it
		if token.Val == "(" || token.Val == "." {
			result = strings.TrimRight(result, " ")
		}

		// If this is the "-" of a negative number, it shouldn't have a space after it
		if token.Val == "-" && i+1 < len(tokens) && tokens[i+1].Type == TokenTypeNumber && i != 0 {
			prev := tokens[i-1].Type
			if prev != TokenTypeQuote &&
				prev != TokenTypeBacktickQuote &&
				prev != TokenTypeWord &&
				prev != TokenTypeNumber {

				result = strings.TrimRight(result, " ")
			}
		}
	}

	// Replace tab characters with the configuration tab character
	result = strings.TrimRight(strings.Replace(result, "\t", tab, -1), " ")

	return result
}


================================================
FILE: ast/pretty_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ast

import (
	"fmt"
	"testing"

	"github.com/XiaoMi/soar/common"

	"vitess.io/vitess/go/vt/sqlparser"
)

var TestSqlsPretty = []string{
	"select sourcetable, if(f.lastcontent = ?, f.lastupdate, f.lastcontent) as lastactivity, f.totalcount as activity, type.class as type, (f.nodeoptions & ?) as nounsubscribe from node as f inner join contenttype as type on type.contenttypeid = f.contenttypeid inner join subscribed as sd on sd.did = f.nodeid and sd.userid = ? union all select f.name as title, f.userid as keyval, ? as sourcetable, ifnull(f.lastpost, f.joindate) as lastactivity, f.posts as activity, ? as type, ? as nounsubscribe from user as f inner join userlist as ul on ul.relationid = f.userid and ul.userid = ? where ul.type = ? and ul.aq = ? order by title limit ?",
	"administrator command: Init DB",
	"CALL foo(1, 2, 3)",
	"### Channels ###\n\u0009\u0009\u0009\u0009\u0009SELECT sourcetable, IF(f.lastcontent = 0, f.lastupdate, f.lastcontent) AS lastactivity,\n\u0009\u0009\u0009\u0009\u0009f.totalcount AS activity, type.class AS type,\n\u0009\u0009\u0009\u0009\u0009(f.nodeoptions \u0026 512) AS noUnsubscribe\n\u0009\u0009\u0009\u0009\u0009FROM node AS f\n\u0009\u0009\u0009\u0009\u0009INNER JOIN contenttype AS type ON type.contenttypeid = f.contenttypeid \n\n\u0009\u0009\u0009\u0009\u0009INNER JOIN subscribed AS sd ON sd.did = f.nodeid AND sd.userid = 15965\n UNION  ALL \n\n\u0009\u0009\u0009\u0009\u0009### Users ###\n\u0009\u0009\u0009\u0009\u0009SELECT f.name AS title, f.userid AS keyval, 'user' AS sourcetable, IFNULL(f.lastpost, f.joindate) AS lastactivity,\n\u0009\u0009\u0009\u0009\u0009f.posts as activity, 'Member' AS type,\n\u0009\u0009\u0009\u0009\u00090 AS noUnsubscribe\n\u0009\u0009\u0009\u0009\u0009FROM user AS f\n\u0009\u0009\u0009\u0009\u0009INNER JOIN userlist AS ul ON ul.relationid = f.userid AND ul.userid = 15965\n\u0009\u0009\u0009\u0009\u0009WHERE ul.type = 'f' AND ul.aq = 'yes'\n ORDER BY title ASC LIMIT 100",
	"CREATE DATABASE org235_percona345 COLLATE 'utf8_general_ci'",
	"insert into abtemp.coxed select foo.bar from foo",
	"insert into foo(a, b, c) value(2, 4, 5)",
	"insert into foo(a, b, c) values(2, 4, 5)",
	"insert into foo(a, b, c) values(2, 4, 5) , (2,4,5)",
	"insert into foo values (1, '(2)', 'This is a trick: ). More values.', 4)",
	"insert into tb values (1)",
	"INSERT INTO t (ts) VALUES ('()', '\\(', '\\)')",
	"INSERT INTO t (ts) VALUES (NOW())",
	"INSERT INTO t () VALUES ()",
	"insert into t values (1), (2), (3)\n\n\ton duplicate key update query_count=1",
	"insert into t values (1) on duplicate key update query_count=COALESCE(query_count, 0) + VALUES(query_count)",
	"LOAD DATA INFILE '/tmp/foo.txt' INTO db.tbl",
	"select 0e0, +6e-30, -6.00 from foo where a = 5.5 or b=0.5 or c=.5",
	"select 0x0, x'123', 0b1010, b'10101' from foo",
	"select 123_foo from 123_foo",
	"select 123foo from 123foo",
	`SELECT 	1 AS one FROM calls USE INDEX(index_name)`,
	"SELECT /*!40001 SQL_NO_CACHE */ * FROM `film`",
	"SELECT 'a' 'b' 'c' 'd' FROM kamil",
	"SELECT BENCHMARK(100000000, pow(rand(), rand())), 1 FROM `-hj-7d6-shdj5-7jd-kf-g988h-`.`-aaahj-7d6-shdj5-7&^%$jd-kf-g988h-9+4-5*6ab-`",
	"SELECT c FROM org235.t WHERE id=0xdeadbeaf",
	"select c from t where i=1 order by c asc",
	"SELECT c FROM t WHERE id=0xdeadbeaf",
	"SELECT c FROM t WHERE id=1",
	"select `col` from `table-1` where `id` = 5",
	"SELECT `db`.*, (CASE WHEN (`date_start` <=  '2014-09-10 09:17:59' AND `date_end` >=  '2014-09-10 09:17:59') THEN 'open' WHEN (`date_start` >  '2014-09-10 09:17:59' AND `date_end` >  '2014-09-10 09:17:59') THEN 'tbd' ELSE 'none' END) AS `status` FROM `foo` AS `db` WHERE (a_b in ('1', '10101'))",
	"select field from `-master-db-1`.`-table-1-` order by id, ?;",
	"select   foo",
	"select foo_1 from foo_2_3",
	"select foo -- bar\n",
	"select foo-- bar\n,foo",
	"select '\\\\' from foo",
	"select * from foo limit 5",
	"select * from foo limit 5, 10",
	"select * from foo limit 5 offset 10",
	"SELECT * from foo where a = 5",
	"select * from foo where a in (5) and b in (5, 8,9 ,9 , 10)",
	"SELECT '' '' '' FROM kamil",
	" select  * from\nfoo where a = 5",
	"SELECT * FROM prices.rt_5min where id=1",
	"SELECT * FROM table WHERE field = 'value' /*arbitrary/31*/ ",
	"SELECT * FROM table WHERE field = 'value' /*arbitrary31*/ ",
	"SELECT *    FROM t WHERE 1=1 AND id=1",
	"select * from t where (base.nid IN  ('1412', '1410', '1411'))",
	`select * from t where i=1      order            by
             a,  b          ASC, d    DESC,

                                    e asc`,
	"select * from t where i=1 order by a, b ASC, d DESC, e asc",
	"select 'hello'\n",
	"select 'hello', '\nhello\n', \"hello\", '\\'' from foo",
	"SELECT ID, name, parent, type FROM posts WHERE _name IN ('perf','caching') AND (type = 'page' OR type = 'attachment')",
	"SELECT name, value FROM variable",
	"select \n-- bar\n foo",
	"select null, 5.001, 5001. from foo",
	"select sleep(2) from test.n",
	"SELECT t FROM field WHERE  (entity_type = 'node') AND (entity_id IN  ('609')) AND (language IN  ('und')) AND (deleted = '0') ORDER BY delta ASC",
	"select  t.table_schema,t.table_name,engine  from information_schema.tables t  inner join information_schema.columns c  on t.table_schema=c.table_schema and t.table_name=c.table_name group by t.table_schema,t.table_name having  sum(if(column_key in ('PRI','UNI'),1,0))=0",
	"/* -- S++ SU ABORTABLE -- spd_user: rspadim */SELECT SQL_SMALL_RESULT SQL_CACHE DISTINCT centro_atividade FROM est_dia WHERE unidade_id=1001 AND item_id=67 AND item_id_red=573",
	`UPDATE groups_search SET  charter = '   -------3\'\' XXXXXXXXX.\n    \n    -----------------------------------------------------', show_in_list = 'Y' WHERE group_id='aaaaaaaa'`,
	"use `foo`",
	"select sourcetable, if(f.lastcontent = ?, f.lastupdate, f.lastcontent) as lastactivity, f.totalcount as activity, type.class as type, (f.nodeoptions & ?) as nounsubscribe from node as f inner join contenttype as type on type.contenttypeid = f.contenttypeid inner join subscribed as sd on sd.did = f.nodeid and sd.userid = ? union all select f.name as title, f.userid as keyval, ? as sourcetable, ifnull(f.lastpost, f.joindate) as lastactivity, f.posts as activity, ? as type, ? as nounsubscribe from user as f inner join userlist as ul on ul.relationid = f.userid and ul.userid = ? where ul.type = ? and ul.aq = ? order by title limit ?",
	"CREATE INDEX part_of_name ON customer (name(10));",
	"alter table `sakila`.`t1` add index `idx_col`(`col`)",
	"alter table `sakila`.`t1` add UNIQUE index `idx_col`(`col`)",
	"alter table `sakila`.`t1` add index `idx_ID`(`ID`)",

	// ADD|DROP COLUMN
	"ALTER TABLE t2 DROP COLUMN c, DROP COLUMN d;",
	"ALTER TABLE T2 ADD COLUMN C int;",
	"ALTER TABLE T2 ADD COLUMN D int FIRST;",
	"ALTER TABLE T2 ADD COLUMN E int AFTER D;",

	// RENAME COLUMN
	"ALTER TABLE t1 RENAME COLUMN a TO b",

	// RENAME INDEX
	"ALTER TABLE t1 RENAME INDEX idx_a TO idx_b",
	"ALTER TABLE t1 RENAME KEY idx_a TO idx_b",

	// RENAME TABLE
	"ALTER TABLE db.old_table RENAME new_table;",
	"ALTER TABLE old_table RENAME TO new_table;",
	"ALTER TABLE old_table RENAME AS new_table;",

	// MODIFY & CHANGE
	"ALTER TABLE t1 MODIFY col1 BIGINT UNSIGNED DEFAULT 1 COMMENT 'my column';",
	"ALTER TABLE t1 CHANGE b a INT NOT NULL;",

	// COMMENT
	"/*!40000 select 1*/;",
}

func TestPretty(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	err := common.GoldenDiff(func() {
		for _, sql := range append(TestSqlsPretty, common.TestSQLs...) {
			fmt.Println(sql)
			fmt.Println(Pretty(sql, "builtin"))
		}
		orgMaxPrettySQLLength := common.Config.MaxPrettySQLLength
		common.Config.MaxPrettySQLLength = 1
		fmt.Println(Pretty("select 1", "builtin"))
		common.Config.MaxPrettySQLLength = orgMaxPrettySQLLength
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestIsKeyword(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	tks := map[string]bool{
		"AGAINST":        true,
		"AUTO_INCREMENT": true,
		"ADD":            true,
		"BETWEEN":        true,
		".":              false,
		"actions":        false,
		`"`:              false,
		":":              false,
	}
	for tk, v := range tks {
		if IsMysqlKeyword(tk) != v {
			t.Error("isKeyword:", tk)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRemoveComments(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	for _, sql := range TestSqlsPretty {
		stmt, _ := sqlparser.Parse(sql)
		newSQL := sqlparser.String(stmt)
		if newSQL != sql {
			fmt.Print(newSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}


================================================
FILE: ast/rewrite.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ast

import (
	"bytes"
	"encoding/json"
	"fmt"
	"github.com/pingcap/parser/ast"
	"reflect"
	"regexp"
	"strings"

	"github.com/XiaoMi/soar/common"

	"github.com/kr/pretty"
	"vitess.io/vitess/go/vt/sqlparser"
)

// Rule SQL重写规则
type Rule struct {
	Name        string                  `json:"Name"`
	Description string                  `json:"Description"`
	Original    string                  `json:"Original"` // 错误示范。为空或"暂不支持"不会出现在list-rewrite-rules中
	Suggest     string                  `json:"Suggest"`  // 正确示范。
	Func        func(*Rewrite) *Rewrite `json:"-"`        // 如果不定义 Func 需要多条 SQL 联动改写
}

// RewriteRules SQL重写规则,注意这个规则是有序的,先后顺序不能乱
var RewriteRules []Rule

func init() {
	RewriteRules = []Rule{
		{
			Name:        "dml2select",
			Description: "将数据库更新请求转换为只读查询请求,便于执行EXPLAIN",
			Original:    "DELETE FROM film WHERE length > 100",
			Suggest:     "select * from film where length > 100",
			Func:        (*Rewrite).RewriteDML2Select,
		},
		{
			Name:        "reg2select",
			Description: "使用正则的方式将数据库更新请求转换为只读查询请求,便于执行EXPLAIN",
			Original:    "DELETE FROM film WHERE length > 100",
			Suggest:     "select * from film where length > 100",
			Func:        (*Rewrite).RewriteReg2Select,
		},
		{
			Name:        "star2columns",
			Description: "为SELECT *补全表的列信息",
			Original:    "SELECT * FROM film",
			Suggest:     "select film.film_id, film.title from film",
			Func:        (*Rewrite).RewriteStar2Columns,
		},
		{
			Name:        "insertcolumns",
			Description: "为INSERT补全表的列信息",
			Original:    "insert into film values(1,2,3,4,5)",
			Suggest:     "insert into film(film_id, title, description, release_year, language_id) values (1, 2, 3, 4, 5)",
			Func:        (*Rewrite).RewriteInsertColumns,
		},
		{
			Name:        "having",
			Description: "将查询的 HAVING 子句改写为 WHERE 中的查询条件",
			Original:    "SELECT state, COUNT(*) FROM Drivers GROUP BY state HAVING state IN ('GA', 'TX') ORDER BY state",
			Suggest:     "select state, COUNT(*) from Drivers where state in ('GA', 'TX') group by state order by state asc",
			Func:        (*Rewrite).RewriteHaving,
		},
		{
			Name:        "orderbynull",
			Description: "如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 ORDER BY NULL",
			Original:    "SELECT sum(col1) FROM tbl GROUP BY col",
			Suggest:     "select sum(col1) from tbl group by col order by null",
			Func:        (*Rewrite).RewriteAddOrderByNull,
		},
		{
			Name:        "unionall",
			Description: "可以接受重复的时间,使用 UNION ALL 替代 UNION 以提高查询效率",
			Original:    "select country_id from city union select country_id from country",
			Suggest:     "select country_id from city union all select country_id from country",
			Func:        (*Rewrite).RewriteUnionAll,
		},
		{
			Name:        "or2in",
			Description: "将同一列不同条件的 OR 查询转写为 IN 查询",
			Original:    "select country_id from city where col1 = 1 or (col2 = 1 or col2 = 2 ) or col1 = 3;",
			Suggest:     "select country_id from city where (col2 in (1, 2)) or col1 in (1, 3);",
			Func:        (*Rewrite).RewriteOr2In,
		},
		{
			Name:        "innull",
			Description: "如果 IN 条件中可能有 NULL 值而又想匹配 NULL 值时,建议添加OR col IS NULL",
			Original:    "暂不支持",
			Suggest:     "暂不支持",
			Func:        (*Rewrite).RewriteInNull,
		},
		// 把所有跟 or 相关的重写完之后才进行 or 转 union 的重写
		{
			Name:        "or2union",
			Description: "将不同列的 OR 查询转为 UNION 查询,建议结合 unionall 重写策略一起使用",
			Original:    "暂不支持",
			Suggest:     "暂不支持",
			Func:        (*Rewrite).RewriteOr2Union,
		},
		{
			Name:        "dmlorderby",
			Description: "删除 DML 更新操作中无意义的 ORDER BY",
			Original:    "DELETE FROM tbl WHERE col1=1 ORDER BY col",
			Suggest:     "delete from tbl where col1 = 1",
			Func:        (*Rewrite).RewriteRemoveDMLOrderBy,
		},
		/*
			{
				Name:        "groupbyconst",
				Description: "删除无意义的GROUP BY常量",
				Original:    "SELECT sum(col1) FROM tbl GROUP BY 1;",
				Suggest:     "select sum(col1) from tbl",
				Func:        (*Rewrite).RewriteGroupByConst,
			},
		*/
		{
			Name:        "sub2join",
			Description: "将子查询转换为JOIN查询",
			Original:    "暂不支持",
			Suggest:     "暂不支持",
			Func:        (*Rewrite).RewriteSubQuery2Join,
		},
		{
			Name:        "join2sub",
			Description: "将JOIN查询转换为子查询",
			Original:    "暂不支持",
			Suggest:     "暂不支持",
			Func:        (*Rewrite).RewriteJoin2SubQuery,
		},
		{
			Name:        "distinctstar",
			Description: "DISTINCT *对有主键的表没有意义,可以将DISTINCT删掉",
			Original:    "SELECT DISTINCT * FROM film;",
			Suggest:     "SELECT * FROM film",
			Func:        (*Rewrite).RewriteDistinctStar,
		},
		{
			Name:        "standard",
			Description: "SQL标准化,如:关键字转换为小写",
			Original:    "SELECT sum(col1) FROM tbl GROUP BY 1;",
			Suggest:     "select sum(col1) from tbl group by 1",
			Func:        (*Rewrite).RewriteStandard,
		},
		{
			Name:        "mergealter",
			Description: "合并同一张表的多条ALTER语句",
			Original:    "ALTER TABLE t2 DROP COLUMN c;ALTER TABLE t2 DROP COLUMN d;",
			Suggest:     "ALTER TABLE t2 DROP COLUMN c, DROP COLUMN d;",
		},
		{
			Name:        "alwaystrue",
			Description: "删除无用的恒真判断条件",
			Original:    "SELECT count(col) FROM tbl where 'a'= 'a' or ('b' = 'b' and a = 'b');",
			Suggest:     "select count(col) from tbl where (a = 'b');",
			Func:        (*Rewrite).RewriteAlwaysTrue,
		},
		{
			Name:        "countstar",
			Description: "不建议使用COUNT(col)或COUNT(常量),建议改写为COUNT(*)",
			Original:    "SELECT count(col) FROM tbl GROUP BY 1;",
			Suggest:     "SELECT count(*) FROM tbl GROUP BY 1;",
			Func:        (*Rewrite).RewriteCountStar,
		},
		{
			Name:        "innodb",
			Description: "建表时建议使用InnoDB引擎,非 InnoDB 引擎表自动转 InnoDB",
			Original:    "CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT);",
			Suggest:     "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=InnoDB;",
			Func:        (*Rewrite).RewriteInnoDB,
		},
		{
			Name:        "autoincrement",
			Description: "将autoincrement初始化为1",
			Original:    "CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT) ENGINE=InnoDB AUTO_INCREMENT=123802;",
			Suggest:     "create table t1(id bigint(20) not null auto_increment) ENGINE=InnoDB auto_increment=1;",
			Func:        (*Rewrite).RewriteAutoIncrement,
		},
		{
			Name:        "intwidth",
			Description: "整型数据类型修改默认显示宽度",
			Original:    "create table t1 (id int(20) not null auto_increment) ENGINE=InnoDB;",
			Suggest:     "create table t1 (id int(10) not null auto_increment) ENGINE=InnoDB;",
			Func:        (*Rewrite).RewriteIntWidth,
		},
		{
			Name:        "truncate",
			Description: "不带 WHERE 条件的 DELETE 操作建议修改为 TRUNCATE",
			Original:    "DELETE FROM tbl",
			Suggest:     "truncate table tbl",
			Func:        (*Rewrite).RewriteTruncate,
		},
		{
			Name:        "rmparenthesis",
			Description: "去除没有意义的括号",
			Original:    "select col from table where (col = 1);",
			Suggest:     "select col from table where col = 1;",
			Func:        (*Rewrite).RewriteRmParenthesis,
		},
		// delimiter要放在最后,不然补不上
		{
			Name:        "delimiter",
			Description: "补全DELIMITER",
			Original:    "use sakila",
			Suggest:     "use sakila;",
			Func:        (*Rewrite).RewriteDelimiter,
		},
		// TODO in to exists
		// TODO exists to in
	}
}

// ListRewriteRules 打印SQL重写规则
func ListRewriteRules(rules []Rule) {
	switch common.Config.ReportType {
	case "json":
		js, err := json.MarshalIndent(rules, "", "  ")
		if err == nil {
			fmt.Println(string(js))
		}
	default:

		fmt.Print("# 重写规则\n\n[toc]\n\n")
		for _, r := range rules {
			if !common.Config.Verbose && (r.Original == "" || r.Original == "暂不支持") {
				continue
			}

			fmt.Print("## ", common.MarkdownEscape(r.Name),
				"\n* **Description**:", r.Description+"\n",
				"\n* **Original**:\n\n```sql\n", r.Original, "\n```\n",
				"\n* **Suggest**:\n\n```sql\n", r.Suggest, "\n```\n")

		}
	}
}

// Rewrite 用于重写SQL
type Rewrite struct {
	SQL     string
	NewSQL  string
	Stmt    sqlparser.Statement
	Columns common.TableColumns
}

// NewRewrite 返回一个*Rewrite对象,如果SQL无法被正常解析,将错误输出到日志中,返回一个nil
func NewRewrite(sql string) *Rewrite {
	stmt, err := sqlparser.Parse(sql)
	if err != nil {
		common.Log.Error(err.Error(), sql)
		return nil
	}

	return &Rewrite{
		SQL:  sql,
		Stmt: stmt,
	}
}

// Rewrite 入口函数
func (rw *Rewrite) Rewrite() *Rewrite {
	defer func() {
		if err := recover(); err != nil {
			common.Log.Error("Query rewrite Error: %s, maybe hit a bug.\nQuery: %s \nAST: %s",
				err, rw.SQL, pretty.Sprint(rw.Stmt))
			return
		}
	}()

	for _, rule := range RewriteRules {
		if RewriteRuleMatch(rule.Name) && rule.Func != nil {
			rule.Func(rw)
			common.Log.Debug("Rewrite Rule:%s Output NewSQL: %s", rule.Name, rw.NewSQL)
		}
	}
	if rw.NewSQL == "" {
		rw.NewSQL = rw.SQL
	}
	rw.Stmt, _ = sqlparser.Parse(rw.NewSQL)

	// TODO: 重新前后返回结果一致性对比

	// TODO: 前后SQL性能对比
	return rw
}

// RewriteDelimiter delimiter: 补分号,可以指定不同的DELIMITER
func (rw *Rewrite) RewriteDelimiter() *Rewrite {
	if rw.NewSQL != "" {
		rw.NewSQL = strings.TrimSuffix(rw.NewSQL, common.Config.Delimiter) + common.Config.Delimiter
	} else {
		rw.NewSQL = strings.TrimSuffix(rw.SQL, common.Config.Delimiter) + common.Config.Delimiter
	}
	return rw
}

// RewriteStandard standard: 使用 vitess 提供的 String 功能将抽象语法树转写回 SQL,注意:这可能转写失败。
func (rw *Rewrite) RewriteStandard() *Rewrite {
	if _, err := sqlparser.Parse(rw.SQL); err == nil {
		rw.NewSQL = sqlparser.String(rw.Stmt)
	}
	return rw
}

// RewriteAlwaysTrue always true: 删除恒真条件
func (rw *Rewrite) RewriteAlwaysTrue() (reWriter *Rewrite) {
	array := NewNodeList(rw.Stmt)
	tNode := array.Head
	for {
		omitAlwaysTrue(tNode)
		tNode = tNode.Next
		if tNode == nil {
			break
		}
	}

	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// isAlwaysTrue 用于判断ComparisonExpr是否是恒真
func isAlwaysTrue(expr *sqlparser.ComparisonExpr) bool {
	if expr == nil {
		return true
	}

	var result bool
	switch expr.Operator {
	case "<>":
		expr.Operator = "!="
	case "<=>":
		expr.Operator = "="
	case ">=", "<=", "!=", "=", ">", "<":
	default:
		return false
	}

	var left []byte
	var right []byte

	// left
	switch l := expr.Left.(type) {
	case *sqlparser.SQLVal:
		left = l.Val
	default:
		return false
	}

	// right
	switch r := expr.Right.(type) {
	case *sqlparser.SQLVal:
		right = r.Val
	default:
		return false
	}

	switch expr.Operator {
	case "=":
		result = bytes.Equal(left, right)
	case "!=":
		result = !bytes.Equal(left, right)
	case ">":
		result = bytes.Compare(left, right) > 0
	case ">=":
		result = bytes.Compare(left, right) >= 0
	case "<":
		result = bytes.Compare(left, right) < 0
	case "<=":
		result = bytes.Compare(left, right) <= 0
	default:
		result = false
	}

	return result
}

// omitAlwaysTrue 移除AST中的恒真条件
func omitAlwaysTrue(node *NodeItem) {
	if node == nil {
		return
	}

	switch self := node.Self.(type) {
	case *sqlparser.Where:
		if self != nil {
			switch cond := self.Expr.(type) {
			case *sqlparser.ComparisonExpr:
				if isAlwaysTrue(cond) {
					self.Expr = nil
				}
			case *sqlparser.ParenExpr:
				if cond.Expr == nil {
					self.Expr = nil
				}
			}
		}
	case *sqlparser.ParenExpr:
		if self != nil {
			switch cond := self.Expr.(type) {
			case *sqlparser.ComparisonExpr:
				if isAlwaysTrue(cond) {
					self.Expr = nil
				}
			}
		}
	case *sqlparser.AndExpr:
		if self != nil {
			var tmp sqlparser.Expr
			isRightTrue := false
			isLeftTrue := false
			tmp = nil

			// 查看左树的情况
			switch l := self.Left.(type) {
			case *sqlparser.ComparisonExpr:
				if isAlwaysTrue(l) {
					self.Left = nil
					isLeftTrue = true
					tmp = self.Right
				}
			case *sqlparser.ParenExpr:
				if l.Expr == nil {
					self.Left = nil
					isLeftTrue = true
					tmp = self.Right
				}
			default:
				if l == nil {
					isLeftTrue = true
					tmp = self.Right
				}
			}

			// 查看右树的情况
			switch r := self.Right.(type) {
			case *sqlparser.ComparisonExpr:
				if isAlwaysTrue(r) {
					self.Right = nil
					isRightTrue = true
					tmp = self.Left
				}
			case *sqlparser.ParenExpr:
				if r.Expr == nil {
					self.Right = nil
					isRightTrue = true
					tmp = self.Left
				}
			default:
				if r == nil {
					isRightTrue = true
					tmp = self.Left
				}
			}

			if isRightTrue && isLeftTrue {
				tmp = nil
			} else if !isLeftTrue && !isRightTrue {
				return
			}

			// 根据类型开始替换节点
			switch l := node.Prev.Self.(type) {
			case *sqlparser.Where:
				l.Expr = tmp
			case *sqlparser.ParenExpr:
				l.Expr = tmp
			case *sqlparser.AndExpr:
				if l.Left == self {
					l.Left = tmp
				} else if l.Right == self {
					l.Right = tmp
				}
			case *sqlparser.OrExpr:
				if l.Left == self {
					l.Left = tmp
				} else if l.Right == self {
					l.Right = tmp
				}
			default:
				// 未匹配到对应数据类型则从链表中移除该节点
				err := node.Array.Remove(node.Prev)
				common.LogIfError(err, "")
			}

		}

	case *sqlparser.OrExpr:
		// 与AndExpr相同
		if self != nil {
			var tmp sqlparser.Expr
			isRightTrue := false
			isLeftTrue := false
			tmp = nil

			switch l := self.Left.(type) {
			case *sqlparser.ComparisonExpr:
				if isAlwaysTrue(l) {
					self.Left = nil
					isLeftTrue = true
					tmp = self.Right
				}
			case *sqlparser.ParenExpr:
				if l.Expr == nil {
					self.Left = nil
					isLeftTrue = true
					tmp = self.Right
				}
			default:
				if l == nil {
					isLeftTrue = true
					tmp = self.Right
				}
			}

			switch r := self.Right.(type) {
			case *sqlparser.ComparisonExpr:
				if isAlwaysTrue(r) {
					self.Right = nil
					isRightTrue = true
					tmp = self.Left
				}
			case *sqlparser.ParenExpr:
				if r.Expr == nil {
					self.Right = nil
					isRightTrue = true
					tmp = self.Left
				}
			default:
				if r == nil {
					isRightTrue = true
					tmp = self.Left
				}
			}

			if isRightTrue && isLeftTrue {
				tmp = nil
			} else if !isLeftTrue && !isRightTrue {
				return
			}

			switch l := node.Prev.Self.(type) {
			case *sqlparser.Where:
				l.Expr = tmp
			case *sqlparser.ParenExpr:
				l.Expr = tmp
			case *sqlparser.AndExpr:
				if l.Left == self {
					l.Left = tmp
				} else if l.Right == self {
					l.Right = tmp
				}
			case *sqlparser.OrExpr:
				if l.Left == self {
					l.Left = tmp
				} else if l.Right == self {
					l.Right = tmp
				}
			default:
				err := node.Array.Remove(node.Prev)
				common.LogIfError(err, "")
			}
		}
	}

	omitAlwaysTrue(node.Prev)
}

// RewriteCountStar countstar: 将COUNT(col)改写为COUNT(*)
// COUNT(DISTINCT col)不能替换为COUNT(*)
func (rw *Rewrite) RewriteCountStar() *Rewrite {
	err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
		switch f := node.(type) {
		case *sqlparser.FuncExpr:
			if strings.ToLower(f.Name.String()) == "count" && len(f.Exprs) > 0 {
				switch colExpr := f.Exprs[0].(type) {
				case *sqlparser.AliasedExpr:
					switch col := colExpr.Expr.(type) {
					case *sqlparser.ColName:
						f.Exprs[0] = &sqlparser.StarExpr{TableName: col.Qualifier}
					}
				}
			}
		}
		return true, nil
	}, rw.Stmt)
	common.LogIfError(err, "")
	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteInnoDB InnoDB: 为未指定 Engine 的表默认添加 InnoDB 引擎,将其他存储引擎转为 InnoDB
func (rw *Rewrite) RewriteInnoDB() *Rewrite {
	switch create := rw.Stmt.(type) {
	case *sqlparser.DDL:
		if create.Action != "create" {
			return rw
		}

		if strings.Contains(strings.ToLower(create.TableSpec.Options), "engine=") {
			reg := regexp.MustCompile(`(?i)engine=[a-z]+`)
			create.TableSpec.Options = reg.ReplaceAllString(create.TableSpec.Options, "ENGINE=InnoDB ")
		} else {
			create.TableSpec.Options = " ENGINE=InnoDB " + create.TableSpec.Options
		}

	}

	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteAutoIncrement autoincrement: 将auto_increment设置为1
func (rw *Rewrite) RewriteAutoIncrement() *Rewrite {
	switch create := rw.Stmt.(type) {
	case *sqlparser.DDL:
		if create.Action != "create" || create.TableSpec == nil {
			return rw
		}
		if strings.Contains(strings.ToLower(create.TableSpec.Options), "auto_increment=") {
			reg := regexp.MustCompile(`(?i)auto_increment=[0-9]+`)
			create.TableSpec.Options = reg.ReplaceAllString(create.TableSpec.Options, "auto_increment=1 ")
		}
	}

	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteIntWidth intwidth: int 类型转为 int(10),bigint 类型转为 bigint(20)
func (rw *Rewrite) RewriteIntWidth() *Rewrite {
	switch create := rw.Stmt.(type) {
	case *sqlparser.DDL:
		if create.Action != "create" || create.TableSpec == nil {
			return rw
		}
		for _, col := range create.TableSpec.Columns {
			switch col.Type.Type {
			case "int", "integer":
				if col.Type.Length != nil &&
					(string(col.Type.Length.Val) != "10" && string(col.Type.Length.Val) != "11") {
					col.Type.Length = sqlparser.NewIntVal([]byte("10"))
				}
			case "bigint":
				if col.Type.Length != nil && string(col.Type.Length.Val) != "20" || col.Type.Length == nil {
					col.Type.Length = sqlparser.NewIntVal([]byte("20"))
				}
			default:
			}
		}
	}

	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteStar2Columns star2columns: 对应COL.001,SELECT补全*指代的列名
func (rw *Rewrite) RewriteStar2Columns() *Rewrite {
	// 如果未配置mysql环境或从环境中获取失败,*不进行替换
	if common.Config.TestDSN.Disable || len(rw.Columns) == 0 {
		common.Log.Debug("(rw *Rewrite) RewriteStar2Columns(): Rewrite failed. TestDSN.Disable: %v, len(rw.Columns):%d",
			common.Config.TestDSN.Disable, len(rw.Columns))
		return rw
	}

	// 单张表 select * 不补全表名,避免SQL过长,多张表的 select tb1.*, tb2.* 需要补全表名
	var multiTable bool
	if len(rw.Columns) > 1 {
		multiTable = true
	} else {
		for db := range rw.Columns {
			if len(rw.Columns[db]) > 1 {
				multiTable = true
			}
		}
	}

	err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
		switch n := node.(type) {
		case *sqlparser.Select:

			// select * 可能出现的情况:
			// 1. select * from tb;
			// 2. select * from tb1,tb2;
			// 3. select tb1.* from tb1;
			// 4. select tb1.*,tb2.col from tb1,tb2;
			// 5. select db.tb1.* from tb1;
			// 6. select db.tb1.*,db.tb2.col from db.tb1,db.tb2;

			newSelectExprs := make(sqlparser.SelectExprs, 0)
			for _, expr := range n.SelectExprs {
				switch e := expr.(type) {
				case *sqlparser.StarExpr:
					// 一般情况下最外层循环不会超过两层
					for _, tables := range rw.Columns {
						for _, cols := range tables {
							for _, col := range cols {
								var table string
								if multiTable {
									table = col.Table
								}
								newExpr := &sqlparser.AliasedExpr{
									Expr: &sqlparser.ColName{
										Metadata: nil,
										Name:     sqlparser.NewColIdent(col.Name),
										Qualifier: sqlparser.TableName{
											Name: sqlparser.NewTableIdent(table),
											// 因为不建议跨DB的查询,所以这里的db前缀将不进行补齐
											Qualifier: sqlparser.TableIdent{},
										},
									},
									As: sqlparser.ColIdent{},
								}

								if e.TableName.Name.IsEmpty() {
									// 情况1,2
									newSelectExprs = append(newSelectExprs, newExpr)
								} else {
									// 其他情况下只有在匹配表名的时候才会进行替换
									if e.TableName.Name.String() == col.Table {
										newSelectExprs = append(newSelectExprs, newExpr)
									}
								}
							}
						}
					}
				default:
					newSelectExprs = append(newSelectExprs, e)
				}
			}

			n.SelectExprs = newSelectExprs
		}
		return true, nil
	}, rw.Stmt)
	common.LogIfError(err, "")
	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteInsertColumns insertcolumns: 对应COL.002,INSERT补全列名
func (rw *Rewrite) RewriteInsertColumns() *Rewrite {

	switch insert := rw.Stmt.(type) {
	case *sqlparser.Insert:
		switch insert.Action {
		case "insert", "replace":
			if insert.Columns != nil {
				return rw
			}

			newColumns := make(sqlparser.Columns, 0)
			db := insert.Table.Qualifier.String()
			table := insert.Table.Name.String()
			// 支持INSERT/REPLACE INTO VALUES形式,支持INSERT/REPLACE INTO SELECT
			colCount := 0
			switch v := insert.Rows.(type) {
			case sqlparser.Values:
				if len(v) > 0 {
					colCount = len(v[0])
				}

			case *sqlparser.Select:
				if l := len(v.SelectExprs); l > 0 {
					colCount = l
				}
			}

			// 开始对ast进行替换,补全前N列
			counter := 0
			for dbName, tb := range rw.Columns {
				for tbName, cols := range tb {
					for _, col := range cols {
						// 只有全部列补全完成的时候才会替换ast
						if counter == colCount {
							insert.Columns = newColumns
							rw.NewSQL = sqlparser.String(rw.Stmt)
							return rw
						}

						if db != "" {
							// 指定了DB的时候,只能怼指定DB的列
							if db == dbName && table == tbName {
								newColumns = append(newColumns, sqlparser.NewColIdent(col.Name))
								counter++
							}
						} else {
							// 没有指定DB的时候,将column中的列按顺序往里怼
							if table == tbName {
								newColumns = append(newColumns, sqlparser.NewColIdent(col.Name))
								counter++
							}
						}
					}
				}
			}
		}
	}
	return rw
}

// RewriteHaving having: 对应CLA.013,使用 WHERE 过滤条件替代 HAVING
func (rw *Rewrite) RewriteHaving() *Rewrite {
	err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
		switch n := node.(type) {
		case *sqlparser.Select:
			if n.Having != nil {
				if n.Where == nil {
					// WHERE 条件为空直接用 HAVING 替代 WHERE 即可
					n.Where = n.Having
				} else {
					// WHERE 条件不为空,需要对已有的条件进行括号保护,然后再 AND+HAVING
					n.Where = &sqlparser.Where{
						Expr: &sqlparser.AndExpr{
							Left: &sqlparser.ParenExpr{
								Expr: n.Where.Expr,
							},
							Right: n.Having.Expr,
						},
					}
				}
				// 别忘了重置 HAVING 和 Where.Type
				n.Where.Type = "where"
				n.Having = nil
			}
		}
		return true, nil
	}, rw.Stmt)
	common.LogIfError(err, "")
	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteAddOrderByNull orderbynull: 对应 CLA.008,GROUP BY 无排序要求时添加 ORDER BY NULL
func (rw *Rewrite) RewriteAddOrderByNull() *Rewrite {
	err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
		switch n := node.(type) {
		case *sqlparser.Select:
			if n.GroupBy != nil && n.OrderBy == nil {
				n.OrderBy = sqlparser.OrderBy{
					&sqlparser.Order{
						Expr:      &sqlparser.NullVal{},
						Direction: "asc",
					},
				}
			}
		}
		return true, nil
	}, rw.Stmt)
	common.LogIfError(err, "")
	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteOr2Union or2union: 将 OR 查询转写为 UNION ALL TODO: 暂无对应 HeuristicRules
// TODO: https://sqlperformance.com/2014/09/sql-plan/rewriting-queries-improve-performance
func (rw *Rewrite) RewriteOr2Union() *Rewrite {
	return rw
}

// RewriteUnionAll unionall: 不介意重复数据的情况下使用 union all 替换 union
func (rw *Rewrite) RewriteUnionAll() *Rewrite {
	err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
		switch n := node.(type) {
		case *sqlparser.Union:
			n.Type = "union all"
		}
		return true, nil
	}, rw.Stmt)
	common.LogIfError(err, "")
	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteOr2In or2in: 同一列的 OR 过滤条件使用 IN() 替代,如果值有相等的会进行合并
func (rw *Rewrite) RewriteOr2In() *Rewrite {
	// 通过 AST 生成 node 的双向链表,链表顺序为书写顺序
	nodeList := NewNodeList(rw.Stmt)
	tNode := nodeList.First()

	for {
		tNode.or2in()
		if tNode.Next == nil {
			break
		}
		tNode = tNode.Next
	}

	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// or2in 用于将 or 转换成 in
func (node *NodeItem) or2in() {
	if node == nil || node.Self == nil {
		return
	}

	switch selfNode := node.Self.(type) {
	case *sqlparser.OrExpr:
		newExpr := mergeExprs(selfNode.Left, selfNode.Right)
		if newExpr != nil {
			// or 自身两个节点可以合并的情况下,将父节点中的 expr 替换成新的
			switch pre := node.Prev.Self.(type) {
			case *sqlparser.OrExpr:
				if pre.Left == node.Self {
					node.Self = newExpr
					pre.Left = newExpr
				} else if pre.Right == node.Self {
					node.Self = newExpr
					pre.Right = newExpr
				}
			case *sqlparser.AndExpr:
				if pre.Left == node.Self {
					node.Self = newExpr
					pre.Left = newExpr
				} else if pre.Right == node.Self {
					node.Self = newExpr
					pre.Right = newExpr
				}
			case *sqlparser.Where:
				node.Self = newExpr
				pre.Expr = newExpr
			case *sqlparser.ParenExpr:
				// 如果 SQL 书写中带了括号,暂不会进行跨括号的合并
				// TODO: 无意义括号打平,加个 rewrite rule
				node.Self = newExpr
				pre.Expr = newExpr
			}
		} else {
			// or 自身两个节点如不可以合并,则检测是否可以与父节点合并
			// 与父节点的合并不能跨越and、括号等,可能会改变语义
			// 检查自身左右节点是否能与上层节点中合并,or 只能与 or 合并
			switch pre := node.Prev.Self.(type) {
			case *sqlparser.OrExpr:
				// AST 中如果出现复合条件,则一定在左树,所以只需要判断左边就可以
				if pre.Left == selfNode {
					switch n := pre.Right.(type) {
					case *sqlparser.ComparisonExpr:
						newLeftExpr := mergeExprs(selfNode.Left, n)
						newRightExpr := mergeExprs(selfNode.Right, n)

						// newLeftExpr 与 newRightExpr 一定有一个是 nil,
						// 否则说明该 orExpr 下的两个节点可合并,可以通过最后的向前递归合并 pre 节点中的 expr
						if newLeftExpr == nil || newRightExpr == nil {
							if newLeftExpr != nil {
								pre.Right = newLeftExpr
								pre.Left = selfNode.Right
								err := node.Array.Remove(node)
								common.LogIfError(err, "")
							}

							if newRightExpr != nil {
								pre.Right = newRightExpr
								pre.Left = selfNode.Left
								err := node.Array.Remove(node)
								common.LogIfError(err, "")
							}
						}
					}
				}
			}
		}
	}

	// 逆向合并由更改 AST 后产生的新的可合并节点
	node.Prev.or2in()
}

// mergeExprs 将两个属于同一个列的 ComparisonExpr 合并成一个,如果不能合并则返回 nil
func mergeExprs(left, right sqlparser.Expr) *sqlparser.ComparisonExpr {
	// 用于对比两个列是否相同
	colInLeft := ""
	colInRight := ""
	lOperator := ""
	rOperator := ""

	// 用于存放 expr 左右子树中的值
	var values []sqlparser.SQLNode

	// SQL 中使用到的列
	var colName *sqlparser.ColName

	// 左子树
	switch l := left.(type) {
	case *sqlparser.ComparisonExpr:
		// 获取列名
		colName, colInLeft = getColumnName(l.Left)
		// 获取值
		if colInLeft != "" {
			switch v := l.Right.(type) {
			case *sqlparser.SQLVal, sqlparser.ValTuple, *sqlparser.BoolVal, *sqlparser.NullVal:
				values = append(values, v)
			}
		}
		// 获取 operator
		lOperator = l.Operator
	default:
		return nil
	}

	// 右子树
	switch r := right.(type) {
	case *sqlparser.ComparisonExpr:
		// 获取列名
		if colName.Name.String() != "" {
			common.Log.Warn("colName shouldn't has value, but now it's %s", colName.Name.String())
		}
		colName, colInRight = getColumnName(r.Left)
		// 获取值
		if colInRight != "" {
			switch v := r.Right.(type) {
			case *sqlparser.SQLVal, sqlparser.ValTuple, *sqlparser.BoolVal, *sqlparser.NullVal:
				values = append(values, v)
			}
		}
		// 获取 operator
		rOperator = r.Operator
	default:
		return nil
	}

	// operator 替换,用于在之后判断是否可以合并
	switch lOperator {
	case "in", "=":
		lOperator = "="
	default:
		return nil
	}

	switch rOperator {
	case "in", "=":
		rOperator = "="
	default:
		return nil
	}

	// 不匹配则返回
	if colInLeft == "" || colInLeft != colInRight ||
		lOperator == "" || lOperator != rOperator {
		return nil
	}

	// 合并左右子树的值
	newValTuple := make(sqlparser.ValTuple, 0)
	for _, v := range values {
		switch v := v.(type) {
		case *sqlparser.SQLVal:
			newValTuple = append(newValTuple, v)
		case *sqlparser.BoolVal:
			newValTuple = append(newValTuple, v)
		case *sqlparser.NullVal:
			newValTuple = append(newValTuple, v)
		case sqlparser.ValTuple:
			newValTuple = append(newValTuple, v...)
		}
	}

	// 去 expr 中除重复的 value,
	newValTuple = removeDup(newValTuple...)
	newExpr := &sqlparser.ComparisonExpr{
		Operator: "in",
		Left:     colName,
		Right:    newValTuple,
	}
	// 如果只有一个值则是一个等式,没有必要转写成 in
	if len(newValTuple) == 1 {
		newExpr = &sqlparser.ComparisonExpr{
			Operator: lOperator,
			Left:     colName,
			Right:    newValTuple[0],
		}
	}

	return newExpr
}

// removeDup 清除 sqlparser.ValTuple 中重复的值
func removeDup(vt ...sqlparser.Expr) sqlparser.ValTuple {
	uni := make(sqlparser.ValTuple, 0)
	m := make(map[string]sqlparser.SQLNode)

	for _, value := range vt {
		switch v := value.(type) {
		case *sqlparser.SQLVal:
			// Type:Val, 冒号用于分隔 Type 和 Val,防止两种不同类型拼接后出现同一个值
			if _, ok := m[fmt.Sprint(v.Type)+":"+sqlparser.String(v)]; !ok {
				uni = append(uni, v)
				m[fmt.Sprint(v.Type)+":"+sqlparser.String(v)] = v
			}
		case *sqlparser.BoolVal:
			if _, ok := m[sqlparser.String(v)]; !ok {
				uni = append(uni, v)
				m[sqlparser.String(v)] = v
			}
		case *sqlparser.NullVal:
			if _, ok := m[sqlparser.String(v)]; !ok {
				uni = append(uni, v)
				m[sqlparser.String(v)] = v
			}
		case sqlparser.ValTuple:
			for _, val := range removeDup(v...) {
				switch v := val.(type) {
				case *sqlparser.SQLVal:
					if _, ok := m[fmt.Sprint(v.Type)+":"+sqlparser.String(v)]; !ok {
						uni = append(uni, v)
						m[fmt.Sprint(v.Type)+":"+sqlparser.String(v)] = v
					}
				case *sqlparser.BoolVal:
					if _, ok := m[sqlparser.String(v)]; !ok {
						uni = append(uni, v)
						m[sqlparser.String(v)] = v
					}
				case *sqlparser.NullVal:
					if _, ok := m[sqlparser.String(v)]; !ok {
						uni = append(uni, v)
						m[sqlparser.String(v)] = v
					}
				}
			}
		}
	}

	return uni
}

// RewriteInNull innull: TODO: 对应ARG.004
func (rw *Rewrite) RewriteInNull() *Rewrite {
	return rw
}

// RewriteRmParenthesis rmparenthesis: 去除无意义的括号
func (rw *Rewrite) RewriteRmParenthesis() *Rewrite {
	rw.rmParenthesis()
	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// rmParenthesis 用于语出无用的括号
func (rw *Rewrite) rmParenthesis() {
	continueFlag := false
	err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
		switch node := node.(type) {
		case *sqlparser.Where:
			if node == nil {
				return true, nil
			}
			switch paren := node.Expr.(type) {
			case *sqlparser.ParenExpr:
				switch paren.Expr.(type) {
				case *sqlparser.ComparisonExpr:
					node.Expr = paren.Expr
					continueFlag = true
				}
			}

		case *sqlparser.ParenExpr:
			switch paren := node.Expr.(type) {
			case *sqlparser.ParenExpr:
				switch paren.Expr.(type) {
				case *sqlparser.ComparisonExpr:
					node.Expr = paren.Expr
					continueFlag = true
				}
			}

		case *sqlparser.AndExpr:
			switch left := node.Left.(type) {
			case *sqlparser.ParenExpr:
				switch inner := left.Expr.(type) {
				case *sqlparser.ComparisonExpr:
					node.Left = inner
					continueFlag = true
				}
			}

			switch right := node.Right.(type) {
			case *sqlparser.ParenExpr:
				switch inner := right.Expr.(type) {
				case *sqlparser.ComparisonExpr:
					node.Right = inner
					continueFlag = true
				}
			}

		case *sqlparser.OrExpr:
			switch left := node.Left.(type) {
			case *sqlparser.ParenExpr:
				switch inner := left.Expr.(type) {
				case *sqlparser.ComparisonExpr:
					node.Left = inner
					continueFlag = true
				}
			}

			switch right := node.Right.(type) {
			case *sqlparser.ParenExpr:
				switch inner := right.Expr.(type) {
				case *sqlparser.ComparisonExpr:
					node.Right = inner
					continueFlag = true
				}
			}
		}
		return true, nil
	}, rw.Stmt)
	common.LogIfError(err, "")
	// 本层的修改可能使得原本不符合条件的括号变为无意义括号
	// 每次修改都需要再过滤一遍语法树
	if continueFlag {
		rw.rmParenthesis()
	} else {
		return
	}
}

// RewriteRemoveDMLOrderBy dmlorderby: 对应 RES.004,删除无 LIMIT 条件时 UPDATE, DELETE 中包含的 ORDER BY
func (rw *Rewrite) RewriteRemoveDMLOrderBy() *Rewrite {
	switch st := rw.Stmt.(type) {
	case *sqlparser.Update:
		err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
			switch n := node.(type) {
			case *sqlparser.Select:
				if n.OrderBy != nil && n.Limit == nil {
					n.OrderBy = nil
				}
				return false, nil
			}
			return true, nil
		}, rw.Stmt)
		common.LogIfError(err, "")
		if st.OrderBy != nil && st.Limit == nil {
			st.OrderBy = nil
		}
	case *sqlparser.Delete:
		err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
			switch n := node.(type) {
			case *sqlparser.Select:
				if n.OrderBy != nil && n.Limit == nil {
					n.OrderBy = nil
				}
				return false, nil
			}
			return true, nil
		}, rw.Stmt)
		common.LogIfError(err, "")
		if st.OrderBy != nil && st.Limit == nil {
			st.OrderBy = nil
		}
	}
	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteGroupByConst 对应CLA.004,将GROUP BY CONST替换为列名
// TODO:
func (rw *Rewrite) RewriteGroupByConst() *Rewrite {
	err := sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
		switch n := node.(type) {
		case *sqlparser.Select:
			groupByCol := false
			if n.GroupBy != nil {
				for _, group := range n.GroupBy {
					switch group.(type) {
					case *sqlparser.SQLVal:
					default:
						groupByCol = true
					}
				}
				if !groupByCol {
					// TODO: 这里只是去掉了GROUP BY并没解决问题
					n.GroupBy = nil
				}
			}
		}
		return true, nil
	}, rw.Stmt)
	common.LogIfError(err, "")
	rw.NewSQL = sqlparser.String(rw.Stmt)
	return rw
}

// RewriteSubQuery2Join 将 subquery 转写成 join
func (rw *Rewrite) RewriteSubQuery2Join() *Rewrite {
	var err error
	// 如果未配置 mysql 环境或从环境中获取失败
	if common.Config.TestDSN.Disable || len(rw.Columns) == 0 {
		common.Log.Debug("(rw *Rewrite) RewriteSubQuery2Join(): Rewrite failed. TestDSN.Disable: %v, len(rw.Columns):%d",
			common.Config.TestDSN.Disable, len(rw.Columns))
		return rw
	}

	if rw.NewSQL == "" {
		rw.NewSQL = sqlparser.String(rw.Stmt)
	}

	// query backup
	backup := rw.NewSQL
	var subQueryList []string
	err = sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
		switch sub := node.(type) {
		case sqlparser.SelectStatement:
			subStr := sqlparser.String(sub)
			if strings.HasPrefix(subStr, "(") {
				subStr = subStr[1 : len(subStr)-1]
			}
			subQueryList = append(subQueryList, subStr)
		}
		return true, nil
	}, rw.Stmt)
	common.LogIfError(err, "")
	if length := len(subQueryList); length > 1 {
		lastResult := ""
		for i := length - 1; i > 0; i-- {
			if lastResult == "" {
				lastResult, err = rw.sub2Join(subQueryList[i-1], subQueryList[i])
			} else {
				// 将subquery的部分替换成上次合并的结果
				subQueryList[i-1] = strings.Replace(subQueryList[i-1], subQueryList[i], lastResult, -1)
				lastResult, err = rw.sub2Join(subQueryList[i-1], lastResult)
			}

			if err != nil {
				common.Log.Error("RewriteSubQuery2Join Error: %v", err)
				return rw
			}
		}
		rw.NewSQL = lastResult
	} else if length == 1 {
		var newSQL string
		newSQL, err = rw.sub2Join(rw.NewSQL, subQueryList[0])
		if err == nil {
			rw.NewSQL = newSQL
		}
	}

	// 因为这个修改不会直接修改rw.stmt,所以需要将rw.stmt也更新一下
	newStmt, err := sqlparser.Parse(rw.NewSQL)
	if err != nil {
		rw.NewSQL = backup
		rw.Stmt, _ = sqlparser.Parse(backup)
	} else {
		rw.Stmt = newStmt
	}

	return rw
}

// sub2Join 将 subquery 转写成 join
func (rw *Rewrite) sub2Join(parent, sub string) (string, error) {
	// 只处理SelectStatement
	if sqlparser.Preview(parent) != sqlparser.StmtSelect || sqlparser.Preview(sub) != sqlparser.StmtSelect {
		return "", nil
	}

	// 如果子查询不属于parent,则不处理
	if !strings.Contains(parent, sub) {
		return "", nil
	}

	// 解析外层SQL语法树
	stmt, err := sqlparser.Parse(parent)
	if err != nil {
		common.Log.Warn("(rw *Rewrite) RewriteSubQuery2Join() sub2Join sql `%s` parsed error: %v", parent, err)
		return "", err
	}

	switch stmt.(type) {
	case sqlparser.SelectStatement:
	default:
		common.Log.Debug("Query `%s` not select statement.", parent)
		return "", nil
	}

	// 解析子查询语法树
	subStmt, err := sqlparser.Parse(sub)
	if err != nil {
		common.Log.Warn("(rw *Rewrite) RewriteSubQuery2Join() sub2Join sql `%s` parsed error: %v", sub, err)
		return "", err
	}

	// 获取外部SQL用到的表
	stmtMeta := GetTableFromExprs(stmt.(*sqlparser.Select).From)
	// 获取内部SQL用到的表
	subMeta := GetTableFromExprs(subStmt.(*sqlparser.Select).From)

	// 处理关联条件
	err = sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
		switch p := node.(type) {
		case *sqlparser.ComparisonExpr:
			// a in (select * from tb)
			switch subquery := p.Right.(type) {
			case *sqlparser.Subquery:

				// 获取左边的列
				var leftColumn *sqlparser.ColName

				switch l := p.Left.(type) {
				case *sqlparser.ColName:
					leftColumn = l
				default:
					return false, nil
				}

				// 用于存放获取的subquery中的列,有且只有一个
				var rightColumn sqlparser.SQLNode

				// 对subquery中的列进行替换
				switch subSelectStmt := subquery.Select.(type) {
				case *sqlparser.Select:
					cachingOperator := p.Operator

					rightColumn = subSelectStmt.SelectExprs[0]

					rightCol, _ := getColumnName(rightColumn.(*sqlparser.AliasedExpr).Expr)
					if rightCol != nil {
						// 将subquery替换为等值条件
						p.Operator = "="

						// selectExpr 信息补齐
						var newExprs []sqlparser.SelectExpr
						err = sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
							switch col := node.(type) {
							case *sqlparser.StarExpr:
								if col.TableName.Name.IsEmpty() {
									for dbName, db := range stmtMeta {
										for tbName := range db.Table {

											col.TableName.Name = sqlparser.NewTableIdent(tbName)
											if dbName != "" {
												col.TableName.Qualifier = sqlparser.NewTableIdent(dbName)
											}

											newExprs = append(newExprs, col)
										}
									}
								}
							case *sqlparser.AliasedExpr:
								switch n := col.Expr.(type) {
								case *sqlparser.ColName:
									col.Expr = columnFromWhere(n, stmtMeta, rw.Columns)
								}
							}
							return true, nil
						}, stmt.(*sqlparser.Select).SelectExprs)
						common.LogIfError(err, "")

						// 原节点列信息补齐
						p.Left = columnFromWhere(leftColumn, stmtMeta, rw.Columns)

						// 将子查询中的节点上提,补充前缀信息
						p.Right = columnFromWhere(rightCol, subMeta, rw.Columns)

						// subquery Where条件中的列信息补齐
						subWhereExpr := subStmt.(*sqlparser.Select).Where
						err = sqlparser.Walk(func(node sqlparser.SQLNode) (kontinue bool, err error) {
							switch n := node.(type) {
							case *sqlparser.ComparisonExpr:
								switch left := n.Left.(type) {
								case *sqlparser.ColName:
									n.Left = columnFromWhere(left, subMeta, rw.Columns)
								}

								switch right := n.Right.(type) {
								case *sqlparser.ColName:
									n.Right = columnFromWhere(right, subMeta, rw.Columns)
								}
							}
							return true, nil
						}, subWhereExpr)
						common.LogIfError(err, "")
						// 如果 subquery 中存在 Where 条件,怼在 parent 的 where 中后面
						if subWhereExpr != nil {
							if stmt.(*sqlparser.Select).Where != nil {
								stmt.(*sqlparser.Select).Where.Expr = &sqlparser.AndExpr{
									Left:  stmt.(*sqlparser.Select).Where.Expr,
									Right: subWhereExpr.Expr,
								}
							} else {
								stmt.(*sqlparser.Select).Where = subWhereExpr
							}
						}

						switch cachingOperator {
						case "in":
							// 将表以 inner join 的形式追加到 parent 的 from 中
							var newTables []sqlparser.TableExpr
							for _, subExpr := range subStmt.(*sqlparser.Select).From {
								has := false
								for _, expr := range stmt.(*sqlparser.Select).From {
									if reflect.DeepEqual(expr, subExpr) {
										has = true
									}
								}
								if !has {
									newTables = append(newTables, subExpr)
								}
							}
							stmt.(*sqlparser.Select).From = append(stmt.(*sqlparser.Select).From, newTables...)
						case "not in":
							// 将表以left join 的形式 追加到 parent 的 from 中
							// TODO:
						}
					}

				}
			}
		}
		return true, nil
	}, stmt)
	common.LogIfError(err, "")
	newSQL := sqlparser.String(stmt)
	return newSQL, nil
}

// columnFromWhere 获取列是来自哪个表,并补充前缀
func columnFromWhere(col *sqlparser.ColName, meta common.Meta, columns common.TableColumns) *sqlparser.ColName {

	for dbName, db := range meta {
		for tbName := range db.Table {
			for _, tables := range columns {
				for _, columns := range tables {
					for _, column := range columns {
						if strings.EqualFold(col.Name.String(), column.Name) {
							if col.Qualifier.Name.IsEmpty() && tbName == column.Table {
								col.Qualifier.Name = sqlparser.NewTableIdent(column.Table)
								return col
							}
							if (dbName == "" && tbName == column.Table) || (tbName == column.Table && dbName == column.DB) {
								col.Qualifier.Name = sqlparser.NewTableIdent(column.Table)
								if dbName != "" {
									col.Qualifier.Qualifier = sqlparser.NewTableIdent(column.DB)
								}
								return col
							}
						}
					}
				}
			}

		}
	}
	return col
}

// RewriteJoin2SubQuery join2sub: TODO:
// https://mariadb.com/kb/en/library/subqueries-and-joins/
func (rw *Rewrite) RewriteJoin2SubQuery() *Rewrite {
	return rw
}

// RewriteDistinctStar distinctstar: 对应DIS.003,将多余的`DISTINCT *`删除
func (rw *Rewrite) RewriteDistinctStar() *Rewrite {
	// 注意:这里并未对表是否有主键做检查,按照我们的SQL编程规范,一张表必须有主键
	switch rw.Stmt.(type) {
	case *sqlparser.Select:
		meta := GetMeta(rw.Stmt, nil)
		for _, m := range meta {
			if len(m.Table) == 1 {
				// distinct tbl.*, distinct *, count(distinct *)
				re := regexp.MustCompile(`(?i)((distinct\s*\*)|(distinct\s+[0-9a-z_` + "`" + `]*\.\*))`)
				if re.MatchString(rw.SQL) {
					rw.NewSQL = re.ReplaceAllString(rw.SQL, "*")
				}
			}
			break
		}
	}
	if rw.NewSQL == "" {
		rw.NewSQL = rw.SQL
	}
	rw.Stmt, _ = sqlparser.Parse(rw.NewSQL)
	return rw
}

// RewriteTruncate truncate: DELETE 全表修改为 TRUNCATE TABLE
func (rw *Rewrite) RewriteTruncate() *Rewrite {
	switch n := rw.Stmt.(type) {
	case *sqlparser.Delete:
		meta := GetMeta(rw.Stmt, nil)
		if len(meta) == 1 && n.Where == nil {
			for _, db := range meta {
				for _, tbl := range db.Table {
					rw.NewSQL = "truncate table " + tbl.TableName
				}
			}
		}
	}
	return rw
}

// RewriteDML2Select dml2select: DML 转成 SELECT,兼容低版本的 EXPLAIN
func (rw *Rewrite) RewriteDML2Select() *Rewrite {
	if rw.Stmt == nil {
		return rw
	}

	switch stmt := rw.Stmt.(type) {
	case *sqlparser.Select:
		rw.NewSQL = rw.SQL
	case *sqlparser.Delete: // Multi DELETE not support yet.
		rw.NewSQL = delete2Select(stmt)
	case *sqlparser.Insert:
		rw.NewSQL = insert2Select(stmt)
	case *sqlparser.Update: // Multi UPDATE not support yet.
		rw.NewSQL = update2Select(stmt)
	}
	rw.Stmt, _ = sqlparser.Parse(rw.NewSQL)
	return rw
}

func (rw *Rewrite) RewriteReg2Select() *Rewrite {
	var pre = 9
	if len(rw.SQL) < pre {
		// SQL to short no need convert
		return rw
	}
	if strings.HasPrefix(strings.ToLower(rw.SQL[:pre]), "select") {
		rw.NewSQL = rw.SQL
	}
	if strings.HasPrefix(strings.ToLower(rw.SQL[:pre]), "update") {
		rw.NewSQL = regUpdate2Select(rw.SQL)
	}
	if strings.HasPrefix(strings.ToLower(rw.SQL[:pre]), "delete") {
		rw.NewSQL = regDelete2Select(rw.SQL)
	}
	return rw
}

// delete2Select 将 Delete 语句改写成 Select
func delete2Select(stmt *sqlparser.Delete) string {
	newSQL := &sqlparser.Select{
		SelectExprs: []sqlparser.SelectExpr{
			new(sqlparser.StarExpr),
		},
		From:    stmt.TableExprs,
		Where:   stmt.Where,
		OrderBy: stmt.OrderBy,
	}
	return sqlparser.String(newSQL)
}

// regDelete2Select convert delete to select by regexp
func regDelete2Select(sql string) string {
	sql = strings.TrimSpace(sql)
	sqlRegexp := regexp.MustCompile(`^(?i)delete\s+from\s+(.*)$`)
	params := sqlRegexp.FindStringSubmatch(sql)
	if len(params) > 1 {
		return fmt.Sprintf(`select * from %s`, params[1])
	}
	return sql
}

// update2Select 将 Update 语句改写成 Select
func update2Select(stmt *sqlparser.Update) string {
	newSQL := &sqlparser.Select{
		SelectExprs: []sqlparser.SelectExpr{
			new(sqlparser.StarExpr),
		},
		From:    stmt.TableExprs,
		Where:   stmt.Where,
		OrderBy: stmt.OrderBy,
		Limit:   stmt.Limit,
	}
	return sqlparser.String(newSQL)
}

// regUpdate2Select convert update to select by regexp
func regUpdate2Select(sql string) string {
	sql = strings.TrimSpace(sql)
	sqlRegexp := regexp.MustCompile(`^(?i)update\s+(.*)\s+set\s+(.*)\s+(where\s+.*)$`)
	params := sqlRegexp.FindStringSubmatch(sql)
	if len(params) > 2 {
		return fmt.Sprintf(`select * from %s %s`, params[1], params[3])
	}
	return sql
}

// insert2Select 将 Insert 语句改写成 Select
func insert2Select(stmt *sqlparser.Insert) string {
	switch row := stmt.Rows.(type) {
	// 如果insert包含子查询,只需要explain该子树
	case *sqlparser.Select, *sqlparser.Union, *sqlparser.ParenSelect:
		return sqlparser.String(row)
	}

	return "select 1 from DUAL"
}

// AlterAffectTable 获取ALTER影响的库表名,返回:`db`.`table`
func AlterAffectTable(stmt sqlparser.Statement) string {
	switch n := stmt.(type) {
	case *sqlparser.DDL:
		tableName := strings.ToLower(n.Table.Name.String())
		dbName := strings.ToLower(n.Table.Qualifier.String())
		if tableName != "" && tableName != "dual" {
			if dbName == "" {
				return "`" + tableName + "`"
			}

			return "`" + dbName + "`.`" + tableName + "`"
		}
	}
	return ""
}

// MergeAlterTables mergealter: 将同一张表的多条 ALTER 语句合成一条 ALTER 语句
// @input: sql, alter string
// @output: [[db.]table]sql, 如果找不到 DB,key 为表名;如果找得到 DB,key 为 db.table
func MergeAlterTables(sqls ...string) map[string]string {
	alterSQLs := make(map[string][]string)
	mergedAlterStr := make(map[string]string)

	// table/column/index name can be quoted in back ticks
	backTicks := "(`[^\\s]*`)"

	alterExp := regexp.MustCompile(`(?i)alter\s*table\s*(` + backTicks + `|([^\s]*))\s*`)   // ALTER TABLE
	renameExp := regexp.MustCompile(`(?i)rename\s*table\s*(` + backTicks + `|([^\s]*))\s*`) // RENAME TABLE
	// CREATE [UNIQUE|FULLTEXT|SPATIAL|PRIMARY] [KEY|INDEX] idx_name ON tbl_name
	createIndexExp := regexp.MustCompile(`(?i)create((unique)|(fulltext)|(spatial)|(primary)|(\s*)\s*)((index)|(key))\s*`)
	indexNameExp := regexp.MustCompile(`(?i)(` + backTicks + `|([^\s]*))\s*`)

	for _, sql := range sqls {
		sql = strings.Trim(sql, common.Config.Delimiter)
		stmts, err := TiParse(sql, "", "")
		if err != nil {
			common.Log.Warn(err.Error())
			continue
		}
		// stmt, _ := sqlparser.Parse(sql)
		alterSQL := ""
		dbName := ""
		tableName := ""
		for _, stmt := range stmts {
			switch n := stmt.(type) {
			case *ast.AlterTableStmt:
				// 注意: 表名和库名不区分大小写
				tableName = n.Table.Name.L
				dbName = n.Table.Schema.L
				if alterExp.MatchString(sql) {
					common.Log.Debug("rename alterExp: ALTER %v %v", tableName, alterExp.ReplaceAllString(sql, ""))
					alterSQL = fmt.Sprint(alterExp.ReplaceAllString(sql, ""))
				}
			case *ast.CreateIndexStmt:
				tableName = n.Table.Name.L
				dbName = n.Table.Schema.L

				buf := createIndexExp.ReplaceAllString(sql, "")
				idxName := strings.TrimSpace(indexNameExp.FindString(buf))
				buf = string([]byte(buf)[strings.Index(buf, "("):])
				common.Log.Error(buf)
				common.Log.Debug("alter createIndexExp: ALTER %v ADD INDEX %v %v", tableName, "ADD INDEX", idxName, buf)
				alterSQL = fmt.Sprint("ADD INDEX", " "+idxName+" ", buf)
			case *ast.RenameTableStmt:
				// 注意: 表名和库名不区分大小写
				tableName = n.TableToTables[0].OldTable.Name.L
				dbName = n.TableToTables[0].OldTable.Schema.L
				if alterExp.MatchString(sql) {
					common.Log.Debug("rename alterExp: ALTER %v %v", tableName, alterExp.ReplaceAllString(sql, ""))
					alterSQL = fmt.Sprint(alterExp.ReplaceAllString(sql, ""))
				} else if renameExp.MatchString(sql) {
					common.Log.Debug("rename renameExp: ALTER %v %v", tableName, alterExp.ReplaceAllString(sql, ""))
					alterSQL = fmt.Sprint(alterExp.ReplaceAllString(sql, ""))
				} else {
					common.Log.Warn("rename not match: ALTER %v %v", tableName, sql)
				}
			default:
			}
		}

		if alterSQL != "" && tableName != "" && tableName != "dual" {
			if dbName == "" {
				alterSQLs["`"+tableName+"`"] = append(alterSQLs["`"+tableName+"`"], alterSQL)
			} else {
				alterSQLs["`"+dbName+"`.`"+tableName+"`"] = append(alterSQLs["`"+dbName+"`.`"+tableName+"`"], alterSQL)
			}
		}
	}
	for k, v := range alterSQLs {
		mergedAlterStr[k] = fmt.Sprintln("ALTER TABLE", k, strings.Join(v, ", "), common.Config.Delimiter)
	}
	return mergedAlterStr
}

// RewriteRuleMatch 检查重写规则是否生效
func RewriteRuleMatch(name string) bool {
	for _, r := range common.Config.RewriteRules {
		if r == name {
			return true
		}
	}
	return false
}


================================================
FILE: ast/rewrite_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ast

import (
	"fmt"
	"sort"
	"testing"

	"github.com/XiaoMi/soar/common"
)

func TestRewrite(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	orgTestDSNStatus := common.Config.TestDSN.Disable
	common.Config.TestDSN.Disable = false
	testSQL := []map[string]string{
		{
			"input":  `SELECT * FROM film`,
			"output": `select film_id, title, description, release_year, language_id, original_language_id, rental_duration from film;`,
		},
		{
			"input":  `SELECT film.*, actor.actor_id FROM film,actor`,
			"output": `select film_id, title, description, release_year, language_id, original_language_id, rental_duration, actor.actor_id from film, actor;`,
		},
		{
			"input":  `insert into film values(1,2,3,4,5)`,
			"output": `insert into film(film_id, title, description, release_year, language_id) values (1, 2, 3, 4, 5);`,
		},
		{
			"input":  `insert into sakila.film values(1,2)`,
			"output": `insert into sakila.film(film_id, title) values (1, 2);`,
		},
		{
			"input":  `replace into sakila.film select id from tb`,
			"output": `replace into sakila.film(film_id) select id from tb;`,
		},
		{
			"input":  `replace into sakila.film select id, title, description from tb`,
			"output": `replace into sakila.film(film_id, title, description) select id, title, description from tb;`,
		},
		{
			"input":  `insert into film values(1,2,3,4,5)`,
			"output": `insert into film(film_id, title, description, release_year, language_id) values (1, 2, 3, 4, 5);`,
		},
		{
			"input":  `insert into sakila.film values(1,2)`,
			"output": `insert into sakila.film(film_id, title) values (1, 2);`,
		},
		{
			"input":  `replace into sakila.film select id from tb`,
			"output": `replace into sakila.film(film_id) select id from tb;`,
		},
		{
			"input":  `replace into sakila.film select id, title, description from tb`,
			"output": `replace into sakila.film(film_id, title, description) select id, title, description from tb;`,
		},
		{
			"input":  "DELETE FROM tbl WHERE col1=1 ORDER BY col",
			"output": "delete from tbl where col1 = 1;",
		},
		{
			"input":  "UPDATE tbl SET col =1 WHERE col1=1 ORDER BY col",
			"output": "update tbl set col = 1 where col1 = 1;",
		},
	}

	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"])
		rw.Columns = map[string]map[string][]*common.Column{
			"sakila": {
				"film": {
					{Name: "film_id", Table: "film"},
					{Name: "title", Table: "film"},
					{Name: "description", Table: "film"},
					{Name: "release_year", Table: "film"},
					{Name: "language_id", Table: "film"},
					{Name: "original_language_id", Table: "film"},
					{Name: "rental_duration", Table: "film"},
				},
			},
		}
		rw.Rewrite()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Config.TestDSN.Disable = orgTestDSNStatus
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteStar2Columns(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	orgTestDSNStatus := common.Config.TestDSN.Disable
	common.Config.TestDSN.Disable = false
	testSQL := []map[string]string{
		{
			"input":  `SELECT * FROM film`,
			"output": `select film_id, title from film`,
		},
		{
			"input":  `SELECT film.* FROM film`,
			"output": `select film_id, title from film`,
		},
	}

	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"])
		rw.Columns = map[string]map[string][]*common.Column{
			"sakila": {
				"film": {
					{Name: "film_id", Table: "film"},
					{Name: "title", Table: "film"},
				},
			},
		}
		rw.RewriteStar2Columns()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}

	testSQL2 := []map[string]string{
		{
			"input":  `SELECT film.* FROM film, actor`,
			"output": `select film.film_id, film.title from film, actor`,
		},
		{
			"input":  `SELECT film.*, actor.actor_id FROM film, actor`,
			"output": `select film.film_id, film.title, actor.actor_id from film, actor`,
		},
	}

	for _, sql := range testSQL2 {
		rw := NewRewrite(sql["input"])
		rw.Columns = map[string]map[string][]*common.Column{
			"sakila": {
				"film": {
					{Name: "film_id", Table: "film"},
					{Name: "title", Table: "film"},
				},
				"actor": {
					{Name: "actor_id", Table: "actor"},
				},
			},
		}
		rw.RewriteStar2Columns()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Config.TestDSN.Disable = orgTestDSNStatus
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteInsertColumns(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  `insert into film values(1,2,3,4,5)`,
			"output": `insert into film(film_id, title, description, release_year, language_id) values (1, 2, 3, 4, 5)`,
		},
		{
			"input":  `insert into sakila.film values(1,2)`,
			"output": `insert into sakila.film(film_id, title) values (1, 2)`,
		},
		{
			"input":  `replace into sakila.film select id from tb`,
			"output": `replace into sakila.film(film_id) select id from tb`,
		},
		{
			"input":  `replace into sakila.film select id, title, description from tb`,
			"output": `replace into sakila.film(film_id, title, description) select id, title, description from tb`,
		},
	}

	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"])
		rw.Columns = map[string]map[string][]*common.Column{
			"sakila": {
				"film": {
					{Name: "film_id", Table: "film"},
					{Name: "title", Table: "film"},
					{Name: "description", Table: "film"},
					{Name: "release_year", Table: "film"},
					{Name: "language_id", Table: "film"},
					{Name: "original_language_id", Table: "film"},
					{Name: "rental_duration", Table: "film"},
				},
			},
		}
		rw.RewriteInsertColumns()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteHaving(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  `SELECT state, COUNT(*) FROM Drivers GROUP BY state HAVING state IN ('GA', 'TX') ORDER BY state`,
			"output": "select state, COUNT(*) from Drivers where state in ('GA', 'TX') group by state order by state asc",
		},
		{
			"input":  `SELECT state, COUNT(*) FROM Drivers WHERE col =1 GROUP BY state HAVING state IN ('GA', 'TX') ORDER BY state`,
			"output": "select state, COUNT(*) from Drivers where (col = 1) and state in ('GA', 'TX') group by state order by state asc",
		},
		{
			"input":  `SELECT state, COUNT(*) FROM Drivers WHERE col =1 or col1 =2 GROUP BY state HAVING state IN ('GA', 'TX') ORDER BY state`,
			"output": "select state, COUNT(*) from Drivers where (col = 1 or col1 = 2) and state in ('GA', 'TX') group by state order by state asc",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteHaving()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteAddOrderByNull(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "SELECT sum(col1) FROM tbl GROUP BY col",
			"output": "select sum(col1) from tbl group by col order by null",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteAddOrderByNull()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteRemoveDMLOrderBy(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "DELETE FROM tbl WHERE col1=1 ORDER BY col",
			"output": "delete from tbl where col1 = 1",
		},
		{
			"input":  "UPDATE tbl SET col =1 WHERE col1=1 ORDER BY col",
			"output": "update tbl set col = 1 where col1 = 1",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteRemoveDMLOrderBy()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteGroupByConst(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "select 1;",
			"output": "select 1 from dual",
		},
		/*
				{
					"input":  "SELECT col1 FROM tbl GROUP BY 1;",
					"output": "select col1 from tbl GROUP BY col1",
				},
			    {
					"input":  "SELECT col1, col2 FROM tbl GROUP BY 1, 2;",
					"output": "select col1, col2 from tbl GROUP BY col1, col2",
				},
			    {
					"input":  "SELECT col1, col2, col3 FROM tbl GROUP BY 1, 3;",
					"output": "select col1, col2, col3 from tbl GROUP BY col1, col3",
				},
		*/
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteGroupByConst()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteStandard(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "SELECT sum(col1) FROM tbl GROUP BY 1;",
			"output": "select sum(col1) from tbl group by 1",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteStandard()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteCountStar(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "SELECT count(col) FROM tbl GROUP BY 1;",
			"output": "select count(*) from tbl group by 1",
		},
		{
			"input":  "SELECT COUNT(tb.col) FROM tbl GROUP BY 1;",
			"output": "select COUNT(tb.*) from tbl group by 1",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteCountStar()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteInnoDB(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT);",
			"output": "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=InnoDB ",
		},
		{
			"input":  "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=memory ",
			"output": "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=InnoDB ",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteInnoDB()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteAutoIncrement(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT) ENGINE=InnoDB AUTO_INCREMENT=123802;",
			"output": "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=InnoDB auto_increment=1 ",
		},
		{
			"input":  "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=InnoDB",
			"output": "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=InnoDB",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteAutoIncrement()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteIntWidth(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "CREATE TABLE t1(id bigint(10) NOT NULL AUTO_INCREMENT) ENGINE=InnoDB AUTO_INCREMENT=123802;",
			"output": "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=InnoDB AUTO_INCREMENT=123802",
		},
		{
			"input":  "CREATE TABLE t1(id bigint NOT NULL AUTO_INCREMENT) ENGINE=InnoDB AUTO_INCREMENT=123802;",
			"output": "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=InnoDB AUTO_INCREMENT=123802",
		},
		{
			"input":  "create table t1(id int(20) not null auto_increment) ENGINE=InnoDB;",
			"output": "create table t1 (\n\tid int(10) not null auto_increment\n) ENGINE=InnoDB",
		},
		{
			"input":  "create table t1(id int not null auto_increment) ENGINE=InnoDB;",
			"output": "create table t1 (\n\tid int not null auto_increment\n) ENGINE=InnoDB",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteIntWidth()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteAlwaysTrue(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "SELECT count(col) FROM tbl where 1=1;",
			"output": "select count(col) from tbl",
		},
		{
			"input":  "SELECT count(col) FROM tbl where col=col;",
			"output": "select count(col) from tbl where col = col",
		},
		{
			"input":  "SELECT count(col) FROM tbl where col=col2;",
			"output": "select count(col) from tbl where col = col2",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 1>=1;",
			"output": "select count(col) from tbl",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 2>1;",
			"output": "select count(col) from tbl",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 1<=1;",
			"output": "select count(col) from tbl",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 1<2;",
			"output": "select count(col) from tbl",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 1=1 and 2=2;",
			"output": "select count(col) from tbl",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 1=1 or 2=3;",
			"output": "select count(col) from tbl where 2 = 3",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 1=1 and 3=3 or 2=3;",
			"output": "select count(col) from tbl where 2 = 3",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 1=1 and 3=3 or 2!=3;",
			"output": "select count(col) from tbl",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 1=1 or 2=3 and 3=3 ;",
			"output": "select count(col) from tbl where 2 = 3",
		},
		{
			"input":  "SELECT count(col) FROM tbl where (1=1);",
			"output": "select count(col) from tbl",
		},
		{
			"input":  "SELECT count(col) FROM tbl where a=1;",
			"output": "select count(col) from tbl where a = 1",
		},
		{
			"input":  "SELECT count(col) FROM tbl where ('a'= 'a' or 'b' = 'b') and a = 'b';",
			"output": "select count(col) from tbl where a = 'b'",
		},
		{
			"input":  "SELECT count(col) FROM tbl where (('a'= 'a' or 'b' = 'b') and a = 'b');",
			"output": "select count(col) from tbl where (a = 'b')",
		},
		{
			"input":  "SELECT count(col) FROM tbl where 'a'= 'a' or ('b' = 'b' and a = 'b');",
			"output": "select count(col) from tbl where (a = 'b')",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteAlwaysTrue()
		if rw == nil {
			t.Errorf("NoRw")
		} else if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

// TODO:
func TestRewriteSubQuery2Join(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	orgTestDSNStatus := common.Config.TestDSN.Disable
	common.Config.TestDSN.Disable = true
	testSQL := []map[string]string{
		{
			// 这个case是官方文档给的,但不一定正确,需要视表结构的定义来进行判断
			"input":  `SELECT * FROM t1 WHERE id IN (SELECT id FROM t2);`,
			"output": "",
			//"output": `SELECT DISTINCT t1.* FROM t1, t2 WHERE t1.id=t2.id;`,
		},
		{
			"input":  `SELECT * FROM t1 WHERE id NOT IN (SELECT id FROM t2);`,
			"output": "",
			//"output": `SELECT table1.* FROM t1 LEFT JOIN t2 ON t1.id=t2.id WHERE t2.id IS NULL;`,
		},
		{
			"input":  `SELECT * FROM t1 WHERE NOT EXISTS (SELECT id FROM t2 WHERE t1.id=t2.id);`,
			"output": "",
			//"output": `SELECT table1.* FROM table1 LEFT JOIN table2 ON table1.id=table2.id WHERE table2.id IS NULL;`,
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteSubQuery2Join()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Config.TestDSN.Disable = orgTestDSNStatus
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteDML2Select(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1;",
			"output": "select * from city join country using (country_id) where city.city_id = 1",
		}, {
			"input":  "DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL;",
			"output": "select * from city left join country on city.country_id = country.country_id where country.country is null",
		}, {
			"input":  "DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id",
			"output": "select * from city as a1 join country as a2 where a1.country_id = a2.country_id",
		}, {
			"input":  "DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id",
			"output": "select * from city as a1 join country as a2 where a1.country_id = a2.country_id",
		}, {
			"input":  "DELETE FROM film WHERE length > 100;",
			"output": "select * from film where length > 100",
		}, {
			"input":  "UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;",
			"output": "select * from city join country using (country_id) where city.city_id = 10",
		}, {
			"input":  "UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;",
			"output": "select * from city join country on city.country_id = country.country_id join address on city.city_id = address.city_id where city.city_id = 10",
		}, {
			"input":  "UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10;",
			"output": "select * from city, country where city.country_id = country.country_id and city.city_id = 10",
		}, {
			"input":  "UPDATE film SET length = 10 WHERE language_id = 20;",
			"output": "select * from film where language_id = 20",
		}, {
			"input":  "INSERT INTO city (country_id) SELECT country_id FROM country;",
			"output": "select country_id from country",
		}, {
			"input":  "INSERT INTO city (country_id) VALUES (1),(2),(3);",
			"output": "select 1 from DUAL",
		}, {
			"input":  "INSERT INTO city (country_id) VALUES (10);",
			"output": "select 1 from DUAL",
		}, {
			"input":  "INSERT INTO city (country_id) SELECT 10 FROM DUAL;",
			"output": "select 10 from dual",
		}, {
			"input":  "replace INTO city (country_id) SELECT 10 FROM DUAL;",
			"output": "select 10 from dual",
		},
	}

	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteDML2Select()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteReg2Select(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  "select 1 from dual",
			"output": "select 1 from dual",
		},
		{
			"input":  "delete from dual",
			"output": "select * from dual",
		},
		{
			"input":  "update tb set col = 1 where col = 2",
			"output": "select * from tb where col = 2",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteReg2Select()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteDistinctStar(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  `SELECT DISTINCT * FROM film;`,
			"output": "SELECT * FROM film;",
		},
		{
			"input":  `SELECT COUNT(DISTINCT *) FROM film;`,
			"output": "SELECT COUNT(*) FROM film;",
		},
		{
			"input":  `SELECT DISTINCT film.* FROM film;`,
			"output": "SELECT * FROM film;",
		},
		{
			"input":  "SELECT DISTINCT col FROM film;",
			"output": "SELECT DISTINCT col FROM film;",
		},
		{
			"input":  "SELECT DISTINCT film.* FROM film, tbl;",
			"output": "SELECT DISTINCT film.* FROM film, tbl;",
		},
		{

			"input":  "SELECT DISTINCT * FROM film, tbl;",
			"output": "SELECT DISTINCT * FROM film, tbl;",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteDistinctStar()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestMergeAlterTables(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	sqls := []string{
		// ADD|DROP INDEX
		// TODO: PRIMARY KEY, [UNIQUE|FULLTEXT|SPATIAL] INDEX
		"CREATE INDEX part_of_name ON customer (name(10));",
		"create index idx_test_cca on test_bb(test_cc);", // https://github.com/XiaoMi/soar/issues/205
		"alter table `sakila`.`t1` add index `idx_col`(`col`)",
		"alter table `sakila`.`t1` add UNIQUE index `idx_col`(`col`)",
		"alter table `sakila`.`t1` add index `idx_ID`(`ID`)",

		// ADD|DROP COLUMN
		"ALTER TABLE t2 DROP COLUMN c, DROP COLUMN d;",
		"ALTER TABLE T2 ADD COLUMN C int;",
		"ALTER TABLE T2 ADD COLUMN D int FIRST;",
		"ALTER TABLE T2 ADD COLUMN E int AFTER D;",

		// RENAME COLUMN
		"ALTER TABLE t1 RENAME COLUMN a TO b",

		// RENAME INDEX
		"ALTER TABLE t1 RENAME INDEX idx_a TO idx_b",
		"ALTER TABLE t1 RENAME KEY idx_a TO idx_b",

		// RENAME TABLE
		"ALTER TABLE db.old_table RENAME new_table;",
		"ALTER TABLE old_table RENAME TO new_table;",
		"ALTER TABLE old_table RENAME AS new_table;",

		// MODIFY & CHANGE
		"ALTER TABLE t1 MODIFY col1 BIGINT UNSIGNED DEFAULT 1 COMMENT 'my column';",
		"ALTER TABLE t1 CHANGE b a INT NOT NULL;",

		// table name quote in back ticks
		"alter table `t3`add index `idx_a`(a)",
		"alter table`t3`drop index`idx_b`",
	}

	alterSQLs := MergeAlterTables(sqls...)
	var sortedAlterSQLs []string
	for item := range alterSQLs {
		sortedAlterSQLs = append(sortedAlterSQLs, item)
	}
	sort.Strings(sortedAlterSQLs)

	err := common.GoldenDiff(func() {
		for _, tb := range sortedAlterSQLs {
			fmt.Println(tb, ":", alterSQLs[tb])
		}
	}, t.Name(), update)
	if err != nil {
		t.Error(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteUnionAll(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  `select country_id from city union select country_id from country;`,
			"output": "select country_id from city union all select country_id from country",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteUnionAll()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}
func TestRewriteTruncate(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  `delete from tbl;`,
			"output": "truncate table tbl",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteTruncate()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRewriteOr2In(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  `select country_id from city where country_id = 1 or country_id = 2 or country_id = 3;`,
			"output": "select country_id from city where country_id in (1, 2, 3)",
		},
		// TODO or中的恒真条件
		{
			"input":  `select country_id from city where country_id != 1 or country_id != 2 or country_id = 3;`,
			"output": "select country_id from city where country_id != 1 or country_id != 2 or country_id = 3",
		},
		// col = 1 or col is null不可转为IN
		{
			"input":  `select country_id from city where col = 1 or col is null;`,
			"output": "select country_id from city where col = 1 or col is null",
		},
		{
			"input":  `select country_id from city where col1 = 1 or col2 = 1 or col2 = 2;`,
			"output": "select country_id from city where col1 = 1 or col2 in (1, 2)",
		},
		{
			"input":  `select country_id from city where col1 = 1 or col2 = 1 or col2 = 2 or col1 = 3;`,
			"output": "select country_id from city where col2 in (1, 2) or col1 in (1, 3)",
		},
		{
			"input":  `select country_id from city where (col1 = 1 or col2 = 1 or col2 = 2 ) or col1 = 3;`,
			"output": "select country_id from city where (col1 = 1 or col2 in (1, 2)) or col1 = 3",
		},
		{
			"input":  `select country_id from city where col1 = 1 or (col2 = 1 or col2 = 2 ) or col1 = 3;`,
			"output": "select country_id from city where (col2 in (1, 2)) or col1 in (1, 3)",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteOr2In()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRmParenthesis(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	testSQL := []map[string]string{
		{
			"input":  `select country_id from city where (country_id = 1);`,
			"output": "select country_id from city where country_id = 1",
		},
		{
			"input":  `select * from city where a = 1 and (country_id = 1);`,
			"output": "select * from city where a = 1 and country_id = 1",
		},
		{
			"input":  `select country_id from city where (country_id = 1) or country_id = 1 ;`,
			"output": "select country_id from city where country_id = 1 or country_id = 1",
		},
		{
			"input":  `select country_id from city where col = 1 or (country_id = 1) or country_id = 1 ;`,
			"output": "select country_id from city where col = 1 or country_id = 1 or country_id = 1",
		},
	}
	for _, sql := range testSQL {
		rw := NewRewrite(sql["input"]).RewriteRmParenthesis()
		if rw.NewSQL != sql["output"] {
			t.Errorf("want: %s\ngot: %s", sql["output"], rw.NewSQL)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestListRewriteRules(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	err := common.GoldenDiff(func() {
		ListRewriteRules(RewriteRules)
		orgReportType := common.Config.ReportType
		common.Config.ReportType = "json"
		ListRewriteRules(RewriteRules)
		common.Config.ReportType = orgReportType
	}, t.Name(), update)
	if err != nil {
		t.Error(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}


================================================
FILE: ast/testdata/TestCompress.golden
================================================
SELECT * FROM film WHERE length = 86;
SELECT * FROM film WHERE length = 86;
SELECT * FROM film WHERE length IS NULL;
SELECT * FROM film WHERE length IS NULL;
SELECT * FROM film HAVING title = 'abc';
SELECT * FROM film HAVING title = 'abc';
SELECT * FROM sakila.film WHERE length >= 60;
SELECT * FROM sakila.film WHERE length >= 60;
SELECT * FROM sakila.film WHERE length >= '60';
SELECT * FROM sakila.film WHERE length >= '60';
SELECT * FROM film WHERE length BETWEEN 60 AND 84;
SELECT * FROM film WHERE length BETWEEN 60 AND 84;
SELECT * FROM film WHERE title LIKE 'AIR%';
SELECT * FROM film WHERE title LIKE 'AIR%';
SELECT * FROM film WHERE title IS NOT NULL;
SELECT * FROM film WHERE title IS NOT NULL;
SELECT * FROM film WHERE length = 114 and title = 'ALABAMA DEVIL';
SELECT * FROM film WHERE length = 114 and title = 'ALABAMA DEVIL';
SELECT * FROM film WHERE length > 100 and title = 'ALABAMA DEVIL';
SELECT * FROM film WHERE length > 100 and title = 'ALABAMA DEVIL';
SELECT * FROM film WHERE length > 100 and language_id < 10 and title = 'xyz';
SELECT * FROM film WHERE length > 100 and language_id < 10 and title = 'xyz';
SELECT * FROM film WHERE length > 100 and language_id < 10;
SELECT * FROM film WHERE length > 100 and language_id < 10;
SELECT release_year, sum(length) FROM film WHERE length = 123 AND language_id = 1 GROUP BY release_year;
SELECT release_year, sum(length) FROM film WHERE length = 123 AND language_id = 1 GROUP BY release_year;
SELECT release_year, sum(length) FROM film WHERE length >= 123 GROUP BY release_year;
SELECT release_year, sum(length) FROM film WHERE length >= 123 GROUP BY release_year;
SELECT release_year, language_id, sum(length) FROM film GROUP BY release_year, language_id;
SELECT release_year, language_id, sum(length) FROM film GROUP BY release_year, language_id;
SELECT release_year, sum(length) FROM film WHERE length = 123 GROUP BY release_year,(length+language_id);
SELECT release_year, sum(length) FROM film WHERE length = 123 GROUP BY release_year,(length+language_id);
SELECT release_year, sum(film_id) FROM film GROUP BY release_year;
SELECT release_year, sum(film_id) FROM film GROUP BY release_year;
SELECT * FROM address GROUP BY address,district;
SELECT * FROM address GROUP BY address,district;
SELECT title FROM film WHERE ABS(language_id) = 3 GROUP BY title;
SELECT title FROM film WHERE ABS(language_id) = 3 GROUP BY title;
SELECT language_id FROM film WHERE length = 123 GROUP BY release_year ORDER BY language_id;
SELECT language_id FROM film WHERE length = 123 GROUP BY release_year ORDER BY language_id;
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year;
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year;
SELECT * FROM film WHERE length = 123 ORDER BY release_year ASC, language_id DESC;
SELECT * FROM film WHERE length = 123 ORDER BY release_year ASC, language_id DESC;
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year LIMIT 10;
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year LIMIT 10;
SELECT * FROM film WHERE length = 123 ORDER BY release_year LIMIT 10;
SELECT * FROM film WHERE length = 123 ORDER BY release_year LIMIT 10;
SELECT * FROM film ORDER BY release_year LIMIT 10;
SELECT * FROM film ORDER BY release_year LIMIT 10;
SELECT film_id FROM film ORDER BY release_year LIMIT 10;
SELECT film_id FROM film ORDER BY release_year LIMIT 10;
SELECT * FROM film WHERE length > 100 ORDER BY length LIMIT 10;
SELECT * FROM film WHERE length > 100 ORDER BY length LIMIT 10;
SELECT * FROM film WHERE length < 100 ORDER BY length LIMIT 10;
SELECT * FROM film WHERE length < 100 ORDER BY length LIMIT 10;
SELECT * FROM customer WHERE address_id in (224,510) ORDER BY last_name;
SELECT * FROM customer WHERE address_id in (224,510) ORDER BY last_name;
SELECT * FROM film WHERE release_year = 2016 AND length != 1 ORDER BY title;
SELECT * FROM film WHERE release_year = 2016 AND length != 1 ORDER BY title;
SELECT title FROM film WHERE release_year = 1995;
SELECT title FROM film WHERE release_year = 1995;
SELECT title, replacement_cost FROM film WHERE language_id = 5 AND length = 70;
SELECT title, replacement_cost FROM film WHERE language_id = 5 AND length = 70;
SELECT title FROM film WHERE language_id > 5 AND length > 70;
SELECT title FROM film WHERE language_id > 5 AND length > 70;
SELECT * FROM film WHERE length = 100 and title = 'xyz' ORDER BY release_year;
SELECT * FROM film WHERE length = 100 and title = 'xyz' ORDER BY release_year;
SELECT * FROM film WHERE length > 100 and title = 'xyz' ORDER BY release_year;
SELECT * FROM film WHERE length > 100 and title = 'xyz' ORDER BY release_year;
SELECT * FROM film WHERE length > 100 ORDER BY release_year;
SELECT * FROM film WHERE length > 100 ORDER BY release_year;
SELECT * FROM city a INNER JOIN country b ON a.country_id=b.country_id;
SELECT * FROM city a INNER JOIN country b ON a.country_id=b.country_id;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;
SELECT country_id, last_update FROM city NATURAL JOIN country;
SELECT country_id, last_update FROM city NATURAL JOIN country;
SELECT country_id, last_update FROM city NATURAL LEFT JOIN country;
SELECT country_id, last_update FROM city NATURAL LEFT JOIN country;
SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country;
SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country;
SELECT a.country_id, a.last_update FROM city a STRAIGHT_JOIN country b ON a.country_id=b.country_id;
SELECT a.country_id, a.last_update FROM city a STRAIGHT_JOIN country b ON a.country_id=b.country_id;
SELECT a.address, a.postal_code FROM sakila.address a WHERE a.city_id IN  (SELECT c.city_id FROM sakila.city c);
SELECT a.address, a.postal_code FROM sakila.address a WHERE a.city_id IN (SELECT c.city_id FROM sakila.city c);
SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I.city_id = city.city_id) JOIN country ON (country.country_id = city.country_id) ORDER BY city DESC;
SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I.city_id = city.city_id) JOIN country ON (country.country_id = city.country_id) ORDER BY city DESC;
DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1;
DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1;
DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL;
DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL;
DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
DELETE FROM film WHERE length > 100;
DELETE FROM film WHERE length > 100;
UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;
UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;
UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;
UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;
UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10;
UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10;
UPDATE film SET length = 10 WHERE language_id = 20;
UPDATE film SET length = 10 WHERE language_id = 20;
INSERT INTO city (country_id) SELECT country_id FROM country;
INSERT INTO city (country_id) SELECT country_id FROM country;
INSERT INTO city (country_id) VALUES (1),(2),(3);
INSERT INTO city (country_id) VALUES (1),(2),(3);
INSERT INTO city (country_id) VALUES (10);
INSERT INTO city (country_id) VALUES (10);
INSERT INTO city (country_id) SELECT 10 FROM DUAL;
INSERT INTO city (country_id) SELECT 10 FROM DUAL;
REPLACE INTO city (country_id) SELECT country_id FROM country;
REPLACE INTO city (country_id) SELECT country_id FROM country;
REPLACE INTO city (country_id) VALUES (1),(2),(3);
REPLACE INTO city (country_id) VALUES (1),(2),(3);
REPLACE INTO city (country_id) VALUES (10);
REPLACE INTO city (country_id) VALUES (10);
REPLACE INTO city (country_id) SELECT 10 FROM DUAL;
REPLACE INTO city (country_id) SELECT 10 FROM DUAL;
SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM  film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film;
SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film;
SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1);
SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1);
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;
SELECT * FROM (SELECT * FROM actor WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE') t WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE' GROUP BY first_name;
SELECT * FROM (SELECT * FROM actor WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE') t WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE' GROUP BY first_name;
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id WHERE o.country_id is null union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id WHERE i.city_id is null;
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id WHERE o.country_id is null union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id WHERE i.city_id is null;
SELECT first_name,last_name,email FROM customer STRAIGHT_JOIN address ON customer.address_id=address.address_id;
SELECT first_name,last_name,email FROM customer STRAIGHT_JOIN address ON customer.address_id=address.address_id;
SELECT ID,name FROM (SELECT address FROM customer_list WHERE SID=1 order by phone limit 50,10) a JOIN customer_list l ON (a.address=l.address) JOIN city c ON (c.city=l.city) order by phone desc;
SELECT ID,name FROM (SELECT address FROM customer_list WHERE SID=1 order by phone limit 50,10) a JOIN customer_list l ON (a.address=l.address) JOIN city c ON (c.city=l.city) order by phone desc;
SELECT * FROM film WHERE date(last_update)='2006-02-15';
SELECT * FROM film WHERE date(last_update)='2006-02-15';
SELECT last_update FROM film GROUP BY date(last_update);
SELECT last_update FROM film GROUP BY date(last_update);
SELECT last_update FROM film order by date(last_update);
SELECT last_update FROM film order by date(last_update);
SELECT description FROM film WHERE description IN('NEWS','asd') GROUP BY description;
SELECT description FROM film WHERE description IN('NEWS','asd') GROUP BY description;
alter table address add index idx_city_id(city_id);
alter table address add index idx_city_id(city_id);
alter table inventory add index `idx_store_film` (`store_id`,`film_id`);
alter table inventory add index `idx_store_film` (`store_id`,`film_id`);
alter table inventory add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`);
alter table inventory add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`);
SELECT	DATE_FORMAT(t.last_update, '%Y-%m-%d'),	COUNT(DISTINCT (t.city))	FROM city t WHERE t.last_update > '2018-10-22 00:00:00'	AND t.city LIKE '%Chrome%'	AND t.city = 'eip' GROUP BY DATE_FORMAT(t.last_update, '%Y-%m-%d') ORDER BY DATE_FORMAT(t.last_update, '%Y-%m-%d');
SELECT DATE_FORMAT(t.last_update, '%Y-%m-%d'), COUNT(DISTINCT (t.city)) FROM city t WHERE t.last_update > '2018-10-22 00:00:00' AND t.city LIKE '%Chrome%' AND t.city = 'eip' GROUP BY DATE_FORMAT(t.last_update, '%Y-%m-%d') ORDER BY DATE_FORMAT(t.last_update, '%Y-%m-%d');
create table hello.t (id int unsigned);
create table hello.t (id int unsigned);
select * from tb where data >= '';
select * from tb where data >= '';
alter table tb alter column id drop default;
alter table tb alter column id drop default;
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film where last_update > '2016-03-27 02:01:01') as d;
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film where last_update > '2016-03-27 02:01:01') as d;
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film) as d;
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film) as d;


================================================
FILE: ast/testdata/TestFormat.golden
================================================
SELECT * FROM film WHERE length = 86;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 86;
SELECT * FROM film WHERE length IS NULL;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  IS  NULL;
SELECT * FROM film HAVING title = 'abc';

SELECT  
  * 
FROM  
  film  
HAVING  
  title  = 'abc';
SELECT * FROM sakila.film WHERE length >= 60;

SELECT  
  * 
FROM  
  sakila. film  
WHERE  
  LENGTH  >= 60;
SELECT * FROM sakila.film WHERE length >= '60';

SELECT  
  * 
FROM  
  sakila. film  
WHERE  
  LENGTH  >= '60';
SELECT * FROM film WHERE length BETWEEN 60 AND 84;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  BETWEEN  60  
  AND  84;
SELECT * FROM film WHERE title LIKE 'AIR%';

SELECT  
  * 
FROM  
  film  
WHERE  
  title  LIKE  'AIR%';
SELECT * FROM film WHERE title IS NOT NULL;

SELECT  
  * 
FROM  
  film  
WHERE  
  title  IS  NOT  NULL;
SELECT * FROM film WHERE length = 114 and title = 'ALABAMA DEVIL';

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 114  
  AND  title  = 'ALABAMA DEVIL';
SELECT * FROM film WHERE length > 100 and title = 'ALABAMA DEVIL';

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
  AND  title  = 'ALABAMA DEVIL';
SELECT * FROM film WHERE length > 100 and language_id < 10 and title = 'xyz';

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
  AND  language_id  < 10  
  AND  title  = 'xyz';
SELECT * FROM film WHERE length > 100 and language_id < 10;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
  AND  language_id  < 10;
SELECT release_year, sum(length) FROM film WHERE length = 123 AND language_id = 1 GROUP BY release_year;

SELECT  
  release_year, SUM( LENGTH) 
FROM  
  film  
WHERE  
  LENGTH  = 123  
  AND  language_id  = 1  
GROUP BY  
  release_year;
SELECT release_year, sum(length) FROM film WHERE length >= 123 GROUP BY release_year;

SELECT  
  release_year, SUM( LENGTH) 
FROM  
  film  
WHERE  
  LENGTH  >= 123  
GROUP BY  
  release_year;
SELECT release_year, language_id, sum(length) FROM film GROUP BY release_year, language_id;

SELECT  
  release_year, language_id, SUM( LENGTH) 
FROM  
  film  
GROUP BY  
  release_year, language_id;
SELECT release_year, sum(length) FROM film WHERE length = 123 GROUP BY release_year,(length+language_id);

SELECT  
  release_year, SUM( LENGTH) 
FROM  
  film  
WHERE  
  LENGTH  = 123  
GROUP BY  
  release_year, (LENGTH+ language_id);
SELECT release_year, sum(film_id) FROM film GROUP BY release_year;

SELECT  
  release_year, SUM( film_id) 
FROM  
  film  
GROUP BY  
  release_year;
SELECT * FROM address GROUP BY address,district;

SELECT  
  * 
FROM  
  address  
GROUP BY  
  address, district;
SELECT title FROM film WHERE ABS(language_id) = 3 GROUP BY title;

SELECT  
  title  
FROM  
  film  
WHERE  
  ABS( language_id) = 3  
GROUP BY  
  title;
SELECT language_id FROM film WHERE length = 123 GROUP BY release_year ORDER BY language_id;

SELECT  
  language_id  
FROM  
  film  
WHERE  
  LENGTH  = 123  
GROUP BY  
  release_year  
ORDER BY  
  language_id;
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year;

SELECT  
  release_year  
FROM  
  film  
WHERE  
  LENGTH  = 123  
GROUP BY  
  release_year  
ORDER BY  
  release_year;
SELECT * FROM film WHERE length = 123 ORDER BY release_year ASC, language_id DESC;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 123  
ORDER BY  
  release_year  ASC, language_id  DESC;
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year LIMIT 10;

SELECT  
  release_year  
FROM  
  film  
WHERE  
  LENGTH  = 123  
GROUP BY  
  release_year  
ORDER BY  
  release_year  
LIMIT  
  10;
SELECT * FROM film WHERE length = 123 ORDER BY release_year LIMIT 10;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 123  
ORDER BY  
  release_year  
LIMIT  
  10;
SELECT * FROM film ORDER BY release_year LIMIT 10;

SELECT  
  * 
FROM  
  film  
ORDER BY  
  release_year  
LIMIT  
  10;
SELECT film_id FROM film ORDER BY release_year LIMIT 10;

SELECT  
  film_id  
FROM  
  film  
ORDER BY  
  release_year  
LIMIT  
  10;
SELECT * FROM film WHERE length > 100 ORDER BY length LIMIT 10;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
ORDER BY  
  LENGTH  
LIMIT  
  10;
SELECT * FROM film WHERE length < 100 ORDER BY length LIMIT 10;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  < 100  
ORDER BY  
  LENGTH  
LIMIT  
  10;
SELECT * FROM customer WHERE address_id in (224,510) ORDER BY last_name;

SELECT  
  * 
FROM  
  customer  
WHERE  
  address_id  in  (224, 510) 
ORDER BY  
  last_name;
SELECT * FROM film WHERE release_year = 2016 AND length != 1 ORDER BY title;

SELECT  
  * 
FROM  
  film  
WHERE  
  release_year  = 2016  
  AND  LENGTH  != 1  
ORDER BY  
  title;
SELECT title FROM film WHERE release_year = 1995;

SELECT  
  title  
FROM  
  film  
WHERE  
  release_year  = 1995;
SELECT title, replacement_cost FROM film WHERE language_id = 5 AND length = 70;

SELECT  
  title, replacement_cost  
FROM  
  film  
WHERE  
  language_id  = 5  
  AND  LENGTH  = 70;
SELECT title FROM film WHERE language_id > 5 AND length > 70;

SELECT  
  title  
FROM  
  film  
WHERE  
  language_id  > 5  
  AND  LENGTH  > 70;
SELECT * FROM film WHERE length = 100 and title = 'xyz' ORDER BY release_year;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 100  
  AND  title  = 'xyz' 
ORDER BY  
  release_year;
SELECT * FROM film WHERE length > 100 and title = 'xyz' ORDER BY release_year;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
  AND  title  = 'xyz' 
ORDER BY  
  release_year;
SELECT * FROM film WHERE length > 100 ORDER BY release_year;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
ORDER BY  
  release_year;
SELECT * FROM city a INNER JOIN country b ON a.country_id=b.country_id;

SELECT  
  * 
FROM  
  city  a  
  INNER JOIN  country  b  ON  a. country_id= b. country_id;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id;

SELECT  
  * 
FROM  
  city  a  
  LEFT JOIN  country  b  ON  a. country_id= b. country_id;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;

SELECT  
  * 
FROM  
  city  a  
  RIGHT JOIN  country  b  ON  a. country_id= b. country_id;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;

SELECT  
  * 
FROM  
  city  a  
  LEFT JOIN  country  b  ON  a. country_id= b. country_id  
WHERE  
  b. last_update  IS  NULL;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL;

SELECT  
  * 
FROM  
  city  a  
  RIGHT JOIN  country  b  ON  a. country_id= b. country_id  
WHERE  
  a. last_update  IS  NULL;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;

SELECT  
  * 
FROM  
  city  a  
  LEFT JOIN  country  b  ON  a. country_id= b. country_id  
UNION  
SELECT  
  * 
FROM  
  city  a  
  RIGHT JOIN  country  b  ON  a. country_id= b. country_id;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;

SELECT  
  * 
FROM  
  city  a  
  RIGHT JOIN  country  b  ON  a. country_id= b. country_id  
WHERE  
  a. last_update  IS  NULL  
UNION  
SELECT  
  * 
FROM  
  city  a  
  LEFT JOIN  country  b  ON  a. country_id= b. country_id  
WHERE  
  b. last_update  IS  NULL;
SELECT country_id, last_update FROM city NATURAL JOIN country;

SELECT  
  country_id, last_update  
FROM  
  city  NATURAL  
  JOIN  country;
SELECT country_id, last_update FROM city NATURAL LEFT JOIN country;

SELECT  
  country_id, last_update  
FROM  
  city  NATURAL  
  LEFT JOIN  country;
SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country;

SELECT  
  country_id, last_update  
FROM  
  city  NATURAL  
  RIGHT JOIN  country;
SELECT a.country_id, a.last_update FROM city a STRAIGHT_JOIN country b ON a.country_id=b.country_id;

SELECT  
  a. country_id, a. last_update  
FROM  
  city  a  STRAIGHT_JOIN  country  b  ON  a. country_id= b. country_id;
SELECT a.address, a.postal_code FROM sakila.address a WHERE a.city_id IN  (SELECT c.city_id FROM sakila.city c);

SELECT  
  a. address, a. postal_code  
FROM  
  sakila. address  a  
WHERE  
  a. city_id  IN  (
SELECT  
  c. city_id  
FROM  
  sakila. city  c);
SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I.city_id = city.city_id) JOIN country ON (country.country_id = city.country_id) ORDER BY city DESC;

SELECT  
  city  
FROM( 
SELECT  
  city_id  
FROM  
  city  
WHERE  
  city  = "A Corua (La Corua)" 
ORDER BY  
  last_update  DESC  
LIMIT  
  50, 10) I  
  JOIN  city  ON  (I. city_id  = city. city_id) 
  JOIN  country  ON  (country. country_id  = city. country_id) 
ORDER BY  
  city  DESC;
DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1;
DELETE  city, country  
FROM  
  city  
  INNER JOIN  country  using  (country_id) 
WHERE  
  city. city_id  = 1;
DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL;
DELETE  city  
FROM  
  city  
  LEFT JOIN  country  ON  city. country_id  = country. country_id  
WHERE  
  country. country  IS  NULL;
DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
DELETE  a1, a2  
FROM  
  city  AS  a1  
  INNER JOIN  country  AS  a2  
WHERE  
  a1. country_id= a2. country_id;
DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;

DELETE FROM  
  a1, a2  USING  city  AS  a1  
  INNER JOIN  country  AS  a2  
WHERE  
  a1. country_id= a2. country_id;
DELETE FROM film WHERE length > 100;

DELETE FROM  
  film  
WHERE  
  LENGTH  > 100;
UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;

UPDATE  
  city  
  INNER JOIN  country  USING( country_id) 
SET  
  city. city  = 'Abha', 
  city. last_update  = '2006-02-15 04:45:25', 
  country. country  = 'Afghanistan' 
WHERE  
  city. city_id= 10;
UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;

UPDATE  
  city  
  INNER JOIN  country  ON  city. country_id  = country. country_id  
  INNER JOIN  address  ON  city. city_id  = address. city_id  
SET  
  city. city  = 'Abha', 
  city. last_update  = '2006-02-15 04:45:25', 
  country. country  = 'Afghanistan' 
WHERE  
  city. city_id= 10;
UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10;

UPDATE  
  city, country  
SET  
  city. city  = 'Abha', 
  city. last_update  = '2006-02-15 04:45:25', 
  country. country  = 'Afghanistan' 
WHERE  
  city. country_id  = country. country_id  
  AND  city. city_id= 10;
UPDATE film SET length = 10 WHERE language_id = 20;

UPDATE  
  film  
SET  
  LENGTH  = 10  
WHERE  
  language_id  = 20;
INSERT INTO city (country_id) SELECT country_id FROM country;
INSERT  INTO  city  (country_id) 
SELECT  
  country_id  
FROM  
  country;
INSERT INTO city (country_id) VALUES (1),(2),(3);
INSERT  INTO  city  (country_id) 
VALUES  
  (1), 
  (2), 
  (3);
INSERT INTO city (country_id) VALUES (10);
INSERT  INTO  city  (country_id) 
VALUES  
  (10);
INSERT INTO city (country_id) SELECT 10 FROM DUAL;
INSERT  INTO  city  (country_id) 
SELECT  
  10  
FROM  
  DUAL;
REPLACE INTO city (country_id) SELECT country_id FROM country;
REPLACE  INTO  city  (country_id) 
SELECT  
  country_id  
FROM  
  country;
REPLACE INTO city (country_id) VALUES (1),(2),(3);
REPLACE  INTO  city  (country_id) 
VALUES  
  (1), 
  (2), 
  (3);
REPLACE INTO city (country_id) VALUES (10);
REPLACE  INTO  city  (country_id) 
VALUES  
  (10);
REPLACE INTO city (country_id) SELECT 10 FROM DUAL;
REPLACE  INTO  city  (country_id) 
SELECT  
  10  
FROM  
  DUAL;
SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM  film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film;

SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film;
SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1);

SELECT  
  * 
FROM  
  film  
WHERE  
  language_id  = (
SELECT  
  language_id  
FROM  
  language  
LIMIT  
  1);
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;

SELECT  
  * 
FROM  
  city  i  
  LEFT JOIN  country  o  ON  i. city_id= o. country_id  
UNION  
SELECT  
  * 
FROM  
  city  i  
  RIGHT JOIN  country  o  ON  i. city_id= o. country_id;
SELECT * FROM (SELECT * FROM actor WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE') t WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE' GROUP BY first_name;

SELECT  
  * 
FROM  
  (
SELECT  
  * 
FROM  
  actor  
WHERE  
  last_update= '2006-02-15 04:34:33' 
  AND  last_name= 'CHASE'
) t  
WHERE  
  last_update= '2006-02-15 04:34:33' 
  AND  last_name= 'CHASE' 
GROUP BY  
  first_name;
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;

SELECT  
  * 
FROM  
  city  i  
  LEFT JOIN  country  o  ON  i. city_id= o. country_id  
UNION  
SELECT  
  * 
FROM  
  city  i  
  RIGHT JOIN  country  o  ON  i. city_id= o. country_id;
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id WHERE o.country_id is null union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id WHERE i.city_id is null;

SELECT  
  * 
FROM  
  city  i  
  LEFT JOIN  country  o  ON  i. city_id= o. country_id  
WHERE  
  o. country_id  is  null  
UNION  
SELECT  
  * 
FROM  
  city  i  
  RIGHT JOIN  country  o  ON  i. city_id= o. country_id  
WHERE  
  i. city_id  is  null;
SELECT first_name,last_name,email FROM customer STRAIGHT_JOIN address ON customer.address_id=address.address_id;

SELECT  
  first_name, last_name, email  
FROM  
  customer  STRAIGHT_JOIN  address  ON  customer. address_id= address. address_id;
SELECT ID,name FROM (SELECT address FROM customer_list WHERE SID=1 order by phone limit 50,10) a JOIN customer_list l ON (a.address=l.address) JOIN city c ON (c.city=l.city) order by phone desc;

SELECT  
  ID, name  
FROM  
  (
SELECT  
  address  
FROM  
  customer_list  
WHERE  
  SID= 1  
ORDER BY  
  phone  
LIMIT  
  50, 10) a  
  JOIN  customer_list  l  ON  (a. address= l. address) 
  JOIN  city  c  ON  (c. city= l. city) 
ORDER BY  
  phone  desc;
SELECT * FROM film WHERE date(last_update)='2006-02-15';

SELECT  
  * 
FROM  
  film  
WHERE  
  DATE( last_update) = '2006-02-15';
SELECT last_update FROM film GROUP BY date(last_update);

SELECT  
  last_update  
FROM  
  film  
GROUP BY  
  DATE( last_update);
SELECT last_update FROM film order by date(last_update);

SELECT  
  last_update  
FROM  
  film  
ORDER BY  
  DATE( last_update);
SELECT description FROM film WHERE description IN('NEWS','asd') GROUP BY description;

SELECT  
  description  
FROM  
  film  
WHERE  
  description  IN( 'NEWS', 
  'asd'
) 
GROUP BY  
  description;
alter table address add index idx_city_id(city_id);

ALTER TABLE  
  address  
ADD  
  index  idx_city_id( city_id);
alter table inventory add index `idx_store_film` (`store_id`,`film_id`);

ALTER TABLE  
  inventory  
ADD  
  index  `idx_store_film` (
    `store_id`, `film_id`);
alter table inventory add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`);

ALTER TABLE  
  inventory  
ADD  
  index  `idx_store_film` (
    `store_id`, `film_id`), 
      ADD  
      index  `idx_store_film` (
        `store_id`, `film_id`), 
              ADD  
          index  `idx_store_film` (
            `store_id`, `film_id`);
SELECT	DATE_FORMAT(t.last_update, '%Y-%m-%d'),	COUNT(DISTINCT (t.city))	FROM city t WHERE t.last_update > '2018-10-22 00:00:00'	AND t.city LIKE '%Chrome%'	AND t.city = 'eip' GROUP BY DATE_FORMAT(t.last_update, '%Y-%m-%d') ORDER BY DATE_FORMAT(t.last_update, '%Y-%m-%d');

SELECT  
  DATE_FORMAT( t. last_update, '%Y-%m-%d'
), 
COUNT( DISTINCT  (
  t. city)) 
  FROM  
    city  t  
  WHERE  
    t. last_update  > '2018-10-22 00:00:00' 
    AND  t. city  LIKE  '%Chrome%' 
    AND  t. city  = 'eip' 
  GROUP BY  
    DATE_FORMAT( t. last_update, '%Y-%m-%d'
) 
ORDER BY  
  DATE_FORMAT( t. last_update, '%Y-%m-%d'
);
create table hello.t (id int unsigned);
create  table  hello. t  (id  int  unsigned);
select * from tb where data >= '';

SELECT  
  * 
FROM  
  tb  
WHERE  
  data  >= '';
alter table tb alter column id drop default;

ALTER TABLE  
  tb  alter  column  id  
DROP  
  DEFAULT;
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film where last_update > '2016-03-27 02:01:01') as d;

SELECT  
  maxId, minId  
FROM  
  (
SELECT  
  MAX( film_id) maxId, MIN( film_id) minId  
FROM  
  film  
WHERE  
  last_update  > '2016-03-27 02:01:01'
) as  d;
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film) as d;

SELECT  
  maxId, minId  
FROM  
  (
SELECT  
  MAX( film_id) maxId, MIN( film_id) minId  
FROM  
  film) as  d;


================================================
FILE: ast/testdata/TestGetQuotedString.golden
================================================
orignal: "hello world"
quoted: "hello world"
orignal: `hello world`
quoted: `hello world`
orignal: 'hello world'
quoted: 'hello world'
orignal: hello world
quoted: 
orignal: 'hello \'world'
quoted: 'hello \'world'
orignal: "hello \"wor\"ld"
quoted: "hello \"wor\"ld"
orignal: "hello \"world"
quoted: "hello \"world"
orignal: ""
quoted: ""
orignal: ''
quoted: ''
orignal: ``
quoted: ``
orignal: 'hello 'world'
quoted: 'hello '
orignal: "hello "world"
quoted: "hello "
orignal: ' LOGGER.error(""); }'
quoted: ' LOGGER.error(""); }'


================================================
FILE: ast/testdata/TestLeftNewLines.golden
================================================
1
0
0


================================================
FILE: ast/testdata/TestListRewriteRules.golden
================================================
# 重写规则

[toc]

## dml2select
* **Description**:将数据库更新请求转换为只读查询请求,便于执行EXPLAIN

* **Original**:

```sql
DELETE FROM film WHERE length > 100
```

* **Suggest**:

```sql
select * from film where length > 100
```
## reg2select
* **Description**:使用正则的方式将数据库更新请求转换为只读查询请求,便于执行EXPLAIN

* **Original**:

```sql
DELETE FROM film WHERE length > 100
```

* **Suggest**:

```sql
select * from film where length > 100
```
## star2columns
* **Description**:为SELECT *补全表的列信息

* **Original**:

```sql
SELECT * FROM film
```

* **Suggest**:

```sql
select film.film_id, film.title from film
```
## insertcolumns
* **Description**:为INSERT补全表的列信息

* **Original**:

```sql
insert into film values(1,2,3,4,5)
```

* **Suggest**:

```sql
insert into film(film_id, title, description, release_year, language_id) values (1, 2, 3, 4, 5)
```
## having
* **Description**:将查询的 HAVING 子句改写为 WHERE 中的查询条件

* **Original**:

```sql
SELECT state, COUNT(*) FROM Drivers GROUP BY state HAVING state IN ('GA', 'TX') ORDER BY state
```

* **Suggest**:

```sql
select state, COUNT(*) from Drivers where state in ('GA', 'TX') group by state order by state asc
```
## orderbynull
* **Description**:如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 ORDER BY NULL

* **Original**:

```sql
SELECT sum(col1) FROM tbl GROUP BY col
```

* **Suggest**:

```sql
select sum(col1) from tbl group by col order by null
```
## unionall
* **Description**:可以接受重复的时间,使用 UNION ALL 替代 UNION 以提高查询效率

* **Original**:

```sql
select country_id from city union select country_id from country
```

* **Suggest**:

```sql
select country_id from city union all select country_id from country
```
## or2in
* **Description**:将同一列不同条件的 OR 查询转写为 IN 查询

* **Original**:

```sql
select country_id from city where col1 = 1 or (col2 = 1 or col2 = 2 ) or col1 = 3;
```

* **Suggest**:

```sql
select country_id from city where (col2 in (1, 2)) or col1 in (1, 3);
```
## dmlorderby
* **Description**:删除 DML 更新操作中无意义的 ORDER BY

* **Original**:

```sql
DELETE FROM tbl WHERE col1=1 ORDER BY col
```

* **Suggest**:

```sql
delete from tbl where col1 = 1
```
## distinctstar
* **Description**:DISTINCT *对有主键的表没有意义,可以将DISTINCT删掉

* **Original**:

```sql
SELECT DISTINCT * FROM film;
```

* **Suggest**:

```sql
SELECT * FROM film
```
## standard
* **Description**:SQL标准化,如:关键字转换为小写

* **Original**:

```sql
SELECT sum(col1) FROM tbl GROUP BY 1;
```

* **Suggest**:

```sql
select sum(col1) from tbl group by 1
```
## mergealter
* **Description**:合并同一张表的多条ALTER语句

* **Original**:

```sql
ALTER TABLE t2 DROP COLUMN c;ALTER TABLE t2 DROP COLUMN d;
```

* **Suggest**:

```sql
ALTER TABLE t2 DROP COLUMN c, DROP COLUMN d;
```
## alwaystrue
* **Description**:删除无用的恒真判断条件

* **Original**:

```sql
SELECT count(col) FROM tbl where 'a'= 'a' or ('b' = 'b' and a = 'b');
```

* **Suggest**:

```sql
select count(col) from tbl where (a = 'b');
```
## countstar
* **Description**:不建议使用COUNT(col)或COUNT(常量),建议改写为COUNT(*)

* **Original**:

```sql
SELECT count(col) FROM tbl GROUP BY 1;
```

* **Suggest**:

```sql
SELECT count(*) FROM tbl GROUP BY 1;
```
## innodb
* **Description**:建表时建议使用InnoDB引擎,非 InnoDB 引擎表自动转 InnoDB

* **Original**:

```sql
CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT);
```

* **Suggest**:

```sql
create table t1 (
	id bigint(20) not null auto_increment
) ENGINE=InnoDB;
```
## autoincrement
* **Description**:将autoincrement初始化为1

* **Original**:

```sql
CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT) ENGINE=InnoDB AUTO_INCREMENT=123802;
```

* **Suggest**:

```sql
create table t1(id bigint(20) not null auto_increment) ENGINE=InnoDB auto_increment=1;
```
## intwidth
* **Description**:整型数据类型修改默认显示宽度

* **Original**:

```sql
create table t1 (id int(20) not null auto_increment) ENGINE=InnoDB;
```

* **Suggest**:

```sql
create table t1 (id int(10) not null auto_increment) ENGINE=InnoDB;
```
## truncate
* **Description**:不带 WHERE 条件的 DELETE 操作建议修改为 TRUNCATE

* **Original**:

```sql
DELETE FROM tbl
```

* **Suggest**:

```sql
truncate table tbl
```
## rmparenthesis
* **Description**:去除没有意义的括号

* **Original**:

```sql
select col from table where (col = 1);
```

* **Suggest**:

```sql
select col from table where col = 1;
```
## delimiter
* **Description**:补全DELIMITER

* **Original**:

```sql
use sakila
```

* **Suggest**:

```sql
use sakila;
```
[
  {
    "Name": "dml2select",
    "Description": "将数据库更新请求转换为只读查询请求,便于执行EXPLAIN",
    "Original": "DELETE FROM film WHERE length \u003e 100",
    "Suggest": "select * from film where length \u003e 100"
  },
  {
    "Name": "reg2select",
    "Description": "使用正则的方式将数据库更新请求转换为只读查询请求,便于执行EXPLAIN",
    "Original": "DELETE FROM film WHERE length \u003e 100",
    "Suggest": "select * from film where length \u003e 100"
  },
  {
    "Name": "star2columns",
    "Description": "为SELECT *补全表的列信息",
    "Original": "SELECT * FROM film",
    "Suggest": "select film.film_id, film.title from film"
  },
  {
    "Name": "insertcolumns",
    "Description": "为INSERT补全表的列信息",
    "Original": "insert into film values(1,2,3,4,5)",
    "Suggest": "insert into film(film_id, title, description, release_year, language_id) values (1, 2, 3, 4, 5)"
  },
  {
    "Name": "having",
    "Description": "将查询的 HAVING 子句改写为 WHERE 中的查询条件",
    "Original": "SELECT state, COUNT(*) FROM Drivers GROUP BY state HAVING state IN ('GA', 'TX') ORDER BY state",
    "Suggest": "select state, COUNT(*) from Drivers where state in ('GA', 'TX') group by state order by state asc"
  },
  {
    "Name": "orderbynull",
    "Description": "如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 ORDER BY NULL",
    "Original": "SELECT sum(col1) FROM tbl GROUP BY col",
    "Suggest": "select sum(col1) from tbl group by col order by null"
  },
  {
    "Name": "unionall",
    "Description": "可以接受重复的时间,使用 UNION ALL 替代 UNION 以提高查询效率",
    "Original": "select country_id from city union select country_id from country",
    "Suggest": "select country_id from city union all select country_id from country"
  },
  {
    "Name": "or2in",
    "Description": "将同一列不同条件的 OR 查询转写为 IN 查询",
    "Original": "select country_id from city where col1 = 1 or (col2 = 1 or col2 = 2 ) or col1 = 3;",
    "Suggest": "select country_id from city where (col2 in (1, 2)) or col1 in (1, 3);"
  },
  {
    "Name": "innull",
    "Description": "如果 IN 条件中可能有 NULL 值而又想匹配 NULL 值时,建议添加OR col IS NULL",
    "Original": "暂不支持",
    "Suggest": "暂不支持"
  },
  {
    "Name": "or2union",
    "Description": "将不同列的 OR 查询转为 UNION 查询,建议结合 unionall 重写策略一起使用",
    "Original": "暂不支持",
    "Suggest": "暂不支持"
  },
  {
    "Name": "dmlorderby",
    "Description": "删除 DML 更新操作中无意义的 ORDER BY",
    "Original": "DELETE FROM tbl WHERE col1=1 ORDER BY col",
    "Suggest": "delete from tbl where col1 = 1"
  },
  {
    "Name": "sub2join",
    "Description": "将子查询转换为JOIN查询",
    "Original": "暂不支持",
    "Suggest": "暂不支持"
  },
  {
    "Name": "join2sub",
    "Description": "将JOIN查询转换为子查询",
    "Original": "暂不支持",
    "Suggest": "暂不支持"
  },
  {
    "Name": "distinctstar",
    "Description": "DISTINCT *对有主键的表没有意义,可以将DISTINCT删掉",
    "Original": "SELECT DISTINCT * FROM film;",
    "Suggest": "SELECT * FROM film"
  },
  {
    "Name": "standard",
    "Description": "SQL标准化,如:关键字转换为小写",
    "Original": "SELECT sum(col1) FROM tbl GROUP BY 1;",
    "Suggest": "select sum(col1) from tbl group by 1"
  },
  {
    "Name": "mergealter",
    "Description": "合并同一张表的多条ALTER语句",
    "Original": "ALTER TABLE t2 DROP COLUMN c;ALTER TABLE t2 DROP COLUMN d;",
    "Suggest": "ALTER TABLE t2 DROP COLUMN c, DROP COLUMN d;"
  },
  {
    "Name": "alwaystrue",
    "Description": "删除无用的恒真判断条件",
    "Original": "SELECT count(col) FROM tbl where 'a'= 'a' or ('b' = 'b' and a = 'b');",
    "Suggest": "select count(col) from tbl where (a = 'b');"
  },
  {
    "Name": "countstar",
    "Description": "不建议使用COUNT(col)或COUNT(常量),建议改写为COUNT(*)",
    "Original": "SELECT count(col) FROM tbl GROUP BY 1;",
    "Suggest": "SELECT count(*) FROM tbl GROUP BY 1;"
  },
  {
    "Name": "innodb",
    "Description": "建表时建议使用InnoDB引擎,非 InnoDB 引擎表自动转 InnoDB",
    "Original": "CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT);",
    "Suggest": "create table t1 (\n\tid bigint(20) not null auto_increment\n) ENGINE=InnoDB;"
  },
  {
    "Name": "autoincrement",
    "Description": "将autoincrement初始化为1",
    "Original": "CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT) ENGINE=InnoDB AUTO_INCREMENT=123802;",
    "Suggest": "create table t1(id bigint(20) not null auto_increment) ENGINE=InnoDB auto_increment=1;"
  },
  {
    "Name": "intwidth",
    "Description": "整型数据类型修改默认显示宽度",
    "Original": "create table t1 (id int(20) not null auto_increment) ENGINE=InnoDB;",
    "Suggest": "create table t1 (id int(10) not null auto_increment) ENGINE=InnoDB;"
  },
  {
    "Name": "truncate",
    "Description": "不带 WHERE 条件的 DELETE 操作建议修改为 TRUNCATE",
    "Original": "DELETE FROM tbl",
    "Suggest": "truncate table tbl"
  },
  {
    "Name": "rmparenthesis",
    "Description": "去除没有意义的括号",
    "Original": "select col from table where (col = 1);",
    "Suggest": "select col from table where col = 1;"
  },
  {
    "Name": "delimiter",
    "Description": "补全DELIMITER",
    "Original": "use sakila",
    "Suggest": "use sakila;"
  }
]


================================================
FILE: ast/testdata/TestMergeAlterTables.golden
================================================
`customer` : ALTER TABLE `customer` ADD INDEX part_of_name (name(10)) ;

`db`.`old_table` : ALTER TABLE `db`.`old_table` RENAME new_table ;

`old_table` : ALTER TABLE `old_table` RENAME TO new_table, RENAME AS new_table ;

`sakila`.`t1` : ALTER TABLE `sakila`.`t1` add index `idx_col`(`col`), add UNIQUE index `idx_col`(`col`), add index `idx_ID`(`ID`) ;

`t1` : ALTER TABLE `t1` RENAME COLUMN a TO b, RENAME INDEX idx_a TO idx_b, RENAME KEY idx_a TO idx_b, MODIFY col1 BIGINT UNSIGNED DEFAULT 1 COMMENT 'my column', CHANGE b a INT NOT NULL ;

`t2` : ALTER TABLE `t2` DROP COLUMN c, DROP COLUMN d, ADD COLUMN C int, ADD COLUMN D int FIRST, ADD COLUMN E int AFTER D ;

`t3` : ALTER TABLE `t3` add index `idx_a`(a), drop index`idx_b` ;

`test_bb` : ALTER TABLE `test_bb` ADD INDEX idx_test_cca (test_cc) ;



================================================
FILE: ast/testdata/TestNewLines.golden
================================================
1
2
0


================================================
FILE: ast/testdata/TestPretty.golden
================================================
select sourcetable, if(f.lastcontent = ?, f.lastupdate, f.lastcontent) as lastactivity, f.totalcount as activity, type.class as type, (f.nodeoptions & ?) as nounsubscribe from node as f inner join contenttype as type on type.contenttypeid = f.contenttypeid inner join subscribed as sd on sd.did = f.nodeid and sd.userid = ? union all select f.name as title, f.userid as keyval, ? as sourcetable, ifnull(f.lastpost, f.joindate) as lastactivity, f.posts as activity, ? as type, ? as nounsubscribe from user as f inner join userlist as ul on ul.relationid = f.userid and ul.userid = ? where ul.type = ? and ul.aq = ? order by title limit ?

SELECT  
  sourcetable, IF( f. lastcontent  = ?, f. lastupdate, f. lastcontent) as  lastactivity, f. totalcount  as  activity, type. class  as  type, (f. nodeoptions  & ?) as  nounsubscribe  
FROM  
  node  as  f  
  INNER JOIN  contenttype  as  type  on  type. contenttypeid  = f. contenttypeid  
  INNER JOIN  subscribed  as  sd  on  sd. did  = f. nodeid  
  AND  sd. userid  = ?  
UNION ALL  
SELECT  
  f. name  as  title, f. userid  as  keyval, ?  as  sourcetable, IFNULL( f. lastpost, f. joindate) as  lastactivity, f. posts  as  activity, ?  as  type, ?  as  nounsubscribe  
FROM  
  USER  as  f  
  INNER JOIN  userlist  as  ul  on  ul. relationid  = f. userid  
  AND  ul. userid  = ?  
WHERE  
  ul. type  = ?  
  AND  ul. aq  = ?  
ORDER BY  
  title  
LIMIT  
  ?
administrator command: Init DB
administrator  command: Init  DB
CALL foo(1, 2, 3)
CALL  foo( 1, 2, 3)
### Channels ###
					SELECT sourcetable, IF(f.lastcontent = 0, f.lastupdate, f.lastcontent) AS lastactivity,
					f.totalcount AS activity, type.class AS type,
					(f.nodeoptions & 512) AS noUnsubscribe
					FROM node AS f
					INNER JOIN contenttype AS type ON type.contenttypeid = f.contenttypeid 

					INNER JOIN subscribed AS sd ON sd.did = f.nodeid AND sd.userid = 15965
 UNION  ALL 

					### Users ###
					SELECT f.name AS title, f.userid AS keyval, 'user' AS sourcetable, IFNULL(f.lastpost, f.joindate) AS lastactivity,
					f.posts as activity, 'Member' AS type,
					0 AS noUnsubscribe
					FROM user AS f
					INNER JOIN userlist AS ul ON ul.relationid = f.userid AND ul.userid = 15965
					WHERE ul.type = 'f' AND ul.aq = 'yes'
 ORDER BY title ASC LIMIT 100
### Channels ###
SELECT  
  sourcetable, IF( f. lastcontent  = 0, f. lastupdate, f. lastcontent) AS  lastactivity, f. totalcount  AS  activity, type. class  AS  type, (f. nodeoptions  & 512) AS  noUnsubscribe
 
FROM  
  node  AS  f
 
  INNER JOIN  contenttype  AS  type  ON  type. contenttypeid  = f. contenttypeid  
  INNER JOIN  subscribed  AS  sd  ON  sd. did  = f. nodeid  
  AND  sd. userid  = 15965
 
UNION  
  ALL  ### Users ###
SELECT  
  f. name  AS  title, f. userid  AS  keyval, 'user' AS  sourcetable, IFNULL( f. lastpost, f. joindate) AS  lastactivity, f. posts  as  activity, 'Member' AS  type, 0  AS  noUnsubscribe
 
FROM  
  USER  AS  f
 
  INNER JOIN  userlist  AS  ul  ON  ul. relationid  = f. userid  
  AND  ul. userid  = 15965
 
WHERE  
  ul. type  = 'f' 
  AND  ul. aq  = 'yes' 
ORDER BY  
  title  ASC  
LIMIT  
  100
CREATE DATABASE org235_percona345 COLLATE 'utf8_general_ci'
CREATE  DATABASE  org235_percona345  COLLATE  'utf8_general_ci'
insert into abtemp.coxed select foo.bar from foo
INSERT  into  abtemp. coxed  
SELECT  
  foo. bar  
FROM  
  foo
insert into foo(a, b, c) value(2, 4, 5)
INSERT  into  foo( a, b, c) value( 2, 4, 5)
insert into foo(a, b, c) values(2, 4, 5)
INSERT  into  foo( a, b, c) 
VALUES( 
  2, 4, 5)
insert into foo(a, b, c) values(2, 4, 5) , (2,4,5)
INSERT  into  foo( a, b, c) 
VALUES( 
  2, 4, 5), 
  (2, 4, 5)
insert into foo values (1, '(2)', 'This is a trick: ). More values.', 4)
INSERT  into  foo  
VALUES  
  (1, '(2)', 
  'This is a trick: ). More values.', 
  4)
insert into tb values (1)
INSERT  into  tb  
VALUES  
  (1)
INSERT INTO t (ts) VALUES ('()', '\(', '\)')
INSERT  INTO  t  (ts) 
VALUES  
  (
    '()', '\(', '\)')
INSERT INTO t (ts) VALUES (NOW())
INSERT  INTO  t  (ts) 
VALUES  
  (
    NOW()
  )
INSERT INTO t () VALUES ()
INSERT  INTO  t  (
) 
  VALUES  
    (
)
insert into t values (1), (2), (3)

	on duplicate key update query_count=1
INSERT  into  t  
VALUES  
  (1), 
  (2), 
  (3) on  duplicate  key  
UPDATE  
  query_count= 1
insert into t values (1) on duplicate key update query_count=COALESCE(query_count, 0) + VALUES(query_count)
INSERT  into  t  
VALUES  
  (1) on  duplicate  key  
UPDATE  
  query_count= COALESCE( query_count, 0) + 
VALUES( 
  query_count)
LOAD DATA INFILE '/tmp/foo.txt' INTO db.tbl
LOAD  DATA  INFILE  '/tmp/foo.txt' INTO  db. tbl
select 0e0, +6e-30, -6.00 from foo where a = 5.5 or b=0.5 or c=.5

SELECT  
  0e0, + 6e- 30, - 6.00  
FROM  
  foo  
WHERE  
  a  = 5.5  
  OR  b= 0.5  
  OR  c=.5
select 0x0, x'123', 0b1010, b'10101' from foo

SELECT  
  0x0, x' 123', 
  0b1010, b' 10101' 
FROM  
  foo
select 123_foo from 123_foo

SELECT  
  123_foo  
FROM  
  123_foo
select 123foo from 123foo

SELECT  
  123foo  
FROM  
  123foo
SELECT 	1 AS one FROM calls USE INDEX(index_name)

SELECT  
  1  AS  one  
FROM  
  calls  USE  INDEX( index_name)
SELECT /*!40001 SQL_NO_CACHE */ * FROM `film`

SELECT  
  
  /*!40001 SQL_NO_CACHE 
  */ * 
FROM  
  `film`
SELECT 'a' 'b' 'c' 'd' FROM kamil

SELECT  
  'a' 'b' 'c' 'd' 
FROM  
  kamil
SELECT BENCHMARK(100000000, pow(rand(), rand())), 1 FROM `-hj-7d6-shdj5-7jd-kf-g988h-`.`-aaahj-7d6-shdj5-7&^%$jd-kf-g988h-9+4-5*6ab-`

SELECT  
  BENCHMARK( 100000000, POW( RAND(
), 
RAND(
)
)
), 
1  
FROM  
  `-hj-7d6-shdj5-7jd-kf-g988h-`.`-aaahj-7d6-shdj5-7&^%$jd-kf-g988h-9+4-5*6ab-`
SELECT c FROM org235.t WHERE id=0xdeadbeaf

SELECT  
  c  
FROM  
  org235. t  
WHERE  
  id= 0xdeadbeaf
select c from t where i=1 order by c asc

SELECT  
  c  
FROM  
  t  
WHERE  
  i= 1  
ORDER BY  
  c  asc
SELECT c FROM t WHERE id=0xdeadbeaf

SELECT  
  c  
FROM  
  t  
WHERE  
  id= 0xdeadbeaf
SELECT c FROM t WHERE id=1

SELECT  
  c  
FROM  
  t  
WHERE  
  id= 1
select `col` from `table-1` where `id` = 5

SELECT  
  `col` 
FROM  
  `table-1` 
WHERE  
  `id` = 5
SELECT `db`.*, (CASE WHEN (`date_start` <=  '2014-09-10 09:17:59' AND `date_end` >=  '2014-09-10 09:17:59') THEN 'open' WHEN (`date_start` >  '2014-09-10 09:17:59' AND `date_end` >  '2014-09-10 09:17:59') THEN 'tbd' ELSE 'none' END) AS `status` FROM `foo` AS `db` WHERE (a_b in ('1', '10101'))

SELECT  
  `db`.*, 
  (CASE  WHEN  (`date_start` <= '2014-09-10 09:17:59' 
  AND  `date_end` >= '2014-09-10 09:17:59'
) THEN  'open' WHEN  (`date_start` > '2014-09-10 09:17:59' 
AND  `date_end` > '2014-09-10 09:17:59'
) THEN  'tbd' ELSE  'none' END) AS  `status` 
FROM  
  `foo` AS  `db` 
WHERE  
  (a_b  in  (
    '1', '10101')
  )
select field from `-master-db-1`.`-table-1-` order by id, ?;

SELECT  
  FIELD  
FROM  
  `-master-db-1`.`-table-1-` 
ORDER BY  
  id, ?;
select   foo

SELECT  
  foo
select foo_1 from foo_2_3

SELECT  
  foo_1  
FROM  
  foo_2_3
select foo -- bar


SELECT  
  foo  -- bar
select foo-- bar
,foo

SELECT  
  foo- - bar
, 
  foo
select '\\' from foo

SELECT  
  '\\' 
FROM  
  foo
select * from foo limit 5

SELECT  
  * 
FROM  
  foo  
LIMIT  
  5
select * from foo limit 5, 10

SELECT  
  * 
FROM  
  foo  
LIMIT  
  5, 10
select * from foo limit 5 offset 10

SELECT  
  * 
FROM  
  foo  
LIMIT  
  5  offset  10
SELECT * from foo where a = 5

SELECT  
  * 
FROM  
  foo  
WHERE  
  a  = 5
select * from foo where a in (5) and b in (5, 8,9 ,9 , 10)

SELECT  
  * 
FROM  
  foo  
WHERE  
  a  in  (5) 
  AND  b  in  (5, 8, 9, 
  9, 
  10)
SELECT '' '' '' FROM kamil

SELECT  
  '' '' '' 
FROM  
  kamil
 select  * from
foo where a = 5

SELECT  
  * 
FROM  
  foo  
WHERE  
  a  = 5
SELECT * FROM prices.rt_5min where id=1

SELECT  
  * 
FROM  
  prices. rt_5min  
WHERE  
  id= 1
SELECT * FROM table WHERE field = 'value' /*arbitrary/31*/ 

SELECT  
  * 
FROM  
  table  
WHERE  
  FIELD  = 'value' 
  /*arbitrary/31
  */
SELECT * FROM table WHERE field = 'value' /*arbitrary31*/ 

SELECT  
  * 
FROM  
  table  
WHERE  
  FIELD  = 'value' 
  /*arbitrary31
  */
SELECT *    FROM t WHERE 1=1 AND id=1

SELECT  
  * 
FROM  
  t  
WHERE  
  1= 1  
  AND  id= 1
select * from t where (base.nid IN  ('1412', '1410', '1411'))

SELECT  
  * 
FROM  
  t  
WHERE  
  (base. nid  IN  (
    '1412', '1410', '1411')
  )
select * from t where i=1      order            by
             a,  b          ASC, d    DESC,

                                    e asc

SELECT  
  * 
FROM  
  t  
WHERE  
  i= 1  order  by
 a, b  ASC, d  DESC, e  asc
select * from t where i=1 order by a, b ASC, d DESC, e asc

SELECT  
  * 
FROM  
  t  
WHERE  
  i= 1  
ORDER BY  
  a, b  ASC, d  DESC, e  asc
select 'hello'


SELECT  
  'hello'
select 'hello', '
hello
', "hello", '\'' from foo

SELECT  
  'hello', 
  '
hello
', 
  "hello", 
  '\'' 
FROM  
  foo
SELECT ID, name, parent, type FROM posts WHERE _name IN ('perf','caching') AND (type = 'page' OR type = 'attachment')

SELECT  
  ID, name, parent, type  
FROM  
  posts  
WHERE  
  _name  IN  (
    'perf', 'caching') 
    AND  (type  = 'page' 
    OR  type  = 'attachment'
  )
SELECT name, value FROM variable

SELECT  
  name, value  
FROM  
  variable
select 
-- bar
 foo

SELECT  
  -- bar
  foo
select null, 5.001, 5001. from foo

SELECT  
  null, 5.001, 5001. 
FROM  
  foo
select sleep(2) from test.n

SELECT  
  SLEEP( 2) 
FROM  
  test. n
SELECT t FROM field WHERE  (entity_type = 'node') AND (entity_id IN  ('609')) AND (language IN  ('und')) AND (deleted = '0') ORDER BY delta ASC

SELECT  
  t  
FROM  
  FIELD  
WHERE  
  (
    entity_type  = 'node') 
    AND  (entity_id  IN  (
      '609')
    ) 
    AND  (language  IN  (
      'und')
    ) 
    AND  (
      deleted  = '0') 
      ORDER BY  
        delta  ASC
select  t.table_schema,t.table_name,engine  from information_schema.tables t  inner join information_schema.columns c  on t.table_schema=c.table_schema and t.table_name=c.table_name group by t.table_schema,t.table_name having  sum(if(column_key in ('PRI','UNI'),1,0))=0

SELECT  
  t. table_schema, t. table_name, engine  
FROM  
  information_schema. tables  t  
  INNER JOIN  information_schema. columns  c  on  t. table_schema= c. table_schema  
  AND  t. table_name= c. table_name  
GROUP BY  
  t. table_schema, t. table_name  
HAVING  
  SUM( IF( column_key  in  (
    'PRI', 'UNI'), 
    1, 0)
  )= 0
/* -- S++ SU ABORTABLE -- spd_user: rspadim */SELECT SQL_SMALL_RESULT SQL_CACHE DISTINCT centro_atividade FROM est_dia WHERE unidade_id=1001 AND item_id=67 AND item_id_red=573

/* -- S++ SU ABORTABLE -- spd_user: rspadim 
*/ 
SELECT  
  SQL_SMALL_RESULT  SQL_CACHE  DISTINCT  centro_atividade  
FROM  
  est_dia  
WHERE  
  unidade_id= 1001  
  AND  item_id= 67  
  AND  item_id_red= 573
UPDATE groups_search SET  charter = '   -------3\'\' XXXXXXXXX.\n    \n    -----------------------------------------------------', show_in_list = 'Y' WHERE group_id='aaaaaaaa'

UPDATE  
  groups_search  
SET  
  charter  = '   -------3\'\' XXXXXXXXX.\n    \n    -----------------------------------------------------', 
  show_in_list  = 'Y' 
WHERE  
  group_id= 'aaaaaaaa'
use `foo`
use  `foo`
select sourcetable, if(f.lastcontent = ?, f.lastupdate, f.lastcontent) as lastactivity, f.totalcount as activity, type.class as type, (f.nodeoptions & ?) as nounsubscribe from node as f inner join contenttype as type on type.contenttypeid = f.contenttypeid inner join subscribed as sd on sd.did = f.nodeid and sd.userid = ? union all select f.name as title, f.userid as keyval, ? as sourcetable, ifnull(f.lastpost, f.joindate) as lastactivity, f.posts as activity, ? as type, ? as nounsubscribe from user as f inner join userlist as ul on ul.relationid = f.userid and ul.userid = ? where ul.type = ? and ul.aq = ? order by title limit ?

SELECT  
  sourcetable, IF( f. lastcontent  = ?, f. lastupdate, f. lastcontent) as  lastactivity, f. totalcount  as  activity, type. class  as  type, (f. nodeoptions  & ?) as  nounsubscribe  
FROM  
  node  as  f  
  INNER JOIN  contenttype  as  type  on  type. contenttypeid  = f. contenttypeid  
  INNER JOIN  subscribed  as  sd  on  sd. did  = f. nodeid  
  AND  sd. userid  = ?  
UNION ALL  
SELECT  
  f. name  as  title, f. userid  as  keyval, ?  as  sourcetable, IFNULL( f. lastpost, f. joindate) as  lastactivity, f. posts  as  activity, ?  as  type, ?  as  nounsubscribe  
FROM  
  USER  as  f  
  INNER JOIN  userlist  as  ul  on  ul. relationid  = f. userid  
  AND  ul. userid  = ?  
WHERE  
  ul. type  = ?  
  AND  ul. aq  = ?  
ORDER BY  
  title  
LIMIT  
  ?
CREATE INDEX part_of_name ON customer (name(10));
CREATE  INDEX  part_of_name  ON  customer  (
  name( 10));
alter table `sakila`.`t1` add index `idx_col`(`col`)

ALTER TABLE  
  `sakila`.`t1` 
ADD  
  index  `idx_col` (
    `col`)
alter table `sakila`.`t1` add UNIQUE index `idx_col`(`col`)

ALTER TABLE  
  `sakila`.`t1` 
ADD  
  UNIQUE  index  `idx_col` (
    `col`)
alter table `sakila`.`t1` add index `idx_ID`(`ID`)

ALTER TABLE  
  `sakila`.`t1` 
ADD  
  index  `idx_ID` (
    `ID`)
ALTER TABLE t2 DROP COLUMN c, DROP COLUMN d;

ALTER TABLE  
  t2  
DROP  
  COLUMN  c, 
DROP  
  COLUMN  d;
ALTER TABLE T2 ADD COLUMN C int;

ALTER TABLE  
  T2  
ADD  
  COLUMN  C  int;
ALTER TABLE T2 ADD COLUMN D int FIRST;

ALTER TABLE  
  T2  
ADD  
  COLUMN  D  int  FIRST;
ALTER TABLE T2 ADD COLUMN E int AFTER D;

ALTER TABLE  
  T2  
ADD  
  COLUMN  E  int  
AFTER  
  D;
ALTER TABLE t1 RENAME COLUMN a TO b

ALTER TABLE  
  t1  RENAME  COLUMN  a  TO  b
ALTER TABLE t1 RENAME INDEX idx_a TO idx_b

ALTER TABLE  
  t1  RENAME  INDEX  idx_a  TO  idx_b
ALTER TABLE t1 RENAME KEY idx_a TO idx_b

ALTER TABLE  
  t1  RENAME  KEY  idx_a  TO  idx_b
ALTER TABLE db.old_table RENAME new_table;

ALTER TABLE  
  db. old_table  RENAME  new_table;
ALTER TABLE old_table RENAME TO new_table;

ALTER TABLE  
  old_table  RENAME  TO  new_table;
ALTER TABLE old_table RENAME AS new_table;

ALTER TABLE  
  old_table  RENAME  AS  new_table;
ALTER TABLE t1 MODIFY col1 BIGINT UNSIGNED DEFAULT 1 COMMENT 'my column';

ALTER TABLE  
  t1  MODIFY  col1  BIGINT  UNSIGNED  DEFAULT  1  COMMENT  'my column';
ALTER TABLE t1 CHANGE b a INT NOT NULL;

ALTER TABLE  
  t1  CHANGE  b  a  INT  NOT  NULL;
/*!40000 select 1*/;

/*!40000 select 1
*/;
SELECT * FROM film WHERE length = 86;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 86;
SELECT * FROM film WHERE length IS NULL;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  IS  NULL;
SELECT * FROM film HAVING title = 'abc';

SELECT  
  * 
FROM  
  film  
HAVING  
  title  = 'abc';
SELECT * FROM sakila.film WHERE length >= 60;

SELECT  
  * 
FROM  
  sakila. film  
WHERE  
  LENGTH  >= 60;
SELECT * FROM sakila.film WHERE length >= '60';

SELECT  
  * 
FROM  
  sakila. film  
WHERE  
  LENGTH  >= '60';
SELECT * FROM film WHERE length BETWEEN 60 AND 84;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  BETWEEN  60  
  AND  84;
SELECT * FROM film WHERE title LIKE 'AIR%';

SELECT  
  * 
FROM  
  film  
WHERE  
  title  LIKE  'AIR%';
SELECT * FROM film WHERE title IS NOT NULL;

SELECT  
  * 
FROM  
  film  
WHERE  
  title  IS  NOT  NULL;
SELECT * FROM film WHERE length = 114 and title = 'ALABAMA DEVIL';

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 114  
  AND  title  = 'ALABAMA DEVIL';
SELECT * FROM film WHERE length > 100 and title = 'ALABAMA DEVIL';

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
  AND  title  = 'ALABAMA DEVIL';
SELECT * FROM film WHERE length > 100 and language_id < 10 and title = 'xyz';

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
  AND  language_id  < 10  
  AND  title  = 'xyz';
SELECT * FROM film WHERE length > 100 and language_id < 10;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
  AND  language_id  < 10;
SELECT release_year, sum(length) FROM film WHERE length = 123 AND language_id = 1 GROUP BY release_year;

SELECT  
  release_year, SUM( LENGTH) 
FROM  
  film  
WHERE  
  LENGTH  = 123  
  AND  language_id  = 1  
GROUP BY  
  release_year;
SELECT release_year, sum(length) FROM film WHERE length >= 123 GROUP BY release_year;

SELECT  
  release_year, SUM( LENGTH) 
FROM  
  film  
WHERE  
  LENGTH  >= 123  
GROUP BY  
  release_year;
SELECT release_year, language_id, sum(length) FROM film GROUP BY release_year, language_id;

SELECT  
  release_year, language_id, SUM( LENGTH) 
FROM  
  film  
GROUP BY  
  release_year, language_id;
SELECT release_year, sum(length) FROM film WHERE length = 123 GROUP BY release_year,(length+language_id);

SELECT  
  release_year, SUM( LENGTH) 
FROM  
  film  
WHERE  
  LENGTH  = 123  
GROUP BY  
  release_year, (LENGTH+ language_id);
SELECT release_year, sum(film_id) FROM film GROUP BY release_year;

SELECT  
  release_year, SUM( film_id) 
FROM  
  film  
GROUP BY  
  release_year;
SELECT * FROM address GROUP BY address,district;

SELECT  
  * 
FROM  
  address  
GROUP BY  
  address, district;
SELECT title FROM film WHERE ABS(language_id) = 3 GROUP BY title;

SELECT  
  title  
FROM  
  film  
WHERE  
  ABS( language_id) = 3  
GROUP BY  
  title;
SELECT language_id FROM film WHERE length = 123 GROUP BY release_year ORDER BY language_id;

SELECT  
  language_id  
FROM  
  film  
WHERE  
  LENGTH  = 123  
GROUP BY  
  release_year  
ORDER BY  
  language_id;
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year;

SELECT  
  release_year  
FROM  
  film  
WHERE  
  LENGTH  = 123  
GROUP BY  
  release_year  
ORDER BY  
  release_year;
SELECT * FROM film WHERE length = 123 ORDER BY release_year ASC, language_id DESC;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 123  
ORDER BY  
  release_year  ASC, language_id  DESC;
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year LIMIT 10;

SELECT  
  release_year  
FROM  
  film  
WHERE  
  LENGTH  = 123  
GROUP BY  
  release_year  
ORDER BY  
  release_year  
LIMIT  
  10;
SELECT * FROM film WHERE length = 123 ORDER BY release_year LIMIT 10;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 123  
ORDER BY  
  release_year  
LIMIT  
  10;
SELECT * FROM film ORDER BY release_year LIMIT 10;

SELECT  
  * 
FROM  
  film  
ORDER BY  
  release_year  
LIMIT  
  10;
SELECT film_id FROM film ORDER BY release_year LIMIT 10;

SELECT  
  film_id  
FROM  
  film  
ORDER BY  
  release_year  
LIMIT  
  10;
SELECT * FROM film WHERE length > 100 ORDER BY length LIMIT 10;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
ORDER BY  
  LENGTH  
LIMIT  
  10;
SELECT * FROM film WHERE length < 100 ORDER BY length LIMIT 10;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  < 100  
ORDER BY  
  LENGTH  
LIMIT  
  10;
SELECT * FROM customer WHERE address_id in (224,510) ORDER BY last_name;

SELECT  
  * 
FROM  
  customer  
WHERE  
  address_id  in  (224, 510) 
ORDER BY  
  last_name;
SELECT * FROM film WHERE release_year = 2016 AND length != 1 ORDER BY title;

SELECT  
  * 
FROM  
  film  
WHERE  
  release_year  = 2016  
  AND  LENGTH  != 1  
ORDER BY  
  title;
SELECT title FROM film WHERE release_year = 1995;

SELECT  
  title  
FROM  
  film  
WHERE  
  release_year  = 1995;
SELECT title, replacement_cost FROM film WHERE language_id = 5 AND length = 70;

SELECT  
  title, replacement_cost  
FROM  
  film  
WHERE  
  language_id  = 5  
  AND  LENGTH  = 70;
SELECT title FROM film WHERE language_id > 5 AND length > 70;

SELECT  
  title  
FROM  
  film  
WHERE  
  language_id  > 5  
  AND  LENGTH  > 70;
SELECT * FROM film WHERE length = 100 and title = 'xyz' ORDER BY release_year;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  = 100  
  AND  title  = 'xyz' 
ORDER BY  
  release_year;
SELECT * FROM film WHERE length > 100 and title = 'xyz' ORDER BY release_year;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
  AND  title  = 'xyz' 
ORDER BY  
  release_year;
SELECT * FROM film WHERE length > 100 ORDER BY release_year;

SELECT  
  * 
FROM  
  film  
WHERE  
  LENGTH  > 100  
ORDER BY  
  release_year;
SELECT * FROM city a INNER JOIN country b ON a.country_id=b.country_id;

SELECT  
  * 
FROM  
  city  a  
  INNER JOIN  country  b  ON  a. country_id= b. country_id;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id;

SELECT  
  * 
FROM  
  city  a  
  LEFT JOIN  country  b  ON  a. country_id= b. country_id;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;

SELECT  
  * 
FROM  
  city  a  
  RIGHT JOIN  country  b  ON  a. country_id= b. country_id;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;

SELECT  
  * 
FROM  
  city  a  
  LEFT JOIN  country  b  ON  a. country_id= b. country_id  
WHERE  
  b. last_update  IS  NULL;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL;

SELECT  
  * 
FROM  
  city  a  
  RIGHT JOIN  country  b  ON  a. country_id= b. country_id  
WHERE  
  a. last_update  IS  NULL;
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;

SELECT  
  * 
FROM  
  city  a  
  LEFT JOIN  country  b  ON  a. country_id= b. country_id  
UNION  
SELECT  
  * 
FROM  
  city  a  
  RIGHT JOIN  country  b  ON  a. country_id= b. country_id;
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;

SELECT  
  * 
FROM  
  city  a  
  RIGHT JOIN  country  b  ON  a. country_id= b. country_id  
WHERE  
  a. last_update  IS  NULL  
UNION  
SELECT  
  * 
FROM  
  city  a  
  LEFT JOIN  country  b  ON  a. country_id= b. country_id  
WHERE  
  b. last_update  IS  NULL;
SELECT country_id, last_update FROM city NATURAL JOIN country;

SELECT  
  country_id, last_update  
FROM  
  city  NATURAL  
  JOIN  country;
SELECT country_id, last_update FROM city NATURAL LEFT JOIN country;

SELECT  
  country_id, last_update  
FROM  
  city  NATURAL  
  LEFT JOIN  country;
SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country;

SELECT  
  country_id, last_update  
FROM  
  city  NATURAL  
  RIGHT JOIN  country;
SELECT a.country_id, a.last_update FROM city a STRAIGHT_JOIN country b ON a.country_id=b.country_id;

SELECT  
  a. country_id, a. last_update  
FROM  
  city  a  STRAIGHT_JOIN  country  b  ON  a. country_id= b. country_id;
SELECT a.address, a.postal_code FROM sakila.address a WHERE a.city_id IN  (SELECT c.city_id FROM sakila.city c);

SELECT  
  a. address, a. postal_code  
FROM  
  sakila. address  a  
WHERE  
  a. city_id  IN  (
SELECT  
  c. city_id  
FROM  
  sakila. city  c);
SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I.city_id = city.city_id) JOIN country ON (country.country_id = city.country_id) ORDER BY city DESC;

SELECT  
  city  
FROM( 
SELECT  
  city_id  
FROM  
  city  
WHERE  
  city  = "A Corua (La Corua)" 
ORDER BY  
  last_update  DESC  
LIMIT  
  50, 10) I  
  JOIN  city  ON  (I. city_id  = city. city_id) 
  JOIN  country  ON  (country. country_id  = city. country_id) 
ORDER BY  
  city  DESC;
DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1;
DELETE  city, country  
FROM  
  city  
  INNER JOIN  country  using  (country_id) 
WHERE  
  city. city_id  = 1;
DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL;
DELETE  city  
FROM  
  city  
  LEFT JOIN  country  ON  city. country_id  = country. country_id  
WHERE  
  country. country  IS  NULL;
DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
DELETE  a1, a2  
FROM  
  city  AS  a1  
  INNER JOIN  country  AS  a2  
WHERE  
  a1. country_id= a2. country_id;
DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;

DELETE FROM  
  a1, a2  USING  city  AS  a1  
  INNER JOIN  country  AS  a2  
WHERE  
  a1. country_id= a2. country_id;
DELETE FROM film WHERE length > 100;

DELETE FROM  
  film  
WHERE  
  LENGTH  > 100;
UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;

UPDATE  
  city  
  INNER JOIN  country  USING( country_id) 
SET  
  city. city  = 'Abha', 
  city. last_update  = '2006-02-15 04:45:25', 
  country. country  = 'Afghanistan' 
WHERE  
  city. city_id= 10;
UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;

UPDATE  
  city  
  INNER JOIN  country  ON  city. country_id  = country. country_id  
  INNER JOIN  address  ON  city. city_id  = address. city_id  
SET  
  city. city  = 'Abha', 
  city. last_update  = '2006-02-15 04:45:25', 
  country. country  = 'Afghanistan' 
WHERE  
  city. city_id= 10;
UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10;

UPDATE  
  city, country  
SET  
  city. city  = 'Abha', 
  city. last_update  = '2006-02-15 04:45:25', 
  country. country  = 'Afghanistan' 
WHERE  
  city. country_id  = country. country_id  
  AND  city. city_id= 10;
UPDATE film SET length = 10 WHERE language_id = 20;

UPDATE  
  film  
SET  
  LENGTH  = 10  
WHERE  
  language_id  = 20;
INSERT INTO city (country_id) SELECT country_id FROM country;
INSERT  INTO  city  (country_id) 
SELECT  
  country_id  
FROM  
  country;
INSERT INTO city (country_id) VALUES (1),(2),(3);
INSERT  INTO  city  (country_id) 
VALUES  
  (1), 
  (2), 
  (3);
INSERT INTO city (country_id) VALUES (10);
INSERT  INTO  city  (country_id) 
VALUES  
  (10);
INSERT INTO city (country_id) SELECT 10 FROM DUAL;
INSERT  INTO  city  (country_id) 
SELECT  
  10  
FROM  
  DUAL;
REPLACE INTO city (country_id) SELECT country_id FROM country;
REPLACE  INTO  city  (country_id) 
SELECT  
  country_id  
FROM  
  country;
REPLACE INTO city (country_id) VALUES (1),(2),(3);
REPLACE  INTO  city  (country_id) 
VALUES  
  (1), 
  (2), 
  (3);
REPLACE INTO city (country_id) VALUES (10);
REPLACE  INTO  city  (country_id) 
VALUES  
  (10);
REPLACE INTO city (country_id) SELECT 10 FROM DUAL;
REPLACE  INTO  city  (country_id) 
SELECT  
  10  
FROM  
  DUAL;
SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM  film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film;

SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  (
SELECT  
  film_id  
FROM  
  film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film
) film;
SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1);

SELECT  
  * 
FROM  
  film  
WHERE  
  language_id  = (
SELECT  
  language_id  
FROM  
  language  
LIMIT  
  1);
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;

SELECT  
  * 
FROM  
  city  i  
  LEFT JOIN  country  o  ON  i. city_id= o. country_id  
UNION  
SELECT  
  * 
FROM  
  city  i  
  RIGHT JOIN  country  o  ON  i. city_id= o. country_id;
SELECT * FROM (SELECT * FROM actor WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE') t WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE' GROUP BY first_name;

SELECT  
  * 
FROM  
  (
SELECT  
  * 
FROM  
  actor  
WHERE  
  last_update= '2006-02-15 04:34:33' 
  AND  last_name= 'CHASE'
) t  
WHERE  
  last_update= '2006-02-15 04:34:33' 
  AND  last_name= 'CHASE' 
GROUP BY  
  first_name;
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;

SELECT  
  * 
FROM  
  city  i  
  LEFT JOIN  country  o  ON  i. city_id= o. country_id  
UNION  
SELECT  
  * 
FROM  
  city  i  
  RIGHT JOIN  country  o  ON  i. city_id= o. country_id;
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id WHERE o.country_id is null union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id WHERE i.city_id is null;

SELECT  
  * 
FROM  
  city  i  
  LEFT JOIN  country  o  ON  i. city_id= o. country_id  
WHERE  
  o. country_id  is  null  
UNION  
SELECT  
  * 
FROM  
  city  i  
  RIGHT JOIN  country  o  ON  i. city_id= o. country_id  
WHERE  
  i. city_id  is  null;
SELECT first_name,last_name,email FROM customer STRAIGHT_JOIN address ON customer.address_id=address.address_id;

SELECT  
  first_name, last_name, email  
FROM  
  customer  STRAIGHT_JOIN  address  ON  customer. address_id= address. address_id;
SELECT ID,name FROM (SELECT address FROM customer_list WHERE SID=1 order by phone limit 50,10) a JOIN customer_list l ON (a.address=l.address) JOIN city c ON (c.city=l.city) order by phone desc;

SELECT  
  ID, name  
FROM  
  (
SELECT  
  address  
FROM  
  customer_list  
WHERE  
  SID= 1  
ORDER BY  
  phone  
LIMIT  
  50, 10) a  
  JOIN  customer_list  l  ON  (a. address= l. address) 
  JOIN  city  c  ON  (c. city= l. city) 
ORDER BY  
  phone  desc;
SELECT * FROM film WHERE date(last_update)='2006-02-15';

SELECT  
  * 
FROM  
  film  
WHERE  
  DATE( last_update) = '2006-02-15';
SELECT last_update FROM film GROUP BY date(last_update);

SELECT  
  last_update  
FROM  
  film  
GROUP BY  
  DATE( last_update);
SELECT last_update FROM film order by date(last_update);

SELECT  
  last_update  
FROM  
  film  
ORDER BY  
  DATE( last_update);
SELECT description FROM film WHERE description IN('NEWS','asd') GROUP BY description;

SELECT  
  description  
FROM  
  film  
WHERE  
  description  IN( 'NEWS', 
  'asd'
) 
GROUP BY  
  description;
alter table address add index idx_city_id(city_id);

ALTER TABLE  
  address  
ADD  
  index  idx_city_id( city_id);
alter table inventory add index `idx_store_film` (`store_id`,`film_id`);

ALTER TABLE  
  inventory  
ADD  
  index  `idx_store_film` (
    `store_id`, `film_id`);
alter table inventory add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`);

ALTER TABLE  
  inventory  
ADD  
  index  `idx_store_film` (
    `store_id`, `film_id`), 
      ADD  
      index  `idx_store_film` (
        `store_id`, `film_id`), 
              ADD  
          index  `idx_store_film` (
            `store_id`, `film_id`);
SELECT	DATE_FORMAT(t.last_update, '%Y-%m-%d'),	COUNT(DISTINCT (t.city))	FROM city t WHERE t.last_update > '2018-10-22 00:00:00'	AND t.city LIKE '%Chrome%'	AND t.city = 'eip' GROUP BY DATE_FORMAT(t.last_update, '%Y-%m-%d') ORDER BY DATE_FORMAT(t.last_update, '%Y-%m-%d');

SELECT  
  DATE_FORMAT( t. last_update, '%Y-%m-%d'
), 
COUNT( DISTINCT  (
  t. city)) 
  FROM  
    city  t  
  WHERE  
    t. last_update  > '2018-10-22 00:00:00' 
    AND  t. city  LIKE  '%Chrome%' 
    AND  t. city  = 'eip' 
  GROUP BY  
    DATE_FORMAT( t. last_update, '%Y-%m-%d'
) 
ORDER BY  
  DATE_FORMAT( t. last_update, '%Y-%m-%d'
);
create table hello.t (id int unsigned);
create  table  hello. t  (id  int  unsigned);
select * from tb where data >= '';

SELECT  
  * 
FROM  
  tb  
WHERE  
  data  >= '';
alter table tb alter column id drop default;

ALTER TABLE  
  tb  alter  column  id  
DROP  
  DEFAULT;
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film where last_update > '2016-03-27 02:01:01') as d;

SELECT  
  maxId, minId  
FROM  
  (
SELECT  
  MAX( film_id) maxId, MIN( film_id) minId  
FROM  
  film  
WHERE  
  last_update  > '2016-03-27 02:01:01'
) as  d;
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film) as d;

SELECT  
  maxId, minId  
FROM  
  (
SELECT  
  MAX( film_id) maxId, MIN( film_id) minId  
FROM  
  film) as  d;
select 1


================================================
FILE: ast/testdata/TestPrintPrettyStmtNode.golden
================================================
[]ast.StmtNode{
    &ast.SelectStmt{
        dmlNode: ast.dmlNode{
            stmtNode: ast.stmtNode{
                node: ast.node{text:"select 1", offset:0},
            },
        },
        SelectStmtOpts: &ast.SelectStmtOpts{
            Distinct:        false,
            SQLBigResult:    false,
            SQLBufferResult: false,
            SQLCache:        true,
            SQLSmallResult:  false,
            CalcFoundRows:   false,
            StraightJoin:    false,
            Priority:        0,
            TableHints:      nil,
            ExplicitAll:     false,
        },
        Distinct: false,
        From:     (*ast.TableRefsClause)(nil),
        Where:    nil,
        Fields:   &ast.FieldList{
            node:   ast.node{},
            Fields: {
                &ast.SelectField{
                    node:     ast.node{text:"1", offset:0},
                    Offset:   7,
                    WildCard: (*ast.WildCardField)(nil),
                    Expr:     &driver.ValueExpr{
                        TexprNode: ast.exprNode{
                            node: ast.node{text:"", offset:7},
                            Type: types.FieldType{
                                Tp:      0x8,
                                Flag:    0x80,
                                Flen:    1,
                                Decimal: 0,
                                Charset: "binary",
                                Collate: "binary",
                                Elems:   nil,
                            },
                            flag: 0x0,
                        },
                        Datum: types.Datum{
                            k:         0x1,
                            decimal:   0x0,
                            length:    0x0,
                            i:         1,
                            collation: "",
                            b:         nil,
                            x:         nil,
                        },
                        projectionOffset: -1,
                    },
                    AsName:    model.CIStr{},
                    Auxiliary: false,
                },
            },
        },
        GroupBy:          (*ast.GroupByClause)(nil),
        Having:           (*ast.HavingClause)(nil),
        WindowSpecs:      nil,
        OrderBy:          (*ast.OrderByClause)(nil),
        Limit:            (*ast.Limit)(nil),
        LockInfo:         (*ast.SelectLockInfo)(nil),
        TableHints:       nil,
        IsInBraces:       false,
        WithBeforeBraces: false,
        QueryBlockOffset: 0,
        SelectIntoOpt:    (*ast.SelectIntoOption)(nil),
        AfterSetOperator: (*ast.SetOprType)(nil),
        Kind:             0x0,
        Lists:            nil,
        With:             (*ast.WithClause)(nil),
    },
}


================================================
FILE: ast/testdata/TestPrintPrettyVitessStmtNode.golden
================================================
&sqlparser.Select{
    Cache:       "",
    Comments:    nil,
    Distinct:    "",
    Hints:       "",
    SelectExprs: {
        &sqlparser.AliasedExpr{
            Expr: &sqlparser.SQLVal{
                Type: 1,
                Val:  {0x31},
            },
            As: sqlparser.ColIdent{},
        },
    },
    From: {
        &sqlparser.AliasedTableExpr{
            Expr: sqlparser.TableName{
                Name:      sqlparser.TableIdent{v:"dual"},
                Qualifier: sqlparser.TableIdent{},
            },
            Partitions: nil,
            As:         sqlparser.TableIdent{},
            Hints:      (*sqlparser.IndexHints)(nil),
        },
    },
    Where:   (*sqlparser.Where)(nil),
    GroupBy: nil,
    Having:  (*sqlparser.Where)(nil),
    OrderBy: nil,
    Limit:   (*sqlparser.Limit)(nil),
    Lock:    "",
}


================================================
FILE: ast/testdata/TestQueryType.golden
================================================
SELECT
SELECT
SELECT
GRANT
REVOKE
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
DELETE
DELETE
DELETE
DELETE
DELETE
UPDATE
UPDATE
UPDATE
UPDATE
INSERT
INSERT
INSERT
INSERT
REPLACE
REPLACE
REPLACE
REPLACE
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
SELECT
ALTER
ALTER
ALTER
SELECT
CREATE
SELECT
ALTER
SELECT
SELECT


================================================
FILE: ast/testdata/TestSchemaMetaInfo.golden
================================================
use world_x;
[`world_x`.`dual`]
select 1;
[]
syntax error case
[]
select * from ta join tb using (id)
[`sakila`.`ta` `sakila`.`tb`]
select * from ta, tb limit 1
[`sakila`.`ta` `sakila`.`tb`]
drop table tb
[`sakila`.`tb`]
drop table db.tb
[`db`.`tb`]
drop database db
[`db`.`dual`]
create database db
[`db`.`dual`]
create index idx_col on tbl (col)
[`sakila`.`tbl`]
DROP INDEX idx_col on tbl
[`sakila`.`tbl`]
SELECT * FROM film WHERE length = 86;
[`sakila`.`film`]
SELECT * FROM film WHERE length IS NULL;
[`sakila`.`film`]
SELECT * FROM film HAVING title = 'abc';
[`sakila`.`film`]
SELECT * FROM sakila.film WHERE length >= 60;
[`sakila`.`film`]
SELECT * FROM sakila.film WHERE length >= '60';
[`sakila`.`film`]
SELECT * FROM film WHERE length BETWEEN 60 AND 84;
[`sakila`.`film`]
SELECT * FROM film WHERE title LIKE 'AIR%';
[`sakila`.`film`]
SELECT * FROM film WHERE title IS NOT NULL;
[`sakila`.`film`]
SELECT * FROM film WHERE length = 114 and title = 'ALABAMA DEVIL';
[`sakila`.`film`]
SELECT * FROM film WHERE length > 100 and title = 'ALABAMA DEVIL';
[`sakila`.`film`]
SELECT * FROM film WHERE length > 100 and language_id < 10 and title = 'xyz';
[`sakila`.`film`]
SELECT * FROM film WHERE length > 100 and language_id < 10;
[`sakila`.`film`]
SELECT release_year, sum(length) FROM film WHERE length = 123 AND language_id = 1 GROUP BY release_year;
[`sakila`.`film`]
SELECT release_year, sum(length) FROM film WHERE length >= 123 GROUP BY release_year;
[`sakila`.`film`]
SELECT release_year, language_id, sum(length) FROM film GROUP BY release_year, language_id;
[`sakila`.`film`]
SELECT release_year, sum(length) FROM film WHERE length = 123 GROUP BY release_year,(length+language_id);
[`sakila`.`film`]
SELECT release_year, sum(film_id) FROM film GROUP BY release_year;
[`sakila`.`film`]
SELECT * FROM address GROUP BY address,district;
[`sakila`.`address`]
SELECT title FROM film WHERE ABS(language_id) = 3 GROUP BY title;
[`sakila`.`film`]
SELECT language_id FROM film WHERE length = 123 GROUP BY release_year ORDER BY language_id;
[`sakila`.`film`]
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year;
[`sakila`.`film`]
SELECT * FROM film WHERE length = 123 ORDER BY release_year ASC, language_id DESC;
[`sakila`.`film`]
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year LIMIT 10;
[`sakila`.`film`]
SELECT * FROM film WHERE length = 123 ORDER BY release_year LIMIT 10;
[`sakila`.`film`]
SELECT * FROM film ORDER BY release_year LIMIT 10;
[`sakila`.`film`]
SELECT film_id FROM film ORDER BY release_year LIMIT 10;
[`sakila`.`film`]
SELECT * FROM film WHERE length > 100 ORDER BY length LIMIT 10;
[`sakila`.`film`]
SELECT * FROM film WHERE length < 100 ORDER BY length LIMIT 10;
[`sakila`.`film`]
SELECT * FROM customer WHERE address_id in (224,510) ORDER BY last_name;
[`sakila`.`customer`]
SELECT * FROM film WHERE release_year = 2016 AND length != 1 ORDER BY title;
[`sakila`.`film`]
SELECT title FROM film WHERE release_year = 1995;
[`sakila`.`film`]
SELECT title, replacement_cost FROM film WHERE language_id = 5 AND length = 70;
[`sakila`.`film`]
SELECT title FROM film WHERE language_id > 5 AND length > 70;
[`sakila`.`film`]
SELECT * FROM film WHERE length = 100 and title = 'xyz' ORDER BY release_year;
[`sakila`.`film`]
SELECT * FROM film WHERE length > 100 and title = 'xyz' ORDER BY release_year;
[`sakila`.`film`]
SELECT * FROM film WHERE length > 100 ORDER BY release_year;
[`sakila`.`film`]
SELECT * FROM city a INNER JOIN country b ON a.country_id=b.country_id;
[`sakila`.`city` `sakila`.`country`]
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id;
[`sakila`.`city` `sakila`.`country`]
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;
[`sakila`.`city` `sakila`.`country`]
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;
[`sakila`.`city` `sakila`.`country`]
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL;
[`sakila`.`city` `sakila`.`country`]
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;
[`sakila`.`city` `sakila`.`country`]
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;
[`sakila`.`city` `sakila`.`country`]
SELECT country_id, last_update FROM city NATURAL JOIN country;
[`sakila`.`city` `sakila`.`country`]
SELECT country_id, last_update FROM city NATURAL LEFT JOIN country;
[`sakila`.`city` `sakila`.`country`]
SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country;
[`sakila`.`city` `sakila`.`country`]
SELECT a.country_id, a.last_update FROM city a STRAIGHT_JOIN country b ON a.country_id=b.country_id;
[`sakila`.`city` `sakila`.`country`]
SELECT a.address, a.postal_code FROM sakila.address a WHERE a.city_id IN  (SELECT c.city_id FROM sakila.city c);
[`sakila`.`address` `sakila`.`city`]
SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I.city_id = city.city_id) JOIN country ON (country.country_id = city.country_id) ORDER BY city DESC;
[`sakila`.`city` `sakila`.`country`]
DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1;
[`sakila`.`city` `sakila`.`country`]
DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL;
[`sakila`.`city` `sakila`.`country`]
DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
[`sakila`.`city` `sakila`.`country`]
DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
[`sakila`.`city` `sakila`.`country`]
DELETE FROM film WHERE length > 100;
[`sakila`.`film`]
UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;
[`sakila`.`city` `sakila`.`country`]
UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;
[`sakila`.`address` `sakila`.`city` `sakila`.`country`]
UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10;
[`sakila`.`city` `sakila`.`country`]
UPDATE film SET length = 10 WHERE language_id = 20;
[`sakila`.`film`]
INSERT INTO city (country_id) SELECT country_id FROM country;
[`sakila`.`city` `sakila`.`country`]
INSERT INTO city (country_id) VALUES (1),(2),(3);
[`sakila`.`city`]
INSERT INTO city (country_id) VALUES (10);
[`sakila`.`city`]
INSERT INTO city (country_id) SELECT 10 FROM DUAL;
[`sakila`.`city`]
REPLACE INTO city (country_id) SELECT country_id FROM country;
[`sakila`.`city` `sakila`.`country`]
REPLACE INTO city (country_id) VALUES (1),(2),(3);
[`sakila`.`city`]
REPLACE INTO city (country_id) VALUES (10);
[`sakila`.`city`]
REPLACE INTO city (country_id) SELECT 10 FROM DUAL;
[`sakila`.`city`]
SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM  film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film;
[`sakila`.`film`]
SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1);
[`sakila`.`film` `sakila`.`language`]
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;
[`sakila`.`city` `sakila`.`country`]
SELECT * FROM (SELECT * FROM actor WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE') t WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE' GROUP BY first_name;
[`sakila`.`actor`]
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;
[`sakila`.`city` `sakila`.`country`]
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id WHERE o.country_id is null union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id WHERE i.city_id is null;
[`sakila`.`city` `sakila`.`country`]
SELECT first_name,last_name,email FROM customer STRAIGHT_JOIN address ON customer.address_id=address.address_id;
[`sakila`.`address` `sakila`.`customer`]
SELECT ID,name FROM (SELECT address FROM customer_list WHERE SID=1 order by phone limit 50,10) a JOIN customer_list l ON (a.address=l.address) JOIN city c ON (c.city=l.city) order by phone desc;
[`sakila`.`city` `sakila`.`customer_list`]
SELECT * FROM film WHERE date(last_update)='2006-02-15';
[`sakila`.`film`]
SELECT last_update FROM film GROUP BY date(last_update);
[`sakila`.`film`]
SELECT last_update FROM film order by date(last_update);
[`sakila`.`film`]
SELECT description FROM film WHERE description IN('NEWS','asd') GROUP BY description;
[`sakila`.`film`]
alter table address add index idx_city_id(city_id);
[`sakila`.`address`]
alter table inventory add index `idx_store_film` (`store_id`,`film_id`);
[`sakila`.`inventory`]
alter table inventory add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`);
[`sakila`.`inventory`]
SELECT	DATE_FORMAT(t.last_update, '%Y-%m-%d'),	COUNT(DISTINCT (t.city))	FROM city t WHERE t.last_update > '2018-10-22 00:00:00'	AND t.city LIKE '%Chrome%'	AND t.city = 'eip' GROUP BY DATE_FORMAT(t.last_update, '%Y-%m-%d') ORDER BY DATE_FORMAT(t.last_update, '%Y-%m-%d');
[`sakila`.`city`]
create table hello.t (id int unsigned);
[`hello`.`t`]
select * from tb where data >= '';
[`sakila`.`tb`]
alter table tb alter column id drop default;
[`sakila`.`tb`]
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film where last_update > '2016-03-27 02:01:01') as d;
[`sakila`.`film`]
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film) as d;
[`sakila`.`film`]


================================================
FILE: ast/testdata/TestSplitStatement.golden
================================================
0 select * from test;
1 select 'asd;fas', col from test;
2 -- select * from test;hello
3 #select * from test;hello
4 select * /*comment*/from test;
5 select * /*comment;*/from test;
6 select * /*comment
		;*/
		from test;
7 select * from test
8 /*comment*/
9 /*comment*/;
10 --
11 -- comment
12 # comment
13 select
*
-- comment
from tb
where col = 1
14 select
* --
from tb
where col = 1
15 select
* #
from tb
where col = 1
16 select
*
--
from tb
where col = 1
17 select * from
-- comment
tb;
18 
-- comment
19 INSERT /*+ SET_VAR(foreign_key_checks=OFF) */ INTO t2 VALUES(2);
20 select /*!50000 1,*/ 1;
21 UPDATE xxx SET c1=' LOGGER.error(""); }' WHERE id = 2 ;
22 UPDATE `xxx` SET aaa='a;' WHERE `id` = 15;
23 UPDATE `xxx` SET aaa='a -- b' WHERE `id` = 15;
0 select * from test\G
1 select 'hello\Gworld', col from test\G
2 -- select * from test\Ghello
3 #select * from test\Ghello
4 select * /*comment*/from test\G
5 select * /*comment;*/from test\G
6 select * /*comment
        \\G*/
        from test\\G


================================================
FILE: ast/testdata/TestStmtNode2JSON.golden
================================================
[
  {
    "text": "select 1",
    "offset": 0,
    "SQLBigResult": false,
    "SQLBufferResult": false,
    "SQLCache": true,
    "SQLSmallResult": false,
    "CalcFoundRows": false,
    "StraightJoin": false,
    "Priority": 0,
    "ExplicitAll": false,
    "Distinct": false,
    "From": null,
    "Where": null,
    "Fields": {
      "text": "",
      "offset": 0,
      "Fields": [
        {
          "text": "1",
          "offset": 0,
          "Offset": 7,
          "WildCard": null,
          "Expr": {
            "text": "",
            "offset": 7,
            "Type": {
              "Tp": 8,
              "Flag": 128,
              "Flen": 1,
              "Decimal": 0,
              "Charset": "binary",
              "Collate": "binary",
              "Elems": null
            },
            "flag": 0,
            "k": 1,
            "decimal": 0,
            "length": 0,
            "i": 1,
            "collation": "",
            "b": null,
            "x": null,
            "projectionOffset": -1
          },
          "AsName": {
            "O": "",
            "L": ""
          },
          "Auxiliary": false
        }
      ]
    },
    "GroupBy": null,
    "Having": null,
    "WindowSpecs": null,
    "OrderBy": null,
    "Limit": null,
    "LockInfo": null,
    "TableHints": null,
    "IsInBraces": false,
    "WithBeforeBraces": false,
    "QueryBlockOffset": 0,
    "SelectIntoOpt": null,
    "AfterSetOperator": null,
    "Kind": 0,
    "Lists": null,
    "With": null
  }
]



================================================
FILE: ast/testdata/TestTokenize.golden
================================================
SELECT * FROM film WHERE length = 86;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 86; 0}]
SELECT * FROM film WHERE length IS NULL;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {1 IS  0} {1 NULL; 0}]
SELECT * FROM film HAVING title = 'abc';
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 HAVING  0} {1 title  0} {7 = 0} {0   0} {2 'abc' 0} {7 ; 0}]
SELECT * FROM sakila.film WHERE length >= 60;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 sakila. 0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 >= 0} {0   0} {10 60; 0}]
SELECT * FROM sakila.film WHERE length >= '60';
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 sakila. 0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 >= 0} {0   0} {2 '60' 0} {7 ; 0}]
SELECT * FROM film WHERE length BETWEEN 60 AND 84;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {1 BETWEEN  0} {10 60  0} {6 AND  0} {10 84; 0}]
SELECT * FROM film WHERE title LIKE 'AIR%';
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {1 title  0} {1 LIKE  0} {2 'AIR%' 0} {7 ; 0}]
SELECT * FROM film WHERE title IS NOT NULL;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {1 title  0} {1 IS  0} {1 NOT  0} {1 NULL; 0}]
SELECT * FROM film WHERE length = 114 and title = 'ALABAMA DEVIL';
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 114  0} {6 AND  0} {1 title  0} {7 = 0} {0   0} {2 'ALABAMA DEVIL' 0} {7 ; 0}]
SELECT * FROM film WHERE length > 100 and title = 'ALABAMA DEVIL';
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 > 0} {0   0} {10 100  0} {6 AND  0} {1 title  0} {7 = 0} {0   0} {2 'ALABAMA DEVIL' 0} {7 ; 0}]
SELECT * FROM film WHERE length > 100 and language_id < 10 and title = 'xyz';
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 > 0} {0   0} {10 100  0} {6 AND  0} {1 language_id  0} {7 < 0} {0   0} {10 10  0} {6 AND  0} {1 title  0} {7 = 0} {0   0} {2 'xyz' 0} {7 ; 0}]
SELECT * FROM film WHERE length > 100 and language_id < 10;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 > 0} {0   0} {10 100  0} {6 AND  0} {1 language_id  0} {7 < 0} {0   0} {10 10; 0}]
SELECT release_year, sum(length) FROM film WHERE length = 123 AND language_id = 1 GROUP BY release_year;
[{5 SELECT  0} {1 release_year, 0} {0   0} {4 SUM( 0} {4 LENGTH) 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 123  0} {6 AND  0} {1 language_id  0} {7 = 0} {0   0} {10 1  0} {5 GROUP BY  0} {1 release_year; 0}]
SELECT release_year, sum(length) FROM film WHERE length >= 123 GROUP BY release_year;
[{5 SELECT  0} {1 release_year, 0} {0   0} {4 SUM( 0} {4 LENGTH) 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 >= 0} {0   0} {10 123  0} {5 GROUP BY  0} {1 release_year; 0}]
SELECT release_year, language_id, sum(length) FROM film GROUP BY release_year, language_id;
[{5 SELECT  0} {1 release_year, 0} {0   0} {1 language_id, 0} {0   0} {4 SUM( 0} {4 LENGTH) 0} {0   0} {5 FROM  0} {1 film  0} {5 GROUP BY  0} {1 release_year, 0} {0   0} {1 language_id; 0}]
SELECT release_year, sum(length) FROM film WHERE length = 123 GROUP BY release_year,(length+language_id);
[{5 SELECT  0} {1 release_year, 0} {0   0} {4 SUM( 0} {4 LENGTH) 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 123  0} {5 GROUP BY  0} {1 release_year, 0} {7 ( 0} {4 LENGTH+ 0} {1 language_id) 0} {7 ; 0}]
SELECT release_year, sum(film_id) FROM film GROUP BY release_year;
[{5 SELECT  0} {1 release_year, 0} {0   0} {4 SUM( 0} {1 film_id) 0} {0   0} {5 FROM  0} {1 film  0} {5 GROUP BY  0} {1 release_year; 0}]
SELECT * FROM address GROUP BY address,district;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 address  0} {5 GROUP BY  0} {1 address, 0} {1 district; 0}]
SELECT title FROM film WHERE ABS(language_id) = 3 GROUP BY title;
[{5 SELECT  0} {1 title  0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 ABS( 0} {1 language_id) 0} {0   0} {7 = 0} {0   0} {10 3  0} {5 GROUP BY  0} {1 title; 0}]
SELECT language_id FROM film WHERE length = 123 GROUP BY release_year ORDER BY language_id;
[{5 SELECT  0} {1 language_id  0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 123  0} {5 GROUP BY  0} {1 release_year  0} {5 ORDER BY  0} {1 language_id; 0}]
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year;
[{5 SELECT  0} {1 release_year  0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 123  0} {5 GROUP BY  0} {1 release_year  0} {5 ORDER BY  0} {1 release_year; 0}]
SELECT * FROM film WHERE length = 123 ORDER BY release_year ASC, language_id DESC;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 123  0} {5 ORDER BY  0} {1 release_year  0} {1 ASC, 0} {0   0} {1 language_id  0} {1 DESC; 0}]
SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year LIMIT 10;
[{5 SELECT  0} {1 release_year  0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 123  0} {5 GROUP BY  0} {1 release_year  0} {5 ORDER BY  0} {1 release_year  0} {5 LIMIT  0} {10 10; 0}]
SELECT * FROM film WHERE length = 123 ORDER BY release_year LIMIT 10;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 123  0} {5 ORDER BY  0} {1 release_year  0} {5 LIMIT  0} {10 10; 0}]
SELECT * FROM film ORDER BY release_year LIMIT 10;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 ORDER BY  0} {1 release_year  0} {5 LIMIT  0} {10 10; 0}]
SELECT film_id FROM film ORDER BY release_year LIMIT 10;
[{5 SELECT  0} {1 film_id  0} {5 FROM  0} {1 film  0} {5 ORDER BY  0} {1 release_year  0} {5 LIMIT  0} {10 10; 0}]
SELECT * FROM film WHERE length > 100 ORDER BY length LIMIT 10;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 > 0} {0   0} {10 100  0} {5 ORDER BY  0} {4 LENGTH  0} {5 LIMIT  0} {10 10; 0}]
SELECT * FROM film WHERE length < 100 ORDER BY length LIMIT 10;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 < 0} {0   0} {10 100  0} {5 ORDER BY  0} {4 LENGTH  0} {5 LIMIT  0} {10 10; 0}]
SELECT * FROM customer WHERE address_id in (224,510) ORDER BY last_name;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 customer  0} {5 WHERE  0} {1 address_id  0} {1 in  0} {7 ( 0} {10 224, 0} {10 510) 0} {0   0} {5 ORDER BY  0} {1 last_name; 0}]
SELECT * FROM film WHERE release_year = 2016 AND length != 1 ORDER BY title;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {1 release_year  0} {7 = 0} {0   0} {10 2016  0} {6 AND  0} {4 LENGTH  0} {7 != 0} {0   0} {10 1  0} {5 ORDER BY  0} {1 title; 0}]
SELECT title FROM film WHERE release_year = 1995;
[{5 SELECT  0} {1 title  0} {5 FROM  0} {1 film  0} {5 WHERE  0} {1 release_year  0} {7 = 0} {0   0} {10 1995; 0}]
SELECT title, replacement_cost FROM film WHERE language_id = 5 AND length = 70;
[{5 SELECT  0} {1 title, 0} {0   0} {1 replacement_cost  0} {5 FROM  0} {1 film  0} {5 WHERE  0} {1 language_id  0} {7 = 0} {0   0} {10 5  0} {6 AND  0} {4 LENGTH  0} {7 = 0} {0   0} {10 70; 0}]
SELECT title FROM film WHERE language_id > 5 AND length > 70;
[{5 SELECT  0} {1 title  0} {5 FROM  0} {1 film  0} {5 WHERE  0} {1 language_id  0} {7 > 0} {0   0} {10 5  0} {6 AND  0} {4 LENGTH  0} {7 > 0} {0   0} {10 70; 0}]
SELECT * FROM film WHERE length = 100 and title = 'xyz' ORDER BY release_year;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 = 0} {0   0} {10 100  0} {6 AND  0} {1 title  0} {7 = 0} {0   0} {2 'xyz' 0} {0   0} {5 ORDER BY  0} {1 release_year; 0}]
SELECT * FROM film WHERE length > 100 and title = 'xyz' ORDER BY release_year;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 > 0} {0   0} {10 100  0} {6 AND  0} {1 title  0} {7 = 0} {0   0} {2 'xyz' 0} {0   0} {5 ORDER BY  0} {1 release_year; 0}]
SELECT * FROM film WHERE length > 100 ORDER BY release_year;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 > 0} {0   0} {10 100  0} {5 ORDER BY  0} {1 release_year; 0}]
SELECT * FROM city a INNER JOIN country b ON a.country_id=b.country_id;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 a  0} {6 INNER JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id; 0}]
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 a  0} {6 LEFT JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id; 0}]
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 a  0} {6 RIGHT JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id; 0}]
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 a  0} {6 LEFT JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id  0} {5 WHERE  0} {1 b. 0} {1 last_update  0} {1 IS  0} {1 NULL; 0}]
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 a  0} {6 RIGHT JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id  0} {5 WHERE  0} {1 a. 0} {1 last_update  0} {1 IS  0} {1 NULL; 0}]
SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 a  0} {6 LEFT JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id  0} {5 UNION  0} {5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 a  0} {6 RIGHT JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id; 0}]
SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 a  0} {6 RIGHT JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id  0} {5 WHERE  0} {1 a. 0} {1 last_update  0} {1 IS  0} {1 NULL  0} {5 UNION  0} {5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 a  0} {6 LEFT JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id  0} {5 WHERE  0} {1 b. 0} {1 last_update  0} {1 IS  0} {1 NULL; 0}]
SELECT country_id, last_update FROM city NATURAL JOIN country;
[{5 SELECT  0} {1 country_id, 0} {0   0} {1 last_update  0} {5 FROM  0} {1 city  0} {1 NATURAL  0} {6 JOIN  0} {1 country; 0}]
SELECT country_id, last_update FROM city NATURAL LEFT JOIN country;
[{5 SELECT  0} {1 country_id, 0} {0   0} {1 last_update  0} {5 FROM  0} {1 city  0} {1 NATURAL  0} {6 LEFT JOIN  0} {1 country; 0}]
SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country;
[{5 SELECT  0} {1 country_id, 0} {0   0} {1 last_update  0} {5 FROM  0} {1 city  0} {1 NATURAL  0} {6 RIGHT JOIN  0} {1 country; 0}]
SELECT a.country_id, a.last_update FROM city a STRAIGHT_JOIN country b ON a.country_id=b.country_id;
[{5 SELECT  0} {1 a. 0} {1 country_id, 0} {0   0} {1 a. 0} {1 last_update  0} {5 FROM  0} {1 city  0} {1 a  0} {1 STRAIGHT_JOIN  0} {1 country  0} {1 b  0} {1 ON  0} {1 a. 0} {1 country_id= 0} {1 b. 0} {1 country_id; 0}]
SELECT a.address, a.postal_code FROM sakila.address a WHERE a.city_id IN  (SELECT c.city_id FROM sakila.city c);
[{5 SELECT  0} {1 a. 0} {1 address, 0} {0   0} {1 a. 0} {1 postal_code  0} {5 FROM  0} {1 sakila. 0} {1 address  0} {1 a  0} {5 WHERE  0} {1 a. 0} {1 city_id  0} {1 IN  0} {0   0} {7 ( 0} {5 SELECT  0} {1 c. 0} {1 city_id  0} {5 FROM  0} {1 sakila. 0} {1 city  0} {1 c) 0} {7 ; 0}]
SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I.city_id = city.city_id) JOIN country ON (country.country_id = city.country_id) ORDER BY city DESC;
[{5 SELECT  0} {1 city  0} {5 FROM( 0} {0   0} {5 SELECT  0} {1 city_id  0} {5 FROM  0} {1 city  0} {5 WHERE  0} {1 city  0} {7 = 0} {0   0} {2 "A Corua (La Corua)" 0} {0   0} {5 ORDER BY  0} {1 last_update  0} {1 DESC  0} {5 LIMIT  0} {10 50, 0} {0   0} {10 10) 0} {0   0} {1 I  0} {6 JOIN  0} {1 city  0} {1 ON  0} {7 ( 0} {1 I. 0} {1 city_id  0} {7 = 0} {0   0} {1 city. 0} {1 city_id) 0} {0   0} {6 JOIN  0} {1 country  0} {1 ON  0} {7 ( 0} {1 country. 0} {1 country_id  0} {7 = 0} {0   0} {1 city. 0} {1 country_id) 0} {0   0} {5 ORDER BY  0} {1 city  0} {1 DESC; 0}]
DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1;
[{1 DELETE  0} {1 city, 0} {0   0} {1 country  0} {5 FROM  0} {1 city  0} {6 INNER JOIN  0} {1 country  0} {1 using  0} {7 ( 0} {1 country_id) 0} {0   0} {5 WHERE  0} {1 city. 0} {1 city_id  0} {7 = 0} {0   0} {10 1; 0}]
DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL;
[{1 DELETE  0} {1 city  0} {5 FROM  0} {1 city  0} {6 LEFT JOIN  0} {1 country  0} {1 ON  0} {1 city. 0} {1 country_id  0} {7 = 0} {0   0} {1 country. 0} {1 country_id  0} {5 WHERE  0} {1 country. 0} {1 country  0} {1 IS  0} {1 NULL; 0}]
DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
[{1 DELETE  0} {1 a1, 0} {0   0} {1 a2  0} {5 FROM  0} {1 city  0} {1 AS  0} {1 a1  0} {6 INNER JOIN  0} {1 country  0} {1 AS  0} {1 a2  0} {5 WHERE  0} {1 a1. 0} {1 country_id= 0} {1 a2. 0} {1 country_id; 0}]
DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;
[{5 DELETE FROM  0} {1 a1, 0} {0   0} {1 a2  0} {1 USING  0} {1 city  0} {1 AS  0} {1 a1  0} {6 INNER JOIN  0} {1 country  0} {1 AS  0} {1 a2  0} {5 WHERE  0} {1 a1. 0} {1 country_id= 0} {1 a2. 0} {1 country_id; 0}]
DELETE FROM film WHERE length > 100;
[{5 DELETE FROM  0} {1 film  0} {5 WHERE  0} {4 LENGTH  0} {7 > 0} {0   0} {10 100; 0}]
UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;
[{5 UPDATE  0} {1 city  0} {6 INNER JOIN  0} {1 country  0} {1 USING( 0} {1 country_id) 0} {0   0} {5 SET  0} {1 city. 0} {1 city  0} {7 = 0} {0   0} {2 'Abha' 0} {7 , 0} {0   0} {1 city. 0} {1 last_update  0} {7 = 0} {0   0} {2 '2006-02-15 04:45:25' 0} {7 , 0} {0   0} {1 country. 0} {1 country  0} {7 = 0} {0   0} {2 'Afghanistan' 0} {0   0} {5 WHERE  0} {1 city. 0} {1 city_id= 0} {10 10; 0}]
UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;
[{5 UPDATE  0} {1 city  0} {6 INNER JOIN  0} {1 country  0} {1 ON  0} {1 city. 0} {1 country_id  0} {7 = 0} {0   0} {1 country. 0} {1 country_id  0} {6 INNER JOIN  0} {1 address  0} {1 ON  0} {1 city. 0} {1 city_id  0} {7 = 0} {0   0} {1 address. 0} {1 city_id  0} {5 SET  0} {1 city. 0} {1 city  0} {7 = 0} {0   0} {2 'Abha' 0} {7 , 0} {0   0} {1 city. 0} {1 last_update  0} {7 = 0} {0   0} {2 '2006-02-15 04:45:25' 0} {7 , 0} {0   0} {1 country. 0} {1 country  0} {7 = 0} {0   0} {2 'Afghanistan' 0} {0   0} {5 WHERE  0} {1 city. 0} {1 city_id= 0} {10 10; 0}]
UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10;
[{5 UPDATE  0} {1 city, 0} {0   0} {1 country  0} {5 SET  0} {1 city. 0} {1 city  0} {7 = 0} {0   0} {2 'Abha' 0} {7 , 0} {0   0} {1 city. 0} {1 last_update  0} {7 = 0} {0   0} {2 '2006-02-15 04:45:25' 0} {7 , 0} {0   0} {1 country. 0} {1 country  0} {7 = 0} {0   0} {2 'Afghanistan' 0} {0   0} {5 WHERE  0} {1 city. 0} {1 country_id  0} {7 = 0} {0   0} {1 country. 0} {1 country_id  0} {6 AND  0} {1 city. 0} {1 city_id= 0} {10 10; 0}]
UPDATE film SET length = 10 WHERE language_id = 20;
[{5 UPDATE  0} {1 film  0} {5 SET  0} {4 LENGTH  0} {7 = 0} {0   0} {10 10  0} {5 WHERE  0} {1 language_id  0} {7 = 0} {0   0} {10 20; 0}]
INSERT INTO city (country_id) SELECT country_id FROM country;
[{4 INSERT  0} {1 INTO  0} {1 city  0} {7 ( 0} {1 country_id) 0} {0   0} {5 SELECT  0} {1 country_id  0} {5 FROM  0} {1 country; 0}]
INSERT INTO city (country_id) VALUES (1),(2),(3);
[{4 INSERT  0} {1 INTO  0} {1 city  0} {7 ( 0} {1 country_id) 0} {0   0} {5 VALUES  0} {7 ( 0} {10 1) 0} {7 , 0} {7 ( 0} {10 2) 0} {7 , 0} {7 ( 0} {10 3) 0} {7 ; 0}]
INSERT INTO city (country_id) VALUES (10);
[{4 INSERT  0} {1 INTO  0} {1 city  0} {7 ( 0} {1 country_id) 0} {0   0} {5 VALUES  0} {7 ( 0} {10 10) 0} {7 ; 0}]
INSERT INTO city (country_id) SELECT 10 FROM DUAL;
[{4 INSERT  0} {1 INTO  0} {1 city  0} {7 ( 0} {1 country_id) 0} {0   0} {5 SELECT  0} {10 10  0} {5 FROM  0} {1 DUAL; 0}]
REPLACE INTO city (country_id) SELECT country_id FROM country;
[{4 REPLACE  0} {1 INTO  0} {1 city  0} {7 ( 0} {1 country_id) 0} {0   0} {5 SELECT  0} {1 country_id  0} {5 FROM  0} {1 country; 0}]
REPLACE INTO city (country_id) VALUES (1),(2),(3);
[{4 REPLACE  0} {1 INTO  0} {1 city  0} {7 ( 0} {1 country_id) 0} {0   0} {5 VALUES  0} {7 ( 0} {10 1) 0} {7 , 0} {7 ( 0} {10 2) 0} {7 , 0} {7 ( 0} {10 3) 0} {7 ; 0}]
REPLACE INTO city (country_id) VALUES (10);
[{4 REPLACE  0} {1 INTO  0} {1 city  0} {7 ( 0} {1 country_id) 0} {0   0} {5 VALUES  0} {7 ( 0} {10 10) 0} {7 ; 0}]
REPLACE INTO city (country_id) SELECT 10 FROM DUAL;
[{4 REPLACE  0} {1 INTO  0} {1 city  0} {7 ( 0} {1 country_id) 0} {0   0} {5 SELECT  0} {10 10  0} {5 FROM  0} {1 DUAL; 0}]
SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM  film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film;
[{5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {7 ( 0} {0   0} {5 SELECT  0} {1 film_id  0} {5 FROM  0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film  0} {7 ) 0} {0   0} {1 film; 0}]
SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1);
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {1 language_id  0} {7 = 0} {0   0} {7 ( 0} {5 SELECT  0} {1 language_id  0} {5 FROM  0} {1 language  0} {5 LIMIT  0} {10 1) 0} {7 ; 0}]
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 i  0} {6 LEFT JOIN  0} {1 country  0} {1 o  0} {1 ON  0} {1 i. 0} {1 city_id= 0} {1 o. 0} {1 country_id  0} {5 UNION  0} {5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 i  0} {6 RIGHT JOIN  0} {1 country  0} {1 o  0} {1 ON  0} {1 i. 0} {1 city_id= 0} {1 o. 0} {1 country_id; 0}]
SELECT * FROM (SELECT * FROM actor WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE') t WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE' GROUP BY first_name;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {7 ( 0} {5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 actor  0} {5 WHERE  0} {1 last_update= 0} {2 '2006-02-15 04:34:33' 0} {0   0} {6 AND  0} {1 last_name= 0} {2 'CHASE' 0} {7 ) 0} {0   0} {1 t  0} {5 WHERE  0} {1 last_update= 0} {2 '2006-02-15 04:34:33' 0} {0   0} {6 AND  0} {1 last_name= 0} {2 'CHASE' 0} {0   0} {5 GROUP BY  0} {1 first_name; 0}]
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 i  0} {6 LEFT JOIN  0} {1 country  0} {1 o  0} {1 ON  0} {1 i. 0} {1 city_id= 0} {1 o. 0} {1 country_id  0} {5 UNION  0} {5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 i  0} {6 RIGHT JOIN  0} {1 country  0} {1 o  0} {1 ON  0} {1 i. 0} {1 city_id= 0} {1 o. 0} {1 country_id; 0}]
SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id WHERE o.country_id is null union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id WHERE i.city_id is null;
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 i  0} {6 LEFT JOIN  0} {1 country  0} {1 o  0} {1 ON  0} {1 i. 0} {1 city_id= 0} {1 o. 0} {1 country_id  0} {5 WHERE  0} {1 o. 0} {1 country_id  0} {1 is  0} {1 null  0} {5 UNION  0} {5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 city  0} {1 i  0} {6 RIGHT JOIN  0} {1 country  0} {1 o  0} {1 ON  0} {1 i. 0} {1 city_id= 0} {1 o. 0} {1 country_id  0} {5 WHERE  0} {1 i. 0} {1 city_id  0} {1 is  0} {1 null; 0}]
SELECT first_name,last_name,email FROM customer STRAIGHT_JOIN address ON customer.address_id=address.address_id;
[{5 SELECT  0} {1 first_name, 0} {1 last_name, 0} {1 email  0} {5 FROM  0} {1 customer  0} {1 STRAIGHT_JOIN  0} {1 address  0} {1 ON  0} {1 customer. 0} {1 address_id= 0} {1 address. 0} {1 address_id; 0}]
SELECT ID,name FROM (SELECT address FROM customer_list WHERE SID=1 order by phone limit 50,10) a JOIN customer_list l ON (a.address=l.address) JOIN city c ON (c.city=l.city) order by phone desc;
[{5 SELECT  0} {1 ID, 0} {1 name  0} {5 FROM  0} {7 ( 0} {5 SELECT  0} {1 address  0} {5 FROM  0} {1 customer_list  0} {5 WHERE  0} {1 SID= 0} {10 1  0} {5 ORDER BY  0} {1 phone  0} {5 LIMIT  0} {10 50, 0} {10 10) 0} {0   0} {1 a  0} {6 JOIN  0} {1 customer_list  0} {1 l  0} {1 ON  0} {7 ( 0} {1 a. 0} {1 address= 0} {1 l. 0} {1 address) 0} {0   0} {6 JOIN  0} {1 city  0} {1 c  0} {1 ON  0} {7 ( 0} {1 c. 0} {1 city= 0} {1 l. 0} {1 city) 0} {0   0} {5 ORDER BY  0} {1 phone  0} {1 desc; 0}]
SELECT * FROM film WHERE date(last_update)='2006-02-15';
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 film  0} {5 WHERE  0} {4 DATE( 0} {1 last_update) 0} {7 = 0} {2 '2006-02-15' 0} {7 ; 0}]
SELECT last_update FROM film GROUP BY date(last_update);
[{5 SELECT  0} {1 last_update  0} {5 FROM  0} {1 film  0} {5 GROUP BY  0} {4 DATE( 0} {1 last_update) 0} {7 ; 0}]
SELECT last_update FROM film order by date(last_update);
[{5 SELECT  0} {1 last_update  0} {5 FROM  0} {1 film  0} {5 ORDER BY  0} {4 DATE( 0} {1 last_update) 0} {7 ; 0}]
SELECT description FROM film WHERE description IN('NEWS','asd') GROUP BY description;
[{5 SELECT  0} {1 description  0} {5 FROM  0} {1 film  0} {5 WHERE  0} {1 description  0} {1 IN( 0} {2 'NEWS' 0} {7 , 0} {2 'asd' 0} {7 ) 0} {0   0} {5 GROUP BY  0} {1 description; 0}]
alter table address add index idx_city_id(city_id);
[{5 ALTER TABLE  0} {1 address  0} {5 ADD  0} {1 index  0} {1 idx_city_id( 0} {1 city_id) 0} {7 ; 0}]
alter table inventory add index `idx_store_film` (`store_id`,`film_id`);
[{5 ALTER TABLE  0} {1 inventory  0} {5 ADD  0} {1 index  0} {3 `idx_store_film` 0} {0   0} {7 ( 0} {3 `store_id` 0} {7 , 0} {3 `film_id` 0} {7 ) 0} {7 ; 0}]
alter table inventory add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`);
[{5 ALTER TABLE  0} {1 inventory  0} {5 ADD  0} {1 index  0} {3 `idx_store_film` 0} {0   0} {7 ( 0} {3 `store_id` 0} {7 , 0} {3 `film_id` 0} {7 ) 0} {7 , 0} {5 ADD  0} {1 index  0} {3 `idx_store_film` 0} {0   0} {7 ( 0} {3 `store_id` 0} {7 , 0} {3 `film_id` 0} {7 ) 0} {7 , 0} {5 ADD  0} {1 index  0} {3 `idx_store_film` 0} {0   0} {7 ( 0} {3 `store_id` 0} {7 , 0} {3 `film_id` 0} {7 ) 0} {7 ; 0}]
SELECT	DATE_FORMAT(t.last_update, '%Y-%m-%d'),	COUNT(DISTINCT (t.city))	FROM city t WHERE t.last_update > '2018-10-22 00:00:00'	AND t.city LIKE '%Chrome%'	AND t.city = 'eip' GROUP BY DATE_FORMAT(t.last_update, '%Y-%m-%d') ORDER BY DATE_FORMAT(t.last_update, '%Y-%m-%d');
[{5 SELECT	 0} {4 DATE_FORMAT( 0} {1 t. 0} {1 last_update, 0} {0   0} {2 '%Y-%m-%d' 0} {7 ) 0} {7 , 0} {0   0} {4 COUNT( 0} {1 DISTINCT  0} {7 ( 0} {1 t. 0} {1 city) 0} {7 ) 0} {0   0} {5 FROM  0} {1 city  0} {1 t  0} {5 WHERE  0} {1 t. 0} {1 last_update  0} {7 > 0} {0   0} {2 '2018-10-22 00:00:00' 0} {0   0} {6 AND  0} {1 t. 0} {1 city  0} {1 LIKE  0} {2 '%Chrome%' 0} {0   0} {6 AND  0} {1 t. 0} {1 city  0} {7 = 0} {0   0} {2 'eip' 0} {0   0} {5 GROUP BY  0} {4 DATE_FORMAT( 0} {1 t. 0} {1 last_update, 0} {0   0} {2 '%Y-%m-%d' 0} {7 ) 0} {0   0} {5 ORDER BY  0} {4 DATE_FORMAT( 0} {1 t. 0} {1 last_update, 0} {0   0} {2 '%Y-%m-%d' 0} {7 ) 0} {7 ; 0}]
create table hello.t (id int unsigned);
[{1 create  0} {1 table  0} {1 hello. 0} {1 t  0} {7 ( 0} {1 id  0} {1 int  0} {1 unsigned) 0} {7 ; 0}]
select * from tb where data >= '';
[{5 SELECT  0} {7 * 0} {0   0} {5 FROM  0} {1 tb  0} {5 WHERE  0} {1 data  0} {7 >= 0} {0   0} {2 '' 0} {7 ; 0}]
alter table tb alter column id drop default;
[{5 ALTER TABLE  0} {1 tb  0} {1 alter  0} {1 column  0} {1 id  0} {5 DROP  0} {4 DEFAULT; 0}]
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film where last_update > '2016-03-27 02:01:01') as d;
[{5 SELECT  0} {1 maxId, 0} {0   0} {1 minId  0} {5 FROM  0} {7 ( 0} {5 SELECT  0} {4 MAX( 0} {1 film_id) 0} {0   0} {1 maxId, 0} {0   0} {4 MIN( 0} {1 film_id) 0} {0   0} {1 minId  0} {5 FROM  0} {1 film  0} {5 WHERE  0} {1 last_update  0} {7 > 0} {0   0} {2 '2016-03-27 02:01:01' 0} {7 ) 0} {0   0} {1 as  0} {1 d; 0}]
select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film) as d;
[{5 SELECT  0} {1 maxId, 0} {0   0} {1 minId  0} {5 FROM  0} {7 ( 0} {5 SELECT  0} {4 MAX( 0} {1 film_id) 0} {0   0} {1 maxId, 0} {0   0} {4 MIN( 0} {1 film_id) 0} {0   0} {1 minId  0} {5 FROM  0} {1 film) 0} {0   0} {1 as  0} {1 d; 0}]


================================================
FILE: ast/testdata/TestTokenizer.golden
================================================
[]ast.Token{
    {Type:57348, Val:"select", i:0},
    {Type:57407, Val:"-- comment 1", i:0},
}
[]ast.Token{
    {Type:57348, Val:"select", i:0},
    {Type:57397, Val:"c1", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"c2", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"c3", i:0},
    {Type:57353, Val:"from", i:0},
    {Type:57397, Val:"t1", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"t2", i:0},
    {Type:57385, Val:"join", i:0},
    {Type:57397, Val:"t3", i:0},
    {Type:57395, Val:"on", i:0},
    {Type:57397, Val:"t1", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"c1", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57397, Val:"t2", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"c1", i:0},
    {Type:57415, Val:"and", i:0},
    {Type:57397, Val:"t1", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"c3", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57397, Val:"t3", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"c1", i:0},
    {Type:57354, Val:"where", i:0},
    {Type:57397, Val:"id", i:0},
    {Type:62, Val:">", i:0},
    {Type:57402, Val:"1000", i:0},
}
[]ast.Token{
    {Type:57348, Val:"select", i:0},
    {Type:57397, Val:"sourcetable", i:0},
    {Type:44, Val:",", i:0},
    {Type:57456, Val:"if", i:0},
    {Type:40, Val:"(", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"lastcontent", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57405, Val:":v1", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"lastupdate", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"lastcontent", i:0},
    {Type:41, Val:")", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"lastactivity", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"totalcount", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"activity", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"type", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"class", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"type", i:0},
    {Type:44, Val:",", i:0},
    {Type:40, Val:"(", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"nodeoptions", i:0},
    {Type:38, Val:"&", i:0},
    {Type:57405, Val:":v2", i:0},
    {Type:41, Val:")", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"nounsubscribe", i:0},
    {Type:57353, Val:"from", i:0},
    {Type:57397, Val:"node", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:57389, Val:"inner", i:0},
    {Type:57385, Val:"join", i:0},
    {Type:57397, Val:"contenttype", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"type", i:0},
    {Type:57395, Val:"on", i:0},
    {Type:57397, Val:"type", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"contenttypeid", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"contenttypeid", i:0},
    {Type:57389, Val:"inner", i:0},
    {Type:57385, Val:"join", i:0},
    {Type:57397, Val:"subscribed", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"sd", i:0},
    {Type:57395, Val:"on", i:0},
    {Type:57397, Val:"sd", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"did", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"nodeid", i:0},
    {Type:57415, Val:"and", i:0},
    {Type:57397, Val:"sd", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"userid", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57405, Val:":v3", i:0},
    {Type:57347, Val:"union", i:0},
    {Type:57362, Val:"all", i:0},
    {Type:57348, Val:"select", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"name", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"title", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"userid", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"keyval", i:0},
    {Type:44, Val:",", i:0},
    {Type:57405, Val:":v4", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"sourcetable", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"ifnull", i:0},
    {Type:40, Val:"(", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"lastpost", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"joindate", i:0},
    {Type:41, Val:")", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"lastactivity", i:0},
    {Type:44, Val:",", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"posts", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"activity", i:0},
    {Type:44, Val:",", i:0},
    {Type:57405, Val:":v5", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"type", i:0},
    {Type:44, Val:",", i:0},
    {Type:57405, Val:":v6", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"nounsubscribe", i:0},
    {Type:57353, Val:"from", i:0},
    {Type:57397, Val:"user", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:57389, Val:"inner", i:0},
    {Type:57385, Val:"join", i:0},
    {Type:57397, Val:"userlist", i:0},
    {Type:57364, Val:"as", i:0},
    {Type:57397, Val:"ul", i:0},
    {Type:57395, Val:"on", i:0},
    {Type:57397, Val:"ul", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"relationid", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57397, Val:"f", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"userid", i:0},
    {Type:57415, Val:"and", i:0},
    {Type:57397, Val:"ul", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"userid", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57405, Val:":v7", i:0},
    {Type:57354, Val:"where", i:0},
    {Type:57397, Val:"ul", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"type", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57405, Val:":v8", i:0},
    {Type:57415, Val:"and", i:0},
    {Type:57397, Val:"ul", i:0},
    {Type:46, Val:".", i:0},
    {Type:57397, Val:"aq", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57405, Val:":v9", i:0},
    {Type:57357, Val:"order", i:0},
    {Type:57358, Val:"by", i:0},
    {Type:57397, Val:"title", i:0},
    {Type:57359, Val:"limit", i:0},
    {Type:57405, Val:":v10", i:0},
}
[]ast.Token{
    {Type:57348, Val:"select", i:0},
    {Type:57397, Val:"c1", i:0},
    {Type:57353, Val:"from", i:0},
    {Type:57397, Val:"t1", i:0},
    {Type:57354, Val:"where", i:0},
    {Type:57397, Val:"id", i:0},
    {Type:57424, Val:">=", i:0},
    {Type:57402, Val:"1000", i:0},
}
[]ast.Token{
    {Type:57348, Val:"select", i:0},
    {Type:57593, Val:"SQL_CALC_FOUND_ROWS", i:0},
    {Type:57397, Val:"col", i:0},
    {Type:57353, Val:"from", i:0},
    {Type:57397, Val:"tbl", i:0},
    {Type:57354, Val:"where", i:0},
    {Type:57397, Val:"id", i:0},
    {Type:62, Val:">", i:0},
    {Type:57402, Val:"1000", i:0},
}
[]ast.Token{
    {Type:57348, Val:"SELECT", i:0},
    {Type:42, Val:"*", i:0},
    {Type:57353, Val:"FROM", i:0},
    {Type:57397, Val:"tb", i:0},
    {Type:57354, Val:"WHERE", i:0},
    {Type:57397, Val:"id", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57405, Val:":v1", i:0},
    {Type:59, Val:";", i:0},
}
[]ast.Token{
    {Type:57348, Val:"SELECT", i:0},
    {Type:42, Val:"*", i:0},
    {Type:57353, Val:"FROM", i:0},
    {Type:57397, Val:"tb", i:0},
    {Type:57354, Val:"WHERE", i:0},
    {Type:57397, Val:"id", i:0},
    {Type:57427, Val:"is", i:0},
    {Type:57410, Val:"null", i:0},
    {Type:59, Val:";", i:0},
}
[]ast.Token{
    {Type:57348, Val:"SELECT", i:0},
    {Type:42, Val:"*", i:0},
    {Type:57353, Val:"FROM", i:0},
    {Type:57397, Val:"tb", i:0},
    {Type:57354, Val:"WHERE", i:0},
    {Type:57397, Val:"id", i:0},
    {Type:57427, Val:"is", i:0},
    {Type:57416, Val:"not", i:0},
    {Type:57410, Val:"null", i:0},
    {Type:59, Val:";", i:0},
}
[]ast.Token{
    {Type:57348, Val:"SELECT", i:0},
    {Type:42, Val:"*", i:0},
    {Type:57353, Val:"FROM", i:0},
    {Type:57397, Val:"tb", i:0},
    {Type:57354, Val:"WHERE", i:0},
    {Type:57397, Val:"id", i:0},
    {Type:57417, Val:"between", i:0},
    {Type:57402, Val:"1", i:0},
    {Type:57415, Val:"and", i:0},
    {Type:57402, Val:"3", i:0},
    {Type:59, Val:";", i:0},
}
[]ast.Token{
    {Type:57444, Val:"alter", i:0},
    {Type:57451, Val:"table", i:0},
    {Type:57397, Val:"inventory", i:0},
    {Type:57448, Val:"add", i:0},
    {Type:57452, Val:"index", i:0},
    {Type:57397, Val:"idx_store_film", i:0},
    {Type:57397, Val:" (", i:0},
    {Type:57397, Val:"store_id", i:0},
    {Type:57397, Val:",", i:0},
    {Type:57397, Val:"film_id", i:0},
    {Type:57346, Val:");", i:0},
}
[]ast.Token{
    {Type:57351, Val:"UPDATE", i:0},
    {Type:57397, Val:"xxx", i:0},
    {Type:57372, Val:"SET", i:0},
    {Type:57397, Val:"c1", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57401, Val:" LOGGER.error(\"\"); }", i:0},
    {Type:57354, Val:"WHERE", i:0},
    {Type:57397, Val:"id", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57402, Val:"2", i:0},
    {Type:59, Val:";", i:0},
}
[]ast.Token{
    {Type:57351, Val:"update", i:0},
    {Type:57346, Val:"\xc2", i:0},
    {Type:57346, Val:"\xa0", i:0},
    {Type:57397, Val:"tb", i:0},
    {Type:57372, Val:"set", i:0},
    {Type:57346, Val:"\xc2", i:0},
    {Type:57346, Val:"\xa0", i:0},
    {Type:57488, Val:"status", i:0},
    {Type:57346, Val:"\xc2", i:0},
    {Type:57346, Val:"\xa0", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57346, Val:"\xc2", i:0},
    {Type:57346, Val:"\xa0", i:0},
    {Type:57402, Val:"1", i:0},
    {Type:57354, Val:"where", i:0},
    {Type:57346, Val:"\xc2", i:0},
    {Type:57346, Val:"\xa0", i:0},
    {Type:57397, Val:"id", i:0},
    {Type:57346, Val:"\xc2", i:0},
    {Type:57346, Val:"\xa0", i:0},
    {Type:61, Val:"=", i:0},
    {Type:57346, Val:"\xc2", i:0},
    {Type:57346, Val:"\xa0", i:0},
    {Type:57402, Val:"1", i:0},
    {Type:59, Val:";", i:0},
}


================================================
FILE: ast/testdata/TestVitessStmtNode2JSON.golden
================================================
{
  "Cache": "",
  "Comments": null,
  "Distinct": "",
  "Hints": "",
  "SelectExprs": [
    {
      "Expr": {
        "Type": 1,
        "Val": "MQ=="
      },
      "As": ""
    }
  ],
  "From": [
    {
      "Expr": {
        "Name": "dual",
        "Qualifier": ""
      },
      "Partitions": null,
      "As": "",
      "Hints": null
    }
  ],
  "Where": null,
  "GroupBy": null,
  "Having": null,
  "OrderBy": null,
  "Limit": null,
  "Lock": ""
}



================================================
FILE: ast/tidb.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ast

import (
	"fmt"
	"regexp"
	"strings"

	"github.com/XiaoMi/soar/common"

	json "github.com/CorgiMan/json2"
	"github.com/kr/pretty"
	"github.com/pingcap/parser"
	"github.com/pingcap/parser/ast"
	"github.com/tidwall/gjson"

	// for pingcap parser
	_ "github.com/pingcap/tidb/types/parser_driver"
)

// TiParse TiDB 语法解析
func TiParse(sql, charset, collation string) ([]ast.StmtNode, error) {
	p := parser.New()
	sql = removeIncompatibleWords(sql)
	stmt, warn, err := p.Parse(sql, charset, collation)
	if err != nil {
		// issue: https://github.com/XiaoMi/soar/issues/235
		// TODO: bypass charset error, pingcap/parser not support so much charsets
		if strings.Contains(err.Error(), "Unknown character set") {
			err = nil
		}
	}

	// TODO: bypass warning info
	for _, w := range warn {
		common.Log.Warn(w.Error())
	}
	return stmt, err
}

// removeIncompatibleWords remove pingcap/parser not support words from schema
func removeIncompatibleWords(sql string) string {
	fields := strings.Fields(strings.TrimSpace(sql))
	if len(fields) == 0 {
		return sql
	}
	switch strings.ToLower(fields[0]) {
	case "create", "alter":
	default:
		return sql
	}
	// CONSTRAINT col_fk FOREIGN KEY (col) REFERENCES tb (id) ON UPDATE CASCADE
	re := regexp.MustCompile(`(?i) ON UPDATE CASCADE`)
	sql = re.ReplaceAllString(sql, "")

	// FULLTEXT KEY col_fk (col) /*!50100 WITH PARSER `ngram` */
	// /*!50100 PARTITION BY LIST (col)
	re = regexp.MustCompile(`/\*!5`)
	sql = re.ReplaceAllString(sql, "/* 5")

	// col varchar(10) CHARACTER SET gbk DEFAULT NULL
	re = regexp.MustCompile(`(?i)CHARACTER SET [a-z_0-9]* `)
	sql = re.ReplaceAllString(sql, "")

	// CREATE TEMPORARY TABLE IF NOT EXISTS t_film AS (SELECT * FROM film);
	re = regexp.MustCompile(`(?i)CREATE TEMPORARY TABLE`)
	sql = re.ReplaceAllString(sql, "CREATE TABLE")

	return sql
}

// PrintPrettyStmtNode 打印TiParse语法树
func PrintPrettyStmtNode(sql, charset, collation string) {
	tree, err := TiParse(sql, charset, collation)
	if err != nil {
		common.Log.Warning(err.Error())
	} else {
		_, err = pretty.Println(tree)
		common.LogIfWarn(err, "")
	}
}

// StmtNode2JSON TiParse AST tree into json format
func StmtNode2JSON(sql, charset, collation string) string {
	var str string
	tree, err := TiParse(sql, charset, collation)
	if err != nil {
		common.Log.Warning(err.Error())
	} else {
		b, err := json.MarshalIndent(tree, "", "  ")
		if err != nil {
			common.Log.Error(err.Error())
		} else {
			str = string(b)
		}
	}
	return str
}

// SchemaMetaInfo get used database, table name from SQL
func SchemaMetaInfo(sql string, defaultDatabase string) []string {
	var tables []string
	tree, err := TiParse(sql, "", "")
	if err != nil {
		return tables
	}

	jsonString := StmtNode2JSON(sql, "", "")

	for _, node := range tree {
		switch n := node.(type) {
		case *ast.UseStmt:
			tables = append(tables, fmt.Sprintf("`%s`.`dual`", n.DBName))
		// SetOprStmt represents "union/except/intersect statement"
		case *ast.InsertStmt, *ast.SelectStmt, *ast.SetOprStmt, *ast.UpdateStmt, *ast.DeleteStmt:
			// DML/DQL: INSERT, SELECT, UPDATE, DELETE
			for _, tableRef := range common.JSONFind(jsonString, "TableRefs") {
				for _, source := range common.JSONFind(tableRef, "Source") {
					database := gjson.Get(source, "Schema.O")
					table := gjson.Get(source, "Name.O")
					if database.String() == "" {
						if table.String() != "" {
							tables = append(tables, fmt.Sprintf("`%s`.`%s`", defaultDatabase, table.String()))
						}
					} else {
						if table.String() != "" {
							tables = append(tables, fmt.Sprintf("`%s`.`%s`", database.String(), table.String()))
						} else {
							tables = append(tables, fmt.Sprintf("`%s`.`dual`", database.String()))
						}
					}
				}
			}
		case *ast.DropTableStmt:
			// DDL: DROP TABLE|VIEW
			schemas := common.JSONFind(jsonString, "Tables")
			for _, tabs := range schemas {
				for _, table := range gjson.Parse(tabs).Array() {
					db := gjson.Get(table.String(), "Schema.O")
					tb := gjson.Get(table.String(), "Name.O")
					if db.String() == "" {
						if tb.String() != "" {
							tables = append(tables, fmt.Sprintf("`%s`.`%s`", defaultDatabase, tb.String()))
						}
					} else {
						if tb.String() != "" {
							tables = append(tables, fmt.Sprintf("`%s`.`%s`", db.String(), tb.String()))
						}
					}
				}
			}
		case *ast.DropDatabaseStmt, *ast.CreateDatabaseStmt:
			// DDL: DROP|CREATE DATABASE
			schemas := common.JSONFind(jsonString, "Name")
			for _, schema := range schemas {
				tables = append(tables, fmt.Sprintf("`%s`.`dual`", schema))
			}
		default:
			// DDL: CREATE TABLE|DATABASE|INDEX|VIEW, DROP INDEX
			schemas := common.JSONFind(jsonString, "Table")
			for _, table := range schemas {
				db := gjson.Get(table, "Schema.O")
				tb := gjson.Get(table, "Name.O")
				if db.String() == "" {
					if tb.String() != "" {
						tables = append(tables, fmt.Sprintf("`%s`.`%s`", defaultDatabase, tb.String()))
					}
				} else {
					if tb.String() != "" {
						tables = append(tables, fmt.Sprintf("`%s`.`%s`", db.String(), tb.String()))
					}
				}
			}
		}
	}
	return common.RemoveDuplicatesItem(tables)
}


================================================
FILE: ast/tidb_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ast

import (
	"fmt"
	"testing"

	"github.com/XiaoMi/soar/common"
)

func TestPrintPrettyStmtNode(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	sqls := []string{
		`select 1`,
		`select * f`, // syntax error case
	}
	err := common.GoldenDiff(func() {
		for _, sql := range sqls {
			PrintPrettyStmtNode(sql, "", "")
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestStmtNode2JSON(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	sqls := []string{
		`select 1`,
		`select * f`, // syntax error case
	}
	err := common.GoldenDiff(func() {
		for _, sql := range sqls {
			fmt.Println(StmtNode2JSON(sql, "", ""))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestSchemaMetaInfo(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	sqls := []string{
		"use world_x;",
		"select 1;",
		"syntax error case",
		"select * from ta join tb using (id)",
		"select * from ta, tb limit 1",
		"drop table tb",
		"drop table db.tb",
		"drop database db",
		"create database db",
		"create index idx_col on tbl (col)",
		"DROP INDEX idx_col on tbl",
	}
	// fmt.Println(sqls[len(sqls)-1])
	// fmt.Println(SchemaMetaInfo(sqls[len(sqls)-1], "sakila"))
	// return
	err := common.GoldenDiff(func() {
		for _, sql := range append(sqls, common.TestSQLs...) {
			fmt.Println(sql)
			fmt.Println(SchemaMetaInfo(sql, "sakila"))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestRemoveIncompatibleWords(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	sqls := [][]string{
		{
			`CREATE TEMPORARY TABLE IF NOT EXISTS t_film AS (SELECT * FROM film)`,
			`CREATE CONSTRAINT col_fk FOREIGN KEY (col) REFERENCES tb (id) ON UPDATE CASCADE`,
			"CREATE FULLTEXT KEY col_fk (col) /*!50100 WITH PARSER `ngram` */",
			`CREATE /*!50100 PARTITION BY LIST (col)`,
			`CREATE col varchar(10) CHARACTER SET gbk DEFAULT NULL`,
		},
		{
			`CREATE TABLE IF NOT EXISTS t_film AS (SELECT * FROM film)`,
			`CREATE CONSTRAINT col_fk FOREIGN KEY (col) REFERENCES tb (id)`,
			"CREATE FULLTEXT KEY col_fk (col) /* 50100 WITH PARSER `ngram` */",
			`CREATE /* 50100 PARTITION BY LIST (col)`,
			`CREATE col varchar(10) DEFAULT NULL`,
		},
	}
	for k, sql := range sqls[0] {
		sql = removeIncompatibleWords(sql)
		if sqls[1][k] != sql {
			fmt.Println(sql)
			t.Fatal(sql)
		}
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}


================================================
FILE: ast/token.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ast

import (
	"fmt"
	"regexp"
	"strings"
	"unicode"

	"vitess.io/vitess/go/vt/sqlparser"
)

// TokenType
const (
	TokenTypeWhitespace       = 0
	TokenTypeWord             = 1
	TokenTypeQuote            = 2
	TokenTypeBacktickQuote    = 3
	TokenTypeReserved         = 4
	TokenTypeReservedToplevel = 5
	TokenTypeReservedNewline  = 6
	TokenTypeBoundary         = 7
	TokenTypeComment          = 8
	TokenTypeBlockComment     = 9
	TokenTypeNumber           = 10
	TokenTypeError            = 11
	TokenTypeVariable         = 12
)

var maxCachekeySize = 15
var cacheHits int
var cacheMisses int

var tokenBoundaries = []string{
	// multi character
	"(>=)", "(<=)", "(!=)", "(<>)",
	// single characters
	",", ";", ":", "\\)", "\\(", "\\.", "=", "<", ">", "\\+", "-", "\\*", "/", "!", "\\^", "%", "\\|", "&", "#",
}

var tokenReserved = []string{
	"ACCESSIBLE", "ACTION", "AGAINST", "AGGREGATE", "ALGORITHM", "ALL", "ALTER", "ANALYSE", "ANALYZE", "AS", "ASC",
	"AUTOCOMMIT", "AUTO_INCREMENT", "BACKUP", "BEGIN", "BETWEEN", "BINLOG", "BOTH", "CASCADE", "CASE", "CHANGE", "CHANGED", "CHARACTER SET",
	"CHARSET", "CHECK", "CHECKSUM", "COLLATE", "COLLATION", "COLUMN", "COLUMNS", "COMMENT", "COMMIT", "COMMITTED", "COMPRESSED", "CONCURRENT",
	"CONSTRAINT", "CONTAINS", "CONVERT", "CREATE", "CROSS", "CURRENT_TIMESTAMP", "DATABASE", "DATABASES", "DAY", "DAY_HOUR", "DAY_MINUTE",
	"DAY_SECOND", "DEFAULT", "DEFINER", "DELAYED", "DELETE", "DESC", "DESCRIBE", "DETERMINISTIC", "DISTINCT", "DISTINCTROW", "DIV",
	"DO", "DUMPFILE", "DUPLICATE", "DYNAMIC", "ELSE", "ENCLOSED", "END", "ENGINE", "ENGINE_TYPE", "ENGINES", "ESCAPE", "ESCAPED", "EVENTS", "EXEC",
	"EXECUTE", "EXISTS", "EXPLAIN", "EXTENDED", "FAST", "FIELDS", "FILE", "FIRST", "FIXED", "FLUSH", "FOR", "FORCE", "FOREIGN", "FULL", "FULLTEXT",
	"FUNCTION", "GLOBAL", "GRANT", "GRANTS", "GROUP_CONCAT", "HEAP", "HIGH_PRIORITY", "HOSTS", "HOUR", "HOUR_MINUTE",
	"HOUR_SECOND", "IDENTIFIED", "IF", "IFNULL", "IGNORE", "IN", "INDEX", "INDEXES", "INFILE", "INSERT", "INSERT_ID", "INSERT_METHOD", "INTERVAL",
	"INTO", "INVOKER", "IS", "ISOLATION", "KEY", "KEYS", "KILL", "LAST_INSERT_ID", "LEADING", "LEVEL", "LIKE", "LINEAR",
	"LINES", "LOAD", "LOCAL", "LOCK", "LOCKS", "LOGS", "LOW_PRIORITY", "MARIA", "MASTER", "MASTER_CONNECT_RETRY", "MASTER_HOST", "MASTER_LOG_FILE",
	"MATCH", "MAX_CONNECTIONS_PER_HOUR", "MAX_QUERIES_PER_HOUR", "MAX_ROWS", "MAX_UPDATES_PER_HOUR", "MAX_USER_CONNECTIONS",
	"MEDIUM", "MERGE", "MINUTE", "MINUTE_SECOND", "MIN_ROWS", "MODE", "MODIFY",
	"MONTH", "MRG_MYISAM", "MYISAM", "NAMES", "NATURAL", "NOT", "NOW()", "NULL", "OFFSET", "ON", "OPEN", "OPTIMIZE", "OPTION", "OPTIONALLY",
	"ON UPDATE", "ON DELETE", "OUTFILE", "PACK_KEYS", "PAGE", "PARTIAL", "PARTITION", "PARTITIONS", "PASSWORD", "PRIMARY", "PRIVILEGES", "PROCEDURE",
	"PROCESS", "PROCESSLIST", "PURGE", "QUICK", "RANGE", "RAID0", "RAID_CHUNKS", "RAID_CHUNKSIZE", "RAID_TYPE", "READ", "READ_ONLY",
	"READ_WRITE", "REFERENCES", "REGEXP", "RELOAD", "RENAME", "REPAIR", "REPEATABLE", "REPLACE", "REPLICATION", "RESET", "RESTORE", "RESTRICT",
	"RETURN", "RETURNS", "REVOKE", "RLIKE", "ROLLBACK", "ROW", "ROWS", "ROW_FORMAT", "SECOND", "SECURITY", "SEPARATOR",
	"SERIALIZABLE", "SESSION", "SHARE", "SHOW", "SHUTDOWN", "SLAVE", "SONAME", "SOUNDS", "SQL", "SQL_AUTO_IS_NULL", "SQL_BIG_RESULT",
	"SQL_BIG_SELECTS", "SQL_BIG_TABLES", "SQL_BUFFER_RESULT", "SQL_CALC_FOUND_ROWS", "SQL_LOG_BIN", "SQL_LOG_OFF", "SQL_LOG_UPDATE",
	"SQL_LOW_PRIORITY_UPDATES", "SQL_MAX_JOIN_SIZE", "SQL_QUOTE_SHOW_CREATE", "SQL_SAFE_UPDATES", "SQL_SELECT_LIMIT", "SQL_SLAVE_SKIP_COUNTER",
	"SQL_SMALL_RESULT", "SQL_WARNINGS", "SQL_CACHE", "SQL_NO_CACHE", "START", "STARTING", "STATUS", "STOP", "STORAGE",
	"STRAIGHT_JOIN", "STRING", "STRIPED", "SUPER", "TABLE", "TABLES", "TEMPORARY", "TERMINATED", "THEN", "TO", "TRAILING", "TRANSACTIONAL", "TRUE",
	"TRUNCATE", "TYPE", "TYPES", "UNCOMMITTED", "UNIQUE", "UNLOCK", "UNSIGNED", "USAGE", "USE", "USING", "VARIABLES",
	"VIEW", "WHEN", "WITH", "WORK", "WRITE", "YEAR_MONTH",
}

var tokenReservedTopLevel = []string{
	"SELECT", "FROM", "WHERE", "SET", "ORDER BY", "GROUP BY", "LIMIT", "DROP",
	"VALUES", "UPDATE", "HAVING", "ADD", "AFTER", "ALTER TABLE", "DELETE FROM", "UNION ALL", "UNION", "EXCEPT", "INTERSECT",
}

var tokenFunction = []string{
	"ABS", "ACOS", "ADDDATE", "ADDTIME", "AES_DECRYPT", "AES_ENCRYPT", "AREA", "ASBINARY", "ASCII", "ASIN", "ASTEXT", "ATAN", "ATAN2",
	"AVG", "BDMPOLYFROMTEXT", "BDMPOLYFROMWKB", "BDPOLYFROMTEXT", "BDPOLYFROMWKB", "BENCHMARK", "BIN", "BIT_AND", "BIT_COUNT", "BIT_LENGTH",
	"BIT_OR", "BIT_XOR", "BOUNDARY", "BUFFER", "CAST", "CEIL", "CEILING", "CENTROID", "CHAR", "CHARACTER_LENGTH", "CHARSET", "CHAR_LENGTH",
	"COALESCE", "COERCIBILITY", "COLLATION", "COMPRESS", "CONCAT", "CONCAT_WS", "CONNECTION_ID", "CONTAINS", "CONV", "CONVERT", "CONVERT_TZ",
	"CONVEXHULL", "COS", "COT", "COUNT", "CRC32", "CROSSES", "CURDATE", "CURRENT_DATE", "CURRENT_TIME", "CURRENT_TIMESTAMP", "CURRENT_USER",
	"CURTIME", "DATABASE", "DATE", "DATEDIFF", "DATE_ADD", "DATE_DIFF", "DATE_FORMAT", "DATE_SUB", "DAY", "DAYNAME", "DAYOFMONTH", "DAYOFWEEK",
	"DAYOFYEAR", "DECODE", "DEFAULT", "DEGREES", "DES_DECRYPT", "DES_ENCRYPT", "DIFFERENCE", "DIMENSION", "DISJOINT", "DISTANCE", "ELT", "ENCODE",
	"ENCRYPT", "ENDPOINT", "ENVELOPE", "EQUALS", "EXP", "EXPORT_SET", "EXTERIORRING", "EXTRACT", "EXTRACTVALUE", "FIELD", "FIND_IN_SET", "FLOOR",
	"FORMAT", "FOUND_ROWS", "FROM_DAYS", "FROM_UNIXTIME", "GEOMCOLLFROMTEXT", "GEOMCOLLFROMWKB", "GEOMETRYCOLLECTION", "GEOMETRYCOLLECTIONFROMTEXT",
	"GEOMETRYCOLLECTIONFROMWKB", "GEOMETRYFROMTEXT", "GEOMETRYFROMWKB", "GEOMETRYN", "GEOMETRYTYPE", "GEOMFROMTEXT", "GEOMFROMWKB", "GET_FORMAT",
	"GET_LOCK", "GLENGTH", "GREATEST", "GROUP_CONCAT", "GROUP_UNIQUE_USERS", "HEX", "HOUR", "IF", "IFNULL", "INET_ATON", "INET_NTOA", "INSERT", "INSTR",
	"INTERIORRINGN", "INTERSECTION", "INTERSECTS", "INTERVAL", "ISCLOSED", "ISEMPTY", "ISNULL", "ISRING", "ISSIMPLE", "IS_FREE_LOCK", "IS_USED_LOCK",
	"LAST_DAY", "LAST_INSERT_ID", "LCASE", "LEAST", "LEFT", "LENGTH", "LINEFROMTEXT", "LINEFROMWKB", "LINESTRING", "LINESTRINGFROMTEXT", "LINESTRINGFROMWKB",
	"LN", "LOAD_FILE", "LOCALTIME", "LOCALTIMESTAMP", "LOCATE", "LOG", "LOG10", "LOG2", "LOWER", "LPAD", "LTRIM", "MAKEDATE", "MAKETIME", "MAKE_SET",
	"MASTER_POS_WAIT", "MAX", "MBRCONTAINS", "MBRDISJOINT", "MBREQUAL", "MBRINTERSECTS", "MBROVERLAPS", "MBRTOUCHES", "MBRWITHIN", "MD5", "MICROSECOND",
	"MID", "MIN", "MINUTE", "MLINEFROMTEXT", "MLINEFROMWKB", "MOD", "MONTH", "MONTHNAME", "MPOINTFROMTEXT", "MPOINTFROMWKB", "MPOLYFROMTEXT", "MPOLYFROMWKB",
	"MULTILINESTRING", "MULTILINESTRINGFROMTEXT", "MULTILINESTRINGFROMWKB", "MULTIPOINT", "MULTIPOINTFROMTEXT", "MULTIPOINTFROMWKB", "MULTIPOLYGON",
	"MULTIPOLYGONFROMTEXT", "MULTIPOLYGONFROMWKB", "NAME_CONST", "NULLIF", "NUMGEOMETRIES", "NUMINTERIORRINGS", "NUMPOINTS", "OCT", "OCTET_LENGTH",
	"OLD_PASSWORD", "ORD", "OVERLAPS", "PASSWORD", "PERIOD_ADD", "PERIOD_DIFF", "PI", "POINT", "POINTFROMTEXT", "POINTFROMWKB", "POINTN", "POINTONSURFACE",
	"POLYFROMTEXT", "POLYFROMWKB", "POLYGON", "POLYGONFROMTEXT", "POLYGONFROMWKB", "POSITION", "POW", "POWER", "QUARTER", "QUOTE", "RADIANS", "RAND",
	"RELATED", "RELEASE_LOCK", "REPEAT", "REPLACE", "REVERSE", "RIGHT", "ROUND", "ROW_COUNT", "RPAD", "RTRIM", "SCHEMA", "SECOND", "SEC_TO_TIME",
	"SESSION_USER", "SHA", "SHA1", "SIGN", "SIN", "SLEEP", "SOUNDEX", "SPACE", "SQRT", "SRID", "STARTPOINT", "STD", "STDDEV", "STDDEV_POP", "STDDEV_SAMP",
	"STRCMP", "STR_TO_DATE", "SUBDATE", "SUBSTR", "SUBSTRING", "SUBSTRING_INDEX", "SUBTIME", "SUM", "SYMDIFFERENCE", "SYSDATE", "SYSTEM_USER", "TAN",
	"TIME", "TIMEDIFF", "TIMESTAMP", "TIMESTAMPADD", "TIMESTAMPDIFF", "TIME_FORMAT", "TIME_TO_SEC", "TOUCHES", "TO_DAYS", "TRIM", "TRUNCATE", "UCASE",
	"UNCOMPRESS", "UNCOMPRESSED_LENGTH", "UNHEX", "UNIQUE_USERS", "UNIX_TIMESTAMP", "UPDATEXML", "UPPER", "USER", "UTC_DATE", "UTC_TIME", "UTC_TIMESTAMP",
	"UUID", "VARIANCE", "VAR_POP", "VAR_SAMP", "VERSION", "WEEK", "WEEKDAY", "WEEKOFYEAR", "WITHIN", "X", "Y", "YEAR", "YEARWEEK",
}

var tokenReservedNewLine = []string{
	"LEFT OUTER JOIN", "RIGHT OUTER JOIN", "LEFT JOIN", "RIGHT JOIN", "OUTER JOIN", "INNER JOIN", "JOIN", "XOR", "OR", "AND",
}

var regBoundariesString string
var regReservedToplevelString string
var regReservedNewlineString string
var regReservedString string
var regFunctionString string

func init() {
	var regs []string
	regs = append(regs, tokenBoundaries...)
	regBoundariesString = "(" + strings.Join(regs, "|") + ")"

	regs = make([]string, 0)
	for _, reg := range tokenReservedTopLevel {
		regs = append(regs, regexp.QuoteMeta(reg))
	}
	regReservedToplevelString = "(" + strings.Join(regs, "|") + ")"

	regs = make([]string, 0)
	for _, reg := range tokenReservedNewLine {
		regs = append(regs, regexp.QuoteMeta(reg))
	}
	regReservedNewlineString = "(" + strings.Join(regs, "|") + ")"

	regs = make([]string, 0)
	for _, reg := range tokenReserved {
		regs = append(regs, regexp.QuoteMeta(reg))
	}
	regReservedString = "(" + strings.Join(regs, "|") + ")"

	regs = make([]string, 0)
	for _, reg := range tokenFunction {
		regs = append(regs, regexp.QuoteMeta(reg))
	}
	regFunctionString = "(" + strings.Join(regs, "|") + ")"
}

// TokenString sqlparser tokens
var TokenString = map[int]string{
	sqlparser.LEX_ERROR:               "",
	sqlparser.UNION:                   "union",
	sqlparser.SELECT:                  "select",
	sqlparser.STREAM:                  "stream",
	sqlparser.INSERT:                  "insert",
	sqlparser.UPDATE:                  "update",
	sqlparser.DELETE:                  "delete",
	sqlparser.FROM:                    "from",
	sqlparser.WHERE:                   "where",
	sqlparser.GROUP:                   "group",
	sqlparser.HAVING:                  "having",
	sqlparser.ORDER:                   "order",
	sqlparser.BY:                      "by",
	sqlparser.LIMIT:                   "limit",
	sqlparser.OFFSET:                  "offset",
	sqlparser.FOR:                     "for",
	sqlparser.ALL:                     "all",
	sqlparser.DISTINCT:                "distinct",
	sqlparser.AS:                      "as",
	sqlparser.EXISTS:                  "exists",
	sqlparser.ASC:                     "asc",
	sqlparser.DESC:                    "desc",
	sqlparser.INTO:                    "into",
	sqlparser.DUPLICATE:               "duplicate",
	sqlparser.KEY:                     "key",
	sqlparser.DEFAULT:                 "default",
	sqlparser.SET:                     "set",
	sqlparser.LOCK:                    "lock",
	sqlparser.KEYS:                    "keys",
	sqlparser.VALUES:                  "values",
	sqlparser.LAST_INSERT_ID:          "last_insert_id",
	sqlparser.NEXT:                    "next",
	sqlparser.VALUE:                   "value",
	sqlparser.SHARE:                   "share",
	sqlparser.MODE:                    "mode",
	sqlparser.SQL_NO_CACHE:            "sql_no_cache",
	sqlparser.SQL_CACHE:               "sql_cache",
	sqlparser.JOIN:                    "join",
	sqlparser.STRAIGHT_JOIN:           "straight_join",
	sqlparser.LEFT:                    "left",
	sqlparser.RIGHT:                   "right",
	sqlparser.INNER:                   "inner",
	sqlparser.OUTER:                   "outer",
	sqlparser.CROSS:                   "cross",
	sqlparser.NATURAL:                 "natural",
	sqlparser.USE:                     "use",
	sqlparser.FORCE:                   "force",
	sqlparser.ON:                      "on",
	sqlparser.USING:                   "using",
	sqlparser.ID:                      "id",
	sqlparser.HEX:                     "hex",
	sqlparser.STRING:                  "string",
	sqlparser.INTEGRAL:                "integral",
	sqlparser.FLOAT:                   "float",
	sqlparser.HEXNUM:                  "hexnum",
	sqlparser.VALUE_ARG:               "?",
	sqlparser.LIST_ARG:                ":",
	sqlparser.COMMENT:                 "",
	sqlparser.COMMENT_KEYWORD:         "comment",
	sqlparser.BIT_LITERAL:             "bit_literal",
	sqlparser.NULL:                    "null",
	sqlparser.TRUE:                    "true",
	sqlparser.FALSE:                   "false",
	sqlparser.OR:                      "||",
	sqlparser.AND:                     "&&",
	sqlparser.NOT:                     "not",
	sqlparser.BETWEEN:                 "between",
	sqlparser.CASE:                    "case",
	sqlparser.WHEN:                    "when",
	sqlparser.THEN:                    "then",
	sqlparser.ELSE:                    "else",
	sqlparser.END:                     "end",
	sqlparser.LE:                      "<",
	sqlparser.GE:                      ">=",
	sqlparser.NE:                      "<>",
	sqlparser.NULL_SAFE_EQUAL:         "<=>",
	sqlparser.IS:                      "is",
	sqlparser.LIKE:                    "like",
	sqlparser.REGEXP:                  "regexp",
	sqlparser.IN:                      "in",
	sqlparser.SHIFT_LEFT:              "<<",
	sqlparser.SHIFT_RIGHT:             ">>",
	sqlparser.DIV:                     "div",
	sqlparser.MOD:                     "mod",
	sqlparser.UNARY:                   "unary",
	sqlparser.COLLATE:                 "collate",
	sqlparser.BINARY:                  "binary",
	sqlparser.UNDERSCORE_BINARY:       "_binary",
	sqlparser.INTERVAL:                "interval",
	sqlparser.JSON_EXTRACT_OP:         "->>",
	sqlparser.JSON_UNQUOTE_EXTRACT_OP: "->",
	sqlparser.CREATE:                  "create",
	sqlparser.ALTER:                   "alter",
	sqlparser.DROP:                    "drop",
	sqlparser.RENAME:                  "rename",
	sqlparser.ANALYZE:                 "analyze",
	sqlparser.ADD:                     "add",
	sqlparser.SCHEMA:                  "schema",
	sqlparser.TABLE:                   "table",
	sqlparser.INDEX:                   "index",
	sqlparser.VIEW:                    "view",
	sqlparser.TO:                      "to",
	sqlparser.IGNORE:                  "ignore",
	sqlparser.IF:                      "if",
	sqlparser.UNIQUE:                  "unique",
	sqlparser.PRIMARY:                 "primary",
	sqlparser.COLUMN:                  "column",
	sqlparser.CONSTRAINT:              "constraint",
	sqlparser.SPATIAL:                 "spatial",
	sqlparser.FULLTEXT:                "fulltext",
	sqlparser.FOREIGN:                 "foreign",
	sqlparser.SHOW:                    "show",
	sqlparser.DESCRIBE:                "describe",
	sqlparser.EXPLAIN:                 "explain",
	sqlparser.DATE:                    "date",
	sqlparser.ESCAPE:                  "escape",
	sqlparser.REPAIR:                  "repair",
	sqlparser.OPTIMIZE:                "optimize",
	sqlparser.TRUNCATE:                "truncate",
	sqlparser.MAXVALUE:                "maxvalue",
	sqlparser.PARTITION:               "partition",
	sqlparser.REORGANIZE:              "reorganize",
	sqlparser.LESS:                    "less",
	sqlparser.THAN:                    "than",
	sqlparser.PROCEDURE:               "procedure",
	sqlparser.TRIGGER:                 "trigger",
	sqlparser.VINDEX:                  "vindex",
	sqlparser.VINDEXES:                "vindexes",
	sqlparser.STATUS:                  "status",
	sqlparser.VARIABLES:               "variables",
	sqlparser.BEGIN:                   "begin",
	sqlparser.START:                   "start",
	sqlparser.TRANSACTION:             "transaction",
	sqlparser.COMMIT:                  "commit",
	sqlparser.ROLLBACK:                "rollback",
	sqlparser.BIT:                     "bit",
	sqlparser.TINYINT:                 "tinyint",
	sqlparser.SMALLINT:                "smallint",
	sqlparser.MEDIUMINT:               "mediumint",
	sqlparser.INT:                     "int",
	sqlparser.INTEGER:                 "integer",
	sqlparser.BIGINT:                  "bigint",
	sqlparser.INTNUM:                  "intnum",
	sqlparser.REAL:                    "real",
	sqlparser.DOUBLE:                  "double",
	sqlparser.FLOAT_TYPE:              "float_type",
	sqlparser.DECIMAL:                 "decimal",
	sqlparser.NUMERIC:                 "numeric",
	sqlparser.TIME:                    "time",
	sqlparser.TIMESTAMP:               "timestamp",
	sqlparser.DATETIME:                "datetime",
	sqlparser.YEAR:                    "year",
	sqlparser.CHAR:                    "char",
	sqlparser.VARCHAR:                 "varchar",
	sqlparser.BOOL:                    "bool",
	sqlparser.CHARACTER:               "character",
	sqlparser.VARBINARY:               "varbinary",
	sqlparser.NCHAR:                   "nchar",
	sqlparser.TEXT:                    "text",
	sqlparser.TINYTEXT:                "tinytext",
	sqlparser.MEDIUMTEXT:              "mediumtext",
	sqlparser.LONGTEXT:                "longtext",
	sqlparser.BLOB:                    "blob",
	sqlparser.TINYBLOB:                "tinyblob",
	sqlparser.MEDIUMBLOB:              "mediumblob",
	sqlparser.LONGBLOB:                "longblob",
	sqlparser.JSON:                    "json",
	sqlparser.ENUM:                    "enum",
	sqlparser.GEOMETRY:                "geometry",
	sqlparser.POINT:                   "point",
	sqlparser.LINESTRING:              "linestring",
	sqlparser.POLYGON:                 "polygon",
	sqlparser.GEOMETRYCOLLECTION:      "geometrycollection",
	sqlparser.MULTIPOINT:              "multipoint",
	sqlparser.MULTILINESTRING:         "multilinestring",
	sqlparser.MULTIPOLYGON:            "multipolygon",
	sqlparser.NULLX:                   "nullx",
	sqlparser.AUTO_INCREMENT:          "auto_increment",
	sqlparser.APPROXNUM:               "approxnum",
	sqlparser.SIGNED:                  "signed",
	sqlparser.UNSIGNED:                "unsigned",
	sqlparser.ZEROFILL:                "zerofill",
	sqlparser.DATABASES:               "databases",
	sqlparser.TABLES:                  "tables",
	sqlparser.NAMES:                   "names",
	sqlparser.CHARSET:                 "charset",
	sqlparser.GLOBAL:                  "global",
	sqlparser.SESSION:                 "session",
	sqlparser.CURRENT_TIMESTAMP:       "current_timestamp",
	sqlparser.DATABASE:                "database",
	sqlparser.CURRENT_DATE:            "current_date",
	sqlparser.CURRENT_TIME:            "current_time",
	sqlparser.LOCALTIME:               "localtime",
	sqlparser.LOCALTIMESTAMP:          "localtimestamp",
	sqlparser.UTC_DATE:                "utc_date",
	sqlparser.UTC_TIME:                "utc_time",
	sqlparser.UTC_TIMESTAMP:           "utc_timestamp",
	sqlparser.REPLACE:                 "replace",
	sqlparser.CONVERT:                 "convert",
	sqlparser.CAST:                    "cast",
	sqlparser.SUBSTR:                  "substr",
	sqlparser.SUBSTRING:               "substring",
	sqlparser.GROUP_CONCAT:            "group_concat",
	sqlparser.SEPARATOR:               "separator",
	sqlparser.VSCHEMA:                 "vschema",
	sqlparser.SEQUENCE:                "sequence",
	sqlparser.MATCH:                   "match",
	sqlparser.AGAINST:                 "against",
	sqlparser.BOOLEAN:                 "boolean",
	sqlparser.LANGUAGE:                "language",
	sqlparser.WITH:                    "with",
	sqlparser.QUERY:                   "query",
	sqlparser.EXPANSION:               "expansion",
	sqlparser.UNUSED:                  "",
}

// 这个变更从vitess更新过来,如果vitess新开了一个关键字这里也要同步开
var mySQLKeywords = map[string]string{
	"add":                "ADD",
	"against":            "AGAINST",
	"all":                "ALL",
	"alter":              "ALTER",
	"analyze":            "ANALYZE",
	"and":                "AND",
	"as":                 "AS",
	"asc":                "ASC",
	"auto_increment":     "AUTO_INCREMENT",
	"begin":              "BEGIN",
	"between":            "BETWEEN",
	"bigint":             "BIGINT",
	"binary":             "BINARY",
	"_binary":            "UNDERSCORE_BINARY",
	"bit":                "BIT",
	"blob":               "BLOB",
	"bool":               "BOOL",
	"boolean":            "BOOLEAN",
	"by":                 "BY",
	"case":               "CASE",
	"cast":               "CAST",
	"char":               "CHAR",
	"character":          "CHARACTER",
	"charset":            "CHARSET",
	"collate":            "COLLATE",
	"column":             "COLUMN",
	"comment":            "COMMENT_KEYWORD",
	"commit":             "COMMIT",
	"constraint":         "CONSTRAINT",
	"convert":            "CONVERT",
	"substr":             "SUBSTR",
	"substring":          "SUBSTRING",
	"create":             "CREATE",
	"cross":              "CROSS",
	"current_date":       "CURRENT_DATE",
	"current_time":       "CURRENT_TIME",
	"current_timestamp":  "CURRENT_TIMESTAMP",
	"database":           "DATABASE",
	"databases":          "DATABASES",
	"date":               "DATE",
	"datetime":           "DATETIME",
	"decimal":            "DECIMAL",
	"default":            "DEFAULT",
	"delete":             "DELETE",
	"desc":               "DESC",
	"describe":           "DESCRIBE",
	"distinct":           "DISTINCT",
	"div":                "DIV",
	"double":             "DOUBLE",
	"drop":               "DROP",
	"duplicate":          "DUPLICATE",
	"else":               "ELSE",
	"end":                "END",
	"enum":               "ENUM",
	"escape":             "ESCAPE",
	"exists":             "EXISTS",
	"explain":            "EXPLAIN",
	"expansion":          "EXPANSION",
	"false":              "FALSE",
	"float":              "FLOAT_TYPE",
	"for":                "FOR",
	"force":              "FORCE",
	"foreign":            "FOREIGN",
	"from":               "FROM",
	"fulltext":           "FULLTEXT",
	"geometry":           "GEOMETRY",
	"geometrycollection": "GEOMETRYCOLLECTION",
	"global":             "GLOBAL",
	"grant":              "GRANT",
	"group":              "GROUP",
	"group_concat":       "GROUP_CONCAT",
	"having":             "HAVING",
	"if":                 "IF",
	"ignore":             "IGNORE",
	"in":                 "IN",
	"index":              "INDEX",
	"inner":              "INNER",
	"insert":             "INSERT",
	"int":                "INT",
	"integer":            "INTEGER",
	"interval":           "INTERVAL",
	"into":               "INTO",
	"is":                 "IS",
	"join":               "JOIN",
	"json":               "JSON",
	"key":                "KEY",
	"keys":               "KEYS",
	"key_block_size":     "KEY_BLOCK_SIZE",
	"language":           "LANGUAGE",
	"last_insert_id":     "LAST_INSERT_ID",
	"left":               "LEFT",
	"less":               "LESS",
	"like":               "LIKE",
	"limit":              "LIMIT",
	"linestring":         "LINESTRING",
	"localtime":          "LOCALTIME",
	"localtimestamp":     "LOCALTIMESTAMP",
	"lock":               "LOCK",
	"longblob":           "LONGBLOB",
	"longtext":           "LONGTEXT",
	"match":              "MATCH",
	"maxvalue":           "MAXVALUE",
	"mediumblob":         "MEDIUMBLOB",
	"mediumint":          "MEDIUMINT",
	"mediumtext":         "MEDIUMTEXT",
	"mod":                "MOD",
	"mode":               "MODE",
	"multilinestring":    "MULTILINESTRING",
	"multipoint":         "MULTIPOINT",
	"multipolygon":       "MULTIPOLYGON",
	"names":              "NAMES",
	"natural":            "NATURAL",
	"nchar":              "NCHAR",
	"next":               "NEXT",
	"not":                "NOT",
	"null":               "NULL",
	"numeric":            "NUMERIC",
	"offset":             "OFFSET",
	"on":                 "ON",
	"optimize":           "OPTIMIZE",
	"or":                 "OR",
	"order":              "ORDER",
	"outer":              "OUTER",
	"partition":          "PARTITION",
	"point":              "POINT",
	"polygon":            "POLYGON",
	"primary":            "PRIMARY",
	"procedure":          "PROCEDURE",
	"query":              "QUERY",
	"real":               "REAL",
	"regexp":             "REGEXP",
	"rename":             "RENAME",
	"reorganize":         "REORGANIZE",
	"repair":             "REPAIR",
	"replace":            "REPLACE",
	"revoke":             "REVOKE",
	"right":              "RIGHT",
	"rlike":              "REGEXP",
	"rollback":           "ROLLBACK",
	"schema":             "SCHEMA",
	"select":             "SELECT",
	"separator":          "SEPARATOR",
	"session":            "SESSION",
	"set":                "SET",
	"share":              "SHARE",
	"show":               "SHOW",
	"signed":             "SIGNED",
	"smallint":           "SMALLINT",
	"spatial":            "SPATIAL",
	"sql_cache":          "SQL_CACHE",
	"sql_no_cache":       "SQL_NO_CACHE",
	"start":              "START",
	"status":             "STATUS",
	"straight_join":      "STRAIGHT_JOIN",
	"stream":             "STREAM",
	"table":              "TABLE",
	"tables":             "TABLES",
	"text":               "TEXT",
	"than":               "THAN",
	"then":               "THEN",
	"time":               "TIME",
	"timestamp":          "TIMESTAMP",
	"tinyblob":           "TINYBLOB",
	"tinyint":            "TINYINT",
	"tinytext":           "TINYTEXT",
	"to":                 "TO",
	"transaction":        "TRANSACTION",
	"trigger":            "TRIGGER",
	"true":               "TRUE",
	"truncate":           "TRUNCATE",
	"union":              "UNION",
	"unique":             "UNIQUE",
	"unsigned":           "UNSIGNED",
	"update":             "UPDATE",
	"use":                "USE",
	"using":              "USING",
	"utc_date":           "UTC_DATE",
	"utc_time":           "UTC_TIME",
	"utc_timestamp":      "UTC_TIMESTAMP",
	"values":             "VALUES",
	"variables":          "VARIABLES",
	"varbinary":          "VARBINARY",
	"varchar":            "VARCHAR",
	"vindex":             "VINDEX",
	"vindexes":           "VINDEXES",
	"view":               "VIEW",
	"vitess_keyspaces":   "VITESS_KEYSPACES",
	"vitess_shards":      "VITESS_SHARDS",
	"vitess_tablets":     "VITESS_TABLETS",
	"vschema_tables":     "VSCHEMA_TABLES",
	"when":               "WHEN",
	"where":              "WHERE",
	"with":               "WITH",
	"year":               "YEAR",
	"zerofill":           "ZEROFILL",
}

// Token 基本定义
type Token struct {
	Type int
	Val  string
	i    int
}

// Tokenizer 用于初始化 token,区别于 Tokenize 函数,这个函数使用 vitess 的切词方式
func Tokenizer(sql string) []Token {
	var tokens []Token
	tkn := sqlparser.NewStringTokenizer(sql)
	typ, val := tkn.Scan()
	for typ != 0 {
		if val != nil {
			tokens = append(tokens, Token{Type: typ, Val: string(val)})
		} else {
			if typ > 255 {
				if v, ok := TokenString[typ]; ok {
					tokens = append(tokens, Token{
						Type: typ,
						Val:  v,
					})
				} else {
					tokens = append(tokens, Token{
						Type: typ,
						Val:  "",
					})
				}
			} else {
				tokens = append(tokens, Token{
					Type: typ,
					Val:  fmt.Sprintf("%c", typ),
				})
			}
		}
		typ, val = tkn.Scan()
	}
	return tokens
}

// IsMysqlKeyword 判断是否是关键字
func IsMysqlKeyword(name string) bool {
	_, ok := mySQLKeywords[strings.ToLower(strings.TrimSpace(name))]
	return ok
}

// getNextToken 从 buf 中获取 token
func getNextToken(buf string, previous Token) Token {
	var typ int // TOKEN_TYPE

	// Whitespace
	whiteSpaceReg := regexp.MustCompile(`^\s+`)
	if whiteSpaceReg.MatchString(buf) {
		return Token{
			Type: TokenTypeWhitespace,
			Val:  " ",
		}
	}

	// Comment (#, --, /**/)
	if buf[0] == '#' || (len(buf) > 1 && (buf[:2] == "--" || buf[:2] == "/*")) {
		var last int
		if buf[0] == '-' || buf[0] == '#' {
			// Comment until end of line
			last = strings.Index(buf, "\n")
			typ = TokenTypeComment
		} else {
			// Comment until closing comment tag
			last = strings.Index(buf[2:], "*/") + 2
			typ = TokenTypeBlockComment
		}
		if last <= 0 {
			last = len(buf)
		}
		return Token{
			Type: typ,
			Val:  buf[:last],
		}
	}

	// Quoted String
	if buf[0] == '"' || buf[0] == '\'' || buf[0] == '`' || buf[0] == '[' {
		var typ int
		switch buf[0] {
		case '`', '[':
			typ = TokenTypeBacktickQuote
		default:
			typ = TokenTypeQuote
		}
		return Token{
			Type: typ,
			Val:  getQuotedString(buf),
		}
	}

	// User-defined Variable
	if (buf[0] == '@' || buf[0] == ':') && len(buf) > 1 {
		ret := Token{
			Type: TokenTypeVariable,
			Val:  "",
		}

		if buf[1] == '"' || buf[1] == '\'' || buf[1] == '`' {
			// If the variable name is quoted
			ret.Val = string(buf[0]) + getQuotedString(buf[1:])
		} else {
			// Non-quoted variable name
			varReg := regexp.MustCompile(`^(` + string(buf[0]) + `[a-zA-Z0-9\._\$]+)`)
			if varReg.MatchString(buf) {
				ret.Val = varReg.FindString(buf)
			}
		}

		if ret.Val != "" {
			return ret
		}
	}

	// Number(decimal, binary, hex...)
	numReg := regexp.MustCompile(`^([0-9]+(\.[0-9]+)?|0x[0-9a-fA-F]+|0b[01]+)($|\s|"'` + "`|" + regBoundariesString + ")")
	if numReg.MatchString(buf) {
		return Token{
			Type: TokenTypeNumber,
			Val:  numReg.FindString(buf),
		}
	}

	// Boundary Character(punctuation and symbols)
	boundaryReg := regexp.MustCompile(`^(` + regBoundariesString + `)`)
	if boundaryReg.MatchString(buf) {
		return Token{
			Type: TokenTypeBoundary,
			Val:  boundaryReg.FindString(buf),
		}
	}
	sqlUpper := strings.ToUpper(buf)
	// A reserved word cannot be preceded by a '.'
	// this makes it so in "mytable.from", "from" is not considered a reserved word
	if previous.Val != "." {
		// Top Level Reserved Word
		reservedToplevelReg := regexp.MustCompile(`^(` + regReservedToplevelString + `)($|\s|` + regBoundariesString + `)`)
		if reservedToplevelReg.MatchString(sqlUpper) {
			return Token{
				Type: TokenTypeReservedToplevel,
				Val:  reservedToplevelReg.FindString(sqlUpper),
			}
		}

		// Newline Reserved Word
		reservedNewlineReg := regexp.MustCompile(`^(` + regReservedNewlineString + `)($|\s|` + regBoundariesString + `)`)
		if reservedNewlineReg.MatchString(sqlUpper) {
			return Token{
				Type: TokenTypeReservedNewline,
				Val:  reservedNewlineReg.FindString(sqlUpper),
			}
		}

		// Other Reserved Word
		reservedReg := regexp.MustCompile(`^(` + regReservedString + `)($|\s|` + regBoundariesString + `)`)
		if reservedNewlineReg.MatchString(sqlUpper) {
			return Token{
				Type: TokenTypeReserved,
				Val:  reservedReg.FindString(sqlUpper),
			}
		}

	}

	// function
	// A function must be succeeded by '('
	// this makes it so "count(" is considered a function, but "count" alone is not
	functionReg := regexp.MustCompile(`^(` + regFunctionString + `)($|\s|` + regBoundariesString + `)`)
	if functionReg.MatchString(sqlUpper) {
		return Token{
			Type: TokenTypeReserved,
			Val:  functionReg.FindString(sqlUpper),
		}
	}

	// Non reserved word
	noReservedReg := regexp.MustCompile(`(.*?)($|\s|["'` + "`]|" + regBoundariesString + `)`)
	if noReservedReg.MatchString(buf) {
		return Token{
			Type: TokenTypeWord,
			Val:  noReservedReg.FindString(buf),
		}
	}
	return Token{}
}

// getQuotedString 获取quote
func getQuotedString(buf string) string {
	// This checks for the following patterns:
	// 1. backtick quoted string using `` to escape
	// 2. double quoted string using "" or \" to escape
	// 3. single quoted string using '' or \' to escape
	start := string(buf[0])
	switch start {
	case "\"", "`", "'":
		reg := fmt.Sprintf(`(^%s[^%s\\]*(?:\\.[^%s\\]*)*(%s|$))+`, start, start, start, start)
		quotedReg := regexp.MustCompile(reg)
		if quotedReg.MatchString(buf) {
			buf = quotedReg.FindString(buf)
		} else {
			buf = ""
		}
	default:
		buf = ""
	}
	return buf
}

// Tokenize 序列化 token,区别于 Tokenizer 函数,这个函数是 soar built-in 实现的切词
func Tokenize(sql string) []Token {
	var token Token
	var tokenLength int
	var tokens []Token
	tokenCache := make(map[string]Token)

	// Used to make sure the string keeps shrinking on each iteration
	oldStringLen := len(sql) + 1

	currentLength := len(sql)
	for currentLength > 0 {
		// If the string stopped shrinking, there was a problem
		if oldStringLen <= currentLength {
			tokens = []Token{
				{
					Type: TokenTypeError,
					Val:  sql,
				},
			}
			return tokens
		}

		oldStringLen = currentLength
		cacheKey := ""
		// Determine if we can use caching
		if currentLength >= maxCachekeySize {
			cacheKey = sql[:maxCachekeySize]
		}

		// See if the token is already cached
		if _, ok := tokenCache[cacheKey]; ok {
			// Retrieve from cache
			token = tokenCache[cacheKey]
			tokenLength = len(token.Val)
			cacheHits = cacheHits + 1
		} else {
			// Get the next token and the token type
			token = getNextToken(sql, token)
			tokenLength = len(token.Val)
			cacheMisses = cacheMisses + 1
			// If the token is shorter than the max length, store it in cache
			if cacheKey != "" && tokenLength < maxCachekeySize {
				tokenCache[cacheKey] = token
			}
		}

		tokens = append(tokens, token)

		// Advance the string
		sql = sql[tokenLength:]
		currentLength = currentLength - tokenLength
	}
	return tokens
}

// Compress compress sql
// this method is inspired by eversql.com
func Compress(sql string) string {
	regLineTab := regexp.MustCompile(`(?i)([\n\t])`)
	regSpace := regexp.MustCompile(`\s\s+`)
	sql = regSpace.ReplaceAllString(regLineTab.ReplaceAllString(sql, " "), " ")
	return sql
}

// SplitStatement SQL切分
// return 1. original sql, 2. remove comment sql, 3. left over buf
func SplitStatement(buf []byte, delimiter []byte) (string, string, []byte) {
	var singleLineComment bool
	var multiLineComment bool
	var quoted bool
	var quoteRune byte
	var sql string

	for i := 0; i < len(buf); i++ {
		b := buf[i]
		// single line comment
		if b == '-' {
			if !quoted && i+2 < len(buf) && buf[i+1] == '-' && buf[i+2] == ' ' {
				singleLineComment = true
				i = i + 2
				continue
			}
			if !quoted && i+2 < len(buf) && i == 0 && buf[i+1] == '-' && (buf[i+2] == '\n' || buf[i+2] == '\r') {
				sql = "--\n"
				break
			}
		}

		if b == '#' {
			if !multiLineComment && !quoted && !singleLineComment {
				singleLineComment = true
				continue
			}
		}

		// new line end single line comment
		if b == '\r' || b == '\n' {
			if singleLineComment {
				sql = string(buf[:i])
				singleLineComment = false
				if strings.HasPrefix(strings.TrimSpace(sql), "--") ||
					strings.HasPrefix(strings.TrimSpace(sql), "#") {
					// just comment, query start with '--', '#'
					break
				}
				// comment in multi-line sql
				continue
			}
			continue
		}

		// multi line comment
		// https://dev.mysql.com/doc/refman/8.0/en/comments.html
		// https://dev.mysql.com/doc/refman/8.0/en/optimizer-hints.html
		if b == '/' && i+1 < len(buf) && buf[i+1] == '*' {
			if !multiLineComment && !singleLineComment && !quoted &&
				(buf[i+2] != '!' && buf[i+2] != '+') {
				i = i + 2
				multiLineComment = true
				continue
			}
		}

		if b == '*' && i+1 < len(buf) && buf[i+1] == '/' {
			if multiLineComment && !quoted && !singleLineComment {
				i = i + 2
				multiLineComment = false
				// '/*comment*/'
				if i == len(buf) {
					sql = string(buf[:i])
				}
				// '/*comment*/;', 'select 1/*comment*/;'
				if string(buf[i:]) == string(delimiter) {
					sql = string(buf)
				}
				continue
			}
		}

		// quoted string
		switch b {
		case '`', '\'', '"':
			if i > 1 && buf[i-1] != '\\' {
				if quoted && b == quoteRune {
					quoted = false
					quoteRune = 0
				} else {
					// check if first time found quote
					if quoteRune == 0 {
						quoted = true
						quoteRune = b
					}
				}
			}
		}

		// delimiter
		if !quoted && !singleLineComment && !multiLineComment {
			eof := true
			for k, c := range delimiter {
				if len(buf) > i+k && buf[i+k] != c {
					eof = false
				}
			}
			if eof {
				i = i + len(delimiter)
				sql = string(buf[:i])
				break
			}
		}

		// ended of buf
		if i == len(buf)-1 {
			sql = string(buf)
		}
	}
	orgSQL := string(buf[:len(sql)])
	buf = buf[len(sql):]
	return orgSQL, strings.TrimSuffix(sql, string(delimiter)), buf
}

// LeftNewLines cal left new lines in space
func LeftNewLines(buf []byte) int {
	newLines := 0
	for _, b := range buf {
		if !unicode.IsSpace(rune(b)) {
			break
		}
		if b == byte('\n') {
			newLines++
		}
	}
	return newLines
}

// NewLines cal all new lines
func NewLines(buf []byte) int {
	newLines := 0
	for _, b := range buf {
		if b == byte('\n') {
			newLines++
		}
	}
	return newLines
}

// QueryType get query type such as SELECT/INSERT/DELETE/CREATE/ALTER
func QueryType(sql string) string {
	tokens := Tokenize(sql)
	for _, token := range tokens {
		// use strings.Fields for 'ALTER TABLE' token split
		for _, tk := range strings.Fields(strings.TrimSpace(token.Val)) {
			if val, ok := mySQLKeywords[strings.ToLower(tk)]; ok {
				return val
			}
		}
	}
	return "UNKNOWN"
}


================================================
FILE: ast/token_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ast

import (
	"fmt"
	"testing"

	"github.com/XiaoMi/soar/common"

	"github.com/kr/pretty"
)

func TestTokenize(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	err := common.GoldenDiff(func() {
		for _, sql := range common.TestSQLs {
			fmt.Println(sql)
			fmt.Println(Tokenize(sql))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestTokenizer(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	sqls := []string{
		"select -- comment 1",
		"select c1,c2,c3 from t1,t2 join t3 on t1.c1=t2.c1 and t1.c3=t3.c1 where id>1000",
		"select sourcetable, if(f.lastcontent = ?, f.lastupdate, f.lastcontent) as lastactivity, f.totalcount as activity, type.class as type, (f.nodeoptions & ?) as nounsubscribe from node as f inner join contenttype as type on type.contenttypeid = f.contenttypeid inner join subscribed as sd on sd.did = f.nodeid and sd.userid = ? union all select f.name as title, f.userid as keyval, ? as sourcetable, ifnull(f.lastpost, f.joindate) as lastactivity, f.posts as activity, ? as type, ? as nounsubscribe from user as f inner join userlist as ul on ul.relationid = f.userid and ul.userid = ? where ul.type = ? and ul.aq = ? order by title limit ?",
		"select c1 from t1 where id>=1000", // test ">="
		"select SQL_CALC_FOUND_ROWS col from tbl where id>1000",
		"SELECT * FROM tb WHERE id=?;",
		"SELECT * FROM tb WHERE id is null;",
		"SELECT * FROM tb WHERE id is not null;",
		"SELECT * FROM tb WHERE id between 1 and 3;",
		"alter table inventory add index idx_store_film` (`store_id`,`film_id`);",
		`UPDATE xxx SET c1=' LOGGER.error(""); }' WHERE id = 2 ;`,
		`update tb set status = 1 where id = 1;`, // SQL 中包含 non-broken-space
	}
	err := common.GoldenDiff(func() {
		for _, sql := range sqls {
			pretty.Println(Tokenizer(sql))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestGetQuotedString(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	var str = []string{
		`"hello world"`,
		"`hello world`",
		`'hello world'`,
		"hello world",
		`'hello \'world'`,
		`"hello \"wor\"ld"`,
		`"hello \"world"`,
		`""`,
		`''`,
		"``",
		`'hello 'world'`,
		`"hello "world"`,
		`' LOGGER.error(""); }'`,
	}
	err := common.GoldenDiff(func() {
		for _, s := range str {
			fmt.Printf("orignal: %s\nquoted: %s\n", s, getQuotedString(s))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestCompress(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	err := common.GoldenDiff(func() {
		for _, sql := range common.TestSQLs {
			fmt.Println(sql)
			fmt.Println(Compress(sql))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestFormat(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	err := common.GoldenDiff(func() {
		for _, sql := range common.TestSQLs {
			fmt.Println(sql)
			fmt.Println(format(sql))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestSplitStatement(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	bufs := [][]byte{
		[]byte("select * from test;hello"),              // 0
		[]byte("select 'asd;fas', col from test;hello"), // 1
		[]byte("-- select * from test;hello"),           // 2
		[]byte("#select * from test;hello"),             // 3
		[]byte("select * /*comment*/from test;hello"),   // 4
		[]byte("select * /*comment;*/from test;hello"),  // 5
		[]byte(`select * /*comment
		;*/
		from test;hello`), // 6
		[]byte(`select * from test`), // 7
		// https://github.com/XiaoMi/soar/issues/66
		[]byte(`/*comment*/`),  // 8
		[]byte(`/*comment*/;`), // 9
		[]byte(`--`),           // 10
		[]byte(`-- comment`),   // 11
		[]byte(`# comment`),    // 12
		// https://github.com/XiaoMi/soar/issues/116
		[]byte(`select
*
-- comment
from tb
where col = 1`), // 13
		[]byte(`select
* --
from tb
where col = 1`), // 14
		[]byte(`select
* #
from tb
where col = 1`), // 15
		[]byte(`select
*
--
from tb
where col = 1`), // 16
		[]byte(`select * from
-- comment
tb;
select col from tb where col = 1;`), // 17
		// https://github.com/XiaoMi/soar/issues/120
		[]byte(`
-- comment
select col from tb;
select col from tb;
`), // 18
		[]byte(`INSERT /*+ SET_VAR(foreign_key_checks=OFF) */ INTO t2 VALUES(2);`),                              // 19
		[]byte(`select /*!50000 1,*/ 1;`),                                                                       // 20
		[]byte(`UPDATE xxx SET c1=' LOGGER.error(""); }' WHERE id = 2 ;`),                                       // 21
		[]byte("UPDATE `xxx` SET aaa='a;' WHERE `id` = 15;"),                                                    // 22
		[]byte("UPDATE `xxx` SET aaa='a -- b' WHERE `id` = 15; UPDATE `xxx` SET aaa='c -- d' WHERE `id` = 16;"), // 23
		// []byte(`/* comment here */ SET MAX_JOIN_SIZE=#`),                        // 24
	}
	// \G 分隔符
	buf2s := [][]byte{
		[]byte("select * from test\\Ghello"),                    // 0
		[]byte("select 'hello\\Gworld', col from test\\Ghello"), // 1
		[]byte("-- select * from test\\Ghello"),                 // 2
		[]byte("#select * from test\\Ghello"),                   // 3
		[]byte("select * /*comment*/from test\\Ghello"),         // 4
		[]byte("select * /*comment;*/from test\\Ghello"),        // 5
		[]byte(`select * /*comment
        \\G*/
        from test\\Ghello`), // 6
	}
	//// single sql test
	//b, t1, t2 := SplitStatement(bufs[23], []byte(";"))
	//fmt.Println("buf: ", b, "sql: ", t1, "left: ", string(t2))
	//return
	err := common.GoldenDiff(func() {
		for i, buf := range bufs {
			sql, _, _ := SplitStatement(buf, []byte(";"))
			fmt.Println(i, sql)
		}

		for i, buf := range buf2s {
			sql, _, _ := SplitStatement(buf, []byte("\\G"))
			fmt.Println(i, sql)
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestLeftNewLines(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	bufs := [][]byte{
		[]byte(`
		select * from test;hello`),
		[]byte(`select * /*comment
        ;*/
        from test;hello`),
		[]byte(`select * from test`),
	}
	err := common.GoldenDiff(func() {
		for _, buf := range bufs {
			fmt.Println(LeftNewLines(buf))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestNewLines(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	bufs := [][]byte{
		[]byte(`
		select * from test;hello`),
		[]byte(`select * /*comment
        ;*/
        from test;hello`),
		[]byte(`select * from test`),
	}
	err := common.GoldenDiff(func() {
		for _, buf := range bufs {
			fmt.Println(NewLines(buf))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestQueryType(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	var testSQLs = []string{
		` select 1`,
		`/*comment*/ select 1`,
		`(select 1)`,
		`grant select on *.* to user@'localhost'`,
		`REVOKE INSERT ON *.* FROM 'jeffrey'@'localhost';`,
	}
	// fmt.Println(testSQLs[len(testSQLs)-1])
	// fmt.Println(QueryType(testSQLs[len(testSQLs)-1]))
	// return
	err := common.GoldenDiff(func() {
		for _, buf := range append(testSQLs, common.TestSQLs...) {
			fmt.Println(QueryType(buf))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}


================================================
FILE: ast/vitess.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ast

import (
	"encoding/json"

	"github.com/XiaoMi/soar/common"

	"github.com/kr/pretty"
	"vitess.io/vitess/go/vt/sqlparser"
)

// PrintPrettyVitessStmtNode print vitess AST struct data
func PrintPrettyVitessStmtNode(sql string) {
	tree, err := sqlparser.Parse(sql)
	if err != nil {
		common.Log.Warning(err.Error())
	} else {
		_, err = pretty.Println(tree)
		common.LogIfWarn(err, "")
	}
}

// VitessStmtNode2JSON vitess AST tree into json format
func VitessStmtNode2JSON(sql string) string {
	var str string
	tree, err := sqlparser.Parse(sql)
	if err != nil {
		common.Log.Warning(err.Error())
	} else {
		b, err := json.MarshalIndent(tree, "", "  ")
		if err != nil {
			common.Log.Error(err.Error())
		} else {
			str = string(b)
		}
	}
	return str
}


================================================
FILE: ast/vitess_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ast

import (
	"fmt"
	"testing"

	"github.com/XiaoMi/soar/common"
)

func TestPrintPrettyVitessStmtNode(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	sqls := []string{
		`select 1`,
		`select * f`, // syntax error case
	}
	err := common.GoldenDiff(func() {
		for _, sql := range sqls {
			PrintPrettyVitessStmtNode(sql)
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func TestVitessStmtNode2JSON(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	sqls := []string{
		`select 1`,
		`select * f`, // syntax error case
	}
	err := common.GoldenDiff(func() {
		for _, sql := range sqls {
			fmt.Println(VitessStmtNode2JSON(sql))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}


================================================
FILE: cmd/soar/doc.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

// Package soar is the main program of SOAR
package main


================================================
FILE: cmd/soar/soar.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package main

import (
	"encoding/json"
	"fmt"
	"os"
	"strings"

	"github.com/XiaoMi/soar/advisor"
	"github.com/XiaoMi/soar/ast"
	"github.com/XiaoMi/soar/common"
	"github.com/XiaoMi/soar/database"
	"github.com/XiaoMi/soar/env"

	"github.com/go-sql-driver/mysql"
	"github.com/kr/pretty"
	"github.com/percona/go-mysql/query"
)

func main() {
	// 全局变量
	var err error
	var sql string                                            // 单条评审指定的 sql 或 explain
	var currentDB string                                      // 当前 SQL 使用的 database
	sqlCounter := 1                                           // SQL 计数器
	lineCounter := 1                                          // 行计数器
	var alterSQLs []string                                    // 待评审的 SQL 中所有 ALTER 请求
	alterTableTimes := make(map[string]int)                   // 待评审的 SQL 中同一经表 ALTER 请求计数器
	suggestMerged := make(map[string]map[string]advisor.Rule) // 优化建议去重, key 为 sql 的 fingerprint.ID
	var suggestStr []string                                   // string 形式格式化之后的优化建议,用于 -report-type json
	tables := make(map[string][]string)                       // SQL 使用的库表名

	// 配置文件&命令行参数解析
	initConfig()

	// 命令行帮助工具,如 -list-report-types, -check-config等。
	if isContinue, exitCode := helpTools(); !isContinue {
		os.Exit(exitCode)
	}

	// 环境初始化,连接检查线上环境+构建测试环境
	vEnv, rEnv := env.BuildEnv()

	// 使用 -cleanup-test-database 命令手动清理残余的 optimizer_xxx 数据库
	if common.Config.CleanupTestDatabase {
		vEnv.CleanupTestDatabase()
		return
	}

	// 如果使用到测试环境,在这里环境清理
	if common.Config.DropTestTemporary {
		defer vEnv.CleanUp()
	}

	// 当程序卡死的时候,或者由于某些原因程序没有退出,可以通过捕获信号量的形式让程序优雅退出并且清理测试环境
	common.HandleSignal(func() {
		shutdown(vEnv, rEnv)
	})

	// 对指定的库表进行索引重复检查
	if common.Config.ReportType == "duplicate-key-checker" {
		dupKeySuggest := advisor.DuplicateKeyChecker(rEnv)
		_, str := advisor.FormatSuggest("", currentDB, common.Config.ReportType, dupKeySuggest)
		if str == "" {
			fmt.Printf("%s/%s 未发现重复索引\n", common.Config.OnlineDSN.Addr, common.Config.OnlineDSN.Schema)
		} else {
			fmt.Println(str)
		}
		return
	}

	// 读入待优化 SQL ,当配置文件或命令行参数未指定 SQL 时从管道读取
	buf := initQuery(common.Config.Query)
	lineCounter += ast.LeftNewLines([]byte(buf))
	buf = strings.TrimSpace(buf)

	// remove bom from file header
	var bom []byte
	buf, bom = common.RemoveBOM([]byte(buf))

	if isContinue, exitCode := reportTool(buf, bom); !isContinue {
		os.Exit(exitCode)
	}

	// 逐条SQL给出优化建议
	for ; ; sqlCounter++ {
		var id string                                     // fingerprint.ID
		heuristicSuggest := make(map[string]advisor.Rule) // 启发式建议
		expSuggest := make(map[string]advisor.Rule)       // EXPLAIN 解读
		idxSuggest := make(map[string]advisor.Rule)       // 索引建议
		proSuggest := make(map[string]advisor.Rule)       // Profiling 信息
		traceSuggest := make(map[string]advisor.Rule)     // Trace 信息
		mysqlSuggest := make(map[string]advisor.Rule)     // MySQL 返回的 ERROR 信息

		if buf == "" {
			common.Log.Debug("Ending, buf: '%s', sql: '%s'", buf, sql)
			break
		}
		// 查询请求切分
		orgSQL, sql, bufBytes := ast.SplitStatement([]byte(buf), []byte(common.Config.Delimiter))
		// lineCounter
		lc := ast.NewLines([]byte(orgSQL))
		// leftLineCounter
		llc := ast.LeftNewLines([]byte(orgSQL))
		lineCounter += llc
		if len(buf) == len(bufBytes) {
			// 防止切分死循环,当剩余的内容和原 SQL 相同时直接清空 buf
			buf = ""
			orgSQL = string(bufBytes)
			sql = orgSQL
		} else {
			buf = string(bufBytes)
		}

		// 去除无用的备注和空格
		sql = database.RemoveSQLComments(sql)
		if sql == "" {
			common.Log.Debug("empty query or comment, buf: %s", buf)
			continue
		}
		common.Log.Debug("main loop SQL: %s", sql)

		// +++++++++++++++++++++小工具集[开始]+++++++++++++++++++++++{
		fingerprint := strings.TrimSpace(query.Fingerprint(sql))
		// SQL 签名
		id = query.Id(fingerprint)
		currentDB = env.CurrentDB(sql, currentDB)
		switch common.Config.ReportType {
		case "fingerprint":
			// SQL 指纹
			if common.Config.Verbose {
				fmt.Printf("-- ID: %s\n", id)
			}
			fmt.Println(fingerprint)
			continue
		case "pretty":
			// SQL 美化
			fmt.Println(ast.Pretty(sql, "builtin") + common.Config.Delimiter)
			continue
		case "compress":
			// SQL 压缩
			fmt.Println(ast.Compress(sql) + common.Config.Delimiter)
			continue
		case "ast":
			// print vitess AST data struct
			ast.PrintPrettyVitessStmtNode(sql)
			continue
		case "ast-json":
			// print vitess SQL AST into json format
			fmt.Println(ast.VitessStmtNode2JSON(sql))
			continue
		case "tiast":
			// print TiDB AST data struct
			ast.PrintPrettyStmtNode(sql, "", "")
			continue
		case "tiast-json":
			// print TiDB SQL AST into json format
			fmt.Println(ast.StmtNode2JSON(sql, "", ""))
			continue
		case "tokenize":
			// SQL 切词
			_, err = pretty.Println(ast.Tokenize(sql))
			common.LogIfWarn(err, "")
			continue
		default:
			// 建议去重,减少评审整个文件耗时
			// TODO: 由于 a = 11 和 a = '11' 的 fingerprint 相同,这里一旦跳过即无法检查有些建议了,如: ARG.003
			if _, ok := suggestMerged[id]; ok {
				// `use ?` 不可以去重,去重后将导致无法切换数据库
				if !strings.HasPrefix(fingerprint, "use") {
					continue
				}
			}
			// 黑名单中的SQL不给建议
			if advisor.InBlackList(fingerprint) {
				// `use ?` 不可以出现在黑名单中
				if !strings.HasPrefix(fingerprint, "use") {
					continue
				}
			}
		}
		tables[id] = ast.SchemaMetaInfo(sql, currentDB)
		// +++++++++++++++++++++小工具集[结束]+++++++++++++++++++++++}

		// +++++++++++++++++++++语法检查[开始]+++++++++++++++++++++++{
		q, syntaxErr := advisor.NewQuery4Audit(sql)
		stmt := q.Stmt

		// 如果语法检查出错则不需要给优化建议
		if syntaxErr != nil {
			errContent := fmt.Sprintf("At SQL %d : %v", sqlCounter, syntaxErr)
			common.Log.Warning(errContent)
			if common.Config.OnlySyntaxCheck || common.Config.ReportType == "rewrite" ||
				common.Config.ReportType == "query-type" {
				fmt.Println(errContent)
				os.Exit(1)
			}
			// tidb parser 语法检查给出的建议 ERR.000
			mysqlSuggest["ERR.000"] = advisor.RuleMySQLError("ERR.000", syntaxErr)
		}
		// 如果只想检查语法直接跳过后面的步骤
		if common.Config.OnlySyntaxCheck {
			continue
		}
		// +++++++++++++++++++++语法检查[结束]+++++++++++++++++++++++}

		switch common.Config.ReportType {
		case "tables":
			continue
		case "query-type":
			// query type by first key word
			fmt.Println(ast.QueryType(sql))
			continue
		}

		// +++++++++++++++++++++启发式规则建议[开始]+++++++++++++++++++++++{
		common.Log.Debug("start of heuristic advisor Query: %s", q.Query)
		for item, rule := range advisor.HeuristicRules {
			// 去除忽略的建议检查
			okFunc := (*advisor.Query4Audit).RuleOK
			if !advisor.IsIgnoreRule(item) && &rule.Func != &okFunc {
				r := rule.Func(q)
				if r.Item == item {
					heuristicSuggest[item] = r
				}
			}
		}
		common.Log.Debug("end of heuristic advisor Query: %s", q.Query)
		// +++++++++++++++++++++启发式规则建议[结束]+++++++++++++++++++++++}

		// +++++++++++++++++++++索引优化建议[开始]+++++++++++++++++++++++{
		// 如果配置了索引建议过滤规则,不进行索引优化建议
		// 在配置文件 ignore-rules 中添加 'IDX.*' 即可屏蔽索引优化建议
		common.Log.Debug("start of index advisor Query: %s", q.Query)
		if !advisor.IsIgnoreRule("IDX.") {
			if vEnv.BuildVirtualEnv(rEnv, q.Query) {
				idxAdvisor, err := advisor.NewAdvisor(vEnv, *rEnv, *q)
				if err != nil || (idxAdvisor == nil && vEnv.Error == nil) {
					if idxAdvisor == nil {
						// 如果 SQL 是 DDL 语句,则返回的 idxAdvisor 为 nil,可以忽略不处理
						// TODO alter table add index 语句检查索引是否已经存在
						common.Log.Debug("idxAdvisor by pass Query: %s", q.Query)
					} else {
						common.Log.Warning("advisor.NewAdvisor Error: %v", err)
					}
				} else {
					// 创建环境时没有出现错误,生成索引建议
					if vEnv.Error == nil {
						idxSuggest = idxAdvisor.IndexAdvise().Format()

						// 依赖数据字典的启发式建议
						for i, r := range idxAdvisor.HeuristicCheck(*q) {
							heuristicSuggest[i] = r
						}
					} else {
						// 根据错误号输出建议
						switch vEnv.Error.(*mysql.MySQLError).Number {
						case 1061:
							idxSuggest["IDX.001"] = advisor.Rule{
								Item:     "IDX.001",
								Severity: "L2",
								Summary:  "索引名称已存在",
								Content:  strings.Trim(strings.Split(vEnv.Error.Error(), ":")[1], " "),
								Case:     sql,
							}
						default:
							// vEnv.VEnvBuild 阶段给出的 ERROR 是 ERR.001
							delete(mysqlSuggest, "ERR.000")
							mysqlSuggest["ERR.001"] = advisor.RuleMySQLError("ERR.001", vEnv.Error)
							common.Log.Error("BuildVirtualEnv DDL Execute Error : %v", vEnv.Error)
						}
					}
				}
			} else {
				common.Log.Error("vEnv.BuildVirtualEnv Error: prepare SQL '%s' in vEnv failed.", q.Query)
			}
		}
		common.Log.Debug("end of index advisor Query: %s", q.Query)
		// +++++++++++++++++++++索引优化建议[结束]+++++++++++++++++++++++}

		// +++++++++++++++++++++EXPLAIN 建议[开始]+++++++++++++++++++++++{
		// 如果未配置 Online 或 Test 无法给 Explain 建议
		common.Log.Debug("start of explain Query: %s", q.Query)
		if !common.Config.OnlineDSN.Disable && !common.Config.TestDSN.Disable {
			// 因为 EXPLAIN 依赖数据库环境,所以把这段逻辑放在启发式建议和索引建议后面
			if common.Config.Explain {
				// 执行 EXPLAIN
				explainInfo, err := rEnv.Explain(q.Query,
					database.ExplainType[common.Config.ExplainType],
					database.ExplainFormatType[common.Config.ExplainFormat])
				if err != nil {
					// 线上环境执行失败才到测试环境 EXPLAIN,比如在用户提供建表语句及查询语句的场景
					common.Log.Warn("rEnv.Explain Warn: %v", err)
					explainInfo, err = vEnv.Explain(q.Query,
						database.ExplainType[common.Config.ExplainType],
						database.ExplainFormatType[common.Config.ExplainFormat])
					if err != nil {
						// EXPLAIN 阶段给出的 ERROR 是 ERR.002
						mysqlSuggest["ERR.002"] = advisor.RuleMySQLError("ERR.002", err)
						common.Log.Error("vEnv.Explain Error: %v", err)
					}
				}
				// 分析 EXPLAIN 结果
				if explainInfo != nil {
					expSuggest = advisor.ExplainAdvisor(explainInfo)
				} else {
					common.Log.Warn("rEnv&vEnv.Explain explainInfo nil, SQL: %s", q.Query)
				}
			}
		}
		common.Log.Debug("end of explain Query: %s", q.Query)
		// +++++++++++++++++++++ EXPLAIN 建议[结束]+++++++++++++++++++++++}

		// +++++++++++++++++++++ Profiling [开始]+++++++++++++++++++++++++{
		common.Log.Debug("start of profiling Query: %s", q.Query)
		if common.Config.Profiling {
			res, err := vEnv.Profiling(q.Query)
			if err == nil {
				proSuggest["PRO.001"] = advisor.Rule{
					Item:     "PRO.001",
					Severity: "L0",
					Content:  database.FormatProfiling(res),
				}
			} else {
				common.Log.Error("Profiling Error: %v", err)
			}
		}
		common.Log.Debug("end of profiling Query: %s", q.Query)
		// +++++++++++++++++++++ Profiling [结束]++++++++++++++++++++++++++}

		// +++++++++++++++++++++ Trace [开始]+++++++++++++++++++++++++{
		common.Log.Debug("start of trace Query: %s", q.Query)
		if common.Config.Trace {
			res, err := vEnv.Trace(q.Query)
			if err == nil {
				traceSuggest["TRA.001"] = advisor.Rule{
					Item:     "TRA.001",
					Severity: "L0",
					Content:  database.FormatTrace(res),
				}
			} else {
				common.Log.Error("Trace Error: %v", err)
			}
		}
		common.Log.Debug("end of trace Query: %s", q.Query)
		// +++++++++++++++++++++Trace [结束]++++++++++++++++++++++++++}

		// +++++++++++++++++++++SQL 重写[开始]+++++++++++++++++++++++++{
		common.Log.Debug("start of rewrite Query: %s", q.Query)
		if common.Config.ReportType == "rewrite" {
			if strings.HasPrefix(strings.TrimSpace(strings.ToLower(sql)), "create") ||
				strings.HasPrefix(strings.TrimSpace(strings.ToLower(sql)), "alter") ||
				strings.HasPrefix(strings.TrimSpace(strings.ToLower(sql)), "rename") {
				// 依赖上下文件的 SQL 重写,如:多条 ALTER SQL 合并
				// vitess 对 DDL 语法的支持不好,大部分 DDL 会语法解析出错,但即使出错了还是会生成一个 stmt 而且里面的 db.table 还是准确的。

				alterSQLs = append(alterSQLs, sql)
				alterTbl := ast.AlterAffectTable(stmt)
				if alterTbl != "" && alterTbl != "dual" {
					if _, ok := alterTableTimes[alterTbl]; ok {
						heuristicSuggest["ALT.002"] = advisor.HeuristicRules["ALT.002"]
						alterTableTimes[alterTbl] = alterTableTimes[alterTbl] + 1
					} else {
						alterTableTimes[alterTbl] = 1
					}
				}
			} else {
				// 其他不依赖上下文件的 SQL 重写
				rw := ast.NewRewrite(sql)
				if rw == nil {
					// 都到这一步了 sql 不会语法不正确,因此 rw 一般不会为 nil
					common.Log.Critical("NewRewrite nil point error, SQL: %s", sql)
					os.Exit(1)
				}
				// SQL 转写需要的源信息采集,如果没有配置环境则只做有限改写
				meta := ast.GetMeta(rw.Stmt, nil)
				rw.Columns = vEnv.GenTableColumns(meta)
				// 执行定义好的 SQL 重写规则
				rw.Rewrite()
				fmt.Println(strings.TrimSpace(rw.NewSQL))
			}
		}
		common.Log.Debug("end of rewrite Query: %s", q.Query)
		// +++++++++++++++++++++ SQL 重写[结束]++++++++++++++++++++++++++}

		// +++++++++++++++++++++打印单条 SQL 优化建议[开始]++++++++++++++++++++++++++{
		common.Log.Debug("start of print suggestions, Query: %s", q.Query)
		if strings.HasPrefix(fingerprint, "use") {
			continue
		}
		sug, str := advisor.FormatSuggest(q.Query, currentDB, common.Config.ReportType, heuristicSuggest, idxSuggest, expSuggest, proSuggest, traceSuggest, mysqlSuggest)
		suggestMerged[id] = sug
		switch common.Config.ReportType {
		case "json":
			suggestStr = append(suggestStr, str)
		case "tables":
		case "duplicate-key-checker":
		case "rewrite":
		case "lint":
			for _, s := range strings.Split(str, "\n") {
				// ignore empty output
				if strings.TrimSpace(s) == "" {
					continue
				}

				if common.Config.Query != "" {
					if _, err = os.Stat(common.Config.Query); err == nil {
						fmt.Printf("%s:%d:%s\n", common.Config.Query, lineCounter, s)
					} else {
						fmt.Printf("null:%d:%s\n", lineCounter, s)
					}
				} else {
					fmt.Printf("stdin:%d:%s\n", lineCounter, s)
				}
			}
			lineCounter += lc - llc
		case "html":
			fmt.Println(common.Markdown2HTML(str))
		default:
			fmt.Println(str)
		}
		common.Log.Debug("end of print suggestions, Query: %s", q.Query)
		// +++++++++++++++++++++打印单条 SQL 优化建议[结束]++++++++++++++++++++++++++}
	}

	// 同一张表的多条 ALTER 语句合并为一条
	if ast.RewriteRuleMatch("mergealter") {
		for _, v := range ast.MergeAlterTables(alterSQLs...) {
			fmt.Println(strings.TrimSpace(v))
		}
		return
	}

	// 以 JSON 格式化输出
	if common.Config.ReportType == "json" {
		fmt.Println("[\n", strings.Join(suggestStr, ",\n"), "\n]")
	}

	// 以 JSON 格式输出 SQL 影响的库表名
	if common.Config.ReportType == "tables" {
		js, err := json.MarshalIndent(tables, "", "  ")
		if err == nil {
			fmt.Println(string(js))
		} else {
			common.Log.Error("FormatSuggest json.Marshal Error: %v", err)
		}
		return
	}

	verboseInfo()
}


================================================
FILE: cmd/soar/soar_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package main

import (
	"flag"
	"fmt"
	"os"
	"path/filepath"
	"runtime"
	"testing"

	"github.com/XiaoMi/soar/common"
)

var update = flag.Bool("update", false, "update .golden files")

func TestMain(m *testing.M) {
	// 初始化 init
	if common.DevPath == "" {
		_, file, _, _ := runtime.Caller(0)
		common.DevPath, _ = filepath.Abs(filepath.Dir(filepath.Join(file, ".."+string(filepath.Separator))))
	}
	common.BaseDir = common.DevPath
	err := common.ParseConfig("")
	common.LogIfError(err, "init ParseConfig")
	common.Log.Debug("mysql_test init")
	_ = update // check if var success init

	// 分割线
	flag.Parse()
	m.Run()

	// 环境清理
	//
}

func Test_Main(_ *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	common.Config.OnlineDSN.Disable = true
	common.Config.LogLevel = 0
	common.Config.Query = "select * syntaxError"
	main()
	common.Config.Query = "select * from film;alter table city add index idx_country_id(country_id);"
	main()
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func Test_Main_More(_ *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	common.Config.LogLevel = 0
	common.Config.Profiling = true
	common.Config.Explain = true
	common.Config.Query = "select * from film where country_id = 1;use sakila;alter table city add index idx_country_id(country_id);"
	orgRerportType := common.Config.ReportType
	for _, typ := range []string{
		"json", "html", "markdown", "fingerprint", "compress", "pretty", "rewrite",
		"ast", "tiast", "ast-json", "tiast-json", "tokenize", "lint", "tables", "query-type",
	} {
		common.Config.ReportType = typ
		main()
	}
	common.Config.ReportType = orgRerportType
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func Test_Main_initQuery(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	// direct query
	query := initQuery("select 1")
	if query != "select 1" {
		t.Errorf("want 'select 1', got %s", query)
	}

	// read from file
	initQuery(common.DevPath + "/README.md")

	orgStdin := os.Stdin
	tmpStdin, err := os.Open(common.DevPath + "/VERSION")
	if err != nil {
		t.Error(err)
	}
	os.Stdin = tmpStdin
	fmt.Println(initQuery(""))
	os.Stdin = orgStdin
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func Test_Main_reportTool(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	orgRerportType := common.Config.ReportType
	types := []string{"html", "md2html", "explain-digest", "chardet", "remove-comment"}
	for _, tp := range types {
		common.Config.ReportType = tp
		fmt.Println(reportTool(tp, []byte{}))
	}
	common.Config.ReportType = orgRerportType
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func Test_Main_helpTools(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())

	orgConfig := common.CheckConfig
	common.CheckConfig = true
	helpTools()
	common.CheckConfig = orgConfig

	orgConfig = common.PrintVersion
	common.PrintVersion = true
	helpTools()
	common.PrintVersion = orgConfig

	orgConfig = common.PrintConfig
	common.PrintConfig = true
	helpTools()
	common.PrintConfig = orgConfig

	orgConfig = common.Config.ListHeuristicRules
	common.Config.ListHeuristicRules = true
	helpTools()
	common.Config.ListHeuristicRules = orgConfig

	orgConfig = common.Config.ListRewriteRules
	common.Config.ListRewriteRules = true
	helpTools()
	common.Config.ListRewriteRules = orgConfig

	orgConfig = common.Config.ListTestSqls
	common.Config.ListTestSqls = true
	helpTools()
	common.Config.ListTestSqls = orgConfig

	orgConfig = common.Config.ListReportTypes
	common.Config.ListReportTypes = true
	helpTools()
	common.Config.ListReportTypes = orgConfig
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}

func Test_Main_verboseInfo(t *testing.T) {
	common.Log.Debug("Entering function: %s", common.GetFunctionName())
	orgVerbose := common.Config.Verbose
	common.Config.Verbose = true
	err := common.GoldenDiff(func() {
		// Syntax check OK
		orgSyntaxCheck := common.Config.OnlySyntaxCheck
		common.Config.OnlySyntaxCheck = true
		verboseInfo()
		common.Config.OnlySyntaxCheck = orgSyntaxCheck

		// MySQL environment verbose info
		orgTestDSNDisable := common.Config.TestDSN.Disable
		common.Config.TestDSN.Disable = true
		verboseInfo()
		common.Config.TestDSN.Disable = orgTestDSNDisable

		orgOnlineDSNDisable := common.Config.OnlineDSN.Disable
		common.Config.OnlineDSN.Disable = true
		verboseInfo()
		common.Config.OnlineDSN.Disable = orgOnlineDSNDisable
	}, t.Name(), update)
	if err != nil {
		t.Error(err)
	}

	common.Config.Verbose = orgVerbose
	common.Log.Debug("Exiting function: %s", common.GetFunctionName())
}


================================================
FILE: cmd/soar/testdata/Test_Main.golden
================================================
# Query: 16219655761820A2

★ ★ ★ ★ ★ 100分

```sql

SELECT  
  1
```

##  ✔️



================================================
FILE: cmd/soar/testdata/Test_Main_verboseInfo.golden
================================================
Syntax check OK!
MySQL environment verbose info
* test-dsn: 127.0.0.1:3306 is disable, please check log.
* online-dsn: 127.0.0.1:3306 is disable, please check log.
MySQL environment verbose info
* test-dsn: 127.0.0.1:3306 is disable, please check log.
* online-dsn: 127.0.0.1:3306 is disable, please check log.


================================================
FILE: cmd/soar/tool.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package main

import (
	"fmt"
	"io/ioutil"
	"os"
	"path/filepath"
	"strings"

	"github.com/XiaoMi/soar/advisor"
	"github.com/XiaoMi/soar/ast"
	"github.com/XiaoMi/soar/common"
	"github.com/XiaoMi/soar/database"
	"github.com/XiaoMi/soar/env"
)

// initConfig load config from default->file->cmdFlag
func initConfig() {
	// 更新 binary 文件所在路径为 BaseDir
	ex, err := os.Executable()
	if err != nil {
		panic(err)
	}
	common.BaseDir = filepath.Dir(ex)

	for i, c := range os.Args {
		// 如果指定了 -config, 它必须是第一个参数
		if strings.HasPrefix(c, "-config") && i != 1 {
			fmt.Println("-config must be the first arg")
			os.Exit(1)
		}
		// 等号两边请不要加空格
		if c == "=" {
			// -config = soar.yaml not support
			fmt.Println("wrong format, no space between '=', eg: -config=soar.yaml")
			os.Exit(1)
		}
	}

	// 加载配置文件,处理命令行参数
	err = common.ParseConfig(common.ArgConfig())
	// 检查配置文件及命令行参数是否正确
	if common.CheckConfig && err != nil {
		fmt.Println(err.Error())
		os.Exit(1)
	}

	// 更新 HeuristicRules 中与配置相关的文字
	advisor.InitHeuristicRules()

	common.LogIfWarn(err, "")
}

// checkConfig for `-check-config` flag
// if error found return non-zero, no error return zero
func checkConfig() int {
	// TestDSN connection check
	connTest, err := database.NewConnector(common.Config.TestDSN)
	if err != nil {
		fmt.Println("test-dsn:", common.Config.TestDSN.Addr, err.Error())
		return 1
	}
	testVersion, err := connTest.Version()
	if err != nil && !common.Config.TestDSN.Disable {
		fmt.Println("test-dsn:", connTest, err.Error())
		return 1
	}
	if common.Config.Verbose {
		if err == nil {
			fmt.Println("test-dsn", connTest, "Version:", testVersion)
		} else {
			fmt.Println("test-dsn", common.Config.TestDSN)
		}
	}

	if !connTest.HasAllPrivilege() {
		fmt.Printf("test-dsn: %s, need all privileges", common.FormatDSN(common.Config.TestDSN))
		return 1
	}
	// OnlineDSN connection check
	connOnline, err := database.NewConnector(common.Config.OnlineDSN)
	if err != nil {
		fmt.Println("test-dsn:", common.Config.OnlineDSN.Addr, err.Error())
		return 1
	}
	onlineVersion, err := connOnline.Version()
	if err != nil && !common.Config.OnlineDSN.Disable {
		fmt.Println("online-dsn:", connOnline, err.Error())
		return 1
	}
	if common.Config.Verbose {
		if err == nil {
			fmt.Println("online-dsn", connOnline, "Version:", onlineVersion)
		} else {
			fmt.Println("online-dsn", common.Config.OnlineDSN)
		}
	}

	if !connOnline.HasSelectPrivilege() {
		fmt.Printf("online-dsn: %s, need all privileges", common.FormatDSN(common.Config.OnlineDSN))
		return 1
	}
	return 0
}

// helpTools help tools in cmd flags
func helpTools() (isContinue bool, exitCode int) {
	// environment error check, eg. MySQL password error
	if common.CheckConfig {
		return false, checkConfig()
	}
	// 打印 SOAR 版本信息
	if common.PrintVersion {
		common.SoarVersion()
		return false, 0
	}
	// 打印已加载配置的各配置项,检查配置是否生效
	if common.PrintConfig {
		common.PrintConfiguration()
		return false, 0
	}
	// 打印支持启发式建议
	if common.Config.ListHeuristicRules {
		advisor.ListHeuristicRules(advisor.HeuristicRules)
		return false, 0
	}
	// 打印支持的 SQL 重写规则
	if common.Config.ListRewriteRules {
		ast.ListRewriteRules(ast.RewriteRules)
		return false, 0
	}
	// 打印所有的测试 SQL
	if common.Config.ListTestSqls {
		advisor.ListTestSQLs()
		return false, 0
	}
	// 打印支持的 report-type
	if common.Config.ListReportTypes {
		common.ListReportTypes()
		return false, 0
	}

	return true, 0
}

// reportTool tools in report type
func reportTool(sql string, bom []byte) (isContinue bool, exitCode int) {
	switch common.Config.ReportType {
	case "html":
		// HTML 格式输入 CSS 加载
		fmt.Println(common.MarkdownHTMLHeader())
		return true, 0
	case "md2html":
		// markdown2html 转换小工具
		fmt.Println(common.MarkdownHTMLHeader())
		fmt.Println(common.Markdown2HTML(sql))
		return false, 0
	case "explain-digest":
		// 当用户输入为 EXPLAIN 信息,只对 Explain 信息进行分析
		// 注意: 这里只能处理一条 SQL 的 EXPLAIN 信息,用户一次反馈多条 SQL 的 EXPLAIN 信息无法处理
		advisor.DigestExplainText(sql)
		return false, 0
	case "chardet":
		// Get charset of input
		charset := common.CheckCharsetByBOM(bom)
		if charset == "" {
			charset = common.Chardet([]byte(sql))
		}
		fmt.Println(charset)
		return false, 0
	case "remove-comment":
		fmt.Println(database.RemoveSQLComments(sql))
		return false, 0
	default:
		return true, 0
	}
}

// initQuery
func initQuery(query string) string {
	// 读入待优化 SQL ,当配置文件或命令行参数未指定 SQL 时从管道读取
	if query == "" {
		// check stdin is pipe or terminal
		// https://stackoverflow.com/questions/22744443/check-if-there-is-something-to-read-on-stdin-in-golang
		stat, err := os.Stdin.Stat()
		if stat == nil {
			common.Log.Critical("os.Stdin.Stat Error: %v", err)
			os.Exit(1)
		}
		if (stat.Mode() & os.ModeCharDevice) != 0 {
			// stdin is from a terminal
			fmt.Println("Args format error, use --help see how to use it!")
			os.Exit(1)
		}
		// read from pipe
		var data []byte
		data, err = ioutil.ReadAll(os.Stdin)
		if err != nil {
			common.Log.Critical("ioutil.ReadAll Error: %v", err)
		}
		common.Log.Debug("initQuery get query from os.Stdin")
		return string(data)
	}

	if _, err := os.Stat(query); err == nil {
		var data []byte
		data, err = ioutil.ReadFile(query)
		if err != nil {
			common.Log.Critical("ioutil.ReadFile Error: %v", err)
		}
		common.Log.Debug("initQuery get query from file: %s", query)
		return string(data)
	}

	return query
}

func shutdown(vEnv *env.VirtualEnv, rEnv *database.Connector) {
	if common.Config.DropTestTemporary {
		vEnv.CleanUp()
	}
	err := vEnv.Conn.Close()
	common.LogIfWarn(err, "")
	err = rEnv.Conn.Close()
	common.LogIfWarn(err, "")
	os.Exit(0)
}

func verboseInfo() {
	if !common.Config.Verbose {
		return
	}
	// syntax check verbose mode, add output for success!
	if common.Config.OnlySyntaxCheck {
		fmt.Println("Syntax check OK!")
		return
	}
	switch common.Config.ReportType {
	case "markdown":
		if common.Config.TestDSN.Disable || common.Config.OnlineDSN.Disable {
			fmt.Println("MySQL environment verbose info")
			// TestDSN
			if common.Config.TestDSN.Disable {
				fmt.Println("* test-dsn:", common.Config.TestDSN.Addr, "is disable, please check log.")
			}
			// OnlineDSN
			if common.Config.OnlineDSN.Disable {
				fmt.Println("* online-dsn:", common.Config.OnlineDSN.Addr, "is disable, please check log.")
			}
		}
	}
}


================================================
FILE: common/cases.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

// TestSQLs 测试SQL大集合
var TestSQLs []string

func init() {
	// 所有的SQL都要以分号结尾,-list-test-sqls 参数会打印这个 list,以分号结尾可方便测试
	// 如:./soar -list-test-sql | ./soar
	TestSQLs = []string{
		// single equality
		"SELECT * FROM film WHERE length = 86;",    // index(length)
		"SELECT * FROM film WHERE length IS NULL;", // index(length)
		"SELECT * FROM film HAVING title = 'abc';", // 无法使用索引

		// single inequality
		"SELECT * FROM sakila.film WHERE length >= 60;",   // any of <, <=, >=, >; but not <>, !=, IS NOT NULL"
		"SELECT * FROM sakila.film WHERE length >= '60';", // Implicit Conversion
		"SELECT * FROM film WHERE length BETWEEN 60 AND 84;",
		"SELECT * FROM film WHERE title LIKE 'AIR%';", // but not LIKE '%blah'",
		"SELECT * FROM film WHERE title IS NOT NULL;",

		// multiple equalities
		"SELECT * FROM film WHERE length = 114 and title = 'ALABAMA DEVIL';", // index(title,length) or index(length,title)",

		// equality and inequality
		"SELECT * FROM film WHERE length > 100 and title = 'ALABAMA DEVIL';", // index(title, length)",

		// multiple inequality
		"SELECT * FROM film WHERE length > 100 and language_id < 10 and title = 'xyz';", // index(d, b) or index(d, c) 依赖数据",
		"SELECT * FROM film WHERE length > 100 and language_id < 10;",                   // index(b) or index(c)",

		// GROUP BY
		"SELECT release_year, sum(length) FROM film WHERE length = 123 AND language_id = 1 GROUP BY release_year;",  // INDEX(length, language_id, release_year) or INDEX(language_id, length, release_year)",
		"SELECT release_year, sum(length) FROM film WHERE length >= 123 GROUP BY release_year;",                     // INDEX(length)",
		"SELECT release_year, language_id, sum(length) FROM film GROUP BY release_year, language_id;",               // INDEX(release_year, language_id) (no WHERE)",
		"SELECT release_year, sum(length) FROM film WHERE length = 123 GROUP BY release_year,(length+language_id);", // INDEX(length) expression in GROUP BY, so no use including even release_year.",
		"SELECT release_year, sum(film_id) FROM film GROUP BY release_year;",                                        // INDEX(`release_year`)
		"SELECT * FROM address GROUP BY address,district;",                                                          // INDEX(address, district)
		"SELECT title FROM film WHERE ABS(language_id) = 3 GROUP BY title;",                                         // 无法使用索引

		// ORDER BY
		"SELECT language_id FROM film WHERE length = 123 GROUP BY release_year ORDER BY language_id;",            //  INDEX(length, release_year) should have stopped with Step 2b",
		"SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year;",          //  INDEX(length, release_year) the release_year will be used for both GROUP BY and ORDER BY",
		"SELECT * FROM film WHERE length = 123 ORDER BY release_year ASC, language_id DESC;",                     //  INDEX(length) mixture of ASC and DESC.",
		"SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year LIMIT 10;", //  INDEX(length, release_year)",
		"SELECT * FROM film WHERE length = 123 ORDER BY release_year LIMIT 10;",                                  //  INDEX(length, release_year)",
		"SELECT * FROM film ORDER BY release_year LIMIT 10;",                                                     //  不能单独给release_year加索引
		"SELECT film_id FROM film ORDER BY release_year LIMIT 10;",                                               //  TODO: INDEX(release_year),film_id 是主键查询列满足索引覆盖的情况才会使用到 release_year 索引
		"SELECT * FROM film WHERE length > 100 ORDER BY length LIMIT 10;",                                        //  INDEX(length) This "range" is compatible with ORDER BY
		"SELECT * FROM film WHERE length < 100 ORDER BY length LIMIT 10;",                                        //  INDEX(length) also works
		"SELECT * FROM customer WHERE address_id in (224,510) ORDER BY last_name;",                               //  INDEX(address_id)
		"SELECT * FROM film WHERE release_year = 2016 AND length != 1 ORDER BY title;",                           //  INDEX(`release_year`, `length`, `title`)

		// "Covering" Rows
		"SELECT title FROM film WHERE release_year = 1995;",                               //  INDEX(release_year, title)",
		"SELECT title, replacement_cost FROM film WHERE language_id = 5 AND length = 70;", //  INDEX(language_id, length, title, replacement_cos film ), title, replacement_cost顺序无关,language_id, length顺序视散粒度情况.
		"SELECT title FROM film WHERE language_id > 5 AND length > 70;",                   //  INDEX(language_id, length, title) language_id or length first (that's as far as the Algorithm goes), then the other two fields afterwards.

		// equalities and sort
		"SELECT * FROM film WHERE length = 100 and title = 'xyz' ORDER BY release_year;", // 依赖数据特征,index(length, title, release_year) or index(title, length, release_year)需要评估

		// inequality and sort
		"SELECT * FROM film WHERE length > 100 and title = 'xyz' ORDER BY release_year;", // 依赖数据特征, index(title, release_year),index(title, length)需要评估
		"SELECT * FROM film WHERE length > 100 ORDER BY release_year;",                   // 依赖数据特征, index(length),index(release_year)需要评估

		// Join
		// 内连接 INNER JOIN
		// 在mysql中,inner join...on , join...on , 逗号...WHERE ,cross join...on是一样的含义。
		// 但是在标准SQL中,它们并不等价,标准 SQL 中 INNER JOIN 与 ON共同使用, CROSS JOIN用于其他情况。
		// 逗号不支持 on 和 using 语法, 逗号的优先级要低于INNER JOIN, CROSS JOIN, LEFT JOIN
		// ON子句的语法格式为:tb1.col1 = tb2.col2列名可以不同,筛选连接后的结果,两表的对应列值相同才在结果集中。
		// 当模式设计对联接表的列采用了相同的命名样式时,就可以使用 USING 语法来简化 ON 语法

		// join, inner join, cross join等价,优先选择小结果集条件表为驱动表
		// left [outer] join左表为驱动表
		// right [outer] join右表为驱动表
		// 驱动表连接列如果没其他条件可以不考虑加索引,反正是需要foreach
		// 被驱动表连接列需要加索引。即:left [outer] join的右表连接列需要加索引,right [outer] join的左表连接列需要加索引,inner join结果集较大表的连接列需要加索引
		// 其他索引添加算法与单表索引优化算法相同
		// 总结:被驱动表列需要添加索引
		// 建议:将无索引的表通常作为驱动表

		"SELECT * FROM city a INNER JOIN country b ON a.country_id=b.country_id;",

		// 左外连接 LEFT [OUTER] JOIN
		"SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id;",

		// 右外连接 RIGHT [OUTER] JOIN
		"SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;",

		// 左连接
		"SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;",

		// 右连接
		"SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL;",

		// 全连接 FULL JOIN 因为在mysql中并不支持,所以我们用union实现
		"SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id " +
			"UNION " +
			"SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id;",

		// 两张表中不共同满足的数据集
		"SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL " +
			"UNION " +
			"SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL;",

		// NATURAL JOIN 默认是同名字段完全匹配的INNER JOIN
		"SELECT country_id, last_update FROM city NATURAL JOIN country;",

		// NATURAL LEFT JOIN
		"SELECT country_id, last_update FROM city NATURAL LEFT JOIN country;",

		// NATURAL RIGHT JOIN
		"SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country;",

		// STRAIGHT_JOIN 实际上与内连接 INNER JOIN 表现完全一致,
		// 不同的是使用了 STRAIGHT_JOIN 后指定表载入的顺序,city 先于 country 载入
		"SELECT a.country_id, a.last_update FROM city a STRAIGHT_JOIN country b ON a.country_id=b.country_id;",

		// SEMI JOIN
		// 半连接: 当一张表在另一张表找到匹配的记录之后,半连接(semi-join)返回第一张表中的记录。
		// 与条件连接相反,即使在右节点中找到几条匹配的记录,左节点的表也只会返回一条记录。
		// 另外,右节点的表一条记录也不会返回。半连接通常使用 IN 或 EXISTS 作为连接条件
		"SELECT a.address, a.postal_code FROM sakila.address a WHERE a.city_id IN  (SELECT c.city_id FROM sakila.city c);",

		// Delayed Join
		// https://www.percona.com/blog/2007/04/06/using-delayed-join-to-optimize-count-and-limit-queries/
		`SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I.city_id = city.city_id) JOIN country ON (country.country_id = city.country_id) ORDER BY city DESC;`,

		// DELETE
		"DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1;",
		"DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL;",
		"DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;",
		"DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id;",
		"DELETE FROM film WHERE length > 100;",

		// UPDATE
		"UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;",
		"UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10;",
		"UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10;",
		"UPDATE film SET length = 10 WHERE language_id = 20;",

		// INSERT
		"INSERT INTO city (country_id) SELECT country_id FROM country;",
		"INSERT INTO city (country_id) VALUES (1),(2),(3);",
		"INSERT INTO city (country_id) VALUES (10);",
		"INSERT INTO city (country_id) SELECT 10 FROM DUAL;",

		// REPLACE
		"REPLACE INTO city (country_id) SELECT country_id FROM country;",
		"REPLACE INTO city (country_id) VALUES (1),(2),(3);",
		"REPLACE INTO city (country_id) VALUES (10);",
		"REPLACE INTO city (country_id) SELECT 10 FROM DUAL;",

		// DEPTH
		"SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM  film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film;",

		// SUBQUERY
		"SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1);",
		// "SELECT COUNT(*) /* no hint */ FROM t2 WHERE NOT EXISTS (SELECT * FROM t3 WHERE ROW(5 * t2.s1, 77) = (SELECT 50, 11 * s1 FROM t4 UNION SELECT 50, 77 FROM (SELECT * FROM t5) AS t5 ) ) ;",
		"SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;",
		"SELECT * FROM (SELECT * FROM actor WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE') t WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE' GROUP BY first_name;",
		"SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id;",
		"SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id WHERE o.country_id is null union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id WHERE i.city_id is null;",
		"SELECT first_name,last_name,email FROM customer STRAIGHT_JOIN address ON customer.address_id=address.address_id;",
		"SELECT ID,name FROM (SELECT address FROM customer_list WHERE SID=1 order by phone limit 50,10) a JOIN customer_list l ON (a.address=l.address) JOIN city c ON (c.city=l.city) order by phone desc;",

		// function in conditions
		"SELECT * FROM film WHERE date(last_update)='2006-02-15';",
		"SELECT last_update FROM film GROUP BY date(last_update);",
		"SELECT last_update FROM film order by date(last_update);",

		// CLA.004
		"SELECT description FROM film WHERE description IN('NEWS','asd') GROUP BY description;",

		// ALTER TABLE ADD INDEX
		// 已经存在索引的列应该提醒索引已存在
		"alter table address add index idx_city_id(city_id);",
		"alter table inventory add index `idx_store_film` (`store_id`,`film_id`);",
		"alter table inventory add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`);",

		// https://github.com/XiaoMi/soar/issues/47
		`SELECT	DATE_FORMAT(t.last_update, '%Y-%m-%d'),	COUNT(DISTINCT (t.city))	FROM city t WHERE t.last_update > '2018-10-22 00:00:00'	AND t.city LIKE '%Chrome%'	AND t.city = 'eip' GROUP BY DATE_FORMAT(t.last_update, '%Y-%m-%d') ORDER BY DATE_FORMAT(t.last_update, '%Y-%m-%d');`,
		// https://github.com/XiaoMi/soar/issues/17
		"create table hello.t (id int unsigned);",

		// https://github.com/XiaoMi/soar/issues/146
		"select * from tb where data >= '';",

		// https://github.com/XiaoMi/soar/issues/163
		"alter table tb alter column id drop default;",

		// explain extra info "Select tables optimized away"
		"select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film where last_update > '2016-03-27 02:01:01') as d;",
		"select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film) as d;",
	}
}


================================================
FILE: common/chardet.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"github.com/kr/pretty"
	"github.com/saintfish/chardet"
)

// Chardet get best match charset
func Chardet(buf []byte) string {
	// check character set by file BOM
	charset := CheckCharsetByBOM(buf)
	if charset != "" {
		return charset
	}

	// use chardet pkg check file charset
	charset = "unknown"
	var confidence int
	detector := chardet.NewTextDetector()

	// detector.DetectBest is unstable
	// when the confidence value are equally, the best detect charset will be random
	result, err := detector.DetectAll(buf)
	if err != nil {
		return charset
	}
	Log.Debug("Chardet DetectAll Result: %s", pretty.Sprint(result))

	// SOAR's main user speak Chinese, GB-18030, UTF-8 are higher suggested
	for _, r := range result {
		if confidence > r.Confidence && r.Confidence != 0 {
			return charset
		}
		confidence = r.Confidence
		if r.Charset == "GB-18030" || r.Charset == "UTF-8" {
			return r.Charset
		}
		charset = r.Charset
	}
	return charset
}

// CheckCharsetByBOM ref: https://en.wikipedia.org/wiki/Byte_order_mark
func CheckCharsetByBOM(buf []byte) string {
	// TODO: There are many kind of BOM
	// UTF-8	EF BB BF
	if len(buf) >= 3 {
		if buf[0] == 0xef && buf[1] == 0xbb && buf[2] == 0xbf {
			return "UTF-8"
		}
	}
	// GB-18030	84 31 95 33
	if len(buf) >= 4 {
		if buf[0] == 0x84 && buf[1] == 0x31 && buf[2] == 0x95 && buf[3] == 0x33 {
			return "GB-18030"
		}
	}
	return ""
}

// RemoveBOM remove bom from file
func RemoveBOM(buf []byte) (string, []byte) {
	// ef bb bf, UTF-8 BOM
	if len(buf) > 3 {
		if buf[0] == 0xef && buf[1] == 0xbb && buf[2] == 0xbf {
			return string(buf[3:]), buf[:3]
		}
	}
	// ff fe, UTF-16 (LE) BOM
	if len(buf) > 2 {
		if buf[0] == 0xff && buf[1] == 0xfe {
			return string(buf[2:]), buf[:2]
		}
	}
	return string(buf), []byte{}
}


================================================
FILE: common/chardet_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"fmt"
	"io/ioutil"
	"testing"
)

func TestChardet(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	charsets := []string{
		"GB-18030",
		"UTF-8",
	}
	for _, c := range charsets {
		fileName := DevPath + "/common/testdata/chardet_" + c + ".txt"
		buf, err := ioutil.ReadFile(fileName)
		if err != nil {
			t.Errorf("ioutil.ReadFile %s, Error: %s", fileName, err.Error())
		}
		name := Chardet(buf)
		if name != c {
			t.Errorf("file: %s, Want: %s, Get: %s", fileName, c, name)
		}
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestRemoveBOM(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	fileName := DevPath + "/common/testdata/UTF-8.bom.sql"
	buf, err := ioutil.ReadFile(fileName)
	if err != nil {
		t.Errorf("ioutil.ReadFile %s, Error: %s", fileName, err.Error())
	}
	GoldenDiff(func() {
		fmt.Println(RemoveBOM(buf))
	}, t.Name(), update)
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestCheckCharsetByBOM(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	fileName := DevPath + "/common/testdata/UTF-8.bom.sql"
	buf, err := ioutil.ReadFile(fileName)
	if err != nil {
		t.Errorf("ioutil.ReadFile %s, Error: %s", fileName, err.Error())
	}

	if CheckCharsetByBOM(buf) != "UTF-8" {
		t.Errorf("checkCharsetByBOM Want: UTF-8, Get: %s", CheckCharsetByBOM(buf))
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}


================================================
FILE: common/config.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"bufio"
	"bytes"
	"encoding/json"
	"flag"
	"fmt"
	"io"
	"io/ioutil"
	"os"
	"path/filepath"
	"regexp"
	"runtime"
	"strings"
	"time"

	"github.com/go-sql-driver/mysql"
	yaml "gopkg.in/yaml.v2"
)

var (
	// BlackList 黑名单中的SQL不会被评审
	BlackList []string
	// PrintConfig -print-config
	PrintConfig bool
	// PrintVersion -print-config
	PrintVersion bool
	// CheckConfig -check-config
	CheckConfig bool
	// 防止 readCmdFlags 函数重入
	hasParsed bool
)

// Configuration 配置文件定义结构体
type Configuration struct {
	// +++++++++++++++测试环境+++++++++++++++++
	OnlineDSN               *Dsn   `yaml:"online-dsn"`                // 线上环境数据库配置
	TestDSN                 *Dsn   `yaml:"test-dsn"`                  // 测试环境数据库配置
	AllowOnlineAsTest       bool   `yaml:"allow-online-as-test"`      // 允许 Online 环境也可以当作 Test 环境
	DisableVersionCheck     bool   `yaml:"disable-version-check"`     // 是否禁用环境检测,开启后表示允许测试环境版本低于线上环境 不建议开启,可能会导致语句执行异常
	DropTestTemporary       bool   `yaml:"drop-test-temporary"`       // 是否清理Test环境产生的临时库表
	CleanupTestDatabase     bool   `yaml:"cleanup-test-database"`     // 清理残余的测试数据库(程序异常退出或未开启drop-test-temporary)  issue #48
	OnlySyntaxCheck         bool   `yaml:"only-syntax-check"`         // 只做语法检查不输出优化建议
	SamplingStatisticTarget int    `yaml:"sampling-statistic-target"` // 数据采样因子,对应 PostgreSQL 的 default_statistics_target
	Sampling                bool   `yaml:"sampling"`                  // 数据采样开关
	SamplingCondition       string `yaml:"sampling-condition"`        // 指定采样条件,如:WHERE xxx LIMIT xxx;
	Profiling               bool   `yaml:"profiling"`                 // 在开启数据采样的情况下,在测试环境执行进行profile
	Trace                   bool   `yaml:"trace"`                     // 在开启数据采样的情况下,在测试环境执行进行Trace
	Explain                 bool   `yaml:"explain"`                   // Explain开关
	Delimiter               string `yaml:"delimiter"`                 // SQL分隔符

	// +++++++++++++++日志相关+++++++++++++++++
	// 日志级别,这里使用了 beego 的 log 包
	// [0:Emergency, 1:Alert, 2:Critical, 3:Error, 4:Warning, 5:Notice, 6:Informational, 7:Debug]
	LogLevel int `yaml:"log-level"`
	// 日志输出位置,默认日志输出到控制台
	// 目前只支持['console', 'file']两种形式,如非console形式这里需要指定文件的路径,可以是相对路径
	LogOutput string `yaml:"log-output"`
	// 优化建议输出格式,目前支持: json, text, markdown格式,如指定其他格式会给 pretty.Println 的输出
	ReportType string `yaml:"report-type"`
	// 当 ReportType 为 html 格式时使用的 css 风格,如不指定会提供一个默认风格。CSS可 以是本地文件,也可以是一个URL
	ReportCSS string `yaml:"report-css"`
	// 当 ReportType 为 html 格式时使用的 javascript 脚本,如不指定默认会加载SQL pretty 使用的 javascript。像CSS一样可以是本地文件,也可以是一个URL
	ReportJavascript string `yaml:"report-javascript"`
	// 当ReportType 为 html 格式时,HTML 的 title
	ReportTitle string `yaml:"report-title"`
	// blackfriday markdown2html config
	MarkdownExtensions int `yaml:"markdown-extensions"` // markdown 转 html 支持的扩展包, 参考blackfriday
	MarkdownHTMLFlags  int `yaml:"markdown-html-flags"` // markdown 转 html 支持的 flag, 参考blackfriday, default 0

	// ++++++++++++++优化建议相关++++++++++++++
	IgnoreRules          []string `yaml:"ignore-rules"`              // 忽略的优化建议规则
	RewriteRules         []string `yaml:"rewrite-rules"`             // 生效的重写规则
	BlackList            string   `yaml:"blacklist"`                 // blacklist 中的 SQL 不会被评审,可以是指纹,也可以是正则
	MaxJoinTableCount    int      `yaml:"max-join-table-count"`      // 单条 SQL 中 JOIN 表的最大数量
	MaxGroupByColsCount  int      `yaml:"max-group-by-cols-count"`   // 单条 SQL 中 GroupBy 包含列的最大数量
	MaxDistinctCount     int      `yaml:"max-distinct-count"`        // 单条 SQL 中 Distinct 的最大数量
	MaxIdxColsCount      int      `yaml:"max-index-cols-count"`      // 复合索引中包含列的最大数量
	MaxTextColsCount     int      `yaml:"max-text-cols-count"`       // 表中含有的 text/blob 列的最大数量
	MaxTotalRows         uint64   `yaml:"max-total-rows"`            // 计算散粒度时,当数据行数大于 MaxTotalRows 即开启数据库保护模式,散粒度返回结果可信度下降
	MaxQueryCost         int64    `yaml:"max-query-cost"`            // last_query_cost 超过该值时将给予警告
	SpaghettiQueryLength int      `yaml:"spaghetti-query-length"`    // SQL最大长度警告,超过该长度会给警告
	AllowDropIndex       bool     `yaml:"allow-drop-index"`          // 允许输出删除重复索引的建议
	MaxInCount           int      `yaml:"max-in-count"`              // IN()最大数量
	MaxIdxBytesPerColumn int      `yaml:"max-index-bytes-percolumn"` // 索引中单列最大字节数,默认767
	MaxIdxBytes          int      `yaml:"max-index-bytes"`           // 索引总长度限制,默认3072
	AllowCharsets        []string `yaml:"allow-charsets"`            // 允许使用的 DEFAULT CHARSET
	AllowCollates        []string `yaml:"allow-collates"`            // 允许使用的 COLLATE
	AllowEngines         []string `yaml:"allow-engines"`             // 允许使用的存储引擎
	MaxIdxCount          int      `yaml:"max-index-count"`           // 单张表允许最多索引数
	MaxColCount          int      `yaml:"max-column-count"`          // 单张表允许最大列数
	MaxValueCount        int      `yaml:"max-value-count"`           // INSERT/REPLACE 单次允许批量写入的行数
	IdxPrefix            string   `yaml:"index-prefix"`              // 普通索引建议使用的前缀
	UkPrefix             string   `yaml:"unique-key-prefix"`         // 唯一键建议使用的前缀
	MaxSubqueryDepth     int      `yaml:"max-subquery-depth"`        // 子查询最大尝试
	MaxVarcharLength     int      `yaml:"max-varchar-length"`        // varchar最大长度
	ColumnNotAllowType   []string `yaml:"column-not-allow-type"`     // 字段不允许使用的数据类型
	MinCardinality       float64  `yaml:"min-cardinality"`           // 添加索引散粒度阈值,范围 0~100

	// ++++++++++++++EXPLAIN检查项+++++++++++++
	ExplainSQLReportType   string   `yaml:"explain-sql-report-type"`  // EXPLAIN markdown 格式输出 SQL 样式,支持 sample, fingerprint, pretty 等
	ExplainType            string   `yaml:"explain-type"`             // EXPLAIN方式 [traditional, extended, partitions]
	ExplainFormat          string   `yaml:"explain-format"`           // FORMAT=[json, traditional]
	ExplainWarnSelectType  []string `yaml:"explain-warn-select-type"` // 哪些 select_type 不建议使用
	ExplainWarnAccessType  []string `yaml:"explain-warn-access-type"` // 哪些 access type 不建议使用
	ExplainMaxKeyLength    int      `yaml:"explain-max-keys"`         // 最大 key_len
	ExplainMinPossibleKeys int      `yaml:"explain-min-keys"`         // 最小 possible_keys 警告
	ExplainMaxRows         int64    `yaml:"explain-max-rows"`         // 最大扫描行数警告
	ExplainWarnExtra       []string `yaml:"explain-warn-extra"`       // 哪些 extra 信息会给警告
	ExplainMaxFiltered     float64  `yaml:"explain-max-filtered"`     // filtered 大于该配置给出警告
	ExplainWarnScalability []string `yaml:"explain-warn-scalability"` // 复杂度警告名单
	ShowWarnings           bool     `yaml:"show-warnings"`            // explain extended with show warnings
	ShowLastQueryCost      bool     `yaml:"show-last-query-cost"`     // switch with show status like 'last_query_cost'
	// ++++++++++++++其他配置项+++++++++++++++
	Query              string `yaml:"query"`                 // 需要进行调优的SQL
	ListHeuristicRules bool   `yaml:"list-heuristic-rules"`  // 打印支持的评审规则列表
	ListRewriteRules   bool   `yaml:"list-rewrite-rules"`    // 打印重写规则
	ListTestSqls       bool   `yaml:"list-test-sqls"`        // 打印测试case用于测试
	ListReportTypes    bool   `yaml:"list-report-types"`     // 打印支持的报告输出类型
	Verbose            bool   `yaml:"verbose"`               // verbose模式,会多输出一些信息
	DryRun             bool   `yaml:"dry-run"`               // 是否在预演环境执行
	MaxPrettySQLLength int    `yaml:"max-pretty-sql-length"` // 超出该长度的SQL会转换成指纹输出
}

// Config 默认设置
var Config = &Configuration{
	OnlineDSN:               newDSN(nil),
	TestDSN:                 newDSN(nil),
	AllowOnlineAsTest:       false,
	DropTestTemporary:       true,
	CleanupTestDatabase:     false,
	DryRun:                  true,
	OnlySyntaxCheck:         false,
	SamplingStatisticTarget: 100,
	Sampling:                false,
	Profiling:               false,
	Trace:                   false,
	Explain:                 true,
	Delimiter:               ";",
	MinCardinality:          0,

	MaxJoinTableCount:    5,
	MaxGroupByColsCount:  5,
	MaxDistinctCount:     5,
	MaxIdxColsCount:      5,
	MaxTextColsCount:     2,
	MaxIdxBytesPerColumn: 767,
	MaxIdxBytes:          3072,
	MaxTotalRows:         9999999,
	MaxQueryCost:         9999,
	SpaghettiQueryLength: 2048,
	AllowDropIndex:       false,
	LogLevel:             3,
	LogOutput:            "soar.log",
	ReportType:           "markdown",
	ReportCSS:            "",
	ReportJavascript:     "",
	ReportTitle:          "SQL优化分析报告",
	BlackList:            "",
	AllowCharsets:        []string{"utf8", "utf8mb4"},
	AllowCollates:        []string{},
	AllowEngines:         []string{"innodb"},
	MaxIdxCount:          10,
	MaxColCount:          40,
	MaxValueCount:        100,
	MaxInCount:           10,
	IdxPrefix:            "idx_",
	UkPrefix:             "uk_",
	MaxSubqueryDepth:     5,
	MaxVarcharLength:     1024,
	ColumnNotAllowType:   []string{"boolean"},

	MarkdownExtensions: 94,
	MarkdownHTMLFlags:  0,

	ExplainSQLReportType:   "pretty",
	ExplainType:            "extended",
	ExplainFormat:          "traditional",
	ExplainWarnSelectType:  []string{""},
	ExplainWarnAccessType:  []string{"ALL"},
	ExplainMaxKeyLength:    3,
	ExplainMinPossibleKeys: 0,
	ExplainMaxRows:         10000,
	ExplainWarnExtra:       []string{"Using temporary", "Using filesort"},
	ExplainMaxFiltered:     100.0,
	ExplainWarnScalability: []string{"O(n)"},
	ShowWarnings:           false,
	ShowLastQueryCost:      false,

	IgnoreRules: []string{
		"COL.011",
	},
	RewriteRules: []string{
		"delimiter",
		"orderbynull",
		"groupbyconst",
		"dmlorderby",
		"having",
		"star2columns",
		"insertcolumns",
		"distinctstar",
	},

	ListHeuristicRules: false,
	ListRewriteRules:   false,
	ListTestSqls:       false,
	ListReportTypes:    false,
	MaxPrettySQLLength: 1024,
}

// Dsn Data source name
type Dsn struct {
	User             string            `yaml:"user"`               // Usernames
	Password         string            `yaml:"password"`           // Password (requires User)
	Net              string            `yaml:"net"`                // Network type
	Addr             string            `yaml:"addr"`               // Network address (requires Net)
	Schema           string            `yaml:"schema"`             // Database name
	Charset          string            `yaml:"charset"`            // SET NAMES charset
	Collation        string            `yaml:"collation"`          // Connection collation
	Loc              string            `yaml:"loc"`                // Location for time.Time values
	TLS              string            `yaml:"tls"`                // TLS configuration name
	ServerPubKey     string            `yaml:"server-public-key"`  // Server public key name
	MaxAllowedPacket int               `yaml:"max-allowed-packet"` // Max packet size allowed
	Params           map[string]string `yaml:"params"`             // Other Connection parameters, `SET param=val`, `SET NAMES charset`
	Timeout          string            `yaml:"timeout"`            // Dial timeout
	ReadTimeout      string            `yaml:"read-timeout"`       // I/O read timeout
	WriteTimeout     string            `yaml:"write-timeout"`      // I/O write timeout

	AllowNativePasswords bool `yaml:"allow-native-passwords"` // Allows the native password authentication method
	AllowOldPasswords    bool `yaml:"allow-old-passwords"`    // Allows the old insecure password method

	Disable bool `yaml:"disable"`
	Version int  `yaml:"-"` // 版本自动检查,不可配置
}

// newDSN create default Dsn struct
func newDSN(cfg *mysql.Config) *Dsn {
	dsn := &Dsn{
		Net:                  "tcp",
		Schema:               "information_schema",
		Charset:              "utf8",
		Timeout:              "3s",
		AllowNativePasswords: true,
		Params:               make(map[string]string),
		MaxAllowedPacket:     4 << 20, // 4 MiB

		// Disable: true,
		Version: 99999,
	}
	if cfg == nil {
		return dsn
	}
	dsn.User = cfg.User
	dsn.Password = cfg.Passwd
	dsn.Net = cfg.Net
	dsn.Addr = cfg.Addr
	dsn.Schema = cfg.DBName
	dsn.Params = make(map[string]string)
	for k, v := range cfg.Params {
		dsn.Params[k] = v
	}
	if _, ok := cfg.Params["charset"]; ok {
		dsn.Charset = cfg.Params["charset"]
	}
	dsn.Collation = cfg.Collation
	dsn.Loc = cfg.Loc.String()
	dsn.MaxAllowedPacket = cfg.MaxAllowedPacket
	dsn.ServerPubKey = cfg.ServerPubKey
	dsn.TLS = cfg.TLSConfig
	dsn.Timeout = cfg.Timeout.String()
	dsn.ReadTimeout = cfg.ReadTimeout.String()
	dsn.WriteTimeout = cfg.WriteTimeout.String()
	dsn.AllowNativePasswords = cfg.AllowNativePasswords
	dsn.AllowOldPasswords = cfg.AllowOldPasswords
	return dsn
}

// newMySQLConfig convert Dsn to go-sql-drive Config
func (env *Dsn) newMySQLConfig() (*mysql.Config, error) {
	var err error
	dsn := mysql.NewConfig()

	dsn.User = env.User
	dsn.Passwd = env.Password
	dsn.Net = env.Net
	dsn.Addr = env.Addr
	dsn.DBName = env.Schema
	dsn.Params = make(map[string]string)
	for k, v := range env.Params {
		dsn.Params[k] = v
	}
	dsn.Params["charset"] = env.Charset
	dsn.Collation = env.Collation
	dsn.Loc, err = time.LoadLocation(env.Loc)
	if err != nil {
		return nil, err
	}
	dsn.MaxAllowedPacket = env.MaxAllowedPacket
	dsn.ServerPubKey = env.ServerPubKey
	dsn.TLSConfig = env.TLS
	if env.Timeout != "" {
		dsn.Timeout, err = time.ParseDuration(env.Timeout)
		LogIfError(err, "timeout: '%s'", env.Timeout)
	}
	if env.WriteTimeout != "" {
		dsn.WriteTimeout, err = time.ParseDuration(env.WriteTimeout)
		LogIfError(err, "writeTimeout: '%s'", env.WriteTimeout)
	}
	if env.ReadTimeout != "" {
		dsn.ReadTimeout, err = time.ParseDuration(env.ReadTimeout)
		LogIfError(err, "readTimeout: '%s'", env.ReadTimeout)
	}
	dsn.AllowNativePasswords = env.AllowNativePasswords
	dsn.AllowOldPasswords = env.AllowOldPasswords
	return dsn, err
}

// 解析命令行DSN输入
func parseDSN(odbc string, d *Dsn) *Dsn {
	dsn := newDSN(nil)
	var addr, user, password, schema, charset, timeout string
	if odbc == FormatDSN(d) {
		return d
	}

	if d != nil {
		// 原来有个判断,后来判断条件被删除了就导致第一次addr无论如何都会被修改。所以这边先注释掉
		// addr = d.Addr
		user = d.User
		password = d.Password
		schema = d.Schema
		charset = d.Charset
		timeout = d.Timeout
	}

	// 设置为空表示禁用环境
	odbc = strings.TrimSpace(odbc)
	if odbc == "" {
		return &Dsn{Disable: true}
	}

	var userInfo, hostInfo, query string

	// DSN 格式匹配
	if res := regexp.MustCompile(`^(.*)@(.*?)/(.*?)($|\?)(.*)`).FindStringSubmatch(odbc); len(res) > 5 {
		// userInfo@hostInfo/database
		userInfo = res[1]
		hostInfo = res[2]
		schema = res[3]
		query = res[5]
	} else if res := regexp.MustCompile(`^(.*)/(.*?)($|\?)(.*)`).FindStringSubmatch(odbc); len(res) > 4 {
		// hostInfo/database
		hostInfo = res[1]
		schema = res[2]
		query = res[4]
	} else if res := regexp.MustCompile(`^(.*)@(.*?)($|\?)(.*)`).FindStringSubmatch(odbc); len(res) > 4 {
		// userInfo@hostInfo
		userInfo = res[1]
		hostInfo = res[2]
		query = res[4]
	} else if res := regexp.MustCompile(`^(.*?)($|\?)(.*)`).FindStringSubmatch(odbc); len(res) > 3 {
		// hostInfo
		hostInfo = res[1]
		query = res[3]
	}

	// 解析用户信息
	if userInfo != "" {
		user = strings.Split(userInfo, ":")[0]
		// 防止密码中含有与用户名相同的字符, 所以用正则替换, 剩下的就是密码
		password = strings.TrimLeft(regexp.MustCompile("^"+user).ReplaceAllString(userInfo, ""), ":")
	}

	// 解析主机信息
	host := strings.Split(hostInfo, ":")[0]
	port := strings.TrimLeft(strings.Replace(hostInfo, host, "", 1), ":")
	if host == "" {
		host = "127.0.0.1"
	}
	if port == "" {
		port = "3306"
	}
	addr = host + ":" + port

	// 解析查询字符串
	if query != "" {
		params := strings.Split(query, "&")
		for _, f := range params {
			attr := strings.Split(f, "=")
			if len(attr) > 1 {
				arg := strings.TrimSpace(attr[0])
				val := strings.TrimSpace(attr[1])
				switch arg {
				case "charset":
					charset = val
				case "timeout":
					timeout = val
				default:
				}
			}
		}
	}

	// 默认用information_schema库
	if schema == "" {
		schema = "information_schema"
	}

	// 默认 utf8 使用字符集
	if charset == "" {
		charset = "utf8"
	}

	// 默认连接数据库超时时间 3s
	if timeout == "" {
		timeout = "3s"
	}

	dsn.Addr = addr
	dsn.User = user
	dsn.Password = password
	dsn.Schema = schema
	dsn.Charset = charset
	dsn.Timeout = timeout
	return dsn
}

// ParseDSN compatible with old version soar < 0.11.0
func ParseDSN(odbc string, d *Dsn) *Dsn {
	cfg, err := mysql.ParseDSN(odbc)
	if err != nil {
		// Log.Debug("go-sql-driver/mysql.ParseDSN Error: %s, DSN: %s, try to use old version parseDSN", err.Error(), odbc)
		return parseDSN(odbc, d)
	}
	return newDSN(cfg)
}

// FormatDSN 格式化打印DSN
func FormatDSN(env *Dsn) string {
	if env == nil || env.Disable {
		return ""
	}
	dsn, err := env.newMySQLConfig()
	if err != nil {
		return ""
	}
	return dsn.FormatDSN()
}

// SoarVersion soar version information
func SoarVersion() {
	fmt.Println("Version:", Version)
	fmt.Println("Branch:", Branch)
	fmt.Println("Compile:", Compile)
	fmt.Println("GitDirty:", GitDirty)
}

// 因为vitess sqlparser 使用了 glog 中也会使用 flag,为了不让用户困扰我们单独写一个 usage
func usage() {
	regPwd := regexp.MustCompile(`:.*@`)
	vitessHelp := []string{
		"-alsologtostderr",
		"log to standard error as well as files",
		"-log_backtrace_at value",
		"when logging hits line file:N, emit a stack trace",
		"-log_dir string",
		"If non-empty, write log files in this directory",
		"-logtostderr",
		"log to standard error instead of files",
		"-sql-max-length-errors int",
		"truncate queries in error logs to the given length (default unlimited)",
		"-sql-max-length-ui int",
		"truncate queries in debug UIs to the given length (default 512) (default 512)",
		"-stderrthreshold value",
		"logs at or above this threshold go to stderr",
		"-v value",
		"log level for V logs",
		"-vmodule value",
		"comma-separated list of pattern=N settings for file-filtered logging",
	}

	// io redirect
	restoreStdout := os.Stdout
	restoreStderr := os.Stderr
	stdin, stdout, _ := os.Pipe()
	os.Stderr = stdout
	os.Stdout = stdout

	flag.PrintDefaults()

	// copy the output in a separate goroutine so printing can't block indefinitely
	outC := make(chan string)
	go func() {
		var buf bytes.Buffer
		_, err := io.Copy(&buf, stdin)
		if err != nil {
			fmt.Println(err.Error())
		}
		outC <- buf.String()
	}()

	// back to normal state
	stdout.Close()
	os.Stdout = restoreStdout // restoring the real stderr
	os.Stderr = restoreStderr

	fmt.Printf("Usage of %s:\n", os.Args[0])
	// reading our temp stdout
	out := <-outC
	for _, line := range strings.Split(out, "\n") {
		found := false
		for _, ignore := range vitessHelp {
			if strings.TrimSpace(line) == strings.TrimSpace(ignore) {
				found = true
			}
			if regPwd.MatchString(line) && !Config.Verbose {
				line = regPwd.ReplaceAllString(line, ":********@")
			}
		}
		if !found {
			fmt.Println(line)
		}
	}
}

// PrintConfiguration for `-print-config` flag
func PrintConfiguration() {
	// 打印配置的时候密码不显示
	if !Config.Verbose {
		Config.OnlineDSN.Password = "********"
		Config.TestDSN.Password = "********"
	}
	data, _ := yaml.Marshal(Config)
	fmt.Print(string(data))
}

// 加载配置文件
func (conf *Configuration) readConfigFile(path string) error {
	configFile, err := os.Open(path)
	if err != nil {
		Log.Warning("readConfigFile(%s) os.Open failed: %v", path, err)
		return err
	}
	defer configFile.Close()

	content, err := ioutil.ReadAll(configFile)
	if err != nil {
		Log.Warning("readConfigFile(%s) ioutil.ReadAll failed: %v", path, err)
		return err
	}

	err = yaml.Unmarshal(content, Config)
	if err != nil {
		Log.Warning("readConfigFile(%s) yaml.Unmarshal failed: %v", path, err)
		return err
	}
	return nil
}

// 从命令行参数读配置
func readCmdFlags() error {
	if hasParsed {
		Log.Debug("Skip read cmd flags.")
		return nil
	}

	_ = flag.String("config", "", "Config file path")
	// +++++++++++++++测试环境+++++++++++++++++
	onlineDSN := flag.String("online-dsn", FormatDSN(Config.OnlineDSN), "OnlineDSN, 线上环境数据库配置, username:password@tcp(ip:port)/schema")
	testDSN := flag.String("test-dsn", FormatDSN(Config.TestDSN), "TestDSN, 测试环境数据库配置, username:password@tcp(ip:port)/schema")
	allowOnlineAsTest := flag.Bool("allow-online-as-test", Config.AllowOnlineAsTest, "AllowOnlineAsTest, 允许线上环境也可以当作测试环境")
	dropTestTemporary := flag.Bool("drop-test-temporary", Config.DropTestTemporary, "DropTestTemporary, 是否清理测试环境产生的临时库表")
	cleanupTestDatabase := flag.Bool("cleanup-test-database", Config.CleanupTestDatabase, "单次运行清理历史1小时前残余的测试库。")
	onlySyntaxCheck := flag.Bool("only-syntax-check", Config.OnlySyntaxCheck, "OnlySyntaxCheck, 只做语法检查不输出优化建议")
	profiling := flag.Bool("profiling", Config.Profiling, "Profiling, 开启数据采样的情况下在测试环境执行Profile")
	trace := flag.Bool("trace", Config.Trace, "Trace, 开启数据采样的情况下在测试环境执行Trace")
	explain := flag.Bool("explain", Config.Explain, "Explain, 是否开启Explain执行计划分析")
	sampling := flag.Bool("sampling", Config.Sampling, "Sampling, 数据采样开关")
	samplingStatisticTarget := flag.Int("sampling-statistic-target", Config.SamplingStatisticTarget, "SamplingStatisticTarget, 数据采样因子,对应 PostgreSQL 的 default_statistics_target")
	samplingCondition := flag.String("sampling-condition", Config.SamplingCondition, "SamplingCondition, 数据采样条件,如: WHERE xxx LIMIT xxx")
	delimiter := flag.String("delimiter", Config.Delimiter, "Delimiter, SQL分隔符")
	minCardinality := flag.Float64("min-cardinality", Config.MinCardinality, "MinCardinality,索引列散粒度最低阈值,散粒度低于该值的列不添加索引,建议范围0.0 ~ 100.0")
	// +++++++++++++++日志相关+++++++++++++++++
	logLevel := flag.Int("log-level", Config.LogLevel, "LogLevel, 日志级别, [0:Emergency, 1:Alert, 2:Critical, 3:Error, 4:Warning, 5:Notice, 6:Informational, 7:Debug]")
	logOutput := flag.String("log-output", Config.LogOutput, "LogOutput, 日志输出位置")
	reportType := flag.String("report-type", Config.ReportType, "ReportType, 优化建议输出格式,目前支持: json, text, markdown, html等")
	reportCSS := flag.String("report-css", Config.ReportCSS, "ReportCSS, 当 ReportType 为 html 格式时使用的 css 风格,如不指定会提供一个默认风格。CSS可以是本地文件,也可以是一个URL")
	reportJavascript := flag.String("report-javascript", Config.ReportJavascript, "ReportJavascript, 当 ReportType 为 html 格式时使用的javascript脚本,如不指定默认会加载SQL pretty 使用的 javascript。像CSS一样可以是本地文件,也可以是一个URL")
	reportTitle := flag.String("report-title", Config.ReportTitle, "ReportTitle, 当 ReportType 为 html 格式时,HTML 的 title")
	// +++++++++++++++markdown+++++++++++++++++
	markdownExtensions := flag.Int("markdown-extensions", Config.MarkdownExtensions, "MarkdownExtensions, markdown 转 html支持的扩展包, 参考blackfriday")
	markdownHTMLFlags := flag.Int("markdown-html-flags", Config.MarkdownHTMLFlags, "MarkdownHTMLFlags, markdown 转 html 支持的 flag, 参考blackfriday")
	// ++++++++++++++优化建议相关++++++++++++++
	ignoreRules := flag.String("ignore-rules", strings.Join(Config.IgnoreRules, ","), "IgnoreRules, 忽略的优化建议规则")
	rewriteRules := flag.String("rewrite-rules", strings.Join(Config.RewriteRules, ","), "RewriteRules, 生效的重写规则")
	blackList := flag.String("blacklist", Config.BlackList, "指定 blacklist 配置文件的位置,文件中的 SQL 不会被评审。一行一条SQL,可以是指纹,也可以是正则")
	maxJoinTableCount := flag.Int("max-join-table-count", Config.MaxJoinTableCount, "MaxJoinTableCount, 单条 SQL 中 JOIN 表的最大数量")
	maxGroupByColsCount := flag.Int("max-group-by-cols-count", Config.MaxGroupByColsCount, "MaxGroupByColsCount, 单条 SQL 中 GroupBy 包含列的最大数量")
	maxDistinctCount := flag.Int("max-distinct-count", Config.MaxDistinctCount, "MaxDistinctCount, 单条 SQL 中 Distinct 的最大数量")
	maxIdxColsCount := flag.Int("max-index-cols-count", Config.MaxIdxColsCount, "MaxIdxColsCount, 复合索引中包含列的最大数量")
	maxTextColsCount := flag.Int("max-text-cols-count", Config.MaxTextColsCount, "MaxTextColsCount, 表中含有的 text/blob 列的最大数量")
	maxTotalRows := flag.Uint64("max-total-rows", Config.MaxTotalRows, "MaxTotalRows, 计算散粒度时,当数据行数大于MaxTotalRows即开启数据库保护模式,不计算散粒度")
	maxQueryCost := flag.Int64("max-query-cost", Config.MaxQueryCost, "MaxQueryCost, last_query_cost 超过该值时将给予警告")
	spaghettiQueryLength := flag.Int("spaghetti-query-length", Config.SpaghettiQueryLength, "SpaghettiQueryLength, SQL最大长度警告,超过该长度会给警告")
	allowDropIdx := flag.Bool("allow-drop-index", Config.AllowDropIndex, "AllowDropIndex, 允许输出删除重复索引的建议")
	maxInCount := flag.Int("max-in-count", Config.MaxInCount, "MaxInCount, IN()最大数量")
	maxIdxBytesPerColumn := flag.Int("max-index-bytes-percolumn", Config.MaxIdxBytesPerColumn, "MaxIdxBytesPerColumn, 索引中单列最大字节数")
	maxIdxBytes := flag.Int("max-index-bytes", Config.MaxIdxBytes, "MaxIdxBytes, 索引总长度限制")
	allowCharsets := flag.String("allow-charsets", strings.ToLower(strings.Join(Config.AllowCharsets, ",")), "AllowCharsets")
	allowCollates := flag.String("allow-collates", strings.ToLower(strings.Join(Config.AllowCollates, ",")), "AllowCollates")
	allowEngines := flag.String("allow-engines", strings.ToLower(strings.Join(Config.AllowEngines, ",")), "AllowEngines")
	maxIdxCount := flag.Int("max-index-count", Config.MaxIdxCount, "MaxIdxCount, 单表最大索引个数")
	maxColCount := flag.Int("max-column-count", Config.MaxColCount, "MaxColCount, 单表允许的最大列数")
	maxValueCount := flag.Int("max-value-count", Config.MaxValueCount, "MaxValueCount, INSERT/REPLACE 单次批量写入允许的行数")
	idxPrefix := flag.String("index-prefix", Config.IdxPrefix, "IdxPrefix")
	ukPrefix := flag.String("unique-key-prefix", Config.UkPrefix, "UkPrefix")
	maxSubqueryDepth := flag.Int("max-subquery-depth", Config.MaxSubqueryDepth, "MaxSubqueryDepth")
	maxVarcharLength := flag.Int("max-varchar-length", Config.MaxVarcharLength, "MaxVarcharLength")
	columnNotAllowType := flag.String("column-not-allow-type", strings.Join(Config.ColumnNotAllowType, ","), "ColumnNotAllowType")
	// ++++++++++++++EXPLAIN检查项+++++++++++++
	explainSQLReportType := flag.String("explain-sql-report-type", strings.ToLower(Config.ExplainSQLReportType), "ExplainSQLReportType [pretty, sample, fingerprint]")
	explainType := flag.String("explain-type", strings.ToLower(Config.ExplainType), "ExplainType [extended, partitions, traditional]")
	explainFormat := flag.String("explain-format", strings.ToLower(Config.ExplainFormat), "ExplainFormat [json, traditional]")
	explainWarnSelectType := flag.String("explain-warn-select-type", strings.Join(Config.ExplainWarnSelectType, ","), "ExplainWarnSelectType, 哪些select_type不建议使用")
	explainWarnAccessType := flag.String("explain-warn-access-type", strings.Join(Config.ExplainWarnAccessType, ","), "ExplainWarnAccessType, 哪些access type不建议使用")
	explainMaxKeyLength := flag.Int("explain-max-keys", Config.ExplainMaxKeyLength, "ExplainMaxKeyLength, 最大key_len")
	explainMinPossibleKeys := flag.Int("explain-min-keys", Config.ExplainMinPossibleKeys, "ExplainMinPossibleKeys, 最小possible_keys警告")
	explainMaxRows := flag.Int64("explain-max-rows", Config.ExplainMaxRows, "ExplainMaxRows, 最大扫描行数警告")
	explainWarnExtra := flag.String("explain-warn-extra", strings.Join(Config.ExplainWarnExtra, ","), "ExplainWarnExtra, 哪些extra信息会给警告")
	explainMaxFiltered := flag.Float64("explain-max-filtered", Config.ExplainMaxFiltered, "ExplainMaxFiltered, filtered大于该配置给出警告")
	explainWarnScalability := flag.String("explain-warn-scalability", strings.Join(Config.ExplainWarnScalability, ","), "ExplainWarnScalability, 复杂度警告名单, 支持O(n),O(log n),O(1),O(?)")
	showWarnings := flag.Bool("show-warnings", Config.ShowWarnings, "ShowWarnings")
	showLastQueryCost := flag.Bool("show-last-query-cost", Config.ShowLastQueryCost, "ShowLastQueryCost")
	// +++++++++++++++++其他+++++++++++++++++++
	printConfig := flag.Bool("print-config", false, "Print configs")
	checkConfig := flag.Bool("check-config", false, "Check configs")
	printVersion := flag.Bool("version", false, "Print version info")
	query := flag.String("query", Config.Query, "待评审的 SQL 或 SQL 文件,如 SQL 中包含特殊字符建议使用文件名。")
	listHeuristicRules := flag.Bool("list-heuristic-rules", Config.ListHeuristicRules, "ListHeuristicRules, 打印支持的评审规则列表")
	listRewriteRules := flag.Bool("list-rewrite-rules", Config.ListRewriteRules, "ListRewriteRules, 打印支持的重写规则列表")
	listTestSQLs := flag.Bool("list-test-sqls", Config.ListTestSqls, "ListTestSqls, 打印测试case用于测试")
	listReportTypes := flag.Bool("list-report-types", Config.ListReportTypes, "ListReportTypes, 打印支持的报告输出类型")
	verbose := flag.Bool("verbose", Config.Verbose, "Verbose")
	dryrun := flag.Bool("dry-run", Config.DryRun, "是否在预演环境执行")
	maxPrettySQLLength := flag.Int("max-pretty-sql-length", Config.MaxPrettySQLLength, "MaxPrettySQLLength, 超出该长度的SQL会转换成指纹输出")
	// 一个不存在 log-level,用于更新 usage。
	// 因为 vitess 里面也用了 flag,这些 vitess 的参数我们不需要关注
	if !Config.Verbose && runtime.GOOS != "windows" {
		flag.Usage = usage
	}
	flag.Parse()

	Config.OnlineDSN = ParseDSN(*onlineDSN, Config.OnlineDSN)
	Config.TestDSN = ParseDSN(*testDSN, Config.TestDSN)
	Config.AllowOnlineAsTest = *allowOnlineAsTest
	Config.DropTestTemporary = *dropTestTemporary
	Config.CleanupTestDatabase = *cleanupTestDatabase
	Config.OnlySyntaxCheck = *onlySyntaxCheck
	Config.Profiling = *profiling
	Config.Trace = *trace
	Config.Explain = *explain
	Config.Sampling = *sampling
	Config.SamplingStatisticTarget = *samplingStatisticTarget
	Config.SamplingCondition = *samplingCondition

	Config.LogLevel = *logLevel

	if filepath.IsAbs(*logOutput) || *logOutput == "" {
		Config.LogOutput = *logOutput
	} else {
		Config.LogOutput = filepath.Join(BaseDir, *logOutput)
	}

	Config.ReportType = strings.ToLower(*reportType)
	if Config.ReportType == "tables" && Config.TestDSN.Schema == "information_schema" {
		Config.TestDSN.Schema = "unknown"
	}
	Config.ReportCSS = *reportCSS
	Config.ReportJavascript = *reportJavascript
	Config.ReportTitle = *reportTitle
	Config.MarkdownExtensions = *markdownExtensions
	Config.MarkdownHTMLFlags = *markdownHTMLFlags
	Config.IgnoreRules = strings.Split(*ignoreRules, ",")
	Config.RewriteRules = strings.Split(*rewriteRules, ",")
	*blackList = strings.TrimSpace(*blackList)
	Config.MinCardinality = *minCardinality

	if filepath.IsAbs(*blackList) || *blackList == "" {
		Config.BlackList = *blackList
	} else {
		Config.BlackList = filepath.Join(BaseDir, *blackList)
	}

	Config.MaxJoinTableCount = *maxJoinTableCount
	Config.MaxGroupByColsCount = *maxGroupByColsCount
	Config.MaxDistinctCount = *maxDistinctCount

	if *maxIdxColsCount < 16 {
		Config.MaxIdxColsCount = *maxIdxColsCount
	} else {
		Config.MaxIdxColsCount = 16
	}

	Config.MaxTextColsCount = *maxTextColsCount
	Config.MaxIdxBytesPerColumn = *maxIdxBytesPerColumn
	Config.MaxIdxBytes = *maxIdxBytes
	if *allowCharsets != "" {
		Config.AllowCharsets = strings.Split(strings.ToLower(*allowCharsets), ",")
	}
	if *allowCollates != "" {
		Config.AllowCollates = strings.Split(strings.ToLower(*allowCollates), ",")
	}
	if *allowEngines != "" {
		Config.AllowEngines = strings.Split(strings.ToLower(*allowEngines), ",")
	}
	Config.MaxIdxCount = *maxIdxCount
	Config.MaxColCount = *maxColCount
	Config.MaxValueCount = *maxValueCount
	Config.IdxPrefix = *idxPrefix
	Config.UkPrefix = *ukPrefix
	Config.MaxSubqueryDepth = *maxSubqueryDepth
	Config.MaxTotalRows = *maxTotalRows
	Config.MaxQueryCost = *maxQueryCost
	Config.AllowDropIndex = *allowDropIdx
	Config.MaxInCount = *maxInCount
	Config.SpaghettiQueryLength = *spaghettiQueryLength
	Config.Query = *query
	Config.Delimiter = *delimiter

	Config.ExplainSQLReportType = strings.ToLower(*explainSQLReportType)
	Config.ExplainType = strings.ToLower(*explainType)
	Config.ExplainFormat = strings.ToLower(*explainFormat)
	Config.ExplainWarnSelectType = strings.Split(*explainWarnSelectType, ",")
	Config.ExplainWarnAccessType = strings.Split(*explainWarnAccessType, ",")
	Config.ExplainMaxKeyLength = *explainMaxKeyLength
	Config.ExplainMinPossibleKeys = *explainMinPossibleKeys
	Config.ExplainMaxRows = *explainMaxRows
	Config.ExplainWarnExtra = strings.Split(*explainWarnExtra, ",")
	Config.ExplainMaxFiltered = *explainMaxFiltered
	Config.ExplainWarnScalability = strings.Split(*explainWarnScalability, ",")
	Config.ShowWarnings = *showWarnings
	Config.ShowLastQueryCost = *showLastQueryCost
	Config.ListHeuristicRules = *listHeuristicRules
	Config.ListRewriteRules = *listRewriteRules
	Config.ListTestSqls = *listTestSQLs
	Config.ListReportTypes = *listReportTypes
	Config.Verbose = *verbose
	Config.DryRun = *dryrun
	Config.MaxPrettySQLLength = *maxPrettySQLLength
	Config.MaxVarcharLength = *maxVarcharLength
	if *columnNotAllowType != "" {
		Config.ColumnNotAllowType = strings.Split(strings.ToLower(*columnNotAllowType), ",")
	}

	PrintVersion = *printVersion
	PrintConfig = *printConfig
	CheckConfig = *checkConfig

	hasParsed = true
	return nil
}

// ParseConfig 加载配置文件和命令行参数
func ParseConfig(configFile string) error {
	var err error
	var configs []string
	// 指定了配置文件优先读配置文件,未指定配置文件按如下顺序加载,先找到哪个加载哪个
	if configFile == "" {
		configs = []string{
			"/etc/soar.yaml",
			filepath.Join(BaseDir, "etc", "soar.yaml"),
			filepath.Join(BaseDir, "soar.yaml"),
		}
	} else {
		configs = []string{
			configFile,
		}
	}

	for _, config := range configs {
		if _, err = os.Stat(config); err == nil {
			err = Config.readConfigFile(config)
			if err != nil {
				Log.Error("ParseConfig Config.readConfigFile Error: %v", err)
			}
			// LogOutput now is "console", if add Log.Debug here will print into stdout anyway.
			// Log.Debug("ParseConfig use config file: %s", config)
			break
		}
	}

	err = readCmdFlags()
	if err != nil {
		Log.Error("ParseConfig readCmdFlags Error: %v", err)
		return err
	}

	// parse blacklist & ignore blacklist file parse error
	if _, e := os.Stat(Config.BlackList); e == nil {
		var blFd *os.File
		blFd, err = os.Open(Config.BlackList)
		if err == nil {
			bl := bufio.NewReader(blFd)
			for {
				rule, e := bl.ReadString('\n')
				if e != nil {
					break
				}
				rule = strings.TrimSpace(rule)
				if strings.HasPrefix(rule, "#") || rule == "" {
					continue
				}
				BlackList = append(BlackList, rule)
			}
		}
		defer blFd.Close()
	}
	LoggerInit()
	return err
}

// ReportType 元数据结构定义
type ReportType struct {
	Name        string `json:"Name"`
	Description string `json:"Description"`
	Example     string `json:"Example"`
}

// ReportTypes 命令行-report-type支持的形式
var ReportTypes = []ReportType{
	{
		Name:        "lint",
		Description: "参考sqlint格式,以插件形式集成到代码编辑器,显示输出更加友好",
		Example:     `soar -report-type lint -query test.sql`,
	},
	{
		Name:        "markdown",
		Description: "该格式为默认输出格式,以markdown格式展现,可以用网页浏览器插件直接打开,也可以用markdown编辑器打开",
		Example:     `echo "select * from film" | soar`,
	},
	{
		Name:        "rewrite",
		Description: "SQL重写功能,配合-rewrite-rules参数一起使用,可以通过-list-rewrite-rules 查看所有支持的 SQL 重写规则",
		Example:     `echo "select * from film" | soar -rewrite-rules star2columns,delimiter -report-type rewrite`,
	},
	{
		Name:        "ast",
		Description: "输出 SQL 的抽象语法树,主要用于测试",
		Example:     `echo "select * from film" | soar -report-type ast`,
	},
	{
		Name:        "ast-json",
		Description: "以 JSON 格式输出 SQL 的抽象语法树,主要用于测试",
		Example:     `echo "select * from film" | soar -report-type ast-json`,
	},
	{
		Name:        "tiast",
		Description: "输出 SQL 的 TiDB抽象语法树,主要用于测试",
		Example:     `echo "select * from film" | soar -report-type tiast`,
	},
	{
		Name:        "tiast-json",
		Description: "以 JSON 格式输出 SQL 的 TiDB抽象语法树,主要用于测试",
		Example:     `echo "select * from film" | soar -report-type tiast-json`,
	},
	{
		Name:        "tables",
		Description: "以 JSON 格式输出 SQL 使用的库表名",
		Example:     `echo "select * from film" | soar -report-type tables`,
	},
	{
		Name:        "query-type",
		Description: "SQL 语句的请求类型",
		Example:     `echo "select * from film" | soar -report-type query-type`,
	},
	{
		Name:        "fingerprint",
		Description: "输出SQL的指纹",
		Example:     `echo "select * from film where language_id=1" | soar -report-type fingerprint`,
	},
	{
		Name:        "md2html",
		Description: "markdown 格式转 html 格式小工具",
		Example:     `soar -list-heuristic-rules | soar -report-type md2html > heuristic_rules.html`,
	},
	{
		Name:        "explain-digest",
		Description: "输入为EXPLAIN的表格,JSON 或 Vertical格式,对其进行分析,给出分析结果",
		Example: `soar -report-type explain-digest << EOF
+----+-------------+-------+------+---------------+------+---------+------+------+-------+
| id | select_type | table | type | possible_keys | key  | key_len | ref  | rows | Extra |
+----+-------------+-------+------+---------------+------+---------+------+------+-------+
|  1 | SIMPLE      | film  | ALL  | NULL          | NULL | NULL    | NULL | 1131 |       |
+----+-------------+-------+------+---------------+------+---------+------+------+-------+
EOF`,
	},
	{
		Name:        "duplicate-key-checker",
		Description: "对 OnlineDsn 中指定的 database 进行索引重复检查",
		Example:     `soar -report-type duplicate-key-checker -online-dsn user:password@127.0.0.1:3306/db`,
	},
	{
		Name:        "html",
		Description: "以HTML格式输出报表",
		Example:     `echo "select * from film" | soar -report-type html`,
	},
	{
		Name:        "json",
		Description: "输出JSON格式报表,方便应用程序处理",
		Example:     `echo "select * from film" | soar -report-type json`,
	},
	{
		Name:        "tokenize",
		Description: "对SQL进行切词,主要用于测试",
		Example:     `echo "select * from film" | soar -report-type tokenize`,
	},
	{
		Name:        "compress",
		Description: "SQL压缩小工具,使用内置SQL压缩逻辑,测试中的功能",
		Example: `echo "select
*
from
  film" | soar -report-type compress`,
	},
	{
		Name:        "pretty",
		Description: "使用kr/pretty打印报告,主要用于测试",
		Example:     `echo "select * from film" | soar -report-type pretty`,
	},
	{
		Name:        "remove-comment",
		Description: "去除SQL语句中的注释,支持单行多行注释的去除",
		Example:     `echo "select/*comment*/ * from film" | soar -report-type remove-comment`,
	},
	{
		Name:        "chardet",
		Description: "猜测输入的 SQL 使用的字符集",
		Example:     "echo '中文' | soar -report-type chardet",
	},
}

// ListReportTypes 查看所有支持的report-type
func ListReportTypes() {
	switch Config.ReportType {
	case "json":
		js, err := json.MarshalIndent(ReportTypes, "", "  ")
		if err == nil {
			fmt.Println(string(js))
		}
	default:
		fmt.Print("# 支持的报告类型\n\n[toc]\n\n")
		for _, r := range ReportTypes {
			fmt.Print("## ", MarkdownEscape(r.Name),
				"\n* **Description**:", r.Description+"\n",
				"\n* **Example**:\n\n```bash\n", r.Example, "\n```\n")
		}
	}
}

// ArgConfig get -config arg value from cli
func ArgConfig() string {
	var configFile string
	if len(os.Args) > 1 && strings.HasPrefix(os.Args[1], "-config") {
		if os.Args[1] == "-config" && len(os.Args) > 2 {
			if os.Args[2] == "=" && len(os.Args) > 3 {
				// -config = soar.yaml not support
				fmt.Println("wrong format, no space between '=', eg: -config=soar.yaml")
			} else {
				// -config soar.yaml
				configFile = os.Args[2]
			}
			if strings.HasPrefix(configFile, "=") {
				// -config =soar.yaml
				configFile = strings.Split(configFile, "=")[1]
			}
		}
		if strings.Contains(os.Args[1], "=") {
			// -config=soar.yaml
			configFile = strings.Split(os.Args[1], "=")[1]
		}
	} else {
		for i, c := range os.Args {
			if strings.HasPrefix(c, "-config") && i != 1 {
				fmt.Println("-config must be the first arg")
			}
		}
	}
	return configFile
}


================================================
FILE: common/config_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"flag"
	"os"
	"path/filepath"
	"runtime"
	"testing"

	"github.com/kr/pretty"
)

var update = flag.Bool("update", false, "update .golden files")

func TestMain(m *testing.M) {
	// 初始化 init
	if DevPath == "" {
		_, file, _, _ := runtime.Caller(0)
		DevPath, _ = filepath.Abs(filepath.Dir(filepath.Join(file, ".."+string(filepath.Separator))))
	}
	BaseDir = DevPath
	err := ParseConfig("")
	LogIfError(err, "init ParseConfig")
	Log.Debug("mysql_test init")

	// 分割线
	flag.Parse()
	m.Run()

	// 环境清理
	//
}

func TestParseConfig(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	err := ParseConfig("")
	if err != nil {
		t.Error("sqlparser.Parse Error:", err)
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestReadConfigFile(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	if Config == nil {
		Config = new(Configuration)
	}
	Config.readConfigFile(filepath.Join(DevPath, "etc/soar.yaml"))
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestParseDSN(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	var dsns = []string{
		// version < 0.11.0
		"",
		"user:password@hostname:3307/database",
		"user:password@hostname:3307/database?charset=utf8",
		"user:password@hostname:3307",
		"user:password@hostname:/database",
		"user:password@:3307/database",
		"user@hostname/database",
		"user:pwd:pwd@pwd/pwd@hostname/database",
		"user:password@",
		"hostname:3307/database",
		"@hostname:3307/database",
		"@hostname",
		"hostname",
		"@/database",
		"@hostname:3307",
		"@:3307/database",
		":3307/database",
		"/database",
		// go-sql-driver dsn
		"user@unix(/path/to/socket)/dbname",
		"root:pw@unix(/tmp/mysql.sock)/myDatabase?loc=Local",
		"user:password@tcp(localhost:5555)/dbname?tls=skip-verify",
		"user:password@tcp(localhost:5555)/dbname?autocommit=true",
		"user:password@/dbname?sql_mode=TRADITIONAL",
		"user:password@tcp([de:ad:be:ef::ca:fe]:80)/dbname?timeout=90s",
		"user:password@tcp([de:ad:be:ef::ca:fe]:80)/dbname?collation=utf8mb4_unicode_ci",
		"id:password@tcp(your-amazonaws-uri.com:3306)/dbname",
		"user@cloudsql(project-id:instance-name)/dbname",
		"user@cloudsql(project-id:regionname:instance-name)/dbname",
		//"user:password@tcp/dbname?charset=utf8mb4,utf8&sys_var=esc%40ped", multi key in map, pretty print in random order, by pass
		"user:password@tcp/dbname?sys_var=esc%40ped",
		"user:password@/dbname",
		"user:password@/",
		"user:password@tcp(localhost:3307)/database?timeout=5s",
	}
	err := GoldenDiff(func() {
		for _, dsn := range dsns {
			pretty.Println(dsn)
			pretty.Println(ParseDSN(dsn, nil))
		}
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestListReportTypes(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	err := GoldenDiff(func() { ListReportTypes() }, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestArgConfig(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	testArgs1 := [][]string{
		{"soar", "-config", "=", "soar.yaml"},
		{"soar", "-print-config", "-config", "soar.yaml"},
	}
	testArgs2 := [][]string{
		{"soar", "-config", "soar.yaml"},
		{"soar", "-config", "=soar.yaml"},
		{"soar", "-config=soar.yaml"},
	}
	for _, args := range testArgs1 {
		os.Args = args
		configFile := ArgConfig()
		if configFile != "" {
			t.Errorf("should return '', but got %s", configFile)
		}
	}
	for _, args := range testArgs2 {
		os.Args = args
		configFile := ArgConfig()
		if configFile != "soar.yaml" {
			t.Errorf("should return soar.yaml, but got %s", configFile)
		}
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestPrintConfiguration(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	Config.readConfigFile(filepath.Join(DevPath, "etc/soar.yaml"))
	oldLogOutput := Config.LogOutput
	Config.LogOutput = "soar.log"
	err := GoldenDiff(func() {
		PrintConfiguration()
	}, t.Name(), update)
	if err != nil {
		t.Error(err)
	}
	Config.LogOutput = oldLogOutput
	Log.Debug("Exiting function: %s", GetFunctionName())
}


================================================
FILE: common/doc.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

// Package common contain many useful functions for logging, formatting and so on.
package common


================================================
FILE: common/example_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import "fmt"

func ExampleFormatDSN() {
	Log.Debug("Entering function: %s", GetFunctionName())
	dsxExp := newDSN(nil)
	dsxExp.Addr = "127.0.0.1:3306"
	dsxExp.Schema = "mysql"
	dsxExp.User = "root"
	dsxExp.Password = "1t'sB1g3rt"
	dsxExp.Charset = "utf8mb4"
	dsxExp.Disable = false

	// 根据 &dsn 生成 dsnStr
	fmt.Println(FormatDSN(dsxExp))

	// Output: root:1t'sB1g3rt@tcp(127.0.0.1:3306)/mysql?timeout=3s&charset=utf8mb4
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func ExampleIsColsPart() {
	Log.Debug("Entering function: %s", GetFunctionName())
	// IsColsPart() 会 按照顺序 检查两个Column队列是否是包含(或相等)关系。
	a := []*Column{{Name: "1"}, {Name: "2"}, {Name: "3"}}
	b := []*Column{{Name: "1"}, {Name: "2"}}
	c := []*Column{{Name: "1"}, {Name: "3"}}
	d := []*Column{{Name: "1"}, {Name: "2"}, {Name: "3"}, {Name: "4"}}
	id := []*Column{{Name: "id"}}
	iD := []*Column{{Name: "iD"}}

	ab := IsColsPart(a, b)
	ac := IsColsPart(a, c)
	ad := IsColsPart(a, d)
	idiD := IsColsPart(id, iD) // 大小写对比

	fmt.Println(ab, ac, ad, idiD)
	// Output: true false true true
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func ExampleSortedKey() {
	Log.Debug("Entering function: %s", GetFunctionName())
	ages := map[string]int{
		"a": 1,
		"c": 3,
		"d": 4,
		"b": 2,
	}
	for _, name := range SortedKey(ages) {
		fmt.Print(ages[name])
	}
	// Output: 1234
	Log.Debug("Exiting function: %s", GetFunctionName())
}


================================================
FILE: common/logger.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"encoding/json"
	"fmt"
	"regexp"
	"runtime"
	"strings"

	"github.com/astaxie/beego/logs"
)

// Log 使用 beego 的 log 库
var Log *logs.BeeLogger

// BaseDir 日志打印在binary的根路径
var BaseDir string

func init() {
	Log = logs.NewLogger(0)
	Log.EnableFuncCallDepth(true)
}

// LoggerInit Log配置初始化
func LoggerInit() {
	Log.SetLevel(Config.LogLevel)
	func() { _ = Log.DelLogger(logs.AdapterFile) }()
	logConfig := map[string]interface{}{
		"filename": Config.LogOutput,
		"level":    7,
		"maxlines": 0,
		"maxsize":  0,
		"daily":    false,
		"maxdays":  0,
	}
	logConfigJSON, _ := json.Marshal(logConfig)
	err := Log.SetLogger(logs.AdapterFile, string(logConfigJSON))
	if err != nil {
		fmt.Println(err.Error())
	}
}

// Caller returns the caller of the function that called it :)
// https://stackoverflow.com/questions/35212985/is-it-possible-get-information-about-caller-function-in-golang
func Caller() string {
	// we get the callers as uintptrs - but we just need 1
	fpcs := make([]uintptr, 1)

	// skip 3 levels to get to the caller of whoever called Caller()
	n := runtime.Callers(3, fpcs)
	if n == 0 {
		return "n/a" // proper error her would be better
	}

	// get the info of the actual function that's in the pointer
	fun := runtime.FuncForPC(fpcs[0] - 1)
	if fun == nil {
		return "n/a"
	}

	// return its name
	return fun.Name()
}

// GetFunctionName 获取调当前函数名
func GetFunctionName() string {
	// Skip this function, and fetch the PC and file for its parent
	pc, _, _, _ := runtime.Caller(1)
	// Retrieve a Function object this functions parent
	functionObject := runtime.FuncForPC(pc)
	// Regex to extract just the function name (and not the module path)
	extractFnName := regexp.MustCompile(`^.*\.(.*)$`)
	fnName := extractFnName.ReplaceAllString(functionObject.Name(), "$1")
	return fnName
}

// fileName get filename from path
func fileName(original string) string {
	i := strings.LastIndex(original, "/")
	if i == -1 {
		return original
	}
	return original[i+1:]
}

// LogIfError 简化if err != nil 打 Error 日志代码长度
func LogIfError(err error, format string, v ...interface{}) {
	if err != nil {
		_, fn, line, _ := runtime.Caller(1)
		if format == "" {
			format = "[%s:%d] %s"
			Log.Error(format, fileName(fn), line, err.Error())
		} else {
			format = "[%s:%d] " + format + " Error: %s"
			Log.Error(format, fileName(fn), line, v, err.Error())
		}
	}
}

// LogIfWarn 简化if err != nil 打 Warn 日志代码长度
func LogIfWarn(err error, format string, v ...interface{}) {
	if err != nil {
		_, fn, line, _ := runtime.Caller(1)
		if format == "" {
			format = "[%s:%d] %s"
			Log.Warn(format, fileName(fn), line, err.Error())
		} else {
			format = "[%s:%d] " + format + " Error: %s"
			Log.Warn(format, fileName(fn), line, v, err.Error())
		}
	}
}


================================================
FILE: common/logger_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"errors"
	"testing"
)

func TestLogger(t *testing.T) {
	Log.Info("TestLogger_Info")
	Log.Debug("TestLogger_Debug")
	Log.Warning("TestLogger_Warning")
	Log.Error("Warning_Error")
}

func TestCaller(t *testing.T) {
	caller := Caller()
	if caller != "testing.tRunner" {
		t.Error("get caller failed")
	}
}

func TestGetFunctionName(t *testing.T) {
	f := GetFunctionName()
	if f != "TestGetFunctionName" {
		t.Error("get functionname failed")
	}
}

func TestIfError(t *testing.T) {
	err := errors.New("TestIfError")
	LogIfError(err, "")
	LogIfError(err, "func %s", "func_test")
}

func TestIfWarn(t *testing.T) {
	err := errors.New("test")
	LogIfWarn(err, "")
	LogIfWarn(err, "func %s", "func_test")
}


================================================
FILE: common/markdown.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"encoding/base64"
	"fmt"
	"io/ioutil"
	"net/http"
	"os"
	"strings"

	"github.com/russross/blackfriday"
)

// BuiltinCSS 内置HTML风格
var BuiltinCSS = `
a:link,a:visited{text-decoration:none}h3,h4{margin-top:2em}h5,h6{margin-top:20px}h3,h4,h5,h6{margin-bottom:.5em;color:#000}body,h1,h2,h3,h4,h5,h6{color:#000}ol,ul{margin:0 0 0 30px;padding:0 0 12px 6px}ol,ol ol{list-style-position:outside}table td p,table th p{margin-bottom:0}input,select{vertical-align:middle;padding:0}h5,h6,input,select{padding:0}hr,table,textarea{width:100%}body{margin:20px auto;width:800px;background-color:#fff;font:13px "Myriad Pro","Lucida Grande",Lucida,Verdana,sans-serif}h1,table th p{font-weight:700}a:link{color:#00f}a:visited{color:#00a}a:active,a:hover{color:#f60;text-decoration:underline}* html code,* html pre{font-size:101%}code,pre{font-size:11px;font-family:monaco,courier,consolas,monospace}pre{border:1px solid #c7cfd5;background:#f1f5f9;margin:20px 0;padding:8px;text-align:left}hr{color:#919699;size:1;noshade:"noshade"}h1,h2,h3,h4,h5,h6{font-family:"Myriad Pro","Lucida Grande",Lucida,Verdana,sans-serif;font-weight:700}h1{margin-top:1em;margin-bottom:25px;font-size:30px}h2{margin-top:2.5em;font-size:24px;padding-bottom:2px;border-bottom:1px solid #919699}h3{font-size:17px}h4{font-size:15px}h5{font-size:13px}h6{font-size:11px}table td,table th{font-size:12px;border-bottom:1px solid #919699;border-right:1px solid #919699}p{margin-top:0;margin-bottom:10px}ul{list-style:square}li{margin-top:7px}ol{list-style-type:decimal}ol ol{list-style-type:lower-alpha;margin:7px 0 0 30px;padding:0 0 0 10px}ul ul{margin-left:40px;padding:0 0 0 6px}li>p{display:inline}li>a+p,li>p+p{display:block}table{border-top:1px solid #919699;border-left:1px solid #919699;border-spacing:0}table th{padding:4px 8px;background:#E2E2E2}table td{padding:8px;vertical-align:top}table td p+p,table td p+p+p{margin-top:5px}form{margin:0}button{margin:3px 0 10px}input{margin:0 0 5px}select{margin:0 0 3px}textarea{margin:0 0 10px}
`

// BuiltinJavascript 内置 SQL 美化 Javascript 脚本
var BuiltinJavascript = `IWZ1bmN0aW9uKGUsRSl7Im9iamVjdCI9PXR5cGVvZiBleHBvcnRzJiYib2JqZWN0Ij09dHlwZW9mIG1vZHVsZT9tb2R1bGUuZXhwb3J0cz1FKCk6ImZ1bmN0aW9uIj09dHlwZW9mIGRlZmluZSYmZGVmaW5lLmFtZD9kZWZpbmUoW10sRSk6Im9iamVjdCI9PXR5cGVvZiBleHBvcnRzP2V4cG9ydHMuc3FsRm9ybWF0dGVyPUUoKTplLnNxbEZvcm1hdHRlcj1FKCl9KHRoaXMsZnVuY3Rpb24oKXtyZXR1cm4gZnVuY3Rpb24oZSl7ZnVuY3Rpb24gRShuKXtpZih0W25dKXJldHVybiB0W25dLmV4cG9ydHM7dmFyIHI9dFtuXT17ZXhwb3J0czp7fSxpZDpuLGxvYWRlZDohMX07cmV0dXJuIGVbbl0uY2FsbChyLmV4cG9ydHMscixyLmV4cG9ydHMsRSksci5sb2FkZWQ9ITAsci5leHBvcnRzfXZhciB0PXt9O3JldHVybiBFLm09ZSxFLmM9dCxFLnA9IiIsRSgwKX0oW2Z1bmN0aW9uKGUsRSx0KXsidXNlIHN0cmljdCI7ZnVuY3Rpb24gbihlKXtyZXR1cm4gZSYmZS5fX2VzTW9kdWxlP2U6eyJkZWZhdWx0IjplfX1FLl9fZXNNb2R1bGU9ITA7dmFyIHI9dCgxOCksVD1uKHIpLFI9dCgxOSksbz1uKFIpLE49dCgyMCksQT1uKE4pLEk9dCgyMSksTz1uKEkpO0VbImRlZmF1bHQiXT17Zm9ybWF0OmZ1bmN0aW9uKGUsRSl7c3dpdGNoKEU9RXx8e30sRS5sYW5ndWFnZSl7Y2FzZSJkYjIiOnJldHVybiBuZXcgVFsiZGVmYXVsdCJdKEUpLmZvcm1hdChlKTtjYXNlIm4xcWwiOnJldHVybiBuZXcgb1siZGVmYXVsdCJdKEUpLmZvcm1hdChlKTtjYXNlInBsL3NxbCI6cmV0dXJuIG5ldyBBWyJkZWZhdWx0Il0oRSkuZm9ybWF0KGUpO2Nhc2Uic3FsIjpjYXNlIHZvaWQgMDpyZXR1cm4gbmV3IE9bImRlZmF1bHQiXShFKS5mb3JtYXQoZSk7ZGVmYXVsdDp0aHJvdyBFcnJvcigiVW5zdXBwb3J0ZWQgU1FMIGRpYWxlY3Q6ICIrRS5sYW5ndWFnZSl9fX0sZS5leHBvcnRzPUVbImRlZmF1bHQiXX0sZnVuY3Rpb24oZSxFKXsidXNlIHN0cmljdCI7RS5fX2VzTW9kdWxlPSEwLEVbImRlZmF1bHQiXT1mdW5jdGlvbihlLEUpe2lmKCEoZSBpbnN0YW5jZW9mIEUpKXRocm93IG5ldyBUeXBlRXJyb3IoIkNhbm5vdCBjYWxsIGEgY2xhc3MgYXMgYSBmdW5jdGlvbiIpfX0sZnVuY3Rpb24oZSxFLHQpe3ZhciBuPXQoMzkpLHI9Im9iamVjdCI9PXR5cGVvZiBzZWxmJiZzZWxmJiZzZWxmLk9iamVjdD09PU9iamVjdCYmc2VsZixUPW58fHJ8fEZ1bmN0aW9uKCJyZXR1cm4gdGhpcyIpKCk7ZS5leHBvcnRzPVR9LGZ1bmN0aW9uKGUsRSx0KXtmdW5jdGlvbiBuKGUsRSl7dmFyIHQ9VChlLEUpO3JldHVybiByKHQpP3Q6dm9pZCAwfXZhciByPXQoMzMpLFQ9dCg0MSk7ZS5leHBvcnRzPW59LGZ1bmN0aW9uKGUsRSx0KXsidXNlIHN0cmljdCI7ZnVuY3Rpb24gbihlKXtyZXR1cm4gZSYmZS5fX2VzTW9kdWxlP2U6eyJkZWZhdWx0IjplfX1FLl9fZXNNb2R1bGU9ITA7dmFyIHI9dCgxKSxUPW4ociksUj10KDY2KSxvPW4oUiksTj10KDcpLEE9bihOKSxJPXQoMTUpLE89bihJKSxpPXQoMTYpLFM9bihpKSx1PXQoMTcpLEw9bih1KSxDPWZ1bmN0aW9uKCl7ZnVuY3Rpb24gZShFLHQpeygwLFRbImRlZmF1bHQiXSkodGhpcyxlKSx0aGlzLmNmZz1FfHx7fSx0aGlzLmluZGVudGF0aW9uPW5ldyBPWyJkZWZhdWx0Il0odGhpcy5jZmcuaW5kZW50KSx0aGlzLmlubGluZUJsb2NrPW5ldyBTWyJkZWZhdWx0Il0sdGhpcy5wYXJhbXM9bmV3IExbImRlZmF1bHQiXSh0aGlzLmNmZy5wYXJhbXMpLHRoaXMudG9rZW5pemVyPXQsdGhpcy5wcmV2aW91c1Jlc2VydmVkV29yZD17fX1yZXR1cm4gZS5wcm90b3R5cGUuZm9ybWF0PWZ1bmN0aW9uKGUpe3ZhciBFPXRoaXMudG9rZW5pemVyLnRva2VuaXplKGUpLHQ9dGhpcy5nZXRGb3JtYXR0ZWRRdWVyeUZyb21Ub2tlbnMoRSk7cmV0dXJuIHQudHJpbSgpfSxlLnByb3RvdHlwZS5nZXRGb3JtYXR0ZWRRdWVyeUZyb21Ub2tlbnM9ZnVuY3Rpb24oZSl7dmFyIEU9dGhpcyx0PSIiO3JldHVybiBlLmZvckVhY2goZnVuY3Rpb24obixyKXtuLnR5cGUhPT1BWyJkZWZhdWx0Il0uV0hJVEVTUEFDRSYmKG4udHlwZT09PUFbImRlZmF1bHQiXS5MSU5FX0NPTU1FTlQ/dD1FLmZvcm1hdExpbmVDb21tZW50KG4sdCk6bi50eXBlPT09QVsiZGVmYXVsdCJdLkJMT0NLX0NPTU1FTlQ/dD1FLmZvcm1hdEJsb2NrQ29tbWVudChuLHQpOm4udHlwZT09PUFbImRlZmF1bHQiXS5SRVNFUlZFRF9UT1BMRVZFTD8odD1FLmZvcm1hdFRvcGxldmVsUmVzZXJ2ZWRXb3JkKG4sdCksRS5wcmV2aW91c1Jlc2VydmVkV29yZD1uKTpuLnR5cGU9PT1BWyJkZWZhdWx0Il0uUkVTRVJWRURfTkVXTElORT8odD1FLmZvcm1hdE5ld2xpbmVSZXNlcnZlZFdvcmQobix0KSxFLnByZXZpb3VzUmVzZXJ2ZWRXb3JkPW4pOm4udHlwZT09PUFbImRlZmF1bHQiXS5SRVNFUlZFRD8odD1FLmZvcm1hdFdpdGhTcGFjZXMobix0KSxFLnByZXZpb3VzUmVzZXJ2ZWRXb3JkPW4pOnQ9bi50eXBlPT09QVsiZGVmYXVsdCJdLk9QRU5fUEFSRU4/RS5mb3JtYXRPcGVuaW5nUGFyZW50aGVzZXMoZSxyLHQpOm4udHlwZT09PUFbImRlZmF1bHQiXS5DTE9TRV9QQVJFTj9FLmZvcm1hdENsb3NpbmdQYXJlbnRoZXNlcyhuLHQpOm4udHlwZT09PUFbImRlZmF1bHQiXS5QTEFDRUhPTERFUj9FLmZvcm1hdFBsYWNlaG9sZGVyKG4sdCk6IiwiPT09bi52YWx1ZT9FLmZvcm1hdENvbW1hKG4sdCk6IjoiPT09bi52YWx1ZT9FLmZvcm1hdFdpdGhTcGFjZUFmdGVyKG4sdCk6Ii4iPT09bi52YWx1ZXx8IjsiPT09bi52YWx1ZT9FLmZvcm1hdFdpdGhvdXRTcGFjZXMobix0KTpFLmZvcm1hdFdpdGhTcGFjZXMobix0KSl9KSx0fSxlLnByb3RvdHlwZS5mb3JtYXRMaW5lQ29tbWVudD1mdW5jdGlvbihlLEUpe3JldHVybiB0aGlzLmFkZE5ld2xpbmUoRStlLnZhbHVlKX0sZS5wcm90b3R5cGUuZm9ybWF0QmxvY2tDb21tZW50PWZ1bmN0aW9uKGUsRSl7cmV0dXJuIHRoaXMuYWRkTmV3bGluZSh0aGlzLmFkZE5ld2xpbmUoRSkrdGhpcy5pbmRlbnRDb21tZW50KGUudmFsdWUpKX0sZS5wcm90b3R5cGUuaW5kZW50Q29tbWVudD1mdW5jdGlvbihlKXtyZXR1cm4gZS5yZXBsYWNlKC9cbi9nLCJcbiIrdGhpcy5pbmRlbnRhdGlvbi5nZXRJbmRlbnQoKSl9LGUucHJvdG90eXBlLmZvcm1hdFRvcGxldmVsUmVzZXJ2ZWRXb3JkPWZ1bmN0aW9uKGUsRSl7cmV0dXJuIHRoaXMuaW5kZW50YXRpb24uZGVjcmVhc2VUb3BMZXZlbCgpLEU9dGhpcy5hZGROZXdsaW5lKEUpLHRoaXMuaW5kZW50YXRpb24uaW5jcmVhc2VUb3BsZXZlbCgpLEUrPXRoaXMuZXF1YWxpemVXaGl0ZXNwYWNlKGUudmFsdWUpLHRoaXMuYWRkTmV3bGluZShFKX0sZS5wcm90b3R5cGUuZm9ybWF0TmV3bGluZVJlc2VydmVkV29yZD1mdW5jdGlvbihlLEUpe3JldHVybiB0aGlzLmFkZE5ld2xpbmUoRSkrdGhpcy5lcXVhbGl6ZVdoaXRlc3BhY2UoZS52YWx1ZSkrIiAifSxlLnByb3RvdHlwZS5lcXVhbGl6ZVdoaXRlc3BhY2U9ZnVuY3Rpb24oZSl7cmV0dXJuIGUucmVwbGFjZSgvXHMrL2csIiAiKX0sZS5wcm90b3R5cGUuZm9ybWF0T3BlbmluZ1BhcmVudGhlc2VzPWZ1bmN0aW9uKGUsRSx0KXt2YXIgbj1lW0UtMV07cmV0dXJuIG4mJm4udHlwZSE9PUFbImRlZmF1bHQiXS5XSElURVNQQUNFJiZuLnR5cGUhPT1BWyJkZWZhdWx0Il0uT1BFTl9QQVJFTiYmKHQ9KDAsb1siZGVmYXVsdCJdKSh0KSksdCs9ZVtFXS52YWx1ZSx0aGlzLmlubGluZUJsb2NrLmJlZ2luSWZQb3NzaWJsZShlLEUpLHRoaXMuaW5saW5lQmxvY2suaXNBY3RpdmUoKXx8KHRoaXMuaW5kZW50YXRpb24uaW5jcmVhc2VCbG9ja0xldmVsKCksdD10aGlzLmFkZE5ld2xpbmUodCkpLHR9LGUucHJvdG90eXBlLmZvcm1hdENsb3NpbmdQYXJlbnRoZXNlcz1mdW5jdGlvbihlLEUpe3JldHVybiB0aGlzLmlubGluZUJsb2NrLmlzQWN0aXZlKCk/KHRoaXMuaW5saW5lQmxvY2suZW5kKCksdGhpcy5mb3JtYXRXaXRoU3BhY2VBZnRlcihlLEUpKToodGhpcy5pbmRlbnRhdGlvbi5kZWNyZWFzZUJsb2NrTGV2ZWwoKSx0aGlzLmZvcm1hdFdpdGhTcGFjZXMoZSx0aGlzLmFkZE5ld2xpbmUoRSkpKX0sZS5wcm90b3R5cGUuZm9ybWF0UGxhY2Vob2xkZXI9ZnVuY3Rpb24oZSxFKXtyZXR1cm4gRSt0aGlzLnBhcmFtcy5nZXQoZSkrIiAifSxlLnByb3RvdHlwZS5mb3JtYXRDb21tYT1mdW5jdGlvbihlLEUpe3JldHVybiBFPSgwLG9bImRlZmF1bHQiXSkoRSkrZS52YWx1ZSsiICIsdGhpcy5pbmxpbmVCbG9jay5pc0FjdGl2ZSgpP0U6L15MSU1JVCQvaS50ZXN0KHRoaXMucHJldmlvdXNSZXNlcnZlZFdvcmQudmFsdWUpP0U6dGhpcy5hZGROZXdsaW5lKEUpfSxlLnByb3RvdHlwZS5mb3JtYXRXaXRoU3BhY2VBZnRlcj1mdW5jdGlvbihlLEUpe3JldHVybigwLG9bImRlZmF1bHQiXSkoRSkrZS52YWx1ZSsiICJ9LGUucHJvdG90eXBlLmZvcm1hdFdpdGhvdXRTcGFjZXM9ZnVuY3Rpb24oZSxFKXtyZXR1cm4oMCxvWyJkZWZhdWx0Il0pKEUpK2UudmFsdWV9LGUucHJvdG90eXBlLmZvcm1hdFdpdGhTcGFjZXM9ZnVuY3Rpb24oZSxFKXtyZXR1cm4gRStlLnZhbHVlKyIgIn0sZS5wcm90b3R5cGUuYWRkTmV3bGluZT1mdW5jdGlvbihlKXtyZXR1cm4oMCxvWyJkZWZhdWx0Il0pKGUpKyJcbiIrdGhpcy5pbmRlbnRhdGlvbi5nZXRJbmRlbnQoKX0sZX0oKTtFWyJkZWZhdWx0Il09QyxlLmV4cG9ydHM9RVsiZGVmYXVsdCJdfSxmdW5jdGlvbihlLEUsdCl7InVzZSBzdHJpY3QiO2Z1bmN0aW9uIG4oZSl7cmV0dXJuIGUmJmUuX19lc01vZHVsZT9lOnsiZGVmYXVsdCI6ZX19RS5fX2VzTW9kdWxlPSEwO3ZhciByPXQoMSksVD1uKHIpLFI9dCg1OCksbz1uKFIpLE49dCg1MyksQT1uKE4pLEk9dCg3KSxPPW4oSSksaT1mdW5jdGlvbigpe2Z1bmN0aW9uIGUoRSl7KDAsVFsiZGVmYXVsdCJdKSh0aGlzLGUpLHRoaXMuV0hJVEVTUEFDRV9SRUdFWD0vXihccyspLyx0aGlzLk5VTUJFUl9SRUdFWD0vXigoLVxzKik/WzAtOV0rKFwuWzAtOV0rKT98MHhbMC05YS1mQS1GXSt8MGJbMDFdKylcYi8sdGhpcy5PUEVSQVRPUl9SRUdFWD0vXighPXw8Pnw9PXw8PXw+PXwhPHwhPnxcfFx8fDo6fC0+PnwtPnx+flwqfH5+fCF+flwqfCF+fnx+XCp8IX5cKnwhfnwuKS8sdGhpcy5CTE9DS19DT01NRU5UX1JFR0VYPS9eKFwvXCpbXl0qPyg/OlwqXC98JCkpLyx0aGlzLkxJTkVfQ09NTUVOVF9SRUdFWD10aGlzLmNyZWF0ZUxpbmVDb21tZW50UmVnZXgoRS5saW5lQ29tbWVudFR5cGVzKSx0aGlzLlJFU0VSVkVEX1RPUExFVkVMX1JFR0VYPXRoaXMuY3JlYXRlUmVzZXJ2ZWRXb3JkUmVnZXgoRS5yZXNlcnZlZFRvcGxldmVsV29yZHMpLHRoaXMuUkVTRVJWRURfTkVXTElORV9SRUdFWD10aGlzLmNyZWF0ZVJlc2VydmVkV29yZFJlZ2V4KEUucmVzZXJ2ZWROZXdsaW5lV29yZHMpLHRoaXMuUkVTRVJWRURfUExBSU5fUkVHRVg9dGhpcy5jcmVhdGVSZXNlcnZlZFdvcmRSZWdleChFLnJlc2VydmVkV29yZHMpLHRoaXMuV09SRF9SRUdFWD10aGlzLmNyZWF0ZVdvcmRSZWdleChFLnNwZWNpYWxXb3JkQ2hhcnMpLHRoaXMuU1RSSU5HX1JFR0VYPXRoaXMuY3JlYXRlU3RyaW5nUmVnZXgoRS5zdHJpbmdUeXBlcyksdGhpcy5PUEVOX1BBUkVOX1JFR0VYPXRoaXMuY3JlYXRlUGFyZW5SZWdleChFLm9wZW5QYXJlbnMpLHRoaXMuQ0xPU0VfUEFSRU5fUkVHRVg9dGhpcy5jcmVhdGVQYXJlblJlZ2V4KEUuY2xvc2VQYXJlbnMpLHRoaXMuSU5ERVhFRF9QTEFDRUhPTERFUl9SRUdFWD10aGlzLmNyZWF0ZVBsYWNlaG9sZGVyUmVnZXgoRS5pbmRleGVkUGxhY2Vob2xkZXJUeXBlcywiWzAtOV0qIiksdGhpcy5JREVOVF9OQU1FRF9QTEFDRUhPTERFUl9SRUdFWD10aGlzLmNyZWF0ZVBsYWNlaG9sZGVyUmVnZXgoRS5uYW1lZFBsYWNlaG9sZGVyVHlwZXMsIlthLXpBLVowLTkuXyRdKyIpLHRoaXMuU1RSSU5HX05BTUVEX1BMQUNFSE9MREVSX1JFR0VYPXRoaXMuY3JlYXRlUGxhY2Vob2xkZXJSZWdleChFLm5hbWVkUGxhY2Vob2xkZXJUeXBlcyx0aGlzLmNyZWF0ZVN0cmluZ1BhdHRlcm4oRS5zdHJpbmdUeXBlcykpfXJldHVybiBlLnByb3RvdHlwZS5jcmVhdGVMaW5lQ29tbWVudFJlZ2V4PWZ1bmN0aW9uKGUpe3JldHVybiBSZWdFeHAoIl4oKD86IitlLm1hcChmdW5jdGlvbihlKXtyZXR1cm4oMCxBWyJkZWZhdWx0Il0pKGUpfSkuam9pbigifCIpKyIpLio/KD86XG58JCkpIil9LGUucHJvdG90eXBlLmNyZWF0ZVJlc2VydmVkV29yZFJlZ2V4PWZ1bmN0aW9uKGUpe3ZhciBFPWUuam9pbigifCIpLnJlcGxhY2UoLyAvZywiXFxzKyIpO3JldHVybiBSZWdFeHAoIl4oIitFKyIpXFxiIiwiaSIpfSxlLnByb3RvdHlwZS5jcmVhdGVXb3JkUmVnZXg9ZnVuY3Rpb24oKXt2YXIgZT1hcmd1bWVudHMubGVuZ3RoPjAmJnZvaWQgMCE9PWFyZ3VtZW50c1swXT9hcmd1bWVudHNbMF06W107cmV0dXJuIFJlZ0V4cCgiXihbXFx3IitlLmpvaW4oIiIpKyJdKykiKX0sZS5wcm90b3R5cGUuY3JlYXRlU3RyaW5nUmVnZXg9ZnVuY3Rpb24oZSl7cmV0dXJuIFJlZ0V4cCgiXigiK3RoaXMuY3JlYXRlU3RyaW5nUGF0dGVybihlKSsiKSIpfSxlLnByb3RvdHlwZS5jcmVhdGVTdHJpbmdQYXR0ZXJuPWZ1bmN0aW9uKGUpe3ZhciBFPXsiYGAiOiIoKGBbXmBdKigkfGApKSspIiwiW10iOiIoKFxcW1teXFxdXSooJHxcXF0pKShcXF1bXlxcXV0qKCR8XFxdKSkqKSIsJyIiJzonKCgiW14iXFxcXF0qKD86XFxcXC5bXiJcXFxcXSopKigifCQpKSspJywiJyciOiIoKCdbXidcXFxcXSooPzpcXFxcLlteJ1xcXFxdKikqKCd8JCkpKykiLCJOJyciOiIoKE4nW15OJ1xcXFxdKig/OlxcXFwuW15OJ1xcXFxdKikqKCd8JCkpKykifTtyZXR1cm4gZS5tYXAoZnVuY3Rpb24oZSl7cmV0dXJuIEVbZV19KS5qb2luKCJ8Iil9LGUucHJvdG90eXBlLmNyZWF0ZVBhcmVuUmVnZXg9ZnVuY3Rpb24oZSl7dmFyIEU9dGhpcztyZXR1cm4gUmVnRXhwKCJeKCIrZS5tYXAoZnVuY3Rpb24oZSl7cmV0dXJuIEUuZXNjYXBlUGFyZW4oZSl9KS5qb2luKCJ8IikrIikiLCJpIil9LGUucHJvdG90eXBlLmVzY2FwZVBhcmVuPWZ1bmN0aW9uKGUpe3JldHVybiAxPT09ZS5sZW5ndGg/KDAsQVsiZGVmYXVsdCJdKShlKToiXFxiIitlKyJcXGIifSxlLnByb3RvdHlwZS5jcmVhdGVQbGFjZWhvbGRlclJlZ2V4PWZ1bmN0aW9uKGUsRSl7aWYoKDAsb1siZGVmYXVsdCJdKShlKSlyZXR1cm4hMTt2YXIgdD1lLm1hcChBWyJkZWZhdWx0Il0pLmpvaW4oInwiKTtyZXR1cm4gUmVnRXhwKCJeKCg/OiIrdCsiKSg/OiIrRSsiKSkiKX0sZS5wcm90b3R5cGUudG9rZW5pemU9ZnVuY3Rpb24oZSl7Zm9yKHZhciBFPVtdLHQ9dm9pZCAwO2UubGVuZ3RoOyl0PXRoaXMuZ2V0TmV4dFRva2VuKGUsdCksZT1lLnN1YnN0cmluZyh0LnZhbHVlLmxlbmd0aCksRS5wdXNoKHQpO3JldHVybiBFfSxlLnByb3RvdHlwZS5nZXROZXh0VG9rZW49ZnVuY3Rpb24oZSxFKXtyZXR1cm4gdGhpcy5nZXRXaGl0ZXNwYWNlVG9rZW4oZSl8fHRoaXMuZ2V0Q29tbWVudFRva2VuKGUpfHx0aGlzLmdldFN0cmluZ1Rva2VuKGUpfHx0aGlzLmdldE9wZW5QYXJlblRva2VuKGUpfHx0aGlzLmdldENsb3NlUGFyZW5Ub2tlbihlKXx8dGhpcy5nZXRQbGFjZWhvbGRlclRva2VuKGUpfHx0aGlzLmdldE51bWJlclRva2VuKGUpfHx0aGlzLmdldFJlc2VydmVkV29yZFRva2VuKGUsRSl8fHRoaXMuZ2V0V29yZFRva2VuKGUpfHx0aGlzLmdldE9wZXJhdG9yVG9rZW4oZSl9LGUucHJvdG90eXBlLmdldFdoaXRlc3BhY2VUb2tlbj1mdW5jdGlvbihlKXtyZXR1cm4gdGhpcy5nZXRUb2tlbk9uRmlyc3RNYXRjaCh7aW5wdXQ6ZSx0eXBlOk9bImRlZmF1bHQiXS5XSElURVNQQUNFLHJlZ2V4OnRoaXMuV0hJVEVTUEFDRV9SRUdFWH0pfSxlLnByb3RvdHlwZS5nZXRDb21tZW50VG9rZW49ZnVuY3Rpb24oZSl7cmV0dXJuIHRoaXMuZ2V0TGluZUNvbW1lbnRUb2tlbihlKXx8dGhpcy5nZXRCbG9ja0NvbW1lbnRUb2tlbihlKX0sZS5wcm90b3R5cGUuZ2V0TGluZUNvbW1lbnRUb2tlbj1mdW5jdGlvbihlKXtyZXR1cm4gdGhpcy5nZXRUb2tlbk9uRmlyc3RNYXRjaCh7aW5wdXQ6ZSx0eXBlOk9bImRlZmF1bHQiXS5MSU5FX0NPTU1FTlQscmVnZXg6dGhpcy5MSU5FX0NPTU1FTlRfUkVHRVh9KX0sZS5wcm90b3R5cGUuZ2V0QmxvY2tDb21tZW50VG9rZW49ZnVuY3Rpb24oZSl7cmV0dXJuIHRoaXMuZ2V0VG9rZW5PbkZpcnN0TWF0Y2goe2lucHV0OmUsdHlwZTpPWyJkZWZhdWx0Il0uQkxPQ0tfQ09NTUVOVCxyZWdleDp0aGlzLkJMT0NLX0NPTU1FTlRfUkVHRVh9KX0sZS5wcm90b3R5cGUuZ2V0U3RyaW5nVG9rZW49ZnVuY3Rpb24oZSl7cmV0dXJuIHRoaXMuZ2V0VG9rZW5PbkZpcnN0TWF0Y2goe2lucHV0OmUsdHlwZTpPWyJkZWZhdWx0Il0uU1RSSU5HLHJlZ2V4OnRoaXMuU1RSSU5HX1JFR0VYfSl9LGUucHJvdG90eXBlLmdldE9wZW5QYXJlblRva2VuPWZ1bmN0aW9uKGUpe3JldHVybiB0aGlzLmdldFRva2VuT25GaXJzdE1hdGNoKHtpbnB1dDplLHR5cGU6T1siZGVmYXVsdCJdLk9QRU5fUEFSRU4scmVnZXg6dGhpcy5PUEVOX1BBUkVOX1JFR0VYfSl9LGUucHJvdG90eXBlLmdldENsb3NlUGFyZW5Ub2tlbj1mdW5jdGlvbihlKXtyZXR1cm4gdGhpcy5nZXRUb2tlbk9uRmlyc3RNYXRjaCh7aW5wdXQ6ZSx0eXBlOk9bImRlZmF1bHQiXS5DTE9TRV9QQVJFTixyZWdleDp0aGlzLkNMT1NFX1BBUkVOX1JFR0VYfSl9LGUucHJvdG90eXBlLmdldFBsYWNlaG9sZGVyVG9rZW49ZnVuY3Rpb24oZSl7cmV0dXJuIHRoaXMuZ2V0SWRlbnROYW1lZFBsYWNlaG9sZGVyVG9rZW4oZSl8fHRoaXMuZ2V0U3RyaW5nTmFtZWRQbGFjZWhvbGRlclRva2VuKGUpfHx0aGlzLmdldEluZGV4ZWRQbGFjZWhvbGRlclRva2VuKGUpfSxlLnByb3RvdHlwZS5nZXRJZGVudE5hbWVkUGxhY2Vob2xkZXJUb2tlbj1mdW5jdGlvbihlKXtyZXR1cm4gdGhpcy5nZXRQbGFjZWhvbGRlclRva2VuV2l0aEtleSh7aW5wdXQ6ZSxyZWdleDp0aGlzLklERU5UX05BTUVEX1BMQUNFSE9MREVSX1JFR0VYLHBhcnNlS2V5OmZ1bmN0aW9uKGUpe3JldHVybiBlLnNsaWNlKDEpfX0pfSxlLnByb3RvdHlwZS5nZXRTdHJpbmdOYW1lZFBsYWNlaG9sZGVyVG9rZW49ZnVuY3Rpb24oZSl7dmFyIEU9dGhpcztyZXR1cm4gdGhpcy5nZXRQbGFjZWhvbGRlclRva2VuV2l0aEtleSh7aW5wdXQ6ZSxyZWdleDp0aGlzLlNUUklOR19OQU1FRF9QTEFDRUhPTERFUl9SRUdFWCxwYXJzZUtleTpmdW5jdGlvbihlKXtyZXR1cm4gRS5nZXRFc2NhcGVkUGxhY2Vob2xkZXJLZXkoe2tleTplLnNsaWNlKDIsLTEpLHF1b3RlQ2hhcjplLnNsaWNlKC0xKX0pfX0pfSxlLnByb3RvdHlwZS5nZXRJbmRleGVkUGxhY2Vob2xkZXJUb2tlbj1mdW5jdGlvbihlKXtyZXR1cm4gdGhpcy5nZXRQbGFjZWhvbGRlclRva2VuV2l0aEtleSh7aW5wdXQ6ZSxyZWdleDp0aGlzLklOREVYRURfUExBQ0VIT0xERVJfUkVHRVgscGFyc2VLZXk6ZnVuY3Rpb24oZSl7cmV0dXJuIGUuc2xpY2UoMSl9fSl9LGUucHJvdG90eXBlLmdldFBsYWNlaG9sZGVyVG9rZW5XaXRoS2V5PWZ1bmN0aW9uKGUpe3ZhciBFPWUuaW5wdXQsdD1lLnJlZ2V4LG49ZS5wYXJzZUtleSxyPXRoaXMuZ2V0VG9rZW5PbkZpcnN0TWF0Y2goe2lucHV0OkUscmVnZXg6dCx0eXBlOk9bImRlZmF1bHQiXS5QTEFDRUhPTERFUn0pO3JldHVybiByJiYoci5rZXk9bihyLnZhbHVlKSkscn0sZS5wcm90b3R5cGUuZ2V0RXNjYXBlZFBsYWNlaG9sZGVyS2V5PWZ1bmN0aW9uKGUpe3ZhciBFPWUua2V5LHQ9ZS5xdW90ZUNoYXI7cmV0dXJuIEUucmVwbGFjZShSZWdFeHAoKDAsQVsiZGVmYXVsdCJdKSgiXFwiKSt0LCJnIiksdCl9LGUucHJvdG90eXBlLmdldE51bWJlclRva2VuPWZ1bmN0aW9uKGUpe3JldHVybiB0aGlzLmdldFRva2VuT25GaXJzdE1hdGNoKHtpbnB1dDplLHR5cGU6T1siZGVmYXVsdCJdLk5VTUJFUixyZWdleDp0aGlzLk5VTUJFUl9SRUdFWH0pfSxlLnByb3RvdHlwZS5nZXRPcGVyYXRvclRva2VuPWZ1bmN0aW9uKGUpe3JldHVybiB0aGlzLmdldFRva2VuT25GaXJzdE1hdGNoKHtpbnB1dDplLHR5cGU6T1siZGVmYXVsdCJdLk9QRVJBVE9SLHJlZ2V4OnRoaXMuT1BFUkFUT1JfUkVHRVh9KX0sZS5wcm90b3R5cGUuZ2V0UmVzZXJ2ZWRXb3JkVG9rZW49ZnVuY3Rpb24oZSxFKXtpZighRXx8IUUudmFsdWV8fCIuIiE9PUUudmFsdWUpcmV0dXJuIHRoaXMuZ2V0VG9wbGV2ZWxSZXNlcnZlZFRva2VuKGUpfHx0aGlzLmdldE5ld2xpbmVSZXNlcnZlZFRva2VuKGUpfHx0aGlzLmdldFBsYWluUmVzZXJ2ZWRUb2tlbihlKX0sZS5wcm90b3R5cGUuZ2V0VG9wbGV2ZWxSZXNlcnZlZFRva2VuPWZ1bmN0aW9uKGUpe3JldHVybiB0aGlzLmdldFRva2VuT25GaXJzdE1hdGNoKHtpbnB1dDplLHR5cGU6T1siZGVmYXVsdCJdLlJFU0VSVkVEX1RPUExFVkVMLHJlZ2V4OnRoaXMuUkVTRVJWRURfVE9QTEVWRUxfUkVHRVh9KX0sZS5wcm90b3R5cGUuZ2V0TmV3bGluZVJlc2VydmVkVG9rZW49ZnVuY3Rpb24oZSl7cmV0dXJuIHRoaXMuZ2V0VG9rZW5PbkZpcnN0TWF0Y2goe2lucHV0OmUsdHlwZTpPWyJkZWZhdWx0Il0uUkVTRVJWRURfTkVXTElORSxyZWdleDp0aGlzLlJFU0VSVkVEX05FV0xJTkVfUkVHRVh9KX0sZS5wcm90b3R5cGUuZ2V0UGxhaW5SZXNlcnZlZFRva2VuPWZ1bmN0aW9uKGUpe3JldHVybiB0aGlzLmdldFRva2VuT25GaXJzdE1hdGNoKHtpbnB1dDplLHR5cGU6T1siZGVmYXVsdCJdLlJFU0VSVkVELHJlZ2V4OnRoaXMuUkVTRVJWRURfUExBSU5fUkVHRVh9KX0sZS5wcm90b3R5cGUuZ2V0V29yZFRva2VuPWZ1bmN0aW9uKGUpe3JldHVybiB0aGlzLmdldFRva2VuT25GaXJzdE1hdGNoKHtpbnB1dDplLHR5cGU6T1siZGVmYXVsdCJdLldPUkQscmVnZXg6dGhpcy5XT1JEX1JFR0VYfSl9LGUucHJvdG90eXBlLmdldFRva2VuT25GaXJzdE1hdGNoPWZ1bmN0aW9uKGUpe3ZhciBFPWUuaW5wdXQsdD1lLnR5cGUsbj1lLnJlZ2V4LHI9RS5tYXRjaChuKTtpZihyKXJldHVybnt0eXBlOnQsdmFsdWU6clsxXX19LGV9KCk7RVsiZGVmYXVsdCJdPWksZS5leHBvcnRzPUVbImRlZmF1bHQiXX0sZnVuY3Rpb24oZSxFKXtmdW5jdGlvbiB0KGUpe3ZhciBFPXR5cGVvZiBlO3JldHVybiBudWxsIT1lJiYoIm9iamVjdCI9PUV8fCJmdW5jdGlvbiI9PUUpfWUuZXhwb3J0cz10fSxmdW5jdGlvbihlLEUpeyJ1c2Ugc3RyaWN0IjtFLl9fZXNNb2R1bGU9ITAsRVsiZGVmYXVsdCJdPXtXSElURVNQQUNFOiJ3aGl0ZXNwYWNlIixXT1JEOiJ3b3JkIixTVFJJTkc6InN0cmluZyIsUkVTRVJWRUQ6InJlc2VydmVkIixSRVNFUlZFRF9UT1BMRVZFTDoicmVzZXJ2ZWQtdG9wbGV2ZWwiLFJFU0VSVkVEX05FV0xJTkU6InJlc2VydmVkLW5ld2xpbmUiLE9QRVJBVE9SOiJvcGVyYXRvciIsT1BFTl9QQVJFTjoib3Blbi1wYXJlbiIsQ0xPU0VfUEFSRU46ImNsb3NlLXBhcmVuIixMSU5FX0NPTU1FTlQ6ImxpbmUtY29tbWVudCIsQkxPQ0tfQ09NTUVOVDoiYmxvY2stY29tbWVudCIsTlVNQkVSOiJudW1iZXIiLFBMQUNFSE9MREVSOiJwbGFjZWhvbGRlciJ9LGUuZXhwb3J0cz1FWyJkZWZhdWx0Il19LGZ1bmN0aW9uKGUsRSx0KXtmdW5jdGlvbiBuKGUpe3JldHVybiBudWxsIT1lJiZUKGUubGVuZ3RoKSYmIXIoZSl9dmFyIHI9dCgxMiksVD10KDU5KTtlLmV4cG9ydHM9bn0sZnVuY3Rpb24oZSxFLHQpe2Z1bmN0aW9uIG4oZSl7cmV0dXJuIG51bGw9PWU/IiI6cihlKX12YXIgcj10KDEwKTtlLmV4cG9ydHM9bn0sZnVuY3Rpb24oZSxFLHQpe2Z1bmN0aW9uIG4oZSl7aWYoInN0cmluZyI9PXR5cGVvZiBlKXJldHVybiBlO2lmKFQoZSkpcmV0dXJuIE4/Ti5jYWxsKGUpOiIiO3ZhciBFPWUrIiI7cmV0dXJuIjAiPT1FJiYxL2U9PS1SPyItMCI6RX12YXIgcj10KDI2KSxUPXQoMTQpLFI9MS8wLG89cj9yLnByb3RvdHlwZTp2b2lkIDAsTj1vP28udG9TdHJpbmc6dm9pZCAwO2UuZXhwb3J0cz1ufSxmdW5jdGlvbihlLEUpe2Z1bmN0aW9uIHQoZSl7aWYobnVsbCE9ZSl7dHJ5e3JldHVybiByLmNhbGwoZSl9Y2F0Y2goRSl7fXRyeXtyZXR1cm4gZSsiIn1jYXRjaChFKXt9fXJldHVybiIifXZhciBuPUZ1bmN0aW9uLnByb3RvdHlwZSxyPW4udG9TdHJpbmc7ZS5leHBvcnRzPXR9LGZ1bmN0aW9uKGUsRSx0KXtmdW5jdGlvbiBuKGUpe3ZhciBFPXIoZSk/Ti5jYWxsKGUpOiIiO3JldHVybiBFPT1UfHxFPT1SfXZhciByPXQoNiksVD0iW29iamVjdCBGdW5jdGlvbl0iLFI9IltvYmplY3QgR2VuZXJhdG9yRnVuY3Rpb25dIixvPU9iamVjdC5wcm90b3R5cGUsTj1vLnRvU3RyaW5nO2UuZXhwb3J0cz1ufSxmdW5jdGlvbihlLEUpe2Z1bmN0aW9uIHQoZSl7cmV0dXJuIG51bGwhPWUmJiJvYmplY3QiPT10eXBlb2YgZX1lLmV4cG9ydHM9dH0sZnVuY3Rpb24oZSxFLHQpe2Z1bmN0aW9uIG4oZSl7cmV0dXJuInN5bWJvbCI9PXR5cGVvZiBlfHxyKGUpJiZvLmNhbGwoZSk9PVR9dmFyIHI9dCgxMyksVD0iW29iamVjdCBTeW1ib2xdIixSPU9iamVjdC5wcm90b3R5cGUsbz1SLnRvU3RyaW5nO2UuZXhwb3J0cz1ufSxmdW5jdGlvbihlLEUsdCl7InVzZSBzdHJpY3QiO2Z1bmN0aW9uIG4oZSl7cmV0dXJuIGUmJmUuX19lc01vZHVsZT9lOnsiZGVmYXVsdCI6ZX19RS5fX2VzTW9kdWxlPSEwO3ZhciByPXQoMSksVD1uKHIpLFI9dCg2MSksbz1uKFIpLE49dCg2MCksQT1uKE4pLEk9InRvcC1sZXZlbCIsTz0iYmxvY2stbGV2ZWwiLGk9ZnVuY3Rpb24oKXtmdW5jdGlvbiBlKEUpeygwLFRbImRlZmF1bHQiXSkodGhpcyxlKSx0aGlzLmluZGVudD1FfHwiICAiLHRoaXMuaW5kZW50VHlwZXM9W119cmV0dXJuIGUucHJvdG90eXBlLmdldEluZGVudD1mdW5jdGlvbigpe3JldHVybigwLG9bImRlZmF1bHQiXSkodGhpcy5pbmRlbnQsdGhpcy5pbmRlbnRUeXBlcy5sZW5ndGgpfSxlLnByb3RvdHlwZS5pbmNyZWFzZVRvcGxldmVsPWZ1bmN0aW9uKCl7dGhpcy5pbmRlbnRUeXBlcy5wdXNoKEkpfSxlLnByb3RvdHlwZS5pbmNyZWFzZUJsb2NrTGV2ZWw9ZnVuY3Rpb24oKXt0aGlzLmluZGVudFR5cGVzLnB1c2goTyl9LGUucHJvdG90eXBlLmRlY3JlYXNlVG9wTGV2ZWw9ZnVuY3Rpb24oKXsoMCxBWyJkZWZhdWx0Il0pKHRoaXMuaW5kZW50VHlwZXMpPT09SSYmdGhpcy5pbmRlbnRUeXBlcy5wb3AoKX0sZS5wcm90b3R5cGUuZGVjcmVhc2VCbG9ja0xldmVsPWZ1bmN0aW9uKCl7Zm9yKDt0aGlzLmluZGVudFR5cGVzLmxlbmd0aD4wOyl7dmFyIGU9dGhpcy5pbmRlbnRUeXBlcy5wb3AoKTtpZihlIT09SSlicmVha319LGV9KCk7RVsiZGVmYXVsdCJdPWksZS5leHBvcnRzPUVbImRlZmF1bHQiXX0sZnVuY3Rpb24oZSxFLHQpeyJ1c2Ugc3RyaWN0IjtmdW5jdGlvbiBuKGUpe3JldHVybiBlJiZlLl9fZXNNb2R1bGU/ZTp7ImRlZmF1bHQiOmV9fUUuX19lc01vZHVsZT0hMDt2YXIgcj10KDEpLFQ9bihyKSxSPXQoNyksbz1uKFIpLE49NTAsQT1mdW5jdGlvbigpe2Z1bmN0aW9uIGUoKXsoMCxUWyJkZWZhdWx0Il0pKHRoaXMsZSksdGhpcy5sZXZlbD0wfXJldHVybiBlLnByb3RvdHlwZS5iZWdpbklmUG9zc2libGU9ZnVuY3Rpb24oZSxFKXswPT09dGhpcy5sZXZlbCYmdGhpcy5pc0lubGluZUJsb2NrKGUsRSk/dGhpcy5sZXZlbD0xOnRoaXMubGV2ZWw+MD90aGlzLmxldmVsKys6dGhpcy5sZXZlbD0wfSxlLnByb3RvdHlwZS5lbmQ9ZnVuY3Rpb24oKXt0aGlzLmxldmVsLS19LGUucHJvdG90eXBlLmlzQWN0aXZlPWZ1bmN0aW9uKCl7cmV0dXJuIHRoaXMubGV2ZWw+MH0sZS5wcm90b3R5cGUuaXNJbmxpbmVCbG9jaz1mdW5jdGlvbihlLEUpe2Zvcih2YXIgdD0wLG49MCxyPUU7ZS5sZW5ndGg+cjtyKyspe3ZhciBUPWVbcl07aWYodCs9VC52YWx1ZS5sZW5ndGgsdD5OKXJldHVybiExO2lmKFQudHlwZT09PW9bImRlZmF1bHQiXS5PUEVOX1BBUkVOKW4rKztlbHNlIGlmKFQudHlwZT09PW9bImRlZmF1bHQiXS5DTE9TRV9QQVJFTiYmKG4tLSwwPT09bikpcmV0dXJuITA7aWYodGhpcy5pc0ZvcmJpZGRlblRva2VuKFQpKXJldHVybiExfXJldHVybiExfSxlLnByb3RvdHlwZS5pc0ZvcmJpZGRlblRva2VuPWZ1bmN0aW9uKGUpe3ZhciBFPWUudHlwZSx0PWUudmFsdWU7cmV0dXJuIEU9PT1vWyJkZWZhdWx0Il0uUkVTRVJWRURfVE9QTEVWRUx8fEU9PT1vWyJkZWZhdWx0Il0uUkVTRVJWRURfTkVXTElORXx8RT09PW9bImRlZmF1bHQiXS5DT01NRU5UfHxFPT09b1siZGVmYXVsdCJdLkJMT0NLX0NPTU1FTlR8fCI7Ij09PXR9LGV9KCk7RVsiZGVmYXVsdCJdPUEsZS5leHBvcnRzPUVbImRlZmF1bHQiXX0sZnVuY3Rpb24oZSxFLHQpeyJ1c2Ugc3RyaWN0IjtmdW5jdGlvbiBuKGUpe3JldHVybiBlJiZlLl9fZXNNb2R1bGU/ZTp7ImRlZmF1bHQiOmV9fUUuX19lc01vZHVsZT0hMDt2YXIgcj10KDEpLFQ9bihyKSxSPWZ1bmN0aW9uKCl7ZnVuY3Rpb24gZShFKXsoMCxUWyJkZWZhdWx0Il0pKHRoaXMsZSksdGhpcy5wYXJhbXM9RSx0aGlzLmluZGV4PTB9cmV0dXJuIGUucHJvdG90eXBlLmdldD1mdW5jdGlvbihlKXt2YXIgRT1lLmtleSx0PWUudmFsdWU7cmV0dXJuIHRoaXMucGFyYW1zP0U/dGhpcy5wYXJhbXNbRV06dGhpcy5wYXJhbXNbdGhpcy5pbmRleCsrXTp0fSxlfSgpO0VbImRlZmF1bHQiXT1SLGUuZXhwb3J0cz1FWyJkZWZhdWx0Il19LGZ1bmN0aW9uKGUsRSx0KXsidXNlIHN0cmljdCI7ZnVuY3Rpb24gbihlKXtyZXR1cm4gZSYmZS5fX2VzTW9kdWxlP2U6eyJkZWZhdWx0IjplfX1FLl9fZXNNb2R1bGU9ITA7dmFyIHI9dCgxKSxUPW4ociksUj10KDQpLG89bihSKSxOPXQoNSksQT1uKE4pLEk9WyJBQlMiLCJBQ1RJVkFURSIsIkFMSUFTIiwiQUxMIiwiQUxMT0NBVEUiLCJBTExPVyIsIkFMVEVSIiwiQU5ZIiwiQVJFIiwiQVJSQVkiLCJBUyIsIkFTQyIsIkFTRU5TSVRJVkUiLCJBU1NPQ0lBVEUiLCJBU1VUSU1FIiwiQVNZTU1FVFJJQyIsIkFUIiwiQVRPTUlDIiwiQVRUUklCVVRFUyIsIkFVRElUIiwiQVVUSE9SSVpBVElPTiIsIkFVWCIsIkFVWElMSUFSWSIsIkFWRyIsIkJFRk9SRSIsIkJFR0lOIiwiQkVUV0VFTiIsIkJJR0lOVCIsIkJJTkFSWSIsIkJMT0IiLCJCT09MRUFOIiwiQk9USCIsIkJVRkZFUlBPT0wiLCJCWSIsIkNBQ0hFIiwiQ0FMTCIsIkNBTExFRCIsIkNBUFRVUkUiLCJDQVJESU5BTElUWSIsIkNBU0NBREVEIiwiQ0FTRSIsIkNBU1QiLCJDQ1NJRCIsIkNFSUwiLCJDRUlMSU5HIiwiQ0hBUiIsIkNIQVJBQ1RFUiIsIkNIQVJBQ1RFUl9MRU5HVEgiLCJDSEFSX0xFTkdUSCIsIkNIRUNLIiwiQ0xPQiIsIkNMT05FIiwiQ0xPU0UiLCJDTFVTVEVSIiwiQ09BTEVTQ0UiLCJDT0xMQVRFIiwiQ09MTEVDVCIsIkNPTExFQ1RJT04iLCJDT0xMSUQiLCJDT0xVTU4iLCJDT01NRU5UIiwiQ09NTUlUIiwiQ09OQ0FUIiwiQ09ORElUSU9OIiwiQ09OTkVDVCIsIkNPTk5FQ1RJT04iLCJDT05TVFJBSU5UIiwiQ09OVEFJTlMiLCJDT05USU5VRSIsIkNPTlZFUlQiLCJDT1JSIiwiQ09SUkVTUE9ORElORyIsIkNPVU5UIiwiQ09VTlRfQklHIiwiQ09WQVJfUE9QIiwiQ09WQVJfU0FNUCIsIkNSRUFURSIsIkNST1NTIiwiQ1VCRSIsIkNVTUVfRElTVCIsIkNVUlJFTlQiLCJDVVJSRU5UX0RBVEUiLCJDVVJSRU5UX0RFRkFVTFRfVFJBTlNGT1JNX0dST1VQIiwiQ1VSUkVOVF9MQ19DVFlQRSIsIkNVUlJFTlRfUEFUSCIsIkNVUlJFTlRfUk9MRSIsIkNVUlJFTlRfU0NIRU1BIiwiQ1VSUkVOVF9TRVJWRVIiLCJDVVJSRU5UX1RJTUUiLCJDVVJSRU5UX1RJTUVTVEFNUCIsIkNVUlJFTlRfVElNRVpPTkUiLCJDVVJSRU5UX1RSQU5TRk9STV9HUk9VUF9GT1JfVFlQRSIsIkNVUlJFTlRfVVNFUiIsIkNVUlNPUiIsIkNZQ0xFIiwiREFUQSIsIkRBVEFCQVNFIiwiREFUQVBBUlRJVElPTk5BTUUiLCJEQVRBUEFSVElUSU9OTlVNIiwiREFURSIsIkRBWSIsIkRBWVMiLCJEQjJHRU5FUkFMIiwiREIyR0VOUkwiLCJEQjJTUUwiLCJEQklORk8iLCJEQlBBUlRJVElPTk5BTUUiLCJEQlBBUlRJVElPTk5VTSIsIkRFQUxMT0NBVEUiLCJERUMiLCJERUNJTUFMIiwiREVDTEFSRSIsIkRFRkFVTFQiLCJERUZBVUxUUyIsIkRFRklOSVRJT04iLCJERUxFVEUiLCJERU5TRVJBTksiLCJERU5TRV9SQU5LIiwiREVSRUYiLCJERVNDUklCRSIsIkRFU0NSSVBUT1IiLCJERVRFUk1JTklTVElDIiwiRElBR05PU1RJQ1MiLCJESVNBQkxFIiwiRElTQUxMT1ciLCJESVNDT05ORUNUIiwiRElTVElOQ1QiLCJETyIsIkRPQ1VNRU5UIiwiRE9VQkxFIiwiRFJPUCIsIkRTU0laRSIsIkRZTkFNSUMiLCJFQUNIIiwiRURJVFBST0MiLCJFTEVNRU5UIiwiRUxTRSIsIkVMU0VJRiIsIkVOQUJMRSIsIkVOQ09ESU5HIiwiRU5DUllQVElPTiIsIkVORCIsIkVORC1FWEVDIiwiRU5ESU5HIiwiRVJBU0UiLCJFU0NBUEUiLCJFVkVSWSIsIkVYQ0VQVElPTiIsIkVYQ0xVRElORyIsIkVYQ0xVU0lWRSIsIkVYRUMiLCJFWEVDVVRFIiwiRVhJU1RTIiwiRVhJVCIsIkVYUCIsIkVYUExBSU4iLCJFWFRFTkRFRCIsIkVYVEVSTkFMIiwiRVhUUkFDVCIsIkZBTFNFIiwiRkVOQ0VEIiwiRkVUQ0giLCJGSUVMRFBST0MiLCJGSUxFIiwiRklMVEVSIiwiRklOQUwiLCJGSVJTVCIsIkZMT0FUIiwiRkxPT1IiLCJGT1IiLCJGT1JFSUdOIiwiRlJFRSIsIkZVTEwiLCJGVU5DVElPTiIsIkZVU0lPTiIsIkdFTkVSQUwiLCJHRU5FUkFURUQiLCJHRVQiLCJHTE9CQUwiLCJHT1RPIiwiR1JBTlQiLCJHUkFQSElDIiwiR1JPVVAiLCJHUk9VUElORyIsIkhBTkRMRVIiLCJIQVNIIiwiSEFTSEVEX1ZBTFVFIiwiSElOVCIsIkhPTEQiLCJIT1VSIiwiSE9VUlMiLCJJREVOVElUWSIsIklGIiwiSU1NRURJQVRFIiwiSU4iLCJJTkNMVURJTkciLCJJTkNMVVNJVkUiLCJJTkNSRU1FTlQiLCJJTkRFWCIsIklORElDQVRPUiIsIklORElDQVRPUlMiLCJJTkYiLCJJTkZJTklUWSIsIklOSEVSSVQiLCJJTk5FUiIsIklOT1VUIiwiSU5TRU5TSVRJVkUiLCJJTlNFUlQiLCJJTlQiLCJJTlRFR0VSIiwiSU5URUdSSVRZIiwiSU5URVJTRUNUSU9OIiwiSU5URVJWQUwiLCJJTlRPIiwiSVMiLCJJU09CSUQiLCJJU09MQVRJT04iLCJJVEVSQVRFIiwiSkFSIiwiSkFWQSIsIktFRVAiLCJLRVkiLCJMQUJFTCIsIkxBTkdVQUdFIiwiTEFSR0UiLCJMQVRFUkFMIiwiTENfQ1RZUEUiLCJMRUFESU5HIiwiTEVBVkUiLCJMRUZUIiwiTElLRSIsIkxJTktUWVBFIiwiTE4iLCJMT0NBTCIsIkxPQ0FMREFURSIsIkxPQ0FMRSIsIkxPQ0FMVElNRSIsIkxPQ0FMVElNRVNUQU1QIiwiTE9DQVRPUiIsIkxPQ0FUT1JTIiwiTE9DSyIsIkxPQ0tNQVgiLCJMT0NLU0laRSIsIkxPTkciLCJMT09QIiwiTE9XRVIiLCJNQUlOVEFJTkVEIiwiTUFUQ0giLCJNQVRFUklBTElaRUQiLCJNQVgiLCJNQVhWQUxVRSIsIk1FTUJFUiIsIk1FUkdFIiwiTUVUSE9EIiwiTUlDUk9TRUNPTkQiLCJNSUNST1NFQ09ORFMiLCJNSU4iLCJNSU5VVEUiLCJNSU5VVEVTIiwiTUlOVkFMVUUiLCJNT0QiLCJNT0RFIiwiTU9ESUZJRVMiLCJNT0RVTEUiLCJNT05USCIsIk1PTlRIUyIsIk1VTFRJU0VUIiwiTkFOIiwiTkFUSU9OQUwiLCJOQVRVUkFMIiwiTkNIQVIiLCJOQ0xPQiIsIk5FVyIsIk5FV19UQUJMRSIsIk5FWFRWQUwiLCJOTyIsIk5PQ0FDSEUiLCJOT0NZQ0xFIiwiTk9ERU5BTUUiLCJOT0RFTlVNQkVSIiwiTk9NQVhWQUxVRSIsIk5PTUlOVkFMVUUiLCJOT05FIiwiTk9PUkRFUiIsIk5PUk1BTElaRSIsIk5PUk1BTElaRUQiLCJOT1QiLCJOVUxMIiwiTlVMTElGIiwiTlVMTFMiLCJOVU1FUklDIiwiTlVNUEFSVFMiLCJPQklEIiwiT0NURVRfTEVOR1RIIiwiT0YiLCJPRkZTRVQiLCJPTEQiLCJPTERfVEFCTEUiLCJPTiIsIk9OTFkiLCJPUEVOIiwiT1BUSU1JWkFUSU9OIiwiT1BUSU1JWkUiLCJPUFRJT04iLCJPUkRFUiIsIk9VVCIsIk9VVEVSIiwiT1ZFUiIsIk9WRVJMQVBTIiwiT1ZFUkxBWSIsIk9WRVJSSURJTkciLCJQQUNLQUdFIiwiUEFEREVEIiwiUEFHRVNJWkUiLCJQQVJBTUVURVIiLCJQQVJUIiwiUEFSVElUSU9OIiwiUEFSVElUSU9ORUQiLCJQQVJUSVRJT05JTkciLCJQQVJUSVRJT05TIiwiUEFTU1dPUkQiLCJQQVRIIiwiUEVSQ0VOVElMRV9DT05UIiwiUEVSQ0VOVElMRV9ESVNDIiwiUEVSQ0VOVF9SQU5LIiwiUElFQ0VTSVpFIiwiUExBTiIsIlBPU0lUSU9OIiwiUE9XRVIiLCJQUkVDSVNJT04iLCJQUkVQQVJFIiwiUFJFVlZBTCIsIlBSSU1BUlkiLCJQUklRVFkiLCJQUklWSUxFR0VTIiwiUFJPQ0VEVVJFIiwiUFJPR1JBTSIsIlBTSUQiLCJQVUJMSUMiLCJRVUVSWSIsIlFVRVJZTk8iLCJSQU5HRSIsIlJBTksiLCJSRUFEIiwiUkVBRFMiLCJSRUFMIiwiUkVDT1ZFUlkiLCJSRUNVUlNJVkUiLCJSRUYiLCJSRUZFUkVOQ0VTIiwiUkVGRVJFTkNJTkciLCJSRUZSRVNIIiwiUkVHUl9BVkdYIiwiUkVHUl9BVkdZIiwiUkVHUl9DT1VOVCIsIlJFR1JfSU5URVJDRVBUIiwiUkVHUl9SMiIsIlJFR1JfU0xPUEUiLCJSRUdSX1NYWCIsIlJFR1JfU1hZIiwiUkVHUl9TWVkiLCJSRUxFQVNFIiwiUkVOQU1FIiwiUkVQRUFUIiwiUkVTRVQiLCJSRVNJR05BTCIsIlJFU1RBUlQiLCJSRVNUUklDVCIsIlJFU1VMVCIsIlJFU1VMVF9TRVRfTE9DQVRPUiIsIlJFVFVSTiIsIlJFVFVSTlMiLCJSRVZPS0UiLCJSSUdIVCIsIlJPTEUiLCJST0xMQkFDSyIsIlJPTExVUCIsIlJPVU5EX0NFSUxJTkciLCJST1VORF9ET1dOIiwiUk9VTkRfRkxPT1IiLCJST1VORF9IQUxGX0RPV04iLCJST1VORF9IQUxGX0VWRU4iLCJST1VORF9IQUxGX1VQIiwiUk9VTkRfVVAiLCJST1VUSU5FIiwiUk9XIiwiUk9XTlVNQkVSIiwiUk9XUyIsIlJPV1NFVCIsIlJPV19OVU1CRVIiLCJSUk4iLCJSVU4iLCJTQVZFUE9JTlQiLCJTQ0hFTUEiLCJTQ09QRSIsIlNDUkFUQ0hQQUQiLCJTQ1JPTEwiLCJTRUFSQ0giLCJTRUNPTkQiLCJTRUNPTkRTIiwiU0VDUVRZIiwiU0VDVVJJVFkiLCJTRU5TSVRJVkUiLCJTRVFVRU5DRSIsIlNFU1NJT04iLCJTRVNTSU9OX1VTRVIiLCJTSUdOQUwiLCJTSU1JTEFSIiwiU0lNUExFIiwiU01BTExJTlQiLCJTTkFOIiwiU09NRSIsIlNPVVJDRSIsIlNQRUNJRklDIiwiU1BFQ0lGSUNUWVBFIiwiU1FMIiwiU1FMRVhDRVBUSU9OIiwiU1FMSUQiLCJTUUxTVEFURSIsIlNRTFdBUk5JTkciLCJTUVJUIiwiU1RBQ0tFRCIsIlNUQU5EQVJEIiwiU1RBUlQiLCJTVEFSVElORyIsIlNUQVRFTUVOVCIsIlNUQVRJQyIsIlNUQVRNRU5UIiwiU1RBWSIsIlNURERFVl9QT1AiLCJTVERERVZfU0FNUCIsIlNUT0dST1VQIiwiU1RPUkVTIiwiU1RZTEUiLCJTVUJNVUxUSVNFVCIsIlNVQlNUUklORyIsIlNVTSIsIlNVTU1BUlkiLCJTWU1NRVRSSUMiLCJTWU5PTllNIiwiU1lTRlVOIiwiU1lTSUJNIiwiU1lTUFJPQyIsIlNZU1RFTSIsIlNZU1RFTV9VU0VSIiwiVEFCTEUiLCJUQUJMRVNBTVBMRSIsIlRBQkxFU1BBQ0UiLCJUSEVOIiwiVElNRSIsIlRJTUVTVEFNUCIsIlRJTUVaT05FX0hPVVIiLCJUSU1FWk9ORV9NSU5VVEUiLCJUTyIsIlRSQUlMSU5HIiwiVFJBTlNBQ1RJT04iLCJUUkFOU0xBVEUiLCJUUkFOU0xBVElPTiIsIlRSRUFUIiwiVFJJR0dFUiIsIlRSSU0iLCJUUlVFIiwiVFJVTkNBVEUiLCJUWVBFIiwiVUVTQ0FQRSIsIlVORE8iLCJVTklRVUUiLCJVTktOT1dOIiwiVU5ORVNUIiwiVU5USUwiLCJVUFBFUiIsIlVTQUdFIiwiVVNFUiIsIlVTSU5HIiwiVkFMSURQUk9DIiwiVkFMVUUiLCJWQVJDSEFSIiwiVkFSSUFCTEUiLCJWQVJJQU5UIiwiVkFSWUlORyIsIlZBUl9QT1AiLCJWQVJfU0FNUCIsIlZDQVQiLCJWRVJTSU9OIiwiVklFVyIsIlZPTEFUSUxFIiwiVk9MVU1FUyIsIldIRU4iLCJXSEVORVZFUiIsIldISUxFIiwiV0lEVEhfQlVDS0VUIiwiV0lORE9XIiwiV0lUSCIsIldJVEhJTiIsIldJVEhPVVQiLCJXTE0iLCJXUklURSIsIlhNTEVMRU1FTlQiLCJYTUxFWElTVFMiLCJYTUxOQU1FU1BBQ0VTIiwiWUVBUiIsIllFQVJTIl0sTz1bIkFERCIsIkFGVEVSIiwiQUxURVIgQ09MVU1OIiwiQUxURVIgVEFCTEUiLCJERUxFVEUgRlJPTSIsIkVYQ0VQVCIsIkZFVENIIEZJUlNUIiwiRlJPTSIsIkdST1VQIEJZIiwiR08iLCJIQVZJTkciLCJJTlNFUlQgSU5UTyIsIklOVEVSU0VDVCIsIkxJTUlUIiwiT1JERVIgQlkiLCJTRUxFQ1QiLCJTRVQgQ1VSUkVOVCBTQ0hFTUEiLCJTRVQgU0NIRU1BIiwiU0VUIiwiVU5JT04gQUxMIiwiVVBEQVRFIiwiVkFMVUVTIiwiV0hFUkUiXSxpPVsiQU5EIiwiQ1JPU1MgSk9JTiIsIklOTkVSIEpPSU4iLCJKT0lOIiwiTEVGVCBKT0lOIiwiTEVGVCBPVVRFUiBKT0lOIiwiT1IiLCJPVVRFUiBKT0lOIiwiUklHSFQgSk9JTiIsIlJJR0hUIE9VVEVSIEpPSU4iXSxTPXZvaWQgMCx1PWZ1bmN0aW9uKCl7ZnVuY3Rpb24gZShFKXsoMCxUWyJkZWZhdWx0Il0pKHRoaXMsZSksdGhpcy5jZmc9RX1yZXR1cm4gZS5wcm90b3R5cGUuZm9ybWF0PWZ1bmN0aW9uKGUpe3JldHVybiBTfHwoUz1uZXcgQVsiZGVmYXVsdCJdKHtyZXNlcnZlZFdvcmRzOkkscmVzZXJ2ZWRUb3BsZXZlbFdvcmRzOk8scmVzZXJ2ZWROZXdsaW5lV29yZHM6aSxzdHJpbmdUeXBlczpbJyIiJywiJyciLCJgYCIsIltdIl0sb3BlblBhcmVuczpbIigiXSxjbG9zZVBhcmVuczpbIikiXSxpbmRleGVkUGxhY2Vob2xkZXJUeXBlczpbIj8iXSxuYW1lZFBsYWNlaG9sZGVyVHlwZXM6WyI6Il0sbGluZUNvbW1lbnRUeXBlczpbIi0tIl0sc3BlY2lhbFdvcmRDaGFyczpbIiMiLCJAIl19KSksbmV3IG9bImRlZmF1bHQiXSh0aGlzLmNmZyxTKS5mb3JtYXQoZSl9LGV9KCk7RVsiZGVmYXVsdCJdPXUsZS5leHBvcnRzPUVbImRlZmF1bHQiXX0sZnVuY3Rpb24oZSxFLHQpeyJ1c2Ugc3RyaWN0IjtmdW5jdGlvbiBuKGUpe3JldHVybiBlJiZlLl9fZXNNb2R1bGU/ZTp7ImRlZmF1bHQiOmV9fUUuX19lc01vZHVsZT0hMDt2YXIgcj10KDEpLFQ9bihyKSxSPXQoNCksbz1uKFIpLE49dCg1KSxBPW4oTiksST1bIkFMTCIsIkFMVEVSIiwiQU5BTFlaRSIsIkFORCIsIkFOWSIsIkFSUkFZIiwiQVMiLCJBU0MiLCJCRUdJTiIsIkJFVFdFRU4iLCJCSU5BUlkiLCJCT09MRUFOIiwiQlJFQUsiLCJCVUNLRVQiLCJCVUlMRCIsIkJZIiwiQ0FMTCIsIkNBU0UiLCJDQVNUIiwiQ0xVU1RFUiIsIkNPTExBVEUiLCJDT0xMRUNUSU9OIiwiQ09NTUlUIiwiQ09OTkVDVCIsIkNPTlRJTlVFIiwiQ09SUkVMQVRFIiwiQ09WRVIiLCJDUkVBVEUiLCJEQVRBQkFTRSIsIkRBVEFTRVQiLCJEQVRBU1RPUkUiLCJERUNMQVJFIiwiREVDUkVNRU5UIiwiREVMRVRFIiwiREVSSVZFRCIsIkRFU0MiLCJERVNDUklCRSIsIkRJU1RJTkNUIiwiRE8iLCJEUk9QIiwiRUFDSCIsIkVMRU1FTlQiLCJFTFNFIiwiRU5EIiwiRVZFUlkiLCJFWENFUFQiLCJFWENMVURFIiwiRVhFQ1VURSIsIkVYSVNUUyIsIkVYUExBSU4iLCJGQUxTRSIsIkZFVENIIiwiRklSU1QiLCJGTEFUVEVOIiwiRk9SIiwiRk9SQ0UiLCJGUk9NIiwiRlVOQ1RJT04iLCJHUkFOVCIsIkdST1VQIiwiR1NJIiwiSEFWSU5HIiwiSUYiLCJJR05PUkUiLCJJTElLRSIsIklOIiwiSU5DTFVERSIsIklOQ1JFTUVOVCIsIklOREVYIiwiSU5GRVIiLCJJTkxJTkUiLCJJTk5FUiIsIklOU0VSVCIsIklOVEVSU0VDVCIsIklOVE8iLCJJUyIsIkpPSU4iLCJLRVkiLCJLRVlTIiwiS0VZU1BBQ0UiLCJLTk9XTiIsIkxBU1QiLCJMRUZUIiwiTEVUIiwiTEVUVElORyIsIkxJS0UiLCJMSU1JVCIsIkxTTSIsIk1BUCIsIk1BUFBJTkciLCJNQVRDSEVEIiwiTUFURVJJQUxJWkVEIiwiTUVSR0UiLCJNSU5VUyIsIk1JU1NJTkciLCJOQU1FU1BBQ0UiLCJORVNUIiwiTk9UIiwiTlVMTCIsIk5VTUJFUiIsIk9CSkVDVCIsIk9GRlNFVCIsIk9OIiwiT1BUSU9OIiwiT1IiLCJPUkRFUiIsIk9VVEVSIiwiT1ZFUiIsIlBBUlNFIiwiUEFSVElUSU9OIiwiUEFTU1dPUkQiLCJQQVRIIiwiUE9PTCIsIlBSRVBBUkUiLCJQUklNQVJZIiwiUFJJVkFURSIsIlBSSVZJTEVHRSIsIlBST0NFRFVSRSIsIlBVQkxJQyIsIlJBVyIsIlJFQUxNIiwiUkVEVUNFIiwiUkVOQU1FIiwiUkVUVVJOIiwiUkVUVVJOSU5HIiwiUkVWT0tFIiwiUklHSFQiLCJST0xFIiwiUk9MTEJBQ0siLCJTQVRJU0ZJRVMiLCJTQ0hFTUEiLCJTRUxFQ1QiLCJTRUxGIiwiU0VNSSIsIlNFVCIsIlNIT1ciLCJTT01FIiwiU1RBUlQiLCJTVEFUSVNUSUNTIiwiU1RSSU5HIiwiU1lTVEVNIiwiVEhFTiIsIlRPIiwiVFJBTlNBQ1RJT04iLCJUUklHR0VSIiwiVFJVRSIsIlRSVU5DQVRFIiwiVU5ERVIiLCJVTklPTiIsIlVOSVFVRSIsIlVOS05PV04iLCJVTk5FU1QiLCJVTlNFVCIsIlVQREFURSIsIlVQU0VSVCIsIlVTRSIsIlVTRVIiLCJVU0lORyIsIlZBTElEQVRFIiwiVkFMVUUiLCJWQUxVRUQiLCJWQUxVRVMiLCJWSUEiLCJWSUVXIiwiV0hFTiIsIldIRVJFIiwiV0hJTEUiLCJXSVRIIiwiV0lUSElOIiwiV09SSyIsIlhPUiJdLE89WyJERUxFVEUgRlJPTSIsIkVYQ0VQVCBBTEwiLCJFWENFUFQiLCJFWFBMQUlOIERFTEVURSBGUk9NIiwiRVhQTEFJTiBVUERBVEUiLCJFWFBMQUlOIFVQU0VSVCIsIkZST00iLCJHUk9VUCBCWSIsIkhBVklORyIsIklORkVSIiwiSU5TRVJUIElOVE8iLCJJTlRFUlNFQ1QgQUxMIiwiSU5URVJTRUNUIiwiTEVUIiwiTElNSVQiLCJNRVJHRSIsIk5FU1QiLCJPUkRFUiBCWSIsIlBSRVBBUkUiLCJTRUxFQ1QiLCJTRVQgQ1VSUkVOVCBTQ0hFTUEiLCJTRVQgU0NIRU1BIiwiU0VUIiwiVU5JT04gQUxMIiwiVU5JT04iLCJVTk5FU1QiLCJVUERBVEUiLCJVUFNFUlQiLCJVU0UgS0VZUyIsIlZBTFVFUyIsIldIRVJFIl0saT1bIkFORCIsIklOTkVSIEpPSU4iLCJKT0lOIiwiTEVGVCBKT0lOIiwiTEVGVCBPVVRFUiBKT0lOIiwiT1IiLCJPVVRFUiBKT0lOIiwiUklHSFQgSk9JTiIsIlJJR0hUIE9VVEVSIEpPSU4iLCJYT1IiXSxTPXZvaWQgMCx1PWZ1bmN0aW9uKCl7ZnVuY3Rpb24gZShFKXsoMCxUWyJkZWZhdWx0Il0pKHRoaXMsZSksdGhpcy5jZmc9RX1yZXR1cm4gZS5wcm90b3R5cGUuZm9ybWF0PWZ1bmN0aW9uKGUpe3JldHVybiBTfHwoUz1uZXcgQVsiZGVmYXVsdCJdKHtyZXNlcnZlZFdvcmRzOkkscmVzZXJ2ZWRUb3BsZXZlbFdvcmRzOk8scmVzZXJ2ZWROZXdsaW5lV29yZHM6aSxzdHJpbmdUeXBlczpbJyIiJywiJyciLCJgYCJdLG9wZW5QYXJlbnM6WyIoIiwiWyIsInsiXSxjbG9zZVBhcmVuczpbIikiLCJdIiwifSJdLG5hbWVkUGxhY2Vob2xkZXJUeXBlczpbIiQiXSxsaW5lQ29tbWVudFR5cGVzOlsiIyIsIi0tIl19KSksbmV3IG9bImRlZmF1bHQiXSh0aGlzLmNmZyxTKS5mb3JtYXQoZSl9LGV9KCk7RVsiZGVmYXVsdCJdPXUsZS5leHBvcnRzPUVbImRlZmF1bHQiXX0sZnVuY3Rpb24oZSxFLHQpeyJ1c2Ugc3RyaWN0IjtmdW5jdGlvbiBuKGUpe3JldHVybiBlJiZlLl9fZXNNb2R1bGU/ZTp7ImRlZmF1bHQiOmV9fUUuX19lc01vZHVsZT0hMDt2YXIgcj10KDEpLFQ9bihyKSxSPXQoNCksbz1uKFIpLE49dCg1KSxBPW4oTiksST1bIkEiLCJBQ0NFU1NJQkxFIiwiQUdFTlQiLCJBR0dSRUdBVEUiLCJBTEwiLCJBTFRFUiIsIkFOWSIsIkFSUkFZIiwiQVMiLCJBU0MiLCJBVCIsIkFUVFJJQlVURSIsIkFVVEhJRCIsIkFWRyIsIkJFVFdFRU4iLCJCRklMRV9CQVNFIiwiQklOQVJZX0lOVEVHRVIiLCJCSU5BUlkiLCJCTE9CX0JBU0UiLCJCTE9DSyIsIkJPRFkiLCJCT09MRUFOIiwiQk9USCIsIkJPVU5EIiwiQlVMSyIsIkJZIiwiQllURSIsIkMiLCJDQUxMIiwiQ0FMTElORyIsIkNBU0NBREUiLCJDQVNFIiwiQ0hBUl9CQVNFIiwiQ0hBUiIsIkNIQVJBQ1RFUiIsIkNIQVJTRVQiLCJDSEFSU0VURk9STSIsIkNIQVJTRVRJRCIsIkNIRUNLIiwiQ0xPQl9CQVNFIiwiQ0xPTkUiLCJDTE9TRSIsIkNMVVNURVIiLCJDTFVTVEVSUyIsIkNPQUxFU0NFIiwiQ09MQVVUSCIsIkNPTExFQ1QiLCJDT0xVTU5TIiwiQ09NTUVOVCIsIkNPTU1JVCIsIkNPTU1JVFRFRCIsIkNPTVBJTEVEIiwiQ09NUFJFU1MiLCJDT05ORUNUIiwiQ09OU1RBTlQiLCJDT05TVFJVQ1RPUiIsIkNPTlRFWFQiLCJDT05USU5VRSIsIkNPTlZFUlQiLCJDT1VOVCIsIkNSQVNIIiwiQ1JFQVRFIiwiQ1JFREVOVElBTCIsIkNVUlJFTlQiLCJDVVJSVkFMIiwiQ1VSU09SIiwiQ1VTVE9NREFUVU0iLCJEQU5HTElORyIsIkRBVEEiLCJEQVRFX0JBU0UiLCJEQVRFIiwiREFZIiwiREVDSU1BTCIsIkRFRkFVTFQiLCJERUZJTkUiLCJERUxFVEUiLCJERVNDIiwiREVURVJNSU5JU1RJQyIsIkRJUkVDVE9SWSIsIkRJU1RJTkNUIiwiRE8iLCJET1VCTEUiLCJEUk9QIiwiRFVSQVRJT04iLCJFTEVNRU5UIiwiRUxTSUYiLCJFTVBUWSIsIkVTQ0FQRSIsIkVYQ0VQVElPTlMiLCJFWENMVVNJVkUiLCJFWEVDVVRFIiwiRVhJU1RTIiwiRVhJVCIsIkVYVEVORFMiLCJFWFRFUk5BTCIsIkVYVFJBQ1QiLCJGQUxTRSIsIkZFVENIIiwiRklOQUwiLCJGSVJTVCIsIkZJWEVEIiwiRkxPQVQiLCJGT1IiLCJGT1JBTEwiLCJGT1JDRSIsIkZST00iLCJGVU5DVElPTiIsIkdFTkVSQUwiLCJHT1RPIiwiR1JBTlQiLCJHUk9VUCIsIkhBU0giLCJIRUFQIiwiSElEREVOIiwiSE9VUiIsIklERU5USUZJRUQiLCJJRiIsIklNTUVESUFURSIsIklOIiwiSU5DTFVESU5HIiwiSU5ERVgiLCJJTkRFWEVTIiwiSU5ESUNBVE9SIiwiSU5ESUNFUyIsIklORklOSVRFIiwiSU5TVEFOVElBQkxFIiwiSU5UIiwiSU5URUdFUiIsIklOVEVSRkFDRSIsIklOVEVSVkFMIiwiSU5UTyIsIklOVkFMSURBVEUiLCJJUyIsIklTT0xBVElPTiIsIkpBVkEiLCJMQU5HVUFHRSIsIkxBUkdFIiwiTEVBRElORyIsIkxFTkdUSCIsIkxFVkVMIiwiTElCUkFSWSIsIkxJS0UiLCJMSUtFMiIsIkxJS0U0IiwiTElLRUMiLCJMSU1JVEVEIiwiTE9DQUwiLCJMT0NLIiwiTE9ORyIsIk1BUCIsIk1BWCIsIk1BWExFTiIsIk1FTUJFUiIsIk1FUkdFIiwiTUlOIiwiTUlOVVMiLCJNSU5VVEUiLCJNTFNMQUJFTCIsIk1PRCIsIk1PREUiLCJNT05USCIsIk1VTFRJU0VUIiwiTkFNRSIsIk5BTiIsIk5BVElPTkFMIiwiTkFUSVZFIiwiTkFUVVJBTCIsIk5BVFVSQUxOIiwiTkNIQVIiLCJORVciLCJORVhUVkFMIiwiTk9DT01QUkVTUyIsIk5PQ09QWSIsIk5PVCIsIk5PV0FJVCIsIk5VTEwiLCJOVUxMSUYiLCJOVU1CRVJfQkFTRSIsIk5VTUJFUiIsIk9CSkVDVCIsIk9DSUNPTEwiLCJPQ0lEQVRFIiwiT0NJREFURVRJTUUiLCJPQ0lEVVJBVElPTiIsIk9DSUlOVEVSVkFMIiwiT0NJTE9CTE9DQVRPUiIsIk9DSU5VTUJFUiIsIk9DSVJBVyIsIk9DSVJFRiIsIk9DSVJFRkNVUlNPUiIsIk9DSVJPV0lEIiwiT0NJU1RSSU5HIiwiT0NJVFlQRSIsIk9GIiwiT0xEIiwiT04iLCJPTkxZIiwiT1BBUVVFIiwiT1BFTiIsIk9QRVJBVE9SIiwiT1BUSU9OIiwiT1JBQ0xFIiwiT1JBREFUQSIsIk9SREVSIiwiT1JHQU5JWkFUSU9OIiwiT1JMQU5ZIiwiT1JMVkFSWSIsIk9USEVSUyIsIk9VVCIsIk9WRVJMQVBTIiwiT1ZFUlJJRElORyIsIlBBQ0tBR0UiLCJQQVJBTExFTF9FTkFCTEUiLCJQQVJBTUVURVIiLCJQQVJBTUVURVJTIiwiUEFSRU5UIiwiUEFSVElUSU9OIiwiUEFTQ0FMIiwiUENURlJFRSIsIlBJUEUiLCJQSVBFTElORUQiLCJQTFNfSU5URUdFUiIsIlBMVUdHQUJMRSIsIlBPU0lUSVZFIiwiUE9TSVRJVkVOIiwiUFJBR01BIiwiUFJFQ0lTSU9OIiwiUFJJT1IiLCJQUklWQVRFIiwiUFJPQ0VEVVJFIiwiUFVCTElDIiwiUkFJU0UiLCJSQU5HRSIsIlJBVyIsIlJFQUQiLCJSRUFMIiwiUkVDT1JEIiwiUkVGIiwiUkVGRVJFTkNFIiwiUkVMRUFTRSIsIlJFTElFU19PTiIsIlJFTSIsIlJFTUFJTkRFUiIsIlJFTkFNRSIsIlJFU09VUkNFIiwiUkVTVUxUX0NBQ0hFIiwiUkVTVUxUIiwiUkVUVVJOIiwiUkVUVVJOSU5HIiwiUkVWRVJTRSIsIlJFVk9LRSIsIlJPTExCQUNLIiwiUk9XIiwiUk9XSUQiLCJST1dOVU0iLCJST1dUWVBFIiwiU0FNUExFIiwiU0FWRSIsIlNBVkVQT0lOVCIsIlNCMSIsIlNCMiIsIlNCNCIsIlNFQ09ORCIsIlNFR01FTlQiLCJTRUxGIiwiU0VQQVJBVEUiLCJTRVFVRU5DRSIsIlNFUklBTElaQUJMRSIsIlNIQVJFIiwiU0hPUlQiLCJTSVpFX1QiLCJTSVpFIiwiU01BTExJTlQiLCJTT01FIiwiU1BBQ0UiLCJTUEFSU0UiLCJTUUwiLCJTUUxDT0RFIiwiU1FMREFUQSIsIlNRTEVSUk0iLCJTUUxOQU1FIiwiU1FMU1RBVEUiLCJTVEFOREFSRCIsIlNUQVJUIiwiU1RBVElDIiwiU1REREVWIiwiU1RPUkVEIiwiU1RSSU5HIiwiU1RSVUNUIiwiU1RZTEUiLCJTVUJNVUxUSVNFVCIsIlNVQlBBUlRJVElPTiIsIlNVQlNUSVRVVEFCTEUiLCJTVUJUWVBFIiwiU1VDQ0VTU0ZVTCIsIlNVTSIsIlNZTk9OWU0iLCJTWVNEQVRFIiwiVEFCQVVUSCIsIlRBQkxFIiwiVERPIiwiVEhFIiwiVEhFTiIsIlRJTUUiLCJUSU1FU1RBTVAiLCJUSU1FWk9ORV9BQkJSIiwiVElNRVpPTkVfSE9VUiIsIlRJTUVaT05FX01JTlVURSIsIlRJTUVaT05FX1JFR0lPTiIsIlRPIiwiVFJBSUxJTkciLCJUUkFOU0FDVElPTiIsIlRSQU5TQUNUSU9OQUwiLCJUUklHR0VSIiwiVFJVRSIsIlRSVVNURUQiLCJUWVBFIiwiVUIxIiwiVUIyIiwiVUI0IiwiVUlEIiwiVU5ERVIiLCJVTklRVUUiLCJVTlBMVUciLCJVTlNJR05FRCIsIlVOVFJVU1RFRCIsIlVTRSIsIlVTRVIiLCJVU0lORyIsIlZBTElEQVRFIiwiVkFMSVNUIiwiVkFMVUUiLCJWQVJDSEFSIiwiVkFSQ0hBUjIiLCJWQVJJQUJMRSIsIlZBUklBTkNFIiwiVkFSUkFZIiwiVkFSWUlORyIsIlZJRVciLCJWSUVXUyIsIlZPSUQiLCJXSEVORVZFUiIsIldISUxFIiwiV0lUSCIsIldPUksiLCJXUkFQUEVEIiwiV1JJVEUiLCJZRUFSIiwiWk9ORSJdLE89WyJBREQiLCJBTFRFUiBDT0xVTU4iLCJBTFRFUiBUQUJMRSIsIkJFR0lOIiwiQ09OTkVDVCBCWSIsIkRFQ0xBUkUiLCJERUxFVEUgRlJPTSIsIkRFTEVURSIsIkVORCIsIkVYQ0VQVCIsIkVYQ0VQVElPTiIsIkZFVENIIEZJUlNUIiwiRlJPTSIsIkdST1VQIEJZIiwiSEFWSU5HIiwiSU5TRVJUIElOVE8iLCJJTlNFUlQiLCJJTlRFUlNFQ1QiLCJMSU1JVCIsIkxPT1AiLCJNT0RJRlkiLCJPUkRFUiBCWSIsIlNFTEVDVCIsIlNFVCBDVVJSRU5UIFNDSEVNQSIsIlNFVCBTQ0hFTUEiLCJTRVQiLCJTVEFSVCBXSVRIIiwiVU5JT04gQUxMIiwiVU5JT04iLCJVUERBVEUiLCJWQUxVRVMiLCJXSEVSRSJdLGk9WyJBTkQiLCJDUk9TUyBBUFBMWSIsIkNST1NTIEpPSU4iLCJFTFNFIiwiRU5EIiwiSU5ORVIgSk9JTiIsIkpPSU4iLCJMRUZUIEpPSU4iLCJMRUZUIE9VVEVSIEpPSU4iLCJPUiIsIk9VVEVSIEFQUExZIiwiT1VURVIgSk9JTiIsIlJJR0hUIEpPSU4iLCJSSUdIVCBPVVRFUiBKT0lOIiwiV0hFTiIsIlhPUiJdLFM9dm9pZCAwLHU9ZnVuY3Rpb24oKXtmdW5jdGlvbiBlKEUpeygwLFRbImRlZmF1bHQiXSkodGhpcyxlKSx0aGlzLmNmZz1FfXJldHVybiBlLnByb3RvdHlwZS5mb3JtYXQ9ZnVuY3Rpb24oZSl7cmV0dXJuIFN8fChTPW5ldyBBWyJkZWZhdWx0Il0oe3Jlc2VydmVkV29yZHM6SSxyZXNlcnZlZFRvcGxldmVsV29yZHM6TyxyZXNlcnZlZE5ld2xpbmVXb3JkczppLHN0cmluZ1R5cGVzOlsnIiInLCJOJyciLCInJyIsImBgIl0sb3BlblBhcmVuczpbIigiLCJDQVNFIl0sY2xvc2VQYXJlbnM6WyIpIiwiRU5EIl0saW5kZXhlZFBsYWNlaG9sZGVyVHlwZXM6WyI/Il0sbmFtZWRQbGFjZWhvbGRlclR5cGVzOlsiOiJdLGxpbmVDb21tZW50VHlwZXM6WyItLSJdLHNwZWNpYWxXb3JkQ2hhcnM6WyJfIiwiJCIsIiMiLCIuIiwiQCJdfSkpLG5ldyBvWyJkZWZhdWx0Il0odGhpcy5jZmcsUykuZm9ybWF0KGUpfSxlfSgpO0VbImRlZmF1bHQiXT11LGUuZXhwb3J0cz1FWyJkZWZhdWx0Il19LGZ1bmN0aW9uKGUsRSx0KXsidXNlIHN0cmljdCI7ZnVuY3Rpb24gbihlKXtyZXR1cm4gZSYmZS5fX2VzTW9kdWxlP2U6eyJkZWZhdWx0IjplfX1FLl9fZXNNb2R1bGU9ITA7dmFyIHI9dCgxKSxUPW4ociksUj10KDQpLG89bihSKSxOPXQoNSksQT1uKE4pLEk9WyJBQ0NFU1NJQkxFIiwiQUNUSU9OIiwiQUdBSU5TVCIsIkFHR1JFR0FURSIsIkFMR09SSVRITSIsIkFMTCIsIkFMVEVSIiwiQU5BTFlTRSIsIkFOQUxZWkUiLCJBUyIsIkFTQyIsIkFVVE9DT01NSVQiLCJBVVRPX0lOQ1JFTUVOVCIsIkJBQ0tVUCIsIkJFR0lOIiwiQkVUV0VFTiIsIkJJTkxPRyIsIkJPVEgiLCJDQVNDQURFIiwiQ0FTRSIsIkNIQU5HRSIsIkNIQU5HRUQiLCJDSEFSQUNURVIgU0VUIiwiQ0hBUlNFVCIsIkNIRUNLIiwiQ0hFQ0tTVU0iLCJDT0xMQVRFIiwiQ09MTEFUSU9OIiwiQ09MVU1OIiwiQ09MVU1OUyIsIkNPTU1FTlQiLCJDT01NSVQiLCJDT01NSVRURUQiLCJDT01QUkVTU0VEIiwiQ09OQ1VSUkVOVCIsIkNPTlNUUkFJTlQiLCJDT05UQUlOUyIsIkNPTlZFUlQiLCJDUkVBVEUiLCJDUk9TUyIsIkNVUlJFTlRfVElNRVNUQU1QIiwiREFUQUJBU0UiLCJEQVRBQkFTRVMiLCJEQVkiLCJEQVlfSE9VUiIsIkRBWV9NSU5VVEUiLCJEQVlfU0VDT05EIiwiREVGQVVMVCIsIkRFRklORVIiLCJERUxBWUVEIiwiREVMRVRFIiwiREVTQyIsIkRFU0NSSUJFIiwiREVURVJNSU5JU1RJQyIsIkRJU1RJTkNUIiwiRElTVElOQ1RST1ciLCJESVYiLCJETyIsIkRST1AiLCJEVU1QRklMRSIsIkRVUExJQ0FURSIsIkRZTkFNSUMiLCJFTFNFIiwiRU5DTE9TRUQiLCJFTkQiLCJFTkdJTkUiLCJFTkdJTkVTIiwiRU5HSU5FX1RZUEUiLCJFU0NBUEUiLCJFU0NBUEVEIiwiRVZFTlRTIiwiRVhFQyIsIkVYRUNVVEUiLCJFWElTVFMiLCJFWFBMQUlOIiwiRVhURU5ERUQiLCJGQVNUIiwiRkVUQ0giLCJGSUVMRFMiLCJGSUxFIiwiRklSU1QiLCJGSVhFRCIsIkZMVVNIIiwiRk9SIiwiRk9SQ0UiLCJGT1JFSUdOIiwiRlVMTCIsIkZVTExURVhUIiwiRlVOQ1RJT04iLCJHTE9CQUwiLCJHUkFOVCIsIkdSQU5UUyIsIkdST1VQX0NPTkNBVCIsIkhFQVAiLCJISUdIX1BSSU9SSVRZIiwiSE9TVFMiLCJIT1VSIiwiSE9VUl9NSU5VVEUiLCJIT1VSX1NFQ09ORCIsIklERU5USUZJRUQiLCJJRiIsIklGTlVMTCIsIklHTk9SRSIsIklOIiwiSU5ERVgiLCJJTkRFWEVTIiwiSU5GSUxFIiwiSU5TRVJUIiwiSU5TRVJUX0lEIiwiSU5TRVJUX01FVEhPRCIsIklOVEVSVkFMIiwiSU5UTyIsIklOVk9LRVIiLCJJUyIsIklTT0xBVElPTiIsIktFWSIsIktFWVMiLCJLSUxMIiwiTEFTVF9JTlNFUlRfSUQiLCJMRUFESU5HIiwiTEVWRUwiLCJMSUtFIiwiTElORUFSIiwiTElORVMiLCJMT0FEIiwiTE9DQUwiLCJMT0NLIiwiTE9DS1MiLCJMT0dTIiwiTE9XX1BSSU9SSVRZIiwiTUFSSUEiLCJNQVNURVIiLCJNQVNURVJfQ09OTkVDVF9SRVRSWSIsIk1BU1RFUl9IT1NUIiwiTUFTVEVSX0xPR19GSUxFIiwiTUFUQ0giLCJNQVhfQ09OTkVDVElPTlNfUEVSX0hPVVIiLCJNQVhfUVVFUklFU19QRVJfSE9VUiIsIk1BWF9ST1dTIiwiTUFYX1VQREFURVNfUEVSX0hPVVIiLCJNQVhfVVNFUl9DT05ORUNUSU9OUyIsIk1FRElVTSIsIk1FUkdFIiwiTUlOVVRFIiwiTUlOVVRFX1NFQ09ORCIsIk1JTl9ST1dTIiwiTU9ERSIsIk1PRElGWSIsIk1PTlRIIiwiTVJHX01ZSVNBTSIsIk1ZSVNBTSIsIk5BTUVTIiwiTkFUVVJBTCIsIk5PVCIsIk5PVygpIiwiTlVMTCIsIk9GRlNFVCIsIk9OIERFTEVURSIsIk9OIFVQREFURSIsIk9OIiwiT05MWSIsIk9QRU4iLCJPUFRJTUlaRSIsIk9QVElPTiIsIk9QVElPTkFMTFkiLCJPVVRGSUxFIiwiUEFDS19LRVlTIiwiUEFHRSIsIlBBUlRJQUwiLCJQQVJUSVRJT04iLCJQQVJUSVRJT05TIiwiUEFTU1dPUkQiLCJQUklNQVJZIiwiUFJJVklMRUdFUyIsIlBST0NFRFVSRSIsIlBST0NFU1MiLCJQUk9DRVNTTElTVCIsIlBVUkdFIiwiUVVJQ0siLCJSQUlEMCIsIlJBSURfQ0hVTktTIiwiUkFJRF9DSFVOS1NJWkUiLCJSQUlEX1RZUEUiLCJSQU5HRSIsIlJFQUQiLCJSRUFEX09OTFkiLCJSRUFEX1dSSVRFIiwiUkVGRVJFTkNFUyIsIlJFR0VYUCIsIlJFTE9BRCIsIlJFTkFNRSIsIlJFUEFJUiIsIlJFUEVBVEFCTEUiLCJSRVBMQUNFIiwiUkVQTElDQVRJT04iLCJSRVNFVCIsIlJFU1RPUkUiLCJSRVNUUklDVCIsIlJFVFVSTiIsIlJFVFVSTlMiLCJSRVZPS0UiLCJSTElLRSIsIlJPTExCQUNLIiwiUk9XIiwiUk9XUyIsIlJPV19GT1JNQVQiLCJTRUNPTkQiLCJTRUNVUklUWSIsIlNFUEFSQVRPUiIsIlNFUklBTElaQUJMRSIsIlNFU1NJT04iLCJTSEFSRSIsIlNIT1ciLCJTSFVURE9XTiIsIlNMQVZFIiwiU09OQU1FIiwiU09VTkRTIiwiU1FMIiwiU1FMX0FVVE9fSVNfTlVMTCIsIlNRTF9CSUdfUkVTVUxUIiwiU1FMX0JJR19TRUxFQ1RTIiwiU1FMX0JJR19UQUJMRVMiLCJTUUxfQlVGRkVSX1JFU1VMVCIsIlNRTF9DQUNIRSIsIlNRTF9DQUxDX0ZPVU5EX1JPV1MiLCJTUUxfTE9HX0JJTiIsIlNRTF9MT0dfT0ZGIiwiU1FMX0xPR19VUERBVEUiLCJTUUxfTE9XX1BSSU9SSVRZX1VQREFURVMiLCJTUUxfTUFYX0pPSU5fU0laRSIsIlNRTF9OT19DQUNIRSIsIlNRTF9RVU9URV9TSE9XX0NSRUFURSIsIlNRTF9TQUZFX1VQREFURVMiLCJTUUxfU0VMRUNUX0xJTUlUIiwiU1FMX1NMQVZFX1NLSVBfQ09VTlRFUiIsIlNRTF9TTUFMTF9SRVNVTFQiLCJTUUxfV0FSTklOR1MiLCJTVEFSVCIsIlNUQVJUSU5HIiwiU1RBVFVTIiwiU1RPUCIsIlNUT1JBR0UiLCJTVFJBSUdIVF9KT0lOIiwiU1RSSU5HIiwiU1RSSVBFRCIsIlNVUEVSIiwiVEFCTEUiLCJUQUJMRVMiLCJURU1QT1JBUlkiLCJURVJNSU5BVEVEIiwiVEhFTiIsIlRPIiwiVFJBSUxJTkciLCJUUkFOU0FDVElPTkFMIiwiVFJVRSIsIlRSVU5DQVRFIiwiVFlQRSIsIlRZUEVTIiwiVU5DT01NSVRURUQiLCJVTklRVUUiLCJVTkxPQ0siLCJVTlNJR05FRCIsIlVTQUdFIiwiVVNFIiwiVVNJTkciLCJWQVJJQUJMRVMiLCJWSUVXIiwiV0hFTiIsIldJVEgiLCJXT1JLIiwiV1JJVEUiLCJZRUFSX01PTlRIIl0sTz1bIkFERCIsIkFGVEVSIiwiQUxURVIgQ09MVU1OIiwiQUxURVIgVEFCTEUiLCJERUxFVEUgRlJPTSIsIkVYQ0VQVCIsIkZFVENIIEZJUlNUIiwiRlJPTSIsIkdST1VQIEJZIiwiR08iLCJIQVZJTkciLCJJTlNFUlQgSU5UTyIsIklOU0VSVCIsIklOVEVSU0VDVCIsIkxJTUlUIiwiTU9ESUZZIiwiT1JERVIgQlkiLCJTRUxFQ1QiLCJTRVQgQ1VSUkVOVCBTQ0hFTUEiLCJTRVQgU0NIRU1BIiwiU0VUIiwiVU5JT04gQUxMIiwiVU5JT04iLCJVUERBVEUiLCJWQUxVRVMiLCJXSEVSRSJdLGk9WyJBTkQiLCJDUk9TUyBBUFBMWSIsIkNST1NTIEpPSU4iLCJFTFNFIiwiSU5ORVIgSk9JTiIsIkpPSU4iLCJMRUZUIEpPSU4iLCJMRUZUIE9VVEVSIEpPSU4iLCJPUiIsIk9VVEVSIEFQUExZIiwiT1VURVIgSk9JTiIsIlJJR0hUIEpPSU4iLCJSSUdIVCBPVVRFUiBKT0lOIiwiV0hFTiIsIlhPUiJdLFM9dm9pZCAwLHU9ZnVuY3Rpb24oKXtmdW5jdGlvbiBlKEUpeygwLFRbImRlZmF1bHQiXSkodGhpcyxlKSx0aGlzLmNmZz1FfXJldHVybiBlLnByb3RvdHlwZS5mb3JtYXQ9ZnVuY3Rpb24oZSl7cmV0dXJuIFN8fChTPW5ldyBBWyJkZWZhdWx0Il0oe3Jlc2VydmVkV29yZHM6SSxyZXNlcnZlZFRvcGxldmVsV29yZHM6TyxyZXNlcnZlZE5ld2xpbmVXb3JkczppLHN0cmluZ1R5cGVzOlsnIiInLCJOJyciLCInJyIsImBgIiwiW10iXSxvcGVuUGFyZW5zOlsiKCIsIkNBU0UiXSxjbG9zZVBhcmVuczpbIikiLCJFTkQiXSxpbmRleGVkUGxhY2Vob2xkZXJUeXBlczpbIj8iXSxuYW1lZFBsYWNlaG9sZGVyVHlwZXM6WyJAIiwiOiJdLGxpbmVDb21tZW50VHlwZXM6WyIjIiwiLS0iXX0pKSxuZXcgb1siZGVmYXVsdCJdKHRoaXMuY2ZnLFMpLmZvcm1hdChlKX0sZX0oKTtFWyJkZWZhdWx0Il09dSxlLmV4cG9ydHM9RVsiZGVmYXVsdCJdfSxmdW5jdGlvbihlLEUsdCl7dmFyIG49dCgzKSxyPXQoMiksVD1uKHIsIkRhdGFWaWV3Iik7ZS5leHBvcnRzPVR9LGZ1bmN0aW9uKGUsRSx0KXt2YXIgbj10KDMpLHI9dCgyKSxUPW4ociwiTWFwIik7ZS5leHBvcnRzPVR9LGZ1bmN0aW9uKGUsRSx0KXt2YXIgbj10KDMpLHI9dCgyKSxUPW4ociwiUHJvbWlzZSIpO2UuZXhwb3J0cz1UfSxmdW5jdGlvbihlLEUsdCl7dmFyIG49dCgzKSxyPXQoMiksVD1uKHIsIlNldCIpO2UuZXhwb3J0cz1UfSxmdW5jdGlvbihlLEUsdCl7dmFyIG49dCgyKSxyPW4uU3ltYm9sO2UuZXhwb3J0cz1yfSxmdW5jdGlvbihlLEUsdCl7dmFyIG49dCgzKSxyPXQoMiksVD1uKHIsIldlYWtNYXAiKTtlLmV4cG9ydHM9VH0sZnVuY3Rpb24oZSxFKXtmdW5jdGlvbiB0KGUpe3JldHVybiBlLnNwbGl0KCIiKX1lLmV4cG9ydHM9dH0sZnVuY3Rpb24oZSxFKXtmdW5jdGlvbiB0KGUsRSx0LG4pe2Zvcih2YXIgcj1lLmxlbmd0aCxUPXQrKG4/MTotMSk7bj9ULS06KytUPHI7KWlmKEUoZVtUXSxULGUpKXJldHVybiBUOwpyZXR1cm4tMX1lLmV4cG9ydHM9dH0sZnVuY3Rpb24oZSxFKXtmdW5jdGlvbiB0KGUpe3JldHVybiByLmNhbGwoZSl9dmFyIG49T2JqZWN0LnByb3RvdHlwZSxyPW4udG9TdHJpbmc7ZS5leHBvcnRzPXR9LGZ1bmN0aW9uKGUsRSx0KXtmdW5jdGlvbiBuKGUsRSx0KXtyZXR1cm4gRT09PUU/UihlLEUsdCk6cihlLFQsdCl9dmFyIHI9dCgyOSksVD10KDMyKSxSPXQoNDkpO2UuZXhwb3J0cz1ufSxmdW5jdGlvbihlLEUpe2Z1bmN0aW9uIHQoZSl7cmV0dXJuIGUhPT1lfWUuZXhwb3J0cz10fSxmdW5jdGlvbihlLEUsdCl7ZnVuY3Rpb24gbihlKXtpZighUihlKXx8VChlKSlyZXR1cm4hMTt2YXIgRT1yKGUpP3U6QTtyZXR1cm4gRS50ZXN0KG8oZSkpfXZhciByPXQoMTIpLFQ9dCg0NSksUj10KDYpLG89dCgxMSksTj0vW1xcXiQuKis/KClbXF17fXxdL2csQT0vXlxbb2JqZWN0IC4rP0NvbnN0cnVjdG9yXF0kLyxJPUZ1bmN0aW9uLnByb3RvdHlwZSxPPU9iamVjdC5wcm90b3R5cGUsaT1JLnRvU3RyaW5nLFM9Ty5oYXNPd25Qcm9wZXJ0eSx1PVJlZ0V4cCgiXiIraS5jYWxsKFMpLnJlcGxhY2UoTiwiXFwkJiIpLnJlcGxhY2UoL2hhc093blByb3BlcnR5fChmdW5jdGlvbikuKj8oPz1cXFwoKXwgZm9yIC4rPyg/PVxcXF0pL2csIiQxLio/IikrIiQiKTtlLmV4cG9ydHM9bn0sZnVuY3Rpb24oZSxFKXtmdW5jdGlvbiB0KGUsRSl7dmFyIHQ9IiI7aWYoIWV8fDE+RXx8RT5uKXJldHVybiB0O2RvIEUlMiYmKHQrPWUpLEU9cihFLzIpLEUmJihlKz1lKTt3aGlsZShFKTtyZXR1cm4gdH12YXIgbj05MDA3MTk5MjU0NzQwOTkxLHI9TWF0aC5mbG9vcjtlLmV4cG9ydHM9dH0sZnVuY3Rpb24oZSxFKXtmdW5jdGlvbiB0KGUsRSx0KXt2YXIgbj0tMSxyPWUubGVuZ3RoOzA+RSYmKEU9LUU+cj8wOnIrRSksdD10PnI/cjp0LDA+dCYmKHQrPXIpLHI9RT50PzA6dC1FPj4+MCxFPj4+PTA7Zm9yKHZhciBUPUFycmF5KHIpOysrbjxyOylUW25dPWVbbitFXTtyZXR1cm4gVH1lLmV4cG9ydHM9dH0sZnVuY3Rpb24oZSxFLHQpe2Z1bmN0aW9uIG4oZSxFLHQpe3ZhciBuPWUubGVuZ3RoO3JldHVybiB0PXZvaWQgMD09PXQ/bjp0LEV8fG4+dD9yKGUsRSx0KTplfXZhciByPXQoMzUpO2UuZXhwb3J0cz1ufSxmdW5jdGlvbihlLEUsdCl7ZnVuY3Rpb24gbihlLEUpe2Zvcih2YXIgdD1lLmxlbmd0aDt0LS0mJnIoRSxlW3RdLDApPi0xOyk7cmV0dXJuIHR9dmFyIHI9dCgzMSk7ZS5leHBvcnRzPW59LGZ1bmN0aW9uKGUsRSx0KXt2YXIgbj10KDIpLHI9blsiX19jb3JlLWpzX3NoYXJlZF9fIl07ZS5leHBvcnRzPXJ9LGZ1bmN0aW9uKGUsRSl7KGZ1bmN0aW9uKEUpe3ZhciB0PSJvYmplY3QiPT10eXBlb2YgRSYmRSYmRS5PYmplY3Q9PT1PYmplY3QmJkU7ZS5leHBvcnRzPXR9KS5jYWxsKEUsZnVuY3Rpb24oKXtyZXR1cm4gdGhpc30oKSl9LGZ1bmN0aW9uKGUsRSx0KXt2YXIgbj10KDIyKSxyPXQoMjMpLFQ9dCgyNCksUj10KDI1KSxvPXQoMjcpLE49dCgzMCksQT10KDExKSxJPSJbb2JqZWN0IE1hcF0iLE89IltvYmplY3QgT2JqZWN0XSIsaT0iW29iamVjdCBQcm9taXNlXSIsUz0iW29iamVjdCBTZXRdIix1PSJbb2JqZWN0IFdlYWtNYXBdIixMPSJbb2JqZWN0IERhdGFWaWV3XSIsQz1PYmplY3QucHJvdG90eXBlLHM9Qy50b1N0cmluZyxhPUEobiksZj1BKHIpLGM9QShUKSxwPUEoUiksbD1BKG8pLEQ9TjsobiYmRChuZXcgbihuZXcgQXJyYXlCdWZmZXIoMSkpKSE9THx8ciYmRChuZXcgcikhPUl8fFQmJkQoVC5yZXNvbHZlKCkpIT1pfHxSJiZEKG5ldyBSKSE9U3x8byYmRChuZXcgbykhPXUpJiYoRD1mdW5jdGlvbihlKXt2YXIgRT1zLmNhbGwoZSksdD1FPT1PP2UuY29uc3RydWN0b3I6dm9pZCAwLG49dD9BKHQpOnZvaWQgMDtpZihuKXN3aXRjaChuKXtjYXNlIGE6cmV0dXJuIEw7Y2FzZSBmOnJldHVybiBJO2Nhc2UgYzpyZXR1cm4gaTtjYXNlIHA6cmV0dXJuIFM7Y2FzZSBsOnJldHVybiB1fXJldHVybiBFfSksZS5leHBvcnRzPUR9LGZ1bmN0aW9uKGUsRSl7ZnVuY3Rpb24gdChlLEUpe3JldHVybiBudWxsPT1lP3ZvaWQgMDplW0VdfWUuZXhwb3J0cz10fSxmdW5jdGlvbihlLEUpe2Z1bmN0aW9uIHQoZSl7cmV0dXJuIE4udGVzdChlKX12YXIgbj0iXFx1ZDgwMC1cXHVkZmZmIixyPSJcXHUwMzAwLVxcdTAzNmZcXHVmZTIwLVxcdWZlMjMiLFQ9IlxcdTIwZDAtXFx1MjBmMCIsUj0iXFx1ZmUwZVxcdWZlMGYiLG89IlxcdTIwMGQiLE49UmVnRXhwKCJbIitvK24rcitUK1IrIl0iKTtlLmV4cG9ydHM9dH0sZnVuY3Rpb24oZSxFKXtmdW5jdGlvbiB0KGUsRSl7cmV0dXJuIEU9bnVsbD09RT9uOkUsISFFJiYoIm51bWJlciI9PXR5cGVvZiBlfHxyLnRlc3QoZSkpJiZlPi0xJiZlJTE9PTAmJkU+ZX12YXIgbj05MDA3MTk5MjU0NzQwOTkxLHI9L14oPzowfFsxLTldXGQqKSQvO2UuZXhwb3J0cz10fSxmdW5jdGlvbihlLEUsdCl7ZnVuY3Rpb24gbihlLEUsdCl7aWYoIW8odCkpcmV0dXJuITE7dmFyIG49dHlwZW9mIEU7cmV0dXJuISEoIm51bWJlciI9PW4/VCh0KSYmUihFLHQubGVuZ3RoKToic3RyaW5nIj09biYmRSBpbiB0KSYmcih0W0VdLGUpfXZhciByPXQoNTIpLFQ9dCg4KSxSPXQoNDMpLG89dCg2KTtlLmV4cG9ydHM9bn0sZnVuY3Rpb24oZSxFLHQpe2Z1bmN0aW9uIG4oZSl7cmV0dXJuISFUJiZUIGluIGV9dmFyIHI9dCgzOCksVD1mdW5jdGlvbigpe3ZhciBlPS9bXi5dKyQvLmV4ZWMociYmci5rZXlzJiZyLmtleXMuSUVfUFJPVE98fCIiKTtyZXR1cm4gZT8iU3ltYm9sKHNyYylfMS4iK2U6IiJ9KCk7ZS5leHBvcnRzPW59LGZ1bmN0aW9uKGUsRSl7ZnVuY3Rpb24gdChlKXt2YXIgRT1lJiZlLmNvbnN0cnVjdG9yLHQ9ImZ1bmN0aW9uIj09dHlwZW9mIEUmJkUucHJvdG90eXBlfHxuO3JldHVybiBlPT09dH12YXIgbj1PYmplY3QucHJvdG90eXBlO2UuZXhwb3J0cz10fSxmdW5jdGlvbihlLEUsdCl7dmFyIG49dCg0OCkscj1uKE9iamVjdC5rZXlzLE9iamVjdCk7ZS5leHBvcnRzPXJ9LGZ1bmN0aW9uKGUsRSl7ZnVuY3Rpb24gdChlLEUpe3JldHVybiBmdW5jdGlvbih0KXtyZXR1cm4gZShFKHQpKX19ZS5leHBvcnRzPXR9LGZ1bmN0aW9uKGUsRSl7ZnVuY3Rpb24gdChlLEUsdCl7Zm9yKHZhciBuPXQtMSxyPWUubGVuZ3RoOysrbjxyOylpZihlW25dPT09RSlyZXR1cm4gbjtyZXR1cm4tMX1lLmV4cG9ydHM9dH0sZnVuY3Rpb24oZSxFLHQpe2Z1bmN0aW9uIG4oZSl7cmV0dXJuIFQoZSk/UihlKTpyKGUpfXZhciByPXQoMjgpLFQ9dCg0MiksUj10KDUxKTtlLmV4cG9ydHM9bn0sZnVuY3Rpb24oZSxFKXtmdW5jdGlvbiB0KGUpe3JldHVybiBlLm1hdGNoKGMpfHxbXX12YXIgbj0iXFx1ZDgwMC1cXHVkZmZmIixyPSJcXHUwMzAwLVxcdTAzNmZcXHVmZTIwLVxcdWZlMjMiLFQ9IlxcdTIwZDAtXFx1MjBmMCIsUj0iXFx1ZmUwZVxcdWZlMGYiLG89IlsiK24rIl0iLE49IlsiK3IrVCsiXSIsQT0iXFx1ZDgzY1tcXHVkZmZiLVxcdWRmZmZdIixJPSIoPzoiK04rInwiK0ErIikiLE89IlteIituKyJdIixpPSIoPzpcXHVkODNjW1xcdWRkZTYtXFx1ZGRmZl0pezJ9IixTPSJbXFx1ZDgwMC1cXHVkYmZmXVtcXHVkYzAwLVxcdWRmZmZdIix1PSJcXHUyMDBkIixMPUkrIj8iLEM9IlsiK1IrIl0/IixzPSIoPzoiK3UrIig/OiIrW08saSxTXS5qb2luKCJ8IikrIikiK0MrTCsiKSoiLGE9QytMK3MsZj0iKD86IitbTytOKyI/IixOLGksUyxvXS5qb2luKCJ8IikrIikiLGM9UmVnRXhwKEErIig/PSIrQSsiKXwiK2YrYSwiZyIpO2UuZXhwb3J0cz10fSxmdW5jdGlvbihlLEUpe2Z1bmN0aW9uIHQoZSxFKXtyZXR1cm4gZT09PUV8fGUhPT1lJiZFIT09RX1lLmV4cG9ydHM9dH0sZnVuY3Rpb24oZSxFLHQpe2Z1bmN0aW9uIG4oZSl7cmV0dXJuIGU9cihlKSxlJiZSLnRlc3QoZSk/ZS5yZXBsYWNlKFQsIlxcJCYiKTplfXZhciByPXQoOSksVD0vW1xcXiQuKis/KClbXF17fXxdL2csUj1SZWdFeHAoVC5zb3VyY2UpO2UuZXhwb3J0cz1ufSxmdW5jdGlvbihlLEUsdCl7ZnVuY3Rpb24gbihlKXtyZXR1cm4gcihlKSYmby5jYWxsKGUsImNhbGxlZSIpJiYoIUEuY2FsbChlLCJjYWxsZWUiKXx8Ti5jYWxsKGUpPT1UKX12YXIgcj10KDU2KSxUPSJbb2JqZWN0IEFyZ3VtZW50c10iLFI9T2JqZWN0LnByb3RvdHlwZSxvPVIuaGFzT3duUHJvcGVydHksTj1SLnRvU3RyaW5nLEE9Ui5wcm9wZXJ0eUlzRW51bWVyYWJsZTtlLmV4cG9ydHM9bn0sZnVuY3Rpb24oZSxFKXt2YXIgdD1BcnJheS5pc0FycmF5O2UuZXhwb3J0cz10fSxmdW5jdGlvbihlLEUsdCl7ZnVuY3Rpb24gbihlKXtyZXR1cm4gVChlKSYmcihlKX12YXIgcj10KDgpLFQ9dCgxMyk7ZS5leHBvcnRzPW59LGZ1bmN0aW9uKGUsRSx0KXsoZnVuY3Rpb24oZSl7dmFyIG49dCgyKSxyPXQoNjIpLFQ9Im9iamVjdCI9PXR5cGVvZiBFJiZFJiYhRS5ub2RlVHlwZSYmRSxSPVQmJiJvYmplY3QiPT10eXBlb2YgZSYmZSYmIWUubm9kZVR5cGUmJmUsbz1SJiZSLmV4cG9ydHM9PT1ULE49bz9uLkJ1ZmZlcjp2b2lkIDAsQT1OP04uaXNCdWZmZXI6dm9pZCAwLEk9QXx8cjtlLmV4cG9ydHM9SX0pLmNhbGwoRSx0KDY3KShlKSl9LGZ1bmN0aW9uKGUsRSx0KXtmdW5jdGlvbiBuKGUpe2lmKG8oZSkmJihSKGUpfHwic3RyaW5nIj09dHlwZW9mIGV8fCJmdW5jdGlvbiI9PXR5cGVvZiBlLnNwbGljZXx8TihlKXx8VChlKSkpcmV0dXJuIWUubGVuZ3RoO3ZhciBFPXIoZSk7aWYoRT09T3x8RT09aSlyZXR1cm4hZS5zaXplO2lmKEEoZSkpcmV0dXJuIUkoZSkubGVuZ3RoO2Zvcih2YXIgdCBpbiBlKWlmKHUuY2FsbChlLHQpKXJldHVybiExO3JldHVybiEwfXZhciByPXQoNDApLFQ9dCg1NCksUj10KDU1KSxvPXQoOCksTj10KDU3KSxBPXQoNDYpLEk9dCg0NyksTz0iW29iamVjdCBNYXBdIixpPSJbb2JqZWN0IFNldF0iLFM9T2JqZWN0LnByb3RvdHlwZSx1PVMuaGFzT3duUHJvcGVydHk7ZS5leHBvcnRzPW59LGZ1bmN0aW9uKGUsRSl7ZnVuY3Rpb24gdChlKXtyZXR1cm4ibnVtYmVyIj09dHlwZW9mIGUmJmU+LTEmJmUlMT09MCYmbj49ZX12YXIgbj05MDA3MTk5MjU0NzQwOTkxO2UuZXhwb3J0cz10fSxmdW5jdGlvbihlLEUpe2Z1bmN0aW9uIHQoZSl7dmFyIEU9ZT9lLmxlbmd0aDowO3JldHVybiBFP2VbRS0xXTp2b2lkIDB9ZS5leHBvcnRzPXR9LGZ1bmN0aW9uKGUsRSx0KXtmdW5jdGlvbiBuKGUsRSx0KXtyZXR1cm4gRT0odD9UKGUsRSx0KTp2b2lkIDA9PT1FKT8xOlIoRSkscihvKGUpLEUpfXZhciByPXQoMzQpLFQ9dCg0NCksUj10KDY0KSxvPXQoOSk7ZS5leHBvcnRzPW59LGZ1bmN0aW9uKGUsRSl7ZnVuY3Rpb24gdCgpe3JldHVybiExfWUuZXhwb3J0cz10fSxmdW5jdGlvbihlLEUsdCl7ZnVuY3Rpb24gbihlKXtpZighZSlyZXR1cm4gMD09PWU/ZTowO2lmKGU9cihlKSxlPT09VHx8ZT09PS1UKXt2YXIgRT0wPmU/LTE6MTtyZXR1cm4gRSpSfXJldHVybiBlPT09ZT9lOjB9dmFyIHI9dCg2NSksVD0xLzAsUj0xLjc5NzY5MzEzNDg2MjMxNTdlMzA4O2UuZXhwb3J0cz1ufSxmdW5jdGlvbihlLEUsdCl7ZnVuY3Rpb24gbihlKXt2YXIgRT1yKGUpLHQ9RSUxO3JldHVybiBFPT09RT90P0UtdDpFOjB9dmFyIHI9dCg2Myk7ZS5leHBvcnRzPW59LGZ1bmN0aW9uKGUsRSx0KXtmdW5jdGlvbiBuKGUpe2lmKCJudW1iZXIiPT10eXBlb2YgZSlyZXR1cm4gZTtpZihUKGUpKXJldHVybiBSO2lmKHIoZSkpe3ZhciBFPSJmdW5jdGlvbiI9PXR5cGVvZiBlLnZhbHVlT2Y/ZS52YWx1ZU9mKCk6ZTtlPXIoRSk/RSsiIjpFfWlmKCJzdHJpbmciIT10eXBlb2YgZSlyZXR1cm4gMD09PWU/ZTorZTtlPWUucmVwbGFjZShvLCIiKTt2YXIgdD1BLnRlc3QoZSk7cmV0dXJuIHR8fEkudGVzdChlKT9PKGUuc2xpY2UoMiksdD8yOjgpOk4udGVzdChlKT9SOitlfXZhciByPXQoNiksVD10KDE0KSxSPU5hTixvPS9eXHMrfFxzKyQvZyxOPS9eWy0rXTB4WzAtOWEtZl0rJC9pLEE9L14wYlswMV0rJC9pLEk9L14wb1swLTddKyQvaSxPPXBhcnNlSW50O2UuZXhwb3J0cz1ufSxmdW5jdGlvbihlLEUsdCl7ZnVuY3Rpb24gbihlLEUsdCl7aWYoZT1OKGUpLGUmJih0fHx2b2lkIDA9PT1FKSlyZXR1cm4gZS5yZXBsYWNlKEEsIiIpO2lmKCFlfHwhKEU9cihFKSkpcmV0dXJuIGU7dmFyIG49byhlKSxJPVIobixvKEUpKSsxO3JldHVybiBUKG4sMCxJKS5qb2luKCIiKX12YXIgcj10KDEwKSxUPXQoMzYpLFI9dCgzNyksbz10KDUwKSxOPXQoOSksQT0vXHMrJC87ZS5leHBvcnRzPW59LGZ1bmN0aW9uKGUsRSl7ZS5leHBvcnRzPWZ1bmN0aW9uKGUpe3JldHVybiBlLndlYnBhY2tQb2x5ZmlsbHx8KGUuZGVwcmVjYXRlPWZ1bmN0aW9uKCl7fSxlLnBhdGhzPVtdLGUuY2hpbGRyZW49W10sZS53ZWJwYWNrUG9seWZpbGw9MSksZX19XSl9KTsKCgkJZnVuY3Rpb24gZXNjYXBlMkh0bWwoc3RyKSB7CiAgICAJICAgIHZhciBhcnJFbnRpdGllcyA9IHsnbHQnOiAnPCcsICdndCc6ICc+JywgJ25ic3AnOiAnJywgJ2FtcCc6ICcmJywgJ3F1b3QnOiAnIid9OwogICAgCSAgICByZXR1cm4gc3RyLnJlcGxhY2UoLyYobHR8Z3R8bmJzcHxhbXB8cXVvdCk7L2lnLCBmdW5jdGlvbiAoYWxsLCB0KSB7CiAgICAJICAgICAgICByZXR1cm4gYXJyRW50aXRpZXNbdF07CiAgICAJICAgIH0pOwogICAgCX0KCQogICAgCWZ1bmN0aW9uIGxvYWQoKSB7CiAgICAJICAgIGxldCBjb2RlTGlzdCA9IGRvY3VtZW50LmdldEVsZW1lbnRzQnlDbGFzc05hbWUoJ2xhbmd1YWdlLXNxbCcpOwoJCiAgICAJICAgIGZvciAobGV0IGkgPSAwIDtpPGNvZGVMaXN0Lmxlbmd0aDtpKyspIHsKICAgIAkgICAgICAgIGNvZGVMaXN0W2ldLmlubmVySFRNTCA9IHdpbmRvdy5zcWxGb3JtYXR0ZXIuZm9ybWF0KGVzY2FwZTJIdG1sKGNvZGVMaXN0W2ldLmlubmVySFRNTCkpCiAgICAJICAgIH0KICAgIAl9Owo=
`

// MarkdownEscape markdown格式转义,原样输出
func MarkdownEscape(str string) string {
	for _, b := range "_`*" {
		str = strings.Replace(str, string(b), "\\"+string(b), -1)
	}
	return str
}

// loadExternalResource load js/css resource from http[s] url
func loadExternalResource(resource string) string {
	var content string
	var body []byte
	if strings.HasPrefix(resource, "http") {
		resp, err := http.Get(resource)
		if err != nil {
			Log.Error("http.Get %s Error: %v", resource, err)
			return content
		}
		defer resp.Body.Close()

		body, err = ioutil.ReadAll(resp.Body)
		if err != nil {
			Log.Error("ioutil.ReadAll %s Error: %v", resource, err)
		} else {
			content = string(body)
		}
	} else {
		fd, err := os.Open(resource)
		if err != nil {
			Log.Error("os.Open %s Error: %v", resource, err)
			return content
		}
		defer fd.Close()

		body, err = ioutil.ReadAll(fd)
		if err != nil {
			Log.Error("ioutil.ReadAll %s Error: %v", resource, err)
		} else {
			content = string(body)
		}
	}
	return content
}

// MarkdownHTMLHeader markdown 转 HTML 输出时添加 HTML 头
func MarkdownHTMLHeader() string {
	// load css
	var css string
	if Config.ReportCSS == "" {
		css = BuiltinCSS
	} else {
		css = loadExternalResource(Config.ReportCSS)
	}

	// load javascript
	var js string
	if Config.ReportJavascript == "" {
		decode, _ := base64.StdEncoding.DecodeString(BuiltinJavascript)
		js = string(decode)
	} else {
		js = loadExternalResource(Config.ReportJavascript)
	}

	header := `

` + Config.ReportTitle + `




`
	return header
}

// Markdown2HTML markdown 转 HTML 输出
func Markdown2HTML(buf string) string {
	// extensions default: 94
	// extensions |= blackfriday.EXTENSION_TABLES
	// extensions |= blackfriday.EXTENSION_FENCED_CODE
	// extensions |= blackfriday.EXTENSION_AUTOLINK
	// extensions |= blackfriday.EXTENSION_STRIKETHROUGH
	// extensions |= blackfriday.EXTENSION_SPACE_HEADERS
	extensions := Config.MarkdownExtensions

	// htmlFlags
	htmlFlags := Config.MarkdownHTMLFlags

	renderer := blackfriday.HtmlRenderer(htmlFlags, "", "")
	buf = string(blackfriday.Markdown([]byte(buf), renderer, extensions))
	return buf
}

// Score SQL评审打分
func Score(score int) string {
	// 不需要打分的功能
	switch Config.ReportType {
	case "duplicate-key-checker", "explain-digest":
		return ""
	}
	s1, s2 := "★ ", "☆ "
	if score > 100 {
		score = 100
		Log.Debug("Score Error: score larger than 100, %d", score)
	}
	if score < 0 {
		score = 0
		Log.Debug("Score Warn: score less than 0, %d", score)
	}
	s1Count := score / 20
	s2Count := 5 - s1Count
	str := fmt.Sprintf("%s %d分", strings.TrimSpace(strings.Repeat(s1, s1Count)+strings.Repeat(s2, s2Count)), score)
	return str
}


================================================
FILE: common/markdown_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"fmt"
	"io"
	"io/ioutil"
	"os"
	"path/filepath"
	"testing"
)

func TestMarkdownEscape(_ *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	var strs = []string{
		"a`bc",
		"abc",
		"a'bc",
		"a\"bc",
	}
	for _, str := range strs {
		fmt.Println(MarkdownEscape(str))
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestMarkdown2Html(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	md := filepath.Join("testdata", t.Name()+".md")
	buf, err := ioutil.ReadFile(md)
	if err != nil {
		t.Error(err.Error())
	}
	err = GoldenDiff(func() {
		fmt.Println(Markdown2HTML(string(buf)))
	}, t.Name(), update)
	if nil != err {
		t.Fatal(err)
	}

	// golden 文件拷贝成 html 文件,这步是给人看的
	gd, err := os.OpenFile("testdata/"+t.Name()+".golden", os.O_RDONLY, 0666)
	if nil != err {
		t.Fatal(err)
	}
	html, err := os.OpenFile("testdata/"+t.Name()+".html", os.O_CREATE|os.O_RDWR, 0666)
	if nil != err {
		t.Fatal(err)
	}
	io.Copy(html, gd)
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestScore(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	scores := map[int]string{
		50:  "★ ★ ☆ ☆ ☆ 50分",
		100: "★ ★ ★ ★ ★ 100分",
		-1:  "☆ ☆ ☆ ☆ ☆ 0分",
		101: "★ ★ ★ ★ ★ 100分",
	}
	for score, want := range scores {
		get := Score(score)
		if want != get {
			t.Error(score, want, get)
		}
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestLoadExternalResource(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	buf := loadExternalResource("../doc/themes/github.css")
	if buf == "" {
		t.Error("loadExternalResource local error")
	}
	buf = loadExternalResource("http://www.baidu.com")
	if buf == "" {
		t.Error("loadExternalResource http error")
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestMarkdownHTMLHeader(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	err := GoldenDiff(func() {
		MarkdownHTMLHeader()
	}, t.Name(), update)
	if err != nil {
		t.Error(err)
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}


================================================
FILE: common/meta.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"strconv"
	"strings"
)

// Meta 以 'database' 为 key, DB 的 map, 按 db->table->column 组织的元数据
type Meta map[string]*DB

// DB 数据库相关的结构体
type DB struct {
	Name  string
	Table map[string]*Table // ['table_name']*TableName
}

// NewDB 用于初始化*DB
func NewDB(db string) *DB {
	return &DB{
		Name:  db,
		Table: make(map[string]*Table),
	}
}

// Table 含有表的属性
type Table struct {
	TableName    string
	TableAliases []string
	Column       map[string]*Column
}

// NewTable 初始化*TableName
func NewTable(tb string) *Table {
	return &Table{
		TableName:    tb,
		TableAliases: make([]string, 0),
		Column:       make(map[string]*Column),
	}
}

// KeyType 用于标志每个Key的类别
type KeyType int

// Column 含有列的定义属性
type Column struct {
	Name        string   `json:"col_name"`    // 列名
	Alias       []string `json:"alias"`       // 别名
	Table       string   `json:"tb_name"`     // 表名
	DB          string   `json:"db_name"`     // 数据库名称
	DataType    string   `json:"data_type"`   // 数据类型
	Character   string   `json:"character"`   // 字符集
	Collation   string   `json:"collation"`   // collation
	Cardinality float64  `json:"cardinality"` // 散粒度
	Null        string   `json:"null"`        // 是否为空: YES/NO
	Key         string   `json:"key"`         // 键类型
	Default     string   `json:"default"`     // 默认值
	Extra       string   `json:"extra"`       // 其他
	Comment     string   `json:"comment"`     // 备注
	Privileges  string   `json:"privileges"`  // 权限
}

// TableColumns 这个结构体中的元素是有序的  map[db]map[table][]columns
type TableColumns map[string]map[string][]*Column

// Equal 判断两个column是否相等
func (col *Column) Equal(column *Column) bool {
	return col.Name == column.Name &&
		col.Table == column.Table &&
		col.DB == column.DB
}

// IsColsPart 判断两个column队列是否是包含关系(包括相等)
func IsColsPart(a, b []*Column) bool {
	times := len(a)
	if len(b) < times {
		times = len(b)
	}

	for i := 0; i < times; i++ {
		if strings.ToLower(a[i].DB) != strings.ToLower(b[i].DB) ||
			strings.ToLower(a[i].Table) != strings.ToLower(b[i].Table) ||
			strings.ToLower(a[i].Name) != strings.ToLower(b[i].Name) {
			return false
		}
	}

	return true
}

// JoinColumnsName 将所有的列合并
func JoinColumnsName(cols []*Column, sep string) string {
	name := ""
	for _, col := range cols {
		name += col.Name + sep
	}
	return strings.Trim(name, sep)
}

// Tables 获取 Meta 中指定 db 的所有表名
// Input:数据库名
// Output:表名组成的list
func (b Meta) Tables(db string) []string {
	var result []string
	if b[db] != nil {
		for tb := range b[db].Table {
			result = append(result, tb)
		}

	}
	return result
}

// SetDefault 设置默认值
func (b Meta) SetDefault(defaultDB string) Meta {
	if defaultDB == "" {
		return b
	}

	for db := range b {
		if db == "" {
			// 当获取到的 join 中的 DB 为空的时候,说明 SQL 未显示的指定 DB,即使用的是 rEnv 默认 DB, 需要将表合并到原 DB 中
			if _, ok := b[defaultDB]; ok {
				for tbName, table := range b[""].Table {
					if _, ok := b[defaultDB].Table[tbName]; ok {
						b[defaultDB].Table[tbName].TableAliases = append(
							b[defaultDB].Table[tbName].TableAliases,
							table.TableAliases...,
						)
						continue
					}
					b[defaultDB].Table[tbName] = table
				}
				delete(b, "")
			}

			// 如果没有出现DB指定不一致的情况,直接进行合并
			b[defaultDB] = b[""]
			delete(b, "")
		}
	}

	return b
}

// MergeColumn 将使用到的列按 db->table 组织去重
// 注意:Column 中的 db, table 信息可能为空,需要提前通过env环境补齐再调用该函数。
// @input: 目标列list, 源列list(可以将多个源合并到一个目标列list)
// @output: 合并后的列list
func MergeColumn(dst []*Column, src ...*Column) []*Column {
	var tmp []*Column
	for _, newCol := range src {
		if len(dst) == 0 {
			tmp = append(tmp, newCol)
			continue
		}

		has := false
		for _, oldCol := range dst {
			if (newCol.Name == oldCol.Name) && (newCol.Table == oldCol.Table) && (newCol.DB == oldCol.DB) {
				has = true
			}
		}

		if !has {
			tmp = append(tmp, newCol)
		}

	}
	return append(dst, tmp...)
}

// ColumnSort 通过散粒度对 colList 进行排序, 散粒度排序由大到小
func ColumnSort(colList []*Column) []*Column {
	// 使用冒泡排序保持相等情况下左右两边顺序不变
	if len(colList) < 2 {
		return colList
	}

	for i := 0; i < len(colList)-1; i++ {
		for j := i + 1; j < len(colList); j++ {
			if colList[i].Cardinality < colList[j].Cardinality {
				colList[i], colList[j] = colList[j], colList[i]
			}
		}
	}

	return colList
}

// GetDataTypeBase 获取dataType中的数据类型,忽略长度
func GetDataTypeBase(dataType string) string {
	dataType = strings.TrimSpace(dataType)
	if dataType == "" {
		return dataType
	}
	// smallint unsigned, remove unsigned
	dataType = strings.Fields(dataType)[0]
	// int(10), remote (10)
	if i := strings.Index(dataType, "("); i > 0 {
		return dataType[0:i]
	}

	return dataType
}

// GetDataTypeLength 获取dataType中的数据类型长度
func GetDataTypeLength(dataType string) []int {
	var length []int
	if si := strings.Index(dataType, "("); si > 0 {
		dataLength := dataType[si+1:]
		if ei := strings.Index(dataLength, ")"); ei > 0 {
			dataLength = dataLength[:ei]
			if strings.HasPrefix(dataType, "enum") ||
				strings.HasPrefix(dataType, "set") {
				// set('one', 'two'), enum('G','PG','PG-13','R','NC-17')
				length = []int{len(strings.Split(dataLength, ","))}
			} else {
				// char(10), varchar(10)
				for _, l := range strings.Split(dataLength, ",") {
					v, err := strconv.Atoi(l)
					if err != nil {
						Log.Debug("GetDataTypeLength() Error: %v", err)
						return []int{-1}
					}
					length = append(length, v)
				}
			}
		}
	}

	if len(length) == 0 {
		length = []int{-1}
	}

	return length
}

// GetDataBytes 计算数据类型字节数
// https://dev.mysql.com/doc/refman/8.0/en/storage-requirements.html
// return -1 表示该列无法计算数据大小
func (col *Column) GetDataBytes(dbVersion int) int {
	if col.DataType == "" {
		Log.Warning("Can't get %s.%s data type", col.Table, col.Name)
		return -1
	}
	switch strings.ToLower(GetDataTypeBase(col.DataType)) {
	case "tinyint", "smallint", "mediumint",
		"int", "integer", "bigint",
		"double", "real", "float", "decimal",
		"numeric", "bit", "smallint unsigned":
		// numeric
		return numericStorageReq(col.DataType)

	case "year", "date", "time", "datetime", "timestamp":
		// date & time
		return timeStorageReq(col.DataType, dbVersion)

	case "char", "binary", "varchar", "varbinary", "enum", "set":
		// string
		return StringStorageReq(col.DataType, col.Character)
	case "tinyblob", "tinytext", "blob", "text", "mediumblob", "mediumtext",
		"longblob", "longtext":
		// strings length depend on it's values
		// 这些字段为不定长字段,添加索引时必须指定前缀,索引前缀与字符集相关
		return Config.MaxIdxBytesPerColumn + 1
	default:
		Log.Warning("Type %s not support:", col.DataType)
		return -1
	}
}

// Numeric Type Storage Requirements
// return bytes count
func numericStorageReq(dataType string) int {
	typeLength := GetDataTypeLength(dataType)
	baseType := strings.ToLower(GetDataTypeBase(dataType))

	switch baseType {
	case "tinyint":
		return 1
	case "smallint":
		return 2
	case "mediumint":
		return 3
	case "int", "integer":
		return 4
	case "bigint", "double", "real":
		return 8
	case "float":
		if typeLength[0] == -1 || typeLength[0] >= 0 && typeLength[0] <= 24 {
			// 4 bytes if 0 <= p <= 24
			return 4
		}
		// 8 bytes if no p || 25 <= p <= 53
		return 8
	case "decimal", "numeric":
		// Values for DECIMAL (and NUMERIC) columns are represented using a binary format
		// that packs nine decimal (base 10) digits into four bytes. Storage for the integer
		// and fractional parts of each value are determined separately. Each multiple of nine
		// digits requires four bytes, and the “leftover” digits require some fraction of four bytes.

		if typeLength[0] == -1 {
			return 4
		}

		leftover := func(leftover int) int {
			if leftover > 0 && leftover <= 2 {
				return 1
			} else if leftover > 2 && leftover <= 4 {
				return 2
			} else if leftover > 4 && leftover <= 6 {
				return 3
			} else if leftover > 6 && leftover <= 8 {
				return 4
			} else {
				return 4
			}
		}

		integer := typeLength[0]/9*4 + leftover(typeLength[0]%9)
		fractional := typeLength[1]/9*4 + leftover(typeLength[1]%9)

		return integer + fractional

	case "bit":
		// approximately (M+7)/8 bytes
		if typeLength[0] == -1 {
			return 1
		}
		return (typeLength[0] + 7) / 8

	default:
		Log.Error("No such numeric type: %s", baseType)
		return 8
	}
}

// Date and Time Type Storage Requirements
// return bytes count
func timeStorageReq(dataType string, version int) int {
	/*
			https://dev.mysql.com/doc/refman/8.0/en/storage-requirements.html
			*   ============================================================================================
			*   |	Data Type |	Storage Required Before MySQL 5.6.4	| Storage Required as of MySQL 5.6.4   |
			*   | ---------------------------------------------------------------------------------------- |
			*   |	YEAR	  |	1 byte	                            | 1 byte                               |
			*   |	DATE	  | 3 bytes	                            | 3 bytes                              |
			*   |	TIME	  | 3 bytes	                            | 3 bytes + fractional seconds storage |
			*   |	DATETIME  | 8 bytes	                            | 5 bytes + fractional seconds storage |
			*   |	TIMESTAMP |	4 bytes	                            | 4 bytes + fractional seconds storage |
			*   ============================================================================================
			*	|  Fractional Seconds Precision |Storage Required  |
			*   | ------------------------------------------------ |
			*	|  0	    					|0 bytes		   |
			*	|  1, 2						    |1 byte            |
			*	|  3, 4						    |2 bytes           |
			*	|  5, 6						    |3 bytes           |
		    *   ====================================================
	*/

	typeLength := GetDataTypeLength(dataType)

	extr := func(length int) int {
		if length > 0 && length <= 2 {
			return 1
		} else if length > 2 && length <= 4 {
			return 2
		} else if length > 4 && length <= 6 || length > 6 {
			return 3
		}
		return 0
	}

	switch strings.ToLower(GetDataTypeBase(dataType)) {
	case "year":
		return 1
	case "date":
		return 3
	case "time":
		if version < 50604 {
			return 3
		}
		// 3 bytes + fractional seconds storage
		return 3 + extr(typeLength[0])
	case "datetime":
		if version < 50604 {
			return 8
		}
		// 5 bytes + fractional seconds storage
		return 5 + extr(typeLength[0])
	case "timestamp":
		if version < 50604 {
			return 4
		}
		// 4 bytes + fractional seconds storage
		return 4 + extr(typeLength[0])
	default:
		return 8
	}
}

// SHOW CHARACTER SET

// CharSets character bytes per charcharacter bytes per char
var CharSets = map[string]int{
	"armscii8": 1,
	"ascii":    1,
	"big5":     2,
	"binary":   1,
	"cp1250":   1,
	"cp1251":   1,
	"cp1256":   1,
	"cp1257":   1,
	"cp850":    1,
	"cp852":    1,
	"cp866":    1,
	"cp932":    2,
	"dec8":     1,
	"eucjpms":  3,
	"euckr":    2,
	"gb18030":  4,
	"gb2312":   2,
	"gbk":      2,
	"geostd8":  1,
	"greek":    1,
	"hebrew":   1,
	"hp8":      1,
	"keybcs2":  1,
	"koi8r":    1,
	"koi8u":    1,
	"latin1":   1,
	"latin2":   1,
	"latin5":   1,
	"latin7":   1,
	"macce":    1,
	"macroman": 1,
	"sjis":     2,
	"swe7":     1,
	"tis620":   1,
	"ucs2":     2,
	"ujis":     3,
	"utf16":    4,
	"utf16le":  4,
	"utf32":    4,
	"utf8":     3,
	"utf8mb4":  4,
}

// StringStorageReq String Type Storage Requirements return bytes count
func StringStorageReq(dataType string, charset string) int {
	// get bytes per character, default 1
	bysPerChar := 1
	if _, ok := CharSets[strings.ToLower(charset)]; ok {
		bysPerChar = CharSets[strings.ToLower(charset)]
	}

	// get length
	typeLength := GetDataTypeLength(dataType)
	if typeLength[0] == -1 {
		return 0
	}

	// get type
	baseType := strings.ToLower(GetDataTypeBase(dataType))

	switch baseType {
	case "char":
		// Otherwise, M × w bytes, <= M <= 255,
		// where w is the number of bytes required for the maximum-length character in the character set.
		if typeLength[0] > 255 {
			typeLength[0] = 255
		}
		return typeLength[0] * bysPerChar
	case "binary":
		// M bytes, 0 <= M <= 255
		if typeLength[0] > 255 {
			typeLength[0] = 255
		}
		return typeLength[0]
	case "varchar", "varbinary":
		if typeLength[0] < 255 {
			return typeLength[0]*bysPerChar + 1
		}
		return typeLength[0]*bysPerChar + 2
	case "enum":
		// 1 or 2 bytes, depending on the number of enumeration values (65,535 values maximum)
		return typeLength[0]/(2^15) + 1
	case "set":
		// 1, 2, 3, 4, or 8 bytes, depending on the number of set members (64 members maximum)
		return typeLength[0]/8 + 1
	default:
		return 0
	}
}


================================================
FILE: common/meta_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"fmt"
	"testing"
)

func TestGetDataTypeLength(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	typeList := map[string][]int{
		"varchar(20)":  {20},
		"int(2)":       {2},
		"int(2000000)": {2000000},
		"DECIMAL(1,2)": {1, 2},
		"int":          {-1},
	}

	for typ, want := range typeList {
		got := GetDataTypeLength(typ)
		for i := 0; i < len(want); i++ {
			if want[i] != got[i] {
				t.Errorf("Not match, want %v, got %v", want, got)
			}
		}
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestGetDataTypeBase(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	typeList := map[string]string{
		"varchar(20)":  "varchar",
		"int(2)":       "int",
		"int(2000000)": "int",
	}

	for typ := range typeList {
		if got := GetDataTypeBase(typ); got != typeList[typ] {
			t.Errorf("Not match, want %s, got %s", typeList[typ], got)
		}
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestGetDataBytes(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	cols50604 := map[*Column]int{
		// numeric type
		{Name: "col000", DataType: "tinyint", Character: "utf8"}:        1,
		{Name: "col001", DataType: "SMALLINT", Character: "utf8"}:       2,
		{Name: "col002", DataType: "MEDIUMINT", Character: "utf8"}:      3,
		{Name: "col003", DataType: "int(32)", Character: "utf8"}:        4,
		{Name: "col004", DataType: "integer(32)", Character: "utf8"}:    4,
		{Name: "col005", DataType: "bigint(10)", Character: "utf8"}:     8,
		{Name: "col006", DataType: "float(12)", Character: "utf8"}:      4,
		{Name: "col007", DataType: "float(50)", Character: "utf8"}:      8,
		{Name: "col008", DataType: "float(100)", Character: "utf8"}:     8,
		{Name: "col009", DataType: "float", Character: "utf8"}:          4,
		{Name: "col010", DataType: "double", Character: "utf8"}:         8,
		{Name: "col011", DataType: "real", Character: "utf8"}:           8,
		{Name: "col012", DataType: "BIT(32)", Character: "utf8"}:        4,
		{Name: "col013", DataType: "numeric(32,32)", Character: "utf8"}: 30,
		{Name: "col013", DataType: "decimal(2,32)", Character: "utf8"}:  16,
		{Name: "col014", DataType: "BIT(32)", Character: "utf8"}:        4,

		// date & time
		{Name: "col015", DataType: "year(32)", Character: "utf8mb4"}:      1,
		{Name: "col016", DataType: "date", Character: "utf8mb4"}:          3,
		{Name: "col017", DataType: "time", Character: "utf8mb4"}:          3,
		{Name: "col018", DataType: "time(0)", Character: "utf8mb4"}:       3,
		{Name: "col019", DataType: "time(2)", Character: "utf8mb4"}:       4,
		{Name: "col020", DataType: "time(4)", Character: "utf8mb4"}:       5,
		{Name: "col021", DataType: "time(6)", Character: "utf8mb4"}:       6,
		{Name: "col022", DataType: "datetime", Character: "utf8mb4"}:      5,
		{Name: "col023", DataType: "timestamp(32)", Character: "utf8mb4"}: 7,

		// string
		{Name: "col024", DataType: "varchar(255)", Character: "utf8"}:    767,
		{Name: "col025", DataType: "varchar(191)", Character: "utf8mb4"}: 765,
	}

	for col, bytes := range cols50604 {
		if got := col.GetDataBytes(50604); got != bytes {
			t.Errorf("Version 5.6.4, %s Not match, want %d, got %d", col.Name, bytes, got)
		}
	}

	cols50500 := map[*Column]int{
		// numeric type
		{Name: "col000", DataType: "tinyint", Character: "utf8"}:        1,
		{Name: "col001", DataType: "SMALLINT", Character: "utf8"}:       2,
		{Name: "col002", DataType: "MEDIUMINT", Character: "utf8"}:      3,
		{Name: "col003", DataType: "int(32)", Character: "utf8"}:        4,
		{Name: "col004", DataType: "integer(32)", Character: "utf8"}:    4,
		{Name: "col005", DataType: "bigint(10)", Character: "utf8"}:     8,
		{Name: "col006", DataType: "float(12)", Character: "utf8"}:      4,
		{Name: "col007", DataType: "float(50)", Character: "utf8"}:      8,
		{Name: "col008", DataType: "float(100)", Character: "utf8"}:     8,
		{Name: "col009", DataType: "float", Character: "utf8"}:          4,
		{Name: "col010", DataType: "double", Character: "utf8"}:         8,
		{Name: "col011", DataType: "real", Character: "utf8"}:           8,
		{Name: "col012", DataType: "BIT(32)", Character: "utf8"}:        4,
		{Name: "col013", DataType: "numeric(32,32)", Character: "utf8"}: 30,
		{Name: "col013", DataType: "decimal(2,32)", Character: "utf8"}:  16,
		{Name: "col014", DataType: "BIT(32)", Character: "utf8"}:        4,

		// date & time
		{Name: "col015", DataType: "year(32)", Character: "utf8mb4"}:      1,
		{Name: "col016", DataType: "date", Character: "utf8mb4"}:          3,
		{Name: "col017", DataType: "time", Character: "utf8mb4"}:          3,
		{Name: "col018", DataType: "time(0)", Character: "utf8mb4"}:       3,
		{Name: "col019", DataType: "time(2)", Character: "utf8mb4"}:       3,
		{Name: "col020", DataType: "time(4)", Character: "utf8mb4"}:       3,
		{Name: "col021", DataType: "time(6)", Character: "utf8mb4"}:       3,
		{Name: "col022", DataType: "datetime", Character: "utf8mb4"}:      8,
		{Name: "col023", DataType: "timestamp(32)", Character: "utf8mb4"}: 4,

		// string
		{Name: "col024", DataType: "varchar(255)", Character: "utf8"}:    767,
		{Name: "col025", DataType: "varchar(191)", Character: "utf8mb4"}: 765,
	}

	for col, bytes := range cols50500 {
		if got := col.GetDataBytes(50500); got != bytes {
			t.Errorf("Version: 5.5.0, %s Not match, want %d, got %d", col.Name, bytes, got)
		}
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}

func TestStringStorageReq(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	dataTypes := []string{
		"char(10)",
		"char(256)",
		"binary(10)",
		"binary(256)",
		"varchar(10)",
		"varbinary(10)",
		"enum('G','PG','PG-13','R','NC-17')",
		"set('one', 'two')",
		// wrong case
		"not_exist",
		"char(-1)",
	}

	err := GoldenDiff(func() {
		for _, name := range SortedKey(CharSets) {
			for _, tp := range dataTypes {
				fmt.Println(tp, name, StringStorageReq(tp, name))
			}
		}
	}, t.Name(), update)
	if err != nil {
		t.Error(err)
	}
	Log.Debug("Exiting function: %s", GetFunctionName())
}


================================================
FILE: common/signal.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"os"
	"os/signal"
	"syscall"
)

// HandleSignal 当程序卡死的时候,或者由于某些原因程序没有退出,可以通过捕获信号量的形式让程序优雅退出并且清理测试环境
func HandleSignal(f func()) {
	sc := make(chan os.Signal, 1)
	signal.Notify(sc,
		syscall.SIGHUP,
		syscall.SIGINT,
		syscall.SIGTERM,
		syscall.SIGQUIT)

	go func() {
		n := <-sc
		Log.Info("receive signal %v, closing", n)
		f()
	}()
}


================================================
FILE: common/signal_test.go
================================================
/*
 * Copyright 2018 Xiaomi, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package common

import (
	"fmt"
	"testing"
)

func TestHandleSignal(t *testing.T) {
	Log.Debug("Entering function: %s", GetFunctionName())
	HandleSignal(func() {
		fmt.Println("done")
	})
	Log.Debug("Exiting function: %s", GetFunctionName())
}


================================================
FILE: common/testdata/TestJSONFind.golden
================================================
[{
			"Collate":{
				"Collate":{
					"key":"value"
				}
			}
		} {
				"Collate":{
					"key":"value"
				}
			} {
					"key":"value"
				}]
[McLaughlin Hunter Harold]
[{
      "title": "Sample Konfabulator Widget",
      "name": "main_window",
      "width": 500,
      "height": 500
    }]
[    binary    binary  utf8mb4_bin  ]


================================================
FILE: common/testdata/TestListReportTypes.golden
================================================
# 支持的报告类型

[toc]

## lint
* **Description**:参考sqlint格式,以插件形式集成到代码编辑器,显示输出更加友好

* **Example**:

```bash
soar -report-type lint -query test.sql
```
## markdown
* **Description**:该格式为默认输出格式,以markdown格式展现,可以用网页浏览器插件直接打开,也可以用markdown编辑器打开

* **Example**:

```bash
echo "select * from film" | soar
```
## rewrite
* **Description**:SQL重写功能,配合-rewrite-rules参数一起使用,可以通过-list-rewrite-rules 查看所有支持的 SQL 重写规则

* **Example**:

```bash
echo "select * from film" | soar -rewrite-rules star2columns,delimiter -report-type rewrite
```
## ast
* **Description**:输出 SQL 的抽象语法树,主要用于测试

* **Example**:

```bash
echo "select * from film" | soar -report-type ast
```
## ast-json
* **Description**:以 JSON 格式输出 SQL 的抽象语法树,主要用于测试

* **Example**:

```bash
echo "select * from film" | soar -report-type ast-json
```
## tiast
* **Description**:输出 SQL 的 TiDB抽象语法树,主要用于测试

* **Example**:

```bash
echo "select * from film" | soar -report-type tiast
```
## tiast-json
* **Description**:以 JSON 格式输出 SQL 的 TiDB抽象语法树,主要用于测试

* **Example**:

```bash
echo "select * from film" | soar -report-type tiast-json
```
## tables
* **Description**:以 JSON 格式输出 SQL 使用的库表名

* **Example**:

```bash
echo "select * from film" | soar -report-type tables
```
## query-type
* **Description**:SQL 语句的请求类型

* **Example**:

```bash
echo "select * from film" | soar -report-type query-type
```
## fingerprint
* **Description**:输出SQL的指纹

* **Example**:

```bash
echo "select * from film where language_id=1" | soar -report-type fingerprint
```
## md2html
* **Description**:markdown 格式转 html 格式小工具

* **Example**:

```bash
soar -list-heuristic-rules | soar -report-type md2html > heuristic_rules.html
```
## explain-digest
* **Description**:输入为EXPLAIN的表格,JSON 或 Vertical格式,对其进行分析,给出分析结果

* **Example**:

```bash
soar -report-type explain-digest << EOF
+----+-------------+-------+------+---------------+------+---------+------+------+-------+
| id | select_type | table | type | possible_keys | key  | key_len | ref  | rows | Extra |
+----+-------------+-------+------+---------------+------+---------+------+------+-------+
|  1 | SIMPLE      | film  | ALL  | NULL          | NULL | NULL    | NULL | 1131 |       |
+----+-------------+-------+------+---------------+------+---------+------+------+-------+
EOF
```
## duplicate-key-checker
* **Description**:对 OnlineDsn 中指定的 database 进行索引重复检查

* **Example**:

```bash
soar -report-type duplicate-key-checker -online-dsn user:password@127.0.0.1:3306/db
```
## html
* **Description**:以HTML格式输出报表

* **Example**:

```bash
echo "select * from film" | soar -report-type html
```
## json
* **Description**:输出JSON格式报表,方便应用程序处理

* **Example**:

```bash
echo "select * from film" | soar -report-type json
```
## tokenize
* **Description**:对SQL进行切词,主要用于测试

* **Example**:

```bash
echo "select * from film" | soar -report-type tokenize
```
## compress
* **Description**:SQL压缩小工具,使用内置SQL压缩逻辑,测试中的功能

* **Example**:

```bash
echo "select
*
from
  film" | soar -report-type compress
```
## pretty
* **Description**:使用kr/pretty打印报告,主要用于测试

* **Example**:

```bash
echo "select * from film" | soar -report-type pretty
```
## remove-comment
* **Description**:去除SQL语句中的注释,支持单行多行注释的去除

* **Example**:

```bash
echo "select/*comment*/ * from film" | soar -report-type remove-comment
```
## chardet
* **Description**:猜测输入的 SQL 使用的字符集

* **Example**:

```bash
echo '中文' | soar -report-type chardet
```


================================================
FILE: common/testdata/TestMarkdown2Html.golden
================================================

Markdown For Typora

Overview

Markdown is created by Daring Fireball, the original guideline is here. Its syntax, however, varies between different parsers or editors. Typora is using GitHub Flavored Markdown.

Please note that HTML fragments in markdown source will be recognized but not parsed or rendered. Also, there may be small reformatting on the original markdown source code after saving.

Outline

[TOC]

Block Elements

Paragraph and line breaks

A paragraph is simply one or more consecutive lines of text. In markdown source code, paragraphs are separated by more than one blank lines. In Typora, you only need to press Return to create a new paragraph.

Press Shift + Return to create a single line break. However, most markdown parser will ignore single line break, to make other markdown parsers recognize your line break, you can leave two whitespace at the end of the line, or insert <br/>.

Headers

Headers use 1-6 hash characters at the start of the line, corresponding to header levels 1-6. For example:

# This is an H1

## This is an H2

###### This is an H6

In typora, input ‘#’s followed by title content, and press Return key will create a header.

Blockquotes

Markdown uses email-style > characters for block quoting. They are presented as:

> This is a blockquote with two paragraphs. This is first paragraph.
>
> This is second pragraph.Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.



> This is another blockquote with one paragraph. There is three empty line to seperate two blockquote.

In typora, just input ‘>’ followed by quote contents a block quote is generated. Typora will insert proper ‘>’ or line break for you. Block quote inside anther block quote is allowed by adding additional levels of ‘>’.

Lists

Input * list item 1 will create an un-ordered list, the * symbol can be replace with + or -.

Input 1. list item 1 will create an ordered list, their markdown source code is like:

## un-ordered list
*   Red
*   Green
*   Blue

## ordered list
1.  Red
2. 	Green
3.	Blue

Task List

Task lists are lists with items marked as either [ ] or x. For example:

- [ ] a task list item
- [ ] list syntax required
- [ ] normal **formatting**, @mentions, #1234 refs
- [ ] incomplete
- [x] completed

You can change the complete/incomplete state by click the checkbox before the item.

(Fenced) Code Blocks

Typora only support fences in Github Flavored Markdown. Original code blocks in markdown is not supported.

Using fences is easy: Input ``` and press return. Add an optional language identifier after ``` and we'll run it through syntax highlighting:

Here's an example:

​```
function test() {
  console.log("notice the blank line before this function?");
}
​```

syntax highlighting:
​```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
​```

Math Blocks

You can render LaTeX mathematical expressions using MathJax.

Input $$, then press 'Return' key will trigger an input field which accept Tex/LaTex source. Following is an example: $$ \mathbf{V}1 \times \mathbf{V}2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \ \end{vmatrix} $$

In markdown source file, math block is LaTeX expression wrapped by ‘$$’ mark:

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$

Tables

Input | First Header | Second Header | and press return key will create a table with two column.

After table is created, focus on that table will pop up a toolbar for table, where you can resize, align, or delete table. You can also use context menu to copy and add/delete column/row.

Following descriptions can be skipped, as markdown source code for tables are generated by typora automatically.

In markdown source code, they look like:

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

You can also include inline Markdown such as links, bold, italics, or strikethrough.

Finally, by including colons : within the header row, you can define text to be left-aligned, right-aligned, or center-aligned:

| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is      | some wordy text | $1600 |
| col 2 is      | centered        |   $12 |
| zebra stripes | are neat        |    $1 |

A colon on the left-most side indicates a left-aligned column; a colon on the right-most side indicates a right-aligned column; a colon on both sides indicates a center-aligned column.

Footnotes

You can create footnotes like this[^footnote].

[^footnote]: Here is the *text* of the **footnote**.

will produce:

You can create footnotes like this[^footnote].

[^footnote]: Here is the text of the footnote.

Mouse on the ‘footnote’ superscript to see content of the footnote.

Horizontal Rules

Input *** or --- on a blank line and press return will draw a horizontal line.


YAML Front Matter

Typora support YAML Front Matter now. Input --- at the top of the article and then press Enter will introduce one. Or insert one metadata block from the menu.

TableName of Contents (TOC)

Input [toc] then press Return key will create a section for “TableName of Contents” extracting all headers from one’s writing, its contents will be updated automatically.

Diagrams (Sequence, Flowchart and Mermaid)

Typora supports, sequence, flowchart and mermaid, after this feature is enabled from preference panel.

See this document for detail.

Span Elements

Span elements will be parsed and rendered right after your typing. Moving cursor in middle of those span elements will expand those elements into markdown source. Following will explain the syntax of those span element.

Links

Markdown supports two style of links: inline and reference.

In both styles, the link text is delimited by [square brackets].

To create an inline link, use a set of regular parentheses immediately after the link text’s closing square bracket. Inside the parentheses, put the URL where you want the link to point, along with an optional title for the link, surrounded in quotes. For example:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

will produce:

This is an example inline link. (<p>This is <a href="http://example.com/" title="Title">)

This link has no title attribute. (<p><a href="http://example.net/">This link</a> has no)

Internal Links

You can set the href to headers, which will create a bookmark that allow you to jump to that section after clicking. For example:

Command(on Windows: Ctrl) + Click This link will jump to header Block Elements. To see how to write that, please move cursor or click that link with key pressed to expand the element into markdown source.

Reference Links

Reference-style links use a second set of square brackets, inside which you place a label of your choosing to identify the link:

This is [an example][id] reference-style link.

Then, anywhere in the document, you define your link label like this, on a line by itself:

[id]: http://example.com/  "Optional Title Here"

In typora, they will be rendered like:

This is an example reference-style link.

The implicit link name shortcut allows you to omit the name of the link, in which case the link text itself is used as the name. Just use an empty set of square brackets — e.g., to link the word “Google” to the google.com web site, you could simply write:

[Google][]
And then define the link:

[Google]: http://google.com/

In typora click link will expand it for editing, command+click will open the hyperlink in web browser.

URLs

Typora allows you to insert urls as links, wrapped by <brackets>.

<i@typora.io> becomes i@typora.io.

Typora will aslo auto link standard URLs. e.g: www.google.com.

Images

Image looks similar with links, but it requires an additional ! char before the start of link. Image syntax looks like this:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

You are able to use drag & drop to insert image from image file or we browser. And modify the markdown source code by clicking on the image. Relative path will be used if image is in same directory or sub-directory with current editing document when drag & drop.

For more tips on images, please read http://support.typora.io//Images/

Emphasis

Markdown treats asterisks (*) and underscores (_) as indicators of emphasis. Text wrapped with one * or _ will be wrapped with an HTML <em> tag. E.g:

*single asterisks*

_single underscores_

output:

single asterisks

single underscores

GFM will ignores underscores in words, which is commonly used in code and names, like this:

wowgreatstuff

dothisanddothatandanother_thing.

To produce a literal asterisk or underscore at a position where it would otherwise be used as an emphasis delimiter, you can backslash escape it:

\*this text is surrounded by literal asterisks\*

Typora recommends to use * symbol.

Strong

double *’s or _’s will be wrapped with an HTML <strong> tag, e.g:

**double asterisks**

__double underscores__

output:

double asterisks

double underscores

Typora recommends to use ** symbol.

Code

To indicate a span of code, wrap it with backtick quotes (`). Unlike a pre-formatted code block, a code span indicates code within a normal paragraph. For example:

Use the `printf()` function.

will produce:

Use the printf() function.

Strikethrough

GFM adds syntax to create strikethrough text, which is missing from standard Markdown.

~~Mistaken text.~~ becomes Mistaken text.

Underline

Underline is powered by raw HTML.

<u>Underline</u> becomes Underline.

Emoji :happy:

Input emoji with syntax :smile:.

User can trigger auto-complete suggestions for emoji by pressing ESC key, or trigger it automatically after enable it on preference panel. Also, input UTF8 emoji char directly from Edit -> Emoji & Symbols from menu bar is also supported.

HTML

Typora cannot render html fragments. But typora can parse and render very limited HTML fragments, as an extension of Markdown, including:

Most of their attributes, styles, or classes will be ignored. For other tags, typora will render them as raw HTML snippets.

But those HTML will be exported on print or export.

Inline Math

To use this feature, first, please enable it in Preference Panel -> Markdown Tab. Then use $ to wrap TeX command, for example: $\lim_{x \to \infty} \exp(-x) = 0$ will be rendered as LaTeX command.

To trigger inline preview for inline math: input “$”, then press ESC key, then input TeX command, a preview tooltip will be visible like below:

Subscript

To use this feature, first, please enable it in Preference Panel -> Markdown Tab. Then use ~ to wrap subscript content, for example: H~2~O, X~long\ text~/

Superscript

To use this feature, first, please enable it in Preference Panel -> Markdown Tab. Then use ^ to wrap superscript content, for example: X^2^.

Highlight

To use this feature, first, please enable it in Preference Panel -> Markdown Tab. Then use == to wrap superscript content, for example: ==highlight==.

================================================ FILE: common/testdata/TestMarkdown2Html.md ================================================ # Markdown For Typora ## Overview **Markdown** is created by [Daring Fireball](http://daringfireball.net/), the original guideline is [here](http://daringfireball.net/projects/markdown/syntax). Its syntax, however, varies between different parsers or editors. **Typora** is using [GitHub Flavored Markdown][GFM]. Please note that HTML fragments in markdown source will be recognized but not parsed or rendered. Also, there may be small reformatting on the original markdown source code after saving. *Outline* [TOC] ## Block Elements ### Paragraph and line breaks A paragraph is simply one or more consecutive lines of text. In markdown source code, paragraphs are separated by more than one blank lines. In Typora, you only need to press `Return` to create a new paragraph. Press `Shift` + `Return` to create a single line break. However, most markdown parser will ignore single line break, to make other markdown parsers recognize your line break, you can leave two whitespace at the end of the line, or insert `
`. ### Headers Headers use 1-6 hash characters at the start of the line, corresponding to header levels 1-6. For example: ``` markdown # This is an H1 ## This is an H2 ###### This is an H6 ``` In typora, input ‘#’s followed by title content, and press `Return` key will create a header. ### Blockquotes Markdown uses email-style > characters for block quoting. They are presented as: ``` markdown > This is a blockquote with two paragraphs. This is first paragraph. > > This is second pragraph.Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. > This is another blockquote with one paragraph. There is three empty line to seperate two blockquote. ``` In typora, just input ‘>’ followed by quote contents a block quote is generated. Typora will insert proper ‘>’ or line break for you. Block quote inside anther block quote is allowed by adding additional levels of ‘>’. ### Lists Input `* list item 1` will create an un-ordered list, the `*` symbol can be replace with `+` or `-`. Input `1. list item 1` will create an ordered list, their markdown source code is like: ``` markdown ## un-ordered list * Red * Green * Blue ## ordered list 1. Red 2. Green 3. Blue ``` ### Task List Task lists are lists with items marked as either [ ] or [x] (incomplete or complete). For example: ``` markdown - [ ] a task list item - [ ] list syntax required - [ ] normal **formatting**, @mentions, #1234 refs - [ ] incomplete - [x] completed ``` You can change the complete/incomplete state by click the checkbox before the item. ### (Fenced) Code Blocks Typora only support fences in Github Flavored Markdown. Original code blocks in markdown is not supported. Using fences is easy: Input \`\`\` and press `return`. Add an optional language identifier after \`\`\` and we'll run it through syntax highlighting: ``` gfm Here's an example: ​``` function test() { console.log("notice the blank line before this function?"); } ​``` syntax highlighting: ​```ruby require 'redcarpet' markdown = Redcarpet.new("Hello World!") puts markdown.to_html ​``` ``` ### Math Blocks You can render *LaTeX* mathematical expressions using **MathJax**. Input `$$`, then press 'Return' key will trigger an input field which accept *Tex/LaTex* source. Following is an example: $$ \mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix} $$ In markdown source file, math block is *LaTeX* expression wrapped by ‘$$’ mark: ``` markdown $$ \mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix} $$ ``` ### Tables Input `| First Header | Second Header |` and press `return` key will create a table with two column. After table is created, focus on that table will pop up a toolbar for table, where you can resize, align, or delete table. You can also use context menu to copy and add/delete column/row. Following descriptions can be skipped, as markdown source code for tables are generated by typora automatically. In markdown source code, they look like: ``` markdown | First Header | Second Header | | ------------- | ------------- | | Content Cell | Content Cell | | Content Cell | Content Cell | ``` You can also include inline Markdown such as links, bold, italics, or strikethrough. Finally, by including colons : within the header row, you can define text to be left-aligned, right-aligned, or center-aligned: ``` markdown | Left-Aligned | Center Aligned | Right Aligned | | :------------ |:---------------:| -----:| | col 3 is | some wordy text | $1600 | | col 2 is | centered | $12 | | zebra stripes | are neat | $1 | ``` A colon on the left-most side indicates a left-aligned column; a colon on the right-most side indicates a right-aligned column; a colon on both sides indicates a center-aligned column. ### Footnotes ``` markdown You can create footnotes like this[^footnote]. [^footnote]: Here is the *text* of the **footnote**. ``` will produce: You can create footnotes like this[^footnote]. [^footnote]: Here is the *text* of the **footnote**. Mouse on the ‘footnote’ superscript to see content of the footnote. ### Horizontal Rules Input `***` or `---` on a blank line and press `return` will draw a horizontal line. ------ ### YAML Front Matter Typora support [YAML Front Matter](http://jekyllrb.com/docs/frontmatter/) now. Input `---` at the top of the article and then press `Enter` will introduce one. Or insert one metadata block from the menu. ### TableName of Contents (TOC) Input `[toc]` then press `Return` key will create a section for “TableName of Contents” extracting all headers from one’s writing, its contents will be updated automatically. ### Diagrams (Sequence, Flowchart and Mermaid) Typora supports, [sequence](https://bramp.github.io/js-sequence-diagrams/), [flowchart](http://flowchart.js.org/) and [mermaid](https://knsv.github.io/mermaid/#mermaid), after this feature is enabled from preference panel. See this [document](http://support.typora.io/Draw-Diagrams-With-Markdown/) for detail. ## Span Elements Span elements will be parsed and rendered right after your typing. Moving cursor in middle of those span elements will expand those elements into markdown source. Following will explain the syntax of those span element. ### Links Markdown supports two style of links: inline and reference. In both styles, the link text is delimited by [square brackets]. To create an inline link, use a set of regular parentheses immediately after the link text’s closing square bracket. Inside the parentheses, put the URL where you want the link to point, along with an optional title for the link, surrounded in quotes. For example: ``` markdown This is [an example](http://example.com/ "Title") inline link. [This link](http://example.net/) has no title attribute. ``` will produce: This is [an example](http://example.com/"Title") inline link. (`

This is `) [This link](http://example.net/) has no title attribute. (`

This link has no`) #### Internal Links **You can set the href to headers**, which will create a bookmark that allow you to jump to that section after clicking. For example: Command(on Windows: Ctrl) + Click [This link](#block-elements) will jump to header `Block Elements`. To see how to write that, please move cursor or click that link with `⌘` key pressed to expand the element into markdown source. #### Reference Links Reference-style links use a second set of square brackets, inside which you place a label of your choosing to identify the link: ``` markdown This is [an example][id] reference-style link. Then, anywhere in the document, you define your link label like this, on a line by itself: [id]: http://example.com/ "Optional Title Here" ``` In typora, they will be rendered like: This is [an example][id] reference-style link. [id]: http://example.com/ "Optional Title Here" The implicit link name shortcut allows you to omit the name of the link, in which case the link text itself is used as the name. Just use an empty set of square brackets — e.g., to link the word “Google” to the google.com web site, you could simply write: ``` markdown [Google][] And then define the link: [Google]: http://google.com/ ``` In typora click link will expand it for editing, command+click will open the hyperlink in web browser. ### URLs Typora allows you to insert urls as links, wrapped by `<`brackets`>`. `` becomes . Typora will aslo auto link standard URLs. e.g: www.google.com. ### Images Image looks similar with links, but it requires an additional `!` char before the start of link. Image syntax looks like this: ``` markdown ![Alt text](/path/to/img.jpg) ![Alt text](/path/to/img.jpg "Optional title") ``` You are able to use drag & drop to insert image from image file or we browser. And modify the markdown source code by clicking on the image. Relative path will be used if image is in same directory or sub-directory with current editing document when drag & drop. For more tips on images, please read ### Emphasis Markdown treats asterisks (`*`) and underscores (`_`) as indicators of emphasis. Text wrapped with one `*` or `_` will be wrapped with an HTML `` tag. E.g: ``` markdown *single asterisks* _single underscores_ ``` output: *single asterisks* _single underscores_ GFM will ignores underscores in words, which is commonly used in code and names, like this: > wow_great_stuff > > do_this_and_do_that_and_another_thing. To produce a literal asterisk or underscore at a position where it would otherwise be used as an emphasis delimiter, you can backslash escape it: ``` markdown \*this text is surrounded by literal asterisks\* ``` Typora recommends to use `*` symbol. ### Strong double *’s or _’s will be wrapped with an HTML `` tag, e.g: ``` markdown **double asterisks** __double underscores__ ``` output: **double asterisks** __double underscores__ Typora recommends to use `**` symbol. ### Code To indicate a span of code, wrap it with backtick quotes (`). Unlike a pre-formatted code block, a code span indicates code within a normal paragraph. For example: ``` markdown Use the `printf()` function. ``` will produce: Use the `printf()` function. ### Strikethrough GFM adds syntax to create strikethrough text, which is missing from standard Markdown. `~~Mistaken text.~~` becomes ~~Mistaken text.~~ ### Underline Underline is powered by raw HTML. `Underline` becomes Underline. ### Emoji :happy: Input emoji with syntax `:smile:`. User can trigger auto-complete suggestions for emoji by pressing `ESC` key, or trigger it automatically after enable it on preference panel. Also, input UTF8 emoji char directly from `Edit` -> `Emoji & Symbols` from menu bar is also supported. ### HTML Typora cannot render html fragments. But typora can parse and render very limited HTML fragments, as an extension of Markdown, including: - Underline: `underline` - Image: `` (And `width`, `height` attribute in HTML tag, and `width`, `height`, `zoom` style in `style` attribute will be applied.) - Comments: `` - Hyperlink: `link`. Most of their attributes, styles, or classes will be ignored. For other tags, typora will render them as raw HTML snippets. But those HTML will be exported on print or export. ### Inline Math To use this feature, first, please enable it in `Preference` Panel -> `Markdown` Tab. Then use `$` to wrap TeX command, for example: `$\lim_{x \to \infty} \exp(-x) = 0$` will be rendered as LaTeX command. To trigger inline preview for inline math: input “$”, then press `ESC` key, then input TeX command, a preview tooltip will be visible like below: ### Subscript To use this feature, first, please enable it in `Preference` Panel -> `Markdown` Tab. Then use `~` to wrap subscript content, for example: `H~2~O`, `X~long\ text~`/ ### Superscript To use this feature, first, please enable it in `Preference` Panel -> `Markdown` Tab. Then use `^` to wrap superscript content, for example: `X^2^`. ### Highlight To use this feature, first, please enable it in `Preference` Panel -> `Markdown` Tab. Then use `==` to wrap superscript content, for example: `==highlight==`. [GFM]: https://help.github.com/articles/github-flavored-markdown/ ================================================ FILE: common/testdata/TestMarkdownHTMLHeader.golden ================================================ ================================================ FILE: common/testdata/TestParseDSN.golden ================================================ &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "127.0.0.1:3306", Schema: "", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@hostname:3307/database &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "hostname:3307", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@hostname:3307/database?charset=utf8 &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "hostname:3307", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@hostname:3307 &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "hostname:3307", Schema: "information_schema", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@hostname:/database &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "hostname:3306", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@:3307/database &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "127.0.0.1:3307", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user@hostname/database &common.Dsn{ User: "user", Password: "", Net: "tcp", Addr: "hostname:3306", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:pwd:pwd@pwd/pwd@hostname/database &common.Dsn{ User: "user", Password: "pwd:pwd@pwd/pwd", Net: "tcp", Addr: "hostname:3306", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@ &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "127.0.0.1:3306", Schema: "information_schema", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } hostname:3307/database &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "hostname:3307", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } @hostname:3307/database &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "hostname:3307", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } @hostname &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "hostname:3306", Schema: "information_schema", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } hostname &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "hostname:3306", Schema: "information_schema", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } @/database &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "127.0.0.1:3306", Schema: "database", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } @hostname:3307 &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "hostname:3307", Schema: "information_schema", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } @:3307/database &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "127.0.0.1:3307", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } :3307/database &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "127.0.0.1:3307", Schema: "database", Charset: "utf8", Collation: "", Loc: "", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "3s", ReadTimeout: "", WriteTimeout: "", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } /database &common.Dsn{ User: "", Password: "", Net: "tcp", Addr: "127.0.0.1:3306", Schema: "database", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user@unix(/path/to/socket)/dbname &common.Dsn{ User: "user", Password: "", Net: "unix", Addr: "/path/to/socket", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } root:pw@unix(/tmp/mysql.sock)/myDatabase?loc=Local &common.Dsn{ User: "root", Password: "pw", Net: "unix", Addr: "/tmp/mysql.sock", Schema: "myDatabase", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "Local", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@tcp(localhost:5555)/dbname?tls=skip-verify &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "localhost:5555", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "skip-verify", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@tcp(localhost:5555)/dbname?autocommit=true &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "localhost:5555", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {"autocommit":"true"}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@/dbname?sql_mode=TRADITIONAL &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "127.0.0.1:3306", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {"sql_mode":"TRADITIONAL"}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@tcp([de:ad:be:ef::ca:fe]:80)/dbname?timeout=90s &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "[de:ad:be:ef::ca:fe]:80", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "1m30s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@tcp([de:ad:be:ef::ca:fe]:80)/dbname?collation=utf8mb4_unicode_ci &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "[de:ad:be:ef::ca:fe]:80", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_unicode_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } id:password@tcp(your-amazonaws-uri.com:3306)/dbname &common.Dsn{ User: "id", Password: "password", Net: "tcp", Addr: "your-amazonaws-uri.com:3306", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user@cloudsql(project-id:instance-name)/dbname &common.Dsn{ User: "user", Password: "", Net: "cloudsql", Addr: "project-id:instance-name", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user@cloudsql(project-id:regionname:instance-name)/dbname &common.Dsn{ User: "user", Password: "", Net: "cloudsql", Addr: "project-id:regionname:instance-name", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@tcp/dbname?sys_var=esc%40ped &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "127.0.0.1:3306", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {"sys_var":"esc@ped"}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@/dbname &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "127.0.0.1:3306", Schema: "dbname", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@/ &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "127.0.0.1:3306", Schema: "", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "0s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } user:password@tcp(localhost:3307)/database?timeout=5s &common.Dsn{ User: "user", Password: "password", Net: "tcp", Addr: "localhost:3307", Schema: "database", Charset: "utf8", Collation: "utf8mb4_general_ci", Loc: "UTC", TLS: "", ServerPubKey: "", MaxAllowedPacket: 4194304, Params: {}, Timeout: "5s", ReadTimeout: "0s", WriteTimeout: "0s", AllowNativePasswords: true, AllowOldPasswords: false, Disable: false, Version: 99999, } ================================================ FILE: common/testdata/TestPrintConfiguration.golden ================================================ online-dsn: user: root password: '********' net: tcp addr: 127.0.0.1:3306 schema: sakila charset: utf8 collation: utf8mb4_general_ci loc: UTC tls: "" server-public-key: "" max-allowed-packet: 4194304 params: charset: utf8 timeout: 3s read-timeout: 0s write-timeout: 0s allow-native-passwords: true allow-old-passwords: false disable: false test-dsn: user: root password: '********' net: tcp addr: 127.0.0.1:3306 schema: sakila charset: utf8 collation: utf8mb4_general_ci loc: UTC tls: "" server-public-key: "" max-allowed-packet: 4194304 params: charset: utf8 timeout: 3s read-timeout: 0s write-timeout: 0s allow-native-passwords: true allow-old-passwords: false disable: false allow-online-as-test: true disable-version-check: false drop-test-temporary: true cleanup-test-database: false only-syntax-check: false sampling-statistic-target: 100 sampling: true sampling-condition: "" profiling: false trace: false explain: true delimiter: ; log-level: 7 log-output: soar.log report-type: markdown report-css: "" report-javascript: "" report-title: SQL优化分析报告 markdown-extensions: 94 markdown-html-flags: 0 ignore-rules: - COL.011 rewrite-rules: - delimiter - orderbynull - groupbyconst - dmlorderby - having - star2columns - insertcolumns - distinctstar blacklist: "" max-join-table-count: 5 max-group-by-cols-count: 5 max-distinct-count: 5 max-index-cols-count: 5 max-text-cols-count: 2 max-total-rows: 9999999 max-query-cost: 9999 spaghetti-query-length: 2048 allow-drop-index: false max-in-count: 10 max-index-bytes-percolumn: 767 max-index-bytes: 3072 allow-charsets: - utf8 - utf8mb4 allow-collates: [] allow-engines: - innodb max-index-count: 10 max-column-count: 40 max-value-count: 100 index-prefix: idx_ unique-key-prefix: uk_ max-subquery-depth: 5 max-varchar-length: 1024 column-not-allow-type: - json - text - boolean min-cardinality: 0 explain-sql-report-type: pretty explain-type: extended explain-format: traditional explain-warn-select-type: - "" explain-warn-access-type: - ALL explain-max-keys: 3 explain-min-keys: 0 explain-max-rows: 10000 explain-warn-extra: - Using temporary - Using filesort explain-max-filtered: 100 explain-warn-scalability: - O(n) show-warnings: false show-last-query-cost: false query: "" list-heuristic-rules: false list-rewrite-rules: false list-test-sqls: false list-report-types: false verbose: false dry-run: true max-pretty-sql-length: 1024 ================================================ FILE: common/testdata/TestRemoveBOM.golden ================================================ select col from tb c = 1; [239 187 191] ================================================ FILE: common/testdata/TestStringStorageReq.golden ================================================ char(10) armscii8 10 char(256) armscii8 255 binary(10) armscii8 10 binary(256) armscii8 255 varchar(10) armscii8 11 varbinary(10) armscii8 11 enum('G','PG','PG-13','R','NC-17') armscii8 1 set('one', 'two') armscii8 1 not_exist armscii8 0 char(-1) armscii8 0 char(10) ascii 10 char(256) ascii 255 binary(10) ascii 10 binary(256) ascii 255 varchar(10) ascii 11 varbinary(10) ascii 11 enum('G','PG','PG-13','R','NC-17') ascii 1 set('one', 'two') ascii 1 not_exist ascii 0 char(-1) ascii 0 char(10) big5 20 char(256) big5 510 binary(10) big5 10 binary(256) big5 255 varchar(10) big5 21 varbinary(10) big5 21 enum('G','PG','PG-13','R','NC-17') big5 1 set('one', 'two') big5 1 not_exist big5 0 char(-1) big5 0 char(10) binary 10 char(256) binary 255 binary(10) binary 10 binary(256) binary 255 varchar(10) binary 11 varbinary(10) binary 11 enum('G','PG','PG-13','R','NC-17') binary 1 set('one', 'two') binary 1 not_exist binary 0 char(-1) binary 0 char(10) cp1250 10 char(256) cp1250 255 binary(10) cp1250 10 binary(256) cp1250 255 varchar(10) cp1250 11 varbinary(10) cp1250 11 enum('G','PG','PG-13','R','NC-17') cp1250 1 set('one', 'two') cp1250 1 not_exist cp1250 0 char(-1) cp1250 0 char(10) cp1251 10 char(256) cp1251 255 binary(10) cp1251 10 binary(256) cp1251 255 varchar(10) cp1251 11 varbinary(10) cp1251 11 enum('G','PG','PG-13','R','NC-17') cp1251 1 set('one', 'two') cp1251 1 not_exist cp1251 0 char(-1) cp1251 0 char(10) cp1256 10 char(256) cp1256 255 binary(10) cp1256 10 binary(256) cp1256 255 varchar(10) cp1256 11 varbinary(10) cp1256 11 enum('G','PG','PG-13','R','NC-17') cp1256 1 set('one', 'two') cp1256 1 not_exist cp1256 0 char(-1) cp1256 0 char(10) cp1257 10 char(256) cp1257 255 binary(10) cp1257 10 binary(256) cp1257 255 varchar(10) cp1257 11 varbinary(10) cp1257 11 enum('G','PG','PG-13','R','NC-17') cp1257 1 set('one', 'two') cp1257 1 not_exist cp1257 0 char(-1) cp1257 0 char(10) cp850 10 char(256) cp850 255 binary(10) cp850 10 binary(256) cp850 255 varchar(10) cp850 11 varbinary(10) cp850 11 enum('G','PG','PG-13','R','NC-17') cp850 1 set('one', 'two') cp850 1 not_exist cp850 0 char(-1) cp850 0 char(10) cp852 10 char(256) cp852 255 binary(10) cp852 10 binary(256) cp852 255 varchar(10) cp852 11 varbinary(10) cp852 11 enum('G','PG','PG-13','R','NC-17') cp852 1 set('one', 'two') cp852 1 not_exist cp852 0 char(-1) cp852 0 char(10) cp866 10 char(256) cp866 255 binary(10) cp866 10 binary(256) cp866 255 varchar(10) cp866 11 varbinary(10) cp866 11 enum('G','PG','PG-13','R','NC-17') cp866 1 set('one', 'two') cp866 1 not_exist cp866 0 char(-1) cp866 0 char(10) cp932 20 char(256) cp932 510 binary(10) cp932 10 binary(256) cp932 255 varchar(10) cp932 21 varbinary(10) cp932 21 enum('G','PG','PG-13','R','NC-17') cp932 1 set('one', 'two') cp932 1 not_exist cp932 0 char(-1) cp932 0 char(10) dec8 10 char(256) dec8 255 binary(10) dec8 10 binary(256) dec8 255 varchar(10) dec8 11 varbinary(10) dec8 11 enum('G','PG','PG-13','R','NC-17') dec8 1 set('one', 'two') dec8 1 not_exist dec8 0 char(-1) dec8 0 char(10) eucjpms 30 char(256) eucjpms 765 binary(10) eucjpms 10 binary(256) eucjpms 255 varchar(10) eucjpms 31 varbinary(10) eucjpms 31 enum('G','PG','PG-13','R','NC-17') eucjpms 1 set('one', 'two') eucjpms 1 not_exist eucjpms 0 char(-1) eucjpms 0 char(10) euckr 20 char(256) euckr 510 binary(10) euckr 10 binary(256) euckr 255 varchar(10) euckr 21 varbinary(10) euckr 21 enum('G','PG','PG-13','R','NC-17') euckr 1 set('one', 'two') euckr 1 not_exist euckr 0 char(-1) euckr 0 char(10) gb18030 40 char(256) gb18030 1020 binary(10) gb18030 10 binary(256) gb18030 255 varchar(10) gb18030 41 varbinary(10) gb18030 41 enum('G','PG','PG-13','R','NC-17') gb18030 1 set('one', 'two') gb18030 1 not_exist gb18030 0 char(-1) gb18030 0 char(10) gb2312 20 char(256) gb2312 510 binary(10) gb2312 10 binary(256) gb2312 255 varchar(10) gb2312 21 varbinary(10) gb2312 21 enum('G','PG','PG-13','R','NC-17') gb2312 1 set('one', 'two') gb2312 1 not_exist gb2312 0 char(-1) gb2312 0 char(10) gbk 20 char(256) gbk 510 binary(10) gbk 10 binary(256) gbk 255 varchar(10) gbk 21 varbinary(10) gbk 21 enum('G','PG','PG-13','R','NC-17') gbk 1 set('one', 'two') gbk 1 not_exist gbk 0 char(-1) gbk 0 char(10) geostd8 10 char(256) geostd8 255 binary(10) geostd8 10 binary(256) geostd8 255 varchar(10) geostd8 11 varbinary(10) geostd8 11 enum('G','PG','PG-13','R','NC-17') geostd8 1 set('one', 'two') geostd8 1 not_exist geostd8 0 char(-1) geostd8 0 char(10) greek 10 char(256) greek 255 binary(10) greek 10 binary(256) greek 255 varchar(10) greek 11 varbinary(10) greek 11 enum('G','PG','PG-13','R','NC-17') greek 1 set('one', 'two') greek 1 not_exist greek 0 char(-1) greek 0 char(10) hebrew 10 char(256) hebrew 255 binary(10) hebrew 10 binary(256) hebrew 255 varchar(10) hebrew 11 varbinary(10) hebrew 11 enum('G','PG','PG-13','R','NC-17') hebrew 1 set('one', 'two') hebrew 1 not_exist hebrew 0 char(-1) hebrew 0 char(10) hp8 10 char(256) hp8 255 binary(10) hp8 10 binary(256) hp8 255 varchar(10) hp8 11 varbinary(10) hp8 11 enum('G','PG','PG-13','R','NC-17') hp8 1 set('one', 'two') hp8 1 not_exist hp8 0 char(-1) hp8 0 char(10) keybcs2 10 char(256) keybcs2 255 binary(10) keybcs2 10 binary(256) keybcs2 255 varchar(10) keybcs2 11 varbinary(10) keybcs2 11 enum('G','PG','PG-13','R','NC-17') keybcs2 1 set('one', 'two') keybcs2 1 not_exist keybcs2 0 char(-1) keybcs2 0 char(10) koi8r 10 char(256) koi8r 255 binary(10) koi8r 10 binary(256) koi8r 255 varchar(10) koi8r 11 varbinary(10) koi8r 11 enum('G','PG','PG-13','R','NC-17') koi8r 1 set('one', 'two') koi8r 1 not_exist koi8r 0 char(-1) koi8r 0 char(10) koi8u 10 char(256) koi8u 255 binary(10) koi8u 10 binary(256) koi8u 255 varchar(10) koi8u 11 varbinary(10) koi8u 11 enum('G','PG','PG-13','R','NC-17') koi8u 1 set('one', 'two') koi8u 1 not_exist koi8u 0 char(-1) koi8u 0 char(10) latin1 10 char(256) latin1 255 binary(10) latin1 10 binary(256) latin1 255 varchar(10) latin1 11 varbinary(10) latin1 11 enum('G','PG','PG-13','R','NC-17') latin1 1 set('one', 'two') latin1 1 not_exist latin1 0 char(-1) latin1 0 char(10) latin2 10 char(256) latin2 255 binary(10) latin2 10 binary(256) latin2 255 varchar(10) latin2 11 varbinary(10) latin2 11 enum('G','PG','PG-13','R','NC-17') latin2 1 set('one', 'two') latin2 1 not_exist latin2 0 char(-1) latin2 0 char(10) latin5 10 char(256) latin5 255 binary(10) latin5 10 binary(256) latin5 255 varchar(10) latin5 11 varbinary(10) latin5 11 enum('G','PG','PG-13','R','NC-17') latin5 1 set('one', 'two') latin5 1 not_exist latin5 0 char(-1) latin5 0 char(10) latin7 10 char(256) latin7 255 binary(10) latin7 10 binary(256) latin7 255 varchar(10) latin7 11 varbinary(10) latin7 11 enum('G','PG','PG-13','R','NC-17') latin7 1 set('one', 'two') latin7 1 not_exist latin7 0 char(-1) latin7 0 char(10) macce 10 char(256) macce 255 binary(10) macce 10 binary(256) macce 255 varchar(10) macce 11 varbinary(10) macce 11 enum('G','PG','PG-13','R','NC-17') macce 1 set('one', 'two') macce 1 not_exist macce 0 char(-1) macce 0 char(10) macroman 10 char(256) macroman 255 binary(10) macroman 10 binary(256) macroman 255 varchar(10) macroman 11 varbinary(10) macroman 11 enum('G','PG','PG-13','R','NC-17') macroman 1 set('one', 'two') macroman 1 not_exist macroman 0 char(-1) macroman 0 char(10) sjis 20 char(256) sjis 510 binary(10) sjis 10 binary(256) sjis 255 varchar(10) sjis 21 varbinary(10) sjis 21 enum('G','PG','PG-13','R','NC-17') sjis 1 set('one', 'two') sjis 1 not_exist sjis 0 char(-1) sjis 0 char(10) swe7 10 char(256) swe7 255 binary(10) swe7 10 binary(256) swe7 255 varchar(10) swe7 11 varbinary(10) swe7 11 enum('G','PG','PG-13','R','NC-17') swe7 1 set('one', 'two') swe7 1 not_exist swe7 0 char(-1) swe7 0 char(10) tis620 10 char(256) tis620 255 binary(10) tis620 10 binary(256) tis620 255 varchar(10) tis620 11 varbinary(10) tis620 11 enum('G','PG','PG-13','R','NC-17') tis620 1 set('one', 'two') tis620 1 not_exist tis620 0 char(-1) tis620 0 char(10) ucs2 20 char(256) ucs2 510 binary(10) ucs2 10 binary(256) ucs2 255 varchar(10) ucs2 21 varbinary(10) ucs2 21 enum('G','PG','PG-13','R','NC-17') ucs2 1 set('one', 'two') ucs2 1 not_exist ucs2 0 char(-1) ucs2 0 char(10) ujis 30 char(256) ujis 765 binary(10) ujis 10 binary(256) ujis 255 varchar(10) ujis 31 varbinary(10) ujis 31 enum('G','PG','PG-13','R','NC-17') ujis 1 set('one', 'two') ujis 1 not_exist ujis 0 char(-1) ujis 0 char(10) utf16 40 char(256) utf16 1020 binary(10) utf16 10 binary(256) utf16 255 varchar(10) utf16 41 varbinary(10) utf16 41 enum('G','PG','PG-13','R','NC-17') utf16 1 set('one', 'two') utf16 1 not_exist utf16 0 char(-1) utf16 0 char(10) utf16le 40 char(256) utf16le 1020 binary(10) utf16le 10 binary(256) utf16le 255 varchar(10) utf16le 41 varbinary(10) utf16le 41 enum('G','PG','PG-13','R','NC-17') utf16le 1 set('one', 'two') utf16le 1 not_exist utf16le 0 char(-1) utf16le 0 char(10) utf32 40 char(256) utf32 1020 binary(10) utf32 10 binary(256) utf32 255 varchar(10) utf32 41 varbinary(10) utf32 41 enum('G','PG','PG-13','R','NC-17') utf32 1 set('one', 'two') utf32 1 not_exist utf32 0 char(-1) utf32 0 char(10) utf8 30 char(256) utf8 765 binary(10) utf8 10 binary(256) utf8 255 varchar(10) utf8 31 varbinary(10) utf8 31 enum('G','PG','PG-13','R','NC-17') utf8 1 set('one', 'two') utf8 1 not_exist utf8 0 char(-1) utf8 0 char(10) utf8mb4 40 char(256) utf8mb4 1020 binary(10) utf8mb4 10 binary(256) utf8mb4 255 varchar(10) utf8mb4 41 varbinary(10) utf8mb4 41 enum('G','PG','PG-13','R','NC-17') utf8mb4 1 set('one', 'two') utf8mb4 1 not_exist utf8mb4 0 char(-1) utf8mb4 0 ================================================ FILE: common/testdata/UTF-8.bom.sql ================================================ select col from tb c = 1; ================================================ FILE: common/testdata/chardet_BIG5.txt ================================================ ================================================ FILE: common/testdata/chardet_GB-18030.txt ================================================ ================================================ FILE: common/testdata/chardet_UTF-8.txt ================================================ 中文 ================================================ FILE: common/tricks.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package common import ( "bufio" "bytes" "fmt" "io/ioutil" "os" "path/filepath" "reflect" "sort" "github.com/tidwall/gjson" ) // GoldenDiff 从 gofmt 学来的测试方法 // https://medium.com/soon-london/testing-with-golden-files-in-go-7fccc71c43d3 func GoldenDiff(f func(), name string, update *bool) error { var b bytes.Buffer w := bufio.NewWriter(&b) str := captureOutput(f) _, err := w.WriteString(str) if err != nil { Log.Warning(err.Error()) } err = w.Flush() if err != nil { Log.Warning(err.Error()) } gp := filepath.Join("testdata", name+".golden") if *update { if err = ioutil.WriteFile(gp, b.Bytes(), 0644); err != nil { err = fmt.Errorf("%s failed to update golden file: %s", name, err) return err } } g, err := ioutil.ReadFile(gp) if err != nil { err = fmt.Errorf("%s failed reading .golden: %s", name, err) } if !bytes.Equal(b.Bytes(), g) { err = fmt.Errorf("%s does not match .golden file", name) } return err } // captureOutput 获取函数标准输出 func captureOutput(f func()) string { // keep backup of the real stdout oldStdout := os.Stdout r, w, _ := os.Pipe() os.Stdout = w // copy the output in a separate goroutine so printing can't block indefinitely outC := make(chan string) go func() { buf, err := ioutil.ReadAll(r) if err != nil { panic(err) } outC <- string(buf) }() // execute function f() // back to normal state if err := w.Close(); err != nil { panic(err) } os.Stdout = oldStdout // restoring the real stdout out := <-outC os.Stdout = oldStdout return out } // SortedKey sort map[string]interface{}, use in range clause func SortedKey(m interface{}) []string { var keys []string switch reflect.TypeOf(m).Kind() { case reflect.Map: switch reflect.TypeOf(m).Key().Kind() { case reflect.String: for _, k := range reflect.ValueOf(m).MapKeys() { keys = append(keys, k.String()) } } } sort.Strings(keys) return keys } // jsonFind internal function func jsonFind(json string, name string, find *[]string) (next []string) { res := gjson.Parse(json) res.ForEach(func(key, value gjson.Result) bool { if key.String() == name { *find = append(*find, value.String()) } switch value.Type { case gjson.Number, gjson.True, gjson.False, gjson.Null: default: // String, JSON next = append(next, value.String()) } return true // keep iterating }) return next } // JSONFind iterate find name in json // TODO: for complicate SQL JSONFind will run a long time for json interactions. func JSONFind(json string, name string) []string { Log.Debug("Entering function: %s", GetFunctionName()) var find []string next := []string{json} for len(next) > 0 { var tmpNext []string for _, subJSON := range next { tmpNext = append(tmpNext, jsonFind(subJSON, name, &find)...) } next = tmpNext } Log.Debug("Exiting function: %s", GetFunctionName()) return find } // RemoveDuplicatesItem remove duplicate item from list func RemoveDuplicatesItem(duplicate []string) []string { m := make(map[string]bool) for _, item := range duplicate { if _, ok := m[item]; !ok { m[item] = true } } var unique []string for item := range m { unique = append(unique, item) } sort.Strings(unique) return unique } ================================================ FILE: common/tricks_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package common import ( "fmt" "strings" "testing" "time" ) func TestCaptureOutput(t *testing.T) { Log.Debug("Entering function: %s", GetFunctionName()) c1 := make(chan string, 1) // test output buf large than 65535 length := 1<<16 + 1 go func() { str := captureOutput( func() { var str []string for i := 0; i < length; i++ { str = append(str, "a") } fmt.Println(strings.Join(str, "")) }, ) c1 <- str }() select { case res := <-c1: if len(res) <= length { t.Errorf("want %d, got %d", length, len(res)) } case <-time.After(1 * time.Second): t.Error("capture timeout, pipe read hangup") } Log.Debug("Exiting function: %s", GetFunctionName()) } func TestJSONFind(t *testing.T) { Log.Debug("Entering function: %s", GetFunctionName()) jsons := []string{ ` { "Collate":{ "Collate":{ "Collate":{ "key":"value" } } } } `, `{ "programmers": [ { "firstName": "Janet", "Collate": "McLaughlin", }, { "firstName": "Elliotte", "Collate": "Hunter", }, { "firstName": "Jason", "Collate": "Harold", } ] }`, ` { "widget": { "debug": "on", "Collate": { "title": "Sample Konfabulator Widget", "name": "main_window", "width": 500, "height": 500 }, "image": { "src": "Images/Sun.png", "hOffset": 250, "vOffset": 250, "alignment": "center" }, "text": { "data": "Click Here", "size": 36, "style": "bold", "vOffset": 100, "alignment": "center", "onMouseUp": "sun1.opacity = (sun1.opacity / 100) * 90;" } } } `, ` [ { "SQLCache": true, "CalcFoundRows": false, "StraightJoin": false, "Priority": 0, "Distinct": false, "From": { "TableRefs": { "Left": { "Source": { "Schema": { "O": "", "L": "" }, "Name": { "O": "tb", "L": "tb" }, "DBInfo": null, "TableInfo": null, "IndexHints": null }, "AsName": { "O": "", "L": "" } }, "Right": null, "Tp": 0, "On": null, "Using": null, "NaturalJoin": false, "StraightJoin": false } }, "Where": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Op": 4, "L": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Op": 7, "L": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Name": { "Schema": { "O": "", "L": "" }, "Table": { "O": "", "L": "" }, "Name": { "O": "col3", "L": "col3" } }, "Refer": null }, "R": { "Type": { "Tp": 8, "Flag": 128, "Flen": 1, "Decimal": 0, "Charset": "binary", "Collate": "binary", "Elems": null } } }, "R": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Op": 1, "L": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Op": 7, "L": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Name": { "Schema": { "O": "", "L": "" }, "Table": { "O": "", "L": "" }, "Name": { "O": "col3", "L": "col3" } }, "Refer": null }, "R": { "Type": { "Tp": 8, "Flag": 128, "Flen": 1, "Decimal": 0, "Charset": "binary", "Collate": "binary", "Elems": null } } }, "R": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Op": 7, "L": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Op": 7, "L": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Name": { "Schema": { "O": "", "L": "" }, "Table": { "O": "", "L": "" }, "Name": { "O": "col1", "L": "col1" } }, "Refer": null }, "R": { "Type": { "Tp": 0, "Flag": 0, "Flen": 0, "Decimal": 0, "Charset": "", "Collate": "", "Elems": null }, "Name": { "Schema": { "O": "", "L": "" }, "Table": { "O": "", "L": "" }, "Name": { "O": "col2", "L": "col2" } }, "Refer": null } }, "R": { "Type": { "Tp": 253, "Flag": 0, "Flen": 3, "Decimal": -1, "Charset": "utf8mb4", "Collate": "utf8mb4_bin", "Elems": null } } } } }, "Fields": { "Fields": [ { "Offset": 7, "WildCard": { "Table": { "O": "", "L": "" }, "Schema": { "O": "", "L": "" } }, "Expr": null, "AsName": { "O": "", "L": "" }, "Auxiliary": false } ] }, "GroupBy": null, "Having": null, "WindowSpecs": null, "OrderBy": null, "Limit": null, "LockTp": 0, "TableHints": null, "IsAfterUnionDistinct": false, "IsInBraces": false } ] `, } err := GoldenDiff(func() { for _, json := range jsons { result := JSONFind(json, "Collate") fmt.Println(result) } }, t.Name(), update) if err != nil { t.Error(err) } Log.Debug("Exiting function: %s", GetFunctionName()) } func TestRemoveDuplicatesItem(t *testing.T) { Log.Debug("Entering function: %s", GetFunctionName()) unique := RemoveDuplicatesItem([]string{"a", "a", "b", "c"}) if len(unique) != 3 { t.Error("string list length should 3", unique) } Log.Debug("Exiting function: %s", GetFunctionName()) } ================================================ FILE: common/version.go ================================================ package common // -version输出信息 var ( Version = "No Version Provided" Compile = "" Branch = "" GitDirty = "" DevPath = "" ) ================================================ FILE: database/doc.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ // Package database will take cover of communicate with mysql database. package database ================================================ FILE: database/explain.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "encoding/json" "errors" "fmt" "regexp" "runtime" "sort" "strconv" "strings" "github.com/XiaoMi/soar/ast" "github.com/XiaoMi/soar/common" tidb "github.com/pingcap/parser/ast" "github.com/tidwall/gjson" "vitess.io/vitess/go/vt/sqlparser" ) // format_type 支持的输出格式 // https://dev.mysql.com/doc/refman/5.7/en/explain-output.html const ( TraditionalFormatExplain = iota // 默认输出 JSONFormatExplain // JSON格式输出 ) // ExplainFormatType EXPLAIN 支持的 FORMAT_TYPE var ExplainFormatType = map[string]int{ "traditional": 0, "json": 1, } // explain_type const ( TraditionalExplainType = iota // 默认转出 ExtendedExplainType // EXTENDED输出 PartitionsExplainType // PARTITIONS输出 ) // ExplainType EXPLAIN命令支持的参数 var ExplainType = map[string]int{ "traditional": 0, "extended": 1, "partitions": 2, } // 为TraditionalFormatExplain准备的结构体 { start // ExplainInfo 用于存放Explain信息 type ExplainInfo struct { SQL string ExplainFormat int ExplainRows []ExplainRow ExplainJSON *ExplainJSON Warnings []ExplainWarning QueryCost float64 } // ExplainRow 单行Explain type ExplainRow struct { ID int SelectType string TableName string Partitions string // explain partitions AccessType string PossibleKeys []string Key string KeyLen string // 索引长度,如果发生了index_merge, KeyLen 格式为 N,N,所以不能定义为整型 Ref []string Rows int64 Filtered float64 // 5.6 JSON, 5.7+, 5.5 EXTENDED Scalability string // O(1), O(n), O(log n), O(log n)+ Extra string } // ExplainWarning explain extended 后 SHOW WARNINGS 输出的结果 type ExplainWarning struct { Level string Code int Message string } // 为TraditionalFormatExplain准备的结构体 end } // 为JSONFormatExplain准备的结构体 { start // ExplainJSONCostInfo JSON type ExplainJSONCostInfo struct { ReadCost string `json:"read_cost"` EvalCost string `json:"eval_cost"` PrefixCost string `json:"prefix_cost"` DataReadPerJoin string `json:"data_read_per_join"` QueryCost string `json:"query_cost"` SortCost string `json:"sort_cost"` } // ExplainJSONMaterializedFromSubquery JSON type ExplainJSONMaterializedFromSubquery struct { UsingTemporaryTable bool `json:"using_temporary_table"` Dependent bool `json:"dependent"` Cacheable bool `json:"cacheable"` QueryBlock *ExplainJSONQueryBlock `json:"query_block"` } // 该变量用于存放 JSON 到 Traditional 模式的所有 ExplainJSONTable var explainJSONTables []*ExplainJSONTable // ExplainJSONTable JSON type ExplainJSONTable struct { TableName string `json:"table_name"` AccessType string `json:"access_type"` PossibleKeys []string `json:"possible_keys"` Key string `json:"key"` UsedKeyParts []string `json:"used_key_parts"` KeyLength string `json:"key_length"` Ref []string `json:"ref"` RowsExaminedPerScan int64 `json:"rows_examined_per_scan"` RowsProducedPerJoin int `json:"rows_produced_per_join"` Filtered string `json:"filtered"` UsingIndex bool `json:"using_index"` UsingIndexForGroupBy bool `json:"using_index_for_group_by"` CostInfo ExplainJSONCostInfo `json:"cost_info"` UsedColumns []string `json:"used_columns"` AttachedCondition string `json:"attached_condition"` AttachedSubqueries []ExplainJSONSubqueries `json:"attached_subqueries"` MaterializedFromSubquery ExplainJSONMaterializedFromSubquery `json:"materialized_from_subquery"` } // ExplainJSONNestedLoop JSON type ExplainJSONNestedLoop struct { Table ExplainJSONTable `json:"table"` } // ExplainJSONBufferResult JSON type ExplainJSONBufferResult struct { UsingTemporaryTable bool `json:"using_temporary_table"` NestedLoop []ExplainJSONNestedLoop `json:"nested_loop"` Table ExplainJSONTable `json:"table"` } // ExplainJSONSubqueries JSON type ExplainJSONSubqueries struct { Dependent bool `json:"dependent"` Cacheable bool `json:"cacheable"` QueryBlock ExplainJSONQueryBlock `json:"query_block"` } // ExplainJSONGroupingOperation JSON type ExplainJSONGroupingOperation struct { UsingTemporaryTable bool `json:"using_temporary_table"` UsingFilesort bool `json:"using_filesort"` Table ExplainJSONTable `json:"table"` CostInfo ExplainJSONCostInfo `json:"cost_info"` NestedLoop []ExplainJSONNestedLoop `json:"nested_loop"` GroupBySubqueries []ExplainJSONSubqueries `json:"group_by_subqueries"` } // ExplainJSONDuplicatesRemoval JSON type ExplainJSONDuplicatesRemoval struct { UsingTemporaryTable bool `json:"using_temporary_table"` UsingFilesort bool `json:"using_filesort"` BufferResult ExplainJSONBufferResult `json:"buffer_result"` GroupingOperation ExplainJSONGroupingOperation `json:"grouping_operation"` Table ExplainJSONTable `json:"table"` } // ExplainJSONOrderingOperation JSON type ExplainJSONOrderingOperation struct { UsingFilesort bool `json:"using_filesort"` Table ExplainJSONTable `json:"table"` DuplicatesRemoval ExplainJSONDuplicatesRemoval `json:"duplicates_removal"` GroupingOperation ExplainJSONGroupingOperation `json:"grouping_operation"` OrderbySubqueries []ExplainJSONSubqueries `json:"order_by_subqueries"` OptimizedAwaySubqueries []ExplainJSONSubqueries `json:"optimized_away_subqueries"` } // ExplainJSONQueryBlock JSON type ExplainJSONQueryBlock struct { SelectID int `json:"select_id"` CostInfo ExplainJSONCostInfo `json:"cost_info"` Table ExplainJSONTable `json:"table"` NestedLoop []ExplainJSONNestedLoop `json:"nested_loop"` OrderingOperation ExplainJSONOrderingOperation `json:"ordering_operation"` GroupingOperation ExplainJSONGroupingOperation `json:"grouping_operation"` OptimizedAwaySubqueries []ExplainJSONSubqueries `json:"optimized_away_subqueries"` HavingSubqueries []ExplainJSONSubqueries `json:"having_subqueries"` SelectListSubqueries []ExplainJSONSubqueries `json:"select_list_subqueries"` UpdateValueSubqueries []ExplainJSONSubqueries `json:"update_value_subqueries"` QuerySpecifications []ExplainJSONSubqueries `json:"query_specifications"` UnionResult ExplainJSONUnionResult `json:"union_result"` Message string `json:"message"` } // ExplainJSONUnionResult JSON type ExplainJSONUnionResult struct { UsingTemporaryTable bool `json:"using_temporary_table"` TableName string `json:"table_name"` AccessType string `json:"access_type"` QuerySpecifications []ExplainJSONSubqueries `json:"query_specifications"` } // ExplainJSON 根结点 type ExplainJSON struct { QueryBlock ExplainJSONQueryBlock `json:"query_block"` } // 为JSONFormatExplain准备的结构体 end } // ExplainKeyWords 需要解释的关键字 var ExplainKeyWords = []string{ "access_type", "attached_condition", "attached_subqueries", "buffer_result", "cacheable", "cost_info", "data_read_per_join", "dependent", "duplicates_removal", "eval_cost", "filtered", "group_by_subqueries", "grouping_operation", "having_subqueries", "key", "key_length", "materialized_from_subquery", "message", "nested_loop", "optimized_away_subqueries", "order_by_subqueries", "ordering_operation", "possible_keys", "prefix_cost", "query_block", "query_cost", "query_specifications", "read_cost", "ref", "rows_examined_per_scan", "rows_produced_per_join", "select_id", "select_list_subqueries", "sort_cost", "table", "table_name", "union_result", "update_value_subqueries", "used_columns", "used_key_parts", "using_filesort", "using_index", "using_index_for_group_by", "using_temporary_table", } /* // ExplainColumnIndent EXPLAIN表头 var ExplainColumnIndent = map[string]string{ "id": "id为SELECT的标识符. 它是在SELECT查询中的顺序编号. 如果这一行表示其他行的union结果, 这个值可以为空. 在这种情况下, table列会显示为形如, 表示它是id为M和N的查询行的联合结果.", "select_type": "表示查询的类型. ", "table": "输出行所引用的表.", "type": "type显示连接使用的类型, 有关不同类型的描述, 请参见解释连接类型.", "possible_keys": "指出MySQL能在该表中使用哪些索引有助于查询. 如果为空, 说明没有可用的索引.", "key": "MySQL实际从possible_keys选择使用的索引. 如果为NULL, 则没有使用索引. 很少情况下, MySQL会选择优化不足的索引. 这种情况下, 可以在select语句中使用USE INDEX (indexname)来强制使用一个索引或者用IGNORE INDEX (indexname)来强制MySQL忽略索引.", "key_len": "显示MySQL使用索引键的长度. 如果key是NULL, 则key_len为NULL. 使用的索引的长度. 在不损失精确性的情况下, 长度越短越好.", "ref": "显示索引的哪一列被使用了.", "rows": "表示MySQL认为必须检查的用来返回请求数据的行数.", "filtered": "表示返回结果的行占需要读到的行(rows列的值)的百分比.", "Extra": "该列显示MySQL在查询过程中的一些详细信息, MySQL查询优化器执行查询的过程中对查询计划的重要补充信息.", } */ // ExplainSelectType EXPLAIN中SELECT TYPE会出现的类型 var ExplainSelectType = map[string]string{ "SIMPLE": "简单SELECT(不使用UNION或子查询等).", "PRIMARY": "最外层的select.", "UNION": "UNION中的第二个或后面的SELECT查询, 不依赖于外部查询的结果集.", "DEPENDENT": "UNION中的第二个或后面的SELECT查询, 依赖于外部查询的结果集.", "UNION RESULT": "UNION查询的结果集.", "SUBQUERY": "子查询中的第一个SELECT查询, 不依赖于外部查询的结果集.", "DEPENDENT SUBQUERY": "子查询中的第一个SELECT查询, 依赖于外部查询的结果集.", "DERIVED": "用于from子句里有子查询的情况. MySQL会递归执行这些子查询, 把结果放在临时表里.", "MATERIALIZED": "Materialized subquery.", "UNCACHEABLE SUBQUERY": "结果集不能被缓存的子查询, 必须重新为外层查询的每一行进行评估.", "UNCACHEABLE UNION": "UNION中的第二个或后面的select查询, 属于不可缓存的子查询(类似于UNCACHEABLE SUBQUERY).", } // ExplainAccessType EXPLAIN中ACCESS TYPE会出现的类型 var ExplainAccessType = map[string]string{ "system": "这是const连接类型的一种特例, 该表仅有一行数据(=系统表).", "const": `const用于使用常数值比较PRIMARY KEY时, 当查询的表仅有一行时, 使用system. 例:SELECT * FROM tbl WHERE col = 1.`, "eq_ref": `除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'.`, "ref": `连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'.`, "fulltext": "查询时使用 FULLTEXT 索引.", "ref_or_null": "如同ref, 但是MySQL必须在初次查找的结果里找出null条目, 然后进行二次查找.", "index_merge": `表示使用了索引合并优化方法. 在这种情况下. key列包含了使用的索引的清单, key_len包含了使用的索引的最长的关键元素. 详情请见 8.2.1.4, “Index Merge Optimization”.`, "unique_subquery": `在某些IN查询中使用此种类型,而不是常规的ref:'value IN (SELECT PrimaryKey FROM SingleTable WHERE SomeExpr)'.`, "index_subquery": "在某些IN查询中使用此种类型, 与 unique_subquery 类似, 但是查询的是非唯一索引性索引.", "range": `只检索给定范围的行, 使用一个索引来选择行. key列显示使用了哪个索引. key_len包含所使用索引的最长关键元素.`, "index": "全表扫描, 只是扫描表的时候按照索引次序进行而不是行. 主要优点就是避免了排序, 但是开销仍然非常大.", "ALL": `最坏的情况, 从头到尾全表扫描.`, } // ExplainScalability ACCESS TYPE对应的运算复杂度 [AccessType]scalability map var ExplainScalability = map[string]string{ "NULL": "NULL", "ALL": "O(n)", "index": "O(n)", "range": "O(log n)+", "index_subquery": "O(log n)+", "unique_subquery": "O(log n)+", "index_merge": "O(log n)+", "ref_or_null": "O(log n)+", "fulltext": "O(log n)+", "ref": "O(log n)", "eq_ref": "O(log n)", "const": "O(1)", "system": "O(1)", } // ExplainExtra Extra信息解读 // https://dev.mysql.com/doc/refman/8.0/en/explain-output.html // sql/opt_explain_traditional.cc:traditional_extra_tags var ExplainExtra = map[string]string{ "Using temporary": "表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by.", "Using filesort": "MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'.", "Using index condition": "在5.6版本后加入的新特性(Index Condition Pushdown)。Using index condition 会先条件过滤索引,过滤完索引后找到所有符合索引条件的数据行,随后用 WHERE 子句中的其他条件去过滤这些数据行。", "Range checked for each record": "MySQL没有发现好的可以使用的索引,但发现如果来自前面的表的列值已知,可能部分索引可以使用。", "Using where with pushed condition": "这是一个仅仅在NDBCluster存储引擎中才会出现的信息,打开condition pushdown优化功能才可能被使用。", "Using MRR": "使用了 MRR Optimization IO 层面进行了优化,减少 IO 方面的开销。", "Skip_open_table": "Tables are read using the Multi-Range Read optimization strategy.", "Open_frm_only": "Table files do not need to be opened. The information is already available from the data dictionary.", "Open_full_table": "Unoptimized information lookup. Table information must be read from the data dictionary and by reading table files.", "Scanned": "This indicates how many directory scans the server performs when processing a query for INFORMATION_SCHEMA tables.", "Using index for group-by": "Similar to the Using index table access method, Using index for group-by indicates that MySQL found an index that can be used to retrieve all columns of a GROUP BY or DISTINCT query without any extra disk access to the actual table. Additionally, the index is used in the most efficient way so that for each group, only a few index entries are read.", "Start temporary": "This indicates temporary table use for the semi-join Duplicate Weedout strategy.Start", "End temporary": "This indicates temporary table use for the semi-join Duplicate Weedout strategy.End", "FirstMatch": "The semi-join FirstMatch join shortcutting strategy is used for tbl_name.", "Materialize": "Materialized subquery", "Start materialize": "Materialized subquery Start", "End materialize": "Materialized subquery End", "unique row not found": "For a query such as SELECT ... FROM tbl_name, no rows satisfy the condition for a UNIQUE index or PRIMARY KEY on the table.", // "Scan": "", // "Impossible ON condition": "", // "Ft_hints:": "", // "Backward index scan": "", // "Recursive": "", // "Table function:": "", "Index dive skipped due to FORCE": "This item applies to NDB tables only. It means that MySQL Cluster is using the Condition Pushdown optimization to improve the efficiency of a direct comparison between a nonindexed column and a constant. In such cases, the condition is “pushed down” to the cluster's data nodes and is evaluated on all data nodes simultaneously. This eliminates the need to send nonmatching rows over the network, and can speed up such queries by a factor of 5 to 10 times over cases where Condition Pushdown could be but is not used.", "Impossible WHERE noticed after reading const tables": "查询了所有const(和system)表, 但发现WHERE查询条件不起作用.", "Using where": "WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的.", "Using join buffer": "从已有连接中找被读入缓存的数据, 并且通过缓存来完成与当前表的连接.", "Using index": "只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询.", "const row not found": "空表做类似 SELECT ... FROM tbl_name 的查询操作.", "Distinct": "MySQL is looking for distinct values, so it stops searching for more rows for the current row combination after it has found the first matching row.", "Full scan on NULL key": "子查询中的一种优化方式, 常见于无法通过索引访问null值.", "Impossible HAVING": "HAVING条件过滤没有效果, 返回已有查询的结果集.", "Impossible WHERE": "WHERE条件过滤没有效果, 最终是全表扫描.", "LooseScan": "使用半连接LooseScan策略.", "No matching min/max row": "没有行满足查询的条件, 如 SELECT MIN(...) FROM ... WHERE condition.", "no matching row in const table": "对于连接查询, 列未满足唯一索引的条件或表为空.", "No matching rows after partition pruning": "对于DELETE 或 UPDATE, 优化器在分区之后, 未发现任何要删除或更新的内容. 类似查询 Impossible WHERE.", "No tables used": "查询没有FROM子句, 或者有一个 FROM DUAL子句.", "Not exists": "MySQL能够对LEFT JOIN查询进行优化, 并且在查找到符合LEFT JOIN条件的行后, 则不再查找更多的行.", "Plan isn't ready yet": "This value occurs with EXPLAIN FOR CONNECTION when the optimizer has not finished creating the execution plan for the statement executing in the named connection. If execution plan output comprises multiple lines, any or all of them could have this Extra value, depending on the progress of the optimizer in determining the full execution plan.", "Select tables optimized away": "仅通过使用索引,优化器可能仅从聚合函数结果中返回一行。如:在没有 GROUP BY 子句的情况下,基于索引优化 MIN/MAX 操作,或者对于 MyISAM 存储引擎优化 COUNT(*) 操作,不必等到执行阶段再进行计算,查询执行计划生成的阶段即完成优化。", "Using intersect": "开启了index merge,即:对多个索引分别进行条件扫描,然后将它们各自的结果进行合并,使用的算法为:index_merge_intersection", "Using union": "开启了index merge,即:对多个索引分别进行条件扫描,然后将它们各自的结果进行合并,使用的算法为:index_merge_union", "Using sort_union": "开启了index merge,即:对多个索引分别进行条件扫描,然后将它们各自的结果进行合并,使用的算法为:index_merge_sort_union", } // 提取ExplainJSON中所有的ExplainJSONTable, 将其写入全局变量explainJSONTables // depth只是用于debug,逻辑上并未使用 func findTablesInJSON(explainJSON string, depth int) { common.Log.Debug("findTablesInJSON Enter: depth(%d), json(%s)", depth, explainJSON) // 去除注释,语法检查 explainJSON = RemoveSQLComments(explainJSON) if !gjson.Valid(explainJSON) { return } // 提取所有ExplainJSONTable struct for _, key := range ExplainKeyWords { result := gjson.Get(explainJSON, key) if result.String() == "" { continue } if key == "table" { table := new(ExplainJSONTable) common.Log.Debug("findTablesInJSON FindTable: depth(%d), table(%s)", depth, result.String) err := json.Unmarshal([]byte(result.Raw), table) common.LogIfError(err, "") if table.TableName != "" { explainJSONTables = append(explainJSONTables, table) } findTablesInJSON(result.String(), depth+1) } else { common.Log.Debug("findTablesInJSON ScanOther: depth(%d), key(%s), array_len(%d), json(%s)", depth, key, len(result.Array()), result.String) for _, val := range result.Array() { if val.String() != "" { findTablesInJSON(val.String(), depth+1) } } findTablesInJSON(result.String(), depth+1) } } } // FormatJSONIntoTraditional 将JSON形式转换为TRADITIONAL形式,方便前端展现 func FormatJSONIntoTraditional(explainJSON string) []ExplainRow { // 查找JSON中的所有ExplainJSONTable explainJSONTables = []*ExplainJSONTable{} findTablesInJSON(explainJSON, 0) var explainRows []ExplainRow id := -1 for _, table := range explainJSONTables { keyLen := table.KeyLength filtered, err := strconv.ParseFloat(table.Filtered, 64) if err != nil { filtered = 0.00 } if filtered > 100.00 { filtered = 100.00 } explainRows = append(explainRows, ExplainRow{ ID: id + 1, SelectType: "", TableName: table.TableName, Partitions: "NULL", AccessType: table.AccessType, PossibleKeys: table.PossibleKeys, Key: table.Key, KeyLen: keyLen, Ref: table.Ref, Rows: table.RowsExaminedPerScan, Filtered: filtered, Scalability: ExplainScalability[table.AccessType], Extra: "", }) } return explainRows } // ConvertExplainJSON2Row 将 JSON 格式转成 ROW 格式,为方便统一做优化建议 // 但是会损失一些 JSON 特有的分析结果 func ConvertExplainJSON2Row(explainJSON *ExplainJSON) []ExplainRow { buf, err := json.Marshal(explainJSON) if err != nil { return nil } return FormatJSONIntoTraditional(string(buf)) } // 用于检测 MySQL 版本是否低于 MySQL5.6 // 低于5.6 返回 true, 表示需要改写非 SELECT 的 SQL --> SELECT func (db *Connector) supportExplainWrite() (bool, error) { defer func() { err := recover() if err != nil { common.Log.Error("Recover supportExplainWrite() Error:", err) } }() // 5.6以上版本支持 EXPLAIN UPDATE/DELETE 等语句,但需要开启写入 // 如开启了 read_only, EXPLAIN UPDATE/DELETE 也会受限制 if common.Config.TestDSN.Version >= 50600 { readOnly, err := db.SingleIntValue("read_only") if err != nil { return false, err } superReadOnly, err := db.SingleIntValue("super_read_only") // Percona, MariaDB 5.6就已经有super_read_only了,但社区版5.6还没有这个参数 if err != nil { if !strings.Contains(err.Error(), "Unknown system variable") { return false, err } superReadOnly = readOnly } if readOnly == 1 || superReadOnly == 1 { return true, nil } return false, nil } return true, nil } // 将SQL语句转换为可以被Explain的语句,如:写转读 // 当输出为空时,表示语法错误或不支持EXPLAIN func (db *Connector) explainAbleSQL(sql string) (string, error) { stmt, err := sqlparser.Parse(sql) if err != nil { // TODO: charset, collation tiStmt, tiErr := ast.TiParse(sql, "", "") if tiErr != nil { common.Log.Error("explainAbleSQL ast.TiParse Error: %v", tiErr) return "", tiErr } var isSelect bool for _, st := range tiStmt { switch st.(type) { // SetOprStmt represents "union/except/intersect statement" case *tidb.SelectStmt, *tidb.SetOprStmt: isSelect = true default: isSelect = false } if !isSelect { break } } if isSelect { return sql, nil } common.Log.Error("explainAbleSQL sqlparser.Parse Error: %v", err) return "", err } switch stmt.(type) { case *sqlparser.Insert, *sqlparser.Update, *sqlparser.Delete: // REPLACE 和 INSERT 的 AST 基本相同,只是 Action 不同 // 判断 Explain 的 SQL 是否需要被改写 need, err := db.supportExplainWrite() if err != nil { common.Log.Error("explainAbleSQL db.supportExplainWrite Error: %v", err) return "", err } if need { rw := ast.NewRewrite(sql) if rw != nil { return rw.RewriteDML2Select().NewSQL, nil } } return sql, nil case *sqlparser.Union, *sqlparser.ParenSelect, *sqlparser.Select, sqlparser.SelectStatement: return sql, nil default: } return "", nil } // explainQuery 生成可执行的 explain 查询请求 func (db *Connector) explainQuery(sql string, explainType int, formatType int) string { var err error sql, err = db.explainAbleSQL(sql) if sql == "" || err != nil { return sql } else { // MySQL 5.7 support MAX_EXECUTION_TIME hint // ref: https://dev.mysql.com/doc/refman/5.7/en/optimizer-hints.html re := regexp.MustCompile(`(?i)(^select)(.*)`) sql = re.ReplaceAllString(sql, "SELECT /*+ MAX_EXECUTION_TIME(1000) */${2}") } // 5.6以上支持 FORMAT=JSON explainFormat := "" switch formatType { case JSONFormatExplain: if common.Config.TestDSN.Version >= 50600 { explainFormat = "FORMAT=JSON" } } // 执行 explain switch explainType { case ExtendedExplainType: // 5.6以上extended关键字已经不推荐使用,8.0废弃了这个关键字 if common.Config.TestDSN.Version >= 50600 { sql = fmt.Sprintf("explain %s", sql) } else { sql = fmt.Sprintf("explain extended %s", sql) } case PartitionsExplainType: sql = fmt.Sprintf("explain partitions %s", sql) default: sql = fmt.Sprintf("explain %s %s", explainFormat, sql) } return sql } // MySQLExplainWarnings WARNINGS信息中包含的优化器信息 func MySQLExplainWarnings(exp *ExplainInfo) string { content := "## MySQL优化器调优结果\n\n```sql\n" for _, row := range exp.Warnings { content += "\n" + row.Message + "\n" } content += "\n```" return content } // MySQLExplainQueryCost 将last_query_cost信息补充到评审结果中 func MySQLExplainQueryCost(exp *ExplainInfo) string { var content string if exp == nil { return content } if exp.QueryCost > 0 { tmp := fmt.Sprintf("%.3f\n", exp.QueryCost) content = "Query cost: " if exp.QueryCost > float64(common.Config.MaxQueryCost) { content += fmt.Sprintf("☠️ **%s**", tmp) } else { content += tmp } } return content } // ExplainInfoTranslator 将explain信息翻译成人能读懂的 func ExplainInfoTranslator(exp *ExplainInfo) string { var buf []string var selectTypeBuf []string var accessTypeBuf []string var extraTypeBuf []string buf = append(buf, fmt.Sprint("### Explain信息解读\n")) rows := exp.ExplainRows if exp.ExplainFormat == JSONFormatExplain { // JSON形式遍历分析不方便,转成Row格式统一处理 rows = ConvertExplainJSON2Row(exp.ExplainJSON) } if len(rows) == 0 { return "" } // SelectType信息解读 explainSelectType := make(map[string]string) for k, v := range ExplainSelectType { explainSelectType[k] = v } for _, row := range rows { if _, ok := explainSelectType[row.SelectType]; ok { desc := fmt.Sprintf("* **%s**: %s\n", row.SelectType, explainSelectType[row.SelectType]) selectTypeBuf = append(selectTypeBuf, desc) delete(explainSelectType, row.SelectType) } } if len(selectTypeBuf) > 0 { buf = append(buf, fmt.Sprint("#### SelectType信息解读\n")) sort.Strings(selectTypeBuf) buf = append(buf, strings.Join(selectTypeBuf, "\n")) } // #### Type信息解读 explainAccessType := make(map[string]string) for k, v := range ExplainAccessType { explainAccessType[k] = v } for _, row := range rows { if _, ok := explainAccessType[row.AccessType]; ok { var warn bool var desc string for _, t := range common.Config.ExplainWarnAccessType { if row.AccessType == t { warn = true } } if warn { desc = fmt.Sprintf("* ☠️ **%s**: %s\n", row.AccessType, explainAccessType[row.AccessType]) } else { desc = fmt.Sprintf("* **%s**: %s\n", row.AccessType, explainAccessType[row.AccessType]) } accessTypeBuf = append(accessTypeBuf, desc) delete(explainAccessType, row.AccessType) } } if len(accessTypeBuf) > 0 { buf = append(buf, fmt.Sprint("#### Type信息解读\n")) sort.Strings(accessTypeBuf) buf = append(buf, strings.Join(accessTypeBuf, "\n")) } // #### Extra信息解读 if exp.ExplainFormat != JSONFormatExplain { explainExtra := make(map[string]string) for k, v := range ExplainExtra { explainExtra[k] = v } for _, row := range rows { for k, c := range explainExtra { if strings.Contains(row.Extra, k) { if k == "Impossible WHERE" && strings.Contains(row.Extra, "Impossible WHERE noticed after reading const tables") { continue } if k == "Using index" && strings.Contains(row.Extra, "Using index condition") { continue } warn := false for _, w := range common.Config.ExplainWarnExtra { if k == w { warn = true } } if warn { extraTypeBuf = append(extraTypeBuf, fmt.Sprintf("* ☠️ **%s**: %s\n", k, c)) } else { extraTypeBuf = append(extraTypeBuf, fmt.Sprintf("* **%s**: %s\n", k, c)) } delete(explainExtra, k) } } } } if len(extraTypeBuf) > 0 { buf = append(buf, fmt.Sprint("#### Extra信息解读\n")) sort.Strings(extraTypeBuf) buf = append(buf, strings.Join(extraTypeBuf, "\n")) } return strings.Join(buf, "\n") } // ParseExplainText 解析explain文本信息(很可能是用户复制粘贴得到),返回格式化数据 func ParseExplainText(content string) (exp *ExplainInfo, err error) { exp = &ExplainInfo{ExplainFormat: TraditionalFormatExplain} content = strings.TrimSpace(content) verticalFormat := strings.HasPrefix(content, "*") jsonFormat := strings.HasPrefix(content, "{") traditionalFormat := strings.HasPrefix(content, "+") if verticalFormat && traditionalFormat && jsonFormat { return nil, errors.New("not supported explain type") } if verticalFormat { exp.ExplainRows, err = parseVerticalExplainText(content) } if jsonFormat { exp.ExplainFormat = JSONFormatExplain exp.ExplainJSON, err = parseJSONExplainText(content) } if traditionalFormat { exp.ExplainRows, err = parseTraditionalExplainText(content) } return exp, err } // 解析文本形式传统形式Explain信息 func parseTraditionalExplainText(content string) (explainRows []ExplainRow, err error) { LS := regexp.MustCompile(`^\+`) // 华丽的分隔线:) // 格式正确性检查 lines := strings.Split(content, "\n") if len(lines) < 3 { return nil, errors.New("explain Rows less than 3") } // 提取头部,用于后续list到map的转换 var header []string for _, h := range strings.Split(strings.Trim(lines[1], "|"), "|") { header = append(header, strings.TrimSpace(h)) } colIdx := make(map[string]int) for i, item := range header { colIdx[strings.ToLower(item)] = i } // explain format=json未把外面的框去了 if strings.ToLower(header[0]) == "explain" { return nil, errors.New("json format explain need remove") } // 将每一列填充至ExplainRow结构体 colsMap := make(map[string]string) for _, l := range lines[3:] { var keylen string var rows int64 var filtered float64 var partitions string // 跳过分割线 if LS.MatchString(l) || strings.TrimSpace(l) == "" { continue } // list到map的转换 var cols []string for _, c := range strings.Split(strings.Trim(l, "|"), "|") { cols = append(cols, strings.TrimSpace(c)) } for item, i := range colIdx { colsMap[item] = cols[i] } // 值类型转换 id, err := strconv.Atoi(colsMap["id"]) if err != nil { return nil, err } // 不存在字段给默认值 if colsMap["partitions"] == "" { partitions = "NULL" } else { partitions = colsMap["partitions"] } keylen = colsMap["key_len"] rows, err = strconv.ParseInt(colsMap["Rows"], 10, 64) if err != nil { rows = 0 } filtered, err = strconv.ParseFloat(colsMap["filtered"], 64) if err != nil { filtered = 0.00 } // filtered may larger than 100.00 // https://bugs.mysql.com/bug.php?id=34124 if filtered >= 100.00 { filtered = 100.00 } // 拼接结构体 explainRows = append(explainRows, ExplainRow{ ID: id, SelectType: colsMap["select_type"], TableName: colsMap["table"], Partitions: partitions, AccessType: colsMap["type"], PossibleKeys: strings.Split(colsMap["possible_keys"], ","), Key: colsMap["key"], KeyLen: keylen, Ref: strings.Split(colsMap["ref"], ","), Rows: rows, Filtered: filtered, Scalability: ExplainScalability[colsMap["type"]], Extra: colsMap["extra"], }) } return explainRows, nil } // 解析文本形式竖排版 Explain信息 func parseVerticalExplainText(content string) (explainRows []ExplainRow, err error) { var lines []string explainRow := ExplainRow{ Partitions: "NULL", Filtered: 0.00, } LS := regexp.MustCompile(`^\*.*\*$`) // 华丽的分隔线:) // 格式正确性检查 for _, l := range strings.Split(content, "\n") { lines = append(lines, strings.TrimSpace(l)) } if len(lines) < 11 { return nil, errors.New("explain rows less than 11") } // 将每一行填充至ExplainRow结构体 for _, l := range lines { if LS.MatchString(l) || strings.TrimSpace(l) == "" { continue } if strings.HasPrefix(l, "id:") { id := strings.TrimPrefix(l, "id: ") explainRow.ID, err = strconv.Atoi(id) if err != nil { return nil, err } } if strings.HasPrefix(l, "select_type:") { explainRow.SelectType = strings.TrimPrefix(l, "select_type: ") } if strings.HasPrefix(l, "table:") { explainRow.TableName = strings.TrimPrefix(l, "table: ") } if strings.HasPrefix(l, "partitions:") { explainRow.AccessType = strings.TrimPrefix(l, "partitions: ") } if strings.HasPrefix(l, "type:") { explainRow.AccessType = strings.TrimPrefix(l, "type: ") explainRow.Scalability = ExplainScalability[explainRow.AccessType] } if strings.HasPrefix(l, "possible_keys:") { explainRow.PossibleKeys = strings.Split(strings.TrimPrefix(l, "possible_keys: "), ",") } if strings.HasPrefix(l, "key:") { explainRow.Key = strings.TrimPrefix(l, "key: ") } if strings.HasPrefix(l, "key_len:") { keyLen := strings.TrimPrefix(l, "key_len: ") explainRow.KeyLen = keyLen } if strings.HasPrefix(l, "ref:") { explainRow.Ref = strings.Split(strings.TrimPrefix(l, "ref: "), ",") } if strings.HasPrefix(l, "Rows:") { rows := strings.TrimPrefix(l, "Rows: ") explainRow.Rows, err = strconv.ParseInt(rows, 10, 64) if err != nil { explainRow.Rows = 0 } } if strings.HasPrefix(l, "filtered:") { filtered := strings.TrimPrefix(l, "filtered: ") explainRow.Filtered, err = strconv.ParseFloat(filtered, 64) if err != nil { return nil, err } else if explainRow.Filtered > 100.00 { explainRow.Filtered = 100.00 } } if strings.HasPrefix(l, "Extra:") { explainRow.Extra = strings.TrimPrefix(l, "Extra: ") explainRows = append(explainRows, explainRow) } } return explainRows, err } // 解析文本形式JSON Explain信息 func parseJSONExplainText(content string) (*ExplainJSON, error) { explainJSON := new(ExplainJSON) err := json.Unmarshal([]byte(RemoveSQLComments(content)), explainJSON) return explainJSON, err } // ParseExplainResult 分析 mysql 执行 explain 的结果,返回 ExplainInfo 结构化数据 func ParseExplainResult(res QueryResult, formatType int) (exp *ExplainInfo, err error) { exp = &ExplainInfo{ ExplainFormat: formatType, } // JSON 格式直接调用文本方式解析 if formatType == JSONFormatExplain { if res.Rows.Next() { var explainString string err = res.Rows.Scan(&explainString) if err != nil { common.Log.Debug(err.Error()) } exp.ExplainJSON, err = parseJSONExplainText(explainString) } res.Rows.Close() return exp, err } /* +----+-------------+-------+------------+------+---------------+------+---------+------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+------+---------------+------+---------+------+------+----------+-------+ | 1 | SIMPLE | film | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | 100.00 | NULL | +----+-------------+-------+------------+------+---------------+------+---------+------+------+----------+-------+ +----+-------------+-------+------------+------+---------------+------+---------+------+------+----------+--------------------------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+------+---------------+------+---------+------+------+----------+--------------------------------+ | 1 | SIMPLE | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | no matching row in const table | +----+-------------+-------+------------+------+---------------+------+---------+------+------+----------+--------------------------------+ */ // Different MySQL version has different columns define var selectType, table, partitions, accessType, possibleKeys, key, keyLen, ref, extra, rows, filtered []byte expRow := ExplainRow{} explainFields := make([]interface{}, 0) fields := map[string]interface{}{ "id": &expRow.ID, "select_type": &selectType, "table": &table, "partitions": &partitions, "type": &accessType, "possible_keys": &possibleKeys, "key": &key, "key_len": &keyLen, "ref": &ref, "rows": &rows, "filtered": &filtered, "Extra": &extra, } cols, err := res.Rows.Columns() common.LogIfError(err, "") var colByPass []byte for _, col := range cols { if _, ok := fields[col]; ok { explainFields = append(explainFields, fields[col]) } else { common.Log.Debug("ParseExplainResult by pass column %s", col) explainFields = append(explainFields, &colByPass) } } // 补全 ExplainRows var explainRows []ExplainRow for res.Rows.Next() { err := res.Rows.Scan(explainFields...) if err != nil { common.Log.Warn(err.Error()) } expRow.SelectType = NullString(selectType) expRow.TableName = NullString(table) expRow.Partitions = NullString(partitions) expRow.AccessType = NullString(accessType) expRow.PossibleKeys = strings.Split(NullString(possibleKeys), ",") expRow.Key = NullString(key) expRow.KeyLen = NullString(keyLen) expRow.Ref = strings.Split(NullString(ref), ",") expRow.Rows = NullInt(rows) expRow.Filtered = NullFloat(filtered) expRow.Extra = NullString(extra) // MySQL bug: https://bugs.mysql.com/bug.php?id=34124 if expRow.Filtered > 100.00 { expRow.Filtered = 100.00 } expRow.Scalability = ExplainScalability[expRow.AccessType] explainRows = append(explainRows, expRow) } res.Rows.Close() exp.ExplainRows = explainRows // check explain warning info if common.Config.ShowWarnings { for res.Warning.Next() { var expWarning ExplainWarning err = res.Warning.Scan(&expWarning.Level, &expWarning.Code, &expWarning.Message) if err != nil { break } // 'EXTENDED' is deprecated and will be removed in a future release. if expWarning.Code != 1681 { exp.Warnings = append(exp.Warnings, expWarning) } } res.Warning.Close() } // 添加 last_query_cost exp.QueryCost = res.QueryCost return exp, err } // Explain 获取 SQL 的 explain 信息 func (db *Connector) Explain(sql string, explainType int, formatType int) (exp *ExplainInfo, err error) { exp = &ExplainInfo{SQL: sql} if explainType != TraditionalExplainType { formatType = TraditionalFormatExplain } defer func() { if e := recover(); e != nil { const size = 4096 buf := make([]byte, size) buf = buf[:runtime.Stack(buf, false)] common.Log.Error("Recover Explain() Error: %v\n%v", e, string(buf)) err = errors.New(fmt.Sprint(e)) } }() // 执行EXPLAIN请求 exp.SQL = db.explainQuery(sql, explainType, formatType) if exp.SQL == "" { return exp, nil } res, err := db.Query(exp.SQL) if err != nil { return exp, err } // 解析mysql结果,输出ExplainInfo exp, err = ParseExplainResult(res, formatType) return exp, err } // PrintMarkdownExplainTable 打印 markdown 格式的 explain table func PrintMarkdownExplainTable(exp *ExplainInfo) string { var buf []string rows := exp.ExplainRows // JSON 转换为 TRADITIONAL 格式 if exp.ExplainFormat == JSONFormatExplain { buf = append(buf, fmt.Sprint("以下为 JSON 格式转为传统格式 EXPLAIN 表格", "\n\n")) rows = ConvertExplainJSON2Row(exp.ExplainJSON) } // explain出错 if len(rows) == 0 { return "" } if exp.ExplainFormat == JSONFormatExplain { buf = append(buf, fmt.Sprintln("| table | partitions | type | possible\\_keys | key | key\\_len | ref | rows | filtered | scalability | Extra |")) buf = append(buf, fmt.Sprintln("|---|---|---|---|---|---|---|---|---|---|---|")) for _, row := range rows { buf = append(buf, fmt.Sprintln("|", row.TableName, "|", row.Partitions, "|", row.AccessType, "|", strings.Join(row.PossibleKeys, ","), "|", row.Key, "|", row.KeyLen, "|", strings.Join(row.Ref, ","), "|", row.Rows, "|", fmt.Sprintf("%.2f%s", row.Filtered, "%"), "|", row.Scalability, "|", row.Extra, "|")) } } else { buf = append(buf, fmt.Sprintln("| id | select\\_type | table | partitions | type | possible_keys | key | key\\_len | ref | rows | filtered | scalability | Extra |")) buf = append(buf, fmt.Sprintln("|---|---|---|---|---|---|---|---|---|---|---|---|---|")) for _, row := range rows { // 加粗 rows := fmt.Sprint(row.Rows) if row.Rows >= common.Config.ExplainMaxRows { rows = "☠️ **" + rows + "**" } filtered := fmt.Sprintf("%.2f%s", row.Filtered, "%") if row.Filtered >= common.Config.ExplainMaxFiltered { filtered = "☠️ **" + filtered + "**" } scalability := row.Scalability for _, s := range common.Config.ExplainWarnScalability { if s == scalability { scalability = "☠️ **" + s + "**" } } buf = append(buf, fmt.Sprintln("|", row.ID, " |", common.MarkdownEscape(row.SelectType), "| *"+common.MarkdownEscape(row.TableName)+"* |", common.MarkdownEscape(row.Partitions), "|", common.MarkdownEscape(row.AccessType), "|", common.MarkdownEscape(strings.Join(row.PossibleKeys, ",
")), "|", common.MarkdownEscape(row.Key), "|", row.KeyLen, "|", common.MarkdownEscape(strings.Join(row.Ref, ",
")), "|", rows, "|", filtered, "|", scalability, "|", strings.Replace(common.MarkdownEscape(row.Extra), ",", ",
", -1), "|")) } } buf = append(buf, "\n") return strings.Join(buf, "") } ================================================ FILE: database/explain_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "fmt" "testing" "github.com/XiaoMi/soar/common" "github.com/kr/pretty" ) var sqls = []string{ `use sakila`, // not explain able sql, will convert to empty! `select * from city where country_id = 44;`, `select * from address where address2 is not null;`, `select * from address where address2 is null;`, `select * from address where address2 >= 44;`, `select * from city where country_id between 44 and 107;`, `select * from city where city like 'Ad%';`, `select * from city where city = 'Aden' and country_id = 107;`, `select * from city where country_id > 31 and city = 'Aden';`, `select * from address where address_id > 8 and city_id < 400 and district = 'Nantou';`, `select * from address where address_id > 8 and city_id < 400;`, `select first_name from actor where last_update='2006-02-15 04:34:33' and last_name='CHASE' group by first_name;`, `select district from address where last_update >='2014-09-25 22:33:47' group by district;`, `select address from address group by address,district;`, `select district from address where last_update='2014-09-25 22:30:27' group by district,(address_id+city_id);`, `select * from customer where active=1 order by last_name limit 10;`, `select * from customer order by last_name limit 10;`, `select * from customer where address_id > 224 order by address_id limit 10;`, `select * from customer where address_id < 224 order by address_id limit 10;`, `select * from customer where active=1 order by last_name;`, `select * from customer where address_id > 224 order by address_id;`, `select * from customer where address_id in (224,510) order by last_name;`, `select city from city where country_id = 44;`, `select city,city_id from city where country_id = 44 and last_update='2006-02-15 04:45:25';`, `select city from city where country_id > 44 and last_update > '2006-02-15 04:45:25';`, `select * from city where country_id=1 and city='Kabul' order by last_update;`, `select * from city where country_id>1 and city='Kabul' order by last_update;`, `select * from city where city_id>251 order by last_update;`, `select * from city i inner join country o on i.country_id=o.country_id;`, `select * from city i left join country o on i.city_id=o.country_id;`, `select * from city i right join country o on i.city_id=o.country_id;`, `select * from city i left join country o on i.city_id=o.country_id where o.country_id is null;`, `select * from city i right join country o on i.city_id=o.country_id where i.city_id is null;`, `select * from city i left join country o on i.city_id=o.country_id union select * from city i right join country o on i.city_id=o.country_id;`, `select * from city i left join country o on i.city_id=o.country_id where o.country_id is null union select * from city i right join country o on i.city_id=o.country_id where i.city_id is null;`, `select first_name,last_name,email from customer natural left join address;`, `select first_name,last_name,email from customer natural left join address;`, `select first_name,last_name,email from customer natural right join address;`, `select first_name,last_name,email from customer STRAIGHT_JOIN address on customer.address_id=address.address_id;`, `select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;`, `SELECT a.table_name 表名, a.table_comment 表说明, b.COLUMN_NAME 字段名, b.column_comment 字段说明, b.column_type 字段类型, b.column_key 约束 FROM information_schema.TABLES a LEFT JOIN information_schema. COLUMNS b ON a.table_name = b.TABLE_NAME WHERE a.table_schema IN ('a') AND b.column_comment LIKE '%一%' ORDER BY a.table_name`, } var exp = []string{ `+----+-------------+---------+-------+---------------------------------------------------------+-------------------+---------+---------------------------+------+-------------+ | id | select_type | table | type | possible_keys | key | key_len | ref | rows | Extra | +----+-------------+---------+-------+---------------------------------------------------------+-------------------+---------+---------------------------+------+-------------+ | 1 | SIMPLE | country | index | PRIMARY,country_id | country | 152 | NULL | 109 | Using index | | 1 | SIMPLE | city | ref | idx_fk_country_id,idx_country_id_city,idx_all,idx_other | idx_fk_country_id | 2 | sakila.country.country_id | 2 | Using index | +----+-------------+---------+-------+---------------------------------------------------------+-------------------+---------+---------------------------+------+-------------+`, `+----+-------------+---------+------------+-------+-------------------+-------------------+---------+---------------------------+------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+---------+------------+-------+-------------------+-------------------+---------+---------------------------+------+----------+-------------+ | 1 | SIMPLE | country | NULL | index | PRIMARY | PRIMARY | 2 | NULL | 109 | 100.00 | Using index | | 1 | SIMPLE | city | NULL | ref | idx_fk_country_id | idx_fk_country_id | 2 | sakila.country.country_id | 5 | 100.00 | Using index | +----+-------------+---------+------------+-------+-------------------+-------------------+---------+---------------------------+------+----------+-------------+`, `*************************** 1. row *************************** id: 1 select_type: SIMPLE table: country type: index possible_keys: PRIMARY,country_id key: country key_len: 152 ref: NULL rows: 109 Extra: Using index *************************** 2. row *************************** id: 1 select_type: SIMPLE table: city type: ref possible_keys: idx_fk_country_id,idx_country_id_city,idx_all,idx_other key: idx_fk_country_id key_len: 2 ref: sakila.country.country_id rows: 2 Extra: Using index`, `+----+-------------+---------+------------+-------+---------------------------------------------------------+-------------------+---------+---------------------------+------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | Extra | +----+-------------+---------+------------+-------+---------------------------------------------------------+-------------------+---------+---------------------------+------+-------------+ | 1 | SIMPLE | country | NULL | index | PRIMARY,country_id | country | 152 | NULL | 109 | Using index | | 1 | SIMPLE | city | NULL | ref | idx_fk_country_id,idx_country_id_city,idx_all,idx_other | idx_fk_country_id | 2 | sakila.country.country_id | 2 | Using index | +----+-------------+---------+------------+-------+---------------------------------------------------------+-------------------+---------+---------------------------+------+-------------+`, `{ "query_block": { "select_id": 1, "message": "No tables used" } /* query_block */ }`, `{ "query_block": { "select_id": 1, "message": "no matching row in const table" } }`, `{ "query_block": { "select_id": 1, "table": { "insert": true, "table_name": "t1", "access_type": "ALL" } /* table */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "message": "no matching row in const table" } /* query_block */ }`, `{ "query_block": { "select_id": 1, "message": "no matching row in const table" } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "13.50" } /* cost_info */, "table": { "table_name": "a4", "access_type": "ALL", "rows_examined_per_scan": 14, "rows_produced_per_join": 14, "filtered": "100.00", "cost_info": { "read_cost": "10.70", "eval_cost": "2.80", "prefix_cost": "13.50", "data_read_per_join": "224" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "materialized_from_subquery": { "using_temporary_table": true, "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "13.50" } /* cost_info */, "table": { "table_name": "a3", "access_type": "ALL", "rows_examined_per_scan": 14, "rows_produced_per_join": 14, "filtered": "100.00", "cost_info": { "read_cost": "10.70", "eval_cost": "2.80", "prefix_cost": "13.50", "data_read_per_join": "224" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "materialized_from_subquery": { "using_temporary_table": true, "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "cost_info": { "query_cost": "13.50" } /* cost_info */, "table": { "table_name": "a2", "access_type": "ALL", "rows_examined_per_scan": 14, "rows_produced_per_join": 14, "filtered": "100.00", "cost_info": { "read_cost": "10.70", "eval_cost": "2.80", "prefix_cost": "13.50", "data_read_per_join": "224" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "materialized_from_subquery": { "using_temporary_table": true, "dependent": false, "cacheable": true, "query_block": { "select_id": 4, "cost_info": { "query_cost": "15.55" } /* cost_info */, "nested_loop": [ { "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */ } /* table */ }, { "table": { "table_name": "a1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 14, "filtered": "100.00", "using_join_buffer": "Block Nested Loop", "cost_info": { "read_cost": "10.35", "eval_cost": "2.80", "prefix_cost": "15.55", "data_read_per_join": "224" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "materialized_from_subquery": { "using_temporary_table": true, "dependent": false, "cacheable": true, "query_block": { "select_id": 5, "cost_info": { "query_cost": "3.41" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 7, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.40", "prefix_cost": "3.41", "data_read_per_join": "56" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ } /* materialized_from_subquery */ } /* table */ } ] /* nested_loop */ } /* query_block */ } /* materialized_from_subquery */ } /* table */ } /* query_block */ } /* materialized_from_subquery */ } /* table */ } /* query_block */ } /* materialized_from_subquery */ } /* table */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "5.81" } /* cost_info */, "nested_loop": [ { "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 0, "filtered": "14.29", "cost_info": { "read_cost": "3.21", "eval_cost": "0.20", "prefix_cost": "3.41", "data_read_per_join": "7" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "attached_condition": "(test.t1.i = 10)" } /* table */ }, { "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 0, "filtered": "50.00", "first_match": "t1", "using_join_buffer": "Block Nested Loop", "cost_info": { "read_cost": "2.20", "eval_cost": "0.20", "prefix_cost": "5.82", "data_read_per_join": "7" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "attached_condition": "(test.t2.i = 10)" } /* table */ } ] /* nested_loop */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "3.41" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 7, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.40", "prefix_cost": "3.41", "data_read_per_join": "56" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "attached_condition": "((test.t1.i ,(/* select#2 */ select 1 from test.t2 where ((test.t1.i = 10) and ((test.t1.i) = test.t2.i)))) or (test.t1.i.test.t1.i in ( (/* select#3 */ select NULL from test.t4 where 1 ), (test.t1.i in on where ((test.t1.i = materialized-subquery.i))))))", "attached_subqueries": [ { "table": { "table_name": "", "access_type": "eq_ref", "key": "", "key_length": "5", "rows_examined_per_scan": 1, "materialized_from_subquery": { "using_temporary_table": true, "dependent": true, "cacheable": false, "query_block": { "select_id": 3, "message": "no matching row in const table" } /* query_block */ } /* materialized_from_subquery */ } /* table */ }, { "dependent": true, "cacheable": false, "query_block": { "select_id": 2, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 1, "filtered": "50.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.20", "prefix_cost": "2.40", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "attached_condition": "((test.t1.i = 10) and ((test.t1.i) = test.t2.i))" } /* table */ } /* query_block */ } ] /* attached_subqueries */ } /* table */ } /* query_block */ }`, `{ "query_block": { "union_result": { "using_temporary_table": true, "table_name": "", "access_type": "ALL", "query_specifications": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 1, "cost_info": { "query_cost": "3.41" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 7, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.40", "prefix_cost": "3.41", "data_read_per_join": "56" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ }, { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ }, { "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "message": "no matching row in const table" } /* query_block */ } ] /* query_specifications */ } /* union_result */ } /* query_block */ }`, `{ "query_block": { "union_result": { "using_temporary_table": false, "query_specifications": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 1, "cost_info": { "query_cost": "7.21" } /* cost_info */, "nested_loop": [ { "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */ } /* table */ }, { "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 14, "filtered": "100.00", "using_join_buffer": "Block Nested Loop", "cost_info": { "read_cost": "2.01", "eval_cost": "2.80", "prefix_cost": "7.22", "data_read_per_join": "112" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } ] /* nested_loop */ } /* query_block */ }, { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "message": "no matching row in const table" } /* query_block */ } ] /* query_specifications */ } /* union_result */ } /* query_block */ }`, `{ "query_block": { "ordering_operation": { "using_filesort": true, "union_result": { "using_temporary_table": true, "table_name": "", "access_type": "ALL", "query_specifications": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 1, "cost_info": { "query_cost": "3.41" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 7, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.40", "prefix_cost": "3.41", "data_read_per_join": "56" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ }, { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* query_specifications */ } /* union_result */, "order_by_subqueries": [ { "dependent": true, "cacheable": false, "query_block": { "select_id": 3, "message": "No tables used" } /* query_block */ } ] /* order_by_subqueries */ } /* ordering_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "3.41" } /* cost_info */, "ordering_operation": { "using_filesort": false, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 7, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.40", "prefix_cost": "3.41", "data_read_per_join": "56" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */, "optimized_away_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */ } /* table */ } /* query_block */ } ] /* optimized_away_subqueries */ } /* ordering_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "3.41" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 7, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.40", "prefix_cost": "3.41", "data_read_per_join": "56" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */, "having_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ }, { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* having_subqueries */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "10.41" } /* cost_info */, "grouping_operation": { "using_temporary_table": true, "using_filesort": true, "cost_info": { "sort_cost": "7.00" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 7, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.40", "prefix_cost": "3.41", "data_read_per_join": "56" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */, "group_by_subqueries": [ { "dependent": true, "cacheable": false, "query_block": { "select_id": 3, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "attached_condition": "(outer_field_is_not_null, (((test.t1.i) >= test.t2.i) or isnull(test.t2.i)), true)" } /* table */ } /* query_block */ }, { "dependent": true, "cacheable": false, "query_block": { "select_id": 2, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */, "attached_condition": "(outer_field_is_not_null, (((test.t1.i) <= test.t2.i) or isnull(test.t2.i)), true)" } /* table */ } /* query_block */ } ] /* group_by_subqueries */ } /* grouping_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "3.41" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 7, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.40", "prefix_cost": "3.41", "data_read_per_join": "56" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */, "select_list_subqueries": [ { "dependent": false, "cacheable": false, "query_block": { "select_id": 2, "cost_info": { "query_cost": "3.41" } /* cost_info */, "ordering_operation": { "using_temporary_table": true, "using_filesort": true, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 7, "rows_produced_per_join": 7, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.40", "prefix_cost": "3.41", "data_read_per_join": "56" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* ordering_operation */ } /* query_block */ } ] /* select_list_subqueries */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "message": "no matching row in const table" } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "5.21" } /* cost_info */, "nested_loop": [ { "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "32" } /* cost_info */, "used_columns": [ "a", "b" ] /* used_columns */, "attached_condition": "(((/* select#3 */ select test.t3.e from test.t3),(/* select#4 */ select 1 from test.t3 where (test.t1.b and (outer_field_is_not_null, ((((/* select#3 */ select test.t3.e from test.t3)) < test.t3.e) or isnull(test.t3.e)), true)) having (outer_field_is_not_null, (test.t3.e), true))))", "attached_subqueries": [ { "dependent": true, "cacheable": false, "query_block": { "select_id": 4, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t3", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "e" ] /* used_columns */, "attached_condition": "(test.t1.b and (outer_field_is_not_null, ((((/* select#3 */ select test.t3.e from test.t3)) < test.t3.e) or isnull(test.t3.e)), true))" } /* table */ } /* query_block */ }, { "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t3", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "e" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* attached_subqueries */ } /* table */ }, { "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "50.00", "first_match": "t1", "using_join_buffer": "Block Nested Loop", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "5.21", "data_read_per_join": "32" } /* cost_info */, "used_columns": [ "c" ] /* used_columns */, "attached_condition": "(test.t2.c = test.t1.a)" } /* table */ } ] /* nested_loop */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "35.44" } /* cost_info */, "nested_loop": [ { "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 12, "rows_produced_per_join": 12, "filtered": "100.00", "cost_info": { "read_cost": "2.02", "eval_cost": "2.40", "prefix_cost": "4.42", "data_read_per_join": "96" } /* cost_info */, "used_columns": [ "a" ] /* used_columns */, "attached_condition": "((test.t1.a is not null) and (test.t1.a is not null))" } /* table */ }, { "table": { "table_name": "", "access_type": "eq_ref", "key": "", "key_length": "5", "ref": [ "test.t1.a" ] /* ref */, "rows_examined_per_scan": 1, "materialized_from_subquery": { "using_temporary_table": true, "query_block": { "nested_loop": [ { "table": { "table_name": "t4", "access_type": "ALL", "rows_examined_per_scan": 12, "rows_produced_per_join": 3, "filtered": "33.33", "cost_info": { "read_cost": "3.62", "eval_cost": "0.80", "prefix_cost": "4.42", "data_read_per_join": "31" } /* cost_info */, "used_columns": [ "a" ] /* used_columns */, "attached_condition": "(test.t4.a > 0)" } /* table */ }, { "table": { "table_name": "t3", "access_type": "ALL", "rows_examined_per_scan": 12, "rows_produced_per_join": 4, "filtered": "10.00", "using_join_buffer": "Block Nested Loop", "cost_info": { "read_cost": "2.02", "eval_cost": "0.96", "prefix_cost": "16.04", "data_read_per_join": "38" } /* cost_info */, "used_columns": [ "a" ] /* used_columns */, "attached_condition": "(test.t3.a = test.t4.a)" } /* table */ } ] /* nested_loop */ } /* query_block */ } /* materialized_from_subquery */ } /* table */ }, { "table": { "table_name": "", "access_type": "eq_ref", "key": "", "key_length": "5", "ref": [ "test.t1.a" ] /* ref */, "rows_examined_per_scan": 1, "materialized_from_subquery": { "using_temporary_table": true, "query_block": { "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 12, "rows_produced_per_join": 3, "filtered": "33.33", "cost_info": { "read_cost": "3.62", "eval_cost": "0.80", "prefix_cost": "4.42", "data_read_per_join": "31" } /* cost_info */, "used_columns": [ "a" ] /* used_columns */, "attached_condition": "(test.t2.a > 0)" } /* table */ } /* query_block */ } /* materialized_from_subquery */ } /* table */ } ] /* nested_loop */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "1.20" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "1.00", "eval_cost": "0.20", "prefix_cost": "1.20", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i1", "c1" ] /* used_columns */, "attached_condition": "exists(/* select#2 */ select test.t2.c1 from test.t2 join test.t3 where ((test.t2.c1 = test.t3.c1) and (test.t2.c2 = (/* select#3 */ select min(test.t3.c1) from test.t3)) and ((/* select#3 */ select min(test.t3.c1) from test.t3) <> test.t1.c1)))", "attached_subqueries": [ { "dependent": true, "cacheable": false, "query_block": { "select_id": 2, "cost_info": { "query_cost": "2.40" } /* cost_info */, "nested_loop": [ { "table": { "table_name": "t3", "access_type": "ALL", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "1.00", "eval_cost": "0.20", "prefix_cost": "1.20", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "c1" ] /* used_columns */, "attached_condition": "((/* select#3 */ select min(test.t3.c1) from test.t3) <> test.t1.c1)", "attached_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "cost_info": { "query_cost": "1.20" } /* cost_info */, "table": { "table_name": "t3", "access_type": "ALL", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "1.00", "eval_cost": "0.20", "prefix_cost": "1.20", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "c1" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* attached_subqueries */ } /* table */ }, { "table": { "table_name": "t2", "access_type": "ref", "possible_keys": [ "c1" ] /* possible_keys */, "key": "c1", "used_key_parts": [ "c1" ] /* used_key_parts */, "key_length": "3", "ref": [ "test.t3.c1" ] /* ref */, "rows_examined_per_scan": 1, "rows_produced_per_join": 0, "filtered": "50.00", "cost_info": { "read_cost": "1.00", "eval_cost": "0.10", "prefix_cost": "2.40", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "c1", "c2" ] /* used_columns */, "attached_condition": "(test.t2.c2 = (/* select#3 */ select min(test.t3.c1) from test.t3))", "attached_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "cost_info": { "query_cost": "1.20" } /* cost_info */, "table": { "table_name": "t3", "access_type": "ALL", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "1.00", "eval_cost": "0.20", "prefix_cost": "1.20", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "c1" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* attached_subqueries */ } /* table */ } ] /* nested_loop */ } /* query_block */ } ] /* attached_subqueries */ } /* table */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "20.82" } /* cost_info */, "duplicates_removal": { "using_temporary_table": true, "nested_loop": [ { "table": { "table_name": "t5", "access_type": "ALL", "rows_examined_per_scan": 3, "rows_produced_per_join": 3, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "0.60", "prefix_cost": "2.61", "data_read_per_join": "24" } /* cost_info */, "used_columns": [ "c" ] /* used_columns */ } /* table */ }, { "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 3, "rows_produced_per_join": 3, "filtered": "33.33", "using_join_buffer": "Block Nested Loop", "cost_info": { "read_cost": "2.01", "eval_cost": "0.60", "prefix_cost": "6.41", "data_read_per_join": "48" } /* cost_info */, "used_columns": [ "c", "c_key" ] /* used_columns */, "attached_condition": "(test.t2.c = test.t5.c)" } /* table */ }, { "table": { "table_name": "t1", "access_type": "index", "possible_keys": [ "c_key" ] /* possible_keys */, "key": "c_key", "used_key_parts": [ "c_key" ] /* used_key_parts */, "key_length": "5", "rows_examined_per_scan": 3, "rows_produced_per_join": 3, "filtered": "33.33", "using_index": true, "using_join_buffer": "Block Nested Loop", "cost_info": { "read_cost": "2.01", "eval_cost": "0.60", "prefix_cost": "12.22", "data_read_per_join": "24" } /* cost_info */, "used_columns": [ "c_key" ] /* used_columns */, "attached_condition": "(test.t1.c_key = test.t2.c_key)" } /* table */ }, { "table": { "table_name": "t4", "access_type": "ALL", "rows_examined_per_scan": 3, "rows_produced_per_join": 3, "filtered": "33.33", "using_join_buffer": "Block Nested Loop", "cost_info": { "read_cost": "2.01", "eval_cost": "0.60", "prefix_cost": "16.02", "data_read_per_join": "48" } /* cost_info */, "used_columns": [ "c", "c_key" ] /* used_columns */, "attached_condition": "((test.t4.c = test.t5.c) and (test.t4.c_key is not null))" } /* table */ }, { "table": { "table_name": "t3", "access_type": "ref", "possible_keys": [ "c_key" ] /* possible_keys */, "key": "c_key", "used_key_parts": [ "c_key" ] /* used_key_parts */, "key_length": "5", "ref": [ "test.t4.c_key" ] /* ref */, "rows_examined_per_scan": 1, "rows_produced_per_join": 3, "filtered": "100.00", "using_index": true, "cost_info": { "read_cost": "3.00", "eval_cost": "0.60", "prefix_cost": "20.82", "data_read_per_join": "24" } /* cost_info */, "used_columns": [ "c_key" ] /* used_columns */ } /* table */ } ] /* nested_loop */ } /* duplicates_removal */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "table": { "update": true, "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 1, "filtered": "100.00" } /* table */, "update_value_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "1.00" } /* cost_info */, "table": { "table_name": "t2", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* update_value_subqueries */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "1.00" } /* cost_info */, "nested_loop": [ { "table": { "update": true, "table_name": "t1", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ }, { "table": { "table_name": "t2", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */ } /* table */ } ] /* nested_loop */, "update_value_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "1.00" } /* cost_info */, "table": { "table_name": "t3", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* update_value_subqueries */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "1.00" } /* cost_info */, "table": { "insert": true, "table_name": "t1", "access_type": "ALL" } /* table */, "insert_from": { "table": { "table_name": "t2", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* insert_from */, "update_value_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "1.00" } /* cost_info */, "table": { "table_name": "t2", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* update_value_subqueries */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "table": { "insert": true, "table_name": "t1", "access_type": "ALL" } /* table */, "update_value_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "1.00" } /* cost_info */, "table": { "table_name": "t2", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* update_value_subqueries */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "table": { "insert": true, "table_name": "t3", "access_type": "ALL" } /* table */, "optimized_away_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "cost_info": { "query_cost": "1.00" } /* cost_info */, "table": { "table_name": "t2", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ }, { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "1.00" } /* cost_info */, "table": { "table_name": "t1", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */ } /* query_block */ } ] /* optimized_away_subqueries */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "10.50" } /* cost_info */, "ordering_operation": { "using_filesort": true, "grouping_operation": { "using_temporary_table": true, "using_filesort": false, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "10.10", "eval_cost": "0.40", "prefix_cost": "10.50", "data_read_per_join": "48" } /* cost_info */, "used_columns": [ "a", "b" ] /* used_columns */, "materialized_from_subquery": { "using_temporary_table": true, "dependent": false, "cacheable": true, "query_block": { "union_result": { "using_temporary_table": false, "query_specifications": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "message": "No tables used" } /* query_block */ }, { "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "message": "No tables used" } /* query_block */ } ] /* query_specifications */ } /* union_result */ } /* query_block */ } /* materialized_from_subquery */ } /* table */ } /* grouping_operation */ } /* ordering_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "4.40" } /* cost_info */, "grouping_operation": { "using_temporary_table": true, "using_filesort": true, "cost_info": { "sort_cost": "2.00" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "32" } /* cost_info */, "used_columns": [ "a" ] /* used_columns */ } /* table */, "group_by_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 2, "cost_info": { "query_cost": "1.00" } /* cost_info */, "table": { "table_name": "d", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "b" ] /* used_columns */, "materialized_from_subquery": { "using_temporary_table": true, "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "cost_info": { "query_cost": "5.21" } /* cost_info */, "ordering_operation": { "using_temporary_table": true, "using_filesort": true, "nested_loop": [ { "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "32" } /* cost_info */, "used_columns": [ "a", "b" ] /* used_columns */ } /* table */ }, { "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 4, "filtered": "100.00", "using_join_buffer": "Block Nested Loop", "cost_info": { "read_cost": "2.00", "eval_cost": "0.80", "prefix_cost": "5.21", "data_read_per_join": "64" } /* cost_info */ } /* table */ } ] /* nested_loop */ } /* ordering_operation */ } /* query_block */ } /* materialized_from_subquery */ } /* table */ } /* query_block */ } ] /* group_by_subqueries */ } /* grouping_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "2.40" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */ } /* table */, "optimized_away_subqueries": [ { "dependent": false, "cacheable": true, "query_block": { "select_id": 3, "cost_info": { "query_cost": "4.40" } /* cost_info */, "grouping_operation": { "using_temporary_table": true, "using_filesort": true, "cost_info": { "sort_cost": "2.00" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "f1" ] /* used_columns */ } /* table */ } /* grouping_operation */ } /* query_block */ } ] /* optimized_away_subqueries */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "4.02" } /* cost_info */, "ordering_operation": { "using_filesort": true, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 10, "rows_produced_per_join": 10, "filtered": "100.00", "cost_info": { "read_cost": "2.02", "eval_cost": "2.00", "prefix_cost": "4.02", "data_read_per_join": "80" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */, "order_by_subqueries": [ { "dependent": true, "cacheable": false, "query_block": { "select_id": 2, "cost_info": { "query_cost": "4.02" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 10, "rows_produced_per_join": 1, "filtered": "10.00", "cost_info": { "read_cost": "2.02", "eval_cost": "0.20", "prefix_cost": "4.02", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "i", "j" ] /* used_columns */, "attached_condition": "(test.t2.i = test.t1.i)" } /* table */ } /* query_block */ } ] /* order_by_subqueries */ } /* ordering_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "4.02" } /* cost_info */, "grouping_operation": { "using_temporary_table": true, "using_filesort": true, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 10, "rows_produced_per_join": 10, "filtered": "100.00", "cost_info": { "read_cost": "2.02", "eval_cost": "2.00", "prefix_cost": "4.02", "data_read_per_join": "80" } /* cost_info */, "used_columns": [ "i" ] /* used_columns */ } /* table */, "group_by_subqueries": [ { "dependent": true, "cacheable": false, "query_block": { "select_id": 2, "cost_info": { "query_cost": "4.02" } /* cost_info */, "table": { "table_name": "t2", "access_type": "ALL", "rows_examined_per_scan": 10, "rows_produced_per_join": 1, "filtered": "10.00", "cost_info": { "read_cost": "2.02", "eval_cost": "0.20", "prefix_cost": "4.02", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "i", "j" ] /* used_columns */, "attached_condition": "(test.t2.i = test.t1.i)" } /* table */ } /* query_block */ } ] /* group_by_subqueries */ } /* grouping_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "6.50" } /* cost_info */, "ordering_operation": { "using_temporary_table": true, "using_filesort": true, "grouping_operation": { "using_filesort": false, "table": { "table_name": "t1", "access_type": "range", "possible_keys": [ "k1" ] /* possible_keys */, "key": "k1", "used_key_parts": [ "a" ] /* used_key_parts */, "key_length": "4", "rows_examined_per_scan": 11, "rows_produced_per_join": 11, "filtered": "100.00", "using_index_for_group_by": true, "cost_info": { "read_cost": "4.30", "eval_cost": "2.20", "prefix_cost": "6.50", "data_read_per_join": "176" } /* cost_info */, "used_columns": [ "a", "b" ] /* used_columns */ } /* table */ } /* grouping_operation */ } /* ordering_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "6.20" } /* cost_info */, "ordering_operation": { "using_temporary_table": true, "using_filesort": true, "grouping_operation": { "using_filesort": true, "nested_loop": [ { "table": { "table_name": "t1", "access_type": "ALL", "possible_keys": [ "PRIMARY" ] /* possible_keys */, "rows_examined_per_scan": 3, "rows_produced_per_join": 3, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "0.60", "prefix_cost": "2.61", "data_read_per_join": "48" } /* cost_info */, "used_columns": [ "a", "b" ] /* used_columns */ } /* table */ }, { "table": { "table_name": "t2", "access_type": "ref", "possible_keys": [ "PRIMARY" ] /* possible_keys */, "key": "PRIMARY", "used_key_parts": [ "a" ] /* used_key_parts */, "key_length": "4", "ref": [ "test.t1.a" ] /* ref */, "rows_examined_per_scan": 1, "rows_produced_per_join": 3, "filtered": "100.00", "using_index": true, "cost_info": { "read_cost": "3.00", "eval_cost": "0.60", "prefix_cost": "6.21", "data_read_per_join": "48" } /* cost_info */, "used_columns": [ "a", "b" ] /* used_columns */ } /* table */ } ] /* nested_loop */ } /* grouping_operation */ } /* ordering_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "12.82" } /* cost_info */, "grouping_operation": { "using_filesort": true, "cost_info": { "sort_cost": "9.00" } /* cost_info */, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 9, "rows_produced_per_join": 9, "filtered": "100.00", "cost_info": { "read_cost": "2.02", "eval_cost": "1.80", "prefix_cost": "3.82", "data_read_per_join": "144" } /* cost_info */, "used_columns": [ "a", "b" ] /* used_columns */ } /* table */ } /* grouping_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "3.01" } /* cost_info */, "ordering_operation": { "using_filesort": true, "duplicates_removal": { "using_temporary_table": true, "using_filesort": false, "grouping_operation": { "using_temporary_table": true, "using_filesort": false, "table": { "table_name": "t1", "access_type": "ALL", "rows_examined_per_scan": 5, "rows_produced_per_join": 5, "filtered": "100.00", "cost_info": { "read_cost": "2.01", "eval_cost": "1.00", "prefix_cost": "3.01", "data_read_per_join": "80" } /* cost_info */, "used_columns": [ "a", "b" ] /* used_columns */ } /* table */ } /* grouping_operation */ } /* duplicates_removal */ } /* ordering_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "2.40" } /* cost_info */, "ordering_operation": { "using_filesort": false, "duplicates_removal": { "using_temporary_table": true, "using_filesort": false, "buffer_result": { "using_temporary_table": true, "nested_loop": [ { "table": { "table_name": "t1", "access_type": "system", "rows_examined_per_scan": 1, "rows_produced_per_join": 1, "filtered": "100.00", "cost_info": { "read_cost": "0.00", "eval_cost": "0.20", "prefix_cost": "0.00", "data_read_per_join": "8" } /* cost_info */, "used_columns": [ "a" ] /* used_columns */ } /* table */ }, { "table": { "table_name": "t2", "access_type": "index", "key": "PRIMARY", "used_key_parts": [ "a" ] /* used_key_parts */, "key_length": "4", "rows_examined_per_scan": 2, "rows_produced_per_join": 2, "filtered": "100.00", "using_index": true, "distinct": true, "cost_info": { "read_cost": "2.00", "eval_cost": "0.40", "prefix_cost": "2.40", "data_read_per_join": "16" } /* cost_info */, "used_columns": [ "a" ] /* used_columns */ } /* table */ } ] /* nested_loop */ } /* buffer_result */ } /* duplicates_removal */ } /* ordering_operation */ } /* query_block */ }`, `{ "query_block": { "select_id": 1, "cost_info": { "query_cost": "6.41" } /* cost_info */, "nested_loop": [ { "table": { "table_name": "t1", "access_type": "ALL", "possible_keys": [ "PRIMARY" ] /* possible_keys */, "rows_examined_per_scan": 4, "rows_produced_per_join": 3, "filtered": "75.00", "cost_info": { "read_cost": "2.21", "eval_cost": "0.60", "prefix_cost": "2.81", "data_read_per_join": "48" } /* cost_info */, "used_columns": [ "a", "b" ] /* used_columns */, "attached_condition": "(test.t1.b <> 30)" } /* table */ }, { "table": { "table_name": "t2", "access_type": "eq_ref", "possible_keys": [ "PRIMARY" ] /* possible_keys */, "key": "PRIMARY", "used_key_parts": [ "a" ] /* used_key_parts */, "key_length": "4", "ref": [ "test.t1.a" ] /* ref */, "rows_examined_per_scan": 1, "rows_produced_per_join": 3, "filtered": "100.00", "using_index": true, "cost_info": { "read_cost": "3.00", "eval_cost": "0.60", "prefix_cost": "6.41", "data_read_per_join": "24" } /* cost_info */, "used_columns": [ "a" ] /* used_columns */ } /* table */ } ] /* nested_loop */ } /* query_block */ }`, } func TestExplain(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) // TraditionalFormatExplain for idx, sql := range sqls { exp, err := connTest.Explain(sql, TraditionalExplainType, TraditionalFormatExplain) if err != nil { t.Error(err) } pretty.Println("No.:", idx, "\nOld: ", sql, "\nNew: ", exp.SQL) pretty.Println(exp) } // JSONFormatExplain for idx, sql := range sqls { exp, err := connTest.Explain(sql, TraditionalExplainType, JSONFormatExplain) if err != nil { t.Error(err) } pretty.Println("No.:", idx, "\nOld: ", sql, "\nNew: ", exp.SQL) pretty.Println(exp) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestParseExplainText(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) for _, content := range exp { pretty.Println(RemoveSQLComments(content)) pretty.Println(ParseExplainText(content)) } /* //length := len(exp) pretty.Println(string(RemoveSQLComments([]byte(exp[9])))) explainInfo, err := ParseExplainText(exp[9]) pretty.Println(explainInfo) fmt.Println(err) */ common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindTablesInJson(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) idx := 9 for _, j := range exp[idx : idx+1] { pretty.Println(j) findTablesInJSON(j, 0) } pretty.Println(len(explainJSONTables), explainJSONTables) common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFormatJsonIntoTraditional(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) idx := 11 for _, j := range exp[idx : idx+1] { pretty.Println(j) pretty.Println(FormatJSONIntoTraditional(j)) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestPrintMarkdownExplainTable(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) expInfo, err := connTest.Explain("select 1", TraditionalExplainType, TraditionalFormatExplain) if err != nil { t.Error(err) } err = common.GoldenDiff(func() { PrintMarkdownExplainTable(expInfo) }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestExplainInfoTranslator(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) expInfo, err := connTest.Explain("select 1", TraditionalExplainType, TraditionalFormatExplain) if err != nil { t.Error(err) } err = common.GoldenDiff(func() { ExplainInfoTranslator(expInfo) }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestMySQLExplainWarnings(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) expInfo, err := connTest.Explain("select 1", TraditionalExplainType, TraditionalFormatExplain) if err != nil { t.Error(err) } err = common.GoldenDiff(func() { MySQLExplainWarnings(expInfo) }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestMySQLExplainQueryCost(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) err := common.GoldenDiff(func() { expInfo, err := connTest.Explain("select 1", TraditionalExplainType, TraditionalFormatExplain) fmt.Println(err, MySQLExplainQueryCost(expInfo)) expInfo, err = connTest.Explain("select 1", ExtendedExplainType, TraditionalFormatExplain) fmt.Println(err, MySQLExplainQueryCost(expInfo)) expInfo, err = connTest.Explain("select 1", TraditionalExplainType, JSONFormatExplain) fmt.Println(err, MySQLExplainQueryCost(expInfo)) }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestSupportExplainWrite(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) _, err := connTest.supportExplainWrite() if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestExplainAbleSQL(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) for _, sql := range sqls { if _, err := connTest.explainAbleSQL(sql); err != nil { t.Errorf("SQL: %s, not explain able", sql) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: database/mysql.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "bytes" "database/sql" "errors" "fmt" "io" "regexp" "strconv" "strings" "time" "github.com/XiaoMi/soar/common" // for database/sql _ "github.com/go-sql-driver/mysql" "vitess.io/vitess/go/vt/sqlparser" ) // Connector 数据库连接基本对象 type Connector struct { Addr string User string Pass string Database string Charset string Conn *sql.DB } // QueryResult 数据库查询返回值 type QueryResult struct { Rows *sql.Rows Error error Warning *sql.Rows QueryCost float64 } // NewConnector 创建新连接 func NewConnector(dsn *common.Dsn) (*Connector, error) { conn, err := sql.Open("mysql", common.FormatDSN(dsn)) if err != nil { return nil, err } connector := &Connector{ Addr: dsn.Addr, User: dsn.User, Pass: dsn.Password, Database: dsn.Schema, Charset: dsn.Charset, Conn: conn, } return connector, err } // Query 执行SQL func (db *Connector) Query(sql string, params ...interface{}) (QueryResult, error) { var res QueryResult var err error // 测试环境如果检查是关闭的,则SQL不会被执行 if common.Config.TestDSN.Disable { return res, errors.New("dsn is disable") } // 数据库安全性检查:如果 Connector 的 IP 端口与 TEST 环境不一致,则启用SQL白名单 // 不在白名单中的SQL不允许执行 // 执行环境与test环境不相同 if db.Addr != common.Config.TestDSN.Addr && db.dangerousQuery(sql) { return res, fmt.Errorf("query execution deny: execute SQL with DSN(%s/%s) '%s'", db.Addr, db.Database, fmt.Sprintf(sql, params...)) } if db.Database == "" { db.Database = "information_schema" } common.Log.Debug("Execute SQL with DSN(%s/%s) : %s", db.Addr, db.Database, fmt.Sprintf(sql, params...)) _, err = db.Conn.Exec("USE `" + db.Database + "`") if err != nil { common.Log.Error(err.Error()) return res, err } res.Rows, res.Error = db.Conn.Query(sql, params...) if common.Config.ShowWarnings { res.Warning, err = db.Conn.Query("SHOW WARNINGS") common.LogIfError(err, "") } // SHOW WARNINGS 并不会影响 last_query_cost if common.Config.ShowLastQueryCost { cost, err := db.Conn.Query("SHOW SESSION STATUS LIKE 'last_query_cost'") if err == nil { var varName string if cost.Next() { err = cost.Scan(&varName, &res.QueryCost) common.LogIfError(err, "") } if err := cost.Close(); err != nil { common.Log.Error(err.Error()) } } } if res.Error != nil && err == nil { err = res.Error } return res, err } // Version 获取MySQL数据库版本 func (db *Connector) Version() (int, error) { version := 99999 // 从数据库中获取版本信息 res, err := db.Query("select @@version") if err != nil { common.Log.Warn("(db *Connector) Version() Error: %v", err) return version, err } // MariaDB https://mariadb.com/kb/en/library/comment-syntax/ // MySQL https://dev.mysql.com/doc/refman/8.0/en/comments.html var versionStr string var versionSeg []string if res.Rows.Next() { err = res.Rows.Scan(&versionStr) } if err := res.Rows.Close(); err != nil { common.Log.Error(err.Error()) } versionStr = strings.Split(versionStr, "-")[0] versionSeg = strings.Split(versionStr, ".") if len(versionSeg) == 3 { versionStr = fmt.Sprintf("%s%02s%02s", versionSeg[0], versionSeg[1], versionSeg[2]) version, err = strconv.Atoi(versionStr) } return version, err } // SingleIntValue 获取某个int型变量的值 func (db *Connector) SingleIntValue(option string) (int, error) { // 从数据库中获取信息 res, err := db.Query("select @@" + option) if err != nil { common.Log.Warn("(db *Connector) SingleIntValue() Error: %v", err) return -1, err } var intVal int if res.Rows.Next() { err = res.Rows.Scan(&intVal) } if err := res.Rows.Close(); err != nil { common.Log.Error(err.Error()) } return intVal, err } // ColumnCardinality 粒度计算 func (db *Connector) ColumnCardinality(tb, col string) float64 { // 获取该表上的已有的索引 // show table status 获取总行数(近似) common.Log.Debug("ColumnCardinality, ShowTableStatus check `%s` status Rows", tb) tbStatus, err := db.ShowTableStatus(tb) if err != nil { common.Log.Warn("(db *Connector) ColumnCardinality() ShowTableStatus Error: %v", err) return 0 } // 如果是视图或表中无数据,rowTotal 都为 0 // 视图不需要加索引,无数据相当于散粒度为 1 if len(tbStatus.Rows) == 0 { common.Log.Debug("(db *Connector) ColumnCardinality() No table status: %s", tb) return 1 } if tbStatus.Rows[0].Rows == nil { common.Log.Debug("(db *Connector) ColumnCardinality() No table status: %s", tb) return 1 } rowTotal, err := strconv.ParseUint(string(tbStatus.Rows[0].Rows), 10, 64) if rowTotal == 0 || err != nil { if common.Config.Sampling { common.Log.Debug("ColumnCardinality, %s rowTotal == 0", tb) } if err != nil { common.Log.Error("ColumnCardinality, ParseUint: " + string(tbStatus.Rows[0].Rows) + " Error: " + err.Error()) } return 1 } // rowTotal > xxx 时保护数据库,不对该值计算散粒度,xxx可以在配置中设置 if rowTotal > common.Config.MaxTotalRows { return 0.5 } // 计算该列散粒度 db.Conn.Stats() res, err := db.Query(fmt.Sprintf("select count(distinct `%s`) from `%s`.`%s`", Escape(col, false), Escape(db.Database, false), Escape(tb, false))) if err != nil { common.Log.Warn("(db *Connector) ColumnCardinality() Query Error: %v", err) return 0 } var colNum float64 if res.Rows.Next() { err = res.Rows.Scan(&colNum) if err != nil { common.Log.Warn("(db *Connector) ColumnCardinality() Query Error: %v", err) return 0 } } res.Rows.Close() // 当table status元数据不准确时 rowTotal 可能远小于count(*),导致散粒度大于1 if colNum > float64(rowTotal) { return 1 } // 散粒度区间:[0,1] return colNum / float64(rowTotal) } // IsView 判断表是否是视图 func (db *Connector) IsView(tbName string) bool { common.Log.Debug("IsView, ShowTableStatus check if `%s` is view", tbName) tbStatus, err := db.ShowTableStatus(tbName) if err != nil { common.Log.Error("(db *Connector) IsView Error: %v:", err) return false } if len(tbStatus.Rows) > 0 { /* // mysql 8.0.23 mysql> show table status like "actor_info"\G *************************** 1. row *************************** Name: actor_info Engine: NULL Version: NULL Row_format: NULL Rows: NULL Avg_row_length: NULL Data_length: NULL Max_data_length: NULL Index_length: NULL Data_free: NULL Auto_increment: NULL Create_time: 2021-06-01 10:56:47 Update_time: NULL Check_time: NULL Collation: NULL Checksum: NULL Create_options: NULL Comment: VIEW mysql> show table status like "film"\G *************************** 1. row *************************** Name: film Engine: InnoDB Version: 10 Row_format: Dynamic Rows: 1000 Avg_row_length: 196 Data_length: 196608 Max_data_length: 0 Index_length: 81920 Data_free: 0 Auto_increment: 1001 Create_time: 2021-06-01 10:56:47 Update_time: NULL Check_time: NULL Collation: utf8_general_ci Checksum: NULL Create_options: Comment: */ if string(tbStatus.Rows[0].Comment) == "VIEW" { return true } if string(tbStatus.Rows[0].Comment) == "TABLE" { return false } } return false } // RemoveSQLComments 去除SQL中的注释 func RemoveSQLComments(sql string) string { buf := []byte(sql) // ("(""|[^"]|(\"))*") 双引号中的内容, "", "\"" // ('(''|[^']|(\'))*') 单引号中的内容, '', '\'' // (--[^\n\r]*) 双减号注释 // (#.*) 井号注释 // (/\*([^*]|[\r\n]|(\*+([^*/]|[\r\n])))*\*+/) 多行注释 commentRegex := regexp.MustCompile(`("(""|[^"]|(\"))*")|('(''|[^']|(\'))*')|(--[^\n\r]*)|(#.*)|(/\*([^*]|[\r\n]|(\*+([^*/]|[\r\n])))*\*+/)`) res := commentRegex.ReplaceAllFunc(buf, func(s []byte) []byte { if (s[0] == '"' && s[len(s)-1] == '"') || (s[0] == '\'' && s[len(s)-1] == '\'') || (string(s[:3]) == "/*!") { return s } return []byte("") }) return strings.TrimSpace(string(res)) } // 为了防止在 Online 环境进行误操作,通过 dangerousQuery 来判断能否在 Online 执行 func (db *Connector) dangerousQuery(query string) bool { queries, err := sqlparser.SplitStatementToPieces(strings.TrimSpace(strings.ToLower(query))) if err != nil { return true } for _, query := range queries { dangerous := true whiteList := []string{ "select", "show", "explain", "describe", "desc", } for _, prefix := range whiteList { if strings.HasPrefix(query, prefix) { dangerous = false break } } if dangerous { return true } } return false } // TimeFormat standard MySQL datetime format const TimeFormat = "2006-01-02 15:04:05.000000000" // TimeString returns t as string in MySQL format Converts time.Time zero to MySQL zero. func TimeString(t time.Time) string { if t.IsZero() { return "0000-00-00 00:00:00" } if t.Nanosecond() == 0 { return t.Format(TimeFormat[:19]) } return t.Format(TimeFormat) } // NullString null able string func NullString(buf []byte) string { if buf == nil { return "NULL" } return string(buf) } // NullFloat null able float func NullFloat(buf []byte) float64 { if buf == nil { return 0 } f, _ := strconv.ParseFloat(string(buf), 64) return f } // NullInt null able int func NullInt(buf []byte) int64 { if buf == nil { return 0 } i, _ := strconv.ParseInt(string(buf), 10, 64) return i } // quoteEscape sql_mode=no_backslash_escapes func quoteEscape(source string) string { var buf bytes.Buffer last := 0 for ii, bb := range source { if bb == '\'' { _, err := io.WriteString(&buf, source[last:ii]) common.LogIfWarn(err, "") _, err = io.WriteString(&buf, `''`) common.LogIfWarn(err, "") last = ii + 1 } } _, err := io.WriteString(&buf, source[last:]) common.LogIfWarn(err, "") return buf.String() } // stringEscape mysql_escape_string // https://github.com/liule/golang_escape func stringEscape(source string) string { var j int if source == "" { return source } tempStr := source[:] desc := make([]byte, len(tempStr)*2) for i, b := range tempStr { flag := false var escape byte switch b { case '\000': flag = true escape = '\000' case '\r': flag = true escape = '\r' case '\n': flag = true escape = '\n' case '\\': flag = true escape = '\\' case '\'': flag = true escape = '\'' case '"': flag = true escape = '"' case '\032': flag = true escape = 'Z' default: } if flag { desc[j] = '\\' desc[j+1] = escape j = j + 2 } else { desc[j] = tempStr[i] j = j + 1 } } return string(desc[0:j]) } // Escape like C API mysql_escape_string() func Escape(source string, NoBackslashEscapes bool) string { // NoBackslashEscapes https://dev.mysql.com/doc/refman/8.0/en/sql-mode.html#sqlmode_no_backslash_escapes // TODO: NoBackslashEscapes always false if NoBackslashEscapes { return quoteEscape(source) } return stringEscape(source) } ================================================ FILE: database/mysql_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "flag" "fmt" "os" "path/filepath" "runtime" "testing" "github.com/XiaoMi/soar/common" "github.com/kr/pretty" ) var connTest *Connector var update = flag.Bool("update", false, "update .golden files") func TestMain(m *testing.M) { // 初始化 init if common.DevPath == "" { _, file, _, _ := runtime.Caller(0) common.DevPath, _ = filepath.Abs(filepath.Dir(filepath.Join(file, ".."+string(filepath.Separator)))) } common.BaseDir = common.DevPath err := common.ParseConfig("") common.LogIfError(err, "init ParseConfig") common.Log.Debug("mysql_test init") connTest, err = NewConnector(common.Config.TestDSN) if err != nil { common.Log.Critical("Test env Error: %v", err) os.Exit(0) } if _, err := connTest.Version(); err != nil { common.Log.Critical("Test env Error: %v", err) os.Exit(0) } // 分割线 flag.Parse() m.Run() // 环境清理 // } func TestQuery(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) res, err := connTest.Query("select 0") if err != nil { t.Error(err.Error()) } for res.Rows.Next() { var val int err = res.Rows.Scan(&val) if err != nil { t.Error(err.Error()) } if val != 0 { t.Error("should return 0") } } res.Rows.Close() // TODO: timeout test common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestColumnCardinality(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgDatabase := connTest.Database connTest.Database = "sakila" a := connTest.ColumnCardinality("actor", "first_name") if a > 1 || a <= 0 { t.Error("sakila.actor.first_name cardinality should in [0, 1], now it's", a) } connTest.Database = orgDatabase common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestDangerousSQL(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) testCase := map[string]bool{ "select * from tb;delete from tb;": true, "show database;": false, "select * from t;": false, "explain delete from t;": false, } db := Connector{} for sql, want := range testCase { got := db.dangerousQuery(sql) if got != want { t.Errorf("SQL:%s got:%v want:%v", sql, got, want) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestWarningsAndQueryCost(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) common.Config.ShowWarnings = true common.Config.ShowLastQueryCost = true res, err := connTest.Query("explain select * from sakila.film") if err != nil { t.Error("Query Error: ", err) } else { for res.Warning.Next() { var level, msg string var code int err = res.Warning.Scan(&level, &code, &msg) if err != nil { t.Error(err.Error()) } pretty.Println(msg) } res.Warning.Close() fmt.Println(res.QueryCost, err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestVersion(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) version, err := connTest.Version() if err != nil { t.Error(err.Error()) } fmt.Println(version) common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestRemoveSQLComments(t *testing.T) { // Notice: double dash without space not comment, eg. `--not comment` common.Log.Debug("Entering function: %s", common.GetFunctionName()) SQLs := []string{ // FIXME: comments in two quotes string won't be remove // `"abc" /* comment */ "abc"`, // `"abc" // # comment // "abc"`, // `"abc" // -- comment // "abc"`, `select 'c#\'#not comment'`, `select "c#\"#not comment"`, `-- comment`, `--`, `# comment`, `#comment`, `/* multi-line comment*/`, `-- -- comment`, } // fmt.Println(RemoveSQLComments(SQLs[0])) // return err := common.GoldenDiff(func() { for _, sql := range SQLs { fmt.Println(RemoveSQLComments(sql)) } }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestSingleIntValue(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) val, err := connTest.SingleIntValue("read_only") if err != nil { t.Error(err) } if val < 0 { t.Error("SingleIntValue, return should large than zero") } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestIsView(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) originalDatabase := connTest.Database connTest.Database = "sakila" if !connTest.IsView("actor_info") { t.Error("actor_info should be a VIEW") } if connTest.IsView("film") { t.Error("film should be a TABLE") } connTest.Database = originalDatabase common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestNullString(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) cases := [][]byte{ nil, []byte("NULL"), } for _, buf := range cases { if NullString(buf) != "NULL" { t.Errorf("%s want NULL", string(buf)) } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestEscape(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) cases := []string{ "", "hello world", "hello' world", `hello" world`, "hello\000world", `hello\ world`, "hello\032world", "hello\rworld", "hello\nworld", } err := common.GoldenDiff(func() { for _, str := range cases { fmt.Println(Escape(str, false)) fmt.Println(Escape(str, true)) } }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: database/privilege.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "errors" "fmt" "strings" "github.com/XiaoMi/soar/common" ) // CurrentUser get current user with current_user() function func (db *Connector) CurrentUser() (string, string, error) { var user, host string res, err := db.Query("select current_user()") if err != nil { return user, host, err } if res.Rows.Next() { var currentUser string err = res.Rows.Scan(¤tUser) if err != nil { return user, host, err } res.Rows.Close() cols := strings.Split(currentUser, "@") if len(cols) == 2 { user = strings.Trim(cols[0], "'") host = strings.Trim(cols[1], "'") if strings.Contains(user, "'") || strings.Contains(host, "'") { return "", "", errors.New("user or host contains irregular character") } return user, host, nil } return user, host, errors.New("user or host contains irregular character") } return user, host, errors.New("no privilege info") } // HasSelectPrivilege if user has select privilege func (db *Connector) HasSelectPrivilege() bool { user, host, err := db.CurrentUser() if err != nil { common.Log.Error("User: %s, HasSelectPrivilege: %s", db.User, err.Error()) return false } res, err := db.Query(fmt.Sprintf("select Select_priv from mysql.user where user='%s' and host='%s'", user, host)) if err != nil { common.Log.Error("HasSelectPrivilege, DSN: %s, Error: %s", db.Addr, err.Error()) return false } // Select_priv if res.Rows.Next() { var selectPrivilege string err = res.Rows.Scan(&selectPrivilege) if err != nil { common.Log.Error("HasSelectPrivilege, Scan Error: %s", err.Error()) return false } res.Rows.Close() if selectPrivilege == "Y" { return true } } return false } // HasAllPrivilege if user has all privileges func (db *Connector) HasAllPrivilege() bool { user, host, err := db.CurrentUser() if err != nil { common.Log.Error("User: %s, HasAllPrivilege: %s", db.User, err.Error()) return false } // concat privilege columns res, err := db.Query("SELECT GROUP_CONCAT(COLUMN_NAME) from information_schema.COLUMNS where TABLE_SCHEMA='mysql' and TABLE_NAME='user' and COLUMN_NAME like '%%_priv'") if err != nil { common.Log.Error("HasAllPrivilege, DSN: %s, Error: %s", db.Addr, err.Error()) return false } var priv string if res.Rows.Next() { err = res.Rows.Scan(&priv) if err != nil { common.Log.Error("HasAllPrivilege, DSN: %s, Scan error", db.Addr) return false } res.Rows.Close() } // get all privilege status res, err = db.Query(fmt.Sprintf("select concat("+priv+") from mysql.user where user='%s' and host='%s'", user, host)) if err != nil { common.Log.Error("HasAllPrivilege, DSN: %s, Error: %s", db.Addr, err.Error()) return false } // %_priv if res.Rows.Next() { err = res.Rows.Scan(&priv) if err != nil { common.Log.Error("HasAllPrivilege, DSN: %s, Scan error", db.Addr) return false } res.Rows.Close() if strings.Replace(priv, "Y", "", -1) == "" { return true } } return false } ================================================ FILE: database/privilege_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "testing" "github.com/XiaoMi/soar/common" ) func TestCurrentUser(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) user, host, err := connTest.CurrentUser() if err != nil { t.Error(err.Error()) } if user != "root" || host != "%" { t.Errorf("Want user: root, host: %%. Get user: %s, host: %s", user, host) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestHasSelectPrivilege(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) if !connTest.HasSelectPrivilege() { t.Errorf("DSN: %s, User: %s, should has select privilege", connTest.Addr, connTest.User) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestHasAllPrivilege(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) if !connTest.HasAllPrivilege() { t.Errorf("DSN: %s, User: %s, should has all privilege", connTest.Addr, connTest.User) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: database/profiling.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "errors" "fmt" "strings" "github.com/XiaoMi/soar/common" "vitess.io/vitess/go/vt/sqlparser" ) // Profiling show profile 输出的结果 type Profiling struct { Rows []ProfilingRow } // ProfilingRow show profile每一行信息 type ProfilingRow struct { Status string Duration float64 // TODO: 支持show profile all, 不过目前看所有的信息过多有点眼花缭乱 } // Profiling 执行SQL,并对其 Profile func (db *Connector) Profiling(sql string, params ...interface{}) ([]ProfilingRow, error) { var rows []ProfilingRow // 过滤不需要 profiling 的 SQL switch sqlparser.Preview(sql) { case sqlparser.StmtSelect, sqlparser.StmtUpdate, sqlparser.StmtDelete: default: return rows, errors.New("no need profiling") } // 测试环境如果检查是关闭的,则 SQL 不会被执行 if common.Config.TestDSN.Disable { return rows, errors.New("dsn is disable") } // 数据库安全性检查:如果 Connector 的 IP 端口与 TEST 环境不一致,则启用 SQL 白名单 // 不在白名单中的 SQL 不允许执行 // 执行环境与 test 环境不相同 if db.Addr != common.Config.TestDSN.Addr && db.dangerousQuery(sql) { return rows, fmt.Errorf("query execution deny: Execute SQL with DSN(%s/%s) '%s'", db.Addr, db.Database, fmt.Sprintf(sql, params...)) } common.Log.Debug("Execute SQL with DSN(%s/%s) : %s", db.Addr, db.Database, sql) // Keep connection // https://github.com/go-sql-driver/mysql/issues/208 trx, err := db.Conn.Begin() if err != nil { return rows, err } defer func() { trxErr := trx.Rollback() if trxErr != nil { common.Log.Debug(trxErr.Error()) } }() // 开启 Profiling _, err = trx.Query("set @@profiling=1") common.LogIfError(err, "") // 执行 SQL,抛弃返回结果 tmpRes, err := trx.Query(sql, params...) if err != nil { return rows, err } for tmpRes.Next() { continue } // 返回 Profiling 结果 res, err := trx.Query("show profile") if err != nil { trxErr := trx.Rollback() if trxErr != nil { common.Log.Debug(trxErr.Error()) } return rows, err } var profileRow ProfilingRow for res.Next() { err = res.Scan(&profileRow.Status, &profileRow.Duration) if err != nil { common.LogIfError(err, "") break } rows = append(rows, profileRow) } res.Close() // 关闭 Profiling _, err = trx.Query("set @@profiling=0") common.LogIfError(err, "") return rows, err } // FormatProfiling 格式化输出 Profiling 信息 func FormatProfiling(rows []ProfilingRow) string { str := []string{"| Status | Duration |"} str = append(str, "| --- | --- |") for _, row := range rows { str = append(str, fmt.Sprintf("| %s | %f |", row.Status, row.Duration)) } return strings.Join(str, "\n") } ================================================ FILE: database/profiling_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "testing" "github.com/XiaoMi/soar/common" "github.com/kr/pretty" ) func TestProfiling(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) rows, err := connTest.Profiling("select 1") if err != nil { t.Error(err) } pretty.Println(rows) _, err = connTest.Profiling("delete from film") if err == nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFormatProfiling(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) res, err := connTest.Profiling("select 1") if err != nil { t.Error(err) } pretty.Println(FormatProfiling(res)) common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: database/sampling.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "database/sql" "fmt" "strconv" "strings" "time" "github.com/XiaoMi/soar/common" ) /*-------------------- * The following choice of minrows is based on the paper * "Random sampling for histogram construction: how much is enough?" * by Surajit Chaudhuri, Rajeev Motwani and Vivek Narasayya, in * Proceedings of ACM SIGMOD International Conference on Management * of Data, 1998, Pages 436-447. Their Corollary 1 to Theorem 5 * says that for table size n, histogram size k, maximum relative * error in bin size f, and error probability gamma, the minimum * random sample size is * r = 4 * k * ln(2*n/gamma) / f^2 * Taking f = 0.5, gamma = 0.01, n = 10^6 rows, we obtain * r = 305.82 * k * Note that because of the log function, the dependence on n is * quite weak; even at n = 10^12, a 300*k sample gives <= 0.66 * bin size error with probability 0.99. So there's no real need to * scale for n, which is a good thing because we don't necessarily * know it at this point. *-------------------- */ // SamplingData 将数据从 onlineConn 拉取到 db 中 func (db *Connector) SamplingData(onlineConn *Connector, tables ...string) error { var err error if onlineConn.Database == db.Database { return fmt.Errorf("SamplingData the same database, From: %s/%s, To: %s/%s", onlineConn.Addr, onlineConn.Database, db.Addr, db.Database) } // 计算需要泵取的数据量 wantRowsCount := 300 * common.Config.SamplingStatisticTarget for _, table := range tables { // 表类型检查 if onlineConn.IsView(table) { return nil } // generate where condition var where string if common.Config.SamplingCondition == "" { tableStatus, err := onlineConn.ShowTableStatus(table) if err != nil { return err } if len(tableStatus.Rows) == 0 { common.Log.Info("SamplingData, Table %s with no data, stop sampling", table) return nil } tableRows, err := strconv.ParseUint(string(tableStatus.Rows[0].Rows), 10, 64) if tableRows == 0 || err != nil { common.Log.Info("SamplingData, Table %s with no data, stop sampling", table) if err != nil { common.Log.Error("SamplingData, Error: ", err.Error()) } return nil } factor := float64(wantRowsCount) / float64(tableRows) common.Log.Debug("SamplingData, tableRows: %d, wantRowsCount: %d, factor: %f", tableRows, wantRowsCount, factor) where = fmt.Sprintf("where RAND() <= %f LIMIT %d", factor, wantRowsCount) if factor >= 1 { where = "" } } else { where = common.Config.SamplingCondition } err = db.startSampling(onlineConn.Conn, onlineConn.Database, table, where) } return err } // startSampling sampling data from OnlineDSN to TestDSN func (db *Connector) startSampling(onlineConn *sql.DB, database, table string, where string) error { samplingQuery := fmt.Sprintf("select * from `%s`.`%s` %s", Escape(database, false), Escape(table, false), Escape(where, false)) common.Log.Debug("startSampling with Query: %s", samplingQuery) res, err := onlineConn.Query(samplingQuery) if err != nil { return err } // columns list columns, err := res.Columns() if err != nil { return err } row := make([][]byte, len(columns)) tableFields := make([]interface{}, 0) for i := range columns { tableFields = append(tableFields, &row[i]) } columnTypes, err := res.ColumnTypes() if err != nil { return err } // sampling data var valuesCount int var valuesStr []string maxValuesCount := 200 // one time insert values count, TODO: config able columnsStr := "`" + strings.Join(columns, "`,`") + "`" for res.Next() { var values []string err = res.Scan(tableFields...) if err != nil { common.Log.Debug(err.Error()) } for i, val := range row { if val == nil { values = append(values, "NULL") } else { switch columnTypes[i].DatabaseTypeName() { case "JSON": // https://github.com/XiaoMi/soar/issues/178 values = append(values, fmt.Sprintf(`convert(X'%s' using utf8mb4)`, fmt.Sprintf("%x", val))) case "TIMESTAMP", "DATETIME": t, err := time.Parse(time.RFC3339, string(val)) if err != nil { values = append(values, fmt.Sprintf(`"%s"`, string(val))) } else { values = append(values, fmt.Sprintf(`"%s"`, TimeString(t))) } default: values = append(values, fmt.Sprintf(`unhex("%s")`, fmt.Sprintf("%x", val))) } } } valuesStr = append(valuesStr, "("+strings.Join(values, `,`)+")") valuesCount++ if maxValuesCount <= valuesCount { err = db.doSampling(table, columnsStr, strings.Join(valuesStr, `,`)) if err != nil { break } valuesStr = make([]string, 0) valuesCount = 0 } } if len(valuesStr) > 0 { err = db.doSampling(table, columnsStr, strings.Join(valuesStr, `,`)) if err != nil { common.LogIfWarn(err, "") } } res.Close() return err } // 将泵取的数据转换成 insert 语句并在 testConn 数据库中执行 func (db *Connector) doSampling(table, colDef, values string) error { // db.Database is hashed database name query := fmt.Sprintf("insert into `%s`.`%s` (%s) values %s;", Escape(db.Database, false), Escape(table, false), Escape(colDef, false), values) res, err := db.Query(query) if res.Rows != nil { res.Rows.Close() } return err } ================================================ FILE: database/show.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "fmt" "regexp" "strconv" "strings" "github.com/XiaoMi/soar/common" ) // SHOW TABLE STATUS Syntax // https://dev.mysql.com/doc/refman/5.7/en/show-table-status.html // TableStatInfo 用以保存 show table status 之后获取的table信息 type TableStatInfo struct { Name string Rows []tableStatusRow } // tableStatusRow 用于 show table status value // use []byte instead of string, because []byte allow to be null, string not type tableStatusRow struct { Name string // 表名 Engine []byte // 该表使用的存储引擎 Version []byte // 该表的 .frm 文件版本号 RowFormat []byte // 该表使用的行存储格式 Rows []byte // 表行数, InnoDB 引擎中为预估值,甚至可能会有40%~50%的数值偏差 AvgRowLength []byte // 平均行长度 // MyISAM: Data_length 为数据文件的大小,单位为 bytes // InnoDB: Data_length 为聚簇索引分配的近似内存量,单位为 bytes, 计算方式为聚簇索引数量乘以 InnoDB 页面大小 // 其他不同的存储引擎中该值的意义可能不尽相同 DataLength []byte // MyISAM: Max_data_length 为数据文件长度的最大值。这是在给定使用的数据指针大小的情况下,可以存储在表中的数据的最大字节数 // InnoDB: 未使用 // 其他不同的存储引擎中该值的意义可能不尽相同 MaxDataLength []byte // MyISAM: Index_length 为 index 文件的大小,单位为 bytes // InnoDB: Index_length 为非聚簇索引分配的近似内存量,单位为 bytes,计算方式为非聚簇索引数量乘以 InnoDB 页面大小 // 其他不同的存储引擎中该值的意义可能不尽相同 IndexLength []byte DataFree []byte // 已分配但未使用的字节数 AutoIncrement []byte // 下一个自增值 CreateTime []byte // 创建时间 UpdateTime []byte // 最近一次更新时间,该值不准确 CheckTime []byte // 上次检查时间 Collation []byte // 字符集及排序规则信息 Checksum []byte // 校验和 CreateOptions []byte // 创建表的时候的时候一切其他属性 Comment []byte // 注释 } // 记录去除逗号类型是外健还是分区表 type deleteComaType int8 const ( _ deleteComaType = iota CS PART ) // newTableStat 构造 table Stat 对象 func newTableStat(tableName string) *TableStatInfo { return &TableStatInfo{ Name: tableName, Rows: make([]tableStatusRow, 0), } } // ShowTables 执行 show tables func (db *Connector) ShowTables() ([]string, error) { defer func() { err := recover() if err != nil { common.Log.Error("recover ShowTables()", err) } }() // 执行 show table status res, err := db.Query("show tables") if err != nil { return []string{}, err } // 获取值 var tables []string for res.Rows.Next() { var table string err = res.Rows.Scan(&table) if err != nil { break } tables = append(tables, table) } res.Rows.Close() return tables, err } // ShowTableStatus 执行 show table status func (db *Connector) ShowTableStatus(tableName string) (*TableStatInfo, error) { // 初始化struct tbStatus := newTableStat(tableName) // 执行 show table status res, err := db.Query(fmt.Sprintf("show table status where name = '%s'", Escape(tbStatus.Name, false))) if err != nil { return tbStatus, err } // columns info ts := tableStatusRow{} statusFields := make([]interface{}, 0) fields := map[string]interface{}{ "Name": &ts.Name, "Engine": &ts.Engine, "Version": &ts.Version, "Row_format": &ts.RowFormat, "Rows": &ts.Rows, "Avg_row_length": &ts.AvgRowLength, "Data_length": &ts.DataLength, "Max_data_length": &ts.MaxDataLength, "Index_length": &ts.IndexLength, "Data_free": &ts.DataFree, "Auto_increment": &ts.AutoIncrement, "Create_time": &ts.CreateTime, "Update_time": &ts.UpdateTime, "Check_time": &ts.CheckTime, "Collation": &ts.Collation, "Checksum": &ts.Checksum, "Create_options": &ts.CreateOptions, "Comment": &ts.Comment, } cols, err := res.Rows.Columns() common.LogIfError(err, "") var colByPass []byte for _, col := range cols { if _, ok := fields[col]; ok { statusFields = append(statusFields, fields[col]) } else { common.Log.Debug("ShowTableStatus by pass column %s", col) statusFields = append(statusFields, &colByPass) } } // 获取值 for res.Rows.Next() { err := res.Rows.Scan(statusFields...) if err != nil { // MariaDB 中视图的 STATUS 信息大部分表都为 NULL,此时会打印如下 DEBUG 级别日志信息,看到后忽略即可。 // sql: Scan error on column index 4: converting driver.Value type ("") to uint64: invalid syntax common.Log.Debug(err.Error()) } tbStatus.Rows = append(tbStatus.Rows, ts) } res.Rows.Close() return tbStatus, err } // https://dev.mysql.com/doc/refman/5.7/en/show-index.html // TableIndexInfo 用以保存 show index 之后获取的 index 信息 type TableIndexInfo struct { TableName string Rows []TableIndexRow } // TableIndexRow 用以存放show index 之后获取的每一条 index 信息 type TableIndexRow struct { Table string // 表名 NonUnique int // 0:unique key,1:not unique KeyName string // index的名称,如果是主键则为 "PRIMARY" SeqInIndex int // 该列在索引中的位置。计数从 1 开始 ColumnName string // 列名 Collation string // A or Null Cardinality int // 索引中唯一值的数量,"ANALYZE TABLE" 可更新该值 SubPart int // 索引前缀字节数 Packed int Null string // 表示该列是否可以为空,如果可以为 'YES',反之'' IndexType string // BTREE, FULLTEXT, HASH, RTREE Comment string IndexComment string Visible string Expression []byte } // NewTableIndexInfo 构造 TableIndexInfo func NewTableIndexInfo(tableName string) *TableIndexInfo { return &TableIndexInfo{ TableName: tableName, Rows: make([]TableIndexRow, 0), } } // ShowIndex show Index func (db *Connector) ShowIndex(tableName string) (*TableIndexInfo, error) { tbIndex := NewTableIndexInfo(tableName) if db.Database == "" || tableName == "" { return nil, fmt.Errorf("database('%s') or table('%s') name should not empty", db.Database, tableName) } // 执行 show create table res, err := db.Query(fmt.Sprintf("show index from `%s`.`%s`", Escape(db.Database, false), Escape(tableName, false))) if err != nil { return nil, err } // columns info ti := TableIndexRow{} indexFields := make([]interface{}, 0) fields := map[string]interface{}{ "Table": &ti.Table, "Non_unique": &ti.NonUnique, "Key_name": &ti.KeyName, "Seq_in_index": &ti.SeqInIndex, "Column_name": &ti.ColumnName, "Collation": &ti.Collation, "Cardinality": &ti.Cardinality, "Sub_part": &ti.SubPart, "Packed": &ti.Packed, "Null": &ti.Null, "Index_type": &ti.IndexType, "Comment": &ti.Comment, "Index_comment": &ti.IndexComment, "Visible": &ti.Visible, "Expression": &ti.Expression, } cols, err := res.Rows.Columns() common.LogIfError(err, "") var colByPass []byte for _, col := range cols { if _, ok := fields[col]; ok { indexFields = append(indexFields, fields[col]) } else { common.Log.Debug("ShowIndex by pass column %s", col) indexFields = append(indexFields, &colByPass) } } // 获取值 for res.Rows.Next() { err := res.Rows.Scan(indexFields...) if err != nil { common.Log.Debug(err.Error()) } tbIndex.Rows = append(tbIndex.Rows, ti) } res.Rows.Close() return tbIndex, err } // IndexSelectKey 用以对 TableIndexInfo 进行查询 type IndexSelectKey string // 索引相关 const ( IndexKeyName = IndexSelectKey("KeyName") // 索引名称 IndexColumnName = IndexSelectKey("ColumnName") // 索引列名称 IndexIndexType = IndexSelectKey("IndexType") // 索引类型 IndexNonUnique = IndexSelectKey("NonUnique") // 唯一索引 ) // FindIndex 获取 TableIndexInfo 中需要的索引 func (tbIndex *TableIndexInfo) FindIndex(arg IndexSelectKey, value string) []TableIndexRow { var result []TableIndexRow if tbIndex == nil { return result } value = strings.ToLower(value) switch arg { case IndexKeyName: for _, index := range tbIndex.Rows { if strings.ToLower(index.KeyName) == value { result = append(result, index) } } case IndexColumnName: for _, index := range tbIndex.Rows { if strings.ToLower(index.ColumnName) == value { result = append(result, index) } } case IndexIndexType: for _, index := range tbIndex.Rows { if strings.ToLower(index.IndexType) == value { result = append(result, index) } } case IndexNonUnique: for _, index := range tbIndex.Rows { unique := strconv.Itoa(index.NonUnique) if unique == value { result = append(result, index) } } default: common.Log.Error("no such args: TableIndexRow") } return result } // desc table // https://dev.mysql.com/doc/refman/5.7/en/show-columns.html // TableDesc show columns from rental; type TableDesc struct { Name string DescValues []TableDescValue } // TableDescValue 含有每一列的属性 type TableDescValue struct { Field string // 列名 Type string // 数据类型 Collation []byte // 字符集 Null string // 是否有NULL(NO、YES) Key string // 键类型 Default []byte // 默认值 Extra string // 其他 Privileges string // 权限 Comment string // 备注 } // NewTableDesc 初始化一个*TableDesc func NewTableDesc(tableName string) *TableDesc { return &TableDesc{ Name: tableName, DescValues: make([]TableDescValue, 0), } } // ShowColumns 获取 DB 中所有的 columns func (db *Connector) ShowColumns(tableName string) (*TableDesc, error) { tbDesc := NewTableDesc(tableName) // 执行 show create table res, err := db.Query(fmt.Sprintf("show full columns from `%s`.`%s`", Escape(db.Database, false), Escape(tableName, false))) if err != nil { return nil, err } // columns info tc := TableDescValue{} columnFields := make([]interface{}, 0) fields := map[string]interface{}{ "Field": &tc.Field, "Type": &tc.Type, "Collation": &tc.Collation, "Null": &tc.Null, "Key": &tc.Key, "Default": &tc.Default, "Extra": &tc.Extra, "Privileges": &tc.Privileges, "Comment": &tc.Comment, } cols, err := res.Rows.Columns() common.LogIfError(err, "") var colByPass []byte for _, col := range cols { if _, ok := fields[col]; ok { columnFields = append(columnFields, fields[col]) } else { common.Log.Debug("ShowColumns by pass column %s", col) columnFields = append(columnFields, &colByPass) } } // 获取值 for res.Rows.Next() { err := res.Rows.Scan(columnFields...) if err != nil { common.Log.Debug(err.Error()) } tbDesc.DescValues = append(tbDesc.DescValues, tc) } res.Rows.Close() return tbDesc, err } // Columns 用于获取TableDesc中所有列的名称 func (td TableDesc) Columns() []string { var cols []string for _, col := range td.DescValues { cols = append(cols, col.Field) } return cols } // showCreate show create func (db *Connector) showCreate(createType, name string) (string, error) { // SHOW CREATE DATABASE db_name // SHOW CREATE EVENT event_name // SHOW CREATE FUNCTION func_name // SHOW CREATE PROCEDURE proc_name // SHOW CREATE TABLE tbl_name // SHOW CREATE TRIGGER trigger_name // SHOW CREATE VIEW view_name res, err := db.Query(fmt.Sprintf("SHOW CREATE %s `%s`", createType, Escape(name, false))) if err != nil { return "", err } // columns info var create string createFields := make([]interface{}, 0) fields := map[string]interface{}{ "Create View": &create, "Create Table": &create, "Create Database": &create, "Create Event": &create, "Statement": &create, // show create trigger "Create Function": &create, "Create Procedure": &create, } cols, err := res.Rows.Columns() common.LogIfError(err, "") var colByPass []byte for _, col := range cols { if _, ok := fields[col]; ok { createFields = append(createFields, fields[col]) } else { common.Log.Debug("showCreate Type: %s, Name: %s, by pass column `%s`", createType, name, col) createFields = append(createFields, &colByPass) } } // 获取 CREATE 语句 for res.Rows.Next() { err := res.Rows.Scan(createFields...) if err != nil { common.Log.Debug(err.Error()) } } res.Rows.Close() return create, err } // ShowCreateDatabase show create database func (db *Connector) ShowCreateDatabase(dbName string) (string, error) { defer func() { err := recover() if err != nil { common.Log.Error("recover ShowCreateDatabase()", err) } }() return db.showCreate("database", dbName) } // ShowCreateTable show create table func (db *Connector) ShowCreateTable(tableName string) (string, error) { defer func() { err := recover() if err != nil { common.Log.Error("recover ShowCreateTable()", err) } }() ddl, err := db.showCreate("TABLE", tableName) // 去除外键关联条件 lines := strings.Split(ddl, "\n") // CREATE VIEW ONLY 1 LINE if len(lines) > 2 { var noConstraint []string relationReg, _ := regexp.Compile("CONSTRAINT") partitionReg, _ := regexp.Compile("PARTITIONS") var DeleteComaT deleteComaType for _, line := range lines[1 : len(lines)-1] { if relationReg.Match([]byte(line)) { DeleteComaT = CS continue } else if partitionReg.Match([]byte(line)) { DeleteComaT = PART } line = strings.TrimSuffix(line, ",") noConstraint = append(noConstraint, line) } // 去除外键语句会使DDL中多一个','导致语法错误,要把多余的逗号去除 // len(lines) > 2的判断方式有问题,如果是分区表也会判断成为外键语句,导致建表语句的逗号错乱 if DeleteComaT == CS { ddl = fmt.Sprint( lines[0], "\n", strings.Join(noConstraint, ",\n"), "\n", lines[len(lines)-1], ) } else if DeleteComaT == PART { ddl = fmt.Sprint( lines[0], "\n", strings.Join(noConstraint, ",\n"), "\n", lines[len(lines)-3], ) } } return ddl, err } // FindColumn find column func (db *Connector) FindColumn(name, dbName string, tables ...string) ([]*common.Column, error) { // 执行 show create table var columns []*common.Column sql := fmt.Sprintf("SELECT "+ "c.TABLE_NAME,c.TABLE_SCHEMA,c.COLUMN_TYPE,c.CHARACTER_SET_NAME, c.COLLATION_NAME "+ "FROM `INFORMATION_SCHEMA`.`COLUMNS` as c where c.COLUMN_NAME = '%s' ", Escape(name, false)) if dbName != "" { sql += fmt.Sprintf(" and c.table_schema = '%s'", Escape(dbName, false)) } if len(tables) > 0 { var tmp []string for _, table := range tables { tmp = append(tmp, "'"+Escape(table, false)+"'") } sql += fmt.Sprintf(" and c.table_name in (%s)", strings.Join(tmp, ",")) } common.Log.Debug("FindColumn, execute SQL: %s", sql) res, err := db.Query(sql) if err != nil { common.Log.Error("(db *Connector) FindColumn Error : ", err) return columns, err } var col common.Column for res.Rows.Next() { var character, collation []byte err = res.Rows.Scan(&col.Table, &col.DB, &col.DataType, &character, &collation) if err != nil { break } col.Name = name col.Character = string(character) col.Collation = string(collation) // 填充字符集和排序规则 if col.Character == "" { // 当从 `INFORMATION_SCHEMA`.`COLUMNS` 表中查询不到相关列的 character 和 collation 的信息时 // 认为该列使用的 character 和 collation 与其所处的表一致 // 由于 `INFORMATION_SCHEMA`.`TABLES` 表中未找到表的 character,所以从按照 MySQL 中 collation 的规则从中截取 character sql = fmt.Sprintf("SELECT `t`.`TABLE_COLLATION` FROM `INFORMATION_SCHEMA`.`TABLES` AS `t` "+ "WHERE `t`.`TABLE_NAME`='%s' AND `t`.`TABLE_SCHEMA` = '%s'", Escape(col.Table, false), Escape(col.DB, false)) common.Log.Debug("FindColumn, execute SQL: %s", sql) var newRes QueryResult newRes, err = db.Query(sql) if err != nil { common.Log.Error("(db *Connector) FindColumn Error : ", err) return columns, err } var tbCollation []byte if newRes.Rows.Next() { err = newRes.Rows.Scan(&tbCollation) if err != nil { break } } newRes.Rows.Close() if string(tbCollation) != "" { col.Character = strings.Split(string(tbCollation), "_")[0] col.Collation = string(tbCollation) } } columns = append(columns, &col) } res.Rows.Close() return columns, err } // IsForeignKey 判断列是否是外键 func (db *Connector) IsForeignKey(dbName, tbName, column string) bool { sql := fmt.Sprintf("SELECT REFERENCED_COLUMN_NAME FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE C "+ "WHERE REFERENCED_TABLE_SCHEMA <> 'NULL' AND"+ " TABLE_NAME='%s' AND"+ " TABLE_SCHEMA='%s' AND"+ " COLUMN_NAME='%s'", Escape(tbName, false), Escape(dbName, false), Escape(column, false)) common.Log.Debug("IsForeignKey, execute SQL: %s", sql) res, err := db.Query(sql) if err != nil { common.Log.Error("IsForeignKey, Error: %s", err.Error()) return false } if res.Rows.Next() { return true } return false } // Reference 用于存储关系 type Reference map[string][]ReferenceValue // ReferenceValue 用于处理表之间的关系 type ReferenceValue struct { ReferencedTableSchema string // 夫表所属数据库 ReferencedTableName string // 父表 TableSchema string // 子表所属数据库 TableName string // 子表 ConstraintName string // 关系名称 } // ShowReference 查找所有的外键信息 func (db *Connector) ShowReference(dbName string, tbName ...string) ([]ReferenceValue, error) { var referenceValues []ReferenceValue sql := `SELECT DISTINCT C.REFERENCED_TABLE_SCHEMA,C.REFERENCED_TABLE_NAME,C.TABLE_SCHEMA,C.TABLE_NAME,C.CONSTRAINT_NAME FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE C JOIN INFORMATION_SCHEMA. TABLES T ON T.TABLE_NAME = C.TABLE_NAME WHERE C.REFERENCED_TABLE_NAME IS NOT NULL` sql = sql + fmt.Sprintf(` AND C.TABLE_SCHEMA = "%s"`, Escape(dbName, false)) var tables []string for _, tb := range tbName { tables = append(tables, "'"+Escape(tb, false)+"'") } if len(tbName) > 0 { extra := fmt.Sprintf(` AND C.TABLE_NAME IN ("%s")`, strings.Join(tables, ",")) sql = sql + extra } common.Log.Debug("ShowReference, execute SQL: %s", sql) // 执行SQL查找外键关联关系 res, err := db.Query(sql) if err != nil { return referenceValues, err } // 获取值 for res.Rows.Next() { var rv ReferenceValue err = res.Rows.Scan(&rv.ReferencedTableSchema, &rv.ReferencedTableName, &rv.TableSchema, &rv.TableName, &rv.ConstraintName) if err != nil { break } referenceValues = append(referenceValues, rv) } res.Rows.Close() return referenceValues, err } ================================================ FILE: database/show_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "fmt" "testing" "github.com/XiaoMi/soar/common" "github.com/kr/pretty" ) func TestShowTableStatus(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgDatabase := connTest.Database connTest.Database = "sakila" ts, err := connTest.ShowTableStatus("film") if err != nil { t.Error("ShowTableStatus Error: ", err) } if string(ts.Rows[0].Engine) != "InnoDB" { t.Error("film table should be InnoDB engine") } pretty.Println(ts) connTest.Database = "sakila" ts, err = connTest.ShowTableStatus("actor_info") if err != nil { t.Error("ShowTableStatus Error: ", err) } if string(ts.Rows[0].Comment) != "VIEW" { t.Error("actor_info should be VIEW", ts.Rows[0].Comment) } pretty.Println(ts) connTest.Database = orgDatabase common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestShowTables(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgDatabase := connTest.Database connTest.Database = "sakila" ts, err := connTest.ShowTables() if err != nil { t.Error("ShowTableStatus Error: ", err) } err = common.GoldenDiff(func() { for _, table := range ts { fmt.Println(table) } }, t.Name(), update) if err != nil { t.Error(err) } connTest.Database = orgDatabase common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestShowCreateDatabase(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) err := common.GoldenDiff(func() { fmt.Println(connTest.ShowCreateDatabase("sakila")) }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestShowCreateTable(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgDatabase := connTest.Database connTest.Database = "sakila" tables := []string{ "film", "category", "customer_list", "inventory", } err := common.GoldenDiff(func() { for _, table := range tables { ts, err := connTest.ShowCreateTable(table) if err != nil { t.Error("ShowCreateTable Error: ", err) } fmt.Println(ts) } }, t.Name(), update) if err != nil { t.Error(err) } connTest.Database = orgDatabase common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestShowIndex(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgDatabase := connTest.Database connTest.Database = "sakila" ti, err := connTest.ShowIndex("film") if err != nil { t.Error("ShowIndex Error: ", err) } err = common.GoldenDiff(func() { pretty.Println(ti) pretty.Println(ti.FindIndex(IndexKeyName, "idx_title")) }, t.Name(), update) if err != nil { t.Error(err) } connTest.Database = orgDatabase common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestShowColumns(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgDatabase := connTest.Database connTest.Database = "sakila" ti, err := connTest.ShowColumns("actor_info") if err != nil { t.Error("ShowColumns Error: ", err) } err = common.GoldenDiff(func() { pretty.Println(ti) }, t.Name(), update) if err != nil { t.Error(err) } connTest.Database = orgDatabase common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFindColumn(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) ti, err := connTest.FindColumn("film_id", "sakila", "film") if err != nil { t.Error("FindColumn Error: ", err) } err = common.GoldenDiff(func() { pretty.Println(ti) }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestIsFKey(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) if !connTest.IsForeignKey("sakila", "film", "language_id") { t.Error("want True. got false") } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestShowReference(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) rv, err := connTest.ShowReference("sakila", "film") if err != nil { t.Error("ShowReference Error: ", err) } err = common.GoldenDiff(func() { pretty.Println(rv) }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: database/testdata/TestExplain.golden ================================================ &database.ExplainInfo{ SQL: "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", ExplainFormat: 0, ExplainRows: { &database.ExplainRow{ ID: 1, SelectType: "PRIMARY", TableName: "country", Partitions: "NULL", AccessType: "index", PossibleKeys: {"PRIMARY"}, Key: "PRIMARY", KeyLen: "2", Ref: {""}, Rows: 109, Filtered: 100, Scalability: "O(n)", Extra: "Using index; Using temporary; Using filesort", }, &database.ExplainRow{ ID: 1, SelectType: "PRIMARY", TableName: "city", Partitions: "NULL", AccessType: "ref", PossibleKeys: {"PRIMARY", "idx_fk_country_id"}, Key: "idx_fk_country_id", KeyLen: "2", Ref: {"sakila.country.country_id"}, Rows: 5, Filtered: 100, Scalability: "O(log n)", Extra: "NULL", }, &database.ExplainRow{ ID: 1, SelectType: "PRIMARY", TableName: "c", Partitions: "NULL", AccessType: "ALL", PossibleKeys: {""}, Key: "NULL", KeyLen: "", Ref: {""}, Rows: 600, Filtered: 10, Scalability: "O(n)", Extra: "Using where; Using join buffer (Block Nested Loop)", }, &database.ExplainRow{ ID: 1, SelectType: "PRIMARY", TableName: "a", Partitions: "NULL", AccessType: "ref", PossibleKeys: {"PRIMARY", "idx_fk_city_id"}, Key: "idx_fk_city_id", KeyLen: "2", Ref: {"sakila.city.city_id"}, Rows: 1, Filtered: 100, Scalability: "O(log n)", Extra: "NULL", }, &database.ExplainRow{ ID: 1, SelectType: "PRIMARY", TableName: "cu", Partitions: "NULL", AccessType: "ref", PossibleKeys: {"idx_fk_address_id"}, Key: "idx_fk_address_id", KeyLen: "2", Ref: {"sakila.a.address_id"}, Rows: 1, Filtered: 100, Scalability: "O(log n)", Extra: "NULL", }, &database.ExplainRow{ ID: 1, SelectType: "PRIMARY", TableName: "", Partitions: "NULL", AccessType: "ref", PossibleKeys: {""}, Key: "", KeyLen: "152", Ref: {"sakila.a.address"}, Rows: 6, Filtered: 100, Scalability: "O(log n)", Extra: "Using index", }, &database.ExplainRow{ ID: 2, SelectType: "DERIVED", TableName: "a", Partitions: "NULL", AccessType: "ALL", PossibleKeys: {"PRIMARY", "idx_fk_city_id"}, Key: "NULL", KeyLen: "", Ref: {""}, Rows: 603, Filtered: 100, Scalability: "O(n)", Extra: "Using filesort", }, &database.ExplainRow{ ID: 2, SelectType: "DERIVED", TableName: "cu", Partitions: "NULL", AccessType: "ref", PossibleKeys: {"idx_fk_store_id", "idx_fk_address_id"}, Key: "idx_fk_address_id", KeyLen: "2", Ref: {"sakila.a.address_id"}, Rows: 1, Filtered: 54.42, Scalability: "O(log n)", Extra: "Using where", }, &database.ExplainRow{ ID: 2, SelectType: "DERIVED", TableName: "city", Partitions: "NULL", AccessType: "eq_ref", PossibleKeys: {"PRIMARY", "idx_fk_country_id"}, Key: "PRIMARY", KeyLen: "2", Ref: {"sakila.a.city_id"}, Rows: 1, Filtered: 100, Scalability: "O(log n)", Extra: "NULL", }, &database.ExplainRow{ ID: 2, SelectType: "DERIVED", TableName: "country", Partitions: "NULL", AccessType: "eq_ref", PossibleKeys: {"PRIMARY"}, Key: "PRIMARY", KeyLen: "2", Ref: {"sakila.city.country_id"}, Rows: 1, Filtered: 100, Scalability: "O(log n)", Extra: "Using index", }, }, ExplainJSON: (*database.ExplainJSON)(nil), Warnings: nil, QueryCost: 0, } ================================================ FILE: database/testdata/TestExplainInfoTranslator.golden ================================================ ================================================ FILE: database/testdata/TestFindColumn.golden ================================================ []*common.Column{ &common.Column{ Name: "film_id", Alias: nil, Table: "film", DB: "sakila", DataType: "smallint unsigned", Character: "utf8mb3", Collation: "utf8mb3_general_ci", Cardinality: 0, Null: "", Key: "", Default: "", Extra: "", Comment: "", Privileges: "", }, } ================================================ FILE: database/testdata/TestFormatProfiling.golden ================================================ ================================================ FILE: database/testdata/TestFormatTrace.golden ================================================ ```sql select 1 ``` ```json { "steps": [ { "join_preparation": { "select#": 1, "steps": [ { "expanded_query": "/* select#1 */ select 1 AS `1`" } ] } }, { "join_optimization": { "select#": 1, "steps": [ ] } }, { "join_explain": { "select#": 1, "steps": [ ] } } ] } ``` ================================================ FILE: database/testdata/TestMySQLExplainQueryCost.golden ================================================ ================================================ FILE: database/testdata/TestMySQLExplainWarnings.golden ================================================ ================================================ FILE: database/testdata/TestPrintMarkdownExplainTable.golden ================================================ ================================================ FILE: database/testdata/TestRemoveSQLComments.golden ================================================ select 'c#\'#not comment' select "c#\"#not comment" ================================================ FILE: database/testdata/TestShowColumns.golden ================================================ &database.TableDesc{ Name: "actor_info", DescValues: { { Field: "actor_id", Type: "smallint unsigned", Collation: nil, Null: "NO", Key: "", Default: {0x30}, Extra: "", Privileges: "select,insert,update,references", Comment: "", }, { Field: "first_name", Type: "varchar(45)", Collation: {0x75, 0x74, 0x66, 0x38, 0x6d, 0x62, 0x33, 0x5f, 0x67, 0x65, 0x6e, 0x65, 0x72, 0x61, 0x6c, 0x5f, 0x63, 0x69}, Null: "NO", Key: "", Default: nil, Extra: "", Privileges: "select,insert,update,references", Comment: "", }, { Field: "last_name", Type: "varchar(45)", Collation: {0x75, 0x74, 0x66, 0x38, 0x6d, 0x62, 0x33, 0x5f, 0x67, 0x65, 0x6e, 0x65, 0x72, 0x61, 0x6c, 0x5f, 0x63, 0x69}, Null: "NO", Key: "", Default: nil, Extra: "", Privileges: "select,insert,update,references", Comment: "", }, { Field: "film_info", Type: "text", Collation: {0x75, 0x74, 0x66, 0x38, 0x6d, 0x62, 0x33, 0x5f, 0x67, 0x65, 0x6e, 0x65, 0x72, 0x61, 0x6c, 0x5f, 0x63, 0x69}, Null: "YES", Key: "", Default: nil, Extra: "", Privileges: "select,insert,update,references", Comment: "", }, }, } ================================================ FILE: database/testdata/TestShowCreateDatabase.golden ================================================ CREATE DATABASE `sakila` /*!40100 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci */ /*!80016 DEFAULT ENCRYPTION='N' */ ================================================ FILE: database/testdata/TestShowCreateTable.golden ================================================ CREATE TABLE `film` ( `film_id` smallint unsigned NOT NULL AUTO_INCREMENT, `title` varchar(255) NOT NULL, `description` text, `release_year` year DEFAULT NULL, `language_id` tinyint unsigned NOT NULL, `original_language_id` tinyint unsigned DEFAULT NULL, `rental_duration` tinyint unsigned NOT NULL DEFAULT '3', `rental_rate` decimal(4,2) NOT NULL DEFAULT '4.99', `length` smallint unsigned DEFAULT NULL, `replacement_cost` decimal(5,2) NOT NULL DEFAULT '19.99', `rating` enum('G','PG','PG-13','R','NC-17') DEFAULT 'G', `special_features` set('Trailers','Commentaries','Deleted Scenes','Behind the Scenes') DEFAULT NULL, `last_update` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`film_id`), KEY `idx_title` (`title`), KEY `idx_fk_language_id` (`language_id`), KEY `idx_fk_original_language_id` (`original_language_id`) ) ENGINE=InnoDB AUTO_INCREMENT=1001 DEFAULT CHARSET=utf8mb3 CREATE TABLE `category` ( `category_id` tinyint unsigned NOT NULL AUTO_INCREMENT, `name` varchar(25) NOT NULL, `last_update` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`category_id`) ) ENGINE=InnoDB AUTO_INCREMENT=17 DEFAULT CHARSET=utf8mb3 CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `customer_list` AS select `cu`.`customer_id` AS `ID`,concat(`cu`.`first_name`,_utf8mb3' ',`cu`.`last_name`) AS `name`,`a`.`address` AS `address`,`a`.`postal_code` AS `zip code`,`a`.`phone` AS `phone`,`city`.`city` AS `city`,`country`.`country` AS `country`,if(`cu`.`active`,_utf8mb3'active',_utf8mb3'') AS `notes`,`cu`.`store_id` AS `SID` from (((`customer` `cu` join `address` `a` on((`cu`.`address_id` = `a`.`address_id`))) join `city` on((`a`.`city_id` = `city`.`city_id`))) join `country` on((`city`.`country_id` = `country`.`country_id`))) CREATE TABLE `inventory` ( `inventory_id` mediumint unsigned NOT NULL AUTO_INCREMENT, `film_id` smallint unsigned NOT NULL, `store_id` tinyint unsigned NOT NULL, `last_update` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`inventory_id`), KEY `idx_fk_film_id` (`film_id`), KEY `idx_store_id_film_id` (`store_id`,`film_id`) ) ENGINE=InnoDB AUTO_INCREMENT=4582 DEFAULT CHARSET=utf8mb3 ================================================ FILE: database/testdata/TestShowIndex.golden ================================================ &database.TableIndexInfo{ TableName: "film", Rows: { { Table: "film", NonUnique: 0, KeyName: "PRIMARY", SeqInIndex: 1, ColumnName: "film_id", Collation: "A", Cardinality: 1000, SubPart: 0, Packed: 0, Null: "", IndexType: "", Comment: "", IndexComment: "", Visible: "", Expression: nil, }, { Table: "film", NonUnique: 1, KeyName: "idx_title", SeqInIndex: 1, ColumnName: "title", Collation: "A", Cardinality: 1000, SubPart: 0, Packed: 0, Null: "", IndexType: "", Comment: "", IndexComment: "", Visible: "", Expression: nil, }, { Table: "film", NonUnique: 1, KeyName: "idx_fk_language_id", SeqInIndex: 1, ColumnName: "language_id", Collation: "A", Cardinality: 1, SubPart: 0, Packed: 0, Null: "", IndexType: "", Comment: "", IndexComment: "", Visible: "", Expression: nil, }, { Table: "film", NonUnique: 1, KeyName: "idx_fk_original_language_id", SeqInIndex: 1, ColumnName: "original_language_id", Collation: "A", Cardinality: 1, SubPart: 0, Packed: 0, Null: "", IndexType: "", Comment: "", IndexComment: "", Visible: "", Expression: nil, }, }, } []database.TableIndexRow{ { Table: "film", NonUnique: 1, KeyName: "idx_title", SeqInIndex: 1, ColumnName: "title", Collation: "A", Cardinality: 1000, SubPart: 0, Packed: 0, Null: "", IndexType: "", Comment: "", IndexComment: "", Visible: "", Expression: nil, }, } ================================================ FILE: database/testdata/TestShowReference.golden ================================================ []database.ReferenceValue(nil) ================================================ FILE: database/testdata/TestShowTables.golden ================================================ actor actor_info address category city country customer customer_list film film_actor film_category film_list film_text inventory language nicer_but_slower_film_list payment rental sales_by_film_category sales_by_store staff staff_list store ================================================ FILE: database/testdata/TestTrace.golden ================================================ select 1 []database.TraceRow{ {Query:"explain select 1", Trace:"{\n \"steps\": [\n {\n \"join_preparation\": {\n \"select#\": 1,\n \"steps\": [\n {\n \"expanded_query\": \"/* select#1 */ select 1 AS `1`\"\n }\n ]\n }\n },\n {\n \"join_optimization\": {\n \"select#\": 1,\n \"steps\": [\n ]\n }\n },\n {\n \"join_explain\": {\n \"select#\": 1,\n \"steps\": [\n ]\n }\n }\n ]\n}", MissingBytesBeyondMaxMemSize:0, InsufficientPrivileges:0}, } nil explain select 1 []database.TraceRow(nil) &errors.errorString{s:"no need trace"} show create table film []database.TraceRow(nil) &errors.errorString{s:"no need trace"} ================================================ FILE: database/trace.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "errors" "fmt" "regexp" "strings" "github.com/XiaoMi/soar/common" "vitess.io/vitess/go/vt/sqlparser" ) // Trace 用于存放 Select * From Information_Schema.Optimizer_Trace;输出的结果 type Trace struct { Rows []TraceRow } // TraceRow 中含有trace的基本信息 type TraceRow struct { Query string Trace string MissingBytesBeyondMaxMemSize int InsufficientPrivileges int } // Trace 执行SQL,并对其Trace func (db *Connector) Trace(sql string, params ...interface{}) ([]TraceRow, error) { common.Log.Debug("Trace SQL: %s", sql) var rows []TraceRow if common.Config.TestDSN.Version < 50600 { return rows, errors.New("version < 5.6, not support trace") } // 过滤不需要 Trace 的 SQL switch sqlparser.Preview(sql) { case sqlparser.StmtSelect, sqlparser.StmtUpdate, sqlparser.StmtDelete: sql = "explain " + sql case sqlparser.EXPLAIN: default: return rows, errors.New("no need trace") } // 测试环境如果检查是关闭的,则SQL不会被执行 if common.Config.TestDSN.Disable { return rows, errors.New("dsn is disable") } // 数据库安全性检查:如果 Connector 的 IP 端口与 TEST 环境不一致,则启用SQL白名单 // 不在白名单中的SQL不允许执行 // 执行环境与test环境不相同 if db.Addr != common.Config.TestDSN.Addr && db.dangerousQuery(sql) { return rows, fmt.Errorf("query Execution Deny: Execute SQL with DSN(%s/%s) '%s'", db.Addr, db.Database, fmt.Sprintf(sql, params...)) } common.Log.Debug("Execute SQL with DSN(%s/%s) : %s", db.Addr, db.Database, sql) // 开启Trace common.Log.Debug("SET SESSION OPTIMIZER_TRACE='enabled=on'") trx, err := db.Conn.Begin() if err != nil { return rows, err } defer func() { trxErr := trx.Rollback() if trxErr != nil { common.Log.Debug(trxErr.Error()) } }() _, err = trx.Query("SET SESSION OPTIMIZER_TRACE='enabled=on'") common.LogIfError(err, "") // 执行SQL,抛弃返回结果 tmpRes, err := trx.Query(sql, params...) if err != nil { return rows, err } for tmpRes.Next() { continue } // 返回Trace结果 res, err := trx.Query("SELECT * FROM information_schema.OPTIMIZER_TRACE") if err != nil { trxErr := trx.Rollback() if trxErr != nil { common.Log.Debug(trxErr.Error()) } return rows, err } for res.Next() { var traceRow TraceRow err = res.Scan(&traceRow.Query, &traceRow.Trace, &traceRow.MissingBytesBeyondMaxMemSize, &traceRow.InsufficientPrivileges) if err != nil { common.LogIfError(err, "") break } rows = append(rows, traceRow) } res.Close() // 关闭Trace common.Log.Debug("SET SESSION OPTIMIZER_TRACE='enabled=off'") _, err = trx.Query("SET SESSION OPTIMIZER_TRACE='enabled=off'") common.LogIfError(err, "") return rows, err } // FormatTrace 格式化输出Trace信息 func FormatTrace(rows []TraceRow) string { explainReg := regexp.MustCompile(`(?i)^explain\s+`) str := []string{""} for _, row := range rows { str = append(str, "```sql") sql := explainReg.ReplaceAllString(row.Query, "") str = append(str, sql) str = append(str, "```\n") str = append(str, "```json") str = append(str, row.Trace) str = append(str, "```\n") } return strings.Join(str, "\n") } ================================================ FILE: database/trace_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package database import ( "testing" "github.com/XiaoMi/soar/common" "github.com/kr/pretty" ) func TestTrace(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) sqls := []string{ "select 1", "explain select 1", "show create table film", } err := common.GoldenDiff(func() { for _, sql := range sqls { res, err := connTest.Trace(sql) pretty.Println(sql, res, err) } }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestFormatTrace(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) res, err := connTest.Trace("select 1") if err != nil { t.Error(err) } err = common.GoldenDiff(func() { pretty.Println(FormatTrace(res)) }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: deps.sh ================================================ #!/bin/bash NEEDED_COMMANDS="docker git go retool bats" for cmd in ${NEEDED_COMMANDS} ; do if ! command -v "${cmd}" &> /dev/null ; then echo -e "\033[91m${cmd} missing\033[0m" exit 1 else echo "${cmd} found" fi done # Docker ## https://www.docker.com # Git ## https://git-scm.com/ # Go ## https://golang.org/ # Govendor ## go get github.com/kardianos/govendor # retool ## go get github.com/twitchtv/retool # bats https://github.com/sstephenson/bats ## Ubuntu: apt-get install bats ## Mac: brew install bats ================================================ FILE: doc/FAQ.md ================================================ # 常见问题 ## 软件依赖 * [git](https://git-scm.co) 项目代码管理工具 * [go](https://golang.org/) 源码编译依赖 * [govendor](https://github.com/kardianos/govendor) 管理第三方包 * [docker](https://www.docker.com) 主要用于构建测试环境 * [mysql](https://www.mysql.com/) 测试时用来连接测试环境 * [retool](https://github.com/twitchtv/retool): 管理测试开发工具,首次安装耗时会比较长,如: `gometalinter.v2`, `revive`, `golangci-lint` ## Web 界面支持 官方不会提供 Web 界面支持,但社区已经有相当多的同学基于 SOAR 开发了衍生的 Web 平台。可以参考如下 ISSUE 的讨论。 > https://github.com/XiaoMi/soar/issues/51 ## 命令行参数 `test-dsn`, `online-dsn` 中包含特殊字符怎么办? 如果 `test-dsn` 或 `online-dsn` 中包含':', '@', '/', '!'等特殊字符建议在配置文件中配置相关信息,配置文件为YAML格式,需要遵守YAML格式的要求规范。 ## Windows 环境如下安装使用? SOAR是命令行工具,开源版本无UI界面需要在 `cmd.exe` 下运行。下图为社区同学帮忙录制的 Windows 环境下载、安装及使用演示。 ![SOAR__Windows_Installation](https://wx4.sinaimg.cn/large/7143d93fly1fx9z0lw0k8g211j0jlkjo.gif) ## Windows 环境下 -query 文件找不到问题 ![](https://raw.githubusercontent.com/XiaoMi/soar/master/doc/images/windows_query_error.png) 将 Window 文件后缀名显示打开,并检查文件名是否正确。 ![](https://raw.githubusercontent.com/XiaoMi/soar/master/doc/images/windows_query_check.png) ## Windows环境下双击`soar.windows-amd64`文件无反应。 `soar` 是命令行工具,不是图形化桌面工具,Windows环境需要在 `cmd.exe` 下以命令行方式运行。使用 `soar` 前您需要先熟悉Windows命令行使用。 ## Windows 用户的引号问题 ![windows_quote](https://raw.githubusercontent.com/XiaoMi/soar/master/doc/images/windows_quote.png) 从上图可以看出 Windows 环境下引号(单引号或双引号)也成为了SQL的一部分传递给 soar 进行分析。因此 Windows 环境下使用如下方式读取 SQL 来解决 Windows 的引号问题。 ```bash type query.sql | soar.windows-amd64 ``` ## 文件无法执行 ```bash ./soar.linux-amd64 bash: ./soar.linux-amd64: cannot execute binary file ``` 请注意您操作系统类型,`soar.linux-amd64` 为 Linux 系统使用的二进制文件,`soar.darwin-amd64` 为苹果系统使用的二进制文件,`soar.windows-amd64` 是微软用户使用的二进制文件。下载文件后 Linux 和苹果用户需要为文件添加可执行权限 `chmod a+x filename`。 ## 命令无法找到 ```bash bash: soar: command not found ``` 直接执行 `soar` 命令提示命令无法找到,请先将 soar 文件添加可执行权限 `chmod a+x soar` 然后将可以将 soar 所在路径加到[PATH](https://linuxconfig.org/linux-path-environment-variable)中,也可以将 soar 移动到已有 PATH 中。 当然在 Linux 环境下,在 soar 二进制文件所在路径运行 `./soar` 也同样可以解决您的问题。 ## 提示语法错误 * 请检查SQL语句中是否出现了不配对的引号,如 `, ", ' ## 输出结果返回慢 * 如果配置了 online-dsn 或 test-dsn SOAR 会请求这些数据库以支持更多的功能,这时评审一条SQL就会耗时变长。 * 如果又开启了 `-sampling=true` 的话会将线上的数据导入到测试环境,数据采样也会消耗一些时间。 ## 如何搭建测试环境 ```bash # 创建测试数据库 wget http://downloads.mysql.com/doc/sakila-db.tar.gz tar zxf sakila-db.tar.gz && cd sakila-db mysql -u root -p -f < sakila-schema.sql mysql -u root -p -f < sakila-data.sql # 创建测试用户 CREATE USER root@'hostname' IDENTIFIED BY "1t'sB1g3rt"; GRANT ALL ON *.* TO root@'hostname'; ``` ## 更新vitess依赖 使用`govendor fetch`或`git clone` [vitess](https://github.com/vitessio/vitess) 在某些地区更新vitess可能会比较慢,导致项目编译不过,所以将vitess整个代码库加到了代码仓库。 如属更新vitess仓库可以使用如下命令。 ```bash make vitess ``` ## 生成报告并发邮件 ```bash #!/bin/bash soar -query "select * from film" > ./index.html ( echo To: youmail@example.com echo From: robot@example.com echo "Content-Type: text/html; " echo Subject: SQL Analyze Report echo cat ./index.html ) | sendmail -t ``` ## 如何新增一条启发式建议 ```bash advisor/rules.go HeuristicRules 加一个条新的规则 advisor/heuristic.go 实现一个规则函数 advisor/heuristic_test.go 添加相应规则函数的测试用例 make heuristic make daily ``` ================================================ FILE: doc/FAQ_en.md ================================================ ## FAQ ### Dependency Tools * [git](https://git-scm.co): clone code from git repository * [go](https://golang.org/): build source * [govendor](https://github.com/kardianos/govendor): manager third party dependency * [docker](https://www.docker.com): manager test environment * [mysql](https://www.mysql.com/): connect test environment * [retool](https://github.com/twitchtv/retool): manager test tools such as `gometalinter.v2`, `revive`, `golangci-lint` ### Syntax Error * Unexpected quote, like `, ", ' * vitess syntax not supported yet ### Program running slowly * SOAR will use online-dsn, test-dsn for data sampling and testing if they are on a different host to access these instance will cost much time. This may cause analyze slowly, especially when you are optimizing lots of queries. * As mentioned above, if you set `-sampling=true`(by default), data sampling will take some time for more accurate suggestions. ## build test env ```bash # create test database wget http://downloads.mysql.com/doc/sakila-db.tar.gz tar zxf sakila-db.tar.gz && cd sakila-db mysql -u root -p -f < sakila-schema.sql mysql -u root -p -f < sakila-data.sql # create test user CREATE USER root@'hostname' IDENTIFIED BY "1t'sB1g3rt"; GRANT ALL ON *.* TO root@'hostname'; ``` ## update vitess in vendor `govendor fetch` or `git clone` [vitess](https://github.com/vitessio/vitess) in somewhere maybe very slow or be blocked, so we add vitess source code in vendor directory. If you what to update vitess package, you should bypass that block using yourself method. ```bash $ make vitess ``` ## HTML Format Report ```bash #!/bin/bash soar -query "select * from film" > ./index.html ( echo To: youmail@example.com echo From: robot@example.com echo "Content-Type: text/html; " echo Subject: SQL Analyze Report echo cat ./index.html ) | sendmail -t ``` ## Add a new heuristic rule ```bash advisor/rules.go HeuristicRules add a new item advisor/heuristic.go add a new rule function advisor/heuristic_test.go add a new test function make doc go test github.com/XiaoMi/soar/advisor -v -update -run TestListHeuristicRules go test github.com/XiaoMi/soar/advisor -v -update -run TestMergeConflictHeuristicRules make daily ``` ================================================ FILE: doc/cheatsheet.md ================================================ # 常用命令 [toc] ## 基本用法 ```bash echo "select title from sakila.film" | ./soar -log-output=soar.log ``` ## 指定输入源 ```bash # 从文件读取SQL ./soar -query file.sql # 从管道读取SQL cat file.sql | ./soar ``` ## 指定配置文件 ```bash vi soar.yaml # yaml format config file online-dsn: addr: 127.0.0.1:3306 schema: sakila user: root password: "1t'sB1g3rt" disable: false test-dsn: addr: 127.0.0.1:3306 schema: sakila user: root password: "1t'sB1g3rt" disable: false ``` ```bash echo "select title from sakila.film" | ./soar -test-dsn="root:1t'sB1g3rt@127.0.0.1:3306/sakila" -allow-online-as-test -log-output=soar.log ``` ## 打印所有的启发式规则 ```bash soar -list-heuristic-rules ``` ## 忽略某些规则 ```bash soar -ignore-rules "ALI.001,IDX.*" ``` ## 打印支持的报告格式 ```bash soar -list-report-types ``` ## 以指定格式输出报告 ```bash soar -report-type json ``` ## 语法检查工具 ```bash echo "select * from tb" | soar -only-syntax-check echo $? 0 echo "select * frm tb" | soar -only-syntax-check At SQL 1 : syntax error at position 13 near 'frm' echo $? 1 ``` ## 慢日志进行分析示例 ```bash pt-query-digest slow.log > slow.log.digest # parse pt-query-digest's output which example script python2.7 doc/example/digest_pt.py slow.log.digest > slow.md ``` ## SQL指纹 ```bash echo "select * from film where col='abc'" | soar -report-type=fingerprint ``` 输出 ```sql select * from film where col=? ``` ## 将 UPDATE/DELETE/INSERT 语法转为 SELECT ```bash echo "update film set title = 'abc'" | soar -rewrite-rules dml2select,delimiter -report-type rewrite ``` 输出 ```sql select * from film; ``` ## 合并多条ALTER语句 ```bash echo "alter table tb add column a int; alter table tb add column b int;" | soar -report-type rewrite -rewrite-rules mergealter ``` 输出 ```sql ALTER TABLE `tb` add column a int, add column b int ; ``` ## SQL美化 ```bash echo "select * from tbl where col = 'val'" | ./soar -report-type=pretty ``` 输出 ```sql SELECT * FROM tbl WHERE col = 'val'; ``` ## EXPLAIN信息分析报告 ```bash soar -report-type explain-digest << EOF +----+-------------+-------+------+---------------+------+---------+------+------+-------+ | id | select_type | table | type | possible_keys | key | key_len | ref | rows | Extra | +----+-------------+-------+------+---------------+------+---------+------+------+-------+ | 1 | SIMPLE | film | ALL | NULL | NULL | NULL | NULL | 1131 | | +----+-------------+-------+------+---------------+------+---------+------+------+-------+ EOF ``` ```text ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 0 | 0.00% | ☠️ **O(n)** | | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ``` ## markdown 转 HTML 通过指定-report-css, -report-javascript, -markdown-extensions, -markdown-html-flags这些参数,你还可以控制HTML的显示格式。 ```bash cat test.md | soar -report-type md2html > test.html ``` ## 清理测试环境残余的临时库表 如配置了`-drop-test-temporary=false`或`soar`异常中止,`-test-dsn`中会残余以`optimizer_`为前缀的临时库表。手工清理这些库表可以使用如下命令。 注意:为了不影响正在进行的其他SQL评审,`-cleanup-test-database`中会删除1小时前生成的临时库表。 ```bash ./soar -cleanup-test-database ``` ================================================ FILE: doc/cheatsheet_en.md ================================================ # Useful Commands [toc] ## Basic suggest ```bash echo "select title from sakila.film" | ./soar -log-output=soar.log ``` ## Analyze SQL with test environment ```bash vi soar.yaml # yaml format config file online-dsn: addr: 127.0.0.1:3306 schema: sakila user: root password: "1t'sB1g3rt" disable: false test-dsn: addr: 127.0.0.1:3306 schema: sakila user: root password: "1t'sB1g3rt" disable: false ``` ```bash echo "select title from sakila.film" | ./soar -test-dsn="root:1t'sB1g3rt@127.0.0.1:3306/sakila" -allow-online-as-test -log-output=soar.log ``` ## List supported heuristic rules ```bash soar -list-heuristic-rules ``` ## Ignore Rules ```bash soar -ignore-rules "ALI.001,IDX.*" ``` ## List supported report-type ```bash soar -list-report-types ``` ## Set report-type for output ```bash soar -report-type json ``` ## Syntax Check ```bash echo "select * from tb" | soar -only-syntax-check echo $? 0 echo "select * frm tb" | soar -only-syntax-check At SQL 1 : syntax error at position 13 near 'frm' $ echo $? 1 ``` ## Slow log analyzing ```bash pt-query-digest slow.log > slow.log.digest # parse pt-query-digest's output which example script python2.7 doc/example/digest_pt.py slow.log.digest > slow.md ``` ## SQL FingerPrint ```bash echo "select * from film where col='abc'" | soar -report-type=fingerprint ``` Output ```sql select * from film where col=? ``` ## Convert UPDATE/DELETE/INSERT into SELECT ```bash echo "update film set title = 'abc'" | soar -rewrite-rules dml2select,delimiter -report-type rewrite ``` Output ```sql select * from film; ``` ## Merge ALTER SQLs ```bash echo "alter table tb add column a int; alter table tb add column b int;" | soar -report-type rewrite -rewrite-rules mergealter ``` Output ```sql ALTER TABLE `tb` add column a int, add column b int ; ``` ## SQL Pretty ```bash echo "select * from tbl where col = 'val'" | ./soar -report-type=pretty ``` Output ```sql SELECT * FROM tbl WHERE col = 'val'; ``` ## Convert markdown to HTML md2html comes with other flags, such as `-report-css`, `-report-javascript`, `-markdown-extensions`, `-markdown-html-flags`, you can get more self control HTML report. ```bash cat test.md | soar -report-type md2html > test.html ``` ================================================ FILE: doc/comparison.md ================================================ ## 业内其他优秀产品对比 | | SOAR | sqlcheck | pt-query-advisor | SQL Advisor | Inception | sqlautoreview | | --- | --- | --- | --- | --- | --- | --- | | 启发式建议 | ✔️ | ✔️ | ✔️ | ❌ | ✔️ | ✔️ | | 索引建议 | ✔️ | ❌ | ❌ | ✔️ | ❌ | ✔️ | | 查询重写 | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | | 执行计划展示 | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | | Profiling | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | | Trace | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | | SQL在线执行 | ❌ | ❌ | ❌ | ❌ | ✔️ | ❌ | | 数据备份 | ❌ | ❌ | ❌ | ❌ | ✔️ | ❌ | ================================================ FILE: doc/comparison_en.md ================================================ ## Compare with other wonderful product | | SOAR | sqlcheck | pt-query-advisor | SQL Advisor | Inception | sqlautoreview | | --- | --- | --- | --- | --- | --- | --- | | Heuristic Rules | ✔️ | ✔️ | ✔️ | ❌ | ✔️ | ✔️ | | Index Suggest | ✔️ | ❌ | ❌ | ✔️ | ❌ | ✔️ | | Rewrite Query | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | | Explain | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | | Profiling | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | | Trace | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | | Execute SQL Online | ❌ | ❌ | ❌ | ❌ | ✔️ | ❌ | | Backup Data | ❌ | ❌ | ❌ | ❌ | ✔️ | ❌ | ================================================ FILE: doc/config.md ================================================ ## 配置文件说明 配置文件为[yaml](https://en.wikipedia.org/wiki/YAML)格式。一般情况下只需要配置online-dsn, test-dsn, log-output等少数几个参数。即使不创建配置文件SOAR仍然会给出基本的启发式建议。 默认文件会按照`/etc/soar.yaml`, `./etc/soar.yaml`, `./soar.yaml`顺序加载,找到第一个后不再继续加载后面的配置文件。如需指定其他配置文件可以通过`-config`参数指定。 关于数据库权限`online-dsn`需要相应库表的SELECT权限,`test-dsn`需要root最高权限。 ```text # 线上环境配置 online-dsn: addr: 127.0.0.1:3306 schema: sakila user: root password: 1t'sB1g3rt disable: false # 测试环境配置 test-dsn: addr: 127.0.0.1:3307 schema: test user: root password: 1t'sB1g3rt disable: false # 是否允许测试环境与线上环境配置相同 allow-online-as-test: true # 是否禁用环境检测,开启后表示允许测试环境版本低于线上环境 不建议开启,可能会导致语句执行异常 disable-version-check: false # 是否清理测试时产生的临时文件 drop-test-temporary: true # 语法检查小工具 only-syntax-check: false sampling-statistic-target: 100 sampling: false # 日志级别,[0:Emergency, 1:Alert, 2:Critical, 3:Error, 4:Warning, 5:Notice, 6:Informational, 7:Debug] log-level: 7 log-output: ${your_log_dir}/soar.log # 优化建议输出格式 report-type: markdown ignore-rules: - "" # 黑名单中的 SQL 将不会给评审意见。一行一条 SQL,可以是正则也可以是指纹,填写指纹时注意问号需要加反斜线转义。 blacklist: ${your_config_dir}/soar.blacklist # 启发式算法相关配置 max-join-table-count: 5 max-group-by-cols-count: 5 max-distinct-count: 5 max-index-cols-count: 5 max-total-rows: 9999999 spaghetti-query-length: 2048 allow-drop-index: false # EXPLAIN相关配置 explain-sql-report-type: pretty explain-type: extended explain-format: traditional explain-warn-select-type: - "" explain-warn-access-type: - ALL explain-max-keys: 3 explain-min-keys: 0 explain-max-rows: 10000 explain-warn-extra: - "" explain-max-filtered: 100 explain-warn-scalability: - O(n) query: "" list-heuristic-rules: false list-test-sqls: false verbose: true ``` ## 命令行参数 几乎所有配置文件中指定的参数都通通过命令行参数进行修改,且命令行参数优先级较配置文件优先级高。 ```bash soar -h ``` ### 命令行参数配置DSN SOAR 最新版本已经使用`go-sql-driver`替代了`mymysql`,DSN将使用`go-sql-driver`格式并且保持向前兼容,请参考[go-sql-driver](https://github.com/go-sql-driver/mysql#dsn-data-source-name)文档。 **以下DSN格式不再推荐使用** > 账号密码中如包含特殊符号(如:'@',':','/'等)可在配置文件中设置,存在特殊字符的情况不适合在命令行中使用。目前`soar`只支持 tcp 协议的 MySQL 数据库连接方式,如需要配置本机MySQL环境建议将`localhost`修改为'127.0.0.1',并检查对应的 'user'@'127.0.0.1' 账号是否存在。 ```bash soar -online-dsn "user:password@ip:port/database" soar -test-dsn "user:password@ip:port/database" ``` #### DSN格式支持 * "user:password@127.0.0.1:3307/database" * "user:password@127.0.0.1:3307" * "user:password@127.0.0.1:/database" * "user:password@:3307/database" * "user:password@" * "127.0.0.1:3307/database" * "@127.0.0.1:3307/database" * "@127.0.0.1" * "127.0.0.1" * "@/database" * "@127.0.0.1:3307" * "@:3307/database" * ":3307/database" * "/database" ### SQL评分 不同类型的建议指定的Severity不同,严重程度数字由低到高依次排序。满分100分,扣到0分为止。L0不扣分只给出建议,L1扣5分,L2扣10分,每级多扣5分以此类推。当由时给出L1, L2两要建议时扣分叠加,即扣15分。 如果您想给出不同的扣分建议或者对指引中的文字内容不满意可以为在 git 中提 ISSUE,也可直接修改 rules.go 的相应配置然后重新编译自己的版本。 注意:目前只有`markdown`和`html`两种`-report-type`支持评分输出显示,其他输出格式如有评分需求可以按上述规则自行计算。 ================================================ FILE: doc/editor_plugin.md ================================================ ## Vim插件安装 * 首先安装Syntastic,安装方法参见[官方文档](https://github.com/vim-syntastic/syntastic#installation) * 将`soar`二进制文件拷贝到可执行文件的查找路径($PATH)下,添加可执行权限`chmod a+x soar` * 将doc/example/[soar.vim](http://github.com/XiaoMi/soar/raw/master/doc/example/soar.vim)文件拷贝至${SyntasticInstalledPath}/syntax_checkers/sql目录下 * 修改${SyntasticInstalledPath}/plugin/syntastic/registry.vim文件,增加sql文件的检查工具,`'sql':['soar', 'sqlint']` ### 插件演示 ![Vim插件示例](https://raw.githubusercontent.com/XiaoMi/soar/master/doc/images/vim_plugin.png) ### 常见问题 #### 安装插件后无任何变化 安装了 Syntastic 没有任何显示,官方推荐通过如下配置来开启自动提示,不然用户无法看到SOAR给出的建议。 ```vim 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 ``` 如果soar二进制未在可执行文件查找路径下,或未添加可执行文件也会导致无法提供建议,可通过如下命令确认。 ```bash $ which soar /usr/local/bin/soar ``` ================================================ FILE: doc/environment.md ================================================ ## 集成环境 ![集成环境](https://raw.githubusercontent.com/XiaoMi/soar/master/doc/images/env.png) | 线上环境 | 测试环境 | 场景 | | --- | --- | --- | | 有 | 有 | 日常优化,完整的建议,推荐 | | 无 | 有 | 新申请资源,环境初始化测试 | | 无 | 无 | 盲测,试用,无EXPLAIN和索引建议 | | 有 | 无 | 用线上环境当测试环境,不推荐 | ## 线上环境 * 数据字典 * 数据采样 * EXPLAIN ## 测试环境 * 库表映射 * 语法检查 * 模拟执行 * 索引建议/去重 ## 注意 * 测试环境 MySQL 版本必须高于或等于线上环境 * 测试环境需要所有权限(建议通过[docker](https://hub.docker.com/_/mysql/)启动),线上环境需要只读(SELECT)权限。 ================================================ FILE: doc/example/digest_pt.py ================================================ #!/usr/bin/python -u #-*- coding: utf-8 -*- import sys, re, subprocess import os.path reload(sys) sys.setdefaultencoding("utf-8") SOAR_ARGS=["-ignore-rules=OK"] USE_DATABASE="" # 打印pt-query-digest的统计信息 def printStatInfo(buf): if buf.strip() == "": return if re.match("^# Query [0-9]", buf): sys.stdout.write(buf.split(":", 1)[0] + "\n") sys.stdout.write("\n```text\n") sys.stdout.write(buf) sys.stdout.write("```\n") # 打印每条SQL的SOAR结果 def printSqlAdvisor(buf): global USE_DATABASE buf = re.sub("\\\G$", "", USE_DATABASE + buf) if buf.strip() == "": return cmd = ["soar"] if len(SOAR_ARGS) > 0: cmd = cmd + SOAR_ARGS p = subprocess.Popen(["soar"], stdout=subprocess.PIPE, stdin=subprocess.PIPE) adv = p.communicate(input=buf)[0] # 清理环境 USE_DATABASE = "" # 删除第一行"# Query: xxxxx" try: adv = adv.split('\n', 1)[1] except: pass sys.stdout.write(adv + "\n") # 从统计信息中获取database信息 def getUseDB(line): global USE_DATABASE USE_DATABASE = "USE " + re.sub(' +', " ", line).split(" ")[2] + ";" def parsePtQueryDisget(f): statBuf = "" sqlBuf = "" for line in f: if line.strip() == "": continue if line.startswith("#"): if line.startswith("# Databases ") and not line.strip().endswith("more"): getUseDB(line) if re.match("^# Query [0-9]", line): # pt-query-digest的头部统计信息 if line.startswith("# Query 1:"): sys.stdout.write("# pt-query-digest统计信息" + "\n") printStatInfo(statBuf) statBuf = line else: statBuf += line else: if not line.strip().endswith("\G"): sqlBuf += line else: sqlBuf += line printStatInfo(statBuf) statBuf = "" printSqlAdvisor(sqlBuf) sqlBuf = "" def main(): global SOAR_ARGS if len(sys.argv) == 1: f = sys.stdin parsePtQueryDisget(f) else: if os.path.isfile(sys.argv[-1]): SOAR_ARGS = sys.argv[1:-1] f = open(sys.argv[-1]) else: SOAR_ARGS = sys.argv[1:] f = sys.stdin parsePtQueryDisget(f) if __name__ == '__main__': main() ================================================ FILE: doc/example/metalinter.json ================================================ { "Vendor": true, "DisableAll": true, "Enable": [ "gofmt", "goimports", "interfacer", "misspell", "unconvert", "gosimple", "golint", "structcheck", "deadcode", "ineffassign", "varcheck", "vet" ], "Exclude": [ "MagicWordSZjYPIDgod1M8XqYEwhsdlzv2SyAtjy8", "src/internal", "src/runtime" ], "Deadline": "5m" } ================================================ FILE: doc/example/metalinter.sh ================================================ #!/bin/bash METABIN=$(which gometalinter.v1) PROJECT_PATH=${GOPATH}/src/github.com/XiaoMi/soar/ if [ "x$METABIN" == "x" ]; then go get -u gopkg.in/alecthomas/gometalinter.v1 ${GOPATH}/bin/gometalinter.v1 --install fi UPDATE=$1 if [ "${UPDATE}X" != "X" ]; then ${GOPATH}/bin/gometalinter.v1 --config ${PROJECT_PATH}/doc/example/metalinter.json ./... | tr -d [0-9] | sort > ${PROJECT_PATH}/doc/example/metalinter.txt else cd ${PROJECT_PATH} && diff <(${GOPATH}/bin/gometalinter.v1 --config ${PROJECT_PATH}/doc/example/metalinter.json ./... | tr -d [0-9] | sort) <(cat ${PROJECT_PATH}/doc/example/metalinter.txt) fi ================================================ FILE: doc/example/metalinter.txt ================================================ ================================================ FILE: doc/example/revive.toml ================================================ ignoreGeneratedHeader = false severity = "error" confidence = 0.8 errorCode = 0 warningCode = 0 [rule.blank-imports] [rule.context-as-argument] [rule.dot-imports] [rule.error-return] [rule.error-strings] [rule.error-naming] [rule.exported] [rule.if-return] [rule.var-naming] [rule.package-comments] [rule.range] [rule.receiver-naming] [rule.indent-error-flow] [rule.superfluous-else] [rule.modifies-parameter] # This can be checked by other tools like megacheck [rule.unreachable-code] # Currently this makes too much noise, but should add it in # and perhaps ignore it in a few files #[rule.confusing-naming] # severity = "warning" #[rule.confusing-results] # severity = "warning" #[rule.unused-parameter] # severity = "warning" #[rule.deep-exit] # severity = "warning" #[rule.flag-parameter] # severity = "warning" # Adding these will slow down the linter # They are already provided by megacheck # [rule.unexported-return] # [rule.time-naming] # [rule.errorf] # Adding these will slow down the linter # Not sure if they are already provided by megacheck # [rule.var-declaration] # [rule.context-keys-type] ================================================ FILE: doc/example/slow.log.digest ================================================ # 13.7s user time, 20ms system time, 27.95M rss, 181.32M vsz # Current date: Thu May 17 15:24:49 2018 # Hostname: 127.0.0.1 # Files: slow.log # Overall: 75.28k total, 21 unique, 1.36 QPS, 0.22x concurrency __________ # Time range: 2018-05-17 00:01:47 to 15:24:47 # Attribute total min max avg 95% stddev median # ============ ======= ======= ======= ======= ======= ======= ======= # Exec time 12368s 20ms 6s 164ms 501ms 208ms 95ms # Lock time 2s 0 311us 30us 38us 5us 27us # Rows sent 21.79M 0 28.49k 303.58 49.17 2.44k 0.99 # Rows examine 103.77M 0 31.41k 1.41k 4.49k 2.96k 621.67 # Query size 8.58M 17 7.78k 119.54 143.84 32.94 112.70 # Profile # Rank Query ID Response time Calls R/Call V/M Item # ==== ================== ================ ===== ====== ===== ============ # 1 0x6F837C9DA962A07D 11374.6099 92.0% 67535 0.1684 0.27 SELECT test.table_? # 2 0x0B991403AD4E8932 803.2640 6.5% 5993 0.1340 0.24 SELECT test.table_? # MISC 0xMISC 190.1791 1.5% 1751 0.1086 0.0 <19 ITEMS> # Query 1: 1.22 QPS, 0.21x concurrency, ID 0x6F837C9DA962A07D at byte 6821409 # This item is included in the report because it matches --limit. # Scores: V/M = 0.27 # Time range: 2018-05-17 00:01:47 to 15:24:47 # Attribute pct total min max avg 95% stddev median # ============ === ======= ======= ======= ======= ======= ======= ======= # Count 89 67535 # Exec time 91 11375s 20ms 6s 168ms 501ms 212ms 100ms # Lock time 88 2s 20us 221us 29us 38us 5us 27us # Rows sent 0 65.95k 1 1 1 1 0 1 # Rows examine 72 75.13M 0 31.41k 1.14k 3.52k 1.89k 592.07 # Query size 88 7.61M 114 119 118.23 118.34 2.50 112.70 # String: # Databases test... (50646/74%)... 2 more # Hosts 127.0.0.1 (13617/20%)... 4 more # Users test_r # Query_time distribution # 1us # 10us # 100us # 1ms # 10ms ############################################################ # 100ms ################################################################ # 1s # # 10s+ # Tables # SHOW TABLE STATUS FROM `test` LIKE 'table_78'\G # SHOW CREATE TABLE `test`.`table_78`\G # EXPLAIN /*!50100 PARTITIONS*/ SELECT COUNT(*) AS `count` FROM test.table_78 WHERE `id` = 824076488 AND `last_modify` > 1526044213 AND `type` = 6\G # Query 2: 0.11 QPS, 0.01x concurrency, ID 0x0B991403AD4E8932 at byte 1691609 # This item is included in the report because it matches --limit. # Scores: V/M = 0.24 # Time range: 2018-05-17 00:01:54 to 15:24:43 # Attribute pct total min max avg 95% stddev median # ============ === ======= ======= ======= ======= ======= ======= ======= # Count 7 5993 # Exec time 6 803s 20ms 1s 134ms 552ms 181ms 56ms # Lock time 9 206ms 26us 179us 34us 44us 5us 31us # Rows sent 1 290.64k 7 50 49.66 49.17 2.98 49.17 # Rows examine 6 7.13M 7 5.79k 1.22k 4.27k 1.40k 563.87 # Query size 9 850.97k 142 154 145.40 143.84 1.98 143.84 # String: # Databases test... (4280/71%)... 2 more # Hosts 127.0.0.1 (1246/20%), 127.0.0.2 (1229/20%)... 3 more # Users test_r # Query_time distribution # 1us # 10us # 100us # 1ms # 10ms ################################################################ # 100ms #################################### # 1s # # 10s+ # Tables # SHOW TABLE STATUS FROM `test` LIKE 'table_83'\G # SHOW CREATE TABLE `test`.`table_83`\G # EXPLAIN /*!50100 PARTITIONS*/ SELECT * FROM test.table_83 WHERE `id` = 68211602 AND `last_modify` < 1526495341 AND `type` in ('6') order by `last_modify` desc LIMIT 0,50\G ================================================ FILE: doc/example/soar.vim ================================================ "============================================================================ "File: soar.vim "Description: Syntax checking plugin for syntastic "Maintainer: Pengxiang Li "License: MIT "============================================================================ if exists('g:loaded_syntastic_sql_soar_checker') finish endif let g:loaded_syntastic_sql_soar_checker= 1 let s:save_cpo = &cpo set cpo&vim function! SyntaxCheckers_sql_soar_GetLocList() dict let makeprg = self.makeprgBuild({ \ 'args_after': '-report-type lint -query '}) let errorformat = '%f:%l:%m' return SyntasticMake({ \ 'makeprg': makeprg, \ 'errorformat': errorformat, \ 'defaults': {'type': 'W'}, \ 'subtype': 'Style', \ 'returns': [0, 1] }) endfunction call g:SyntasticRegistry.CreateAndRegisterChecker({ \ 'filetype': 'sql', \ 'name': 'soar'}) let &cpo = s:save_cpo unlet s:save_cpo " vim: set sw=4 sts=4 et fdm=marker: ================================================ FILE: doc/explain.md ================================================ ## EXPLAIN信息解读 * [EXPLAIN语法](https://dev.mysql.com/doc/refman/5.7/en/explain.html) * [EXPLAIN输出信息](https://dev.mysql.com/doc/refman/5.7/en/explain-output.html) ### SELECT转换 指定了线上环境时SOAR会到线上环境进行EXPLAIN,然后对线上执行EXPLAIN的结果进行分析。由于低版本的MySQL不支持对INSERT, UPDATE, DELETE, REPLACE进行分析,SOAR会自动将这些类型的查询请求转换为SELECT请求再执行EXPLAIN信息。 另外当线上环境设置了read\_only或super\_readonly时即使是高版本的MySQL也无法对更新请求执行EXPLAIN。需要进行SELECT转换。 ### 文本格式 SOAR也支持用户直接拷贝粘贴已有的EXPLAIN文本信息,格式可以是传统格式,\G输出的Verical格式,也可以是JSON格式。 JSON格式的EXPLAIN包含的内容很丰富,但不便于人查看,信息解读的时候会将JSON和Vertical格式统一转换成传统格式。Golang处理JSON格式需要提前定义结构体,这里不得不向[gojson](https://github.com/ChimeraCoder/gojson)献出膝盖,要是没有这个工具也许我们暂时会放弃对JSON格式的支持。 ### Filtered 表示此查询条件所过滤的数据的百分比。低版本的MySQL EXPLAIN信息不包含Filtered字段,SOAR会按 `filtered = rows/total_rows` 计算补充。 5.7之前的版本Filtered计算可能出现大于100%的[BUG](https://bugs.mysql.com/bug.php?id=34124),为了不对用户产生困扰,soar会将大于100%的Filered化整为100%。 ### Scalability Scalability表示单表查询的运算复杂度,是参考[explain-analyzer](https://github.com/Preetam/explain-analyzer)项目添加的。Scalability是对access\_type的映射表,由于是单表查询,所以最大复杂度为O(n)。 | Access Type | Scalability | | --- | --- | | ALL | O(n) | | index | O(n) | | range | O(log n)+ | | index\_subquery | O(log n)+ | | unique\_subquery | O(log n)+ | | index\_merge | O(log n)+ | | ref\_or\_null | O(log n)+ | | fulltext | O(log n)+ | | ref | O(log n) | | eq\_ref | O(log n) | | const | O(1) | | system | O(1) | ================================================ FILE: doc/heuristic.md ================================================ # 启发式规则建议 [toc] ## 建议使用 AS 关键字显示声明一个别名 * **Item**:ALI.001 * **Severity**:L0 * **Content**:在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 * **Case**: ```sql select name from tbl t1 where id < 1000 ``` ## 不建议给列通配符'\*'设置别名 * **Item**:ALI.002 * **Severity**:L8 * **Content**:例: "SELECT tbl.\* col1, col2"上面这条 SQL 给列通配符设置了别名,这样的SQL可能存在逻辑错误。您可能意在查询 col1, 但是代替它的是重命名的是 tbl 的最后一列。 * **Case**: ```sql select tbl.* as c1,c2,c3 from tbl where id < 1000 ``` ## 别名不要与表或列的名字相同 * **Item**:ALI.003 * **Severity**:L1 * **Content**:表或列的别名与其真实名称相同, 这样的别名会使得查询更难去分辨。 * **Case**: ```sql select name from tbl as tbl where id < 1000 ``` ## 修改表的默认字符集不会改表各个字段的字符集 * **Item**:ALT.001 * **Severity**:L4 * **Content**:很多初学者会将 ALTER TABLE tbl\_name [DEFAULT] CHARACTER SET 'UTF8' 误认为会修改所有字段的字符集,但实际上它只会影响后续新增的字段不会改表已有字段的字符集。如果想修改整张表所有字段的字符集建议使用 ALTER TABLE tbl\_name CONVERT TO CHARACTER SET charset\_name; * **Case**: ```sql ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name; ``` ## 同一张表的多条 ALTER 请求建议合为一条 * **Item**:ALT.002 * **Severity**:L2 * **Content**:每次表结构变更对线上服务都会产生影响,即使是能够通过在线工具进行调整也请尽量通过合并 ALTER 请求的试减少操作次数。 * **Case**: ```sql ALTER TABLE tbl ADD COLUMN col int, ADD INDEX idx_col (`col`); ``` ## 删除列为高危操作,操作前请注意检查业务逻辑是否还有依赖 * **Item**:ALT.003 * **Severity**:L0 * **Content**:如业务逻辑依赖未完全消除,列被删除后可能导致数据无法写入或无法查询到已删除列数据导致程序异常的情况。这种情况下即使通过备份数据回滚也会丢失用户请求写入的数据。 * **Case**: ```sql ALTER TABLE tbl DROP COLUMN col; ``` ## 删除主键和外键为高危操作,操作前请与 DBA 确认影响 * **Item**:ALT.004 * **Severity**:L0 * **Content**:主键和外键为关系型数据库中两种重要约束,删除已有约束会打破已有业务逻辑,操作前请业务开发与 DBA 确认影响,三思而行。 * **Case**: ```sql ALTER TABLE tbl DROP PRIMARY KEY; ``` ## 不建议使用前项通配符查找 * **Item**:ARG.001 * **Severity**:L4 * **Content**:例如 "%foo",查询参数有一个前项通配符的情况无法使用已有索引。 * **Case**: ```sql select c1,c2,c3 from tbl where name like '%foo' ``` ## 没有通配符的 LIKE 查询 * **Item**:ARG.002 * **Severity**:L1 * **Content**:不包含通配符的 LIKE 查询可能存在逻辑错误,因为逻辑上它与等值查询相同。 * **Case**: ```sql select c1,c2,c3 from tbl where name like 'foo' ``` ## 参数比较包含隐式转换,无法使用索引 * **Item**:ARG.003 * **Severity**:L4 * **Content**:隐式类型转换有无法命中索引的风险,在高并发、大数据量的情况下,命不中索引带来的后果非常严重。 * **Case**: ```sql SELECT * FROM sakila.film WHERE length >= '60'; ``` ## IN (NULL)/NOT IN (NULL) 永远非真 * **Item**:ARG.004 * **Severity**:L4 * **Content**:正确的作法是 col IN ('val1', 'val2', 'val3') OR col IS NULL * **Case**: ```sql SELECT * FROM tb WHERE col IN (NULL); ``` ## IN 要慎用,元素过多会导致全表扫描 * **Item**:ARG.005 * **Severity**:L1 * **Content**: 如:select id from t where num in(1,2,3)对于连续的数值,能用 BETWEEN 就不要用 IN 了:select id from t where num between 1 and 3。而当 IN 值过多时 MySQL 也可能会进入全表扫描导致性能急剧下降。 * **Case**: ```sql select id from t where num in(1,2,3) ``` ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item**:ARG.006 * **Severity**:L1 * **Content**:使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; * **Case**: ```sql select id from t where num is null ``` ## 避免使用模式匹配 * **Item**:ARG.007 * **Severity**:L3 * **Content**:性能问题是使用模式匹配操作符的最大缺点。使用 LIKE 或正则表达式进行模式匹配进行查询的另一个问题,是可能会返回意料之外的结果。最好的方案就是使用特殊的搜索引擎技术来替代 SQL,比如 Apache Lucene。另一个可选方案是将结果保存起来从而减少重复的搜索开销。如果一定要使用SQL,请考虑在 MySQL 中使用像 FULLTEXT 索引这样的第三方扩展。但更广泛地说,您不一定要使用SQL来解决所有问题。 * **Case**: ```sql select c_id,c2,c3 from tbl where c2 like 'test%' ``` ## OR 查询索引列时请尽量使用 IN 谓词 * **Item**:ARG.008 * **Severity**:L1 * **Content**:IN-list 谓词可以用于索引检索,并且优化器可以对 IN-list 进行排序,以匹配索引的排序序列,从而获得更有效的检索。请注意,IN-list 必须只包含常量,或在查询块执行期间保持常量的值,例如外引用。 * **Case**: ```sql SELECT c1,c2,c3 FROM tbl WHERE c1 = 14 OR c1 = 17 ``` ## 引号中的字符串开头或结尾包含空格 * **Item**:ARG.009 * **Severity**:L1 * **Content**:如果 VARCHAR 列的前后存在空格将可能引起逻辑问题,如在 MySQL 5.5中 'a' 和 'a ' 可能会在查询中被认为是相同的值。 * **Case**: ```sql SELECT 'abc ' ``` ## 不要使用 hint,如:sql\_no\_cache, force index, ignore key, straight join等 * **Item**:ARG.010 * **Severity**:L1 * **Content**:hint 是用来强制 SQL 按照某个执行计划来执行,但随着数据量变化我们无法保证自己当初的预判是正确的。 * **Case**: ```sql SELECT * FROM t1 USE INDEX (i1) ORDER BY a; ``` ## 不要使用负向查询,如:NOT IN/NOT LIKE * **Item**:ARG.011 * **Severity**:L3 * **Content**:请尽量不要使用负向查询,这将导致全表扫描,对查询性能影响较大。 * **Case**: ```sql select id from t where num not in(1,2,3); ``` ## 一次性 INSERT/REPLACE 的数据过多 * **Item**:ARG.012 * **Severity**:L2 * **Content**:单条 INSERT/REPLACE 语句批量插入大量数据性能较差,甚至可能导致从库同步延迟。为了提升性能,减少批量写入数据对从库同步延时的影响,建议采用分批次插入的方法。 * **Case**: ```sql INSERT INTO tb (a) VALUES (1), (2) ``` ## DDL 语句中使用了中文全角引号 * **Item**:ARG.013 * **Severity**:L0 * **Content**:DDL 语句中使用了中文全角引号“”或‘’,这可能是书写错误,请确认是否符合预期。 * **Case**: ```sql CREATE TABLE tb (a varchar(10) default '“”' ``` ## IN 条件中存在列名,可能导致数据匹配范围扩大 * **Item**:ARG.014 * **Severity**:L4 * **Content**:如:delete from t where id in(1, 2, id) 可能会导致全表数据误删除。请仔细检查 IN 条件的正确性。 * **Case**: ```sql select id from t where id in(1, 2, id) ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item**:CLA.001 * **Severity**:L4 * **Content**:SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 * **Case**: ```sql select id from tbl ``` ## 不建议使用 ORDER BY RAND() * **Item**:CLA.002 * **Severity**:L3 * **Content**:ORDER BY RAND() 是从结果集中检索随机行的一种非常低效的方法,因为它会对整个结果进行排序并丢弃其大部分数据。 * **Case**: ```sql select name from tbl where id < 1000 order by rand(number) ``` ## 不建议使用带 OFFSET 的LIMIT 查询 * **Item**:CLA.003 * **Severity**:L2 * **Content**:使用 LIMIT 和 OFFSET 对结果集分页的复杂度是 O(n^2),并且会随着数据增大而导致性能问题。采用“书签”扫描的方法实现分页效率更高。 * **Case**: ```sql select c1,c2 from tbl where name=xx order by number limit 1 offset 20 ``` ## 不建议对常量进行 GROUP BY * **Item**:CLA.004 * **Severity**:L2 * **Content**:GROUP BY 1 表示按第一列进行 GROUP BY。如果在 GROUP BY 子句中使用数字,而不是表达式或列名称,当查询列顺序改变时,可能会导致问题。 * **Case**: ```sql select col1,col2 from tbl group by 1 ``` ## ORDER BY 常数列没有任何意义 * **Item**:CLA.005 * **Severity**:L2 * **Content**:SQL 逻辑上可能存在错误; 最多只是一个无用的操作,不会更改查询结果。 * **Case**: ```sql select id from test where id=1 order by id ``` ## 在不同的表中 GROUP BY 或 ORDER BY * **Item**:CLA.006 * **Severity**:L4 * **Content**:这将强制使用临时表和 filesort,可能产生巨大性能隐患,并且可能消耗大量内存和磁盘上的临时空间。 * **Case**: ```sql select tb1.col, tb2.col from tb1, tb2 where id=1 group by tb1.col, tb2.col ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item**:CLA.008 * **Severity**:L2 * **Content**:默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 * **Case**: ```sql select c1,c2,c3 from t1 where c1='foo' group by c2 ``` ## ORDER BY 的条件为表达式 * **Item**:CLA.009 * **Severity**:L2 * **Content**:当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 * **Case**: ```sql select description from film where title ='ACADEMY DINOSAUR' order by length-language_id; ``` ## GROUP BY 的条件为表达式 * **Item**:CLA.010 * **Severity**:L2 * **Content**:当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 * **Case**: ```sql select description from film where title ='ACADEMY DINOSAUR' GROUP BY length-language_id; ``` ## 建议为表添加注释 * **Item**:CLA.011 * **Severity**:L1 * **Content**:为表添加注释能够使得表的意义更明确,从而为日后的维护带来极大的便利。 * **Case**: ```sql CREATE TABLE `test1` (`ID` bigint(20) NOT NULL AUTO_INCREMENT,`c1` varchar(128) DEFAULT NULL,PRIMARY KEY (`ID`)) ENGINE=InnoDB DEFAULT CHARSET=utf8 ``` ## 将复杂的裹脚布式查询分解成几个简单的查询 * **Item**:CLA.012 * **Severity**:L2 * **Content**:SQL是一门极具表现力的语言,您可以在单个SQL查询或者单条语句中完成很多事情。但这并不意味着必须强制只使用一行代码,或者认为使用一行代码就搞定每个任务是个好主意。通过一个查询来获得所有结果的常见后果是得到了一个笛卡儿积。当查询中的两张表之间没有条件限制它们的关系时,就会发生这种情况。没有对应的限制而直接使用两张表进行联结查询,就会得到第一张表中的每一行和第二张表中的每一行的一个组合。每一个这样的组合就会成为结果集中的一行,最终您就会得到一个行数很多的结果集。重要的是要考虑这些查询很难编写、难以修改和难以调试。数据库查询请求的日益增加应该是预料之中的事。经理们想要更复杂的报告以及在用户界面上添加更多的字段。如果您的设计很复杂,并且是一个单一查询,要扩展它们就会很费时费力。不论对您还是项目来说,时间花在这些事情上面不值得。将复杂的意大利面条式查询分解成几个简单的查询。当您拆分一个复杂的SQL查询时,得到的结果可能是很多类似的查询,可能仅仅在数据类型上有所不同。编写所有的这些查询是很乏味的,因此,最好能够有个程序自动生成这些代码。SQL代码生成是一个很好的应用。尽管SQL支持用一行代码解决复杂的问题,但也别做不切实际的事情。 * **Case**: ```sql 这是一条很长很长的 SQL,案例略。 ``` ## 不建议使用 HAVING 子句 * **Item**:CLA.013 * **Severity**:L3 * **Content**:将查询的 HAVING 子句改写为 WHERE 中的查询条件,可以在查询处理期间使用索引。 * **Case**: ```sql SELECT s.c_id,count(s.c_id) FROM s where c = test GROUP BY s.c_id HAVING s.c_id <> '1660' AND s.c_id <> '2' order by s.c_id ``` ## 删除全表时建议使用 TRUNCATE 替代 DELETE * **Item**:CLA.014 * **Severity**:L2 * **Content**:删除全表时建议使用 TRUNCATE 替代 DELETE * **Case**: ```sql delete from tbl ``` ## UPDATE 未指定 WHERE 条件 * **Item**:CLA.015 * **Severity**:L4 * **Content**:UPDATE 不指定 WHERE 条件一般是致命的,请您三思后行 * **Case**: ```sql update tbl set col=1 ``` ## 不要 UPDATE 主键 * **Item**:CLA.016 * **Severity**:L2 * **Content**:主键是数据表中记录的唯一标识符,不建议频繁更新主键列,这将影响元数据统计信息进而影响正常的查询。 * **Case**: ```sql update tbl set col=1 ``` ## 不建议使用 SELECT \* 类型查询 * **Item**:COL.001 * **Severity**:L1 * **Content**:当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 * **Case**: ```sql select * from tbl where id=1 ``` ## INSERT/REPLACE 未指定列名 * **Item**:COL.002 * **Severity**:L2 * **Content**:当表结构发生变更,如果 INSERT 或 REPLACE 请求不明确指定列名,请求的结果将会与预想的不同; 建议使用 “INSERT INTO tbl(col1,col2)VALUES ...” 代替。 * **Case**: ```sql insert into tbl values(1,'name') ``` ## 建议修改自增 ID 为无符号类型 * **Item**:COL.003 * **Severity**:L2 * **Content**:建议修改自增 ID 为无符号类型 * **Case**: ```sql create table test(`id` int(11) NOT NULL AUTO_INCREMENT) ``` ## 请为列添加默认值 * **Item**:COL.004 * **Severity**:L1 * **Content**:请为列添加默认值,如果是 ALTER 操作,请不要忘记将原字段的默认值写上。字段无默认值,当表较大时无法在线变更表结构。 * **Case**: ```sql CREATE TABLE tbl (col int) ENGINE=InnoDB; ``` ## 列未添加注释 * **Item**:COL.005 * **Severity**:L1 * **Content**:建议对表中每个列添加注释,来明确每个列在表中的含义及作用。 * **Case**: ```sql CREATE TABLE tbl (col int) ENGINE=InnoDB; ``` ## 表中包含有太多的列 * **Item**:COL.006 * **Severity**:L3 * **Content**:表中包含有太多的列 * **Case**: ```sql CREATE TABLE tbl ( cols ....); ``` ## 表中包含有太多的 text/blob 列 * **Item**:COL.007 * **Severity**:L3 * **Content**:表中包含超过2个的 text/blob 列 * **Case**: ```sql CREATE TABLE tbl ( cols ....); ``` ## 可使用 VARCHAR 代替 CHAR, VARBINARY 代替 BINARY * **Item**:COL.008 * **Severity**:L1 * **Content**:为首先变长字段存储空间小,可以节省存储空间。其次对于查询来说,在一个相对较小的字段内搜索效率显然要高些。 * **Case**: ```sql create table t1(id int,name char(20),last_time date) ``` ## 建议使用精确的数据类型 * **Item**:COL.009 * **Severity**:L2 * **Content**:实际上,任何使用 FLOAT, REAL 或 DOUBLE PRECISION 数据类型的设计都有可能是反模式。大多数应用程序使用的浮点数的取值范围并不需要达到IEEE 754标准所定义的最大/最小区间。在计算总量时,非精确浮点数所积累的影响是严重的。使用 SQL 中的 NUMERIC 或 DECIMAL 类型来代替 FLOAT 及其类似的数据类型进行固定精度的小数存储。这些数据类型精确地根据您定义这一列时指定的精度来存储数据。尽可能不要使用浮点数。 * **Case**: ```sql CREATE TABLE tab2 (p_id BIGINT UNSIGNED NOT NULL,a_id BIGINT UNSIGNED NOT NULL,hours float not null,PRIMARY KEY (p_id, a_id)) ``` ## 不建议使用 ENUM/BIT/SET 数据类型 * **Item**:COL.010 * **Severity**:L2 * **Content**:ENUM 定义了列中值的类型,使用字符串表示 ENUM 里的值时,实际存储在列中的数据是这些值在定义时的序数。因此,这列的数据是字节对齐的,当您进行一次排序查询时,结果是按照实际存储的序数值排序的,而不是按字符串值的字母顺序排序的。这可能不是您所希望的。没有什么语法支持从 ENUM 或者 check 约束中添加或删除一个值;您只能使用一个新的集合重新定义这一列。如果您打算废弃一个选项,您可能会为历史数据而烦恼。作为一种策略,改变元数据——也就是说,改变表和列的定义——应该是不常见的,并且要注意测试和质量保证。有一个更好的解决方案来约束一列中的可选值:创建一张检查表,每一行包含一个允许在列中出现的候选值;然后在引用新表的旧表上声明一个外键约束。 * **Case**: ```sql create table tab1(status ENUM('new','in progress','fixed')) ``` ## 当需要唯一约束时才使用 NULL,仅当列不能有缺失值时才使用 NOT NULL * **Item**:COL.011 * **Severity**:L0 * **Content**:NULL 和0是不同的,10乘以 NULL 还是 NULL。NULL 和空字符串是不一样的。将一个字符串和标准 SQL 中的 NULL 联合起来的结果还是 NULL。NULL 和 FALSE 也是不同的。AND、OR 和 NOT 这三个布尔操作如果涉及 NULL,其结果也让很多人感到困惑。当您将一列声明为 NOT NULL 时,也就是说这列中的每一个值都必须存在且是有意义的。使用 NULL 来表示任意类型不存在的空值。 当您将一列声明为 NOT NULL 时,也就是说这列中的每一个值都必须存在且是有意义的。 * **Case**: ```sql select c1,c2,c3 from tbl where c4 is null or c4 <> 1 ``` ## TEXT、BLOB 和 JSON 类型的字段不建议设置为 NOT NULL * **Item**:COL.012 * **Severity**:L5 * **Content**:TEXT、BLOB 和 JSON 类型的字段无法指定非 NULL 的默认值,如果添加了 NOT NULL 限制,写入数据时又未对该字段指定值可能导致写入失败。 * **Case**: ```sql CREATE TABLE `tb`(`c` longblob NOT NULL); ``` ## TIMESTAMP 类型默认值检查异常 * **Item**:COL.013 * **Severity**:L4 * **Content**:TIMESTAMP 类型建议设置默认值,且不建议使用 0 或 0000-00-00 00:00:00 作为默认值。可以考虑使用 1970-08-02 01:01:01 * **Case**: ```sql CREATE TABLE tbl( `id` bigint not null, `create_time` timestamp); ``` ## 为列指定了字符集 * **Item**:COL.014 * **Severity**:L5 * **Content**:建议列与表使用同一个字符集,不要单独指定列的字符集。 * **Case**: ```sql CREATE TABLE `tb2` ( `id` int(11) DEFAULT NULL, `col` char(10) CHARACTER SET utf8 DEFAULT NULL) ``` ## TEXT、BLOB 和 JSON 类型的字段不可指定非 NULL 的默认值 * **Item**:COL.015 * **Severity**:L4 * **Content**:MySQL 数据库中 TEXT、BLOB 和 JSON 类型的字段不可指定非 NULL 的默认值。TEXT最大长度为2^16-1个字符,MEDIUMTEXT最大长度为2^32-1个字符,LONGTEXT最大长度为2^64-1个字符。 * **Case**: ```sql CREATE TABLE `tbl` (`c` blob DEFAULT NULL); ``` ## 整型定义建议采用 INT(10) 或 BIGINT(20) * **Item**:COL.016 * **Severity**:L1 * **Content**:INT(M) 在 integer 数据类型中,M 表示最大显示宽度。 在 INT(M) 中,M 的值跟 INT(M) 所占多少存储空间并无任何关系。 INT(3)、INT(4)、INT(8) 在磁盘上都是占用 4 bytes 的存储空间。高版本 MySQL 已经不推荐设置整数显示宽度。 * **Case**: ```sql CREATE TABLE tab (a INT(1)); ``` ## VARCHAR 定义长度过长 * **Item**:COL.017 * **Severity**:L2 * **Content**:varchar 是可变长字符串,不预先分配存储空间,长度不要超过1024,如果存储长度过长 MySQL 将定义字段类型为 text,独立出来一张表,用主键来对应,避免影响其它字段索引效率。 * **Case**: ```sql CREATE TABLE tab (a varchar(3500)); ``` ## 建表语句中使用了不推荐的字段类型 * **Item**:COL.018 * **Severity**:L9 * **Content**:以下字段类型不被推荐使用:boolean * **Case**: ```sql CREATE TABLE tab (a BOOLEAN); ``` ## 不建议使用精度在秒级以下的时间数据类型 * **Item**:COL.019 * **Severity**:L1 * **Content**:使用高精度的时间数据类型带来的存储空间消耗相对较大;MySQL 在5.6.4以上才可以支持精确到微秒的时间数据类型,使用时需要考虑版本兼容问题。 * **Case**: ```sql CREATE TABLE t1 (t TIME(3), dt DATETIME(6)); ``` ## 消除不必要的 DISTINCT 条件 * **Item**:DIS.001 * **Severity**:L1 * **Content**:太多DISTINCT条件是复杂的裹脚布式查询的症状。考虑将复杂查询分解成许多简单的查询,并减少DISTINCT条件的数量。如果主键列是列的结果集的一部分,则DISTINCT条件可能没有影响。 * **Case**: ```sql SELECT DISTINCT c.c_id,count(DISTINCT c.c_name),count(DISTINCT c.c_e),count(DISTINCT c.c_n),count(DISTINCT c.c_me),c.c_d FROM (select distinct id, name from B) as e WHERE e.country_id = c.country_id ``` ## COUNT(DISTINCT) 多列时结果可能和你预想的不同 * **Item**:DIS.002 * **Severity**:L3 * **Content**:COUNT(DISTINCT col) 计算该列除NULL之外的不重复行数,注意 COUNT(DISTINCT col, col2) 如果其中一列全为 NULL 那么即使另一列有不同的值,也返回0。 * **Case**: ```sql SELECT COUNT(DISTINCT col, col2) FROM tbl; ``` ## DISTINCT \* 对有主键的表没有意义 * **Item**:DIS.003 * **Severity**:L3 * **Content**:当表已经有主键时,对所有列进行 DISTINCT 的输出结果与不进行 DISTINCT 操作的结果相同,请不要画蛇添足。 * **Case**: ```sql SELECT DISTINCT * FROM film; ``` ## 避免在 WHERE 条件中使用函数或其他运算符 * **Item**:FUN.001 * **Severity**:L2 * **Content**:虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。 * **Case**: ```sql select id from t where substring(name,1,3)='abc' ``` ## 指定了 WHERE 条件或非 MyISAM 引擎时使用 COUNT(\*) 操作性能不佳 * **Item**:FUN.002 * **Severity**:L1 * **Content**:COUNT(\*) 的作用是统计表行数,COUNT(COL) 的作用是统计指定列非 NULL 的行数。MyISAM 表对于 COUNT(\*) 统计全表行数进行了特殊的优化,通常情况下非常快。但对于非 MyISAM 表或指定了某些 WHERE 条件,COUNT(\*) 操作需要扫描大量的行才能获取精确的结果,性能也因此不佳。有时候某些业务场景并不需要完全精确的 COUNT 值,此时可以用近似值来代替。EXPLAIN 出来的优化器估算的行数就是一个不错的近似值,执行 EXPLAIN 并不需要真正去执行查询,所以成本很低。 * **Case**: ```sql SELECT c3, COUNT(*) AS accounts FROM tab where c2 < 10000 GROUP BY c3 ORDER BY num ``` ## 使用了合并为可空列的字符串连接 * **Item**:FUN.003 * **Severity**:L3 * **Content**:在一些查询请求中,您需要强制让某一列或者某个表达式返回非 NULL 的值,从而让查询逻辑变得更简单,但又不想将这个值存下来。可以使用 COALESCE() 函数来构造连接的表达式,这样即使是空值列也不会使整表达式变为 NULL。 * **Case**: ```sql select c1 || coalesce(' ' || c2 || ' ', ' ') || c3 as c from tbl ``` ## 不建议使用 SYSDATE() 函数 * **Item**:FUN.004 * **Severity**:L4 * **Content**:SYSDATE() 函数可能导致主从数据不一致,请使用 NOW() 函数替代 SYSDATE()。 * **Case**: ```sql SELECT SYSDATE(); ``` ## 不建议使用 COUNT(col) 或 COUNT(常量) * **Item**:FUN.005 * **Severity**:L1 * **Content**:不要使用 COUNT(col) 或 COUNT(常量) 来替代 COUNT(\*), COUNT(\*) 是 SQL92 定义的标准统计行数的方法,跟数据无关,跟 NULL 和非 NULL 也无关。 * **Case**: ```sql SELECT COUNT(1) FROM tbl; ``` ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item**:FUN.006 * **Severity**:L1 * **Content**:当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl * **Case**: ```sql SELECT SUM(COL) FROM tbl; ``` ## 不建议使用触发器 * **Item**:FUN.007 * **Severity**:L1 * **Content**:触发器的执行没有反馈和日志,隐藏了实际的执行步骤,当数据库出现问题是,不能通过慢日志分析触发器的具体执行情况,不易发现问题。在MySQL中,触发器不能临时关闭或打开,在数据迁移或数据恢复等场景下,需要临时drop触发器,可能影响到生产环境。 * **Case**: ```sql CREATE TRIGGER t1 AFTER INSERT ON work FOR EACH ROW INSERT INTO time VALUES(NOW()); ``` ## 不建议使用存储过程 * **Item**:FUN.008 * **Severity**:L1 * **Content**:存储过程无版本控制,配合业务的存储过程升级很难做到业务无感知。存储过程在拓展和移植上也存在问题。 * **Case**: ```sql CREATE PROCEDURE simpleproc (OUT param1 INT); ``` ## 不建议使用自定义函数 * **Item**:FUN.009 * **Severity**:L1 * **Content**:不建议使用自定义函数 * **Case**: ```sql CREATE FUNCTION hello (s CHAR(20)); ``` ## 不建议对等值查询列使用 GROUP BY * **Item**:GRP.001 * **Severity**:L2 * **Content**:GROUP BY 中的列在前面的 WHERE 条件中使用了等值查询,对这样的列进行 GROUP BY 意义不大。 * **Case**: ```sql select film_id, title from film where release_year='2006' group by release_year ``` ## JOIN 语句混用逗号和 ANSI 模式 * **Item**:JOI.001 * **Severity**:L2 * **Content**:表连接的时候混用逗号和 ANSI JOIN 不便于人类理解,并且MySQL不同版本的表连接行为和优先级均有所不同,当 MySQL 版本变化后可能会引入错误。 * **Case**: ```sql select c1,c2,c3 from t1,t2 join t3 on t1.c1=t2.c1,t1.c3=t3,c1 where id>1000 ``` ## 同一张表被连接两次 * **Item**:JOI.002 * **Severity**:L4 * **Content**:相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。 * **Case**: ```sql select tb1.col from (tb1, tb2) join tb2 on tb1.id=tb.id where tb1.id=1 ``` ## OUTER JOIN 失效 * **Item**:JOI.003 * **Severity**:L4 * **Content**:由于 WHERE 条件错误使得 OUTER JOIN 的外部表无数据返回,这会将查询隐式转换为 INNER JOIN 。如:select c from L left join R using(c) where L.a=5 and R.b=10。这种 SQL 逻辑上可能存在错误或程序员对 OUTER JOIN 如何工作存在误解,因为 LEFT/RIGHT JOIN 是 LEFT/RIGHT OUTER JOIN 的缩写。 * **Case**: ```sql select c1,c2,c3 from t1 left outer join t2 using(c1) where t1.c2=2 and t2.c3=4 ``` ## 不建议使用排它 JOIN * **Item**:JOI.004 * **Severity**:L4 * **Content**:只在右侧表为 NULL 的带 WHERE 子句的 LEFT OUTER JOIN 语句,有可能是在WHERE子句中使用错误的列,如:“... FROM l LEFT OUTER JOIN r ON l.l = r.r WHERE r.z IS NULL”,这个查询正确的逻辑可能是 WHERE r.r IS NULL。 * **Case**: ```sql select c1,c2,c3 from t1 left outer join t2 on t1.c1=t2.c1 where t2.c2 is null ``` ## 减少 JOIN 的数量 * **Item**:JOI.005 * **Severity**:L2 * **Content**:太多的 JOIN 是复杂的裹脚布式查询的症状。考虑将复杂查询分解成许多简单的查询,并减少 JOIN 的数量。 * **Case**: ```sql select bp1.p_id, b1.d_d as l, b1.b_id from b1 join bp1 on (b1.b_id = bp1.b_id) left outer join (b1 as b2 join bp2 on (b2.b_id = bp2.b_id)) on (bp1.p_id = bp2.p_id ) join bp21 on (b1.b_id = bp1.b_id) join bp31 on (b1.b_id = bp1.b_id) join bp41 on (b1.b_id = bp1.b_id) where b2.b_id = 0 ``` ## 将嵌套查询重写为 JOIN 通常会导致更高效的执行和更有效的优化 * **Item**:JOI.006 * **Severity**:L4 * **Content**:一般来说,非嵌套子查询总是用于关联子查询,最多是来自FROM子句中的一个表,这些子查询用于 ANY, ALL 和 EXISTS 的谓词。如果可以根据查询语义决定子查询最多返回一个行,那么一个不相关的子查询或来自FROM子句中的多个表的子查询就被压平了。 * **Case**: ```sql SELECT s,p,d FROM tbl WHERE p.p_id = (SELECT s.p_id FROM tbl WHERE s.c_id = 100996 AND s.q = 1 ) ``` ## 不建议使用联表删除或更新 * **Item**:JOI.007 * **Severity**:L4 * **Content**:当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 * **Case**: ```sql UPDATE users u LEFT JOIN hobby h ON u.id = h.uid SET u.name = 'pianoboy' WHERE h.hobby = 'piano'; ``` ## 不要使用跨数据库的 JOIN 查询 * **Item**:JOI.008 * **Severity**:L4 * **Content**:一般来说,跨数据库的 JOIN 查询意味着查询语句跨越了两个不同的子系统,这可能意味着系统耦合度过高或库表结构设计不合理。 * **Case**: ```sql SELECT s,p,d FROM tbl WHERE p.p_id = (SELECT s.p_id FROM tbl WHERE s.c_id = 100996 AND s.q = 1 ) ``` ## 建议使用自增列作为主键,如使用联合自增主键时请将自增键作为第一列 * **Item**:KEY.001 * **Severity**:L2 * **Content**:建议使用自增列作为主键,如使用联合自增主键时请将自增键作为第一列 * **Case**: ```sql create table test(`id` int(11) NOT NULL PRIMARY KEY (`id`)) ``` ## 无主键或唯一键,无法在线变更表结构 * **Item**:KEY.002 * **Severity**:L4 * **Content**:无主键或唯一键,无法在线变更表结构 * **Case**: ```sql create table test(col varchar(5000)) ``` ## 避免外键等递归关系 * **Item**:KEY.003 * **Severity**:L4 * **Content**:存在递归关系的数据很常见,数据常会像树或者以层级方式组织。然而,创建一个外键约束来强制执行同一表中两列之间的关系,会导致笨拙的查询。树的每一层对应着另一个连接。您将需要发出递归查询,以获得节点的所有后代或所有祖先。解决方案是构造一个附加的闭包表。它记录了树中所有节点间的关系,而不仅仅是那些具有直接的父子关系。您也可以比较不同层次的数据设计:闭包表,路径枚举,嵌套集。然后根据应用程序的需要选择一个。 * **Case**: ```sql CREATE TABLE tab2 (p_id BIGINT UNSIGNED NOT NULL,a_id BIGINT UNSIGNED NOT NULL,PRIMARY KEY (p_id, a_id),FOREIGN KEY (p_id) REFERENCES tab1(p_id),FOREIGN KEY (a_id) REFERENCES tab3(a_id)) ``` ## 提醒:请将索引属性顺序与查询对齐 * **Item**:KEY.004 * **Severity**:L0 * **Content**:如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。 * **Case**: ```sql create index idx1 on tbl (last_name,first_name) ``` ## 表建的索引过多 * **Item**:KEY.005 * **Severity**:L2 * **Content**:表建的索引过多 * **Case**: ```sql CREATE TABLE tbl ( a int, b int, c int, KEY idx_a (`a`),KEY idx_b(`b`),KEY idx_c(`c`)); ``` ## 主键中的列过多 * **Item**:KEY.006 * **Severity**:L4 * **Content**:主键中的列过多 * **Case**: ```sql CREATE TABLE tbl ( a int, b int, c int, PRIMARY KEY(`a`,`b`,`c`)); ``` ## 未指定主键或主键非 int 或 bigint * **Item**:KEY.007 * **Severity**:L4 * **Content**:未指定主键或主键非 int 或 bigint,建议将主键设置为 int unsigned 或 bigint unsigned。 * **Case**: ```sql CREATE TABLE tbl (a int); ``` ## ORDER BY 多个列但排序方向不同时可能无法使用索引 * **Item**:KEY.008 * **Severity**:L4 * **Content**:在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。 * **Case**: ```sql SELECT * FROM tbl ORDER BY a DESC, b ASC; ``` ## 添加唯一索引前请注意检查数据唯一性 * **Item**:KEY.009 * **Severity**:L0 * **Content**:请提前检查添加唯一索引列的数据唯一性,如果数据不唯一在线表结构调整时将有可能自动将重复列删除,这有可能导致数据丢失。 * **Case**: ```sql CREATE UNIQUE INDEX part_of_name ON customer (name(10)); ``` ## 全文索引不是银弹 * **Item**:KEY.010 * **Severity**:L0 * **Content**:全文索引主要用于解决模糊查询的性能问题,但需要控制好查询的频率和并发度。同时注意调整 ft\_min\_word\_len, ft\_max\_word\_len, ngram\_token\_size 等参数。 * **Case**: ```sql CREATE TABLE `tb` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `ip` varchar(255) NOT NULL DEFAULT '', PRIMARY KEY (`id`), FULLTEXT KEY `ip` (`ip`) ) ENGINE=InnoDB; ``` ## SQL\_CALC\_FOUND\_ROWS 效率低下 * **Item**:KWR.001 * **Severity**:L2 * **Content**:因为 SQL\_CALC\_FOUND\_ROWS 不能很好地扩展,所以可能导致性能问题; 建议业务使用其他策略来替代 SQL\_CALC\_FOUND\_ROWS 提供的计数功能,比如:分页结果展示等。 * **Case**: ```sql select SQL_CALC_FOUND_ROWS col from tbl where id>1000 ``` ## 不建议使用 MySQL 关键字做列名或表名 * **Item**:KWR.002 * **Severity**:L2 * **Content**:当使用关键字做为列名或表名时程序需要对列名和表名进行转义,如果疏忽被将导致请求无法执行。 * **Case**: ```sql CREATE TABLE tbl ( `select` int ) ``` ## 不建议使用复数做列名或表名 * **Item**:KWR.003 * **Severity**:L1 * **Content**:表名应该仅仅表示表里面的实体内容,不应该表示实体数量,对应于 DO 类名也是单数形式,符合表达习惯。 * **Case**: ```sql CREATE TABLE tbl ( `books` int ) ``` ## 不建议使用使用多字节编码字符(中文)命名 * **Item**:KWR.004 * **Severity**:L1 * **Content**:为库、表、列、别名命名时建议使用英文,数字,下划线等字符,不建议使用中文或其他多字节编码字符。 * **Case**: ```sql select col as 列 from tb ``` ## SQL 中包含 unicode 特殊字符 * **Item**:KWR.005 * **Severity**:L1 * **Content**:部分 IDE 会自动在 SQL 插入肉眼不可见的 unicode 字符。如:non-break space, zero-width space 等。Linux 下可使用 \`cat -A file.sql\` 命令查看不可见字符。 * **Case**: ```sql update tb set status = 1 where id = 1; ``` ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item**:LCK.001 * **Severity**:L3 * **Content**:INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Case**: ```sql INSERT INTO tbl SELECT * FROM tbl2; ``` ## 请慎用 INSERT ON DUPLICATE KEY UPDATE * **Item**:LCK.002 * **Severity**:L3 * **Content**:当主键为自增键时使用 INSERT ON DUPLICATE KEY UPDATE 可能会导致主键出现大量不连续快速增长,导致主键快速溢出无法继续写入。极端情况下还有可能导致主从数据不一致。 * **Case**: ```sql INSERT INTO t1(a,b,c) VALUES (1,2,3) ON DUPLICATE KEY UPDATE c=c+1; ``` ## 用字符类型存储IP地址 * **Item**:LIT.001 * **Severity**:L2 * **Content**:字符串字面上看起来像IP地址,但不是 INET\_ATON() 的参数,表示数据被存储为字符而不是整数。将IP地址存储为整数更为有效。 * **Case**: ```sql insert into tbl (IP,name) values('10.20.306.122','test') ``` ## 日期/时间未使用引号括起 * **Item**:LIT.002 * **Severity**:L4 * **Content**:诸如“WHERE col <2010-02-12”之类的查询是有效的SQL,但可能是一个错误,因为它将被解释为“WHERE col <1996”; 日期/时间文字应该加引号,且引号前后不应有空格。 * **Case**: ```sql select col1,col2 from tbl where time < 2018-01-10 ``` ## 一列中存储一系列相关数据的集合 * **Item**:LIT.003 * **Severity**:L3 * **Content**:将 ID 存储为一个列表,作为 VARCHAR/TEXT 列,这样能导致性能和数据完整性问题。查询这样的列需要使用模式匹配的表达式。使用逗号分隔的列表来做多表联结查询定位一行数据是极不优雅和耗时的。这将使验证 ID 更加困难。考虑一下,列表最多支持存放多少数据呢?将 ID 存储在一张单独的表中,代替使用多值属性,从而每个单独的属性值都可以占据一行。这样交叉表实现了两张表之间的多对多关系。这将更好地简化查询,也更有效地验证ID。 * **Case**: ```sql select c1,c2,c3,c4 from tab1 where col_id REGEXP '[[:<:]]12[[:>:]]' ``` ## 请使用分号或已设定的 DELIMITER 结尾 * **Item**:LIT.004 * **Severity**:L1 * **Content**:USE database, SHOW DATABASES 等命令也需要使用使用分号或已设定的 DELIMITER 结尾。 * **Case**: ```sql USE db ``` ## 非确定性的 GROUP BY * **Item**:RES.001 * **Severity**:L4 * **Content**:SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 * **Case**: ```sql select c1,c2,c3 from t1 where c2='foo' group by c2 ``` ## 未使用 ORDER BY 的 LIMIT 查询 * **Item**:RES.002 * **Severity**:L4 * **Content**:没有 ORDER BY 的 LIMIT 会导致非确定性的结果,这取决于查询执行计划。 * **Case**: ```sql select col1,col2 from tbl where name=xx limit 10 ``` ## UPDATE/DELETE 操作使用了 LIMIT 条件 * **Item**:RES.003 * **Severity**:L4 * **Content**:UPDATE/DELETE 操作使用 LIMIT 条件和不添加 WHERE 条件一样危险,它可将会导致主从数据不一致或从库同步中断。 * **Case**: ```sql UPDATE film SET length = 120 WHERE title = 'abc' LIMIT 1; ``` ## UPDATE/DELETE 操作指定了 ORDER BY 条件 * **Item**:RES.004 * **Severity**:L4 * **Content**:UPDATE/DELETE 操作不要指定 ORDER BY 条件。 * **Case**: ```sql UPDATE film SET length = 120 WHERE title = 'abc' ORDER BY title ``` ## UPDATE 语句可能存在逻辑错误,导致数据损坏 * **Item**:RES.005 * **Severity**:L4 * **Content**:在一条 UPDATE 语句中,如果要更新多个字段,字段间不能使用 AND ,而应该用逗号分隔。 * **Case**: ```sql update tbl set col = 1 and cl = 2 where col=3; ``` ## 永远不真的比较条件 * **Item**:RES.006 * **Severity**:L4 * **Content**:查询条件永远非真,如果该条件出现在 where 中可能导致查询无匹配到的结果。 * **Case**: ```sql select * from tbl where 1 != 1; ``` ## 永远为真的比较条件 * **Item**:RES.007 * **Severity**:L4 * **Content**:查询条件永远为真,可能导致 WHERE 条件失效进行全表查询。 * **Case**: ```sql select * from tbl where 1 = 1; ``` ## 不建议使用LOAD DATA/SELECT ... INTO OUTFILE * **Item**:RES.008 * **Severity**:L2 * **Content**:SELECT INTO OUTFILE 需要授予 FILE 权限,这通过会引入安全问题。LOAD DATA 虽然可以提高数据导入速度,但同时也可能导致从库同步延迟过大。 * **Case**: ```sql LOAD DATA INFILE 'data.txt' INTO TABLE db2.my_table; ``` ## 不建议使用连续判断 * **Item**:RES.009 * **Severity**:L2 * **Content**:类似这样的 SELECT \* FROM tbl WHERE col = col = 'abc' 语句可能是书写错误,您可能想表达的含义是 col = 'abc'。如果确实是业务需求建议修改为 col = col and col = 'abc'。 * **Case**: ```sql SELECT * FROM tbl WHERE col = col = 'abc' ``` ## 建表语句中定义为 ON UPDATE CURRENT\_TIMESTAMP 的字段不建议包含业务逻辑 * **Item**:RES.010 * **Severity**:L2 * **Content**:定义为 ON UPDATE CURRENT\_TIMESTAMP 的字段在该表其他字段更新时会联动修改,如果包含业务逻辑用户可见会埋下隐患。后续如有批量修改数据却又不想修改该字段时会导致数据错误。 * **Case**: ```sql CREATE TABLE category (category_id TINYINT UNSIGNED NOT NULL AUTO_INCREMENT, name VARCHAR(25) NOT NULL, last_update TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (category_id) ``` ## 更新请求操作的表包含 ON UPDATE CURRENT\_TIMESTAMP 字段 * **Item**:RES.011 * **Severity**:L2 * **Content**:定义为 ON UPDATE CURRENT\_TIMESTAMP 的字段在该表其他字段更新时会联动修改,请注意检查。如不想修改字段的更新时间可以使用如下方法:UPDATE category SET name='ActioN', last\_update=last\_update WHERE category\_id=1 * **Case**: ```sql UPDATE category SET name='ActioN', last_update=last_update WHERE category_id=1 ``` ## 请谨慎使用TRUNCATE操作 * **Item**:SEC.001 * **Severity**:L0 * **Content**:一般来说想清空一张表最快速的做法就是使用TRUNCATE TABLE tbl\_name;语句。但TRUNCATE操作也并非是毫无代价的,TRUNCATE TABLE无法返回被删除的准确行数,如果需要返回被删除的行数建议使用DELETE语法。TRUNCATE 操作还会重置 AUTO\_INCREMENT,如果不想重置该值建议使用 DELETE FROM tbl\_name WHERE 1;替代。TRUNCATE 操作会对数据字典添加源数据锁(MDL),当一次需要 TRUNCATE 很多表时会影响整个实例的所有请求,因此如果要 TRUNCATE 多个表建议用 DROP+CREATE 的方式以减少锁时长。 * **Case**: ```sql TRUNCATE TABLE tbl_name ``` ## 不使用明文存储密码 * **Item**:SEC.002 * **Severity**:L0 * **Content**:使用明文存储密码或者使用明文在网络上传递密码都是不安全的。如果攻击者能够截获您用来插入密码的SQL语句,他们就能直接读到密码。另外,将用户输入的字符串以明文的形式插入到纯SQL语句中,也会让攻击者发现它。如果您能够读取密码,黑客也可以。解决方案是使用单向哈希函数对原始密码进行加密编码。哈希是指将输入字符串转化成另一个新的、不可识别的字符串的函数。对密码加密表达式加点随机串来防御“字典攻击”。不要将明文密码输入到SQL查询语句中。在应用程序代码中计算哈希串,只在SQL查询中使用哈希串。 * **Case**: ```sql create table test(id int,name varchar(20) not null,password varchar(200)not null) ``` ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item**:SEC.003 * **Severity**:L0 * **Content**:在执行高危操作之前对数据进行备份是十分有必要的。 * **Case**: ```sql delete from table where col = 'condition' ``` ## 发现常见 SQL 注入函数 * **Item**:SEC.004 * **Severity**:L0 * **Content**:SLEEP(), BENCHMARK(), GET\_LOCK(), RELEASE\_LOCK() 等函数通常出现在 SQL 注入语句中,会严重影响数据库性能。 * **Case**: ```sql SELECT BENCHMARK(10, RAND()) ``` ## '!=' 运算符是非标准的 * **Item**:STA.001 * **Severity**:L0 * **Content**:"<>"才是标准SQL中的不等于运算符。 * **Case**: ```sql select col1,col2 from tbl where type!=0 ``` ## 库名或表名点后建议不要加空格 * **Item**:STA.002 * **Severity**:L1 * **Content**:当使用 db.table 或 table.column 格式访问表或字段时,请不要在点号后面添加空格,虽然这样语法正确。 * **Case**: ```sql select col from sakila. film ``` ## 索引起名不规范 * **Item**:STA.003 * **Severity**:L1 * **Content**:建议普通二级索引以idx\_为前缀,唯一索引以uk\_为前缀。 * **Case**: ```sql select col from now where type!=0 ``` ## 起名时请不要使用字母、数字和下划线之外的字符 * **Item**:STA.004 * **Severity**:L1 * **Content**:以字母或下划线开头,名字只允许使用字母、数字和下划线。请统一大小写,不要使用驼峰命名法。不要在名字中出现连续下划线'\_\_',这样很难辨认。 * **Case**: ```sql CREATE TABLE ` abc` (a int); ``` ## MySQL 对子查询的优化效果不佳 * **Item**:SUB.001 * **Severity**:L4 * **Content**:MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 * **Case**: ```sql select col1,col2,col3 from table1 where col2 in(select col from table2) ``` ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item**:SUB.002 * **Severity**:L2 * **Content**:与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 * **Case**: ```sql select teacher_id as id,people_name as name from t1,t2 where t1.teacher_id=t2.people_id union select student_id as id,people_name as name from t1,t2 where t1.student_id=t2.people_id ``` ## 考虑使用 EXISTS 而不是 DISTINCT 子查询 * **Item**:SUB.003 * **Severity**:L3 * **Content**:DISTINCT 关键字在对元组排序后删除重复。相反,考虑使用一个带有 EXISTS 关键字的子查询,您可以避免返回整个表。 * **Case**: ```sql SELECT DISTINCT c.c_id, c.c_name FROM c,e WHERE e.c_id = c.c_id ``` ## 执行计划中嵌套连接深度过深 * **Item**:SUB.004 * **Severity**:L3 * **Content**:MySQL对子查询的优化效果不佳,MySQL将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。 * **Case**: ```sql SELECT * from tb where id in (select id from (select id from tb)) ``` ## 子查询不支持LIMIT * **Item**:SUB.005 * **Severity**:L8 * **Content**:当前 MySQL 版本不支持在子查询中进行 'LIMIT & IN/ALL/ANY/SOME'。 * **Case**: ```sql SELECT * FROM staff WHERE name IN (SELECT NAME FROM customer ORDER BY name LIMIT 1) ``` ## 不建议在子查询中使用函数 * **Item**:SUB.006 * **Severity**:L2 * **Content**:MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。 * **Case**: ```sql SELECT * FROM staff WHERE name IN (SELECT max(NAME) FROM customer) ``` ## 外层带有 LIMIT 输出限制的 UNION 联合查询,其内层查询建议也添加 LIMIT 输出限制 * **Item**:SUB.007 * **Severity**:L2 * **Content**:有时 MySQL 无法将限制条件从外层“下推”到内层,这会使得原本可以限制能够限制部分返回结果的条件无法应用到内层查询的优化上。比如:(SELECT \* FROM tb1 ORDER BY name) UNION ALL (SELECT \* FROM tb2 ORDER BY name) LIMIT 20; MySQL 会将两个子查询的结果放在一个临时表中,然后取出 20 条结果,可以通过在两个子查询中添加 LIMIT 20 来减少临时表中的数据。(SELECT \* FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT \* FROM tb2 ORDER BY name LIMIT 20) LIMIT 20; * **Case**: ```sql (SELECT * FROM tb1 ORDER BY name LIMIT 20) UNION ALL (SELECT * FROM tb2 ORDER BY name LIMIT 20) LIMIT 20; ``` ## 不建议使用分区表 * **Item**:TBL.001 * **Severity**:L4 * **Content**:不建议使用分区表 * **Case**: ```sql CREATE TABLE trb3(id INT, name VARCHAR(50), purchased DATE) PARTITION BY RANGE(YEAR(purchased)) (PARTITION p0 VALUES LESS THAN (1990), PARTITION p1 VALUES LESS THAN (1995), PARTITION p2 VALUES LESS THAN (2000), PARTITION p3 VALUES LESS THAN (2005) ); ``` ## 请为表选择合适的存储引擎 * **Item**:TBL.002 * **Severity**:L4 * **Content**:建表或修改表的存储引擎时建议使用推荐的存储引擎,如:innodb * **Case**: ```sql create table test(`id` int(11) NOT NULL AUTO_INCREMENT) ``` ## 以DUAL命名的表在数据库中有特殊含义 * **Item**:TBL.003 * **Severity**:L8 * **Content**:DUAL表为虚拟表,不需要创建即可使用,也不建议服务以DUAL命名表。 * **Case**: ```sql create table dual(id int, primary key (id)); ``` ## 表的初始AUTO\_INCREMENT值不为0 * **Item**:TBL.004 * **Severity**:L2 * **Content**:AUTO\_INCREMENT不为0会导致数据空洞。 * **Case**: ```sql CREATE TABLE tbl (a int) AUTO_INCREMENT = 10; ``` ## 请使用推荐的字符集 * **Item**:TBL.005 * **Severity**:L4 * **Content**:表字符集只允许设置为'utf8,utf8mb4' * **Case**: ```sql CREATE TABLE tbl (a int) DEFAULT CHARSET = latin1; ``` ## 不建议使用视图 * **Item**:TBL.006 * **Severity**:L1 * **Content**:不建议使用视图 * **Case**: ```sql create view v_today (today) AS SELECT CURRENT_DATE; ``` ## 不建议使用临时表 * **Item**:TBL.007 * **Severity**:L1 * **Content**:不建议使用临时表 * **Case**: ```sql CREATE TEMPORARY TABLE `work` (`time` time DEFAULT NULL) ENGINE=InnoDB; ``` ## 请使用推荐的COLLATE * **Item**:TBL.008 * **Severity**:L4 * **Content**:COLLATE 只允许设置为'' * **Case**: ```sql CREATE TABLE tbl (a int) DEFAULT COLLATE = latin1_bin; ``` ================================================ FILE: doc/images/logo.ascii ================================================ ,adPPYba, ,adPPYba, ,adPPYYba, 8b,dPPYba, I8[ "" a8" "8a "" `Y8 88P' "Y8 `"Y8ba, 8b d8 ,adPPPPP88 88 aa ]8I "8a, ,a8" 88, ,88 88 `"YbbdP"' `"YbbdP"' `"8bbdP"Y8 88 ================================================ FILE: doc/indexing.md ================================================ # 索引优化建议 以下优化算法基于个人当前理解,能力有限,如有偏颇还请斧正。 ## 简单查询索引优化 ### 等值查询优化 * 单列等值查询,为该等值列加索引 * 多列等值查询,每列求取散粒度,按从大到小排序取前N列添加到索引(N可配置) ```sql SELECT * FROM tbl WHERE a = 123; SELECT * FROM tbl WHERE a = 123 AND b = 456; SELECT * FROM tbl WHERE a IS NULL; SELECT * FROM tbl WHERE a <=> 123; SELECT * FROM tbl WHERE a IS TRUE; SELECT * FROM tbl WHERE a IS FALSE; SELECT * FROM tbl WHERE a IS NOT TRUE; SELECT * FROM tbl WHERE a IS NOT FALSE; SELECT * FROM tbl WHERE a IN ("xxx"); -- IN单值 ``` ### 非等值查询优化 * 单列非等值查询,为该非等值列加索引 * 多列非等值查询,每列求取散粒度,为散粒度最大的列加索引。 思考:对于多列非等值,为filtered最小列加索引可能比较好。因为输入可变,所以现在只按散粒度排序。对于高版本MySQL如果开启了Index Merge,考虑为非等值列加单列索引可能会比较好。 ```sql SELECT * FROM tbl WHERE a >= 123 -- <, <=, >=, >, !=, <> SELECT * FROM tbl WHERE a BETWEEN 22 AND 44; -- NOT BETWEEN SELECT * FROM tbl WHERE a LIKE 'blah%'; -- NOT LIKE SELECT * FROM tbl WHERE a IS NOT NULL; SELECT * FROM tbl WHERE a IN ("xxx"); -- IN多值 ``` ### 等值 & 非等值组合查询优化 1. 先按`等值查询优化`为等值列添加索引 2. 再将`非等值查询优化`的列追加在等值列索引后 ```sql SELECT * FROM tbl WHERE c = 9 AND a > 12 AND b > 345; -- INDEX(c, a)或INDEX(c, b) ``` ### OR操作符 如果使用了OR操作符,即使OR两边是简单的查询条件也会对优化器带来很大的困难。一般对OR的优化需要依赖UNION ALL或Index Merge等多索引访问技术来实现。SOAR目前不会对使用OR操作符连接的字段进行索引优化。 ### GROUP BY子句 GROUP BY相关字段能否加入索引列表需要依赖WHERE子句中的条件。当查询指定了WHERE条件,在满足WHERE子句只有等值查询时,可以对GROUP BY字段添加索引。当查询未指定WHERE条件,可以直接对GROUP BY字段添加索引。 * 按照GROPU BY的先后顺序添加索引 * GROUP BY字段出现常量,数学运算或函数运算时会给出警告 ### ORDER BY子句 ORDER BY相关字段能否加入索引列表需要依赖WHERE子句和GROUP BY子句中的条件。当查询指定了WHERE条件,在满足WHERE子句只有等值查询且无GROUP BY子句时,可以对ORDER BY字段添加索引。当查询未指定WHERE条件,在满足无GROUP BY子句时,可以对ORDER BY字段添加索引。 * 多个字段之间如果指定顺序相同,按照ORDER BY的先后顺序添加索引 * 多个字段之间如果指定顺序不同,所有ORDER BY字段都不添加索引 * ORDER BY字段出现常量,数学运算或函数运算时会给出警告 ## 复杂查询索引优化 ### JOIN索引优化算法 * LEFT JOIN为右表加索引 * RIGHT JOIN为左表加索引 * INNER JOIN两张表都加索引 * NATURAL的处理方法参考前三条 * STRAIGHT_JOIN为后面的表加索引 ### SUBQUERY和UNION的复杂查询 对于使用了IN,EXIST等词的SUBQUERY或UNION类型的SQL,先将其拆成多条独立的SELECT语句。然后基于上面简单查询索引优化算法,对单条SELECT查询进行优化。SUBQUERY的连接列暂不考虑添加索引。 ```sql SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1); 1. SELECT * FROM film; 2. SELECT language_id FROM language LIMIT 1; ``` ```sql SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id; 1. SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id; 2. SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id; ``` ## 无法使用索引的情况 如下类型的查询条件无法使用索引或SOAR无法给出正确的索引建议。 ```sql -- MySQL无法使用索引 SELECT * FROM tbl WHERE a LIKE '%blah%'; SELECT * FROM tbl WHERE a IN (SELECT...) SELECT * FROM tbl WHERE DATE(dt) = 'xxx' SELECT * FROM tbl WHERE LOWER(s) = 'xxx' SELECT * FROM tbl WHERE CAST(s …) = 'xxx' SELECT * FROM tbl where a NOT IN() -- SOAR不支持的索引建议 SELECT * FROM tbl WHERE a = 'xxx' COLLATE xxx -- vitess语法暂不支持 SELECT * FROM tbl ORDER BY a ASC, b DESC -- 8.0+支持 SELECT * FROM tbl WHERE `date` LIKE '2016-12%' -- 时间数据类型隐式类型转换 ``` ## 索引长度限制 由于索引长度受数据库版本及不同配置参数影响,参考[InnoDB限制](https://dev.mysql.com/doc/refman/8.0/en/innodb-restrictions.html)。这里将索引长度限制定义为可配置值,用户可以根据实际情况进行设置。 * 通过-max-index-bytes配置每列索引最大长度,默认为767 Bytes * 超过单列索引最大长度限制后程序会自动添加该列的前缀索引(max-index-bytes/CHARSET_Maxlen) * 通过-max-index-bytes-percolumn配置多列索引加各最大长度,默认为3072 Bytes * 超过多列索引最大长度限制后,由程序生成的ALTER语句会将每列前缀索引长度指定为N,用户自行调整 ```sql ALTER TABLE `sakila`.`film_text` add index `idx_description` (`description`(255)) ; ``` ## 更新语句转换为只读查询 SOAR支持将DELETE, UPDATE, INSERT, REPLACE四种类型语句转换为SELECT查询。对转换后的SELECT查询进行索引优化。以下为转换示例。 ```sql UPDATE film SET length = 10 WHERE language_id = 20; SELECT * FROM film WHERE language_id = 20; ``` ```sql DELETE FROM film WHERE length > 100; SELECT * FROM film WHERE length > 100; ``` ```sql INSERT INTO city (country_id) SELECT country_id FROM country; SELECT country_id FROM country; ``` ```sql REPLACE INTO city (country_id) SELECT country_id FROM country; SELECT country_id FROM country; ``` ## 散粒度计算 ### 计算公式 `Cardinality = ColumnDistinctCount/TableTotalRows * 100%` 由于直接对线上表进行COUNT(DISTINCT)操作会影响数据库请求执行效率,因此默认各列的散粒度均为1。用户可以通过指定`-sampling`参数开启数据采样。SOAR会将线上数据随机采样至测试环境求取散粒度。 ### 数据采样算法 以下说明摘抄自PostgreSQL数据直方图采样算法。默认k(-sampling-statistic-target)设置为100,即最多采样3万行记录。 ```text The following choice of minrows is based on the paper "Random sampling for histogram construction: how much is enough?" by Surajit Chaudhuri, Rajeev Motwani and Vivek Narasayya, in Proceedings of ACM SIGMOD International Conference on Management of Data, 1998, Pages 436-447. Their Corollary 1 to Theorem 5 says that for table size n, histogram size k, maximum relative error in bin size f, and error probability gamma, the minimum random sample size is r = 4 * k * ln(2*n/gamma) / f^2 Taking f = 0.5, gamma = 0.01, n = 10^6 rows, we obtain r = 305.82 * k Note that because of the log function, the dependence on n is quite weak; even at n = 10^12, a 300*k sample gives <= 0.66 bin size error with probability 0.99. So there's no real need to scale for n, which is a good thing because we don't necessarily know it at this point. ``` ### 随机采样 随机采样使用的SQL如下,其中变量`r`, `n`的含义见上面的说明。 ```sql SELECT * FROM `tbl` WHERE RAND() < r LIMIT n; ``` ## 索引去重 ### 检查步骤 1. 为查询语句可能使用索引的字段添加索引 2. 枚举用到的所有库表的已知索引 3. 判断所有新加的索引是否与已知索引重复 4. 判断所有新加的索引之间是否存在索引重复 ### 检查规则 * PRIMARY > UNIQUE > KEY * 索引名称相同,即: idxA == idxA * (a, b) > (a) * (a, b), (b, a) 会给出警告,用户自行判断是否重复 ## 不足 * 目前只支持针对InnoDB引擎添加索引建议,不支持FULLTEXT, SPATIAL等其他类型索引 * 暂不支持索引覆盖(Covering) * 暂不支持Index Merge情况下的索引建议 ================================================ FILE: doc/install.md ================================================ ## 下载二进制安装包 ```bash wget https://github.com/XiaoMi/soar/releases/download/${tag}/soar.${OS}-amd64 -O soar chmod a+x soar 如: wget https://github.com/XiaoMi/soar/releases/download/0.9.0/soar.linux-amd64 -O soar chmod a+x soar ``` ## 源码安装 ### 依赖软件 一般依赖 * Go 1.12+ * git 高级依赖(仅面向开发人员) * [mysql](https://dev.mysql.com/doc/refman/8.0/en/mysql.html) 客户端版本需要与容器中MySQL版本相同,避免出现由于认证原因导致无法连接问题 * [docker](https://docs.docker.com/engine/reference/commandline/cli/) MySQL Server测试容器管理 * [govendor](https://github.com/kardianos/govendor) Go包管理 * [retool](https://github.com/twitchtv/retool) 依赖外部代码质量静态检查工具二进制文件管理 ### 生成二进制文件 ```bash go get -d github.com/XiaoMi/soar cd ${GOPATH}/src/github.com/XiaoMi/soar && make ``` ### 开发调试 如下指令如果您没有精力参与SOAR的开发可以跳过。 * make deps 依赖检查 * make vitess 升级Vitess Parser依赖 * make tidb 升级TiDB Parser依赖 * make fmt 代码格式化,统一风格 * make lint 代码质量检查 * make docker 启动一个MySQL测试容器,可用于测试依赖元数据检查的功能或不同版本MySQL差异 * make test 运行所有的测试用例 * make cover 代码测试覆盖度检查 * make doc 自动生成命令行参数中-list-XX相关文档 * make daily 每日构建,时刻跟进Vitess, TiDB依赖变化 * make release 生成Linux, Windows, Mac发布版本 ## 安装验证 ```bash echo 'select * from film' | ./soar ``` ================================================ FILE: doc/install_en.md ================================================ ## Get Released Binary ```bash wget https://github.com/XiaoMi/soar/releases/download/${tag}/soar.${OS}-amd64 -O soar chmod a+x soar eg. wget https://github.com/XiaoMi/soar/releases/download/0.9.0/soar.linux-amd64 -O soar chmod a+x soar ``` ## Build From Source ```bash go get -d github.com/XiaoMi/soar cd ${GOPATH}/src/github.com/XiaoMi/soar && make ``` ## Simple Test Case ```bash echo 'select * from film' | ./soar ``` ================================================ FILE: doc/js/pretty.js ================================================ ! function(e, E) { "object" == typeof exports && "object" == typeof module ? module.exports = E() : "function" == typeof define && define.amd ? define([], E) : "object" == typeof exports ? exports.sqlFormatter = E() : e.sqlFormatter = E() }(this, function() { return function(e) { function E(n) { if (t[n]) return t[n].exports; var r = t[n] = { exports: {}, id: n, loaded: !1 }; return e[n].call(r.exports, r, r.exports, E), r.loaded = !0, r.exports } var t = {}; return E.m = e, E.c = t, E.p = "", E(0) }([function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(18), T = n(r), R = t(19), o = n(R), N = t(20), A = n(N), I = t(21), O = n(I); E["default"] = { format: function(e, E) { switch (E = E || {}, E.language) { case "db2": return new T["default"](E).format(e); case "n1ql": return new o["default"](E).format(e); case "pl/sql": return new A["default"](E).format(e); case "sql": case void 0: return new O["default"](E).format(e); default: throw Error("Unsupported SQL dialect: " + E.language) } } }, e.exports = E["default"] }, function(e, E) { "use strict"; E.__esModule = !0, E["default"] = function(e, E) { if (!(e instanceof E)) throw new TypeError("Cannot call a class as a function") } }, function(e, E, t) { var n = t(39), r = "object" == typeof self && self && self.Object === Object && self, T = n || r || Function("return this")(); e.exports = T }, function(e, E, t) { function n(e, E) { var t = T(e, E); return r(t) ? t : void 0 } var r = t(33), T = t(41); e.exports = n }, function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(1), T = n(r), R = t(66), o = n(R), N = t(7), A = n(N), I = t(15), O = n(I), i = t(16), S = n(i), u = t(17), L = n(u), C = function() { function e(E, t) { (0, T["default"])(this, e), this.cfg = E || {}, this.indentation = new O["default"](this.cfg.indent), this.inlineBlock = new S["default"], this.params = new L["default"](this.cfg.params), this.tokenizer = t, this.previousReservedWord = {} } return e.prototype.format = function(e) { var E = this.tokenizer.tokenize(e), t = this.getFormattedQueryFromTokens(E); return t.trim() }, e.prototype.getFormattedQueryFromTokens = function(e) { var E = this, t = ""; return e.forEach(function(n, r) { n.type !== A["default"].WHITESPACE && (n.type === A["default"].LINE_COMMENT ? t = E.formatLineComment(n, t) : n.type === A["default"].BLOCK_COMMENT ? t = E.formatBlockComment(n, t) : n.type === A["default"].RESERVED_TOPLEVEL ? (t = E.formatToplevelReservedWord(n, t), E.previousReservedWord = n) : n.type === A["default"].RESERVED_NEWLINE ? (t = E.formatNewlineReservedWord(n, t), E.previousReservedWord = n) : n.type === A["default"].RESERVED ? (t = E.formatWithSpaces(n, t), E.previousReservedWord = n) : t = n.type === A["default"].OPEN_PAREN ? E.formatOpeningParentheses(e, r, t) : n.type === A["default"].CLOSE_PAREN ? E.formatClosingParentheses(n, t) : n.type === A["default"].PLACEHOLDER ? E.formatPlaceholder(n, t) : "," === n.value ? E.formatComma(n, t) : ":" === n.value ? E.formatWithSpaceAfter(n, t) : "." === n.value || ";" === n.value ? E.formatWithoutSpaces(n, t) : E.formatWithSpaces(n, t)) }), t }, e.prototype.formatLineComment = function(e, E) { return this.addNewline(E + e.value) }, e.prototype.formatBlockComment = function(e, E) { return this.addNewline(this.addNewline(E) + this.indentComment(e.value)) }, e.prototype.indentComment = function(e) { return e.replace(/\n/g, "\n" + this.indentation.getIndent()) }, e.prototype.formatToplevelReservedWord = function(e, E) { return this.indentation.decreaseTopLevel(), E = this.addNewline(E), this.indentation.increaseToplevel(), E += this.equalizeWhitespace(e.value), this.addNewline(E) }, e.prototype.formatNewlineReservedWord = function(e, E) { return this.addNewline(E) + this.equalizeWhitespace(e.value) + " " }, e.prototype.equalizeWhitespace = function(e) { return e.replace(/\s+/g, " ") }, e.prototype.formatOpeningParentheses = function(e, E, t) { var n = e[E - 1]; return n && n.type !== A["default"].WHITESPACE && n.type !== A["default"].OPEN_PAREN && (t = (0, o["default"])(t)), t += e[E].value, this.inlineBlock.beginIfPossible(e, E), this.inlineBlock.isActive() || (this.indentation.increaseBlockLevel(), t = this.addNewline(t)), t }, e.prototype.formatClosingParentheses = function(e, E) { return this.inlineBlock.isActive() ? (this.inlineBlock.end(), this.formatWithSpaceAfter(e, E)) : (this.indentation.decreaseBlockLevel(), this.formatWithSpaces(e, this.addNewline(E))) }, e.prototype.formatPlaceholder = function(e, E) { return E + this.params.get(e) + " " }, e.prototype.formatComma = function(e, E) { return E = (0, o["default"])(E) + e.value + " ", this.inlineBlock.isActive() ? E : /^LIMIT$/i.test(this.previousReservedWord.value) ? E : this.addNewline(E) }, e.prototype.formatWithSpaceAfter = function(e, E) { return (0, o["default"])(E) + e.value + " " }, e.prototype.formatWithoutSpaces = function(e, E) { return (0, o["default"])(E) + e.value }, e.prototype.formatWithSpaces = function(e, E) { return E + e.value + " " }, e.prototype.addNewline = function(e) { return (0, o["default"])(e) + "\n" + this.indentation.getIndent() }, e }(); E["default"] = C, e.exports = E["default"] }, function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(1), T = n(r), R = t(58), o = n(R), N = t(53), A = n(N), I = t(7), O = n(I), i = function() { function e(E) { (0, T["default"])(this, e), this.WHITESPACE_REGEX = /^(\s+)/, this.NUMBER_REGEX = /^((-\s*)?[0-9]+(\.[0-9]+)?|0x[0-9a-fA-F]+|0b[01]+)\b/, this.OPERATOR_REGEX = /^(!=|<>|==|<=|>=|!<|!>|\|\||::|->>|->|~~\*|~~|!~~\*|!~~|~\*|!~\*|!~|.)/, this.BLOCK_COMMENT_REGEX = /^(\/\*[^]*?(?:\*\/|$))/, this.LINE_COMMENT_REGEX = this.createLineCommentRegex(E.lineCommentTypes), this.RESERVED_TOPLEVEL_REGEX = this.createReservedWordRegex(E.reservedToplevelWords), this.RESERVED_NEWLINE_REGEX = this.createReservedWordRegex(E.reservedNewlineWords), this.RESERVED_PLAIN_REGEX = this.createReservedWordRegex(E.reservedWords), this.WORD_REGEX = this.createWordRegex(E.specialWordChars), this.STRING_REGEX = this.createStringRegex(E.stringTypes), this.OPEN_PAREN_REGEX = this.createParenRegex(E.openParens), this.CLOSE_PAREN_REGEX = this.createParenRegex(E.closeParens), this.INDEXED_PLACEHOLDER_REGEX = this.createPlaceholderRegex(E.indexedPlaceholderTypes, "[0-9]*"), this.IDENT_NAMED_PLACEHOLDER_REGEX = this.createPlaceholderRegex(E.namedPlaceholderTypes, "[a-zA-Z0-9._$]+"), this.STRING_NAMED_PLACEHOLDER_REGEX = this.createPlaceholderRegex(E.namedPlaceholderTypes, this.createStringPattern(E.stringTypes)) } return e.prototype.createLineCommentRegex = function(e) { return RegExp("^((?:" + e.map(function(e) { return (0, A["default"])(e) }).join("|") + ").*?(?:\n|$))") }, e.prototype.createReservedWordRegex = function(e) { var E = e.join("|").replace(/ /g, "\\s+"); return RegExp("^(" + E + ")\\b", "i") }, e.prototype.createWordRegex = function() { var e = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : []; return RegExp("^([\\w" + e.join("") + "]+)") }, e.prototype.createStringRegex = function(e) { return RegExp("^(" + this.createStringPattern(e) + ")") }, e.prototype.createStringPattern = function(e) { var E = { "``": "((`[^`]*($|`))+)", "[]": "((\\[[^\\]]*($|\\]))(\\][^\\]]*($|\\]))*)", '""': '(("[^"\\\\]*(?:\\\\.[^"\\\\]*)*("|$))+)', "''": "(('[^'\\\\]*(?:\\\\.[^'\\\\]*)*('|$))+)", "N''": "((N'[^N'\\\\]*(?:\\\\.[^N'\\\\]*)*('|$))+)" }; return e.map(function(e) { return E[e] }).join("|") }, e.prototype.createParenRegex = function(e) { var E = this; return RegExp("^(" + e.map(function(e) { return E.escapeParen(e) }).join("|") + ")", "i") }, e.prototype.escapeParen = function(e) { return 1 === e.length ? (0, A["default"])(e) : "\\b" + e + "\\b" }, e.prototype.createPlaceholderRegex = function(e, E) { if ((0, o["default"])(e)) return !1; var t = e.map(A["default"]).join("|"); return RegExp("^((?:" + t + ")(?:" + E + "))") }, e.prototype.tokenize = function(e) { for (var E = [], t = void 0; e.length;) t = this.getNextToken(e, t), e = e.substring(t.value.length), E.push(t); return E }, e.prototype.getNextToken = function(e, E) { return this.getWhitespaceToken(e) || this.getCommentToken(e) || this.getStringToken(e) || this.getOpenParenToken(e) || this.getCloseParenToken(e) || this.getPlaceholderToken(e) || this.getNumberToken(e) || this.getReservedWordToken(e, E) || this.getWordToken(e) || this.getOperatorToken(e) }, e.prototype.getWhitespaceToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].WHITESPACE, regex: this.WHITESPACE_REGEX }) }, e.prototype.getCommentToken = function(e) { return this.getLineCommentToken(e) || this.getBlockCommentToken(e) }, e.prototype.getLineCommentToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].LINE_COMMENT, regex: this.LINE_COMMENT_REGEX }) }, e.prototype.getBlockCommentToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].BLOCK_COMMENT, regex: this.BLOCK_COMMENT_REGEX }) }, e.prototype.getStringToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].STRING, regex: this.STRING_REGEX }) }, e.prototype.getOpenParenToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].OPEN_PAREN, regex: this.OPEN_PAREN_REGEX }) }, e.prototype.getCloseParenToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].CLOSE_PAREN, regex: this.CLOSE_PAREN_REGEX }) }, e.prototype.getPlaceholderToken = function(e) { return this.getIdentNamedPlaceholderToken(e) || this.getStringNamedPlaceholderToken(e) || this.getIndexedPlaceholderToken(e) }, e.prototype.getIdentNamedPlaceholderToken = function(e) { return this.getPlaceholderTokenWithKey({ input: e, regex: this.IDENT_NAMED_PLACEHOLDER_REGEX, parseKey: function(e) { return e.slice(1) } }) }, e.prototype.getStringNamedPlaceholderToken = function(e) { var E = this; return this.getPlaceholderTokenWithKey({ input: e, regex: this.STRING_NAMED_PLACEHOLDER_REGEX, parseKey: function(e) { return E.getEscapedPlaceholderKey({ key: e.slice(2, -1), quoteChar: e.slice(-1) }) } }) }, e.prototype.getIndexedPlaceholderToken = function(e) { return this.getPlaceholderTokenWithKey({ input: e, regex: this.INDEXED_PLACEHOLDER_REGEX, parseKey: function(e) { return e.slice(1) } }) }, e.prototype.getPlaceholderTokenWithKey = function(e) { var E = e.input, t = e.regex, n = e.parseKey, r = this.getTokenOnFirstMatch({ input: E, regex: t, type: O["default"].PLACEHOLDER }); return r && (r.key = n(r.value)), r }, e.prototype.getEscapedPlaceholderKey = function(e) { var E = e.key, t = e.quoteChar; return E.replace(RegExp((0, A["default"])("\\") + t, "g"), t) }, e.prototype.getNumberToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].NUMBER, regex: this.NUMBER_REGEX }) }, e.prototype.getOperatorToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].OPERATOR, regex: this.OPERATOR_REGEX }) }, e.prototype.getReservedWordToken = function(e, E) { if (!E || !E.value || "." !== E.value) return this.getToplevelReservedToken(e) || this.getNewlineReservedToken(e) || this.getPlainReservedToken(e) }, e.prototype.getToplevelReservedToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].RESERVED_TOPLEVEL, regex: this.RESERVED_TOPLEVEL_REGEX }) }, e.prototype.getNewlineReservedToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].RESERVED_NEWLINE, regex: this.RESERVED_NEWLINE_REGEX }) }, e.prototype.getPlainReservedToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].RESERVED, regex: this.RESERVED_PLAIN_REGEX }) }, e.prototype.getWordToken = function(e) { return this.getTokenOnFirstMatch({ input: e, type: O["default"].WORD, regex: this.WORD_REGEX }) }, e.prototype.getTokenOnFirstMatch = function(e) { var E = e.input, t = e.type, n = e.regex, r = E.match(n); if (r) return { type: t, value: r[1] } }, e }(); E["default"] = i, e.exports = E["default"] }, function(e, E) { function t(e) { var E = typeof e; return null != e && ("object" == E || "function" == E) } e.exports = t }, function(e, E) { "use strict"; E.__esModule = !0, E["default"] = { WHITESPACE: "whitespace", WORD: "word", STRING: "string", RESERVED: "reserved", RESERVED_TOPLEVEL: "reserved-toplevel", RESERVED_NEWLINE: "reserved-newline", OPERATOR: "operator", OPEN_PAREN: "open-paren", CLOSE_PAREN: "close-paren", LINE_COMMENT: "line-comment", BLOCK_COMMENT: "block-comment", NUMBER: "number", PLACEHOLDER: "placeholder" }, e.exports = E["default"] }, function(e, E, t) { function n(e) { return null != e && T(e.length) && !r(e) } var r = t(12), T = t(59); e.exports = n }, function(e, E, t) { function n(e) { return null == e ? "" : r(e) } var r = t(10); e.exports = n }, function(e, E, t) { function n(e) { if ("string" == typeof e) return e; if (T(e)) return N ? N.call(e) : ""; var E = e + ""; return "0" == E && 1 / e == -R ? "-0" : E } var r = t(26), T = t(14), R = 1 / 0, o = r ? r.prototype : void 0, N = o ? o.toString : void 0; e.exports = n }, function(e, E) { function t(e) { if (null != e) { try { return r.call(e) } catch (E) {} try { return e + "" } catch (E) {} } return "" } var n = Function.prototype, r = n.toString; e.exports = t }, function(e, E, t) { function n(e) { var E = r(e) ? N.call(e) : ""; return E == T || E == R } var r = t(6), T = "[object Function]", R = "[object GeneratorFunction]", o = Object.prototype, N = o.toString; e.exports = n }, function(e, E) { function t(e) { return null != e && "object" == typeof e } e.exports = t }, function(e, E, t) { function n(e) { return "symbol" == typeof e || r(e) && o.call(e) == T } var r = t(13), T = "[object Symbol]", R = Object.prototype, o = R.toString; e.exports = n }, function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(1), T = n(r), R = t(61), o = n(R), N = t(60), A = n(N), I = "top-level", O = "block-level", i = function() { function e(E) { (0, T["default"])(this, e), this.indent = E || " ", this.indentTypes = [] } return e.prototype.getIndent = function() { return (0, o["default"])(this.indent, this.indentTypes.length) }, e.prototype.increaseToplevel = function() { this.indentTypes.push(I) }, e.prototype.increaseBlockLevel = function() { this.indentTypes.push(O) }, e.prototype.decreaseTopLevel = function() { (0, A["default"])(this.indentTypes) === I && this.indentTypes.pop() }, e.prototype.decreaseBlockLevel = function() { for (; this.indentTypes.length > 0;) { var e = this.indentTypes.pop(); if (e !== I) break } }, e }(); E["default"] = i, e.exports = E["default"] }, function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(1), T = n(r), R = t(7), o = n(R), N = 50, A = function() { function e() { (0, T["default"])(this, e), this.level = 0 } return e.prototype.beginIfPossible = function(e, E) { 0 === this.level && this.isInlineBlock(e, E) ? this.level = 1 : this.level > 0 ? this.level++ : this.level = 0 }, e.prototype.end = function() { this.level-- }, e.prototype.isActive = function() { return this.level > 0 }, e.prototype.isInlineBlock = function(e, E) { for (var t = 0, n = 0, r = E; e.length > r; r++) { var T = e[r]; if (t += T.value.length, t > N) return !1; if (T.type === o["default"].OPEN_PAREN) n++; else if (T.type === o["default"].CLOSE_PAREN && (n--, 0 === n)) return !0; if (this.isForbiddenToken(T)) return !1 } return !1 }, e.prototype.isForbiddenToken = function(e) { var E = e.type, t = e.value; return E === o["default"].RESERVED_TOPLEVEL || E === o["default"].RESERVED_NEWLINE || E === o["default"].COMMENT || E === o["default"].BLOCK_COMMENT || ";" === t }, e }(); E["default"] = A, e.exports = E["default"] }, function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(1), T = n(r), R = function() { function e(E) { (0, T["default"])(this, e), this.params = E, this.index = 0 } return e.prototype.get = function(e) { var E = e.key, t = e.value; return this.params ? E ? this.params[E] : this.params[this.index++] : t }, e }(); E["default"] = R, e.exports = E["default"] }, function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(1), T = n(r), R = t(4), o = n(R), N = t(5), A = n(N), I = ["ABS", "ACTIVATE", "ALIAS", "ALL", "ALLOCATE", "ALLOW", "ALTER", "ANY", "ARE", "ARRAY", "AS", "ASC", "ASENSITIVE", "ASSOCIATE", "ASUTIME", "ASYMMETRIC", "AT", "ATOMIC", "ATTRIBUTES", "AUDIT", "AUTHORIZATION", "AUX", "AUXILIARY", "AVG", "BEFORE", "BEGIN", "BETWEEN", "BIGINT", "BINARY", "BLOB", "BOOLEAN", "BOTH", "BUFFERPOOL", "BY", "CACHE", "CALL", "CALLED", "CAPTURE", "CARDINALITY", "CASCADED", "CASE", "CAST", "CCSID", "CEIL", "CEILING", "CHAR", "CHARACTER", "CHARACTER_LENGTH", "CHAR_LENGTH", "CHECK", "CLOB", "CLONE", "CLOSE", "CLUSTER", "COALESCE", "COLLATE", "COLLECT", "COLLECTION", "COLLID", "COLUMN", "COMMENT", "COMMIT", "CONCAT", "CONDITION", "CONNECT", "CONNECTION", "CONSTRAINT", "CONTAINS", "CONTINUE", "CONVERT", "CORR", "CORRESPONDING", "COUNT", "COUNT_BIG", "COVAR_POP", "COVAR_SAMP", "CREATE", "CROSS", "CUBE", "CUME_DIST", "CURRENT", "CURRENT_DATE", "CURRENT_DEFAULT_TRANSFORM_GROUP", "CURRENT_LC_CTYPE", "CURRENT_PATH", "CURRENT_ROLE", "CURRENT_SCHEMA", "CURRENT_SERVER", "CURRENT_TIME", "CURRENT_TIMESTAMP", "CURRENT_TIMEZONE", "CURRENT_TRANSFORM_GROUP_FOR_TYPE", "CURRENT_USER", "CURSOR", "CYCLE", "DATA", "DATABASE", "DATAPARTITIONNAME", "DATAPARTITIONNUM", "DATE", "DAY", "DAYS", "DB2GENERAL", "DB2GENRL", "DB2SQL", "DBINFO", "DBPARTITIONNAME", "DBPARTITIONNUM", "DEALLOCATE", "DEC", "DECIMAL", "DECLARE", "DEFAULT", "DEFAULTS", "DEFINITION", "DELETE", "DENSERANK", "DENSE_RANK", "DEREF", "DESCRIBE", "DESCRIPTOR", "DETERMINISTIC", "DIAGNOSTICS", "DISABLE", "DISALLOW", "DISCONNECT", "DISTINCT", "DO", "DOCUMENT", "DOUBLE", "DROP", "DSSIZE", "DYNAMIC", "EACH", "EDITPROC", "ELEMENT", "ELSE", "ELSEIF", "ENABLE", "ENCODING", "ENCRYPTION", "END", "END-EXEC", "ENDING", "ERASE", "ESCAPE", "EVERY", "EXCEPTION", "EXCLUDING", "EXCLUSIVE", "EXEC", "EXECUTE", "EXISTS", "EXIT", "EXP", "EXPLAIN", "EXTENDED", "EXTERNAL", "EXTRACT", "FALSE", "FENCED", "FETCH", "FIELDPROC", "FILE", "FILTER", "FINAL", "FIRST", "FLOAT", "FLOOR", "FOR", "FOREIGN", "FREE", "FULL", "FUNCTION", "FUSION", "GENERAL", "GENERATED", "GET", "GLOBAL", "GOTO", "GRANT", "GRAPHIC", "GROUP", "GROUPING", "HANDLER", "HASH", "HASHED_VALUE", "HINT", "HOLD", "HOUR", "HOURS", "IDENTITY", "IF", "IMMEDIATE", "IN", "INCLUDING", "INCLUSIVE", "INCREMENT", "INDEX", "INDICATOR", "INDICATORS", "INF", "INFINITY", "INHERIT", "INNER", "INOUT", "INSENSITIVE", "INSERT", "INT", "INTEGER", "INTEGRITY", "INTERSECTION", "INTERVAL", "INTO", "IS", "ISOBID", "ISOLATION", "ITERATE", "JAR", "JAVA", "KEEP", "KEY", "LABEL", "LANGUAGE", "LARGE", "LATERAL", "LC_CTYPE", "LEADING", "LEAVE", "LEFT", "LIKE", "LINKTYPE", "LN", "LOCAL", "LOCALDATE", "LOCALE", "LOCALTIME", "LOCALTIMESTAMP", "LOCATOR", "LOCATORS", "LOCK", "LOCKMAX", "LOCKSIZE", "LONG", "LOOP", "LOWER", "MAINTAINED", "MATCH", "MATERIALIZED", "MAX", "MAXVALUE", "MEMBER", "MERGE", "METHOD", "MICROSECOND", "MICROSECONDS", "MIN", "MINUTE", "MINUTES", "MINVALUE", "MOD", "MODE", "MODIFIES", "MODULE", "MONTH", "MONTHS", "MULTISET", "NAN", "NATIONAL", "NATURAL", "NCHAR", "NCLOB", "NEW", "NEW_TABLE", "NEXTVAL", "NO", "NOCACHE", "NOCYCLE", "NODENAME", "NODENUMBER", "NOMAXVALUE", "NOMINVALUE", "NONE", "NOORDER", "NORMALIZE", "NORMALIZED", "NOT", "NULL", "NULLIF", "NULLS", "NUMERIC", "NUMPARTS", "OBID", "OCTET_LENGTH", "OF", "OFFSET", "OLD", "OLD_TABLE", "ON", "ONLY", "OPEN", "OPTIMIZATION", "OPTIMIZE", "OPTION", "ORDER", "OUT", "OUTER", "OVER", "OVERLAPS", "OVERLAY", "OVERRIDING", "PACKAGE", "PADDED", "PAGESIZE", "PARAMETER", "PART", "PARTITION", "PARTITIONED", "PARTITIONING", "PARTITIONS", "PASSWORD", "PATH", "PERCENTILE_CONT", "PERCENTILE_DISC", "PERCENT_RANK", "PIECESIZE", "PLAN", "POSITION", "POWER", "PRECISION", "PREPARE", "PREVVAL", "PRIMARY", "PRIQTY", "PRIVILEGES", "PROCEDURE", "PROGRAM", "PSID", "PUBLIC", "QUERY", "QUERYNO", "RANGE", "RANK", "READ", "READS", "REAL", "RECOVERY", "RECURSIVE", "REF", "REFERENCES", "REFERENCING", "REFRESH", "REGR_AVGX", "REGR_AVGY", "REGR_COUNT", "REGR_INTERCEPT", "REGR_R2", "REGR_SLOPE", "REGR_SXX", "REGR_SXY", "REGR_SYY", "RELEASE", "RENAME", "REPEAT", "RESET", "RESIGNAL", "RESTART", "RESTRICT", O = ["ADD", "AFTER", "ALTER COLUMN", "ALTER TABLE", "DELETE FROM", "EXCEPT", "FETCH FIRST", "FROM", "GROUP BY", "GO", "HAVING", "INSERT INTO", "INTERSECT", "LIMIT", "ORDER BY", "SELECT", "SET CURRENT SCHEMA", "SET SCHEMA", "SET", "UNION ALL", "UPDATE", "VALUES", "WHERE"], i = ["AND", "CROSS JOIN", "INNER JOIN", "JOIN", "LEFT JOIN", "LEFT OUTER JOIN", "OR", "OUTER JOIN", "RIGHT JOIN", "RIGHT OUTER JOIN"], S = void 0, u = function() { function e(E) { (0, T["default"])(this, e), this.cfg = E } return e.prototype.format = function(e) { return S || (S = new A["default"]({ reservedWords: I, reservedToplevelWords: O, reservedNewlineWords: i, stringTypes: ['""', "''", "``", "[]"], openParens: ["("], closeParens: [")"], indexedPlaceholderTypes: ["?"], namedPlaceholderTypes: [":"], lineCommentTypes: ["--"], specialWordChars: ["#", "@"] })), new o["default"](this.cfg, S).format(e) }, e }(); E["default"] = u, e.exports = E["default"] }, function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(1), T = n(r), R = t(4), o = n(R), N = t(5), A = n(N), I = ["ALL", "ALTER", "ANALYZE", "AND", "ANY", "ARRAY", "AS", "ASC", "BEGIN", "BETWEEN", "BINARY", "BOOLEAN", "BREAK", "BUCKET", "BUILD", "BY", "CALL", "CASE", "CAST", "CLUSTER", "COLLATE", "COLLECTION", "COMMIT", "CONNECT", "CONTINUE", "CORRELATE", "COVER", "CREATE", "DATABASE", "DATASET", "DATASTORE", "DECLARE", "DECREMENT", "DELETE", "DERIVED", "DESC", "DESCRIBE", "DISTINCT", "DO", "DROP", "EACH", "ELEMENT", "ELSE", "END", "EVERY", "EXCEPT", "EXCLUDE", "EXECUTE", "EXISTS", "EXPLAIN", "FALSE", "FETCH", "FIRST", "FLATTEN", "FOR", "FORCE", "FROM", "FUNCTION", "GRANT", "GROUP", "GSI", "HAVING", "IF", "IGNORE", "ILIKE", "IN", "INCLUDE", "INCREMENT", "INDEX", "INFER", "INLINE", "INNER", "INSERT", "INTERSECT", "INTO", "IS", "JOIN", "KEY", "KEYS", "KEYSPACE", "KNOWN", "LAST", "LEFT", "LET", "LETTING", "LIKE", "LIMIT", "LSM", "MAP", "MAPPING", "MATCHED", "MATERIALIZED", "MERGE", "MINUS", "MISSING", "NAMESPACE", "NEST", "NOT", "NULL", "NUMBER", "OBJECT", "OFFSET", "ON", "OPTION", "OR", "ORDER", "OUTER", "OVER", "PARSE", "PARTITION", "PASSWORD", "PATH", "POOL", "PREPARE", "PRIMARY", "PRIVATE", "PRIVILEGE", "PROCEDURE", "PUBLIC", "RAW", "REALM", "REDUCE", "RENAME", "RETURN", "RETURNING", "REVOKE", "RIGHT", "ROLE", "ROLLBACK", "SATISFIES", "SCHEMA", "SELECT", "SELF", "SEMI", "SET", "SHOW", "SOME", "START", "STATISTICS", "STRING", "SYSTEM", "THEN", "TO", "TRANSACTION", "TRIGGER", "TRUE", "TRUNCATE", "UNDER", "UNION", "UNIQUE", "UNKNOWN", "UNNEST", "UNSET", "UPDATE", "UPSERT", "USE", "USER", "USING", "VALIDATE", "VALUE", "VALUED", "VALUES", "VIA", "VIEW", "WHEN", "WHERE", "WHILE", "WITH", "WITHIN", "WORK", "XOR"], O = ["DELETE FROM", "EXCEPT ALL", "EXCEPT", "EXPLAIN DELETE FROM", "EXPLAIN UPDATE", "EXPLAIN UPSERT", "FROM", "GROUP BY", "HAVING", "INFER", "INSERT INTO", "INTERSECT ALL", "INTERSECT", "LET", "LIMIT", "MERGE", "NEST", "ORDER BY", "PREPARE", "SELECT", "SET CURRENT SCHEMA", "SET SCHEMA", "SET", "UNION ALL", "UNION", "UNNEST", "UPDATE", "UPSERT", "USE KEYS", "VALUES", "WHERE"], i = ["AND", "INNER JOIN", "JOIN", "LEFT JOIN", "LEFT OUTER JOIN", "OR", "OUTER JOIN", "RIGHT JOIN", "RIGHT OUTER JOIN", "XOR"], S = void 0, u = function() { function e(E) { (0, T["default"])(this, e), this.cfg = E } return e.prototype.format = function(e) { return S || (S = new A["default"]({ reservedWords: I, reservedToplevelWords: O, reservedNewlineWords: i, stringTypes: ['""', "''", "``"], openParens: ["(", "[", "{"], closeParens: [")", "]", "}"], namedPlaceholderTypes: ["$"], lineCommentTypes: ["#", "--"] })), new o["default"](this.cfg, S).format(e) }, e }(); E["default"] = u, e.exports = E["default"] }, function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(1), T = n(r), R = t(4), o = n(R), N = t(5), A = n(N), I = ["A", "ACCESSIBLE", "AGENT", "AGGREGATE", "ALL", "ALTER", "ANY", "ARRAY", "AS", "ASC", "AT", "ATTRIBUTE", "AUTHID", "AVG", "BETWEEN", "BFILE_BASE", "BINARY_INTEGER", "BINARY", "BLOB_BASE", "BLOCK", "BODY", "BOOLEAN", "BOTH", "BOUND", "BULK", "BY", "BYTE", "C", "CALL", "CALLING", "CASCADE", "CASE", "CHAR_BASE", "CHAR", "CHARACTER", "CHARSET", "CHARSETFORM", "CHARSETID", "CHECK", "CLOB_BASE", "CLONE", "CLOSE", "CLUSTER", "CLUSTERS", "COALESCE", "COLAUTH", "COLLECT", "COLUMNS", "COMMENT", "COMMIT", "COMMITTED", "COMPILED", "COMPRESS", "CONNECT", "CONSTANT", "CONSTRUCTOR", "CONTEXT", "CONTINUE", "CONVERT", "COUNT", "CRASH", "CREATE", "CREDENTIAL", "CURRENT", "CURRVAL", "CURSOR", "CUSTOMDATUM", "DANGLING", "DATA", "DATE_BASE", "DATE", "DAY", "DECIMAL", "DEFAULT", "DEFINE", "DELETE", "DESC", "DETERMINISTIC", "DIRECTORY", "DISTINCT", "DO", "DOUBLE", "DROP", "DURATION", "ELEMENT", "ELSIF", "EMPTY", "ESCAPE", "EXCEPTIONS", "EXCLUSIVE", "EXECUTE", "EXISTS", "EXIT", "EXTENDS", "EXTERNAL", "EXTRACT", "FALSE", "FETCH", "FINAL", "FIRST", "FIXED", "FLOAT", "FOR", "FORALL", "FORCE", "FROM", "FUNCTION", "GENERAL", "GOTO", "GRANT", "GROUP", "HASH", "HEAP", "HIDDEN", "HOUR", "IDENTIFIED", "IF", "IMMEDIATE", "IN", "INCLUDING", "INDEX", "INDEXES", "INDICATOR", "INDICES", "INFINITE", "INSTANTIABLE", "INT", "INTEGER", "INTERFACE", "INTERVAL", "INTO", "INVALIDATE", "IS", "ISOLATION", "JAVA", "LANGUAGE", "LARGE", "LEADING", "LENGTH", "LEVEL", "LIBRARY", "LIKE", "LIKE2", "LIKE4", "LIKEC", "LIMITED", "LOCAL", "LOCK", "LONG", "MAP", "MAX", "MAXLEN", "MEMBER", "MERGE", "MIN", "MINUS", "MINUTE", "MLSLABEL", "MOD", "MODE", "MONTH", "MULTISET", "NAME", "NAN", "NATIONAL", "NATIVE", "NATURAL", "NATURALN", "NCHAR", "NEW", "NEXTVAL", "NOCOMPRESS", "NOCOPY", "NOT", "NOWAIT", "NULL", "NULLIF", "NUMBER_BASE", "NUMBER", "OBJECT", "OCICOLL", "OCIDATE", "OCIDATETIME", "OCIDURATION", "OCIINTERVAL", "OCILOBLOCATOR", "OCINUMBER", "OCIRAW", "OCIREF", "OCIREFCURSOR", "OCIROWID", "OCISTRING", "OCITYPE", "OF", "OLD", "ON", "ONLY", "OPAQUE", "OPEN", "OPERATOR", "OPTION", "ORACLE", "ORADATA", "ORDER", "ORGANIZATION", "ORLANY", "ORLVARY", "OTHERS", "OUT", "OVERLAPS", "OVERRIDING", "PACKAGE", "PARALLEL_ENABLE", "PARAMETER", "PARAMETERS", "PARENT", "PARTITION", "PASCAL", "PCTFREE", "PIPE", "PIPELINED", "PLS_INTEGER", "PLUGGABLE", "POSITIVE", "POSITIVEN", "PRAGMA", "PRECISION", "PRIOR", "PRIVATE", "PROCEDURE", "PUBLIC", "RAISE", "RANGE", "RAW", "READ", "REAL", "RECORD", "REF", "REFERENCE", "RELEASE", "RELIES_ON", "REM", "REMAINDER", "RENAME", "RESOURCE", "RESULT_CACHE", "RESULT", "RETURN", "RETURNING", "REVERSE", "REVOKE", "ROLLBACK", "ROW", "ROWID", "ROWNUM", "ROWTYPE", "SAMPLE", "SAVE", "SAVEPOINT", "SB1", "SB2", "SB4", "SECOND", "SEGMENT", "SELF", "SEPARATE", "SEQUENCE", "SERIALIZABLE", "SHARE", "SHORT", "SIZE_T", "SIZE", "SMALLINT", "SOME", "SPACE", "SPARSE", "SQL", "SQLCODE", "SQLDATA", "SQLERRM", "SQLNAME", "SQLSTATE", "STANDARD", "START", "STATIC", "STDDEV", "STORED", "STRING", "STRUCT", "STYLE", "SUBMULTISET", "SUBPARTITION", "SUBSTITUTABLE", "SUBTYPE", "SUCCESSFUL", "SUM", "SYNONYM", "SYSDATE", "TABAUTH", "TABLE", "TDO", "THE", "THEN", "TIME", "TIMESTAMP", "TIMEZONE_ABBR", "TIMEZONE_HOUR", "TIMEZONE_MINUTE", "TIMEZONE_REGION", "TO", "TRAILING", "TRANSACTION", "TRANSACTIONAL", "TRIGGER", "TRUE", "TRUSTED", "TYPE", "UB1", "UB2", "UB4", "UID", "UNDER", "UNIQUE", "UNPLUG", "UNSIGNED", "UNTRUSTED", "USE", "USER", "USING", "VALIDATE", "VALIST", "VALUE", "VARCHAR", "VARCHAR2", "VARIABLE", "VARIANCE", "VARRAY", "VARYING", "VIEW", "VIEWS", "VOID", "WHENEVER", "WHILE", "WITH", "WORK", "WRAPPED", "WRITE", "YEAR", "ZONE"], O = ["ADD", "ALTER COLUMN", "ALTER TABLE", "BEGIN", "CONNECT BY", "DECLARE", "DELETE FROM", "DELETE", "END", "EXCEPT", "EXCEPTION", "FETCH FIRST", "FROM", "GROUP BY", "HAVING", "INSERT INTO", "INSERT", "INTERSECT", "LIMIT", "LOOP", "MODIFY", "ORDER BY", "SELECT", "SET CURRENT SCHEMA", "SET SCHEMA", "SET", "START WITH", "UNION ALL", "UNION", "UPDATE", "VALUES", "WHERE"], i = ["AND", "CROSS APPLY", "CROSS JOIN", "ELSE", "END", "INNER JOIN", "JOIN", "LEFT JOIN", "LEFT OUTER JOIN", "OR", "OUTER APPLY", "OUTER JOIN", "RIGHT JOIN", "RIGHT OUTER JOIN", "WHEN", "XOR"], S = void 0, u = function() { function e(E) { (0, T["default"])(this, e), this.cfg = E } return e.prototype.format = function(e) { return S || (S = new A["default"]({ reservedWords: I, reservedToplevelWords: O, reservedNewlineWords: i, stringTypes: ['""', "N''", "''", "``"], openParens: ["(", "CASE"], closeParens: [")", "END"], indexedPlaceholderTypes: ["?"], namedPlaceholderTypes: [":"], lineCommentTypes: ["--"], specialWordChars: ["_", "$", "#", ".", "@"] })), new o["default"](this.cfg, S).format(e) }, e }(); E["default"] = u, e.exports = E["default"] }, function(e, E, t) { "use strict"; function n(e) { return e && e.__esModule ? e : { "default": e } } E.__esModule = !0; var r = t(1), T = n(r), R = t(4), o = n(R), N = t(5), A = n(N), I = ["ACCESSIBLE", "ACTION", "AGAINST", "AGGREGATE", "ALGORITHM", "ALL", "ALTER", "ANALYSE", "ANALYZE", "AS", "ASC", "AUTOCOMMIT", "AUTO_INCREMENT", "BACKUP", "BEGIN", "BETWEEN", "BINLOG", "BOTH", "CASCADE", "CASE", "CHANGE", "CHANGED", "CHARACTER SET", "CHARSET", "CHECK", "CHECKSUM", "COLLATE", "COLLATION", "COLUMN", "COLUMNS", "COMMENT", "COMMIT", "COMMITTED", "COMPRESSED", "CONCURRENT", "CONSTRAINT", "CONTAINS", "CONVERT", "CREATE", "CROSS", "CURRENT_TIMESTAMP", "DATABASE", "DATABASES", "DAY", "DAY_HOUR", "DAY_MINUTE", "DAY_SECOND", "DEFAULT", "DEFINER", "DELAYED", "DELETE", "DESC", "DESCRIBE", "DETERMINISTIC", "DISTINCT", "DISTINCTROW", "DIV", "DO", "DROP", "DUMPFILE", "DUPLICATE", "DYNAMIC", "ELSE", "ENCLOSED", "END", "ENGINE", "ENGINES", "ENGINE_TYPE", "ESCAPE", "ESCAPED", "EVENTS", "EXEC", "EXECUTE", "EXISTS", "EXPLAIN", "EXTENDED", "FAST", "FETCH", "FIELDS", "FILE", "FIRST", "FIXED", "FLUSH", "FOR", "FORCE", "FOREIGN", "FULL", "FULLTEXT", "FUNCTION", "GLOBAL", "GRANT", "GRANTS", "GROUP_CONCAT", "HEAP", "HIGH_PRIORITY", "HOSTS", "HOUR", "HOUR_MINUTE", "HOUR_SECOND", "IDENTIFIED", "IF", "IFNULL", "IGNORE", "IN", "INDEX", "INDEXES", "INFILE", "INSERT", "INSERT_ID", "INSERT_METHOD", "INTERVAL", "INTO", "INVOKER", "IS", "ISOLATION", "KEY", "KEYS", "KILL", "LAST_INSERT_ID", "LEADING", "LEVEL", "LIKE", "LINEAR", "LINES", "LOAD", "LOCAL", "LOCK", "LOCKS", "LOGS", "LOW_PRIORITY", "MARIA", "MASTER", "MASTER_CONNECT_RETRY", "MASTER_HOST", "MASTER_LOG_FILE", "MATCH", "MAX_CONNECTIONS_PER_HOUR", "MAX_QUERIES_PER_HOUR", "MAX_ROWS", "MAX_UPDATES_PER_HOUR", "MAX_USER_CONNECTIONS", "MEDIUM", "MERGE", "MINUTE", "MINUTE_SECOND", "MIN_ROWS", "MODE", "MODIFY", "MONTH", "MRG_MYISAM", "MYISAM", "NAMES", "NATURAL", "NOT", "NOW()", "NULL", "OFFSET", "ON DELETE", "ON UPDATE", "ON", "ONLY", "OPEN", "OPTIMIZE", "OPTION", "OPTIONALLY", "OUTFILE", "PACK_KEYS", "PAGE", "PARTIAL", "PARTITION", "PARTITIONS", "PASSWORD", "PRIMARY", "PRIVILEGES", "PROCEDURE", "PROCESS", "PROCESSLIST", "PURGE", "QUICK", "RAID0", "RAID_CHUNKS", "RAID_CHUNKSIZE", "RAID_TYPE", "RANGE", "READ", "READ_ONLY", "READ_WRITE", "REFERENCES", "REGEXP", "RELOAD", "RENAME", "REPAIR", "REPEATABLE", "REPLACE", "REPLICATION", "RESET", "RESTORE", "RESTRICT", "RETURN", "RETURNS", "REVOKE", "RLIKE", "ROLLBACK", "ROW", "ROWS", "ROW_FORMAT", "SECOND", "SECURITY", "SEPARATOR", "SERIALIZABLE", "SESSION", "SHARE", "SHOW", "SHUTDOWN", "SLAVE", "SONAME", "SOUNDS", "SQL", "SQL_AUTO_IS_NULL", "SQL_BIG_RESULT", "SQL_BIG_SELECTS", "SQL_BIG_TABLES", "SQL_BUFFER_RESULT", "SQL_CACHE", "SQL_CALC_FOUND_ROWS", "SQL_LOG_BIN", "SQL_LOG_OFF", "SQL_LOG_UPDATE", "SQL_LOW_PRIORITY_UPDATES", "SQL_MAX_JOIN_SIZE", "SQL_NO_CACHE", "SQL_QUOTE_SHOW_CREATE", "SQL_SAFE_UPDATES", "SQL_SELECT_LIMIT", "SQL_SLAVE_SKIP_COUNTER", "SQL_SMALL_RESULT", "SQL_WARNINGS", "START", "STARTING", "STATUS", "STOP", "STORAGE", "STRAIGHT_JOIN", "STRING", "STRIPED", "SUPER", "TABLE", "TABLES", "TEMPORARY", "TERMINATED", "THEN", "TO", "TRAILING", "TRANSACTIONAL", "TRUE", "TRUNCATE", "TYPE", "TYPES", "UNCOMMITTED", "UNIQUE", "UNLOCK", "UNSIGNED", "USAGE", "USE", "USING", "VARIABLES", "VIEW", "WHEN", "WITH", "WORK", "WRITE", "YEAR_MONTH"], O = ["ADD", "AFTER", "ALTER COLUMN", "ALTER TABLE", "DELETE FROM", "EXCEPT", "FETCH FIRST", "FROM", "GROUP BY", "GO", "HAVING", "INSERT INTO", "INSERT", "INTERSECT", "LIMIT", "MODIFY", "ORDER BY", "SELECT", "SET CURRENT SCHEMA", "SET SCHEMA", "SET", "UNION ALL", "UNION", "UPDATE", "VALUES", "WHERE"], i = ["AND", "CROSS APPLY", "CROSS JOIN", "ELSE", "INNER JOIN", "JOIN", "LEFT JOIN", "LEFT OUTER JOIN", "OR", "OUTER APPLY", "OUTER JOIN", "RIGHT JOIN", "RIGHT OUTER JOIN", "WHEN", "XOR"], S = void 0, u = function() { function e(E) { (0, T["default"])(this, e), this.cfg = E } return e.prototype.format = function(e) { return S || (S = new A["default"]({ reservedWords: I, reservedToplevelWords: O, reservedNewlineWords: i, stringTypes: ['""', "N''", "''", "``", "[]"], openParens: ["(", "CASE"], closeParens: [")", "END"], indexedPlaceholderTypes: ["?"], namedPlaceholderTypes: ["@", ":"], lineCommentTypes: ["#", "--"] })), new o["default"](this.cfg, S).format(e) }, e }(); E["default"] = u, e.exports = E["default"] }, function(e, E, t) { var n = t(3), r = t(2), T = n(r, "DataView"); e.exports = T }, function(e, E, t) { var n = t(3), r = t(2), T = n(r, "Map"); e.exports = T }, function(e, E, t) { var n = t(3), r = t(2), T = n(r, "Promise"); e.exports = T }, function(e, E, t) { var n = t(3), r = t(2), T = n(r, "Set"); e.exports = T }, function(e, E, t) { var n = t(2), r = n.Symbol; e.exports = r }, function(e, E, t) { var n = t(3), r = t(2), T = n(r, "WeakMap"); e.exports = T }, function(e, E) { function t(e) { return e.split("") } e.exports = t }, function(e, E) { function t(e, E, t, n) { for (var r = e.length, T = t + (n ? 1 : -1); n ? T-- : ++T < r;) if (E(e[T], T, e)) return T; return -1 } e.exports = t }, function(e, E) { function t(e) { return r.call(e) } var n = Object.prototype, r = n.toString; e.exports = t }, function(e, E, t) { function n(e, E, t) { return E === E ? R(e, E, t) : r(e, T, t) } var r = t(29), T = t(32), R = t(49); e.exports = n }, function(e, E) { function t(e) { return e !== e } e.exports = t }, function(e, E, t) { function n(e) { if (!R(e) || T(e)) return !1; var E = r(e) ? u : A; return E.test(o(e)) } var r = t(12), T = t(45), R = t(6), o = t(11), N = /[\\^$.*+?()[\]{}|]/g, A = /^\[object .+?Constructor\]$/, I = Function.prototype, O = Object.prototype, i = I.toString, S = O.hasOwnProperty, u = RegExp("^" + i.call(S).replace(N, "\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g, "$1.*?") + "$"); e.exports = n }, function(e, E) { function t(e, E) { var t = ""; if (!e || 1 > E || E > n) return t; do E % 2 && (t += e), E = r(E / 2), E && (e += e); while (E); return t } var n = 9007199254740991, r = Math.floor; e.exports = t }, function(e, E) { function t(e, E, t) { var n = -1, r = e.length; 0 > E && (E = -E > r ? 0 : r + E), t = t > r ? r : t, 0 > t && (t += r), r = E > t ? 0 : t - E >>> 0, E >>>= 0; for (var T = Array(r); ++n < r;) T[n] = e[n + E]; return T } e.exports = t }, function(e, E, t) { function n(e, E, t) { var n = e.length; return t = void 0 === t ? n : t, E || n > t ? r(e, E, t) : e } var r = t(35); e.exports = n }, function(e, E, t) { function n(e, E) { for (var t = e.length; t-- && r(E, e[t], 0) > -1;); return t } var r = t(31); e.exports = n }, function(e, E, t) { var n = t(2), r = n["__core-js_shared__"]; e.exports = r }, function(e, E) { (function(E) { var t = "object" == typeof E && E && E.Object === Object && E; e.exports = t }).call(E, function() { return this }()) }, function(e, E, t) { var n = t(22), r = t(23), T = t(24), R = t(25), o = t(27), N = t(30), A = t(11), I = "[object Map]", O = "[object Object]", i = "[object Promise]", S = "[object Set]", u = "[object WeakMap]", L = "[object DataView]", C = Object.prototype, s = C.toString, a = A(n), f = A(r), c = A(T), p = A(R), l = A(o), D = N; (n && D(new n(new ArrayBuffer(1))) != L || r && D(new r) != I || T && D(T.resolve()) != i || R && D(new R) != S || o && D(new o) != u) && (D = function(e) { var E = s.call(e), t = E == O ? e.constructor : void 0, n = t ? A(t) : void 0; if (n) switch (n) { case a: return L; case f: return I; case c: return i; case p: return S; case l: return u } return E }), e.exports = D }, function(e, E) { function t(e, E) { return null == e ? void 0 : e[E] } e.exports = t }, function(e, E) { function t(e) { return N.test(e) } var n = "\\ud800-\\udfff", r = "\\u0300-\\u036f\\ufe20-\\ufe23", T = "\\u20d0-\\u20f0", R = "\\ufe0e\\ufe0f", o = "\\u200d", N = RegExp("[" + o + n + r + T + R + "]"); e.exports = t }, function(e, E) { function t(e, E) { return E = null == E ? n : E, !!E && ("number" == typeof e || r.test(e)) && e > -1 && e % 1 == 0 && E > e } var n = 9007199254740991, r = /^(?:0|[1-9]\d*)$/; e.exports = t }, function(e, E, t) { function n(e, E, t) { if (!o(t)) return !1; var n = typeof E; return !!("number" == n ? T(t) && R(E, t.length) : "string" == n && E in t) && r(t[E], e) } var r = t(52), T = t(8), R = t(43), o = t(6); e.exports = n }, function(e, E, t) { function n(e) { return !!T && T in e } var r = t(38), T = function() { var e = /[^.]+$/.exec(r && r.keys && r.keys.IE_PROTO || ""); return e ? "Symbol(src)_1." + e : "" }(); e.exports = n }, function(e, E) { function t(e) { var E = e && e.constructor, t = "function" == typeof E && E.prototype || n; return e === t } var n = Object.prototype; e.exports = t }, function(e, E, t) { var n = t(48), r = n(Object.keys, Object); e.exports = r }, function(e, E) { function t(e, E) { return function(t) { return e(E(t)) } } e.exports = t }, function(e, E) { function t(e, E, t) { for (var n = t - 1, r = e.length; ++n < r;) if (e[n] === E) return n; return -1 } e.exports = t }, function(e, E, t) { function n(e) { return T(e) ? R(e) : r(e) } var r = t(28), T = t(42), R = t(51); e.exports = n }, function(e, E) { function t(e) { return e.match(c) || [] } var n = "\\ud800-\\udfff", r = "\\u0300-\\u036f\\ufe20-\\ufe23", T = "\\u20d0-\\u20f0", R = "\\ufe0e\\ufe0f", o = "[" + n + "]", N = "[" + r + T + "]", A = "\\ud83c[\\udffb-\\udfff]", I = "(?:" + N + "|" + A + ")", O = "[^" + n + "]", i = "(?:\\ud83c[\\udde6-\\uddff]){2}", S = "[\\ud800-\\udbff][\\udc00-\\udfff]", u = "\\u200d", L = I + "?", C = "[" + R + "]?", s = "(?:" + u + "(?:" + [O, i, S].join("|") + ")" + C + L + ")*", a = C + L + s, f = "(?:" + [O + N + "?", N, i, S, o].join("|") + ")", c = RegExp(A + "(?=" + A + ")|" + f + a, "g"); e.exports = t }, function(e, E) { function t(e, E) { return e === E || e !== e && E !== E } e.exports = t }, function(e, E, t) { function n(e) { return e = r(e), e && R.test(e) ? e.replace(T, "\\$&") : e } var r = t(9), T = /[\\^$.*+?()[\]{}|]/g, R = RegExp(T.source); e.exports = n }, function(e, E, t) { function n(e) { return r(e) && o.call(e, "callee") && (!A.call(e, "callee") || N.call(e) == T) } var r = t(56), T = "[object Arguments]", R = Object.prototype, o = R.hasOwnProperty, N = R.toString, A = R.propertyIsEnumerable; e.exports = n }, function(e, E) { var t = Array.isArray; e.exports = t }, function(e, E, t) { function n(e) { return T(e) && r(e) } var r = t(8), T = t(13); e.exports = n }, function(e, E, t) { (function(e) { var n = t(2), r = t(62), T = "object" == typeof E && E && !E.nodeType && E, R = T && "object" == typeof e && e && !e.nodeType && e, o = R && R.exports === T, N = o ? n.Buffer : void 0, A = N ? N.isBuffer : void 0, I = A || r; e.exports = I }).call(E, t(67)(e)) }, function(e, E, t) { function n(e) { if (o(e) && (R(e) || "string" == typeof e || "function" == typeof e.splice || N(e) || T(e))) return !e.length; var E = r(e); if (E == O || E == i) return !e.size; if (A(e)) return !I(e).length; for (var t in e) if (u.call(e, t)) return !1; return !0 } var r = t(40), T = t(54), R = t(55), o = t(8), N = t(57), A = t(46), I = t(47), O = "[object Map]", i = "[object Set]", S = Object.prototype, u = S.hasOwnProperty; e.exports = n }, function(e, E) { function t(e) { return "number" == typeof e && e > -1 && e % 1 == 0 && n >= e } var n = 9007199254740991; e.exports = t }, function(e, E) { function t(e) { var E = e ? e.length : 0; return E ? e[E - 1] : void 0 } e.exports = t }, function(e, E, t) { function n(e, E, t) { return E = (t ? T(e, E, t) : void 0 === E) ? 1 : R(E), r(o(e), E) } var r = t(34), T = t(44), R = t(64), o = t(9); e.exports = n }, function(e, E) { function t() { return !1 } e.exports = t }, function(e, E, t) { function n(e) { if (!e) return 0 === e ? e : 0; if (e = r(e), e === T || e === -T) { var E = 0 > e ? -1 : 1; return E * R } return e === e ? e : 0 } var r = t(65), T = 1 / 0, R = 1.7976931348623157e308; e.exports = n }, function(e, E, t) { function n(e) { var E = r(e), t = E % 1; return E === E ? t ? E - t : E : 0 } var r = t(63); e.exports = n }, function(e, E, t) { function n(e) { if ("number" == typeof e) return e; if (T(e)) return R; if (r(e)) { var E = "function" == typeof e.valueOf ? e.valueOf() : e; e = r(E) ? E + "" : E } if ("string" != typeof e) return 0 === e ? e : +e; e = e.replace(o, ""); var t = A.test(e); return t || I.test(e) ? O(e.slice(2), t ? 2 : 8) : N.test(e) ? R : +e } var r = t(6), T = t(14), R = NaN, o = /^\s+|\s+$/g, N = /^[-+]0x[0-9a-f]+$/i, A = /^0b[01]+$/i, I = /^0o[0-7]+$/i, O = parseInt; e.exports = n }, function(e, E, t) { function n(e, E, t) { if (e = N(e), e && (t || void 0 === E)) return e.replace(A, ""); if (!e || !(E = r(E))) return e; var n = o(e), I = R(n, o(E)) + 1; return T(n, 0, I).join("") } var r = t(10), T = t(36), R = t(37), o = t(50), N = t(9), A = /\s+$/; e.exports = n }, function(e, E) { e.exports = function(e) { return e.webpackPolyfill || (e.deprecate = function() {}, e.paths = [], e.children = [], e.webpackPolyfill = 1), e } }]) }); function escape2Html(str) { var arrEntities = { 'lt': '<', 'gt': '>', 'nbsp': '', 'amp': '&', 'quot': '"' }; return str.replace(/&(lt|gt|nbsp|amp|quot);/ig, function(all, t) { return arrEntities[t]; }); } function load() { let codeList = document.getElementsByTagName('code'); for (let i = 0; i < codeList.length; i++) { codeList[i].innerHTML = window.sqlFormatter.format(escape2Html(codeList[i].innerHTML)) } }; ================================================ FILE: doc/report_type.md ================================================ # 支持的报告类型 [toc] ## lint * **Description**:参考sqlint格式,以插件形式集成到代码编辑器,显示输出更加友好 * **Example**: ```bash soar -report-type lint -query test.sql ``` ## markdown * **Description**:该格式为默认输出格式,以markdown格式展现,可以用网页浏览器插件直接打开,也可以用markdown编辑器打开 * **Example**: ```bash echo "select * from film" | soar ``` ## rewrite * **Description**:SQL重写功能,配合-rewrite-rules参数一起使用,可以通过-list-rewrite-rules 查看所有支持的 SQL 重写规则 * **Example**: ```bash echo "select * from film" | soar -rewrite-rules star2columns,delimiter -report-type rewrite ``` ## ast * **Description**:输出 SQL 的抽象语法树,主要用于测试 * **Example**: ```bash echo "select * from film" | soar -report-type ast ``` ## ast-json * **Description**:以 JSON 格式输出 SQL 的抽象语法树,主要用于测试 * **Example**: ```bash echo "select * from film" | soar -report-type ast-json ``` ## tiast * **Description**:输出 SQL 的 TiDB抽象语法树,主要用于测试 * **Example**: ```bash echo "select * from film" | soar -report-type tiast ``` ## tiast-json * **Description**:以 JSON 格式输出 SQL 的 TiDB抽象语法树,主要用于测试 * **Example**: ```bash echo "select * from film" | soar -report-type tiast-json ``` ## tables * **Description**:以 JSON 格式输出 SQL 使用的库表名 * **Example**: ```bash echo "select * from film" | soar -report-type tables ``` ## query-type * **Description**:SQL 语句的请求类型 * **Example**: ```bash echo "select * from film" | soar -report-type query-type ``` ## fingerprint * **Description**:输出SQL的指纹 * **Example**: ```bash echo "select * from film where language_id=1" | soar -report-type fingerprint ``` ## md2html * **Description**:markdown 格式转 html 格式小工具 * **Example**: ```bash soar -list-heuristic-rules | soar -report-type md2html > heuristic_rules.html ``` ## explain-digest * **Description**:输入为EXPLAIN的表格,JSON 或 Vertical格式,对其进行分析,给出分析结果 * **Example**: ```bash soar -report-type explain-digest << EOF +----+-------------+-------+------+---------------+------+---------+------+------+-------+ | id | select_type | table | type | possible_keys | key | key_len | ref | rows | Extra | +----+-------------+-------+------+---------------+------+---------+------+------+-------+ | 1 | SIMPLE | film | ALL | NULL | NULL | NULL | NULL | 1131 | | +----+-------------+-------+------+---------------+------+---------+------+------+-------+ EOF ``` ## duplicate-key-checker * **Description**:对 OnlineDsn 中指定的 database 进行索引重复检查 * **Example**: ```bash soar -report-type duplicate-key-checker -online-dsn user:password@127.0.0.1:3306/db ``` ## html * **Description**:以HTML格式输出报表 * **Example**: ```bash echo "select * from film" | soar -report-type html ``` ## json * **Description**:输出JSON格式报表,方便应用程序处理 * **Example**: ```bash echo "select * from film" | soar -report-type json ``` ## tokenize * **Description**:对SQL进行切词,主要用于测试 * **Example**: ```bash echo "select * from film" | soar -report-type tokenize ``` ## compress * **Description**:SQL压缩小工具,使用内置SQL压缩逻辑,测试中的功能 * **Example**: ```bash echo "select * from film" | soar -report-type compress ``` ## pretty * **Description**:使用kr/pretty打印报告,主要用于测试 * **Example**: ```bash echo "select * from film" | soar -report-type pretty ``` ## remove-comment * **Description**:去除SQL语句中的注释,支持单行多行注释的去除 * **Example**: ```bash echo "select/*comment*/ * from film" | soar -report-type remove-comment ``` ## chardet * **Description**:猜测输入的 SQL 使用的字符集 * **Example**: ```bash echo '中文' | soar -report-type chardet ``` ================================================ FILE: doc/rewrite.md ================================================ # 重写规则 [toc] ## dml2select * **Description**:将数据库更新请求转换为只读查询请求,便于执行EXPLAIN * **Original**: ```sql DELETE FROM film WHERE length > 100 ``` * **Suggest**: ```sql select * from film where length > 100 ``` ## reg2select * **Description**:使用正则的方式将数据库更新请求转换为只读查询请求,便于执行EXPLAIN * **Original**: ```sql DELETE FROM film WHERE length > 100 ``` * **Suggest**: ```sql select * from film where length > 100 ``` ## star2columns * **Description**:为SELECT *补全表的列信息 * **Original**: ```sql SELECT * FROM film ``` * **Suggest**: ```sql select film.film_id, film.title from film ``` ## insertcolumns * **Description**:为INSERT补全表的列信息 * **Original**: ```sql insert into film values(1,2,3,4,5) ``` * **Suggest**: ```sql insert into film(film_id, title, description, release_year, language_id) values (1, 2, 3, 4, 5) ``` ## having * **Description**:将查询的 HAVING 子句改写为 WHERE 中的查询条件 * **Original**: ```sql SELECT state, COUNT(*) FROM Drivers GROUP BY state HAVING state IN ('GA', 'TX') ORDER BY state ``` * **Suggest**: ```sql select state, COUNT(*) from Drivers where state in ('GA', 'TX') group by state order by state asc ``` ## orderbynull * **Description**:如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 ORDER BY NULL * **Original**: ```sql SELECT sum(col1) FROM tbl GROUP BY col ``` * **Suggest**: ```sql select sum(col1) from tbl group by col order by null ``` ## unionall * **Description**:可以接受重复的时间,使用 UNION ALL 替代 UNION 以提高查询效率 * **Original**: ```sql select country_id from city union select country_id from country ``` * **Suggest**: ```sql select country_id from city union all select country_id from country ``` ## or2in * **Description**:将同一列不同条件的 OR 查询转写为 IN 查询 * **Original**: ```sql select country_id from city where col1 = 1 or (col2 = 1 or col2 = 2 ) or col1 = 3; ``` * **Suggest**: ```sql select country_id from city where (col2 in (1, 2)) or col1 in (1, 3); ``` ## dmlorderby * **Description**:删除 DML 更新操作中无意义的 ORDER BY * **Original**: ```sql DELETE FROM tbl WHERE col1=1 ORDER BY col ``` * **Suggest**: ```sql delete from tbl where col1 = 1 ``` ## distinctstar * **Description**:DISTINCT *对有主键的表没有意义,可以将DISTINCT删掉 * **Original**: ```sql SELECT DISTINCT * FROM film; ``` * **Suggest**: ```sql SELECT * FROM film ``` ## standard * **Description**:SQL标准化,如:关键字转换为小写 * **Original**: ```sql SELECT sum(col1) FROM tbl GROUP BY 1; ``` * **Suggest**: ```sql select sum(col1) from tbl group by 1 ``` ## mergealter * **Description**:合并同一张表的多条ALTER语句 * **Original**: ```sql ALTER TABLE t2 DROP COLUMN c;ALTER TABLE t2 DROP COLUMN d; ``` * **Suggest**: ```sql ALTER TABLE t2 DROP COLUMN c, DROP COLUMN d; ``` ## alwaystrue * **Description**:删除无用的恒真判断条件 * **Original**: ```sql SELECT count(col) FROM tbl where 'a'= 'a' or ('b' = 'b' and a = 'b'); ``` * **Suggest**: ```sql select count(col) from tbl where (a = 'b'); ``` ## countstar * **Description**:不建议使用COUNT(col)或COUNT(常量),建议改写为COUNT(*) * **Original**: ```sql SELECT count(col) FROM tbl GROUP BY 1; ``` * **Suggest**: ```sql SELECT count(*) FROM tbl GROUP BY 1; ``` ## innodb * **Description**:建表时建议使用InnoDB引擎,非 InnoDB 引擎表自动转 InnoDB * **Original**: ```sql CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT); ``` * **Suggest**: ```sql create table t1 ( id bigint(20) not null auto_increment ) ENGINE=InnoDB; ``` ## autoincrement * **Description**:将autoincrement初始化为1 * **Original**: ```sql CREATE TABLE t1(id bigint(20) NOT NULL AUTO_INCREMENT) ENGINE=InnoDB AUTO_INCREMENT=123802; ``` * **Suggest**: ```sql create table t1(id bigint(20) not null auto_increment) ENGINE=InnoDB auto_increment=1; ``` ## intwidth * **Description**:整型数据类型修改默认显示宽度 * **Original**: ```sql create table t1 (id int(20) not null auto_increment) ENGINE=InnoDB; ``` * **Suggest**: ```sql create table t1 (id int(10) not null auto_increment) ENGINE=InnoDB; ``` ## truncate * **Description**:不带 WHERE 条件的 DELETE 操作建议修改为 TRUNCATE * **Original**: ```sql DELETE FROM tbl ``` * **Suggest**: ```sql truncate table tbl ``` ## rmparenthesis * **Description**:去除没有意义的括号 * **Original**: ```sql select col from table where (col = 1); ``` * **Suggest**: ```sql select col from table where col = 1; ``` ## delimiter * **Description**:补全DELIMITER * **Original**: ```sql use sakila ``` * **Suggest**: ```sql use sakila; ``` ================================================ FILE: doc/roadmap.md ================================================ ## 路线图 * 语法支持方面,目前主要依赖vitess,TiDB对SQL语法的支持。 * 目前仅针对MySQL语法族进行开发和测试,其他使用SQL的数据库产品暂不支持。 * Profiling和Trace功能有待深入挖掘,供经验丰富的DBA分析使用。 * 目前尚不支持直接线上自动执行评审通过的SQL,后续会努力支持。 * 由于暂不支持线上自动执行,因此数据备份功能也未提供。 * Vim, Sublime, Emacs等编辑器插件支持。 * Currently, only support Chinese suggestion, if you can help us add multi-language support, it will be greatly appreciated. ================================================ FILE: doc/structure.md ================================================ # 体系架构 ![架构图](https://raw.githubusercontent.com/XiaoMi/soar/master/doc/images/structure.png) SOAR主要由语法解析器,集成环境,优化建议,重写逻辑,工具集五大模块组成。下面将对每个模块的作用及设计实现进行简述,更详细的算法及逻辑会在各个独立章节中详细讲解。 ## 语法解析和语法检查 一条SQL从文件,标准输入或命令行参数等形式传递给SOAR后首先进入语法解析器,这里一开始我们选用了vitess的语法解析库作为SOAR的语法解析库,但随时需求的不断增加我们发现有些复杂需求使用vitess的语法解析实现起来比较逻辑比较复杂。于是参考业务其他数据库产品,我们引入了TiDB的语法解析器做为补充。我们发现这两个解析库还存在一定的盲区,于是又引入了MySQL执行返回结果作为多版本SQL方言的补充。大家也可以看到在语法解析器这里,SOAR的实现方案是松散的、可插拔的。SOAR并不直接维护庞大的语法解析库,它把各种优秀的语法解析库集成在一起,各取所长。 ## 集成环境 集成环境区分`线上环境`和`测试环境`两种,分别用于解决不同场景下用户的SQL优化需求。一种常见的情况是已有表结构需要优化查询SQL的场景,可以从线上环境导出表结构和足够的采样数据到测试环境,在测试环境上就可以放心的执行各种高危操作而不用担心数据被损坏。另一种常见的情况是建一套全新的数据库,需要验证提供的数据字典中是否存在优化的可能。对于这种情况,很有可能你不需要知道线上环境在哪儿,完全只是想先试试看,如果报错了马上改对就是了。当然还有更多种组合的场景需求,将在[集成环境](http://github.com/XiaoMi/soar/blob/master/doc/environment.md)中介绍。 ## 优化建议 目前SOAR可以提供的优化建议有基于启发式规则(通常也称之为经验)的优化建议,基于索引优化算法给出的索引优化建议,以及基于EXPLAIN信息给出的解读。 ### 启发式规则建议 下面这段代码是启发式规则的的元数据结构,它由规则代号,危险等级,规则摘要,规则解释,SQL示例,建议位置,规则函数等7部分组成。每一条SQL经过语法解析后会经过数百个启发式规则的逐一检查,命中了的规则将会保存在一个叫heuristicSuggest的变量中传递下去,与其他优化建议合并输出。这里最核心的部分,也是代码最多的部分在heuristic.go,里面包含了所有的启发式规则实现的函数。所有的启发式规则列表保存在rules.go文件中。 ```Golang // Rule 评审规则元数据结构 type Rule struct { Item string `json:"Item"` // 规则代号 Severity string `json:"Severity"` // 危险等级:L[0-8], 数字越大表示级别越高 Summary string `json:"Summary"` // 规则摘要 Content string `json:"Content"` // 规则解释 Case string `json:"Case"` // SQL示例 Position int `json:"Position"` // 建议所处SQL字符位置,默认0表示全局建议 Func func(*Query4Audit) Rule `json:"-"` // 函数名 } ``` ### 索引优化 关于索引优化,数据库经过几十年的发展,DBA沉淀了很多宝贵的经验,怎样把这些感性的经验转化为覆盖全面、逻辑可推导的算法是这种模块最大的挑战。很幸运的是SOAR并不是第一个尝试做这类算法整理的产品,有很多前人的著作、论文、博客等的知识储备。毫不夸张的说,为了写成这个模块我们读了不下5百万字的著作和论文,还不包括网络上各种大神的博客,这些老师们的知识结晶收集整理在[鸣谢](http://github.com/XiaoMi/soar/blob/master/doc/thanks.md)章节。使用到的算法在[索引优化](http://github.com/XiaoMi/soar/blob/master/doc/indexing.md)章节有详细的描述,虽然在某些算法理解上可能还存在一定争议,很希望与同行们共同讨论,共同进步,不断完善SOAR的算法。 ### EXPLAIN解读 做过SQL优化的人对EXPLAIN应该都不陌生,但对于新手来说要记住每一个列代表什么含义,每个关键字背后的奥秘是什么需要足够的脑容量来记忆才行。统计了一下SOAR只在EXPLAIN信息的注解一项差不多写了200行代码,按平均行长度120计算,算下来一个DBA要精通EXPLAIN优化就要记住不下2万字的文档。SOAR能帮每为DBA节约了这部分脑容量。不过关于EXPLAIN解读还远不止这些,想了解更多可以参考[EXPLAIN信息解读](http://github.com/XiaoMi/soar/blob/master/doc/explain.md)章节。 ## 重写逻辑 上面提到的优化建议是我们早期实现的主要功能,早期的功能还只是停留在建议上,对于一些初级用户看到建议也不一定会改写。为了进一步简化SQL优化的成本,SOAR又进一步挖掘了自动SQL重写的功能。现在提供几十种常见场景下的SQL等价转写,不过相比SQL优化建议还有很大的改进空间。这部分的功能和逻辑将在[重写逻辑](http://github.com/XiaoMi/soar/blob/master/doc/rewrite.md)一章中详细说明。 ## 工具集 除了SQL优化和改写以外,为了方便用户使用以及美化输出展现形式,SOAR还提供了一些辅助的小工具,比如markdown转HTML工具,SQL格式化输出工具等等。你可以在[常用命令](http://github.com/XiaoMi/soar/blob/master/doc/cheatsheet.md)中找到这些小工具的使用方法。 ================================================ FILE: doc/thanks.md ================================================ ## 鸣谢 以下为SOAR的灵感及代码来源,我们站在伟人的肩膀上,让DBA的工作和生活更美好。 * [vitess](https://github.com/vitessio/vitess) * [SQLAdvisor](https://github.com/Meituan-Dianping/SQLAdvisor) * [pt-query-advisor](https://www.percona.com/doc/percona-toolkit/2.1/pt-query-advisor.html) * [sqlcheck](https://github.com/jarulraj/sqlcheck) * [pg_idx_advisor](https://github.com/cohenjo/pg_idx_advisor) * [mysql-xplain-xplain](https://github.com/rap2hpoutre/mysql-xplain-xplain) * [explain-analyzer](https://github.com/Preetam/explain-analyzer) * [Explain](https://github.com/goghcrow/explain/blob/master/Explain.php) * [sql-beautify](https://github.com/jkramer/sql-beautify) * [go-mysql](https://github.com/percona/go-mysql) * [pretty](https://github.com/kr/pretty) * [golang_escape](https://github.com/liule/golang_escape) * [mymysql](https://github.com/ziutek/mymysql) * [beego/logs](https://github.com/astaxie/beego/logs) * [uniuri](https://github.com/dchest/uniuri) * [gjson](https://github.com/tidwall/gjson) ## 参考博文 * [MySQL Reference Manual Chapter 8 Optimization](https://dev.mysql.com/doc/refman/8.0/en/optimization.html) * [Indexing 101: Optimizing MySQL queries on a single table](https://www.percona.com/blog/2015/04/27/indexing-101-optimizing-mysql-queries-on-a-single-table/) * [MySQL: Building the best INDEX for a given SELECT](http://mysql.rjweb.org/doc.php/index_cookbook_mysql) * [MySQL INDEX Cookbook](http://mysql.rjweb.org/slides/cook.pdf) * [Random Sampling for Histogram Construction: How much is enough?](http://www.mathcs.emory.edu/~cheung/papers/StreamDB/Histogram/1998-Chaudhuri-Histo.pdf) * [10 Cool SQL Optimisations That do not Depend on the Cost Model](https://blog.jooq.org/2017/09/28/10-cool-sql-optimisations-that-do-not-depend-on-the-cost-model/) ## 参考书目 * 《高性能MySQL》/《High Performance MySQL》 * 《数据库索引设计与优化》/《Relational Database Index Design and the Optimizers》 * 《数据库系统概论》/《Database System Concepts》 * 《SQL反模式》/《SQL Antipatterns》 * 《数据库查询优化器的艺术》/《The Art of Database Query Optimizer》 * 《SQL优化最佳实践》/《SQL Optimization Best Practice》 * 《SQL编程风格》/《Sql Programming Style》 ================================================ FILE: doc/thanks_en.md ================================================ ## Thanks 以下为SOAR的灵感及代码来源,我们站在伟人的肩膀上,让DBA的工作和生活更美好。 * [vitess](https://github.com/vitessio/vitess) * [SQLAdvisor](https://github.com/Meituan-Dianping/SQLAdvisor) * [pt-query-advisor](https://www.percona.com/doc/percona-toolkit/2.1/pt-query-advisor.html) * [sqlcheck](https://github.com/jarulraj/sqlcheck) * [pg_idx_advisor](https://github.com/cohenjo/pg_idx_advisor) * [mysql-xplain-xplain](https://github.com/rap2hpoutre/mysql-xplain-xplain) * [explain-analyzer](https://github.com/Preetam/explain-analyzer) * [Explain](https://github.com/goghcrow/explain/blob/master/Explain.php) * [sql-beautify](https://github.com/jkramer/sql-beautify) * [go-mysql](https://github.com/percona/go-mysql) * [pretty](https://github.com/kr/pretty) * [golang_escape](https://github.com/liule/golang_escape) * [mymysql](https://github.com/ziutek/mymysql) * [beego/logs](https://github.com/astaxie/beego/logs) * [uniuri](https://github.com/dchest/uniuri) * [gjson](https://github.com/tidwall/gjson) ## Reference Articles * [MySQL Reference Manual Chapter 8 Optimization](https://dev.mysql.com/doc/refman/8.0/en/optimization.html) * [Indexing 101: Optimizing MySQL queries on a single table](https://www.percona.com/blog/2015/04/27/indexing-101-optimizing-mysql-queries-on-a-single-table/) * [MySQL: Building the best INDEX for a given SELECT](http://mysql.rjweb.org/doc.php/index_cookbook_mysql) * [MySQL INDEX Cookbook](http://mysql.rjweb.org/slides/cook.pdf) * [Random Sampling for Histogram Construction: How much is enough?](http://www.mathcs.emory.edu/~cheung/papers/StreamDB/Histogram/1998-Chaudhuri-Histo.pdf) * [10 Cool SQL Optimisations That do not Depend on the Cost Model](https://blog.jooq.org/2017/09/28/10-cool-sql-optimisations-that-do-not-depend-on-the-cost-model/) ## Books * 《高性能MySQL》/《High Performance MySQL》 * 《数据库索引设计与优化》/《Relational Database Index Design and the Optimizers》 * 《数据库系统概论》/《Database System Concepts》 * 《SQL反模式》/《SQL Antipatterns》 * 《数据库查询优化器的艺术》/《The Art of Database Query Optimizer》 * 《SQL优化最佳实践》/《SQL Optimization Best Practice》 * 《SQL编程风格》/《Sql Programming Style》 ================================================ FILE: doc/themes/foghorn.css ================================================ html, body { padding:1em; margin:auto; max-width:42em; background:#fefefe; } body { font: 1.3em "Vollkorn", Palatino, Times; color: #333; line-height: 1.4; text-align: justify; } header, nav, article, footer { width: 700px; margin:0 auto; } article { margin-top: 4em; margin-bottom: 4em; min-height: 400px; } footer { margin-bottom:50px; } video { margin: 2em 0; border:1px solid #ddd; } nav { font-size: .9em; font-style: italic; border-bottom: 1px solid #ddd; padding: 1em 0; } nav p { margin: 0; } /* Typography -------------------------------------------------------- */ h1 { margin-top: 0; font-weight: normal; } h2 { font-weight: normal; } h3 { font-weight: normal; font-style: italic; margin-top:3em; } p { margin-top:0; -webkit-hypens:auto; -moz-hypens:auto; hyphens:auto; } ul { list-style: square; padding-left:1.2em; } ol { padding-left:1.2em; } blockquote { margin-left: 1em; padding-left: 1em; border-left: 1px solid #ddd; } code { font-family: "Consolas", "Menlo", "Monaco", monospace, serif; font-size: .9em; background: white; } a { color: #2484c1; text-decoration: none; } a:hover { text-decoration: underline; } a img { border:none; } h1 a, h1 a:hover { color: #333; text-decoration: none; } hr { color : #ddd; height : 1px; margin: 2em 0; border-top : solid 1px #ddd; border-bottom : none; border-left: 0; border-right: 0; } p#heart{ font-size: 2em; line-height: 1; text-align: center; color: #ccc; } .red { color:#B50000; } /* Home Page --------------------------- */ body#index li { margin-bottom: 1em; } /* iPad -------------------------------------------------------- */ @media only screen and (max-device-width: 1024px) { body { font-size: 120%; line-height: 1.4; } } /* @iPad */ /* iPhone -------------------------------------------------------- */ @media only screen and (max-device-width: 480px) { body { text-align: left; } article, footer { width: auto; } article { padding: 0 10px; } } /* @iPhone */ ================================================ FILE: doc/themes/ghostwriter.css ================================================ /* ============================================================ */ /* Base */ /* ============================================================ */ html, body { height: 100%; } body { background: #fefefe; color: #424242; font-family: "Open Sans", arial, sans-serif; font-size: 18px; } h1, h2, h3, h4, h5, h6 { margin-bottom: 33px; text-transform: none; } h1 { font-size: 26px; } h2 { font-size: 24px; } h3 { font-size: 20px; margin-bottom: 20px; } h4 { font-size: 18px; margin-bottom: 18px; } h5 { font-size: 16px; margin-bottom: 15px; } h6 { font-size: 14px; margin-bottom: 12px; } p { line-height: 1.8; margin: 0 0 30px; } a { color: #f03838; text-decoration: none; } ul, ol { list-style-position: inside; line-height: 1.8; margin: 0 0 40px; padding: 0; } ul li, ol li { margin: 0 0 10px; } blockquote { border-left: 1px dotted #303030; margin: 40px 0; padding: 5px 30px; } blockquote p { color: #AEADAD; display: block; font-style: italic; margin: 0; width: 100%; } img { display: block; margin: 40px 0; width: auto; max-width: 100%; } pre { background: #F1F0EA; border: 1px solid #DDDBCC; border-radius: 3px; margin: 0 0 40px; padding: 15px 20px; } ::selection { background: #FFF5B8; color: #000; display: block; } ::-moz-selection { background: #FFF5B8; color: #000; display: block; } /* ============================================================ */ /* General Appearance */ /* ============================================================ */ .container { margin: 0 auto; position: relative; width: 100%; max-width: 889px; } #wrapper { height: auto; min-height: 100%; /* This must be the same as the height of the footer */ margin-bottom: -265px; } #wrapper:after { content: ""; display: block; /* This must be the same as the height of the footer */ height: 265px; } .button { background: #303030; border: none; border-radius: 3px; color: #FEFEFE; font-size: 14px; font-weight: 700; padding: 10px 12px; text-transform: uppercase; } .button:hover { background: #f03838; } .button-square { background: #f03838; float: left; margin: 0 0 0 10px; padding: 8px; } .button-square:hover { background: #303030; } /* ============================================================ */ /* Site Header */ /* ============================================================ */ .site-header { padding: 100px 0 35px; overflow: auto; text-align: center; text-transform: uppercase; } .site-title-wrapper { display: table; margin: 0 auto; } .site-title { float: left; font-size: 14px; font-weight: 600; margin: 0; text-transform: uppercase; } .site-title a { float: left; background: #f03838; color: #FEFEFE; padding: 5px 10px 6px; } .site-title a:hover { background: #303030; } /* ============================================================ */ /* Post */ /* ============================================================ */ .post { margin: 0 40px; } .post-header { border-bottom: 6px solid #303030; margin: 0 0 50px; padding: 0 0 80px; text-align: center; text-transform: uppercase; } .post-title { font-size: 52px; font-weight: 700; margin: 15px 0; text-transform: uppercase; } .post-date { color: #AEADAD; font-size: 14px; font-weight: 600; line-height: 1; margin: 25px 0 0; } .post-date:after { border-bottom: 1px dotted #303030; content: ""; display: block; margin: 40px auto 0; width: 100px; } .post-content { margin: 0 0 92px; } .post-content a:hover { border-bottom: 1px dotted #f03838; padding: 0 0 2px; } .post-tags { color: #AEADAD; font-size: 14px; } .post-tags span { font-weight: 600; } .post-navigation { display: table; margin: 70px auto 100px; } .newer-posts, .older-posts { float: left; background: #f03838; color: #FEFEFE; font-size: 14px; font-weight: 600; margin: 0 5px; padding: 5px 10px 6px; text-transform: uppercase; } .newer-posts:hover, .older-posts:hover { background: #303030; } .page-number { display: none; } /* ============================================================ */ /* Post Index */ /* ============================================================ */ .post-list { border-top: 6px solid #303030; list-style: none; margin: 80px 40px 0; padding: 35px 0 0; } .post-stub { border-bottom: 1px dotted #303030; margin: 0; } .post-stub:first-child { padding-top: 0; } .post-stub a { -webkit-transition: all 0.2s ease-in-out; -moz-transition: all 0.2s ease-in-out; transition: all 0.2s ease-in-out; display: block; color: #424242; padding: 20px 5px; } .post-stub a:hover { background: #FCF5F5; color: #f03838; padding: 20px 12px; } .post-stub-title { display: inline-block; margin: 0; text-transform: none; } .post-stub-date { display: inline-block; } .post-stub-date:before { content: "/ "; } .next-posts-link a, .previous-posts-link a { display: block; padding: 8px 11px; } /* ============================================================ */ /* Icons */ /* ============================================================ */ .icon { background-size: 14px 38px; display: block; height: 38px; width: 14px; } .icon-menu { background-position: 0 0; height: 14px; width: 14px; } .icon-up { background-position: 0 -15px; height: 8px; width: 14px; } .icon-rss { background-position: 0 -24px; height: 14px; width: 14px; } /* ============================================================ */ /* Footer */ /* ============================================================ */ .footer { background: #303030; color: #D3D3D3; height: 265px; overflow: auto; } .footer .site-title-wrapper { margin: 80px auto 35px; } .footer .site-title a:hover, .footer .button-square:hover { background: #121212; } .button-jump-top { padding-top: 11px; padding-bottom: 11px; } .footer-copyright { color: #656565; font-size: 14px; margin: 0; text-align: center; text-transform: uppercase; } .footer-copyright a { color: #656565; font-weight: 700; } .footer-copyright a:hover { color: #FEFEFE; } /* ============================================================ */ /* NProgress */ /* ============================================================ */ #nprogress .bar { background: #f03838; } #nprogress .peg { box-shadow: 0 0 10px #f03838, 0 0 5px #f03838; } #nprogress .spinner-icon { border-top-color: #f03838; border-left-color: #f03838; } /* ============================================================ */ /* Media Queries */ /* ============================================================ */ @media only screen and (max-width: 600px) { .post-stub-title { display: block; } .post-stub-date:before { content: ""; display: block; } } @media only screen and (max-width: 400px) { .post-title { font-size: 32px; } } ================================================ FILE: doc/themes/github-dark.css ================================================ @font-face { font-family: octicons-link; src: url(data:font/woff;charset=utf-8;base64,d09GRgABAAAAAAZwABAAAAAACFQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABEU0lHAAAGaAAAAAgAAAAIAAAAAUdTVUIAAAZcAAAACgAAAAoAAQAAT1MvMgAAAyQAAABJAAAAYFYEU3RjbWFwAAADcAAAAEUAAACAAJThvmN2dCAAAATkAAAABAAAAAQAAAAAZnBnbQAAA7gAAACyAAABCUM+8IhnYXNwAAAGTAAAABAAAAAQABoAI2dseWYAAAFsAAABPAAAAZwcEq9taGVhZAAAAsgAAAA0AAAANgh4a91oaGVhAAADCAAAABoAAAAkCA8DRGhtdHgAAAL8AAAADAAAAAwGAACfbG9jYQAAAsAAAAAIAAAACABiATBtYXhwAAACqAAAABgAAAAgAA8ASm5hbWUAAAToAAABQgAAAlXu73sOcG9zdAAABiwAAAAeAAAAME3QpOBwcmVwAAAEbAAAAHYAAAB/aFGpk3jaTY6xa8JAGMW/O62BDi0tJLYQincXEypYIiGJjSgHniQ6umTsUEyLm5BV6NDBP8Tpts6F0v+k/0an2i+itHDw3v2+9+DBKTzsJNnWJNTgHEy4BgG3EMI9DCEDOGEXzDADU5hBKMIgNPZqoD3SilVaXZCER3/I7AtxEJLtzzuZfI+VVkprxTlXShWKb3TBecG11rwoNlmmn1P2WYcJczl32etSpKnziC7lQyWe1smVPy/Lt7Kc+0vWY/gAgIIEqAN9we0pwKXreiMasxvabDQMM4riO+qxM2ogwDGOZTXxwxDiycQIcoYFBLj5K3EIaSctAq2kTYiw+ymhce7vwM9jSqO8JyVd5RH9gyTt2+J/yUmYlIR0s04n6+7Vm1ozezUeLEaUjhaDSuXHwVRgvLJn1tQ7xiuVv/ocTRF42mNgZGBgYGbwZOBiAAFGJBIMAAizAFoAAABiAGIAznjaY2BkYGAA4in8zwXi+W2+MjCzMIDApSwvXzC97Z4Ig8N/BxYGZgcgl52BCSQKAA3jCV8CAABfAAAAAAQAAEB42mNgZGBg4f3vACQZQABIMjKgAmYAKEgBXgAAeNpjYGY6wTiBgZWBg2kmUxoDA4MPhGZMYzBi1AHygVLYQUCaawqDA4PChxhmh/8ODDEsvAwHgMKMIDnGL0x7gJQCAwMAJd4MFwAAAHjaY2BgYGaA4DAGRgYQkAHyGMF8NgYrIM3JIAGVYYDT+AEjAwuDFpBmA9KMDEwMCh9i/v8H8sH0/4dQc1iAmAkALaUKLgAAAHjaTY9LDsIgEIbtgqHUPpDi3gPoBVyRTmTddOmqTXThEXqrob2gQ1FjwpDvfwCBdmdXC5AVKFu3e5MfNFJ29KTQT48Ob9/lqYwOGZxeUelN2U2R6+cArgtCJpauW7UQBqnFkUsjAY/kOU1cP+DAgvxwn1chZDwUbd6CFimGXwzwF6tPbFIcjEl+vvmM/byA48e6tWrKArm4ZJlCbdsrxksL1AwWn/yBSJKpYbq8AXaaTb8AAHja28jAwOC00ZrBeQNDQOWO//sdBBgYGRiYWYAEELEwMTE4uzo5Zzo5b2BxdnFOcALxNjA6b2ByTswC8jYwg0VlNuoCTWAMqNzMzsoK1rEhNqByEyerg5PMJlYuVueETKcd/89uBpnpvIEVomeHLoMsAAe1Id4AAAAAAAB42oWQT07CQBTGv0JBhagk7HQzKxca2sJCE1hDt4QF+9JOS0nbaaYDCQfwCJ7Au3AHj+LO13FMmm6cl7785vven0kBjHCBhfpYuNa5Ph1c0e2Xu3jEvWG7UdPDLZ4N92nOm+EBXuAbHmIMSRMs+4aUEd4Nd3CHD8NdvOLTsA2GL8M9PODbcL+hD7C1xoaHeLJSEao0FEW14ckxC+TU8TxvsY6X0eLPmRhry2WVioLpkrbp84LLQPGI7c6sOiUzpWIWS5GzlSgUzzLBSikOPFTOXqly7rqx0Z1Q5BAIoZBSFihQYQOOBEdkCOgXTOHA07HAGjGWiIjaPZNW13/+lm6S9FT7rLHFJ6fQbkATOG1j2OFMucKJJsxIVfQORl+9Jyda6Sl1dUYhSCm1dyClfoeDve4qMYdLEbfqHf3O/AdDumsjAAB42mNgYoAAZQYjBmyAGYQZmdhL8zLdDEydARfoAqIAAAABAAMABwAKABMAB///AA8AAQAAAAAAAAAAAAAAAAABAAAAAA==) format('woff'); } .markdown-body { -ms-text-size-adjust: 100%; -webkit-text-size-adjust: 100%; line-height: 1.5; color: #24292e; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 16px; line-height: 1.5; word-wrap: break-word; } .markdown-body .pl-c { color: #6a737d; } .markdown-body .pl-c1, .markdown-body .pl-s .pl-v { color: #005cc5; } .markdown-body .pl-e, .markdown-body .pl-en { color: #6f42c1; } .markdown-body .pl-smi, .markdown-body .pl-s .pl-s1 { color: #24292e; } .markdown-body .pl-ent { color: #22863a; } .markdown-body .pl-k { color: #d73a49; } .markdown-body .pl-s, .markdown-body .pl-pds, .markdown-body .pl-s .pl-pse .pl-s1, .markdown-body .pl-sr, .markdown-body .pl-sr .pl-cce, .markdown-body .pl-sr .pl-sre, .markdown-body .pl-sr .pl-sra { color: #032f62; } .markdown-body .pl-v, .markdown-body .pl-smw { color: #e36209; } .markdown-body .pl-bu { color: #b31d28; } .markdown-body .pl-ii { color: #fafbfc; background-color: #b31d28; } .markdown-body .pl-c2 { color: #fafbfc; background-color: #d73a49; } .markdown-body .pl-c2::before { content: "^M"; } .markdown-body .pl-sr .pl-cce { font-weight: bold; color: #22863a; } .markdown-body .pl-ml { color: #735c0f; } .markdown-body .pl-mh, .markdown-body .pl-mh .pl-en, .markdown-body .pl-ms { font-weight: bold; color: #005cc5; } .markdown-body .pl-mi { font-style: italic; color: #24292e; } .markdown-body .pl-mb { font-weight: bold; color: #24292e; } .markdown-body .pl-md { color: #b31d28; background-color: #ffeef0; } .markdown-body .pl-mi1 { color: #22863a; background-color: #f0fff4; } .markdown-body .pl-mc { color: #e36209; background-color: #ffebda; } .markdown-body .pl-mi2 { color: #f6f8fa; background-color: #005cc5; } .markdown-body .pl-mdr { font-weight: bold; color: #6f42c1; } .markdown-body .pl-ba { color: #586069; } .markdown-body .pl-sg { color: #959da5; } .markdown-body .pl-corl { text-decoration: underline; color: #032f62; } .markdown-body .octicon { display: inline-block; vertical-align: text-top; fill: currentColor; } .markdown-body a { background-color: transparent; -webkit-text-decoration-skip: objects; } .markdown-body a:active, .markdown-body a:hover { outline-width: 0; } .markdown-body strong { font-weight: inherit; } .markdown-body strong { font-weight: bolder; } .markdown-body h1 { font-size: 2em; margin: 0.67em 0; } .markdown-body img { border-style: none; } .markdown-body svg:not(:root) { overflow: hidden; } .markdown-body code, .markdown-body kbd, .markdown-body pre { font-family: monospace, monospace; font-size: 1em; } .markdown-body hr { box-sizing: content-box; height: 0; overflow: visible; } .markdown-body input { font: inherit; margin: 0; } .markdown-body input { overflow: visible; } .markdown-body [type="checkbox"] { box-sizing: border-box; padding: 0; } .markdown-body * { box-sizing: border-box; } .markdown-body input { font-family: inherit; font-size: inherit; line-height: inherit; } .markdown-body a { color: #0366d6; text-decoration: none; } .markdown-body a:hover { text-decoration: underline; } .markdown-body strong { font-weight: 600; } .markdown-body hr { height: 0; margin: 15px 0; overflow: hidden; background: transparent; border: 0; border-bottom: 1px solid #dfe2e5; } .markdown-body hr::before { display: table; content: ""; } .markdown-body hr::after { display: table; clear: both; content: ""; } .markdown-body table { border-spacing: 0; border-collapse: collapse; } .markdown-body td, .markdown-body th { padding: 0; } .markdown-body h1, .markdown-body h2, .markdown-body h3, .markdown-body h4, .markdown-body h5, .markdown-body h6 { margin-top: 0; margin-bottom: 0; } .markdown-body h1 { font-size: 32px; font-weight: 600; } .markdown-body h2 { font-size: 24px; font-weight: 600; } .markdown-body h3 { font-size: 20px; font-weight: 600; } .markdown-body h4 { font-size: 16px; font-weight: 600; } .markdown-body h5 { font-size: 14px; font-weight: 600; } .markdown-body h6 { font-size: 12px; font-weight: 600; } .markdown-body p { margin-top: 0; margin-bottom: 10px; } .markdown-body blockquote { margin: 0; } .markdown-body ul, .markdown-body ol { padding-left: 0; margin-top: 0; margin-bottom: 0; } .markdown-body ol ol, .markdown-body ul ol { list-style-type: lower-roman; } .markdown-body ul ul ol, .markdown-body ul ol ol, .markdown-body ol ul ol, .markdown-body ol ol ol { list-style-type: lower-alpha; } .markdown-body dd { margin-left: 0; } .markdown-body code { font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; } .markdown-body pre { margin-top: 0; margin-bottom: 0; font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; } .markdown-body .octicon { vertical-align: text-bottom; } .markdown-body .pl-0 { padding-left: 0 !important; } .markdown-body .pl-1 { padding-left: 4px !important; } .markdown-body .pl-2 { padding-left: 8px !important; } .markdown-body .pl-3 { padding-left: 16px !important; } .markdown-body .pl-4 { padding-left: 24px !important; } .markdown-body .pl-5 { padding-left: 32px !important; } .markdown-body .pl-6 { padding-left: 40px !important; } .markdown-body::before { display: table; content: ""; } .markdown-body::after { display: table; clear: both; content: ""; } .markdown-body>*:first-child { margin-top: 0 !important; } .markdown-body>*:last-child { margin-bottom: 0 !important; } .markdown-body a:not([href]) { color: inherit; text-decoration: none; } .markdown-body .anchor { float: left; padding-right: 4px; margin-left: -20px; line-height: 1; } .markdown-body .anchor:focus { outline: none; } .markdown-body p, .markdown-body blockquote, .markdown-body ul, .markdown-body ol, .markdown-body dl, .markdown-body table, .markdown-body pre { margin-top: 0; margin-bottom: 16px; } .markdown-body hr { height: 0.25em; padding: 0; margin: 24px 0; background-color: #e1e4e8; border: 0; } .markdown-body blockquote { padding: 0 1em; color: #6a737d; border-left: 0.25em solid #dfe2e5; } .markdown-body blockquote>:first-child { margin-top: 0; } .markdown-body blockquote>:last-child { margin-bottom: 0; } .markdown-body kbd { display: inline-block; padding: 3px 5px; font-size: 11px; line-height: 10px; color: #444d56; vertical-align: middle; background-color: #fafbfc; border: solid 1px #c6cbd1; border-bottom-color: #959da5; border-radius: 3px; box-shadow: inset 0 -1px 0 #959da5; } .markdown-body h1, .markdown-body h2, .markdown-body h3, .markdown-body h4, .markdown-body h5, .markdown-body h6 { margin-top: 24px; margin-bottom: 16px; font-weight: 600; line-height: 1.25; } .markdown-body h1 .octicon-link, .markdown-body h2 .octicon-link, .markdown-body h3 .octicon-link, .markdown-body h4 .octicon-link, .markdown-body h5 .octicon-link, .markdown-body h6 .octicon-link { color: #1b1f23; vertical-align: middle; visibility: hidden; } .markdown-body h1:hover .anchor, .markdown-body h2:hover .anchor, .markdown-body h3:hover .anchor, .markdown-body h4:hover .anchor, .markdown-body h5:hover .anchor, .markdown-body h6:hover .anchor { text-decoration: none; } .markdown-body h1:hover .anchor .octicon-link, .markdown-body h2:hover .anchor .octicon-link, .markdown-body h3:hover .anchor .octicon-link, .markdown-body h4:hover .anchor .octicon-link, .markdown-body h5:hover .anchor .octicon-link, .markdown-body h6:hover .anchor .octicon-link { visibility: visible; } .markdown-body h1 { padding-bottom: 0.3em; font-size: 2em; border-bottom: 1px solid #eaecef; } .markdown-body h2 { padding-bottom: 0.3em; font-size: 1.5em; border-bottom: 1px solid #eaecef; } .markdown-body h3 { font-size: 1.25em; } .markdown-body h4 { font-size: 1em; } .markdown-body h5 { font-size: 0.875em; } .markdown-body h6 { font-size: 0.85em; color: #6a737d; } .markdown-body ul, .markdown-body ol { padding-left: 2em; } .markdown-body ul ul, .markdown-body ul ol, .markdown-body ol ol, .markdown-body ol ul { margin-top: 0; margin-bottom: 0; } .markdown-body li>p { margin-top: 16px; } .markdown-body li+li { margin-top: 0.25em; } .markdown-body dl { padding: 0; } .markdown-body dl dt { padding: 0; margin-top: 16px; font-size: 1em; font-style: italic; font-weight: 600; } .markdown-body dl dd { padding: 0 16px; margin-bottom: 16px; } .markdown-body table { display: block; width: 100%; overflow: auto; } .markdown-body table th { font-weight: 600; } .markdown-body table th, .markdown-body table td { padding: 6px 13px; border: 1px solid #dfe2e5; } .markdown-body table tr { background-color: #fff; border-top: 1px solid #c6cbd1; } .markdown-body table tr:nth-child(2n) { background-color: #f6f8fa; } .markdown-body img { max-width: 100%; box-sizing: content-box; background-color: #fff; } .markdown-body img[align=right] { padding-left: 20px; } .markdown-body img[align=left] { padding-right: 20px; } .markdown-body code { padding: 0; padding-top: 0.2em; padding-bottom: 0.2em; margin: 0; font-size: 85%; background-color: rgba(27,31,35,0.05); border-radius: 3px; } .markdown-body code::before, .markdown-body code::after { letter-spacing: -0.2em; content: "\00a0"; } .markdown-body pre { word-wrap: normal; } .markdown-body pre>code { padding: 0; margin: 0; font-size: 100%; word-break: normal; white-space: pre; background: transparent; border: 0; } .markdown-body .highlight { margin-bottom: 16px; } .markdown-body .highlight pre { margin-bottom: 0; word-break: normal; } .markdown-body .highlight pre, .markdown-body pre { padding: 16px; overflow: auto; font-size: 85%; line-height: 1.45; background-color: #f6f8fa; border-radius: 3px; } .markdown-body pre code { display: inline; max-width: auto; padding: 0; margin: 0; overflow: visible; line-height: inherit; word-wrap: normal; background-color: transparent; border: 0; } .markdown-body pre code::before, .markdown-body pre code::after { content: normal; } .markdown-body .full-commit .btn-outline:not(:disabled):hover { color: #005cc5; border-color: #005cc5; } .markdown-body kbd { display: inline-block; padding: 3px 5px; font: 11px "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; line-height: 10px; color: #444d56; vertical-align: middle; background-color: #fafbfc; border: solid 1px #d1d5da; border-bottom-color: #c6cbd1; border-radius: 3px; box-shadow: inset 0 -1px 0 #c6cbd1; } .markdown-body :checked+.radio-label { position: relative; z-index: 1; border-color: #0366d6; } .markdown-body .task-list-item { list-style-type: none; } .markdown-body .task-list-item+.task-list-item { margin-top: 3px; } .markdown-body .task-list-item input { margin: 0 0.2em 0.25em -1.6em; vertical-align: middle; } .markdown-body hr { border-bottom-color: #eee; } /*Markdown Viewer*/ .markdown-body summary:hover { cursor: pointer; } .markdown-body ul li p { margin: 0; } /*GitHub Dark*/ body { background: #181818; } .markdown-body { color: #c0c0c0 !important; background: #181818 !important; border-color: #484848 !important; } .markdown-body table { color: #c0c0c0 !important; } .markdown-body table th { border-color: #343434 !important; } .markdown-body table td { border-color: #343434 !important; } .markdown-body table tr { background: #141414 !important; border-color: #343434 !important; } .markdown-body table tr:nth-child(2n) { background: #181818 !important; } .markdown-body hr { background: #383838 !important; } .markdown-body h1, .markdown-body h2 { border-color: #343434 !important; } .markdown-body h1, .markdown-body h2, .markdown-body h3, .markdown-body h4, .markdown-body .octicon-link { color: #e0e0e0 !important; } .markdown-body blockquote strong { color: #808080 !important; } .markdown-body blockquote { border-color: #343434 !important; } .markdown-body blockquote, .markdown-body blockquote code { color: #666 !important; } .markdown-body code, .markdown-body tt, .markdown-body pre, .markdown-body .highlight pre, body.blog pre { border: 1px solid rgba(255,255,255,.1) !important; } .markdown-body code, .markdown-body tt { background: #202020 !important; } .markdown-body pre { background: #141414 !important; color: #ccc !important; } .markdown-body pre code { background: none !important; border: 0 !important; } .markdown-body code[class*="language-"] { color: #c0c0c0 !important; text-shadow: none !important; } .markdown-body code[class*="language-"] .operator, .markdown-body code[class*="language-"] .string { background: none !important; } .markdown-body a[href*="/labels/"], .markdown-body a:not([href*="/labels/"]), .markdown-body blockquote a code { color: #4183C4 !important; } .markdown-body summary:hover { cursor: pointer; } ================================================ FILE: doc/themes/github.css ================================================ @font-face { font-family: octicons-link; src: url(data:font/woff;charset=utf-8;base64,d09GRgABAAAAAAZwABAAAAAACFQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABEU0lHAAAGaAAAAAgAAAAIAAAAAUdTVUIAAAZcAAAACgAAAAoAAQAAT1MvMgAAAyQAAABJAAAAYFYEU3RjbWFwAAADcAAAAEUAAACAAJThvmN2dCAAAATkAAAABAAAAAQAAAAAZnBnbQAAA7gAAACyAAABCUM+8IhnYXNwAAAGTAAAABAAAAAQABoAI2dseWYAAAFsAAABPAAAAZwcEq9taGVhZAAAAsgAAAA0AAAANgh4a91oaGVhAAADCAAAABoAAAAkCA8DRGhtdHgAAAL8AAAADAAAAAwGAACfbG9jYQAAAsAAAAAIAAAACABiATBtYXhwAAACqAAAABgAAAAgAA8ASm5hbWUAAAToAAABQgAAAlXu73sOcG9zdAAABiwAAAAeAAAAME3QpOBwcmVwAAAEbAAAAHYAAAB/aFGpk3jaTY6xa8JAGMW/O62BDi0tJLYQincXEypYIiGJjSgHniQ6umTsUEyLm5BV6NDBP8Tpts6F0v+k/0an2i+itHDw3v2+9+DBKTzsJNnWJNTgHEy4BgG3EMI9DCEDOGEXzDADU5hBKMIgNPZqoD3SilVaXZCER3/I7AtxEJLtzzuZfI+VVkprxTlXShWKb3TBecG11rwoNlmmn1P2WYcJczl32etSpKnziC7lQyWe1smVPy/Lt7Kc+0vWY/gAgIIEqAN9we0pwKXreiMasxvabDQMM4riO+qxM2ogwDGOZTXxwxDiycQIcoYFBLj5K3EIaSctAq2kTYiw+ymhce7vwM9jSqO8JyVd5RH9gyTt2+J/yUmYlIR0s04n6+7Vm1ozezUeLEaUjhaDSuXHwVRgvLJn1tQ7xiuVv/ocTRF42mNgZGBgYGbwZOBiAAFGJBIMAAizAFoAAABiAGIAznjaY2BkYGAA4in8zwXi+W2+MjCzMIDApSwvXzC97Z4Ig8N/BxYGZgcgl52BCSQKAA3jCV8CAABfAAAAAAQAAEB42mNgZGBg4f3vACQZQABIMjKgAmYAKEgBXgAAeNpjYGY6wTiBgZWBg2kmUxoDA4MPhGZMYzBi1AHygVLYQUCaawqDA4PChxhmh/8ODDEsvAwHgMKMIDnGL0x7gJQCAwMAJd4MFwAAAHjaY2BgYGaA4DAGRgYQkAHyGMF8NgYrIM3JIAGVYYDT+AEjAwuDFpBmA9KMDEwMCh9i/v8H8sH0/4dQc1iAmAkALaUKLgAAAHjaTY9LDsIgEIbtgqHUPpDi3gPoBVyRTmTddOmqTXThEXqrob2gQ1FjwpDvfwCBdmdXC5AVKFu3e5MfNFJ29KTQT48Ob9/lqYwOGZxeUelN2U2R6+cArgtCJpauW7UQBqnFkUsjAY/kOU1cP+DAgvxwn1chZDwUbd6CFimGXwzwF6tPbFIcjEl+vvmM/byA48e6tWrKArm4ZJlCbdsrxksL1AwWn/yBSJKpYbq8AXaaTb8AAHja28jAwOC00ZrBeQNDQOWO//sdBBgYGRiYWYAEELEwMTE4uzo5Zzo5b2BxdnFOcALxNjA6b2ByTswC8jYwg0VlNuoCTWAMqNzMzsoK1rEhNqByEyerg5PMJlYuVueETKcd/89uBpnpvIEVomeHLoMsAAe1Id4AAAAAAAB42oWQT07CQBTGv0JBhagk7HQzKxca2sJCE1hDt4QF+9JOS0nbaaYDCQfwCJ7Au3AHj+LO13FMmm6cl7785vven0kBjHCBhfpYuNa5Ph1c0e2Xu3jEvWG7UdPDLZ4N92nOm+EBXuAbHmIMSRMs+4aUEd4Nd3CHD8NdvOLTsA2GL8M9PODbcL+hD7C1xoaHeLJSEao0FEW14ckxC+TU8TxvsY6X0eLPmRhry2WVioLpkrbp84LLQPGI7c6sOiUzpWIWS5GzlSgUzzLBSikOPFTOXqly7rqx0Z1Q5BAIoZBSFihQYQOOBEdkCOgXTOHA07HAGjGWiIjaPZNW13/+lm6S9FT7rLHFJ6fQbkATOG1j2OFMucKJJsxIVfQORl+9Jyda6Sl1dUYhSCm1dyClfoeDve4qMYdLEbfqHf3O/AdDumsjAAB42mNgYoAAZQYjBmyAGYQZmdhL8zLdDEydARfoAqIAAAABAAMABwAKABMAB///AA8AAQAAAAAAAAAAAAAAAAABAAAAAA==) format('woff'); } .markdown-body { -ms-text-size-adjust: 100%; -webkit-text-size-adjust: 100%; line-height: 1.5; color: #24292e; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 16px; line-height: 1.5; word-wrap: break-word; } .markdown-body .pl-c { color: #6a737d; } .markdown-body .pl-c1, .markdown-body .pl-s .pl-v { color: #005cc5; } .markdown-body .pl-e, .markdown-body .pl-en { color: #6f42c1; } .markdown-body .pl-smi, .markdown-body .pl-s .pl-s1 { color: #24292e; } .markdown-body .pl-ent { color: #22863a; } .markdown-body .pl-k { color: #d73a49; } .markdown-body .pl-s, .markdown-body .pl-pds, .markdown-body .pl-s .pl-pse .pl-s1, .markdown-body .pl-sr, .markdown-body .pl-sr .pl-cce, .markdown-body .pl-sr .pl-sre, .markdown-body .pl-sr .pl-sra { color: #032f62; } .markdown-body .pl-v, .markdown-body .pl-smw { color: #e36209; } .markdown-body .pl-bu { color: #b31d28; } .markdown-body .pl-ii { color: #fafbfc; background-color: #b31d28; } .markdown-body .pl-c2 { color: #fafbfc; background-color: #d73a49; } .markdown-body .pl-c2::before { content: "^M"; } .markdown-body .pl-sr .pl-cce { font-weight: bold; color: #22863a; } .markdown-body .pl-ml { color: #735c0f; } .markdown-body .pl-mh, .markdown-body .pl-mh .pl-en, .markdown-body .pl-ms { font-weight: bold; color: #005cc5; } .markdown-body .pl-mi { font-style: italic; color: #24292e; } .markdown-body .pl-mb { font-weight: bold; color: #24292e; } .markdown-body .pl-md { color: #b31d28; background-color: #ffeef0; } .markdown-body .pl-mi1 { color: #22863a; background-color: #f0fff4; } .markdown-body .pl-mc { color: #e36209; background-color: #ffebda; } .markdown-body .pl-mi2 { color: #f6f8fa; background-color: #005cc5; } .markdown-body .pl-mdr { font-weight: bold; color: #6f42c1; } .markdown-body .pl-ba { color: #586069; } .markdown-body .pl-sg { color: #959da5; } .markdown-body .pl-corl { text-decoration: underline; color: #032f62; } .markdown-body .octicon { display: inline-block; vertical-align: text-top; fill: currentColor; } .markdown-body a { background-color: transparent; -webkit-text-decoration-skip: objects; } .markdown-body a:active, .markdown-body a:hover { outline-width: 0; } .markdown-body strong { font-weight: inherit; } .markdown-body strong { font-weight: bolder; } .markdown-body h1 { font-size: 2em; margin: 0.67em 0; } .markdown-body img { border-style: none; } .markdown-body svg:not(:root) { overflow: hidden; } .markdown-body code, .markdown-body kbd, .markdown-body pre { font-family: monospace, monospace; font-size: 1em; } .markdown-body hr { box-sizing: content-box; height: 0; overflow: visible; } .markdown-body input { font: inherit; margin: 0; } .markdown-body input { overflow: visible; } .markdown-body [type="checkbox"] { box-sizing: border-box; padding: 0; } .markdown-body * { box-sizing: border-box; } .markdown-body input { font-family: inherit; font-size: inherit; line-height: inherit; } .markdown-body a { color: #0366d6; text-decoration: none; } .markdown-body a:hover { text-decoration: underline; } .markdown-body strong { font-weight: 600; } .markdown-body hr { height: 0; margin: 15px 0; overflow: hidden; background: transparent; border: 0; border-bottom: 1px solid #dfe2e5; } .markdown-body hr::before { display: table; content: ""; } .markdown-body hr::after { display: table; clear: both; content: ""; } .markdown-body table { border-spacing: 0; border-collapse: collapse; } .markdown-body td, .markdown-body th { padding: 0; } .markdown-body h1, .markdown-body h2, .markdown-body h3, .markdown-body h4, .markdown-body h5, .markdown-body h6 { margin-top: 0; margin-bottom: 0; } .markdown-body h1 { font-size: 32px; font-weight: 600; } .markdown-body h2 { font-size: 24px; font-weight: 600; } .markdown-body h3 { font-size: 20px; font-weight: 600; } .markdown-body h4 { font-size: 16px; font-weight: 600; } .markdown-body h5 { font-size: 14px; font-weight: 600; } .markdown-body h6 { font-size: 12px; font-weight: 600; } .markdown-body p { margin-top: 0; margin-bottom: 10px; } .markdown-body blockquote { margin: 0; } .markdown-body ul, .markdown-body ol { padding-left: 0; margin-top: 0; margin-bottom: 0; } .markdown-body ol ol, .markdown-body ul ol { list-style-type: lower-roman; } .markdown-body ul ul ol, .markdown-body ul ol ol, .markdown-body ol ul ol, .markdown-body ol ol ol { list-style-type: lower-alpha; } .markdown-body dd { margin-left: 0; } .markdown-body code { font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; } .markdown-body pre { margin-top: 0; margin-bottom: 0; font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; } .markdown-body .octicon { vertical-align: text-bottom; } .markdown-body .pl-0 { padding-left: 0 !important; } .markdown-body .pl-1 { padding-left: 4px !important; } .markdown-body .pl-2 { padding-left: 8px !important; } .markdown-body .pl-3 { padding-left: 16px !important; } .markdown-body .pl-4 { padding-left: 24px !important; } .markdown-body .pl-5 { padding-left: 32px !important; } .markdown-body .pl-6 { padding-left: 40px !important; } .markdown-body::before { display: table; content: ""; } .markdown-body::after { display: table; clear: both; content: ""; } .markdown-body>*:first-child { margin-top: 0 !important; } .markdown-body>*:last-child { margin-bottom: 0 !important; } .markdown-body a:not([href]) { color: inherit; text-decoration: none; } .markdown-body .anchor { float: left; padding-right: 4px; margin-left: -20px; line-height: 1; } .markdown-body .anchor:focus { outline: none; } .markdown-body p, .markdown-body blockquote, .markdown-body ul, .markdown-body ol, .markdown-body dl, .markdown-body table, .markdown-body pre { margin-top: 0; margin-bottom: 16px; } .markdown-body hr { height: 0.25em; padding: 0; margin: 24px 0; background-color: #e1e4e8; border: 0; } .markdown-body blockquote { padding: 0 1em; color: #6a737d; border-left: 0.25em solid #dfe2e5; } .markdown-body blockquote>:first-child { margin-top: 0; } .markdown-body blockquote>:last-child { margin-bottom: 0; } .markdown-body kbd { display: inline-block; padding: 3px 5px; font-size: 11px; line-height: 10px; color: #444d56; vertical-align: middle; background-color: #fafbfc; border: solid 1px #c6cbd1; border-bottom-color: #959da5; border-radius: 3px; box-shadow: inset 0 -1px 0 #959da5; } .markdown-body h1, .markdown-body h2, .markdown-body h3, .markdown-body h4, .markdown-body h5, .markdown-body h6 { margin-top: 24px; margin-bottom: 16px; font-weight: 600; line-height: 1.25; } .markdown-body h1 .octicon-link, .markdown-body h2 .octicon-link, .markdown-body h3 .octicon-link, .markdown-body h4 .octicon-link, .markdown-body h5 .octicon-link, .markdown-body h6 .octicon-link { color: #1b1f23; vertical-align: middle; visibility: hidden; } .markdown-body h1:hover .anchor, .markdown-body h2:hover .anchor, .markdown-body h3:hover .anchor, .markdown-body h4:hover .anchor, .markdown-body h5:hover .anchor, .markdown-body h6:hover .anchor { text-decoration: none; } .markdown-body h1:hover .anchor .octicon-link, .markdown-body h2:hover .anchor .octicon-link, .markdown-body h3:hover .anchor .octicon-link, .markdown-body h4:hover .anchor .octicon-link, .markdown-body h5:hover .anchor .octicon-link, .markdown-body h6:hover .anchor .octicon-link { visibility: visible; } .markdown-body h1 { padding-bottom: 0.3em; font-size: 2em; border-bottom: 1px solid #eaecef; } .markdown-body h2 { padding-bottom: 0.3em; font-size: 1.5em; border-bottom: 1px solid #eaecef; } .markdown-body h3 { font-size: 1.25em; } .markdown-body h4 { font-size: 1em; } .markdown-body h5 { font-size: 0.875em; } .markdown-body h6 { font-size: 0.85em; color: #6a737d; } .markdown-body ul, .markdown-body ol { padding-left: 2em; } .markdown-body ul ul, .markdown-body ul ol, .markdown-body ol ol, .markdown-body ol ul { margin-top: 0; margin-bottom: 0; } .markdown-body li>p { margin-top: 16px; } .markdown-body li+li { margin-top: 0.25em; } .markdown-body dl { padding: 0; } .markdown-body dl dt { padding: 0; margin-top: 16px; font-size: 1em; font-style: italic; font-weight: 600; } .markdown-body dl dd { padding: 0 16px; margin-bottom: 16px; } .markdown-body table { display: block; width: 100%; overflow: auto; } .markdown-body table th { font-weight: 600; } .markdown-body table th, .markdown-body table td { padding: 6px 13px; border: 1px solid #dfe2e5; } .markdown-body table tr { background-color: #fff; border-top: 1px solid #c6cbd1; } .markdown-body table tr:nth-child(2n) { background-color: #f6f8fa; } .markdown-body img { max-width: 100%; box-sizing: content-box; background-color: #fff; } .markdown-body img[align=right] { padding-left: 20px; } .markdown-body img[align=left] { padding-right: 20px; } .markdown-body code { padding: 0; padding-top: 0.2em; padding-bottom: 0.2em; margin: 0; font-size: 85%; background-color: rgba(27,31,35,0.05); border-radius: 3px; } .markdown-body code::before, .markdown-body code::after { letter-spacing: -0.2em; content: "\00a0"; } .markdown-body pre { word-wrap: normal; } .markdown-body pre>code { padding: 0; margin: 0; font-size: 100%; word-break: normal; white-space: pre; background: transparent; border: 0; } .markdown-body .highlight { margin-bottom: 16px; } .markdown-body .highlight pre { margin-bottom: 0; word-break: normal; } .markdown-body .highlight pre, .markdown-body pre { padding: 16px; overflow: auto; font-size: 85%; line-height: 1.45; background-color: #f6f8fa; border-radius: 3px; } .markdown-body pre code { display: inline; max-width: auto; padding: 0; margin: 0; overflow: visible; line-height: inherit; word-wrap: normal; background-color: transparent; border: 0; } .markdown-body pre code::before, .markdown-body pre code::after { content: normal; } .markdown-body .full-commit .btn-outline:not(:disabled):hover { color: #005cc5; border-color: #005cc5; } .markdown-body kbd { display: inline-block; padding: 3px 5px; font: 11px "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; line-height: 10px; color: #444d56; vertical-align: middle; background-color: #fafbfc; border: solid 1px #d1d5da; border-bottom-color: #c6cbd1; border-radius: 3px; box-shadow: inset 0 -1px 0 #c6cbd1; } .markdown-body :checked+.radio-label { position: relative; z-index: 1; border-color: #0366d6; } .markdown-body .task-list-item { list-style-type: none; } .markdown-body .task-list-item+.task-list-item { margin-top: 3px; } .markdown-body .task-list-item input { margin: 0 0.2em 0.25em -1.6em; vertical-align: middle; } .markdown-body hr { border-bottom-color: #eee; } /*Markdown Viewer*/ .markdown-body summary:hover { cursor: pointer; } .markdown-body ul li p { margin: 0; } ================================================ FILE: doc/themes/godspeed.css ================================================ /* Title: Godspeed */ /* Author: Jocelyn Richard http://jocelynrichard.com/ */ /* Description: A quirky, low-contrast theme. Works best with Brush Up: http://www.myfonts.com/fonts/pintassilgo/brush-up/ */ /* ================================================ */ /* 1. Reset */ /* 2. Skeleton */ /* 3. Media Queries */ /* 4. Print Styles */ /* 5. Godspeed Overrides */ /* ================================================ */ /* ================================================ */ /* 1. Reset */ /* ================================================ */ html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary, time, mark, audio, video {margin: 0; padding: 0; border: 0;} /* Edited from http://www.cssreset.com/scripts/eric-meyer-reset-css/ */ article, aside, details, figcaption, figure, footer, header, hgroup, nav, section, summary {display: block;} /* Semantic tags definition for IE 6/7/8/9 and Firefox 3 */ html {-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%;} /* Prevents iOS text size adjust after orientation change, without disabling user zoom */ /* ================================================ */ /* 2. Skeleton */ /* ================================================ */ /* ------------------------------------------------- */ /* General */ /* ------------------------------------------------- */ html { font-size: 14px; } body { font-family: 'Open Sans', sans-serif; margin: 1.71rem 1.71rem 3rem 1.71rem ; /* Get margins even if the Markdown rendering app doesn't include any */ background-color: white; color: #222; } #wrapper { /* #wrapper: ID added by Marked */ max-width: 42rem; margin: 0 auto; margin-left: auto !important; /* Countering toc.css added by Marked */ padding: 1.71rem 0 !important; /* Countering toc.css added by Marked */ } /* ------------------------------------------------- */ /* Typography */ /* ------------------------------------------------- */ h1, h2, h3, h4, h5, h6 { margin-bottom: 1.6rem; } h1, h2 { margin-top: 3.2rem; } h1 { font-size: 2.82rem; /* 42.3px @15px */ line-height: 3.2rem; /* 48px @15px */ } h2 { font-size: 1.99rem; /* 29.9px @15px */ line-height: 2.4rem; /* 36px @15px */ } h3 { font-size: 1.41rem; /* 21.2px @15px */ line-height: 2rem; /* 30px @15px */ } h4 { font-size: 1rem; /* 15px @15px */ line-height: 1.6rem; /* 24px @15px */ } h5, h6 { font-size: 0.8rem; line-height: 1.2rem; text-transform: uppercase; } h6 { margin-left: 1.6rem; } p, ol, ul, blockquote { font-size: 1rem; line-height: 1.6rem; margin-bottom: 1.6rem; } ul ul, ul ol, ol ul, ol ol { margin-left: 1.6rem; margin-top: 1.6rem; } #generated-toc ul ul, /* #generated-toc: added by Marked for its table of contents */ #generated-toc ul ol, #generated-toc ol ul, #generated-toc ol ol { margin-top: 0; margin-bottom: 0; padding-top: 0; padding-bottom: 0; } blockquote { margin: 0 0 1.6rem 2.4rem; padding-left: 0.8rem; /* Voire */ border-left: 4px solid rgba(0,0,0,0.08); font-style: normal; } blockquote ul { margin-left: 0.8rem; /* Pour ne pas que les hanging bullets mordent sur le blockquote */ } ol li blockquote, /* So that blockquote work in lists */ ul li blockquote { margin-left: 0; } a:link { text-decoration: none; color: #165bd4; border-bottom: 1px solid #ccc; } a:visited { color: #7697cf; border-bottom: 1px solid #ccc; } a:hover { border-color: #165bd4; } a:active { background-color: #e6e6e6; } /* ------------------------------------------------- */ /* Tables */ /* ------------------------------------------------- */ table { font-size: 0.85rem; margin: 0 0 1.6rem 0; border-collapse: collapse; border: 1px solid #ccc; } th, td { padding: 0.5rem 0.75rem; max-width: 20rem; /* Avoid dropping lines for nothing without having ridiculously wide tables */ } th { border-bottom: 2px solid #222; } tr { border-bottom: 1px solid #ccc; } tbody tr:nth-child(odd) { background-color: #f9f9f9; } table code { font-size: 85%; } /* ------------------------------------------------- */ /* Misc */ /* ------------------------------------------------- */ img { max-width: 100% } caption, figcaption { font-size: 0.85rem; line-height: 1.6rem; margin: 0 1.6rem; text-align: left; } figcaption { margin-bottom: 1.6rem; } h1, /* White-space mentions in order to force wrapping */ h2, a:link { white-space: pre; /* CSS 2.0 */ white-space: pre-wrap; /* CSS 2.1 */ white-space: pre-line; /* CSS 3.0 */ white-space: -pre-wrap; /* Opera 4-6 */ white-space: -o-pre-wrap; /* Opera 7 */ white-space: -moz-pre-wrap; /* Mozilla */ white-space: -hp-pre-wrap; /* HP Printers */ word-wrap: break-word; /* IE 5+ */ } code { font-family: "Menlo", "Courier New", "Courier", monospace; font-size: 85%; color: #666; background-color: rgba(0,0,0,0.08); padding: 2px 4px; border-radius: 2px; } pre { background-color: rgba(0,0,0,0.08); border-radius: 8px; padding: 0.4rem; margin-bottom: 1.6rem; } pre code { /* Counter the code mentions */ background-color: transparent; padding: 0; } sup, sub, a.footnote { /* Keep line-height from being affected by sub, cf https://gist.github.com/unruthless/413930 */ font-size: 75%; height: 0; line-height: 1; position: relative; } sup, a.footnote { vertical-align:super; } sub { vertical-align: sub; } dt { font-weight: 600; } dd { font-size: 1rem; line-height: 1.6rem; margin-bottom: 1.6rem; } hr { clear: none; height: 0.2rem; border: none; margin: 0 auto 1.4rem auto; /* 2.4rem auto 2.2rem auto; */ width: 100%; color: #ccc; background-color: #ccc; } ::selection { background-color: #f8dc77; } ::-moz-selection { background-color: #f8dc77; } a:focus { outline: 2px solid; outline-color: #165bd4; } /* ------------------------------------------------- */ /* Animations */ /* ------------------------------------------------- */ a:hover { -moz-transition: all 0.2s ease-in-out; -webkit-transition: all 0.2s ease-in-out; } h1, h2, h3, h4, h5, h6, p, blockquote { -moz-transition: all 0.2s ease; -webkit-transition: all 0.2s ease; } /* ================================================ */ /* 3. Media Queries */ /* ================================================ */ /* Base styles are for smartphones; elements are then tweaked as the viewport grows. */ /* ------------------------------------------------- */ /* iPad and desktop */ /* ------------------------------------------------- */ @media only screen and (min-width: 641px) { html { font-size: 15px; } body { margin: 2.4rem 2.4rem 3.2rem 2.4rem; } h1 { font-size: 3.57rem; /* 53.2px @15px */ line-height: 4rem; /* 60px @15px */ } h2 { font-size: 2.24rem; /* 33.6px @15px */ line-height: 2.8rem; /* 42px @15px */ } } /* ------------------------------------------------- */ /* Widescreens */ /* ------------------------------------------------- */ @media only screen and (min-width: 1441px) { html { font-size: 22px; } } /* ================================================ */ /* 4. Print Styles */ /* ================================================ */ /* Inconsistent and buggy across browsers */ @media print { * { background: transparent !important; color: #000 !important; /* Black text prints faster and browsers are inconsistent in color reproduction anyway: h5bp.com/s */ } @page { margin: 1cm; /* Added to any #wrapper margin*/ } html { font-size: 15px; } body { margin: 1rem !important; /* Security margins for browser without @page support */ } #wrapper { max-width: none; } h1, h2, h3, h4, h5, h6, p { orphans: 3; widows: 3; page-break-after: avoid; } ul, ol { list-style-position: inside !important; padding-right: 0 !important; margin-left: 0 !important; } ul ul, ul ol, ol ul, ol ol, ul p:not(:first-child), ol p:not(:first-child) { margin-left: 2rem !important; } a:link, a:visited { text-decoration: underline !important; font-weight: normal !important; } a[href]:after { content: " (" attr(href) ")"; } a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; /* Do not show javascript and internal links */ } a[href^="#"] { text-decoration: none !important; } th { background-color: rgba(0,0,0,0.2) !important; border-bottom: none !important; } tr { page-break-inside: avoid; } tbody tr:nth-child(even) { background-color: rgba(0,0,0,0.1) !important; } pre { border: 1px solid rgba(0,0,0,0.2); page-break-inside: avoid; } img { max-width: 100% !important; page-break-inside: avoid; } /* #generated-toc: added by Marked for its table of contents */ #wrapper #generated-toc ul, /* Table of contents printing in Marked */ #wrapper #generated-toc ol { list-style-type: decimal; } #wrapper #generated-toc ul li, #wrapper #generated-toc ol li { margin: 1rem 0; } } /* ================================================ */ /* 5. Godspeed Overrides */ /* ================================================ */ /* ------------------------------------------------- */ /* General */ /* ------------------------------------------------- */ body { font-family: 'Source Sans Pro', Avenir, sans-serif; background-color: #3c3d46; color: #7d7d7a; margin-bottom: 2.4rem; /* Visual tweak */ } /* ------------------------------------------------- */ /* Typography */ /* ------------------------------------------------- */ h1 { font-family: 'Brush Up Too', 'Source Sans Pro', Avenir, sans-serif; color: #e6ceaa; } h2, h3 { color: #b98552; text-transform: uppercase; } h4, h5, h6 { text-transform: uppercase; } blockquote { border-color: rgba(0,0,0,0.1); /* Pour correspondre à l'opacité des bordures ajoutées au #wrapper */ } a:link { color: #6190d2; text-decoration: none; border-bottom: 2px solid rgba(0,0,0,0.2); } a:hover { color: #6190d2; text-decoration: none; border-bottom: 1px solid #6190d2; } /* ------------------------------------------------- */ /* Tables */ /* ------------------------------------------------- */ table { border: 1px solid #7d7d7a; border-radius: 8px; } th { color: #b98552; border-bottom: 1px solid #7d7d7a; } tr { border-bottom: 1px solid #7d7d7a; } tbody tr:nth-child(odd) { background-color: rgba(60,75,94,0.5); } /* ------------------------------------------------- */ /* Misc */ /* ------------------------------------------------- */ code { font-size: 75%; /* Matching better Source Sans */ color: #3c3d46; background-color: #7d7d7a; } pre { background-color: rgba(60,75,94,0.5); } pre code { color: #7d7d7a; } hr { color: rgba(0,0,0,0.2); background-color: rgba(0,0,0,0.2); } ::selection { background-color: rgba(0,0,0,0.2); } ::-moz-selection { background-color: rgba(0,0,0,0.2); } a:focus { outline: 2px dotted; outline-color: #7d7d7a; } /* ------------------------------------------------- */ /* iPad and desktop */ /* ------------------------------------------------- */ @media only screen and (min-width: 641px) { html { font-size: 16px; } #wrapper { padding: 0 2.4rem; border: 1px solid rgba(0,0,0,0.2) !important; /* !important otherwise doesn't show up in Marked */ box-shadow: 0 0 0 6px rgba(0,0,0,0.1); padding: 2.4rem !important; border-radius: 4px; } } /* ------------------------------------------------- */ /* Widescreens */ /* ------------------------------------------------- */ @media only screen and (min-width: 1441px) { html { font-size: 22px; } } ================================================ FILE: doc/themes/markdown-alt.css ================================================ body { line-height: 1.4em; color: black; padding:1em; margin:auto; max-width:42em; } li { color: black; } h1, h2, h3, h4, h5, h6 { border: 0 none !important; } h1 { margin-top: 0.5em; margin-bottom: 0.5em; border-bottom: 2px solid #000080 !important; } h2 { margin-top: 1em; margin-bottom: 0.5em; border-bottom: 2px solid #000080 !important; } pre { background-color: #f8f8f8; border: 1px solid #2f6fab; border-radius: 3px; overflow: auto; padding: 5px; } pre code { background-color: inherit; border: none; padding: 0; } code { background-color: #ffffe0; border: 1px solid orange; border-radius: 3px; padding: 0 0.2em; } a { text-decoration: underline; } ul, ol { padding-left: 30px; } li { margin: 0.2em 0 0 0em; padding: 0px; } em { color: #b05000; } table.text th, table.text td { vertical-align: top; border-top: 1px solid #ccc; padding:5px; } ================================================ FILE: doc/themes/markdown.css ================================================ html { font-size: 100%; overflow-y: scroll; -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; } body{ color:#444; font-family:Georgia, Palatino, 'Palatino Linotype', Times, 'Times New Roman', serif; font-size:12px; line-height:1.5em; padding:1em; margin:auto; max-width:42em; background:#fefefe; } a{ color: #0645ad; text-decoration:none;} a:visited{ color: #0b0080; } a:hover{ color: #06e; } a:active{ color:#faa700; } a:focus{ outline: thin dotted; } a:hover, a:active{ outline: 0; } ::-moz-selection{background:rgba(255,255,0,0.3);color:#000} ::selection{background:rgba(255,255,0,0.3);color:#000} a::-moz-selection{background:rgba(255,255,0,0.3);color:#0645ad} a::selection{background:rgba(255,255,0,0.3);color:#0645ad} p{ margin:1em 0; } img{ max-width:100%; } h1,h2,h3,h4,h5,h6{ font-weight:normal; color:#111; line-height:1em; } h4,h5,h6{ font-weight: bold; } h1{ font-size:2.5em; } h2{ font-size:2em; } h3{ font-size:1.5em; } h4{ font-size:1.2em; } h5{ font-size:1em; } h6{ font-size:0.9em; } blockquote{ color:#666666; margin:0; padding-left: 3em; border-left: 0.5em #EEE solid; } hr { display: block; height: 2px; border: 0; border-top: 1px solid #aaa;border-bottom: 1px solid #eee; margin: 1em 0; padding: 0; } pre, code, kbd, samp { color: #000; font-family: monospace, monospace; _font-family: 'courier new', monospace; font-size: 0.98em; } pre { white-space: pre; white-space: pre-wrap; word-wrap: break-word; } b, strong { font-weight: bold; } dfn { font-style: italic; } ins { background: #ff9; color: #000; text-decoration: none; } mark { background: #ff0; color: #000; font-style: italic; font-weight: bold; } sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; } sup { top: -0.5em; } sub { bottom: -0.25em; } ul, ol { margin: 1em 0; padding: 0 0 0 2em; } li p:last-child { margin:0 } dd { margin: 0 0 0 2em; } img { border: 0; -ms-interpolation-mode: bicubic; vertical-align: middle; } table { border-collapse: collapse; border-spacing: 0; } td { vertical-align: top; } @media only screen and (min-width: 480px) { body{font-size:14px;} } @media only screen and (min-width: 768px) { body{font-size:16px;} } @media print { * { background: transparent !important; color: black !important; filter:none !important; -ms-filter: none !important; } body{font-size:12pt; max-width:100%;} a, a:visited { text-decoration: underline; } hr { height: 1px; border:0; border-bottom:1px solid black; } a[href]:after { content: " (" attr(href) ")"; } abbr[title]:after { content: " (" attr(title) ")"; } .ir a:after, a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; } pre, blockquote { border: 1px solid #999; padding-right: 1em; page-break-inside: avoid; } tr, img { page-break-inside: avoid; } img { max-width: 100% !important; } @page :left { margin: 15mm 20mm 15mm 10mm; } @page :right { margin: 15mm 10mm 15mm 20mm; } p, h2, h3 { orphans: 3; widows: 3; } h2, h3 { page-break-after: avoid; } } ================================================ FILE: doc/themes/markdown5.css ================================================ body{ margin: 0 auto; background-color:white; /* --------- FONT FAMILY -------- following are some optional font families. Usually a family is safer to choose than a specific font, which may not be on the users computer */ font-family:Georgia, Palatino, serif; /* -------------- COLOR OPTIONS ------------ following are additional color options for base font you could uncomment another one to easily change the base color or add one to a specific element style below */ color: #333333; /* dark gray not black */ line-height: 1; max-width: 800px; padding: 30px; font-size: 18px; } p { line-height: 150%; max-width: 960px; font-weight: 400; color: #333333 } h1, h2, h3, h4 { font-weight: 400; } h2, h3, h4, h5, p { margin-bottom: 25px; padding: 0; } h1 { margin-bottom: 10px; font-size:300%; padding: 0px; font-variant:small-caps; } h2 { font-size:150% } h3 { font-size:120% } h4 { font-size:100% font-variant:small-caps; } h5 { font-size:80% font-weight: 100; } h6 { font-size:80% font-weight: 100; color:red; font-variant:small-caps; } a { color: grey; margin: 0; padding: 0; vertical-align: baseline; } a:hover { text-decoration: blink; color: green; } a:visited { color: black; } ul, ol { padding: 0; margin: 0px 0px 0px 50px; } ul { list-style-type: square; list-style-position: inside; } li { line-height:150% } li ul, li ul { margin-left: 24px; } pre { padding: 0px 24px; max-width: 800px; white-space: pre-wrap; } code { font-family: Consolas, Monaco, Andale Mono, monospace; line-height: 1.5; font-size: 13px; } aside { display: block; float: right; width: 390px; } blockquote { border-left:.5em solid #eee; padding: 0 1em; margin-left:0; max-width: 476px; } blockquote cite { line-height:20px; color:#bfbfbf; } blockquote cite:before { content: '\2014 \00A0'; } blockquote p { color: #666; max-width: 460px; } hr { text-align: left; margin: 0 auto 0 0; color: #999; } ================================================ FILE: doc/themes/markdown6.css ================================================ /* Extracted and interpreted from adcstyle.css and frameset_styles.css */ /* body */ body { margin: 20px auto; width: 800px; background-color: #fff; color: #000; font: 13px "Myriad Pro", "Lucida Grande", Lucida, Verdana, sans-serif; } /* links */ a:link { color: #00f; text-decoration: none; } a:visited { color: #00a; text-decoration: none; } a:hover { color: #f60; text-decoration: underline; } a:active { color: #f60; text-decoration: underline; } /* html tags */ /* Work around IE/Win code size bug - courtesy Jesper, waffle.wootest.net */ * html code { font-size: 101%; } * html pre { font-size: 101%; } /* code */ pre, code { font-size: 11px; font-family: monaco, courier, consolas, monospace; } pre { margin-top: 5px; margin-bottom: 10px; border: 1px solid #c7cfd5; background: #f1f5f9; margin: 20px 0; padding: 8px; text-align: left; } hr { color: #919699; size: 1; width: 100%; noshade: "noshade" } /* headers */ h1, h2, h3, h4, h5, h6 { font-family: "Myriad Pro", "Lucida Grande", Lucida, Verdana, sans-serif; font-weight: bold; } h1 { margin-top: 1em; margin-bottom: 25px; color: #000; font-weight: bold; font-size: 30px; } h2 { margin-top: 2.5em; font-size: 24px; color: #000; padding-bottom: 2px; border-bottom: 1px solid #919699; } h3 { margin-top: 2em; margin-bottom: .5em; font-size: 17px; color: #000; } h4 { margin-top: 2em; margin-bottom: .5em; font-size: 15px; color: #000; } h5 { margin-top: 20px; margin-bottom: .5em; padding: 0; font-size: 13px; color: #000; } h6 { margin-top: 20px; margin-bottom: .5em; padding: 0; font-size: 11px; color: #000; } p { margin-top: 0px; margin-bottom: 10px; } /* lists */ ul { list-style: square outside; margin: 0 0 0 30px; padding: 0 0 12px 6px; } li { margin-top: 7px; } ol { list-style-type: decimal; list-style-position: outside; margin: 0 0 0 30px; padding: 0 0 12px 6px; } ol ol { list-style-type: lower-alpha; list-style-position: outside; margin: 7px 0 0 30px; padding: 0 0 0 10px; } ul ul { margin-left: 40px; padding: 0 0 0 6px; } li>p { display: inline } li>p+p { display: block } li>a+p { display: block } /* table */ table { width: 100%; border-top: 1px solid #919699; border-left: 1px solid #919699; border-spacing: 0; } table th { padding: 4px 8px 4px 8px; background: #E2E2E2; font-size: 12px; border-bottom: 1px solid #919699; border-right: 1px solid #919699; } table th p { font-weight: bold; margin-bottom: 0px; } table td { padding: 8px; font-size: 12px; vertical-align: top; border-bottom: 1px solid #919699; border-right: 1px solid #919699; } table td p { margin-bottom: 0px; } table td p + p { margin-top: 5px; } table td p + p + p { margin-top: 5px; } /* forms */ form { margin: 0; } button { margin: 3px 0 10px 0; } input { vertical-align: middle; padding: 0; margin: 0 0 5px 0; } select { vertical-align: middle; padding: 0; margin: 0 0 3px 0; } textarea { margin: 0 0 10px 0; width: 100%; } ================================================ FILE: doc/themes/markdown7.css ================================================ body { font-family: Helvetica, arial, sans-serif; font-size: 14px; line-height: 1.6; padding-top: 10px; padding-bottom: 10px; background-color: white; padding: 30px; } body > *:first-child { margin-top: 0 !important; } body > *:last-child { margin-bottom: 0 !important; } a { color: #4183C4; } a.absent { color: #cc0000; } a.anchor { display: block; padding-left: 30px; margin-left: -30px; cursor: pointer; position: absolute; top: 0; left: 0; bottom: 0; } h1, h2, h3, h4, h5, h6 { margin: 20px 0 10px; padding: 0; font-weight: bold; -webkit-font-smoothing: antialiased; cursor: text; position: relative; } h1:hover a.anchor, h2:hover a.anchor, h3:hover a.anchor, h4:hover a.anchor, h5:hover a.anchor, h6:hover a.anchor { text-decoration: none; } h1 tt, h1 code { font-size: inherit; } h2 tt, h2 code { font-size: inherit; } h3 tt, h3 code { font-size: inherit; } h4 tt, h4 code { font-size: inherit; } h5 tt, h5 code { font-size: inherit; } h6 tt, h6 code { font-size: inherit; } h1 { font-size: 28px; color: black; } h2 { font-size: 24px; border-bottom: 1px solid #cccccc; color: black; } h3 { font-size: 18px; } h4 { font-size: 16px; } h5 { font-size: 14px; } h6 { color: #777777; font-size: 14px; } p, blockquote, ul, ol, dl, li, table, pre { margin: 15px 0; } hr { border: 0 none; color: #cccccc; height: 4px; padding: 0; } body > h2:first-child { margin-top: 0; padding-top: 0; } body > h1:first-child { margin-top: 0; padding-top: 0; } body > h1:first-child + h2 { margin-top: 0; padding-top: 0; } body > h3:first-child, body > h4:first-child, body > h5:first-child, body > h6:first-child { margin-top: 0; padding-top: 0; } a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 { margin-top: 0; padding-top: 0; } h1 p, h2 p, h3 p, h4 p, h5 p, h6 p { margin-top: 0; } li p.first { display: inline-block; } li { margin: 0; } ul, ol { padding-left: 30px; } ul :first-child, ol :first-child { margin-top: 0; } dl { padding: 0; } dl dt { font-size: 14px; font-weight: bold; font-style: italic; padding: 0; margin: 15px 0 5px; } dl dt:first-child { padding: 0; } dl dt > :first-child { margin-top: 0; } dl dt > :last-child { margin-bottom: 0; } dl dd { margin: 0 0 15px; padding: 0 15px; } dl dd > :first-child { margin-top: 0; } dl dd > :last-child { margin-bottom: 0; } blockquote { border-left: 4px solid #dddddd; padding: 0 15px; color: #777777; } blockquote > :first-child { margin-top: 0; } blockquote > :last-child { margin-bottom: 0; } table { padding: 0;border-collapse: collapse; } table tr { border-top: 1px solid #cccccc; background-color: white; margin: 0; padding: 0; } table tr:nth-child(2n) { background-color: #f8f8f8; } table tr th { font-weight: bold; border: 1px solid #cccccc; margin: 0; padding: 6px 13px; } table tr td { border: 1px solid #cccccc; margin: 0; padding: 6px 13px; } table tr th :first-child, table tr td :first-child { margin-top: 0; } table tr th :last-child, table tr td :last-child { margin-bottom: 0; } img { max-width: 100%; } span.frame { display: block; overflow: hidden; } span.frame > span { border: 1px solid #dddddd; display: block; float: left; overflow: hidden; margin: 13px 0 0; padding: 7px; width: auto; } span.frame span img { display: block; float: left; } span.frame span span { clear: both; color: #333333; display: block; padding: 5px 0 0; } span.align-center { display: block; overflow: hidden; clear: both; } span.align-center > span { display: block; overflow: hidden; margin: 13px auto 0; text-align: center; } span.align-center span img { margin: 0 auto; text-align: center; } span.align-right { display: block; overflow: hidden; clear: both; } span.align-right > span { display: block; overflow: hidden; margin: 13px 0 0; text-align: right; } span.align-right span img { margin: 0; text-align: right; } span.float-left { display: block; margin-right: 13px; overflow: hidden; float: left; } span.float-left span { margin: 13px 0 0; } span.float-right { display: block; margin-left: 13px; overflow: hidden; float: right; } span.float-right > span { display: block; overflow: hidden; margin: 13px auto 0; text-align: right; } code, tt { margin: 0 2px; padding: 0 5px; white-space: nowrap; border: 1px solid #eaeaea; background-color: #f8f8f8; border-radius: 3px; } pre code { margin: 0; padding: 0; white-space: pre; border: none; background: transparent; } .highlight pre { background-color: #f8f8f8; border: 1px solid #cccccc; font-size: 13px; line-height: 19px; overflow: auto; padding: 6px 10px; border-radius: 3px; } pre { background-color: #f8f8f8; border: 1px solid #cccccc; font-size: 13px; line-height: 19px; overflow: auto; padding: 6px 10px; border-radius: 3px; } pre code, pre tt { background-color: transparent; border: none; } sup { font-size: 0.83em; vertical-align: super; line-height: 0; } * { -webkit-print-color-adjust: exact; } @media screen and (min-width: 914px) { body { width: 854px; margin:0 auto; } } @media print { table, pre { page-break-inside: avoid; } pre { word-wrap: break-word; } } ================================================ FILE: doc/themes/markdown8.css ================================================ h1, h2, h3, h4, h5, h6, p, blockquote { margin: 0; padding: 0; } body { font-family: "Helvetica Neue", Helvetica, "Hiragino Sans GB", Arial, sans-serif; font-size: 13px; line-height: 18px; color: #737373; background-color: white; margin: 10px 13px 10px 13px; } table { margin: 10px 0 15px 0; border-collapse: collapse; } td,th { border: 1px solid #ddd; padding: 3px 10px; } th { padding: 5px 10px; } a { color: #0069d6; } a:hover { color: #0050a3; text-decoration: none; } a img { border: none; } p { margin-bottom: 9px; } h1, h2, h3, h4, h5, h6 { color: #404040; line-height: 36px; } h1 { margin-bottom: 18px; font-size: 30px; } h2 { font-size: 24px; } h3 { font-size: 18px; } h4 { font-size: 16px; } h5 { font-size: 14px; } h6 { font-size: 13px; } hr { margin: 0 0 19px; border: 0; border-bottom: 1px solid #ccc; } blockquote { padding: 13px 13px 21px 15px; margin-bottom: 18px; font-family:georgia,serif; font-style: italic; } blockquote:before { content:"\201C"; font-size:40px; margin-left:-10px; font-family:georgia,serif; color:#eee; } blockquote p { font-size: 14px; font-weight: 300; line-height: 18px; margin-bottom: 0; font-style: italic; } code, pre { font-family: Monaco, Andale Mono, Courier New, monospace; } code { background-color: #fee9cc; color: rgba(0, 0, 0, 0.75); padding: 1px 3px; font-size: 12px; -webkit-border-radius: 3px; -moz-border-radius: 3px; border-radius: 3px; } pre { display: block; padding: 14px; margin: 0 0 18px; line-height: 16px; font-size: 11px; border: 1px solid #d9d9d9; white-space: pre-wrap; word-wrap: break-word; } pre code { background-color: #fff; color:#737373; font-size: 11px; padding: 0; } sup { font-size: 0.83em; vertical-align: super; line-height: 0; } * { -webkit-print-color-adjust: exact; } @media screen and (min-width: 914px) { body { width: 854px; margin:10px auto; } } @media print { body,code,pre code,h1,h2,h3,h4,h5,h6 { color: black; } table, pre { page-break-inside: avoid; } } ================================================ FILE: doc/themes/markdown9.css ================================================ h1, h2, h3, h4, h5, h6, p, blockquote { margin: 0; padding: 0; } body { font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; font-size: 13px; line-height: 18px; color: #fff; background-color: #110F14; margin: 10px 13px 10px 13px; } table { margin: 10px 0 15px 0; border-collapse: collapse; } td,th { border: 1px solid #ddd; padding: 3px 10px; } th { padding: 5px 10px; } a { color: #59acf3; } a:hover { color: #a7d8ff; text-decoration: none; } a img { border: none; } p { margin-bottom: 9px; } h1, h2, h3, h4, h5, h6 { color: #fff; line-height: 36px; } h1 { margin-bottom: 18px; font-size: 30px; } h2 { font-size: 24px; } h3 { font-size: 18px; } h4 { font-size: 16px; } h5 { font-size: 14px; } h6 { font-size: 13px; } hr { margin: 0 0 19px; border: 0; border-bottom: 1px solid #ccc; } blockquote { padding: 13px 13px 21px 15px; margin-bottom: 18px; font-family:georgia,serif; font-style: italic; } blockquote:before { content:"\201C"; font-size:40px; margin-left:-10px; font-family:georgia,serif; color:#eee; } blockquote p { font-size: 14px; font-weight: 300; line-height: 18px; margin-bottom: 0; font-style: italic; } code, pre { font-family: Menlo, Monaco, Andale Mono, Courier New, monospace; } code { padding: 1px 3px; font-size: 12px; -webkit-border-radius: 3px; -moz-border-radius: 3px; border-radius: 3px; background: #334; } pre { display: block; padding: 14px; margin: 0 0 18px; line-height: 16px; font-size: 11px; border: 1px solid #334; white-space: pre; white-space: pre-wrap; word-wrap: break-word; background-color: #282a36; border-radius: 6px; } pre code { font-size: 11px; padding: 0; background: transparent; } sup { font-size: 0.83em; vertical-align: super; line-height: 0; } * { -webkit-print-color-adjust: exact; } @media screen and (min-width: 914px) { body { width: 854px; margin:10px auto; } } @media print { body,code,pre code,h1,h2,h3,h4,h5,h6 { color: black; } table, pre { page-break-inside: avoid; } } ================================================ FILE: doc/themes/markedapp-byword.css ================================================ /* * This document has been created with Marked.app . * Copyright 2011 Brett Terpstra * --------------------------------------------------------------------------- * Please leave this notice in place, along with any additional credits below. * * Byword.css theme is based on Byword.app * Authors: @brunodecarvalho, @jpedroso, @rcabaco * Copyright 2011 Metaclassy, Lda. */ html { font-size: 62.5%; /* base font-size: 10px */ } body { background-color: #f2f2f2; color: #3c3c3c; /* Change font size below */ font-size: 1.7em; line-height: 1.4em; /* Change font below */ /* Sans-serif fonts */ font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; -webkit-font-smoothing: antialiased; /* Serif fonts */ /* font-family: "Cochin", "Baskerville", "Georgia", serif; -webkit-font-smoothing: subpixel-antialiased; */ /* Monospaced fonts */ /* font-family: "Courier New", Menlo, Monaco, mono; -webkit-font-smoothing: antialiased; */ margin: auto; max-width: 42em; } a { color: #308bd8; text-decoration:none; } a:hover { text-decoration: underline; } /* headings */ h1, h2 { line-height:1.2em; margin-top:32px; margin-bottom:12px; } h1:first-child { margin-top:0; } h3, h4, h5, h6 { margin-top:12px; margin-bottom:0; } h5, h6 { font-size:0.9em; line-height:1.0em; } /* end of headings */ p { margin:0 0 24px 0; } p:last-child { margin:0; } #wrapper hr { width: 100%; margin: 3em auto; border: 0; color: #eee; background-color: #ccc; height: 1px; -webkit-box-shadow:0px 1px 0px rgba(255, 255, 255, 0.75); } /* lists */ ol { list-style: outside decimal; } ul { list-style: outside disc; } ol, ul { padding-left:0; margin-bottom:24px; } ol li { margin-left:28px; } ul li { margin-bottom:8px; margin-left:16px; } ol:last-child, ul:last-child { margin:0; } li > ol, li > ul { padding-left:12px; } dl { margin-bottom:24px; } dl dt { font-weight:bold; margin-bottom:8px; } dl dd { margin-left:0; margin-bottom:12px; } dl dd:last-child, dl:last-child { margin-bottom:0; } /* end of lists */ pre { white-space: pre-wrap; width: 96%; margin-bottom: 24px; overflow: hidden; padding: 3px 10px; -webkit-border-radius: 3px; background-color: #eee; border: 1px solid #ddd; } code { white-space: nowrap; font-size: 1.1em; padding: 2px; -webkit-border-radius: 3px; background-color: #eee; border: 1px solid #ddd; } pre code { white-space: pre-wrap; border: none; padding: 0; background-color: transparent; -webkit-border-radius: 0; } blockquote { margin-left: 0; margin-right: 0; width: 96%; padding: 0 10px; border-left: 3px solid #ddd; color: #777; } table { margin-left: auto; margin-right: auto; margin-bottom: 24px; border-bottom: 1px solid #ddd; border-right: 1px solid #ddd; border-spacing: 0; } table th { padding: 3px 10px; background-color: #eee; border-top: 1px solid #ddd; border-left: 1px solid #ddd; } table tr { } table td { padding: 3px 10px; border-top: 1px solid #ddd; border-left: 1px solid #ddd; } caption { font-size: 1.2em; font-weight: bold; margin-bottom: 5px; } figure { display: block; text-align: center; } #wrapper img { border: none; display: block; margin: 1em auto; max-width: 100%; } figcaption { font-size: 0.8em; font-style: italic; } mark { background: #fefec0; padding:1px 3px; } /* classes */ .markdowncitation { } .footnote { font-size: 0.8em; vertical-align: super; } .footnotes ol { font-weight: bold; } .footnotes ol li p { font-weight: normal; } /* custom formatting classes */ .shadow { -webkit-box-shadow: 0 2px 4px #999; } .source { text-align: center; font-size: 0.8em; color: #777; margin: -40px; } @media screen { .inverted, .inverted #wrapper { background-color: #1a1a1a !important; color: #bebebe !important; /* SANS-SERIF */ font-family: "Helvetica Neue", Helvetica, Arial, sans-serif !important; -webkit-font-smoothing: antialiased !important; /* SERIF */ /* font-family: "Cochin", "Baskerville", "Georgia", serif !important; -webkit-font-smoothing: subpixel-antialiased !important; */ /* MONO */ /* font-family: "Courier", mono !important; -webkit-font-smoothing: antialiased !important; */ } .inverted a { color: #308bd8 !important; } .inverted hr { color: #666 !important; border: 0; background-color: #666 !important; -webkit-box-shadow: none !important; } .inverted pre { background-color: #222 !important; border-color: #3c3c3c !important; } .inverted code { background-color: #222 !important; border-color: #3c3c3c !important; } .inverted blockquote { border-color: #333 !important; color: #999 !important; } .inverted table { border-color: #3c3c3c !important; } .inverted table th { background-color: #222 !important; border-color: #3c3c3c !important; } .inverted table td { border-color: #3c3c3c !important; } .inverted mark { background: #bc990b !important; color:#000 !important; } .inverted .shadow { -webkit-box-shadow: 0 2px 4px #000 !important; } #wrapper { background: transparent; margin: 40px; } } /* Printing support */ @media print { body { overflow: auto; } img, pre, blockquote, table, figure { page-break-inside: avoid; } pre, code { border: none !important; } #wrapper { background: #fff; position: relative; text-indent: 0px; padding: 10px; font-size:85%; } .footnotes { page-break-before: always; } } ================================================ FILE: doc/themes/new-modern.css ================================================ /* Title: New Modern */ /* Author: Jocelyn Richard http://jocelynrichard.com/ */ /* Description: Baseline style, meant to be used on its own or to serve as development basis. */ /* ================================================ */ /* 1. Reset */ /* 2. Skeleton */ /* 3. Media Queries */ /* 4. Print Styles */ /* ================================================ */ /* ================================================ */ /* 1. Reset */ /* ================================================ */ html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary, time, mark, audio, video {margin: 0; padding: 0; border: 0;} /* Edited from http://www.cssreset.com/scripts/eric-meyer-reset-css/ */ article, aside, details, figcaption, figure, footer, header, hgroup, nav, section, summary {display: block;} /* Semantic tags definition for IE 6/7/8/9 and Firefox 3 */ html {-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%;} /* Prevents iOS text size adjust after orientation change, without disabling user zoom */ /* ================================================ */ /* 2. Skeleton */ /* ================================================ */ /* ------------------------------------------------- */ /* General */ /* ------------------------------------------------- */ html { font-size: 14px; } body { font-family: 'Open Sans', sans-serif; /*margin: 3.42rem 1.71rem !important;*/ /* Get margins even if the Markdown rendering app doesn't include any */ background-color: white; color: #222; } #wrapper { /* #wrapper: ID added by Marked */ max-width: 42rem; margin: 0 auto; margin-left: auto !important; /* Countering toc.css added by Marked */ padding: 1.71rem 0 !important; /* Countering toc.css added by Marked */ } /* ------------------------------------------------- */ /* Typography */ /* ------------------------------------------------- */ h1, h2, h3, h4, h5, h6 { margin-bottom: 1.6rem; } h1, h2 { margin-top: 3.2rem; } h1 { font-size: 2.82rem; /* 42.3px @15px */ line-height: 3.2rem; /* 48px @15px */ } h2 { font-size: 1.99rem; /* 29.9px @15px */ line-height: 2.4rem; /* 36px @15px */ } h3 { font-size: 1.41rem; /* 21.2px @15px */ line-height: 2rem; /* 30px @15px */ } h4 { font-size: 1rem; /* 15px @15px */ line-height: 1.6rem; /* 24px @15px */ } h5, h6 { font-size: 0.8rem; line-height: 1.2rem; text-transform: uppercase; } h6 { margin-left: 1.6rem; } p, ol, ul, blockquote { font-size: 1rem; line-height: 1.6rem; margin-bottom: 1.6rem; } ul ul, ul ol, ol ul, ol ol { margin-left: 1.6rem; margin-top: 1.6rem; } #generated-toc ul ul, /* #generated-toc: added by Marked for its table of contents */ #generated-toc ul ol, #generated-toc ol ul, #generated-toc ol ol { margin-top: 0; margin-bottom: 0; padding-top: 0; padding-bottom: 0; } blockquote { margin: 0 0 1.6rem 2.4rem; padding-left: 0.8rem; /* Voire */ border-left: 4px solid rgba(0,0,0,0.08); font-style: normal; } blockquote ul { margin-left: 0.8rem; /* Pour ne pas que les hanging bullets mordent sur le blockquote */ } ol li blockquote, /* So that blockquote work in lists */ ul li blockquote { margin-left: 0; } a:link { text-decoration: none; color: #165bd4; border-bottom: 1px solid #ccc; } a:visited { color: #7697cf; border-bottom: 1px solid #ccc; } a:hover { border-color: #165bd4; } a:active { background-color: #e6e6e6; } /* ------------------------------------------------- */ /* Tables */ /* ------------------------------------------------- */ table { font-size: 0.85rem; margin: 0 0 1.6rem 0; border-collapse: collapse; border: 1px solid #ccc; } th, td { padding: 0.5rem 0.75rem; max-width: 20rem; /* Avoid dropping lines for nothing without having ridiculously wide tables */ } th { border-bottom: 2px solid #222; } tr { border-bottom: 1px solid #ccc; } tbody tr:nth-child(odd) { background-color: #f9f9f9; } table code { font-size: 85%; } /* ------------------------------------------------- */ /* Misc */ /* ------------------------------------------------- */ img { max-width: 100% } caption, figcaption { font-size: 0.85rem; line-height: 1.6rem; margin: 0 1.6rem; text-align: left; } figcaption { margin-bottom: 1.6rem; } h1, /* White-space mentions in order to force wrapping */ h2, a:link, pre { white-space: pre; /* CSS 2.0 */ white-space: pre-wrap; /* CSS 2.1 */ white-space: pre-line; /* CSS 3.0 */ white-space: -pre-wrap; /* Opera 4-6 */ white-space: -o-pre-wrap; /* Opera 7 */ white-space: -moz-pre-wrap; /* Mozilla */ white-space: -hp-pre-wrap; /* HP Printers */ word-wrap: break-word; /* IE 5+ */ } code { font-family: "Menlo", "Courier New", "Courier", monospace; font-size: 85%; color: #666; background-color: rgba(0,0,0,0.08); padding: 2px 4px; border-radius: 2px; } pre { background-color: rgba(0,0,0,0.08); border-radius: 8px; padding: 0.4rem; margin-bottom: 1.6rem; } pre code { /* Counter the code mentions */ background-color: transparent; padding: 0; } sup, sub, a.footnote { /* Keep line-height from being affected by sub, cf https://gist.github.com/unruthless/413930 */ font-size: 75%; height: 0; line-height: 1; position: relative; } sup, a.footnote { vertical-align:super; } sub { vertical-align: sub; } dt { font-weight: 600; } dd { font-size: 1rem; line-height: 1.6rem; margin-bottom: 1.6rem; } hr { clear: none; height: 0.2rem; border: none; margin: 0 auto 1.4rem auto; /* 2.4rem auto 2.2rem auto; */ width: 100%; color: #ccc; background-color: #ccc; } ::selection { background-color: #f8dc77; } ::-moz-selection { background-color: #f8dc77; } a:focus { outline: 2px solid; outline-color: #165bd4; } /* ------------------------------------------------- */ /* Animations */ /* ------------------------------------------------- */ a:hover { -moz-transition: all 0.2s ease-in-out; -webkit-transition: all 0.2s ease-in-out; } h1, h2, h3, h4, h5, h6, p, blockquote { -moz-transition: all 0.2s ease; -webkit-transition: all 0.2s ease; } /* ================================================ */ /* 3. Media Queries */ /* ================================================ */ /* Base styles are for smartphones; elements are then tweaked as the viewport grows. */ /* ------------------------------------------------- */ /* iPad and desktop */ /* ------------------------------------------------- */ @media only screen and (min-width: 641px) { html { font-size: 15px; } body { /*margin: 4.8em 2.4rem 3.2rem 2.4rem !important;*/ } h1 { font-size: 3.57rem; /* 53.2px @15px */ line-height: 4rem; /* 60px @15px */ } h2 { font-size: 2.24rem; /* 33.6px @15px */ line-height: 2.8rem; /* 42px @15px */ } } /* ------------------------------------------------- */ /* Widescreens */ /* ------------------------------------------------- */ @media only screen and (min-width: 1441px) { html { font-size: 22px; } } /* ================================================ */ /* 4. Print Styles */ /* ================================================ */ /* Inconsistent and buggy across browsers */ @media print { * { background: transparent !important; color: #000 !important; /* Black text prints faster and browsers are inconsistent in color reproduction anyway: h5bp.com/s */ } @page { margin: 1cm; /* Added to any #wrapper margin*/ } html { font-size: 15px; } body { margin: 1rem !important; /* Security margins for browser without @page support */ } #wrapper { max-width: none; } h1, h2, h3, h4, h5, h6, p { orphans: 3; widows: 3; page-break-after: avoid; } ul, ol { list-style-position: inside !important; padding-right: 0 !important; margin-left: 0 !important; } ul ul, ul ol, ol ul, ol ol, ul p:not(:first-child), ol p:not(:first-child) { margin-left: 2rem !important; } a:link, a:visited { text-decoration: underline !important; font-weight: normal !important; } a[href]:after { content: " (" attr(href) ")"; } a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; /* Do not show javascript and internal links */ } a[href^="#"] { text-decoration: none !important; } th { background-color: rgba(0,0,0,0.2) !important; border-bottom: none !important; } tr { page-break-inside: avoid; } tbody tr:nth-child(even) { background-color: rgba(0,0,0,0.1) !important; } pre { border: 1px solid rgba(0,0,0,0.2); page-break-inside: avoid; } img { max-width: 100% !important; page-break-inside: avoid; } /* #generated-toc: added by Marked for its table of contents */ #wrapper #generated-toc ul, /* Table of contents printing in Marked */ #wrapper #generated-toc ol { list-style-type: decimal; } #wrapper #generated-toc ul li, #wrapper #generated-toc ol li { margin: 1rem 0; } } ================================================ FILE: doc/themes/radar.css ================================================ body { margin: 0px; font-family: 'PT Sans', Helvetica, 'Helvetica Neuve', Arial, Tahoma, sans-serif; font-size: 17px; color: #333; } h1, h2, h3, h4, h5, h6 { color:#222; margin:0 0 20px; } p, ul, ol, table, pre, dl { margin:0 0 20px; } h1, h2, h3 { line-height:1.1; } h1 { font-size:28px; } h2 { color:#393939; } h3, h4, h5, h6 { color:#494949; } a { color:#39c; font-weight:400; text-decoration:none; } a small { font-size:11px; color:#777; margin-top:-0.6em; display:block; } .wrapper { width:860px; margin:0 auto; } blockquote { border-left:1px solid #e5e5e5; margin:0; padding:0 0 0 20px; font-style:italic; } code, pre { color:#333; font-size:12px; } pre { padding:8px 15px; background: #f8f8f8; border-radius:5px; border:1px solid #e5e5e5; overflow-x: auto; } table { width:100%; border-collapse:collapse; } th, td { text-align:left; padding:5px 10px; border-bottom:1px solid #e5e5e5; } dt { color:#444; font-weight:700; } th { color:#444; } img { max-width:100%; } header { width:270px; float:left; position:fixed; } header ul { list-style:none; height:40px; padding:0; background: #eee; background: -moz-linear-gradient(top, #f8f8f8 0%, #dddddd 100%); background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#f8f8f8), color-stop(100%,#dddddd)); background: -webkit-linear-gradient(top, #f8f8f8 0%,#dddddd 100%); background: -o-linear-gradient(top, #f8f8f8 0%,#dddddd 100%); background: -ms-linear-gradient(top, #f8f8f8 0%,#dddddd 100%); background: linear-gradient(top, #f8f8f8 0%,#dddddd 100%); border-radius:5px; border:1px solid #d2d2d2; box-shadow:inset #fff 0 1px 0, inset rgba(0,0,0,0.03) 0 -1px 0; width:270px; } header li { width:89px; float:left; border-right:1px solid #d2d2d2; height:40px; } header ul a { line-height:1; font-size:11px; color:#999; display:block; text-align:center; padding-top:6px; height:40px; } strong { color:#222; font-weight:700; } header ul li + li { width:88px; border-left:1px solid #fff; } header ul li + li + li { border-right:none; width:89px; } header ul a strong { font-size:14px; display:block; color:#222; } section { width:500px; float:right; padding-bottom:50px; } small { font-size:11px; } hr { border:0; background:#e5e5e5; height:1px; margin:0 0 20px; } footer { width:270px; float:left; position:fixed; bottom:50px; } @media print, screen and (max-width: 960px) { div.wrapper { width:auto; margin:0; } header, section, footer { float:none; position:static; width:auto; } header { padding-right:320px; } section { border:1px solid #e5e5e5; border-width:1px 0; padding:20px 0; margin:0 0 20px; } header a small { display:inline; } header ul { position:absolute; right:50px; top:52px; } } @media print, screen and (max-width: 720px) { body { word-wrap:break-word; } header { padding:0; } header ul, header p.view { position:static; } pre, code { word-wrap:normal; } } @media print, screen and (max-width: 480px) { body { padding:15px; } header ul { display:none; } } @media print { body { padding:0.4in; font-size:12pt; color:#444; } } #wrapper { padding: 1em; } .ca-menu { list-style: none; padding: 0; margin: 20px auto; } #toc { top: 0; right: 0; bottom: 0; left: auto; width: 20%; background-color: #fff; padding: 20px; position: fixed; z-index: 1; display: none; height: 100%; } #toc::before { content: ""; position: absolute; top: 15%; bottom: 15%; left: -1px; width: 1px; background: -webkit-gradient(linear, 50% 0%, 50% 100%, color-stop(0%, rgba(227,224,216,0)), color-stop(20%, #e3e0d8), color-stop(80%, #e3e0d8), color-stop(100%, rgba(227,224,216,0))); background: -webkit-linear-gradient(top, rgba(227,224,216,0) 0%,#e3e0d8 20%,#e3e0d8 80%,rgba(227,224,216,0) 100%); background: -moz-linear-gradient(top, rgba(227,224,216,0) 0%,#e3e0d8 20%,#e3e0d8 80%,rgba(227,224,216,0) 100%); background: -o-linear-gradient(top, rgba(227,224,216,0) 0%,#e3e0d8 20%,#e3e0d8 80%,rgba(227,224,216,0) 100%); background: linear-gradient(top, rgba(227,224,216,0) 0%,#e3e0d8 20%,#e3e0d8 80%,rgba(227,224,216,0) 100%); } #toc-inner { display: table-cell; vertical-align: middle; } .nav-list { height: 50%; margin: auto 0; } div.clear { clear: both; } h1 { font-size: 2.5em; line-height: 1; } h2 { font-size: 2em; line-height: 1; } h3 { font-size: 1.5em; line-height: 1; } h4 { font-size: 1.2em; line-height: 1.25; } h5 { font-size: 1em; line-height: 1; font-weight: bold; } h6 { font-size: 1em; line-height: 1; font-weight: bold; } h1, h2, h3, h4, h5, h6 { font-weight: normal; margin-top: 1em; margin-bottom: 0.5em; } h1, h2 { margin-bottom: 0.5em; } .post p { max-width: 580px; } ul.list, ol.list { padding-left: 3.333em; max-width: 580px; } .post h2 { border-bottom: 1px solid #EDEDED; } h1:nth-child(1), h2:nth-child(1), h3:nth-child(1), h4:nth-child(1), h5:nth-child(1), h6:nth-child(1) { margin-top: 0; } @media (min-width: 43.75em) { #wrapper { width: 650px; padding: 20px 50px; } } @media (min-width: 62em) { #toc { display: table; } } ================================================ FILE: doc/themes/screen.css ================================================ html { font-size: 62.5%; } html, body { height: 100%; } body { font-family: Helvetica, Arial, sans-serif; font-size: 150%; line-height: 1.3; color: #f6e6cc; width: 700px; margin: auto; background: #27221a; position: relative; padding: 0 30px; } p,ul,ol,dl,table,pre { margin-bottom: 1em; } ul { margin-left: 20px; } a { text-decoration: none; cursor: pointer; color: #ba832c; font-weight: bold; } a:focus { outline: 1px dotted; } a:visited { } a:hover, a:focus { color: #d3a459; text-decoration: none; } a *, button * { cursor: pointer; } hr { display: none; } small { font-size: 90%; } input, select, button, textarea, option { font-family: Arial, "Lucida Grande", "Lucida Sans Unicode", Arial, Verdana, sans-serif; font-size: 100%; } button, label, select, option, input[type=submit] { cursor: pointer; } .group:after { content: "."; display: block; height: 0; clear: both; visibility: hidden; } .group {display: inline-block;} /* Hides from IE-mac \*/ * html .group {height: 1%;} .group {display: block;} /* End hide from IE-mac */ sup { font-size: 80%; line-height: 1; vertical-align: super; } button::-moz-focus-inner { border: 0; padding: 1px; } span.amp { font-family: Baskerville, "Goudy Old Style", "Palatino", "Book Antiqua", serif; font-weight: normal; font-style: italic; font-size: 1.2em; line-height: 0.8; } h1,h2,h3,h4,h5,h6 { line-height: 1.1; font-family: Baskerville, "Goudy Old Style", "Palatino", "Book Antiqua", serif; } h2 { font-size: 22pt; } h3 { font-size: 20pt; } h4 { font-size: 18pt; } h5 { font-size: 16pt; } h6 { font-size: 14pt; } ::selection { background: #745626; } ::-moz-selection { background: #745626; } h1 { font-size: 420%; margin: 0 0 0.1em; font-family: Baskerville, "Goudy Old Style", "Palatino", "Book Antiqua", serif; } h1 a, h1 a:hover { color: #d7af72; font-weight: normal; text-decoration: none; } pre { background: rgba(0,0,0,0.3); color: #fff; padding: 8px 10px; border-radius: 0.4em; -moz-border-radius: 0.4em; -webkit-border-radius: 0.4em; overflow-x: hidden; } pre code { font-size: 10pt; } .thumb { float:left; margin: 10px; } ================================================ FILE: doc/themes/solarized-dark.css ================================================ article, aside, details, figcaption, figure, footer, header, hgroup, nav, section, summary { display: block; } audio, canvas, video { display: inline-block; } audio:not([controls]) { display: none; height: 0; } [hidden] { display: none; } html { font-family: sans-serif; -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; } body { margin: 0; } a:focus { outline: thin dotted; } a:active, a:hover { outline: 0; } h1 { font-size: 2em; } abbr[title] { border-bottom: 1px dotted; } b, strong { font-weight: bold; } dfn { font-style: italic; } mark { background: #ff0; color: #000; } code, kbd, pre, samp { font-family: monospace, serif; font-size: 1em; } pre { white-space: pre-wrap; word-wrap: break-word; } q { quotes: "\201C" "\201D" "\2018" "\2019"; } small { font-size: 80%; } sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; } sup { top: -0.5em; } sub { bottom: -0.25em; } img { border: 0; } svg:not(:root) { overflow: hidden; } figure { margin: 0; } fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; } legend { border: 0; padding: 0; } button, input, select, textarea { font-family: inherit; font-size: 100%; margin: 0; } button, input { line-height: normal; } button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; cursor: pointer; } button[disabled], input[disabled] { cursor: default; } input[type="checkbox"], input[type="radio"] { box-sizing: border-box; padding: 0; } input[type="search"] { -webkit-appearance: textfield; -moz-box-sizing: content-box; -webkit-box-sizing: content-box; box-sizing: content-box; } input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; } button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; } textarea { overflow: auto; vertical-align: top; } table { border-collapse: collapse; border-spacing: 0; } html { font-family: 'PT Sans', sans-serif; } pre, code { font-family: 'Inconsolata', sans-serif; } h1, h2, h3, h4, h5, h6 { font-family: 'PT Sans Narrow', sans-serif; font-weight: 700; } html { background-color: #002b36; color: #839496; margin: 1em; } code { /*background-color: #073642;*/ padding: 2px; } a { color: #b58900; } a:visited { color: #cb4b16; } a:hover { color: #cb4b16; } h1 { color: #d33682; } h2, h3, h4, h5, h6 { color: #859900; } pre { /*background-color: #002b36;*/ color: #839496; border: 1pt solid #586e75; padding: 1em; box-shadow: 5pt 5pt 8pt #073642; } pre code { /*background-color: #002b36;*/ } h1 { font-size: 2.8em; } h2 { font-size: 2.4em; } h3 { font-size: 1.8em; } h4 { font-size: 1.4em; } h5 { font-size: 1.3em; } h6 { font-size: 1.15em; } .tag { /*background-color: #073642;*/ color: #d33682; padding: 0 0.2em; } .todo, .next, .done { color: #002b36; background-color: #dc322f; padding: 0 0.2em; } .tag { -webkit-border-radius: 0.35em; -moz-border-radius: 0.35em; border-radius: 0.35em; } .TODO { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; background-color: #2aa198; } .NEXT { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; background-color: #268bd2; } .ACTIVE { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; background-color: #268bd2; } .DONE { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; background-color: #859900; } .WAITING { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; foreground-color: #cb4b16; } .HOLD { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; foreground-color: #d33682; } .NOTE { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; foreground-color: #d33682; } .CANCELLED { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; foreground-color: #859900; } ================================================ FILE: doc/themes/solarized-light.css ================================================ article, aside, details, figcaption, figure, footer, header, hgroup, nav, section, summary { display: block; } audio, canvas, video { display: inline-block; } audio:not([controls]) { display: none; height: 0; } [hidden] { display: none; } html { font-family: sans-serif; -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; } body { margin: 0; } a:focus { outline: thin dotted; } a:active, a:hover { outline: 0; } h1 { font-size: 2em; } abbr[title] { border-bottom: 1px dotted; } b, strong { font-weight: bold; } dfn { font-style: italic; } mark { background: #ff0; color: #000; } code, kbd, pre, samp { font-family: monospace, serif; font-size: 1em; } pre { white-space: pre-wrap; word-wrap: break-word; } q { quotes: "\201C" "\201D" "\2018" "\2019"; } small { font-size: 80%; } sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; } sup { top: -0.5em; } sub { bottom: -0.25em; } img { border: 0; } svg:not(:root) { overflow: hidden; } figure { margin: 0; } fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; } legend { border: 0; padding: 0; } button, input, select, textarea { font-family: inherit; font-size: 100%; margin: 0; } button, input { line-height: normal; } button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; cursor: pointer; } button[disabled], input[disabled] { cursor: default; } input[type="checkbox"], input[type="radio"] { box-sizing: border-box; padding: 0; } input[type="search"] { -webkit-appearance: textfield; -moz-box-sizing: content-box; -webkit-box-sizing: content-box; box-sizing: content-box; } input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; } button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; } textarea { overflow: auto; vertical-align: top; } table { border-collapse: collapse; border-spacing: 0; } html { font-family: 'PT Sans', sans-serif; } pre, code { font-family: 'Inconsolata', sans-serif; } h1, h2, h3, h4, h5, h6 { font-family: 'PT Sans Narrow', sans-serif; font-weight: 700; } html { background-color: #fdf6e3; color: #657b83; margin: 1em; } code { background-color: #eee8d5; padding: 2px; } a { color: #b58900; } a:visited { color: #cb4b16; } a:hover { color: #cb4b16; } h1 { color: #d33682; } h2, h3, h4, h5, h6 { color: #859900; } pre { background-color: #fdf6e3; color: #657b83; border: 1pt solid #93a1a1; padding: 1em; box-shadow: 5pt 5pt 8pt #eee8d5; } pre code { background-color: #fdf6e3; } h1 { font-size: 2.8em; } h2 { font-size: 2.4em; } h3 { font-size: 1.8em; } h4 { font-size: 1.4em; } h5 { font-size: 1.3em; } h6 { font-size: 1.15em; } .tag { background-color: #eee8d5; color: #d33682; padding: 0 0.2em; } .todo, .next, .done { color: #fdf6e3; background-color: #dc322f; padding: 0 0.2em; } .tag { -webkit-border-radius: 0.35em; -moz-border-radius: 0.35em; border-radius: 0.35em; } .TODO { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; background-color: #2aa198; } .NEXT { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; background-color: #268bd2; } .ACTIVE { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; background-color: #268bd2; } .DONE { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; background-color: #859900; } .WAITING { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; foreground-color: #cb4b16; } .HOLD { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; foreground-color: #d33682; } .NOTE { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; foreground-color: #d33682; } .CANCELLED { -webkit-border-radius: 0.2em; -moz-border-radius: 0.2em; border-radius: 0.2em; foreground-color: #859900; } ================================================ FILE: doc/themes/torpedo.css ================================================ /* Title: Torpedo */ /* Author: Jocelyn Richard http://jocelynrichard.com/ */ /* Description: A muted color palette for long-form writing or reading, suited for technical documentation. Works best with Cinta: http://www.myfonts.com/fonts/tipo-pepel/cinta/ */ /* ================================================ */ /* 1. Reset */ /* 2. Skeleton */ /* 3. Media Queries */ /* 4. Print Styles */ /* 5. Torpedo Overrides */ /* ================================================ */ /* ================================================ */ /* 1. Reset */ /* ================================================ */ html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary, time, mark, audio, video {margin: 0; padding: 0; border: 0;} /* Edited from http://www.cssreset.com/scripts/eric-meyer-reset-css/ */ article, aside, details, figcaption, figure, footer, header, hgroup, nav, section, summary {display: block;} /* Semantic tags definition for IE 6/7/8/9 and Firefox 3 */ html {-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%;} /* Prevents iOS text size adjust after orientation change, without disabling user zoom */ /* ================================================ */ /* 2. Skeleton */ /* ================================================ */ /* ------------------------------------------------- */ /* General */ /* ------------------------------------------------- */ html { font-size: 14px; } body { font-family: 'Open Sans', sans-serif; margin: 1.71rem 1.71rem 3rem 1.71rem ; /* Get margins even if the Markdown rendering app doesn't include any */ background-color: white; color: #222; } #wrapper { /* #wrapper: ID added by Marked */ max-width: 42rem; margin: 0 auto; margin-left: auto !important; /* Countering toc.css added by Marked */ padding: 1.71rem 0 !important; /* Countering toc.css added by Marked */ } /* ------------------------------------------------- */ /* Typography */ /* ------------------------------------------------- */ h1, h2, h3, h4, h5, h6 { margin-bottom: 1.6rem; } h1, h2 { margin-top: 3.2rem; } h1 { font-size: 2.82rem; /* 42.3px @15px */ line-height: 3.2rem; /* 48px @15px */ } h2 { font-size: 1.99rem; /* 29.9px @15px */ line-height: 2.4rem; /* 36px @15px */ } h3 { font-size: 1.41rem; /* 21.2px @15px */ line-height: 2rem; /* 30px @15px */ } h4 { font-size: 1rem; /* 15px @15px */ line-height: 1.6rem; /* 24px @15px */ } h5, h6 { font-size: 0.8rem; line-height: 1.2rem; text-transform: uppercase; } h6 { margin-left: 1.6rem; } p, ol, ul, blockquote { font-size: 1rem; line-height: 1.6rem; margin-bottom: 1.6rem; } ul ul, ul ol, ol ul, ol ol { margin-left: 1.6rem; margin-top: 1.6rem; } #generated-toc ul ul, /* #generated-toc: added by Marked for its table of contents */ #generated-toc ul ol, #generated-toc ol ul, #generated-toc ol ol { margin-top: 0; margin-bottom: 0; padding-top: 0; padding-bottom: 0; } blockquote { margin: 0 0 1.6rem 2.4rem; padding-left: 0.8rem; /* Voire */ border-left: 4px solid rgba(0,0,0,0.08); font-style: normal; } blockquote ul { margin-left: 0.8rem; /* Pour ne pas que les hanging bullets mordent sur le blockquote */ } ol li blockquote, /* So that blockquote work in lists */ ul li blockquote { margin-left: 0; } a:link { text-decoration: none; color: #165bd4; border-bottom: 1px solid #ccc; } a:visited { color: #7697cf; border-bottom: 1px solid #ccc; } a:hover { border-color: #165bd4; } a:active { background-color: #e6e6e6; } /* ------------------------------------------------- */ /* Tables */ /* ------------------------------------------------- */ table { font-size: 0.85rem; margin: 0 0 1.6rem 0; border-collapse: collapse; border: 1px solid #ccc; } th, td { padding: 0.5rem 0.75rem; max-width: 20rem; /* Avoid dropping lines for nothing without having ridiculously wide tables */ } th { border-bottom: 2px solid #222; } tr { border-bottom: 1px solid #ccc; } tbody tr:nth-child(odd) { background-color: #f9f9f9; } table code { font-size: 85%; } /* ------------------------------------------------- */ /* Misc */ /* ------------------------------------------------- */ img { max-width: 100% } caption, figcaption { font-size: 0.85rem; line-height: 1.6rem; margin: 0 1.6rem; text-align: left; } figcaption { margin-bottom: 1.6rem; } h1, /* White-space mentions in order to force wrapping */ h2, a:link, pre { white-space: pre; /* CSS 2.0 */ white-space: pre-wrap; /* CSS 2.1 */ white-space: pre-line; /* CSS 3.0 */ white-space: -pre-wrap; /* Opera 4-6 */ white-space: -o-pre-wrap; /* Opera 7 */ white-space: -moz-pre-wrap; /* Mozilla */ white-space: -hp-pre-wrap; /* HP Printers */ word-wrap: break-word; /* IE 5+ */ } code { font-family: "Menlo", "Courier New", "Courier", monospace; font-size: 85%; color: #666; background-color: rgba(0,0,0,0.08); padding: 2px 4px; border-radius: 2px; } pre { background-color: rgba(0,0,0,0.08); border-radius: 8px; padding: 0.4rem; margin-bottom: 1.6rem; } pre code { /* Counter the code mentions */ background-color: transparent; padding: 0; } sup, sub, a.footnote { /* Keep line-height from being affected by sub, cf https://gist.github.com/unruthless/413930 */ font-size: 75%; height: 0; line-height: 1; position: relative; } sup, a.footnote { vertical-align:super; } sub { vertical-align: sub; } dt { font-weight: 600; } dd { font-size: 1rem; line-height: 1.6rem; margin-bottom: 1.6rem; } hr { clear: none; height: 0.2rem; border: none; margin: 0 auto 1.4rem auto; /* 2.4rem auto 2.2rem auto; */ width: 100%; color: #ccc; background-color: #ccc; } ::selection { background-color: #f8dc77; } ::-moz-selection { background-color: #f8dc77; } a:focus { outline: 2px solid; outline-color: #165bd4; } /* ------------------------------------------------- */ /* Animations */ /* ------------------------------------------------- */ a:hover { -moz-transition: all 0.2s ease-in-out; -webkit-transition: all 0.2s ease-in-out; } h1, h2, h3, h4, h5, h6, p, blockquote { -moz-transition: all 0.2s ease; -webkit-transition: all 0.2s ease; } /* ================================================ */ /* 3. Media Queries */ /* ================================================ */ /* Base styles are for smartphones; elements are then tweaked as the viewport grows. */ /* ------------------------------------------------- */ /* iPad and desktop */ /* ------------------------------------------------- */ @media only screen and (min-width: 641px) { html { font-size: 15px; } body { margin: 2.4rem 2.4rem 3.2rem 2.4rem; } h1 { font-size: 3.57rem; /* 53.2px @15px */ line-height: 4rem; /* 60px @15px */ } h2 { font-size: 2.24rem; /* 33.6px @15px */ line-height: 2.8rem; /* 42px @15px */ } } /* ------------------------------------------------- */ /* Widescreens */ /* ------------------------------------------------- */ @media only screen and (min-width: 1441px) { html { font-size: 22px; } } /* ================================================ */ /* 4. Print Styles */ /* ================================================ */ /* Inconsistent and buggy across browsers */ @media print { * { background: transparent !important; color: #000 !important; /* Black text prints faster and browsers are inconsistent in color reproduction anyway: h5bp.com/s */ } @page { margin: 1cm; /* Added to any #wrapper margin*/ } html { font-size: 15px; } body { margin: 1rem !important; /* Security margins for browser without @page support */ } #wrapper { max-width: none; } h1, h2, h3, h4, h5, h6, p { orphans: 3; widows: 3; page-break-after: avoid; } ul, ol { list-style-position: inside !important; padding-right: 0 !important; margin-left: 0 !important; } ul ul, ul ol, ol ul, ol ol, ul p:not(:first-child), ol p:not(:first-child) { margin-left: 2rem !important; } a:link, a:visited { text-decoration: underline !important; font-weight: normal !important; } a[href]:after { content: " (" attr(href) ")"; } a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; /* Do not show javascript and internal links */ } a[href^="#"] { text-decoration: none !important; } th { background-color: rgba(0,0,0,0.2) !important; border-bottom: none !important; } tr { page-break-inside: avoid; } tbody tr:nth-child(even) { background-color: rgba(0,0,0,0.1) !important; } pre { border: 1px solid rgba(0,0,0,0.2); page-break-inside: avoid; } img { max-width: 100% !important; page-break-inside: avoid; } /* #generated-toc: added by Marked for its table of contents */ #wrapper #generated-toc ul, /* Table of contents printing in Marked */ #wrapper #generated-toc ol { list-style-type: decimal; } #wrapper #generated-toc ul li, #wrapper #generated-toc ol li { margin: 1rem 0; } } /* ================================================ */ /* 5. Torpedo Overrides */ /* ================================================ */ /* ------------------------------------------------- */ /* General */ /* ------------------------------------------------- */ html { font-size: 16px; } body { font-family: 'Cinta', 'Source Sans Pro', Avenir, sans-serif; background-color: #F9F9F9; color: #636463; } #wrapper { max-width: 40rem; } /* ------------------------------------------------- */ /* Typography */ /* ------------------------------------------------- */ h1, h2 { color: #febf60; } h3 { color: #b46864; } h4, h5, h6 { font-size: 1rem; color: #b46864; text-transform: none; } h5 { margin-left: 1.6rem; } h6 { margin-left: 3.2rem; } p, ol, ul, dd, figcaption { font-weight: 300; } blockquote { border-color: #efefef; } a:link, a:visited, a:hover, a:visited { color: #636463; } a:link { font-weight: 600; text-decoration: none; border-bottom: none; background-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAMEAAAAJCAYAAACL+UhFAAAEJGlDQ1BJQ0MgUHJvZmlsZQAAOBGFVd9v21QUPolvUqQWPyBYR4eKxa9VU1u5GxqtxgZJk6XtShal6dgqJOQ6N4mpGwfb6baqT3uBNwb8AUDZAw9IPCENBmJ72fbAtElThyqqSUh76MQPISbtBVXhu3ZiJ1PEXPX6yznfOec7517bRD1fabWaGVWIlquunc8klZOnFpSeTYrSs9RLA9Sr6U4tkcvNEi7BFffO6+EdigjL7ZHu/k72I796i9zRiSJPwG4VHX0Z+AxRzNRrtksUvwf7+Gm3BtzzHPDTNgQCqwKXfZwSeNHHJz1OIT8JjtAq6xWtCLwGPLzYZi+3YV8DGMiT4VVuG7oiZpGzrZJhcs/hL49xtzH/Dy6bdfTsXYNY+5yluWO4D4neK/ZUvok/17X0HPBLsF+vuUlhfwX4j/rSfAJ4H1H0qZJ9dN7nR19frRTeBt4Fe9FwpwtN+2p1MXscGLHR9SXrmMgjONd1ZxKzpBeA71b4tNhj6JGoyFNp4GHgwUp9qplfmnFW5oTdy7NamcwCI49kv6fN5IAHgD+0rbyoBc3SOjczohbyS1drbq6pQdqumllRC/0ymTtej8gpbbuVwpQfyw66dqEZyxZKxtHpJn+tZnpnEdrYBbueF9qQn93S7HQGGHnYP7w6L+YGHNtd1FJitqPAR+hERCNOFi1i1alKO6RQnjKUxL1GNjwlMsiEhcPLYTEiT9ISbN15OY/jx4SMshe9LaJRpTvHr3C/ybFYP1PZAfwfYrPsMBtnE6SwN9ib7AhLwTrBDgUKcm06FSrTfSj187xPdVQWOk5Q8vxAfSiIUc7Z7xr6zY/+hpqwSyv0I0/QMTRb7RMgBxNodTfSPqdraz/sDjzKBrv4zu2+a2t0/HHzjd2Lbcc2sG7GtsL42K+xLfxtUgI7YHqKlqHK8HbCCXgjHT1cAdMlDetv4FnQ2lLasaOl6vmB0CMmwT/IPszSueHQqv6i/qluqF+oF9TfO2qEGTumJH0qfSv9KH0nfS/9TIp0Wboi/SRdlb6RLgU5u++9nyXYe69fYRPdil1o1WufNSdTTsp75BfllPy8/LI8G7AUuV8ek6fkvfDsCfbNDP0dvRh0CrNqTbV7LfEEGDQPJQadBtfGVMWEq3QWWdufk6ZSNsjG2PQjp3ZcnOWWing6noonSInvi0/Ex+IzAreevPhe+CawpgP1/pMTMDo64G0sTCXIM+KdOnFWRfQKdJvQzV1+Bt8OokmrdtY2yhVX2a+qrykJfMq4Ml3VR4cVzTQVz+UoNne4vcKLoyS+gyKO6EHe+75Fdt0Mbe5bRIf/wjvrVmhbqBN97RD1vxrahvBOfOYzoosH9bq94uejSOQGkVM6sN/7HelL4t10t9F4gPdVzydEOx83Gv+uNxo7XyL/FtFl8z9ZAHF4bBsrEwAAAE9JREFUWAnt0wENACEQBLHn/SEGK1jCGAk2pufgmp2x9pmfIxAW+MO/e53AExCBIeQFRJCfAAAR2EBeQAT5CQAQgQ3kBUSQnwAAEdhAXuACbF4CJXG10MIAAAAASUVORK5CYII=); background-repeat: repeat-x; background-position: 0 0.7rem; } a:visited { /* Doesn't work? */ background-position: 0 1rem; } a:hover { font-weight: 600; text-decoration: none; background-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAMEAAAAJCAYAAACL+UhFAAAEJGlDQ1BJQ0MgUHJvZmlsZQAAOBGFVd9v21QUPolvUqQWPyBYR4eKxa9VU1u5GxqtxgZJk6XtShal6dgqJOQ6N4mpGwfb6baqT3uBNwb8AUDZAw9IPCENBmJ72fbAtElThyqqSUh76MQPISbtBVXhu3ZiJ1PEXPX6yznfOec7517bRD1fabWaGVWIlquunc8klZOnFpSeTYrSs9RLA9Sr6U4tkcvNEi7BFffO6+EdigjL7ZHu/k72I796i9zRiSJPwG4VHX0Z+AxRzNRrtksUvwf7+Gm3BtzzHPDTNgQCqwKXfZwSeNHHJz1OIT8JjtAq6xWtCLwGPLzYZi+3YV8DGMiT4VVuG7oiZpGzrZJhcs/hL49xtzH/Dy6bdfTsXYNY+5yluWO4D4neK/ZUvok/17X0HPBLsF+vuUlhfwX4j/rSfAJ4H1H0qZJ9dN7nR19frRTeBt4Fe9FwpwtN+2p1MXscGLHR9SXrmMgjONd1ZxKzpBeA71b4tNhj6JGoyFNp4GHgwUp9qplfmnFW5oTdy7NamcwCI49kv6fN5IAHgD+0rbyoBc3SOjczohbyS1drbq6pQdqumllRC/0ymTtej8gpbbuVwpQfyw66dqEZyxZKxtHpJn+tZnpnEdrYBbueF9qQn93S7HQGGHnYP7w6L+YGHNtd1FJitqPAR+hERCNOFi1i1alKO6RQnjKUxL1GNjwlMsiEhcPLYTEiT9ISbN15OY/jx4SMshe9LaJRpTvHr3C/ybFYP1PZAfwfYrPsMBtnE6SwN9ib7AhLwTrBDgUKcm06FSrTfSj187xPdVQWOk5Q8vxAfSiIUc7Z7xr6zY/+hpqwSyv0I0/QMTRb7RMgBxNodTfSPqdraz/sDjzKBrv4zu2+a2t0/HHzjd2Lbcc2sG7GtsL42K+xLfxtUgI7YHqKlqHK8HbCCXgjHT1cAdMlDetv4FnQ2lLasaOl6vmB0CMmwT/IPszSueHQqv6i/qluqF+oF9TfO2qEGTumJH0qfSv9KH0nfS/9TIp0Wboi/SRdlb6RLgU5u++9nyXYe69fYRPdil1o1WufNSdTTsp75BfllPy8/LI8G7AUuV8ek6fkvfDsCfbNDP0dvRh0CrNqTbV7LfEEGDQPJQadBtfGVMWEq3QWWdufk6ZSNsjG2PQjp3ZcnOWWing6noonSInvi0/Ex+IzAreevPhe+CawpgP1/pMTMDo64G0sTCXIM+KdOnFWRfQKdJvQzV1+Bt8OokmrdtY2yhVX2a+qrykJfMq4Ml3VR4cVzTQVz+UoNne4vcKLoyS+gyKO6EHe+75Fdt0Mbe5bRIf/wjvrVmhbqBN97RD1vxrahvBOfOYzoosH9bq94uejSOQGkVM6sN/7HelL4t10t9F4gPdVzydEOx83Gv+uNxo7XyL/FtFl8z9ZAHF4bBsrEwAAAE9JREFUWAnt0wENACEQBLHn/SEGK1jCGAk2pufgmp2x9pmfIxAW+MO/e53AExCBIeQFRJCfAAAR2EBeQAT5CQAQgQ3kBUSQnwAAEdhAXuACbF4CJXG10MIAAAAASUVORK5CYII=); background-repeat: repeat; background-position-y: 0 0; } /* ------------------------------------------------- */ /* Tables */ /* ------------------------------------------------- */ table { font-weight: 300; } table, th, tr { border: none; } th { border-bottom: 1px solid #da9e1a; background-color: #ffd18c; } tbody tr:nth-child(even) { background-color: #efefef; } /* ------------------------------------------------- */ /* Misc */ /* ------------------------------------------------- */ code { color: #5597e7; padding: 0; /* PLus besoin car plus de risque de collision avec l'arrière-plan coloré */ background-color: transparent; } pre { background-color: transparent; } hr { clear: none; height: 1rem; width: 14rem; margin: 2.5rem auto; border: none; color: none; background-color: transparent; background-image: url(data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+Cjxzdmcgd2lkdGg9IjEyNnB4IiBoZWlnaHQ9IjE2cHgiIHZpZXdCb3g9IjAgMCAxMjYgMTYiIHZlcnNpb249IjEuMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayIgeG1sbnM6c2tldGNoPSJodHRwOi8vd3d3LmJvaGVtaWFuY29kaW5nLmNvbS9za2V0Y2gvbnMiPgogICAgPHRpdGxlPmhyPC90aXRsZT4KICAgIDxkZXNjcmlwdGlvbj5DcmVhdGVkIHdpdGggU2tldGNoIChodHRwOi8vd3d3LmJvaGVtaWFuY29kaW5nLmNvbS9za2V0Y2gpPC9kZXNjcmlwdGlvbj4KICAgIDxkZWZzPjwvZGVmcz4KICAgIDxnIGlkPSJQYWdlLTEiIHN0cm9rZT0ibm9uZSIgc3Ryb2tlLXdpZHRoPSIxIiBmaWxsPSJub25lIiBmaWxsLXJ1bGU9ImV2ZW5vZGQiIHNrZXRjaDp0eXBlPSJNU1BhZ2UiPgogICAgICAgIDxwYXRoIGQ9Ik0xMywzIEwzLDEzIiBpZD0iTGluZSIgc3Ryb2tlPSIjRDRERUVCIiBzdHJva2Utd2lkdGg9IjQiIHN0cm9rZS1saW5lY2FwPSJzcXVhcmUiIHNrZXRjaDp0eXBlPSJNU1NoYXBlR3JvdXAiPjwvcGF0aD4KICAgICAgICA8cGF0aCBkPSJNMTMsMyBMMjMuMDQ5ODc1MywxMy4wNDk4NzUzIiBpZD0iTGluZSIgc3Ryb2tlPSIjRDRERUVCIiBzdHJva2Utd2lkdGg9IjQiIHN0cm9rZS1saW5lY2FwPSJzcXVhcmUiIHNrZXRjaDp0eXBlPSJNU1NoYXBlR3JvdXAiPjwvcGF0aD4KICAgICAgICA8cGF0aCBkPSJNMzMsMyBMMjMsMTMiIGlkPSJMaW5lIiBzdHJva2U9IiNENERFRUIiIHN0cm9rZS13aWR0aD0iNCIgc3Ryb2tlLWxpbmVjYXA9InNxdWFyZSIgc2tldGNoOnR5cGU9Ik1TU2hhcGVHcm91cCI+PC9wYXRoPgogICAgICAgIDxwYXRoIGQ9Ik0zMywzIEw0My4wNDk4NzUzLDEzLjA0OTg3NTMiIGlkPSJMaW5lIiBzdHJva2U9IiNENERFRUIiIHN0cm9rZS13aWR0aD0iNCIgc3Ryb2tlLWxpbmVjYXA9InNxdWFyZSIgc2tldGNoOnR5cGU9Ik1TU2hhcGVHcm91cCI+PC9wYXRoPgogICAgICAgIDxwYXRoIGQ9Ik01MywzIEw0MywxMyIgaWQ9IkxpbmUiIHN0cm9rZT0iI0Q0REVFQiIgc3Ryb2tlLXdpZHRoPSI0IiBzdHJva2UtbGluZWNhcD0ic3F1YXJlIiBza2V0Y2g6dHlwZT0iTVNTaGFwZUdyb3VwIj48L3BhdGg+CiAgICAgICAgPHBhdGggZD0iTTUzLDMgTDYzLjA0OTg3NTMsMTMuMDQ5ODc1MyIgaWQ9IkxpbmUiIHN0cm9rZT0iI0Q0REVFQiIgc3Ryb2tlLXdpZHRoPSI0IiBzdHJva2UtbGluZWNhcD0ic3F1YXJlIiBza2V0Y2g6dHlwZT0iTVNTaGFwZUdyb3VwIj48L3BhdGg+CiAgICAgICAgPHBhdGggZD0iTTczLDMgTDYzLDEzIiBpZD0iTGluZSIgc3Ryb2tlPSIjRDRERUVCIiBzdHJva2Utd2lkdGg9IjQiIHN0cm9rZS1saW5lY2FwPSJzcXVhcmUiIHNrZXRjaDp0eXBlPSJNU1NoYXBlR3JvdXAiPjwvcGF0aD4KICAgICAgICA8cGF0aCBkPSJNNzMsMyBMODMuMDQ5ODc1MywxMy4wNDk4NzUzIiBpZD0iTGluZSIgc3Ryb2tlPSIjRDRERUVCIiBzdHJva2Utd2lkdGg9IjQiIHN0cm9rZS1saW5lY2FwPSJzcXVhcmUiIHNrZXRjaDp0eXBlPSJNU1NoYXBlR3JvdXAiPjwvcGF0aD4KICAgICAgICA8cGF0aCBkPSJNOTMsMyBMODMsMTMiIGlkPSJMaW5lIiBzdHJva2U9IiNENERFRUIiIHN0cm9rZS13aWR0aD0iNCIgc3Ryb2tlLWxpbmVjYXA9InNxdWFyZSIgc2tldGNoOnR5cGU9Ik1TU2hhcGVHcm91cCI+PC9wYXRoPgogICAgICAgIDxwYXRoIGQ9Ik05MywzIEwxMDMuMDQ5ODc1LDEzLjA0OTg3NTMiIGlkPSJMaW5lIiBzdHJva2U9IiNENERFRUIiIHN0cm9rZS13aWR0aD0iNCIgc3Ryb2tlLWxpbmVjYXA9InNxdWFyZSIgc2tldGNoOnR5cGU9Ik1TU2hhcGVHcm91cCI+PC9wYXRoPgogICAgICAgIDxwYXRoIGQ9Ik0xMTMsMyBMMTAzLDEzIiBpZD0iTGluZSIgc3Ryb2tlPSIjRDRERUVCIiBzdHJva2Utd2lkdGg9IjQiIHN0cm9rZS1saW5lY2FwPSJzcXVhcmUiIHNrZXRjaDp0eXBlPSJNU1NoYXBlR3JvdXAiPjwvcGF0aD4KICAgICAgICA8cGF0aCBkPSJNMTEzLDMgTDEyMy4wNDk4NzUsMTMuMDQ5ODc1MyIgaWQ9IkxpbmUiIHN0cm9rZT0iI0Q0REVFQiIgc3Ryb2tlLXdpZHRoPSI0IiBzdHJva2UtbGluZWNhcD0ic3F1YXJlIiBza2V0Y2g6dHlwZT0iTVNTaGFwZUdyb3VwIj48L3BhdGg+CiAgICA8L2c+Cjwvc3ZnPg==); background-repeat: no-repeat; background-position-x: 50%; } ::selection { background-color: #D4DEEB; color: #b46864; } ::-moz-selection { background-color: #D4DEEB; color: #b46864; } /* #generated-toc: added by Marked for its table of contents */ #generated-toc ul li a { font-weight: normal; } /* ------------------------------------------------- */ /* iPad and desktop */ /* ------------------------------------------------- */ @media only screen and (min-width: 641px) { html { font-size: 17px; } } /* ------------------------------------------------- */ /* Widescreens */ /* ------------------------------------------------- */ @media only screen and (min-width: 1441px) { html { font-size: 22px; } } ================================================ FILE: doc/themes/vostok.css ================================================ /* Title: Vostok */ /* Author: Jocelyn Richard http://jocelynrichard.com/ */ /* Description: Generous x-height and contrasted colors make for highly legible documents. Works best with the free PT fonts: http://www.paratype.com/public/ */ /* ================================================ */ /* 1. Reset */ /* 2. Skeleton */ /* 3. Media Queries */ /* 4. Print Styles */ /* 5. Vostok Overrides */ /* ================================================ */ /* ================================================ */ /* 1. Reset */ /* ================================================ */ html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary, time, mark, audio, video {margin: 0; padding: 0; border: 0;} /* Edited from http://www.cssreset.com/scripts/eric-meyer-reset-css/ */ article, aside, details, figcaption, figure, footer, header, hgroup, nav, section, summary {display: block;} /* Semantic tags definition for IE 6/7/8/9 and Firefox 3 */ html {-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%;} /* Prevents iOS text size adjust after orientation change, without disabling user zoom */ /* ================================================ */ /* 2. Skeleton */ /* ================================================ */ /* ------------------------------------------------- */ /* General */ /* ------------------------------------------------- */ html { font-size: 14px; } body { font-family: 'Open Sans', sans-serif; margin: 1.71rem 1.71rem 3rem 1.71rem ; /* Get margins even if the Markdown rendering app doesn't include any */ background-color: white; color: #222; } #wrapper { /* #wrapper: ID added by Marked */ max-width: 42rem; margin: 0 auto; margin-left: auto !important; /* Countering toc.css added by Marked */ padding: 1.71rem 0 !important; /* Countering toc.css added by Marked */ } /* ------------------------------------------------- */ /* Typography */ /* ------------------------------------------------- */ h1, h2, h3, h4, h5, h6 { margin-bottom: 1.6rem; } h1, h2 { margin-top: 3.2rem; } h1 { font-size: 2.82rem; /* 42.3px @15px */ line-height: 3.2rem; /* 48px @15px */ } h2 { font-size: 1.99rem; /* 29.9px @15px */ line-height: 2.4rem; /* 36px @15px */ } h3 { font-size: 1.41rem; /* 21.2px @15px */ line-height: 2rem; /* 30px @15px */ } h4 { font-size: 1rem; /* 15px @15px */ line-height: 1.6rem; /* 24px @15px */ } h5, h6 { font-size: 0.8rem; line-height: 1.2rem; text-transform: uppercase; } h6 { margin-left: 1.6rem; } p, ol, ul, blockquote { font-size: 1rem; line-height: 1.6rem; margin-bottom: 1.6rem; } ul ul, ul ol, ol ul, ol ol { margin-left: 1.6rem; margin-top: 1.6rem; } #generated-toc ul ul, /* #generated-toc: added by Marked for its table of contents */ #generated-toc ul ol, #generated-toc ol ul, #generated-toc ol ol { margin-top: 0; margin-bottom: 0; padding-top: 0; padding-bottom: 0; } blockquote { margin: 0 0 1.6rem 2.4rem; padding-left: 0.8rem; /* Voire */ border-left: 4px solid rgba(0,0,0,0.08); font-style: normal; } blockquote ul { margin-left: 0.8rem; /* Pour ne pas que les hanging bullets mordent sur le blockquote */ } ol li blockquote, /* So that blockquote work in lists */ ul li blockquote { margin-left: 0; } a:link { text-decoration: none; color: #165bd4; border-bottom: 1px solid #ccc; } a:visited { color: #7697cf; border-bottom: 1px solid #ccc; } a:hover { border-color: #165bd4; } a:active { background-color: #e6e6e6; } /* ------------------------------------------------- */ /* Tables */ /* ------------------------------------------------- */ table { font-size: 0.85rem; margin: 0 0 1.6rem 0; border-collapse: collapse; border: 1px solid #ccc; } th, td { padding: 0.5rem 0.75rem; max-width: 20rem; /* Avoid dropping lines for nothing without having ridiculously wide tables */ } th { border-bottom: 2px solid #222; } tr { border-bottom: 1px solid #ccc; } tbody tr:nth-child(odd) { background-color: #f9f9f9; } table code { font-size: 85%; } /* ------------------------------------------------- */ /* Misc */ /* ------------------------------------------------- */ img { max-width: 100% } caption, figcaption { font-size: 0.85rem; line-height: 1.6rem; margin: 0 1.6rem; text-align: left; } figcaption { margin-bottom: 1.6rem; } h1, /* White-space mentions in order to force wrapping */ h2, a:link, pre { white-space: pre; /* CSS 2.0 */ white-space: pre-wrap; /* CSS 2.1 */ white-space: pre-line; /* CSS 3.0 */ white-space: -pre-wrap; /* Opera 4-6 */ white-space: -o-pre-wrap; /* Opera 7 */ white-space: -moz-pre-wrap; /* Mozilla */ white-space: -hp-pre-wrap; /* HP Printers */ word-wrap: break-word; /* IE 5+ */ } code { font-family: "Menlo", "Courier New", "Courier", monospace; font-size: 85%; color: #666; background-color: rgba(0,0,0,0.08); padding: 2px 4px; border-radius: 2px; } pre { background-color: rgba(0,0,0,0.08); border-radius: 8px; padding: 0.4rem; margin-bottom: 1.6rem; } pre code { /* Counter the code mentions */ background-color: transparent; padding: 0; } sup, sub, a.footnote { /* Keep line-height from being affected by sub, cf https://gist.github.com/unruthless/413930 */ font-size: 75%; height: 0; line-height: 1; position: relative; } sup, a.footnote { vertical-align:super; } sub { vertical-align: sub; } dt { font-weight: 600; } dd { font-size: 1rem; line-height: 1.6rem; margin-bottom: 1.6rem; } hr { clear: none; height: 0.2rem; border: none; margin: 0 auto 1.4rem auto; /* 2.4rem auto 2.2rem auto; */ width: 100%; color: #ccc; background-color: #ccc; } ::selection { background-color: #f8dc77; } ::-moz-selection { background-color: #f8dc77; } a:focus { outline: 2px solid; outline-color: #165bd4; } /* ------------------------------------------------- */ /* Animations */ /* ------------------------------------------------- */ a:hover { -moz-transition: all 0.2s ease-in-out; -webkit-transition: all 0.2s ease-in-out; } h1, h2, h3, h4, h5, h6, p, blockquote { -moz-transition: all 0.2s ease; -webkit-transition: all 0.2s ease; } /* ================================================ */ /* 3. Media Queries */ /* ================================================ */ /* Base styles are for smartphones; elements are then tweaked as the viewport grows. */ /* ------------------------------------------------- */ /* iPad and desktop */ /* ------------------------------------------------- */ @media only screen and (min-width: 641px) { html { font-size: 15px; } body { margin: 2.4rem 2.4rem 3.2rem 2.4rem; } h1 { font-size: 3.57rem; /* 53.2px @15px */ line-height: 4rem; /* 60px @15px */ } h2 { font-size: 2.24rem; /* 33.6px @15px */ line-height: 2.8rem; /* 42px @15px */ } } /* ------------------------------------------------- */ /* Widescreens */ /* ------------------------------------------------- */ @media only screen and (min-width: 1441px) { html { font-size: 22px; } } /* ================================================ */ /* 4. Print Styles */ /* ================================================ */ /* Inconsistent and buggy across browsers */ @media print { * { background: transparent !important; color: #000 !important; /* Black text prints faster and browsers are inconsistent in color reproduction anyway: h5bp.com/s */ } @page { margin: 1cm; /* Added to any #wrapper margin*/ } html { font-size: 15px; } body { margin: 1rem !important; /* Security margins for browser without @page support */ } #wrapper { max-width: none; } h1, h2, h3, h4, h5, h6, p { orphans: 3; widows: 3; page-break-after: avoid; } ul, ol { list-style-position: inside !important; padding-right: 0 !important; margin-left: 0 !important; } ul ul, ul ol, ol ul, ol ol, ul p:not(:first-child), ol p:not(:first-child) { margin-left: 2rem !important; } a:link, a:visited { text-decoration: underline !important; font-weight: normal !important; } a[href]:after { content: " (" attr(href) ")"; } a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; /* Do not show javascript and internal links */ } a[href^="#"] { text-decoration: none !important; } th { background-color: rgba(0,0,0,0.2) !important; border-bottom: none !important; } tr { page-break-inside: avoid; } tbody tr:nth-child(even) { background-color: rgba(0,0,0,0.1) !important; } pre { border: 1px solid rgba(0,0,0,0.2); page-break-inside: avoid; } img { max-width: 100% !important; page-break-inside: avoid; } /* #generated-toc: added by Marked for its table of contents */ #wrapper #generated-toc ul, /* Table of contents printing in Marked */ #wrapper #generated-toc ol { list-style-type: decimal; } #wrapper #generated-toc ul li, #wrapper #generated-toc ol li { margin: 1rem 0; } } /* ================================================ */ /* 5. Vostok Overrides */ /* ================================================ */ /* ------------------------------------------------- */ /* General */ /* ------------------------------------------------- */ html { font-size: 15px; } body { font-family: "pt serif", Georgia, serif; color: rgba(0,0,0,0.7); text-shadow: 0 1px 0 white; background-color: #ececec; } #wrapper { max-width: 40rem; } /* ------------------------------------------------- */ /* Typography */ /* ------------------------------------------------- */ h1, h2, h3, h4, h5, h6 { font-family: "pt sans", "avenir next", sans-serif; font-weight: 700; color: rgba(0,0,0,1); } h2, h3 { font-family: "pt sans narrow", "avenir next condensed", sans-serif; } h5 { color: rgba(0,0,0,0.7); } h6 { color: rgba(0,0,0,0.7); } ul { list-style-type: none; } ul > li:before { content: "\2022"; float: left; margin-left: -1.2rem; padding-right: 0.6rem; /* Empirically chosen to align horizontally with the position of standard bullet points */ } ul li, ol li { margin: 0; } ul ul, ul ol, ol ul, ol ol, ul p:not(:first-child), ol p:not(:first-child) { margin-left: 1.6rem; } blockquote { border-left: 2px solid rgba(0,0,0,0.5); } a:link { text-decoration: none; border-bottom: none; font-weight: 700; color: rgba(25,107,240,1); } a:visited { color: #2c508a; } a:hover { color: #2DAB5F; } a:focus { outline: 0.125rem solid; } /* ------------------------------------------------- */ /* Tables */ /* ------------------------------------------------- */ thead { border: 1px solid #4C4C4C; /* In hex (= rgba(0,0,0,0.7)) otherwise the alpha gets the border of the tr below */ } th { background-color: #4C4C4C; /* = rgba(0,0,0,0.7) */ border-bottom: 1px solid #4C4C4C; /* = rgba(0,0,0,0.7) ; mentionned otherwise the stroke is of the tr below */ color: white; text-shadow: 0px -1px 0px black; } tbody tr:nth-child(even) { background-color: rgba(255,255,255,0.5); } tbody tr:nth-child(odd) { background-color: transparent; } /* ------------------------------------------------- */ /* Misc */ /* ------------------------------------------------- */ table, caption, figcaption { font-family: "pt sans", "avenir next", sans-serif; } code { border: 1px solid rgba(255,255,255,0.7); background-color: rgba(255,255,255,0.5); border-radius: 2px; color: #2DAB5F; text-shadow: none; } pre { border: 1px solid rgba(255,255,255,0.7); background-color: rgba(255,255,255,0.5); border-radius: 2px; } pre code { color: #81A181; border: none; } hr { clear: none; height: 2px; /* height: 0.125rem; */ border: none; margin: 1.5rem auto; width: 14rem; color: rgba(0,0,0,0.5); background-color: rgba(0,0,0,0.5); } ::selection { background-color: #fbfb48; } ::-moz-selection { background-color: #fbfb48; } /* #generated-toc: added by Marked for its table of contents */ #generated-toc { text-shadow: none; } #generated-toc ul { /* Compensate for the earlier custom bullet point */ margin: 0; list-style-type: none; } #generated-toc ul li { /* Compensate for the earlier custom bullet point */ margin: 0; } #generated-toc ul > li:before { /* Compensate for the earlier custom bullet point */ content: none; margin-left: 0; padding-right: 0; } #generated-toc ul li a { font-weight: normal; display: inline; } #generated-toc ul li ul li ul li a { text-transform: lowercase; } /* ------------------------------------------------- */ /* iPad and desktop */ /* ------------------------------------------------- */ @media only screen and (min-width: 641px) { html { font-size: 17px; } h1 { font-size: 2.81rem; } h2 { font-size: 1.78rem; line-height: 2.21rem; } ul, ol { margin-left: 0; } } ================================================ FILE: doc.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ // Package soar is a command-line tool for SQL optimizing and rewriting. package soar ================================================ FILE: env/doc.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ // Package env contain virtual database build, rehash, cleanup. package env ================================================ FILE: env/env.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package env import ( "fmt" "strings" "time" "github.com/XiaoMi/soar/ast" "github.com/XiaoMi/soar/common" "github.com/XiaoMi/soar/database" "github.com/dchest/uniuri" "vitess.io/vitess/go/vt/sqlparser" ) // VirtualEnv SQL优化评审 测试环境 // DB使用的信息从配置文件中获取 type VirtualEnv struct { *database.Connector // 保存 DB 测试环境映射关系,防止 vEnv 环境冲突。 DBRef map[string]string // db -> optimizer_xxx Hash2DB map[string]string // optimizer_xxx -> db // 保存 Table 创建关系,防止重复创建表 TableMap map[string]map[string]string // 错误 Error error } // NewVirtualEnv 初始化一个新的测试环境 func NewVirtualEnv(vEnv *database.Connector) *VirtualEnv { return &VirtualEnv{ Connector: vEnv, DBRef: make(map[string]string), Hash2DB: make(map[string]string), TableMap: make(map[string]map[string]string), } } // BuildEnv 测试环境初始化&连接线上环境检查 // @output *VirtualEnv 测试环境 // @output *database.Connector 线上环境连接句柄 func BuildEnv() (*VirtualEnv, *database.Connector) { connTest, err := database.NewConnector(common.Config.TestDSN) common.LogIfError(err, "") // 生成测试环境 vEnv := NewVirtualEnv(connTest) // 检查测试环境可用性,并记录数据库版本 vEnvVersion, err := vEnv.Version() common.Config.TestDSN.Version = vEnvVersion if err != nil { common.Log.Warn("BuildEnv TestDSN: %s:********@%s/%s not available , Error: %s", vEnv.User, vEnv.Addr, vEnv.Database, err.Error()) common.Config.TestDSN.Disable = true } // 连接线上环境 // 如果未配置线上环境线测试环境配置为线上环境 if common.Config.OnlineDSN.User == "" { common.Log.Warn("BuildEnv AllowOnlineAsTest: OnlineDSN not config, use TestDSN: %s:********@%s/%s as OnlineDSN", vEnv.User, vEnv.Addr, vEnv.Database) common.Config.OnlineDSN = common.Config.TestDSN } connOnline, err := database.NewConnector(common.Config.OnlineDSN) common.LogIfError(err, "") // 检查线上环境可用性版本 rEnvVersion, err := connOnline.Version() common.Config.OnlineDSN.Version = rEnvVersion if err != nil { common.Log.Warn("BuildEnv OnlineDSN: %s:********@%s/%s not available , Error: %s", connOnline.User, connOnline.Addr, connOnline.Database, err.Error()) common.Config.TestDSN.Disable = true } // 检查是否允许 Online 和 Test 一致,防止误操作 if common.FormatDSN(common.Config.OnlineDSN) == common.FormatDSN(common.Config.TestDSN) && !common.Config.AllowOnlineAsTest { common.Log.Warn("BuildEnv AllowOnlineAsTest: %s:********@%s/%s OnlineDSN can't config as TestDSN", vEnv.User, vEnv.Addr, vEnv.Database) common.Config.TestDSN.Disable = true common.Config.OnlineDSN.Disable = true } // 是否禁用版本检测,禁用后,不再对比测试环境和线上环境的版本大小 if !common.Config.DisableVersionCheck { // 判断测试环境与线上环境版本是否一致,要求测试环境版本不低于线上环境 if vEnvVersion < rEnvVersion { common.Log.Warning("TestDSN MySQL version older than OnlineDSN(%d), TestDSN(%d) will not be used", rEnvVersion, vEnvVersion) common.Config.TestDSN.Disable = true } } return vEnv, connOnline } // RealDB 从测试环境中获取通过 hash 后的 DB func (vEnv *VirtualEnv) RealDB(hash string) string { if _, ok := vEnv.Hash2DB[hash]; ok { return vEnv.Hash2DB[hash] } // hash may be real database name not hash if strings.HasPrefix(hash, "optimizer_") { common.Log.Warning("RealDB, Hash2DB missing hash map: %s", hash) } return hash } // DBHash 从测试环境中根据 DB 找到对应的 hash 值 func (vEnv *VirtualEnv) DBHash(db string) string { if _, ok := vEnv.DBRef[db]; ok { return vEnv.DBRef[db] } return db } // CleanUp 环境清理 func (vEnv *VirtualEnv) CleanUp() bool { if !common.Config.TestDSN.Disable && common.Config.DropTestTemporary { common.Log.Debug("CleanUp ...") for db := range vEnv.Hash2DB { _, err := vEnv.Query(fmt.Sprintf("drop database %s", db)) if err != nil { common.Log.Error("CleanUp failed Error: %s", err) return false } } // cleanup hash map vEnv.DBRef = make(map[string]string) vEnv.Hash2DB = make(map[string]string) vEnv.TableMap = make(map[string]map[string]string) common.Log.Debug("CleanUp, done") } return true } // CleanupTestDatabase 清除一小时前的环境 func (vEnv *VirtualEnv) CleanupTestDatabase() { common.Log.Debug("CleanupTestDatabase ...") dbs, err := vEnv.Query("show databases like 'optimizer%%'") if err != nil { common.Log.Error("CleanupTestDatabase failed Error:%s", err.Error()) return } // TODO: 1 hour should be config-able minHour := 1 for dbs.Rows.Next() { var testDatabase string err = dbs.Rows.Scan(&testDatabase) if err != nil { break } // test temporary database format `optimizer_YYMMDDHHmmss_randomString(16)` if len(testDatabase) != 39 { common.Log.Debug("CleanupTestDatabase by pass %s", testDatabase) continue } s := strings.Split(testDatabase, "_") pastTime, err := time.ParseInLocation("060102150405", s[1], time.Local) if err != nil { common.Log.Error("CleanupTestDatabase compute pastTime Error: %s", err.Error()) continue } subHour := time.Since(pastTime).Hours() if subHour > float64(minHour) { if _, err := vEnv.Query(fmt.Sprintf("drop database %s", testDatabase)); err != nil { common.Log.Error("CleanupTestDatabase failed Error: %s", err.Error()) continue } common.Log.Debug("CleanupTestDatabase drop database %s success", testDatabase) continue } common.Log.Debug("CleanupTestDatabase by pass database %s, %.2f less than %d hours", testDatabase, subHour, minHour) } err = dbs.Rows.Close() common.LogIfError(err, "") common.Log.Debug("CleanupTestDatabase done") } // ChangeDB use db change dsn Database func ChangeDB(env *database.Connector, sql string) { stmt, err := sqlparser.Parse(sql) if err != nil { return } switch stmt := stmt.(type) { case *sqlparser.Use: if stmt.DBName.String() != "" { env.Database = stmt.DBName.String() } } } func CurrentDB(sql, db string) string { stmt, err := sqlparser.Parse(sql) if err != nil { return common.Config.TestDSN.Schema } switch stmt := stmt.(type) { case *sqlparser.Use: if stmt.DBName.String() != "" { db = stmt.DBName.String() } } if db == "" { db = common.Config.TestDSN.Schema } return db } // BuildVirtualEnv rEnv 为 SQL 源环境,DB 使用的信息从接口获取 // 注意:如果是 USE, DDL 等语句,执行完第一条就会返回,后面的 SQL 不会执行 func (vEnv *VirtualEnv) BuildVirtualEnv(rEnv *database.Connector, SQLs ...string) bool { var stmt sqlparser.Statement var err error // 置空错误信息 vEnv.Error = nil // 检测是否已经创建初始数据库,如果未创建则创建一个名称 hash 过的映射数据库 err = vEnv.createDatabase(rEnv) common.LogIfWarn(err, "") // 测试环境检测 if common.Config.TestDSN.Disable { common.Log.Info("BuildVirtualEnv TestDSN not config") return true } // 判断 rEnv 中是否指定了 DB if rEnv.Database == "" { common.Log.Error("BuildVirtualEnv no database specified, TestDSN init failed") return false } // 库表提取 meta := make(map[string]*common.DB) for _, sql := range SQLs { common.Log.Debug("BuildVirtualEnv Database&TableName Mapping, SQL: %s", sql) stmt, err = sqlparser.Parse(sql) if err != nil { common.Log.Error("BuildVirtualEnv Error : %v", err) return false } // 语句类型判断 switch stmt := stmt.(type) { case *sqlparser.Use: // 如果是use语句,则更改基础环配置 if _, ok := meta[stmt.DBName.String()]; !ok { // 如果USE了一个线上环境不存在的数据库,将创建该数据库 meta[stmt.DBName.String()] = common.NewDB(stmt.DBName.String()) rEnv.Database = stmt.DBName.String() // use DB 后检查 DB是否已经创建,如果没有创建则创建DB err = vEnv.createDatabase(rEnv) common.LogIfWarn(err, "") } return true case *sqlparser.DDL: // 如果是DDL,则先获取DDL对应的表结构,然后直接在测试环境接执行SQL // 为不影响其他SQL操作,复制一个Connector对象,将数据库切换到对应的DB上直接执行 vEnv.Database = vEnv.DBRef[rEnv.Database] // 为了支持并发,需要将DB进行映射,但 db.table 这种形式无法保证 DB 的映射是正确的 // TODO:暂不支持 create db.tableName (id int) 形式的建表语句 if stmt.Table.Qualifier.String() != "" { common.Log.Error("BuildVirtualEnv DDL Not support db.tb format") return false } for _, tb := range stmt.FromTables { if tb.Qualifier.String() != "" { common.Log.Error("BuildVirtualEnv DDL Not support db.tb format") return false } } for _, tb := range stmt.ToTables { if tb.Qualifier.String() != "" { common.Log.Error("BuildVirtualEnv DDL Not support db.tb format") return false } } // 拉取表结构 table := stmt.Table.Name.String() if table != "" { err = vEnv.createTable(rEnv, table) // 这里如果报错可能有两种可能: // 1. SQL 是 Create 语句,线上环境并没有相关的库表结构 // 2. 在测试环境中执行 SQL 报错 // 如果是因为 Create 语句报错,后续会在测试环境中直接执行 create 语句,不会对程序有负面影响 // 如果是因为执行 SQL 报错,那么其他地方执行 SQL 的时候也一定会报错 // 所以这里不需要 `return false`,可以继续执行 if err != nil { common.Log.Warning("BuildVirtualEnv Error : %v", err) } } _, err = vEnv.Query(sql) if err != nil { switch stmt.Action { case "create", "alter": // 如果是创建或者修改语句,且报错信息为如重复建表、重复索引等信息,将错误反馈到上一次层输出建议 vEnv.Error = err default: common.Log.Error("BuildVirtualEnv DDL Execute Error : %v", err) } } return true } meta := ast.GetMeta(stmt, nil) // 由于 DB 环境可能是变的,所以需要每一次都单独的提取库表结构,整体随着 rEnv 的变动而发生变化 for db, table := range meta { if db == "" { db = rEnv.Database } rEnv.Database = db // 创建数据库环境 for _, tb := range table.Table { if tb.TableName == "" { continue } // 视图检查 common.Log.Debug("BuildVirtualEnv Checking view -- %s.%s", rEnv.Database, tb.TableName) tbStatus, err := rEnv.ShowTableStatus(tb.TableName) if err != nil { common.Log.Error("BuildVirtualEnv ShowTableStatus Error : %v", err) return false } // 如果是视图,解析语句 if len(tbStatus.Rows) > 0 && string(tbStatus.Rows[0].Comment) == "VIEW" { var viewDDL string viewDDL, err = rEnv.ShowCreateTable(tb.TableName) if err != nil { common.Log.Error("BuildVirtualEnv create view failed: %v", err) return false } startIdx := strings.Index(viewDDL, "AS") if startIdx < 0 || viewDDL == "" { common.Log.Error("BuildVirtualEnv '%s' got '%s', Index: %d", tb.TableName, viewDDL, startIdx) return false } viewDDL = viewDDL[startIdx+2:] if !vEnv.BuildVirtualEnv(rEnv, viewDDL) { return false } } err = vEnv.createTable(rEnv, tb.TableName) if err != nil { common.Log.Error("BuildVirtualEnv %s.%s Error : %v", rEnv.Database, tb.TableName, err) return false } } } } return true } func (vEnv *VirtualEnv) createDatabase(rEnv *database.Connector) error { // 生成映射关系 if _, ok := vEnv.DBRef[rEnv.Database]; ok { common.Log.Debug("createDatabase, Database `%s` has created, mapping from `%s`", vEnv.DBRef[rEnv.Database], rEnv.Database) return nil } // optimizer_YYMMDDHHmmss_xxxx dbHash := fmt.Sprintf("optimizer_%s_%s", // Total 39 bytes time.Now().Format("060102150405"), // 12 Bytes 180102030405 strings.ToLower(uniuri.New())) // 16 Bytes random string common.Log.Debug("createDatabase, mapping `%s` :`%s`-->`%s`", rEnv.Database, rEnv.Database, dbHash) ddl, err := rEnv.ShowCreateDatabase(rEnv.Database) if err != nil { common.Log.Warning("createDatabase, rEnv.ShowCreateDatabase Error : %v", err) ddl = fmt.Sprintf("create database `%s` character set %s", rEnv.Database, rEnv.Charset) } ddl = strings.Replace(ddl, rEnv.Database, dbHash, -1) if ddl == "" { return fmt.Errorf("dbName: '%s' get create info error", rEnv.Database) } res, err := vEnv.Query(ddl) if err != nil { common.Log.Warning("createDatabase, Error : %v", err) return err } err = res.Rows.Close() common.LogIfWarn(err, "") // 创建成功,添加映射记录 vEnv.DBRef[rEnv.Database] = dbHash vEnv.Hash2DB[dbHash] = rEnv.Database return nil } /* @input: database.Connector 为一个线上环境数据库连接句柄的复制,因为在处理SQL时需要对上下文进行关联处理, 所以存在修改DB连接参数(主要是数据库名称变更)的可能性,为了不影响整体上下文的环境,所以需要一个镜像句柄来做当前环境的操作。 dbName, tbName: 需要在环境中操作的库表名称, @output: return 执行过程中的错误 NOTE: 该函数会将线上环境中使用到的库表结构复制到测试环境中,为后续操作提供基础环境。 传入的库表名称均来自于对AST的解析,库表名称的获取遵循以下原则: 如果未在SQL中指定数据库名称,则数据库一定是配置文件(或命令行参数传入DSN)中指定的数据库 如果一个SQL中存在多个数据库,则只能有一个数据库是没有在SQL中被显示指定的(即DSN中指定的数据库) TODO: 在一些可能的情况下,由于数据库配置的不一致(如SQL_MODE不同)导致remote环境的库表无法正确的在测试环境进行同步, soar 能够做出判断并进行 session 级别的修改,但是这一阶段可用性保证应该是由用户提供两个完全相同(或测试环境兼容线上环境) 的数据库环境来实现的。 */ func (vEnv *VirtualEnv) createTable(rEnv *database.Connector, tbName string) error { // 判断数据库是否已经创建 if vEnv.DBRef[rEnv.Database] == "" { // 若没创建,则创建数据库 err := vEnv.createDatabase(rEnv) if err != nil { return err } } if vEnv.TableMap[rEnv.Database] == nil { vEnv.TableMap[rEnv.Database] = make(map[string]string) } if strings.ToLower(tbName) == "dual" { common.Log.Debug("createTable, %s no need create", tbName) return nil } if vEnv.TableMap[rEnv.Database][tbName] != "" { common.Log.Debug("createTable, `%s`.`%s` has created, mapping from `%s`.`%s`", vEnv.DBRef[rEnv.Database], tbName, rEnv.Database, tbName) return nil } common.Log.Debug("createTable, Database: %s, TableName: %s", vEnv.DBRef[rEnv.Database], tbName) // TODO:查看是否有外键关联(done),对外键的支持 (未解决循环依赖的问题) // 记录Table创建信息 vEnv.TableMap[rEnv.Database][tbName] = tbName // 生成建表语句 common.Log.Debug("createTable DSN(%s/%s): generate ddl", rEnv.Addr, rEnv.Database) ddl, err := rEnv.ShowCreateTable(tbName) if err != nil { // 有可能是用户新建表,因此线上环境查不到 common.Log.Error("createTable, %s DDL Error : %v", tbName, err) return err } // 改变数据环境 vEnv.Database = vEnv.DBRef[rEnv.Database] res, err := vEnv.Query(ddl) if err != nil { // 有可能是用户新建表,因此线上环境查不到 common.Log.Error("createTable: %s Error : %v", tbName, err) return err } err = res.Rows.Close() common.LogIfWarn(err, "") // 泵取数据 if common.Config.Sampling { common.Log.Debug("createTable, Start Sampling data from %s.%s to %s.%s ...", rEnv.Database, tbName, vEnv.DBRef[rEnv.Database], tbName) err = vEnv.SamplingData(rEnv, tbName) } return err } // GenTableColumns 为 Rewrite 提供的结构体初始化 func (vEnv *VirtualEnv) GenTableColumns(meta common.Meta) common.TableColumns { tableColumns := make(common.TableColumns) for dbName, db := range meta { for _, tb := range db.Table { // 防止传入非预期值 if tb == nil { break } td, err := vEnv.Connector.ShowColumns(tb.TableName) if err != nil { common.Log.Warn("GenTableColumns, ShowColumns Error: " + err.Error()) break } // tableColumns 初始化 if dbName == "" { dbName = vEnv.RealDB(vEnv.Connector.Database) } if _, ok := tableColumns[dbName]; !ok { tableColumns[dbName] = make(map[string][]*common.Column) } if _, ok := tableColumns[dbName][tb.TableName]; !ok { tableColumns[dbName][tb.TableName] = make([]*common.Column, 0) } if len(tb.Column) == 0 { // tb.column 为空说明 SQL 里这个表是用的*来查询 if err != nil { common.Log.Error("ast.Rewrite ShowColumns, Error: %v", err) break } for _, colInfo := range td.DescValues { tableColumns[dbName][tb.TableName] = append(tableColumns[dbName][tb.TableName], &common.Column{ Name: colInfo.Field, DB: dbName, Table: tb.TableName, DataType: colInfo.Type, Character: string(colInfo.Collation), Key: colInfo.Key, Default: string(colInfo.Default), Extra: colInfo.Extra, Comment: colInfo.Comment, Privileges: colInfo.Privileges, Null: colInfo.Null, }) } } else { // tb.column如果不为空则需要把使用到的列填写进去 var columns []*common.Column for _, col := range tb.Column { for _, colInfo := range td.DescValues { if col.Name == colInfo.Field { // 根据获取的信息将列的信息补全 col.DB = dbName col.Table = tb.TableName col.DataType = colInfo.Type col.Character = string(colInfo.Collation) col.Key = colInfo.Key col.Default = string(colInfo.Default) col.Extra = colInfo.Extra col.Comment = colInfo.Comment col.Privileges = colInfo.Privileges col.Null = colInfo.Null columns = append(columns, col) break } } } tableColumns[dbName][tb.TableName] = columns } } } return tableColumns } ================================================ FILE: env/env_test.go ================================================ /* * Copyright 2018 Xiaomi, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package env import ( "flag" "fmt" "os" "path/filepath" "runtime" "testing" "github.com/XiaoMi/soar/common" "github.com/XiaoMi/soar/database" "github.com/go-sql-driver/mysql" "github.com/kr/pretty" ) var update = flag.Bool("update", false, "update .golden files") var vEnv *VirtualEnv var rEnv *database.Connector func TestMain(m *testing.M) { // 初始化 init if common.DevPath == "" { _, file, _, _ := runtime.Caller(0) common.DevPath, _ = filepath.Abs(filepath.Dir(filepath.Join(file, ".."+string(filepath.Separator)))) } common.BaseDir = common.DevPath err := common.ParseConfig("") common.LogIfError(err, "init ParseConfig") common.Log.Debug("env_test init") vEnv, rEnv = BuildEnv() if _, err = vEnv.Version(); err != nil { fmt.Println(err.Error(), ", By pass all advisor test cases") os.Exit(0) } if _, err := rEnv.Version(); err != nil { fmt.Println(err.Error(), ", By pass all advisor test cases") os.Exit(0) } // 分割线 flag.Parse() m.Run() // 环境清理 vEnv.CleanUp() } func TestNewVirtualEnv(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) testSQL := []string{ "use sakila", "select frm syntaxError", "create table t(id int,c1 varchar(20),PRIMARY KEY (id));", "alter table t add index `idx_c1`(c1);", "select * from city where country_id = 44;", "select * from address where address2 is not null;", "select * from address where address2 is null;", "select * from address where address2 >= 44;", "select * from city where country_id between 44 and 107;", "select * from city where city like 'Ad%';", "select * from city where city = 'Aden' and country_id = 107;", "select * from city where country_id > 31 and city = 'Aden';", "select * from address where address_id > 8 and city_id < 400 and district = 'Nantou';", "select * from address where address_id > 8 and city_id < 400;", "select * from actor where last_update='2006-02-15 04:34:33' and last_name='CHASE' group by first_name;", "select * from address where last_update >='2014-09-25 22:33:47' group by district;", "select * from address group by address,district;", "select * from address where last_update='2014-09-25 22:30:27' group by district,(address_id+city_id);", "select * from customer where active=1 order by last_name limit 10;", "select * from customer order by last_name limit 10;", "select * from customer where address_id > 224 order by address_id limit 10;", "select * from customer where address_id < 224 order by address_id limit 10;", "select * from customer where active=1 order by last_name;", "select * from customer where address_id > 224 order by address_id;", "select * from customer where address_id in (224,510) order by last_name;", "select city from city where country_id = 44;", "select city,city_id from city where country_id = 44 and last_update='2006-02-15 04:45:25';", "select city from city where country_id > 44 and last_update > '2006-02-15 04:45:25';", "select * from city where country_id=1 and city='Kabul' order by last_update;", "select * from city where country_id>1 and city='Kabul' order by last_update;", "select * from city where city_id>251 order by last_update; ", "select * from city i inner join country o on i.country_id=o.country_id;", "select * from city i left join country o on i.city_id=o.country_id;", "select * from city i right join country o on i.city_id=o.country_id;", "select * from city i left join country o on i.city_id=o.country_id where o.country_id is null;", "select * from city i right join country o on i.city_id=o.country_id where i.city_id is null;", "select * from city i left join country o on i.city_id=o.country_id union select * from city i right join country o on i.city_id=o.country_id;", "select * from city i left join country o on i.city_id=o.country_id where o.country_id is null union select * from city i right join country o on i.city_id=o.country_id where i.city_id is null;", "select first_name,last_name,email from customer natural left join address;", "select first_name,last_name,email from customer natural left join address;", "select first_name,last_name,email from customer natural right join address;", "select first_name,last_name,email from customer STRAIGHT_JOIN address on customer.address_id=address.address_id;", "select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc;", } err := common.GoldenDiff(func() { for _, sql := range testSQL { vEnv.BuildVirtualEnv(rEnv, sql) switch err := vEnv.Error.(type) { case nil: pretty.Println(sql, "OK") case error: // unexpected EOF // 测试环境无法访问,或者被Disable的时候会进入这个分支 pretty.Println(sql, err) case *mysql.MySQLError: if err.Number != 1061 { t.Error(err) } default: t.Error(err) } } }, t.Name(), update) if err != nil { t.Error(err) } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestCleanupTestDatabase(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) if common.Config.TestDSN.Disable { common.Log.Warn("common.Config.TestDSN.Disable=true, by pass TestCleanupTestDatabase") return } vEnv.Query("drop database if exists optimizer_060102150405_xxxxxxxxxxxxxxxx") _, err := vEnv.Query("create database optimizer_060102150405_xxxxxxxxxxxxxxxx") if err != nil { t.Error(err) } vEnv.CleanupTestDatabase() _, err = vEnv.Query("show create database optimizer_060102150405_xxxxxxxxxxxxxxxx") if err == nil { t.Error("optimizer_060102150405_xxxxxxxxxxxxxxxx exist, should be dropped") } vEnv.Query("drop database if exists optimizer_060102150405") _, err = vEnv.Query("create database optimizer_060102150405") if err != nil { t.Error(err) } vEnv.CleanupTestDatabase() _, err = vEnv.Query("drop database optimizer_060102150405") if err != nil { t.Error("optimizer_060102150405 not exist, should not be dropped") } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestGenTableColumns(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) pretty.Println(common.Config.TestDSN.Disable) if common.Config.TestDSN.Disable { common.Log.Warn("common.Config.TestDSN.Disable=true, by pass TestGenTableColumns") return } // 只能对sakila数据库进行测试 if rEnv.Database == "sakila" { testSQL := []string{ "select * from city where country_id = 44;", "select country_id from city where country_id = 44;", "select country_id from city where country_id > 44;", } metaList := []common.Meta{ { "": &common.DB{ Table: map[string]*common.Table{ "city": common.NewTable("city"), }, }, }, { "sakila": &common.DB{ Table: map[string]*common.Table{ "city": common.NewTable("city"), }, }, }, { "sakila": &common.DB{ Table: map[string]*common.Table{ "city": { TableName: "city", Column: map[string]*common.Column{ "country_id": { Name: "country_id", }, }, }, }, }, }, } for i, sql := range testSQL { vEnv.BuildVirtualEnv(rEnv, sql) tFlag := false columns := vEnv.GenTableColumns(metaList[i]) if _, ok := columns["sakila"]; ok { if _, okk := columns["sakila"]["city"]; okk { if length := len(columns["sakila"]["city"]); length >= 1 { tFlag = true } } } if !tFlag { t.Errorf("columns: \n%s", pretty.Sprint(columns)) } } } common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestCreateTable(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgSamplingCondition := common.Config.SamplingCondition common.Config.SamplingCondition = "LIMIT 1" orgREnvDatabase := rEnv.Database rEnv.Database = "sakila" tables := []string{ "actor", "address", "category", "city", "country", "customer", "film", "film_actor", "film_category", "film_text", "inventory", "language", "payment", "rental", "staff", "store", "staff_list", "customer_list", "actor_info", "sales_by_film_category", "sales_by_store", "nicer_but_slower_film_list", "film_list", } for _, table := range tables { err := vEnv.createTable(rEnv, table) if err != nil { t.Error(err) } } common.Config.SamplingCondition = orgSamplingCondition rEnv.Database = orgREnvDatabase common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } func TestCreateDatabase(t *testing.T) { common.Log.Debug("Entering function: %s", common.GetFunctionName()) orgREnvDatabase := rEnv.Database rEnv.Database = "sakila" err := vEnv.createDatabase(rEnv) if err != nil { t.Error(err) } if vEnv.DBHash("sakila") == "sakila" { t.Errorf("database: sakila rehashed failed!") } if vEnv.DBHash("not_exist_db") != "not_exist_db" { t.Errorf("database: not_exist_db rehashed!") } rEnv.Database = orgREnvDatabase common.Log.Debug("Exiting function: %s", common.GetFunctionName()) } ================================================ FILE: env/testdata/TestNewVirtualEnv.golden ================================================ use sakila OK select frm syntaxError OK create table t(id int,c1 varchar(20),PRIMARY KEY (id)); OK alter table t add index `idx_c1`(c1); OK select * from city where country_id = 44; OK select * from address where address2 is not null; OK select * from address where address2 is null; OK select * from address where address2 >= 44; OK select * from city where country_id between 44 and 107; OK select * from city where city like 'Ad%'; OK select * from city where city = 'Aden' and country_id = 107; OK select * from city where country_id > 31 and city = 'Aden'; OK select * from address where address_id > 8 and city_id < 400 and district = 'Nantou'; OK select * from address where address_id > 8 and city_id < 400; OK select * from actor where last_update='2006-02-15 04:34:33' and last_name='CHASE' group by first_name; OK select * from address where last_update >='2014-09-25 22:33:47' group by district; OK select * from address group by address,district; OK select * from address where last_update='2014-09-25 22:30:27' group by district,(address_id+city_id); OK select * from customer where active=1 order by last_name limit 10; OK select * from customer order by last_name limit 10; OK select * from customer where address_id > 224 order by address_id limit 10; OK select * from customer where address_id < 224 order by address_id limit 10; OK select * from customer where active=1 order by last_name; OK select * from customer where address_id > 224 order by address_id; OK select * from customer where address_id in (224,510) order by last_name; OK select city from city where country_id = 44; OK select city,city_id from city where country_id = 44 and last_update='2006-02-15 04:45:25'; OK select city from city where country_id > 44 and last_update > '2006-02-15 04:45:25'; OK select * from city where country_id=1 and city='Kabul' order by last_update; OK select * from city where country_id>1 and city='Kabul' order by last_update; OK select * from city where city_id>251 order by last_update; OK select * from city i inner join country o on i.country_id=o.country_id; OK select * from city i left join country o on i.city_id=o.country_id; OK select * from city i right join country o on i.city_id=o.country_id; OK select * from city i left join country o on i.city_id=o.country_id where o.country_id is null; OK select * from city i right join country o on i.city_id=o.country_id where i.city_id is null; OK select * from city i left join country o on i.city_id=o.country_id union select * from city i right join country o on i.city_id=o.country_id; OK select * from city i left join country o on i.city_id=o.country_id where o.country_id is null union select * from city i right join country o on i.city_id=o.country_id where i.city_id is null; OK select first_name,last_name,email from customer natural left join address; OK select first_name,last_name,email from customer natural left join address; OK select first_name,last_name,email from customer natural right join address; OK select first_name,last_name,email from customer STRAIGHT_JOIN address on customer.address_id=address.address_id; OK select ID,name from (select address from customer_list where SID=1 order by phone limit 50,10) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc; OK ================================================ FILE: etc/soar.blacklist ================================================ # 这是一个黑名单例子 ## 不评审常见的SET, SHOW, SELECT CONST等完美请求 ^set.* ^show.* ^select \?$ ^\/\*.*\*\/$ ^drop.* ^lock.* ^unlock.* ================================================ FILE: etc/soar.yaml ================================================ # 这是一个配置文件例子 online-dsn: addr: 127.0.0.1:3306 schema: sakila user: root password: "1tIsB1g3rt" disable: false test-dsn: addr: 127.0.0.1:3306 schema: sakila user: root password: "1tIsB1g3rt" disable: false # 高危,仅测试时使用,线上环境禁止配置为 true allow-online-as-test: true disable-version-check: false column-not-allow-type: - json - text - boolean log-level: 7 log-output: soar.log sampling: true ================================================ FILE: genver.sh ================================================ #!/bin/bash ## Generate Repository Version tag="$(git describe --tags --always)" version="$(git log --date=iso --pretty=format:"%cd" -1) ${tag}" if [ "X${version}" == "X" ]; then version="not a git repo" tag="not a git repo" fi git_dirty=$(git diff --no-ext-diff 2>/dev/null | wc -l) compile="$(date +"%F %T %z") by $(go version)" branch=$(git rev-parse --abbrev-ref HEAD) dev_path=$( cd "$(dirname "$0")" || exit pwd ) cat <common/version.go package common // -version输出信息 const ( Version = "${version}" Compile = "${compile}" Branch = "${branch}" GitDirty= ${git_dirty} DevPath = "${dev_path}" ) EOF XIAOMI=$(git ls-remote --get-url | grep XiaoMi) if [ "x${XIAOMI}" != "x" ]; then echo "${tag}" | awk -F '-' '{print $1}' > VERSION fi ================================================ FILE: go.mod ================================================ module github.com/XiaoMi/soar go 1.15 require ( github.com/Azure/azure-storage-blob-go v0.10.0 // indirect github.com/Azure/go-autorest/autorest v0.10.0 // indirect github.com/CorgiMan/json2 v0.0.0-20150213135156-e72957aba209 github.com/aquarapid/vaultlib v0.5.1 // indirect github.com/astaxie/beego v1.12.3 github.com/buger/jsonparser v1.1.1 // indirect github.com/codegangsta/inject v0.0.0-20150114235600-33e0aa1cb7c0 // indirect github.com/cyberdelia/go-metrics-graphite v0.0.0-20161219230853-39f87cc3b432 // indirect github.com/dchest/uniuri v0.0.0-20200228104902-7aecb25e1fe5 github.com/gedex/inflector v0.0.0-20170307190818-16278e9db813 github.com/go-martini/martini v0.0.0-20170121215854-22fa46961aab // indirect github.com/go-sql-driver/mysql v1.6.0 github.com/golang/protobuf v1.5.2 // indirect github.com/google/shlex v0.0.0-20191202100458-e7afc7fbc510 // indirect github.com/gorilla/handlers v1.5.1 // indirect github.com/gorilla/mux v1.8.0 // indirect github.com/hashicorp/consul/api v1.5.0 // indirect github.com/hashicorp/go-immutable-radix v1.1.0 // indirect github.com/hashicorp/go-sockaddr v1.0.2 // indirect github.com/hashicorp/go-uuid v1.0.2 // indirect github.com/hashicorp/serf v0.9.2 // indirect github.com/howeyc/gopass v0.0.0-20190910152052-7cb4b85ec19c // indirect github.com/jeremywohl/flatten v0.0.0-20190921043622-d936035e55cf // indirect github.com/klauspost/pgzip v1.2.4 // indirect github.com/konsorten/go-windows-terminal-sequences v1.0.3 // indirect github.com/kr/pretty v0.2.1 github.com/looplab/fsm v0.2.0 // indirect github.com/martini-contrib/auth v0.0.0-20150219114609-fa62c19b7ae8 // indirect github.com/martini-contrib/gzip v0.0.0-20151124214156-6c035326b43f // indirect github.com/martini-contrib/render v0.0.0-20150707142108-ec18f8345a11 // indirect github.com/mitchellh/go-ps v1.0.0 // indirect github.com/mitchellh/go-testing-interface v1.14.0 // indirect github.com/mitchellh/mapstructure v1.2.3 // indirect github.com/montanaflynn/stats v0.6.3 // indirect github.com/olekukonko/tablewriter v0.0.5-0.20200416053754-163badb3bac6 // indirect github.com/oxtoacart/bpool v0.0.0-20190530202638-03653db5a59c // indirect github.com/patrickmn/go-cache v2.1.0+incompatible // indirect github.com/percona/go-mysql v0.0.0-20210427141028-73d29c6da78c github.com/pingcap/log v0.0.0-20210317133921-96f4fcab92a4 // indirect github.com/pingcap/parser v0.0.0-20210525032559-c37778aff307 github.com/pingcap/pd/v4 v4.0.0-beta.1.0.20200305072537-61d9f9cc35d3 // indirect github.com/pingcap/tidb v1.1.0-beta.0.20210601085537-5d7c852770eb github.com/pingcap/tipb v0.0.0-20210601083426-79a378b6d1c4 // indirect github.com/planetscale/pargzip v0.0.0-20201116224723-90c7fc03ea8a // indirect github.com/rcrowley/go-metrics v0.0.0-20200313005456-10cdbea86bc0 // indirect github.com/russross/blackfriday v1.6.0 github.com/saintfish/chardet v0.0.0-20120816061221-3af4cd4741ca github.com/samuel/go-zookeeper v0.0.0-20200724154423-2164a8ac840e // indirect github.com/shirou/gopsutil v3.21.2+incompatible // indirect github.com/sirupsen/logrus v1.8.1 // indirect github.com/sjmudd/stopwatch v0.0.0-20170613150411-f380bf8a9be1 // indirect github.com/spf13/cobra v1.1.1 // indirect github.com/spyzhov/ajson v0.4.2 // indirect github.com/tidwall/gjson v1.12.1 go.uber.org/multierr v1.7.0 // indirect go.uber.org/zap v1.17.0 // indirect golang.org/x/lint v0.0.0-20200302205851-738671d3881b // indirect golang.org/x/sys v0.0.0-20210601080250-7ecdf8ef093b // indirect golang.org/x/text v0.3.6 // indirect gopkg.in/gcfg.v1 v1.2.3 // indirect gopkg.in/warnings.v0 v0.1.2 // indirect gopkg.in/yaml.v2 v2.4.0 vitess.io/vitess v0.0.0-20200325000816-eda961851d63 ) ================================================ FILE: go.sum ================================================ cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= cloud.google.com/go v0.34.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= cloud.google.com/go v0.38.0/go.mod h1:990N+gfupTy94rShfmMCWGDn0LpTmnzTp2qbd1dvSRU= cloud.google.com/go v0.41.0/go.mod h1:OauMR7DV8fzvZIl2qg6rkaIhD/vmgk4iwEw/h6ercmg= cloud.google.com/go v0.44.1/go.mod h1:iSa0KzasP4Uvy3f1mN/7PiObzGgflwredwwASm/v6AU= cloud.google.com/go v0.44.2/go.mod h1:60680Gw3Yr4ikxnPRS/oxxkBccT6SA1yMk63TGekxKY= cloud.google.com/go v0.45.1/go.mod h1:RpBamKRgapWJb87xiFSdk4g1CME7QZg3uwTez+TSTjc= cloud.google.com/go v0.46.3/go.mod h1:a6bKKbmY7er1mI7TEI4lsAkts/mkhTSZK8w33B4RAg0= cloud.google.com/go v0.50.0/go.mod h1:r9sluTvynVuxRIOHXQEHMFffphuXHOMZMycpNR5e6To= cloud.google.com/go v0.52.0/go.mod h1:pXajvRH/6o3+F9jDHZWQ5PbGhn+o8w9qiu/CffaVdO4= cloud.google.com/go v0.53.0/go.mod h1:fp/UouUEsRkN6ryDKNW/Upv/JBKnv6WDthjR6+vze6M= cloud.google.com/go/bigquery v1.0.1/go.mod h1:i/xbL2UlR5RvWAURpBYZTtm/cXjCha9lbfbpx4poX+o= cloud.google.com/go/bigquery v1.3.0/go.mod h1:PjpwJnslEMmckchkHFfq+HTD2DmtT67aNFKH1/VBDHE= cloud.google.com/go/bigquery v1.4.0/go.mod h1:S8dzgnTigyfTmLBfrtrhyYhwRxG72rYxvftPBK2Dvzc= cloud.google.com/go/datastore v1.0.0/go.mod h1:LXYbyblFSglQ5pkeyhO+Qmw7ukd3C+pD7TKLgZqpHYE= cloud.google.com/go/datastore v1.1.0/go.mod h1:umbIZjpQpHh4hmRpGhH4tLFup+FVzqBi1b3c64qFpCk= cloud.google.com/go/firestore v1.1.0/go.mod h1:ulACoGHTpvq5r8rxGJ4ddJZBZqakUQqClKRT5SZwBmk= cloud.google.com/go/pubsub v1.0.1/go.mod h1:R0Gpsv3s54REJCy4fxDixWD93lHJMoZTyQ2kNxGRt3I= cloud.google.com/go/pubsub v1.1.0/go.mod h1:EwwdRX2sKPjnvnqCa270oGRyludottCI76h+R3AArQw= cloud.google.com/go/pubsub v1.2.0/go.mod h1:jhfEVHT8odbXTkndysNHCcx0awwzvfOlguIAii9o8iA= cloud.google.com/go/storage v1.0.0/go.mod h1:IhtSnM/ZTZV8YYJWCY8RULGVqBDmpoyjwiyrjsg+URw= cloud.google.com/go/storage v1.5.0/go.mod h1:tpKbwo567HUNpVclU5sGELwQWBDZ8gh0ZeosJ0Rtdos= cloud.google.com/go/storage v1.6.0/go.mod h1:N7U0C8pVQ/+NIKOBQyamJIeKQKkZ+mxpohlUTyfDhBk= dmitri.shuralyov.com/gpu/mtl v0.0.0-20190408044501-666a987793e9/go.mod h1:H6x//7gZCb22OMCxBHrMx7a5I7Hp++hsVxbQ4BYO7hU= github.com/Azure/azure-pipeline-go v0.2.1/go.mod h1:UGSo8XybXnIGZ3epmeBw7Jdz+HiUVpqIlpz/HKHylF4= github.com/Azure/azure-pipeline-go v0.2.2/go.mod h1:4rQ/NZncSvGqNkkOsNpOU1tgoNuIlp9AfUH5G1tvCHc= github.com/Azure/azure-storage-blob-go v0.8.0/go.mod h1:lPI3aLPpuLTeUwh1sViKXFxwl2B6teiRqI0deQUvsw0= github.com/Azure/azure-storage-blob-go v0.10.0/go.mod h1:ep1edmW+kNQx4UfWM9heESNmQdijykocJ0YOxmMX8SE= github.com/Azure/go-ansiterm v0.0.0-20170929234023-d6e3b3328b78/go.mod h1:LmzpDX56iTiv29bbRTIsUNlaFfuhWRQBWjQdVyAevI8= github.com/Azure/go-autorest/autorest v0.9.0/go.mod h1:xyHB1BMZT0cuDHU7I0+g046+BFDTQ8rEZB0s4Yfa6bI= github.com/Azure/go-autorest/autorest v0.10.0/go.mod h1:/FALq9T/kS7b5J5qsQ+RSTUdAmGFqi0vUdVNNx8q630= github.com/Azure/go-autorest/autorest/adal v0.5.0/go.mod h1:8Z9fGy2MpX0PvDjB1pEgQTmVqjGhiHBW7RJJEciWzS0= github.com/Azure/go-autorest/autorest/adal v0.8.1/go.mod h1:ZjhuQClTqx435SRJ2iMlOxPYt3d2C/T/7TiQCVZSn3Q= github.com/Azure/go-autorest/autorest/adal v0.8.2/go.mod h1:ZjhuQClTqx435SRJ2iMlOxPYt3d2C/T/7TiQCVZSn3Q= github.com/Azure/go-autorest/autorest/adal v0.8.3/go.mod h1:ZjhuQClTqx435SRJ2iMlOxPYt3d2C/T/7TiQCVZSn3Q= github.com/Azure/go-autorest/autorest/date v0.1.0/go.mod h1:plvfp3oPSKwf2DNjlBjWF/7vwR+cUD/ELuzDCXwHUVA= github.com/Azure/go-autorest/autorest/date v0.2.0/go.mod h1:vcORJHLJEh643/Ioh9+vPmf1Ij9AEBM5FuBIXLmIy0g= github.com/Azure/go-autorest/autorest/mocks v0.1.0/go.mod h1:OTyCOPRA2IgIlWxVYxBee2F5Gr4kF2zd2J5cFRaIDN0= github.com/Azure/go-autorest/autorest/mocks v0.2.0/go.mod h1:OTyCOPRA2IgIlWxVYxBee2F5Gr4kF2zd2J5cFRaIDN0= github.com/Azure/go-autorest/autorest/mocks v0.3.0/go.mod h1:a8FDP3DYzQ4RYfVAxAN3SVSiiO77gL2j2ronKKP0syM= github.com/Azure/go-autorest/logger v0.1.0/go.mod h1:oExouG+K6PryycPJfVSxi/koC6LSNgds39diKLz7Vrc= github.com/Azure/go-autorest/tracing v0.5.0/go.mod h1:r/s2XiOKccPW3HrqB+W0TQzfbtp2fGCgRFtBroKn4Dk= github.com/Bowery/prompt v0.0.0-20190419144237-972d0ceb96f5/go.mod h1:4/6eNcqZ09BZ9wLK3tZOjBA1nDj+B0728nlX5YRlSmQ= github.com/BurntSushi/toml v0.3.1 h1:WXkYYl6Yr3qBf1K79EBnL4mak0OimBfB0XUf9Vl28OQ= github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= github.com/BurntSushi/xgb v0.0.0-20160522181843-27f122750802/go.mod h1:IVnqGOEym/WlBOVXweHU+Q+/VP0lqqI8lqeDx9IjBqo= github.com/BurntSushi/xgbutil v0.0.0-20160919175755-f7c97cef3b4e/go.mod h1:uw9h2sd4WWHOPdJ13MQpwK5qYWKYDumDqxWWIknEQ+k= github.com/CorgiMan/json2 v0.0.0-20150213135156-e72957aba209 h1:rRZPHlNlREFwuEtpYikMNZPs4l5g6zic54l2XDAK4ws= github.com/CorgiMan/json2 v0.0.0-20150213135156-e72957aba209/go.mod h1:VwmVPvMIZlx23Q7F1umyYmkhNDqf6WQKfMUhGEdVcLA= github.com/DATA-DOG/go-sqlmock v1.5.0/go.mod h1:f/Ixk793poVmq4qj/V1dPUg2JEAKC73Q5eFN3EC/SaM= github.com/DataDog/datadog-go v2.2.0+incompatible/go.mod h1:LButxg5PwREeZtORoXG3tL4fMGNddJ+vMq1mwgfaqoQ= github.com/GeertJohan/go.incremental v1.0.0/go.mod h1:6fAjUhbVuX1KcMD3c8TEgVUqmo4seqhv0i0kdATSkM0= github.com/GeertJohan/go.rice v1.0.0/go.mod h1:eH6gbSOAUv07dQuZVnBmoDP8mgsM1rtixis4Tib9if0= github.com/HdrHistogram/hdrhistogram-go v0.9.0/go.mod h1:nxrse8/Tzg2tg3DZcZjm6qEclQKK70g0KxO61gFFZD4= github.com/Jeffail/gabs v1.1.0/go.mod h1:6xMvQMK4k33lb7GUUpaAPh6nKMmemQeg5d4gn7/bOXc= github.com/Jeffail/gabs/v2 v2.5.1/go.mod h1:xCn81vdHKxFUuWWAaD5jCTQDNPBMh5pPs9IJ+NcziBI= github.com/Knetic/govaluate v3.0.0+incompatible/go.mod h1:r7JcOSlj0wfOMncg0iLm8Leh48TZaKVeNIfJntJ2wa0= github.com/KyleBanks/depth v1.2.1/go.mod h1:jzSb9d0L43HxTQfT+oSA1EEp2q+ne2uh6XgeJcm8brE= github.com/Masterminds/glide v0.13.2/go.mod h1:STyF5vcenH/rUqTEv+/hBXlSTo7KYwg2oc2f4tzPWic= github.com/Masterminds/semver v1.4.2/go.mod h1:MB6lktGJrhw8PrUyiEoblNEGEQ+RzHPF078ddwwvV3Y= github.com/Masterminds/vcs v1.13.0/go.mod h1:N09YCmOQr6RLxC6UNHzuVwAdodYbbnycGHSmwVJjcKA= github.com/Microsoft/go-winio v0.4.3/go.mod h1:VhR8bwka0BXejwEJY73c50VrPtXAaKcyvVC4A4RozmA= github.com/NYTimes/gziphandler v0.0.0-20170623195520-56545f4a5d46/go.mod h1:3wb06e3pkSAbeQ52E9H9iFoQsEEwGN64994WTCIhntQ= github.com/NYTimes/gziphandler v1.0.1/go.mod h1:3wb06e3pkSAbeQ52E9H9iFoQsEEwGN64994WTCIhntQ= github.com/Nvveen/Gotty v0.0.0-20120604004816-cd527374f1e5/go.mod h1:lmUJ/7eu/Q8D7ML55dXQrVaamCz2vxCfdQBasLZfHKk= github.com/OneOfOne/xxhash v1.2.2/go.mod h1:HSdplMjZKSmBqAxg5vPj2TmRDmfkzw+cTzAElWljhcU= github.com/OpenPeeDeeP/depguard v1.0.1/go.mod h1:xsIw86fROiiwelg+jB2uM9PiKihMMmUx/1V+TNhjQvM= github.com/PuerkitoBio/goquery v1.5.1/go.mod h1:GsLWisAFVj4WgDibEWF4pvYnkVQBpKBKeU+7zCJoLcc= github.com/PuerkitoBio/purell v1.0.0/go.mod h1:c11w/QuzBsJSee3cPx9rAFu61PvFxuPbtSwDGJws/X0= github.com/PuerkitoBio/purell v1.1.0/go.mod h1:c11w/QuzBsJSee3cPx9rAFu61PvFxuPbtSwDGJws/X0= github.com/PuerkitoBio/purell v1.1.1/go.mod h1:c11w/QuzBsJSee3cPx9rAFu61PvFxuPbtSwDGJws/X0= github.com/PuerkitoBio/urlesc v0.0.0-20160726150825-5bd2802263f2/go.mod h1:uGdkoq3SwY9Y+13GIhn11/XLaGBb4BfwItxLd5jeuXE= github.com/PuerkitoBio/urlesc v0.0.0-20170810143723-de5bf2ad4578/go.mod h1:uGdkoq3SwY9Y+13GIhn11/XLaGBb4BfwItxLd5jeuXE= github.com/SAP/go-hdb v0.12.0/go.mod h1:etBT+FAi1t5k3K3tf5vQTnosgYmhDkRi8jEnQqCnxF0= github.com/SermoDigital/jose v0.0.0-20180104203859-803625baeddc/go.mod h1:ARgCUhI1MHQH+ONky/PAtmVHQrP5JlGY0F3poXOp/fA= github.com/StackExchange/wmi v0.0.0-20180116203802-5d049714c4a6/go.mod h1:3eOhrUMpNV+6aFIbp5/iudMxNCF27Vw2OZgy4xEx0Fg= github.com/StackExchange/wmi v0.0.0-20190523213315-cbe66965904d h1:G0m3OIz70MZUWq3EgK3CesDbo8upS2Vm9/P3FtgI+Jk= github.com/StackExchange/wmi v0.0.0-20190523213315-cbe66965904d/go.mod h1:3eOhrUMpNV+6aFIbp5/iudMxNCF27Vw2OZgy4xEx0Fg= github.com/VividCortex/ewma v1.1.1/go.mod h1:2Tkkvm3sRDVXaiyucHiACn4cqf7DpdyLvmxzcbUokwA= github.com/VividCortex/mysqlerr v0.0.0-20200629151747-c28746d985dd/go.mod h1:f3HiCrHjHBdcm6E83vGaXh1KomZMA2P6aeo3hKx/wg0= github.com/Xeoncross/go-aesctr-with-hmac v0.0.0-20200623134604-12b17a7ff502/go.mod h1:pmnBM9bxWSiHvC/gSWunUIyDvGn33EkP2CUjxFKtTTM= github.com/abdullin/seq v0.0.0-20160510034733-d5467c17e7af/go.mod h1:5Jv4cbFiHJMsVxt52+i0Ha45fjshj6wxYr1r19tB9bw= github.com/agnivade/levenshtein v1.0.1/go.mod h1:CURSv5d9Uaml+FovSIICkLbAUZ9S4RqaHDIsdSBg7lM= github.com/akavel/rsrc v0.8.0/go.mod h1:uLoCtb9J+EyAqh+26kdrTgmzRBFPGOolLWKpdxkKq+c= github.com/alecthomas/template v0.0.0-20160405071501-a0175ee3bccc/go.mod h1:LOuyumcjzFXgccqObfd/Ljyb9UuFJ6TxHnclSeseNhc= github.com/alecthomas/template v0.0.0-20190718012654-fb15b899a751/go.mod h1:LOuyumcjzFXgccqObfd/Ljyb9UuFJ6TxHnclSeseNhc= github.com/alecthomas/units v0.0.0-20151022065526-2efee857e7cf/go.mod h1:ybxpYRFXyAe+OPACYpWeL0wqObRcbAqCMya13uyzqw0= github.com/alecthomas/units v0.0.0-20190717042225-c3de453c63f4/go.mod h1:ybxpYRFXyAe+OPACYpWeL0wqObRcbAqCMya13uyzqw0= github.com/alicebob/gopher-json v0.0.0-20180125190556-5a6b3ba71ee6/go.mod h1:SGnFV6hVsYE877CKEZ6tDNTjaSXYUk6QqoIK6PrAtcc= github.com/alicebob/miniredis v2.5.0+incompatible/go.mod h1:8HZjEj4yU0dwhYHky+DxYx+6BMjkBbe5ONFIF1MXffk= github.com/andreyvit/diff v0.0.0-20170406064948-c7f18ee00883/go.mod h1:rCTlJbsFo29Kk6CurOXKm700vrz8f0KW0JNfpkRJY/8= github.com/andybalholm/cascadia v1.1.0/go.mod h1:GsXiBklL0woXo1j/WYWtSYYC4ouU9PqHO0sqidkEA4Y= github.com/antihax/optional v0.0.0-20180407024304-ca021399b1a6/go.mod h1:V8iCPQYkqmusNa815XgQio277wI47sdRh1dUOLdyC6Q= github.com/apache/thrift v0.0.0-20181112125854-24918abba929/go.mod h1:cp2SuWMxlEZw2r+iP2GNCdIi4C1qmUzdZFSVb+bacwQ= github.com/apache/thrift v0.13.1-0.20201008052519-daf620915714/go.mod h1:cp2SuWMxlEZw2r+iP2GNCdIi4C1qmUzdZFSVb+bacwQ= github.com/appleboy/gin-jwt/v2 v2.6.3/go.mod h1:MfPYA4ogzvOcVkRwAxT7quHOtQmVKDpTwxyUrC2DNw0= github.com/appleboy/gofight/v2 v2.1.2/go.mod h1:frW+U1QZEdDgixycTj4CygQ48yLTUhplt43+Wczp3rw= github.com/aquarapid/vaultlib v0.5.1/go.mod h1:yT7AlEXtuabkxylOc/+Ulyp18tff1+QjgNLTnFWTlOs= github.com/armon/circbuf v0.0.0-20150827004946-bbbad097214e/go.mod h1:3U/XgcO3hCbHZ8TKRvWD2dDTCfh9M9ya+I9JpbB7O8o= github.com/armon/consul-api v0.0.0-20180202201655-eb2c6b5be1b6/go.mod h1:grANhF5doyWs3UAsr3K4I6qtAmlQcZDesFNEHPZAzj8= github.com/armon/go-metrics v0.0.0-20180917152333-f0300d1749da/go.mod h1:Q73ZrmVTwzkszR9V5SSuryQ31EELlFMUz1kKyl939pY= github.com/armon/go-metrics v0.0.0-20190430140413-ec5e00d3c878/go.mod h1:3AMJUQhVx52RsWOnlkpikZr01T/yAVN2gn0861vByNg= github.com/armon/go-radix v0.0.0-20180808171621-7fddfc383310/go.mod h1:ufUuZ+zHj4x4TnLV4JWEpy2hxWSpsRywHrMgIH9cCH8= github.com/armon/go-radix v1.0.0/go.mod h1:ufUuZ+zHj4x4TnLV4JWEpy2hxWSpsRywHrMgIH9cCH8= github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5/go.mod h1:wHh0iHkYZB8zMSxRWpUBQtwG5a7fFgvEO+odwuTv2gs= github.com/asaskevich/govalidator v0.0.0-20180720115003-f9ffefc3facf/go.mod h1:lB+ZfQJz7igIIfQNfa7Ml4HSf2uFQQRzpGGRXenZAgY= github.com/asaskevich/govalidator v0.0.0-20190424111038-f61b66f89f4a/go.mod h1:lB+ZfQJz7igIIfQNfa7Ml4HSf2uFQQRzpGGRXenZAgY= github.com/astaxie/beego v1.12.3 h1:SAQkdD2ePye+v8Gn1r4X6IKZM1wd28EyUOVQ3PDSOOQ= github.com/astaxie/beego v1.12.3/go.mod h1:p3qIm0Ryx7zeBHLljmd7omloyca1s4yu1a8kM1FkpIA= github.com/aws/aws-sdk-go v1.28.8/go.mod h1:KmX6BPdI08NWTb3/sm4ZGu5ShLoqVDhKgpiN924inxo= github.com/aws/aws-sdk-go v1.30.19/go.mod h1:5zCpMtNQVjRREroY7sYe8lOMRSxkhG6MZveU8YkpAk0= github.com/aws/aws-sdk-go v1.35.3/go.mod h1:H7NKnBqNVzoTJpGfLrQkkD+ytBA93eiDYi/+8rV9s48= github.com/beego/goyaml2 v0.0.0-20130207012346-5545475820dd/go.mod h1:1b+Y/CofkYwXMUU0OhQqGvsY2Bvgr4j6jfT699wyZKQ= github.com/beego/x2j v0.0.0-20131220205130-a0352aadc542/go.mod h1:kSeGC/p1AbBiEp5kat81+DSQrZenVBZXklMLaELspWU= github.com/beorn7/perks v0.0.0-20180321164747-3a771d992973/go.mod h1:Dwedo/Wpr24TaqPxmxbtue+5NUziq4I4S80YR8gNf3Q= github.com/beorn7/perks v1.0.0/go.mod h1:KWe93zE9D1o94FZ5RNwFwVgaQK1VOXiVxmqh+CedLV8= github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM= github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw= github.com/bgentry/speakeasy v0.1.0/go.mod h1:+zsyZBPWlz7T6j88CTgSN5bM796AkVf0kBD4zp0CCIs= github.com/bitly/go-hostpool v0.0.0-20171023180738-a3a6125de932/go.mod h1:NOuUCSz6Q9T7+igc/hlvDOUdtWKryOrtFyIVABv/p7k= github.com/bketelsen/crypt v0.0.3-0.20200106085610-5cbc8cc4026c/go.mod h1:MKsuJmJgSg28kpZDP6UIiPt0e0Oz0kqKNGyRaWEPv84= github.com/blacktear23/go-proxyprotocol v0.0.0-20180807104634-af7a81e8dd0d/go.mod h1:VKt7CNAQxpFpSDz3sXyj9hY/GbVsQCr0sB3w59nE7lU= github.com/blang/semver v3.5.0+incompatible/go.mod h1:kRBLl5iJ+tD4TcOOxsy/0fnwebNt5EWlYSAyrTnjyyk= github.com/blang/semver v3.5.1+incompatible/go.mod h1:kRBLl5iJ+tD4TcOOxsy/0fnwebNt5EWlYSAyrTnjyyk= github.com/bmizerany/assert v0.0.0-20160611221934-b7ed37b82869/go.mod h1:Ekp36dRnpXw/yCqJaO+ZrUyxD+3VXMFFr56k5XYrpB4= github.com/boltdb/bolt v1.3.1/go.mod h1:clJnj/oiGkjum5o1McbSZDSLxVThjynRyGBgiAx27Ps= github.com/bombsimon/wsl v1.2.5/go.mod h1:43lEF/i0kpXbLCeDXL9LMT8c92HyBywXb0AsgMHYngM= github.com/bombsimon/wsl v1.2.8/go.mod h1:43lEF/i0kpXbLCeDXL9LMT8c92HyBywXb0AsgMHYngM= github.com/bradfitz/gomemcache v0.0.0-20180710155616-bc664df96737/go.mod h1:PmM6Mmwb0LSuEubjR8N7PtNe1KxZLtOUHtbeikc5h60= github.com/buger/jsonparser v0.0.0-20200322175846-f7e751efca13/go.mod h1:tgcrVJ81GPSF0mz+0nu1Xaz0fazGPrmmJfJtxjbHhUQ= github.com/buger/jsonparser v1.1.1 h1:2PnMjfWD7wBILjqQbt530v576A/cAbQvEW9gGIpYMUs= github.com/buger/jsonparser v1.1.1/go.mod h1:6RYKKt7H4d4+iWqouImQ9R2FZql3VbhNgx27UK13J/0= github.com/cakturk/go-netstat v0.0.0-20200220111822-e5b49efee7a5/go.mod h1:jtAfVaU/2cu1+wdSRPWE2c1N2qeAA3K4RH9pYgqwets= github.com/carlmjohnson/flagext v0.21.0/go.mod h1:Eenv0epIUAr4NuedNmkzI8WmBmjIxZC239XcKxYS2ac= github.com/casbin/casbin v1.7.0/go.mod h1:c67qKN6Oum3UF5Q1+BByfFxkwKvhwW57ITjqwtzR1KE= github.com/cenkalti/backoff v2.1.1+incompatible/go.mod h1:90ReRw6GdpyfrHakVjL/QHaoyV4aDUVVkXQJJJ3NXXM= github.com/cenkalti/backoff/v4 v4.0.2/go.mod h1:eEew/i+1Q6OrCDZh3WiXYv3+nJwBASZ8Bog/87DQnVg= github.com/census-instrumentation/opencensus-proto v0.2.1/go.mod h1:f6KPmirojxKA12rnyqOA5BBL4O983OfeGPqjHWSTneU= github.com/cespare/xxhash v1.1.0 h1:a6HrQnmkObjyL+Gs60czilIUGqrzKutQD6XZog3p+ko= github.com/cespare/xxhash v1.1.0/go.mod h1:XrSqR1VqqWfGrhpAt58auRo0WTKS1nRRg3ghfAqPWnc= github.com/cespare/xxhash/v2 v2.1.0/go.mod h1:dgIUBU3pDso/gPgZ1osOZ0iQf77oPR28Tjxl5dIMyVM= github.com/cespare/xxhash/v2 v2.1.1 h1:6MnRN8NT7+YBpUIWxHtefFZOKTAPgGjpQSxqLNn0+qY= github.com/cespare/xxhash/v2 v2.1.1/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs= github.com/cheggaaa/pb/v3 v3.0.4/go.mod h1:7rgWxLrAUcFMkvJuv09+DYi7mMUYi8nO9iOWcvGJPfw= github.com/chzyer/logex v1.1.10/go.mod h1:+Ywpsq7O8HXn0nuIou7OrIPyXbp3wmkHB+jjWRnGsAI= github.com/chzyer/readline v0.0.0-20171208011716-f6d7a1f6fbf3/go.mod h1:nSuG5e5PlCu98SY8svDHJxuZscDgtXS6KTTbou5AhLI= github.com/chzyer/readline v0.0.0-20180603132655-2972be24d48e/go.mod h1:nSuG5e5PlCu98SY8svDHJxuZscDgtXS6KTTbou5AhLI= github.com/chzyer/test v0.0.0-20180213035817-a1ea475d72b1/go.mod h1:Q3SI9o4m/ZMnBNeIyt5eFwwo7qiLfzFZmjNmxjkiQlU= github.com/circonus-labs/circonus-gometrics v2.3.1+incompatible/go.mod h1:nmEj6Dob7S7YxXgwXpfOuvO54S+tGdZdw9fuRZt25Ag= github.com/circonus-labs/circonusllhist v0.1.3/go.mod h1:kMXHVDlOchFAehlya5ePtbp5jckzBHf4XRpQvBOLI+I= github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw= github.com/cloudflare/golz4 v0.0.0-20150217214814-ef862a3cdc58/go.mod h1:EOBUe0h4xcZ5GoxqC5SDxFQ8gwyZPKQoEzownBlhI80= github.com/cockroachdb/cmux v0.0.0-20170110192607-30d10be49292/go.mod h1:qRiX68mZX1lGBkTWyp3CLcenw9I94W2dLeRvMzcn9N4= github.com/cockroachdb/datadriven v0.0.0-20190809214429-80d97fb3cbaa/go.mod h1:zn76sxSg3SzpJ0PPJaLDCu+Bu0Lg3sKTORVIj19EIF8= github.com/codahale/hdrhistogram v0.0.0-20161010025455-3a0bb77429bd/go.mod h1:sE/e/2PUdi/liOCUjSTXgM1o87ZssimdTWN964YiIeI= github.com/codegangsta/cli v1.20.0/go.mod h1:/qJNoX69yVSKu5o4jLyXAENLRyk1uhi7zkbQ3slBdOA= github.com/codegangsta/inject v0.0.0-20150114235600-33e0aa1cb7c0/go.mod h1:4Zcjuz89kmFXt9morQgcfYZAYZ5n8WHjt81YYWIwtTM= github.com/colinmarc/hdfs/v2 v2.1.1/go.mod h1:M3x+k8UKKmxtFu++uAZ0OtDU8jR3jnaZIAc6yK4Ue0c= github.com/containerd/continuity v0.0.0-20181203112020-004b46473808/go.mod h1:GL3xCUCBDV3CZiTSEKksMWbLE66hEyuu9qyDOOqM47Y= github.com/coocood/bbloom v0.0.0-20190830030839-58deb6228d64/go.mod h1:F86k/6c7aDUdwSUevnLpHS/3Q9hzYCE99jGk2xsHnt0= github.com/coocood/freecache v1.1.1/go.mod h1:OKrEjkGVoxZhyWAJoeFi5BMLUJm2Tit0kpGkIr7NGYY= github.com/coocood/rtutil v0.0.0-20190304133409-c84515f646f2/go.mod h1:7qG7YFnOALvsx6tKTNmQot8d7cGFXM9TidzvRFLWYwM= github.com/coredns/coredns v1.1.2/go.mod h1:zASH/MVDgR6XZTbxvOnsZfffS+31vg6Ackf/wo1+AM0= github.com/coreos/bbolt v1.3.2/go.mod h1:iRUV2dpdMOn7Bo10OQBFzIJO9kkE559Wcmn+qkEiiKk= github.com/coreos/etcd v3.3.10+incompatible/go.mod h1:uF7uidLiAD3TWHmW31ZFd/JWoc32PjwdhPthX9715RE= github.com/coreos/etcd v3.3.13+incompatible/go.mod h1:uF7uidLiAD3TWHmW31ZFd/JWoc32PjwdhPthX9715RE= github.com/coreos/go-etcd v2.0.0+incompatible/go.mod h1:Jez6KQU2B/sWsbdaef3ED8NzMklzPG4d5KIOhIy30Tk= github.com/coreos/go-oidc v2.1.0+incompatible/go.mod h1:CgnwVTmzoESiwO9qyAFEMiHoZ1nMCKZlZ9V6mm3/LKc= github.com/coreos/go-semver v0.2.0/go.mod h1:nnelYz7RCh+5ahJtPPxZlU+153eP4D4r3EedlOD2RNk= github.com/coreos/go-semver v0.3.0/go.mod h1:nnelYz7RCh+5ahJtPPxZlU+153eP4D4r3EedlOD2RNk= github.com/coreos/go-systemd v0.0.0-20180511133405-39ca1b05acc7/go.mod h1:F5haX7vjVVG0kc13fIWeqUViNPyEJxv/OmvnBo0Yme4= github.com/coreos/go-systemd v0.0.0-20181031085051-9002847aa142/go.mod h1:F5haX7vjVVG0kc13fIWeqUViNPyEJxv/OmvnBo0Yme4= github.com/coreos/go-systemd v0.0.0-20190321100706-95778dfbb74e/go.mod h1:F5haX7vjVVG0kc13fIWeqUViNPyEJxv/OmvnBo0Yme4= github.com/coreos/go-systemd v0.0.0-20190719114852-fd7a80b32e1f h1:JOrtw2xFKzlg+cbHpyrpLDmnN1HqhBfnX7WDiW7eG2c= github.com/coreos/go-systemd v0.0.0-20190719114852-fd7a80b32e1f/go.mod h1:F5haX7vjVVG0kc13fIWeqUViNPyEJxv/OmvnBo0Yme4= github.com/coreos/pkg v0.0.0-20160727233714-3ac0863d7acf/go.mod h1:E3G3o1h8I7cfcXa63jLwjI0eiQQMgzzUDFVpN/nH/eA= github.com/coreos/pkg v0.0.0-20180108230652-97fdf19511ea/go.mod h1:E3G3o1h8I7cfcXa63jLwjI0eiQQMgzzUDFVpN/nH/eA= github.com/coreos/pkg v0.0.0-20180928190104-399ea9e2e55f h1:lBNOc5arjvs8E5mO2tbpBpLoyyu8B6e44T7hJy6potg= github.com/coreos/pkg v0.0.0-20180928190104-399ea9e2e55f/go.mod h1:E3G3o1h8I7cfcXa63jLwjI0eiQQMgzzUDFVpN/nH/eA= github.com/corona10/goimagehash v1.0.2/go.mod h1:/l9umBhvcHQXVtQO1V6Gp1yD20STawkhRnnX0D1bvVI= github.com/corpix/uarand v0.1.1/go.mod h1:SFKZvkcRoLqVRFZ4u25xPmp6m9ktANfbpXZ7SJ0/FNU= github.com/couchbase/go-couchbase v0.0.0-20200519150804-63f3cdb75e0d/go.mod h1:TWI8EKQMs5u5jLKW/tsb9VwauIrMIxQG1r5fMsswK5U= github.com/couchbase/gomemcached v0.0.0-20200526233749-ec430f949808/go.mod h1:srVSlQLB8iXBVXHgnqemxUXqN6FCvClgCMPCsjBDR7c= github.com/couchbase/goutils v0.0.0-20180530154633-e865a1461c8a/go.mod h1:BQwMFlJzDjFDG3DJUdU0KORxn88UlsOULuxLExMh3Hs= github.com/cpuguy83/go-md2man v1.0.10/go.mod h1:SmD6nW6nTyfqj6ABTjUi3V3JVMnlJmwcJI5acqYI6dE= github.com/cpuguy83/go-md2man/v2 v2.0.0-20190314233015-f79a8a8ca69d/go.mod h1:maD7wRr/U5Z6m/iR4s+kqSMx2CaBsrgA7czyZG/E6dU= github.com/cpuguy83/go-md2man/v2 v2.0.0/go.mod h1:maD7wRr/U5Z6m/iR4s+kqSMx2CaBsrgA7czyZG/E6dU= github.com/creack/pty v1.1.7/go.mod h1:lj5s0c3V2DBrqTV7llrYr5NG6My20zk30Fl46Y7DoTY= github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E= github.com/cupcake/rdb v0.0.0-20161107195141-43ba34106c76/go.mod h1:vYwsqCOLxGiisLwp9rITslkFNpZD5rz43tf41QFkTWY= github.com/cyberdelia/go-metrics-graphite v0.0.0-20161219230853-39f87cc3b432/go.mod h1:xwIwAxMvYnVrGJPe2FKx5prTrnAjGOD8zvDOnxnrrkM= github.com/cznic/golex v0.0.0-20181122101858-9c343928389c/go.mod h1:+bmmJDNmKlhWNG+gwWCkaBoTy39Fs+bzRxVBzoTQbIc= github.com/cznic/mathutil v0.0.0-20181122101859-297441e03548 h1:iwZdTE0PVqJCos1vaoKsclOGD3ADKpshg3SRtYBbwso= github.com/cznic/mathutil v0.0.0-20181122101859-297441e03548/go.mod h1:e6NPNENfs9mPDVNRekM7lKScauxd5kXTr1Mfyig6TDM= github.com/cznic/parser v0.0.0-20160622100904-31edd927e5b1/go.mod h1:2B43mz36vGZNZEwkWi8ayRSSUXLfjL8OkbzwW4NcPMM= github.com/cznic/sortutil v0.0.0-20181122101858-f5f958428db8/go.mod h1:q2w6Bg5jeox1B+QkJ6Wp/+Vn0G/bo3f1uY7Fn3vivIQ= github.com/cznic/strutil v0.0.0-20171016134553-529a34b1c186/go.mod h1:AHHPPPXTw0h6pVabbcbyGRK1DckRn7r/STdZEeIDzZc= github.com/cznic/y v0.0.0-20170802143616-045f81c6662a/go.mod h1:1rk5VM7oSnA4vjp+hrLQ3HWHa+Y4yPCa3/CsJrcNnvs= github.com/daaku/go.zipexe v1.0.0/go.mod h1:z8IiR6TsVLEYKwXAoE/I+8ys/sDkgTzSL0CLnGVd57E= github.com/danjacques/gofslock v0.0.0-20191023191349-0a45f885bc37 h1:X6mKGhCFOxrKeeHAjv/3UvT6e5RRxW6wRdlqlV6/H4w= github.com/danjacques/gofslock v0.0.0-20191023191349-0a45f885bc37/go.mod h1:DC3JtzuG7kxMvJ6dZmf2ymjNyoXwgtklr7FN+Um2B0U= github.com/davecgh/go-spew v0.0.0-20151105211317-5215b55f46b2/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/dchest/safefile v0.0.0-20151022103144-855e8d98f185/go.mod h1:cFRxtTwTOJkz2x3rQUNCYKWC93yP1VKjR8NUhqFxZNU= github.com/dchest/uniuri v0.0.0-20200228104902-7aecb25e1fe5 h1:RAV05c0xOkJ3dZGS0JFybxFKZ2WMLabgx3uXnd7rpGs= github.com/dchest/uniuri v0.0.0-20200228104902-7aecb25e1fe5/go.mod h1:GgB8SF9nRG+GqaDtLcwJZsQFhcogVCJ79j4EdT0c2V4= github.com/denisenkom/go-mssqldb v0.0.0-20180620032804-94c9c97e8c9f/go.mod h1:xN/JuLBIz4bjkxNmByTiV1IbhfnYb6oo99phBn4Eqhc= github.com/denisenkom/go-mssqldb v0.0.0-20191124224453-732737034ffd/go.mod h1:xbL0rPBG9cCiLr28tMa8zpbdarY27NDyej4t/EjAShU= github.com/denverdino/aliyungo v0.0.0-20170926055100-d3308649c661/go.mod h1:dV8lFg6daOBZbT6/BDGIz6Y3WFGn8juu6G+CQ6LHtl0= github.com/dgraph-io/ristretto v0.0.1/go.mod h1:T40EBc7CJke8TkpiYfGGKAeFjSaxuFXhuXRyumBd6RE= github.com/dgrijalva/jwt-go v3.2.0+incompatible/go.mod h1:E3ru+11k8xSBh+hMPgOLZmtrrCbhqsmaPHjLKYnJCaQ= github.com/dgryski/go-farm v0.0.0-20190104051053-3adb47b1fb0f/go.mod h1:SqUrOPUnsFjfmXRMNPybcSiG0BgUW2AuFH8PAnS2iTw= github.com/dgryski/go-farm v0.0.0-20190423205320-6a90982ecee2/go.mod h1:SqUrOPUnsFjfmXRMNPybcSiG0BgUW2AuFH8PAnS2iTw= github.com/dgryski/go-sip13 v0.0.0-20181026042036-e10d5fee7954/go.mod h1:vAd38F8PWV+bWy6jNmig1y/TA+kYO4g3RSRF0IAv0no= github.com/digitalocean/godo v1.10.0/go.mod h1:h6faOIcZ8lWIwNQ+DN7b3CgX4Kwby5T+nbpNqkUIozU= github.com/docker/docker v0.7.3-0.20190327010347-be7ac8be2ae0/go.mod h1:eEKB0N0r5NX/I1kEveEz05bcu8tLC/8azJZsviup8Sk= github.com/docker/go-connections v0.3.0/go.mod h1:Gbd7IOopHjR8Iph03tsViu4nIes5XhDvyHbTtUxmeec= github.com/docker/go-units v0.3.3/go.mod h1:fgPhTUdO+D/Jk86RDLlptpiXQzgHJF7gydDDbaIK4Dk= github.com/docker/go-units v0.4.0/go.mod h1:fgPhTUdO+D/Jk86RDLlptpiXQzgHJF7gydDDbaIK4Dk= github.com/docker/spdystream v0.0.0-20160310174837-449fdfce4d96/go.mod h1:Qh8CwZgvJUkLughtfhJv5dyTYa91l1fOUCrgjqmcifM= github.com/duosecurity/duo_api_golang v0.0.0-20190308151101-6c680f768e74/go.mod h1:UqXY1lYT/ERa4OEAywUqdok1T4RCRdArkhic1Opuavo= github.com/dustin/go-humanize v0.0.0-20171111073723-bb3d318650d4/go.mod h1:HtrtbFcZ19U5GC7JDqmcUSB87Iq5E25KnS6fMYU6eOk= github.com/dustin/go-humanize v0.0.0-20180421182945-02af3965c54e/go.mod h1:HtrtbFcZ19U5GC7JDqmcUSB87Iq5E25KnS6fMYU6eOk= github.com/dustin/go-humanize v1.0.0/go.mod h1:HtrtbFcZ19U5GC7JDqmcUSB87Iq5E25KnS6fMYU6eOk= github.com/edsrzf/mmap-go v0.0.0-20170320065105-0bce6a688712/go.mod h1:YO35OhQPt3KJa3ryjFM5Bs14WD66h8eGKpfaBNrHW5M= github.com/eknkc/amber v0.0.0-20171010120322-cdade1c07385/go.mod h1:0vRUJqYpeSZifjYj7uP3BG/gKcuzL9xWVV/Y+cK33KM= github.com/elastic/go-elasticsearch/v6 v6.8.5/go.mod h1:UwaDJsD3rWLM5rKNFzv9hgox93HoX8utj1kxD9aFUcI= github.com/elazarl/go-bindata-assetfs v0.0.0-20160803192304-e1a2a7ec64b0/go.mod h1:v+YaWX3bdea5J/mo8dSETolEo7R71Vk1u8bnjau5yw4= github.com/elazarl/go-bindata-assetfs v1.0.0/go.mod h1:v+YaWX3bdea5J/mo8dSETolEo7R71Vk1u8bnjau5yw4= github.com/elazarl/goproxy v0.0.0-20170405201442-c4fc26588b6e/go.mod h1:/Zj4wYkgs4iZTTu3o/KG3Itv/qCCa8VVMlb3i9OVuzc= github.com/emicklei/go-restful v0.0.0-20170410110728-ff4f55a20633/go.mod h1:otzb+WCGbkyDHkqmQmT5YD2WR4BBwUdeQoFo8l/7tVs= github.com/emicklei/go-restful v2.9.5+incompatible/go.mod h1:otzb+WCGbkyDHkqmQmT5YD2WR4BBwUdeQoFo8l/7tVs= github.com/envoyproxy/go-control-plane v0.0.0-20180919002855-2137d9196328/go.mod h1:SBwIajubJHhxtWwsL9s8ss4safvEdbitLhGGK48rN6g= github.com/envoyproxy/go-control-plane v0.9.0/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4= github.com/envoyproxy/go-control-plane v0.9.1-0.20191026205805-5f8ba28d4473/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4= github.com/envoyproxy/protoc-gen-validate v0.1.0/go.mod h1:iSmxcyjqTsJpI2R4NaDN7+kN2VEUnK/pcBlmesArF7c= github.com/erikstmartin/go-testdb v0.0.0-20160219214506-8d10e4a1bae5/go.mod h1:a2zkGnVExMxdzMo3M0Hi/3sEU+cWnZpSni0O6/Yb/P0= github.com/evanphx/json-patch v4.2.0+incompatible/go.mod h1:50XU6AFN0ol/bzJsmQLiYLvXMP4fmwYFNcr97nuDLSk= github.com/evanphx/json-patch v4.5.0+incompatible/go.mod h1:50XU6AFN0ol/bzJsmQLiYLvXMP4fmwYFNcr97nuDLSk= github.com/fatih/color v1.7.0/go.mod h1:Zm6kSWBoL9eyXnKyktHP6abPY2pDugNf5KwzbycvMj4= github.com/fatih/color v1.9.0/go.mod h1:eQcE1qtQxscV5RaZvpXrrb8Drkc3/DdQ+uUYCNjL+zU= github.com/fatih/color v1.10.0/go.mod h1:ELkj/draVOlAH/xkhN6mQ50Qd0MPOk5AAr3maGEBuJM= github.com/fatih/structs v0.0.0-20180123065059-ebf56d35bba7/go.mod h1:9NiDSp5zOcgEDl+j00MP/WkGVPOlPRLejGD8Ga6PJ7M= github.com/fatih/structtag v1.2.0/go.mod h1:mBJUNpUnHmRKrKlQQlmCrh5PuhftFbNv8Ys4/aAZl94= github.com/felixge/httpsnoop v1.0.1/go.mod h1:m8KPJKqk1gH5J9DgRY2ASl2lWCfGKXixSwevea8zH2U= github.com/fogleman/gg v1.3.0/go.mod h1:R/bRT+9gY/C5z7JzPU0zXsXHKM4/ayA+zqcVNZzPa1k= github.com/fsnotify/fsnotify v1.4.7/go.mod h1:jwhsz4b93w/PPRr/qN1Yymfu8t87LnFCMoQvtojpjFo= github.com/fsouza/fake-gcs-server v1.17.0/go.mod h1:D1rTE4YCyHFNa99oyJJ5HyclvN/0uQR+pM/VdlL83bw= github.com/gedex/inflector v0.0.0-20170307190818-16278e9db813 h1:Uc+IZ7gYqAf/rSGFplbWBSHaGolEQlNLgMgSE3ccnIQ= github.com/gedex/inflector v0.0.0-20170307190818-16278e9db813/go.mod h1:P+oSoE9yhSRvsmYyZsshflcR6ePWYLql6UU1amW13IM= github.com/ghodss/yaml v0.0.0-20150909031657-73d445a93680/go.mod h1:4dBDuWmgqj2HViK6kFavaiC9ZROes6MMH2rRYeMEF04= github.com/ghodss/yaml v1.0.0/go.mod h1:4dBDuWmgqj2HViK6kFavaiC9ZROes6MMH2rRYeMEF04= github.com/ghodss/yaml v1.0.1-0.20190212211648-25d852aebe32/go.mod h1:GIjDIg/heH5DOkXY3YJ/wNhfHsQHoXGjl8G8amsYQ1I= github.com/gin-contrib/gzip v0.0.1/go.mod h1:fGBJBCdt6qCZuCAOwWuFhBB4OOq9EFqlo5dEaFhhu5w= github.com/gin-contrib/sse v0.0.0-20170109093832-22d885f9ecc7/go.mod h1:VJ0WA2NBN22VlZ2dKZQPAPnyWw5XTlK1KymzLKsr59s= github.com/gin-contrib/sse v0.0.0-20190301062529-5545eab6dad3/go.mod h1:VJ0WA2NBN22VlZ2dKZQPAPnyWw5XTlK1KymzLKsr59s= github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI= github.com/gin-gonic/gin v1.3.0/go.mod h1:7cKuhb5qV2ggCFctp2fJQ+ErvciLZrIeoOSOm6mUr7Y= github.com/gin-gonic/gin v1.4.0/go.mod h1:OW2EZn3DO8Ln9oIKOvM++LBO+5UPHJJDH72/q/3rZdM= github.com/gin-gonic/gin v1.5.0/go.mod h1:Nd6IXA8m5kNZdNEHMBd93KT+mdY3+bewLgRvmCsR2Do= github.com/glendc/gopher-json v0.0.0-20170414221815-dc4743023d0c/go.mod h1:Gja1A+xZ9BoviGJNA2E9vFkPjjsl+CoJxSXiQM1UXtw= github.com/globalsign/mgo v0.0.0-20180905125535-1ca0a4f7cbcb/go.mod h1:xkRDCp4j0OGD1HRkm4kmhM+pmpv3AKq5SU7GMg4oO/Q= github.com/globalsign/mgo v0.0.0-20181015135952-eeefdecb41b8/go.mod h1:xkRDCp4j0OGD1HRkm4kmhM+pmpv3AKq5SU7GMg4oO/Q= github.com/go-bindata/go-bindata v3.1.2+incompatible/go.mod h1:xK8Dsgwmeed+BBsSy2XTopBn/8uK2HWuGSnA11C3Joo= github.com/go-chi/chi v4.0.2+incompatible/go.mod h1:eB3wogJHnLi3x/kFX2A+IbTBlXxmMeXJVKy9tTv1XzQ= github.com/go-critic/go-critic v0.3.5-0.20190904082202-d79a9f0c64db/go.mod h1:+sE8vrLDS2M0pZkBk0wy6+nLdKexVDrl/jBqQOTDThA= github.com/go-critic/go-critic v0.4.0/go.mod h1:7/14rZGnZbY6E38VEGk2kVhoq6itzc1E68facVDK23g= github.com/go-echarts/go-echarts v1.0.0/go.mod h1:qbmyAb/Rl1f2w7wKba1D4LoNq4U164yO4/wedFbcWyo= github.com/go-gl/glfw v0.0.0-20190409004039-e6da0acd62b1/go.mod h1:vR7hzQXu2zJy9AVAgeJqvqgH9Q5CA+iKCZ2gyEVpxRU= github.com/go-gl/glfw/v3.3/glfw v0.0.0-20191125211704-12ad95a8df72/go.mod h1:tQ2UAYgL5IevRw8kRxooKSPJfGvJ9fJQFa0TUsXzTg8= github.com/go-gl/glfw/v3.3/glfw v0.0.0-20200222043503-6f7a984d4dc4/go.mod h1:tQ2UAYgL5IevRw8kRxooKSPJfGvJ9fJQFa0TUsXzTg8= github.com/go-ini/ini v1.25.4/go.mod h1:ByCAeIL28uOIIG0E3PJtZPDL8WnHpFKFOtgjp+3Ies8= github.com/go-kit/kit v0.8.0/go.mod h1:xBxKIO96dXMWWy0MnWVtmwkA9/13aqxPnvrjFYMA2as= github.com/go-kit/kit v0.9.0/go.mod h1:xBxKIO96dXMWWy0MnWVtmwkA9/13aqxPnvrjFYMA2as= github.com/go-ldap/ldap v3.0.2+incompatible/go.mod h1:qfd9rJvER9Q0/D/Sqn1DfHRoBp40uXYvFoEVrNEPqRc= github.com/go-lintpack/lintpack v0.5.2/go.mod h1:NwZuYi2nUHho8XEIZ6SIxihrnPoqBTDqfpXvXAN0sXM= github.com/go-logfmt/logfmt v0.3.0/go.mod h1:Qt1PoO58o5twSAckw1HlFXLmHsOX5/0LbT9GBnD5lWE= github.com/go-logfmt/logfmt v0.4.0/go.mod h1:3RMwSq7FuexP4Kalkev3ejPJsZTpXXBr9+V4qmtdjCk= github.com/go-logr/logr v0.1.0/go.mod h1:ixOQHD9gLJUVQQ2ZOR7zLEifBX6tGkNJF4QyIY7sIas= github.com/go-martini/martini v0.0.0-20170121215854-22fa46961aab/go.mod h1:/P9AEU963A2AYjv4d1V5eVL1CQbEJq6aCNHDDjibzu8= github.com/go-ole/go-ole v1.2.1/go.mod h1:7FAglXiTm7HKlQRDeOQ6ZNUHidzCWXuZWq/1dTyBNF8= github.com/go-ole/go-ole v1.2.4 h1:nNBDSCOigTSiarFpYE9J/KtEA1IOW4CNeqT9TQDqCxI= github.com/go-ole/go-ole v1.2.4/go.mod h1:XCwSNxSkXRo4vlyPy93sltvi/qJq0jqQhjqQNIwKuxM= github.com/go-openapi/analysis v0.0.0-20180825180245-b006789cd277/go.mod h1:k70tL6pCuVxPJOHXQ+wIac1FUrvNkHolPie/cLEU6hI= github.com/go-openapi/analysis v0.17.0/go.mod h1:IowGgpVeD0vNm45So8nr+IcQ3pxVtpRoBWb8PVZO0ik= github.com/go-openapi/analysis v0.18.0/go.mod h1:IowGgpVeD0vNm45So8nr+IcQ3pxVtpRoBWb8PVZO0ik= github.com/go-openapi/analysis v0.19.2/go.mod h1:3P1osvZa9jKjb8ed2TPng3f0i/UY9snX6gxi44djMjk= github.com/go-openapi/analysis v0.19.5/go.mod h1:hkEAkxagaIvIP7VTn8ygJNkd4kAYON2rCu0v0ObL0AU= github.com/go-openapi/errors v0.17.0/go.mod h1:LcZQpmvG4wyF5j4IhA73wkLFQg+QJXOQHVjmcZxhka0= github.com/go-openapi/errors v0.18.0/go.mod h1:LcZQpmvG4wyF5j4IhA73wkLFQg+QJXOQHVjmcZxhka0= github.com/go-openapi/errors v0.19.2/go.mod h1:qX0BLWsyaKfvhluLejVpVNwNRdXZhEbTA4kxxpKBC94= github.com/go-openapi/jsonpointer v0.0.0-20160704185906-46af16f9f7b1/go.mod h1:+35s3my2LFTysnkMfxsJBAMHj/DoqoB9knIWoYG/Vk0= github.com/go-openapi/jsonpointer v0.17.0/go.mod h1:cOnomiV+CVVwFLk0A/MExoFMjwdsUdVpsRhURCKh+3M= github.com/go-openapi/jsonpointer v0.18.0/go.mod h1:cOnomiV+CVVwFLk0A/MExoFMjwdsUdVpsRhURCKh+3M= github.com/go-openapi/jsonpointer v0.19.2/go.mod h1:3akKfEdA7DF1sugOqz1dVQHBcuDBPKZGEoHC/NkiQRg= github.com/go-openapi/jsonpointer v0.19.3/go.mod h1:Pl9vOtqEWErmShwVjC8pYs9cog34VGT37dQOVbmoatg= github.com/go-openapi/jsonreference v0.0.0-20160704190145-13c6e3589ad9/go.mod h1:W3Z9FmVs9qj+KR4zFKmDPGiLdk1D9Rlm7cyMvf57TTg= github.com/go-openapi/jsonreference v0.17.0/go.mod h1:g4xxGn04lDIRh0GJb5QlpE3HfopLOL6uZrK/VgnsK9I= github.com/go-openapi/jsonreference v0.18.0/go.mod h1:g4xxGn04lDIRh0GJb5QlpE3HfopLOL6uZrK/VgnsK9I= github.com/go-openapi/jsonreference v0.19.0/go.mod h1:g4xxGn04lDIRh0GJb5QlpE3HfopLOL6uZrK/VgnsK9I= github.com/go-openapi/jsonreference v0.19.2/go.mod h1:jMjeRr2HHw6nAVajTXJ4eiUwohSTlpa0o73RUL1owJc= github.com/go-openapi/jsonreference v0.19.3/go.mod h1:rjx6GuL8TTa9VaixXglHmQmIL98+wF9xc8zWvFonSJ8= github.com/go-openapi/loads v0.17.0/go.mod h1:72tmFy5wsWx89uEVddd0RjRWPZm92WRLhf7AC+0+OOU= github.com/go-openapi/loads v0.18.0/go.mod h1:72tmFy5wsWx89uEVddd0RjRWPZm92WRLhf7AC+0+OOU= github.com/go-openapi/loads v0.19.0/go.mod h1:72tmFy5wsWx89uEVddd0RjRWPZm92WRLhf7AC+0+OOU= github.com/go-openapi/loads v0.19.2/go.mod h1:QAskZPMX5V0C2gvfkGZzJlINuP7Hx/4+ix5jWFxsNPs= github.com/go-openapi/loads v0.19.4/go.mod h1:zZVHonKd8DXyxyw4yfnVjPzBjIQcLt0CCsn0N0ZrQsk= github.com/go-openapi/runtime v0.0.0-20180920151709-4f900dc2ade9/go.mod h1:6v9a6LTXWQCdL8k1AO3cvqx5OtZY/Y9wKTgaoP6YRfA= github.com/go-openapi/runtime v0.19.0/go.mod h1:OwNfisksmmaZse4+gpV3Ne9AyMOlP1lt4sK4FXt0O64= github.com/go-openapi/runtime v0.19.4/go.mod h1:X277bwSUBxVlCYR3r7xgZZGKVvBd/29gLDlFGtJ8NL4= github.com/go-openapi/spec v0.0.0-20160808142527-6aced65f8501/go.mod h1:J8+jY1nAiCcj+friV/PDoE1/3eeccG9LYBs0tYvLOWc= github.com/go-openapi/spec v0.17.0/go.mod h1:XkF/MOi14NmjsfZ8VtAKf8pIlbZzyoTvZsdfssdxcBI= github.com/go-openapi/spec v0.18.0/go.mod h1:XkF/MOi14NmjsfZ8VtAKf8pIlbZzyoTvZsdfssdxcBI= github.com/go-openapi/spec v0.19.0/go.mod h1:XkF/MOi14NmjsfZ8VtAKf8pIlbZzyoTvZsdfssdxcBI= github.com/go-openapi/spec v0.19.2/go.mod h1:sCxk3jxKgioEJikev4fgkNmwS+3kuYdJtcsZsD5zxMY= github.com/go-openapi/spec v0.19.3/go.mod h1:FpwSN1ksY1eteniUU7X0N/BgJ7a4WvBFVA8Lj9mJglo= github.com/go-openapi/spec v0.19.4/go.mod h1:FpwSN1ksY1eteniUU7X0N/BgJ7a4WvBFVA8Lj9mJglo= github.com/go-openapi/strfmt v0.17.0/go.mod h1:P82hnJI0CXkErkXi8IKjPbNBM6lV6+5pLP5l494TcyU= github.com/go-openapi/strfmt v0.18.0/go.mod h1:P82hnJI0CXkErkXi8IKjPbNBM6lV6+5pLP5l494TcyU= github.com/go-openapi/strfmt v0.19.0/go.mod h1:+uW+93UVvGGq2qGaZxdDeJqSAqBqBdl+ZPMF/cC8nDY= github.com/go-openapi/strfmt v0.19.3/go.mod h1:0yX7dbo8mKIvc3XSKp7MNfxw4JytCfCD6+bY1AVL9LU= github.com/go-openapi/swag v0.0.0-20160704191624-1d0bd113de87/go.mod h1:DXUve3Dpr1UfpPtxFw+EFuQ41HhCWZfha5jSVRG7C7I= github.com/go-openapi/swag v0.17.0/go.mod h1:AByQ+nYG6gQg71GINrmuDXCPWdL640yX49/kXLo40Tg= github.com/go-openapi/swag v0.18.0/go.mod h1:AByQ+nYG6gQg71GINrmuDXCPWdL640yX49/kXLo40Tg= github.com/go-openapi/swag v0.19.2/go.mod h1:POnQmlKehdgb5mhVOsnJFsivZCEZ/vjK9gh66Z9tfKk= github.com/go-openapi/swag v0.19.5/go.mod h1:POnQmlKehdgb5mhVOsnJFsivZCEZ/vjK9gh66Z9tfKk= github.com/go-openapi/validate v0.18.0/go.mod h1:Uh4HdOzKt19xGIGm1qHf/ofbX1YQ4Y+MYsct2VUrAJ4= github.com/go-openapi/validate v0.19.2/go.mod h1:1tRCw7m3jtI8eNWEEliiAqUIcBztB2KDnRCRMUi7GTA= github.com/go-openapi/validate v0.19.5/go.mod h1:8DJv2CVJQ6kGNpFW6eV9N3JviE1C85nY1c2z52x1Gk4= github.com/go-playground/locales v0.12.1/go.mod h1:IUMDtCfWo/w/mtMfIE/IG2K+Ey3ygWanZIBtBW0W2TM= github.com/go-playground/locales v0.13.0/go.mod h1:taPMhCMXrRLJO55olJkUXHZBHCxTMfnGwq/HNwmWNS8= github.com/go-playground/overalls v0.0.0-20180201144345-22ec1a223b7c/go.mod h1:UqxAgEOt89sCiXlrc/ycnx00LVvUO/eS8tMUkWX4R7w= github.com/go-playground/universal-translator v0.16.0/go.mod h1:1AnU7NaIRDWWzGEKwgtJRd2xk99HeFyHw3yid4rvQIY= github.com/go-playground/universal-translator v0.17.0/go.mod h1:UkSxE5sNxxRwHyU+Scu5vgOQjsIJAF8j9muTVoKLVtA= github.com/go-redis/redis v6.14.2+incompatible/go.mod h1:NAIEuMOZ/fxfXJIrKDQDz8wamY7mA7PouImQ2Jvg6kA= github.com/go-sql-driver/mysql v1.3.0/go.mod h1:zAC/RDZ24gD3HViQzih4MyKcchzm+sOG5ZlKdlhCg5w= github.com/go-sql-driver/mysql v1.4.1/go.mod h1:zAC/RDZ24gD3HViQzih4MyKcchzm+sOG5ZlKdlhCg5w= github.com/go-sql-driver/mysql v1.5.0/go.mod h1:DCzpHaOWr8IXmIStZouvnhqoel9Qv2LBy8hT2VhHyBg= github.com/go-sql-driver/mysql v1.6.0 h1:BCTh4TKNUYmOmMUcQ3IipzF5prigylS7XXjEkfCHuOE= github.com/go-sql-driver/mysql v1.6.0/go.mod h1:DCzpHaOWr8IXmIStZouvnhqoel9Qv2LBy8hT2VhHyBg= github.com/go-stack/stack v1.8.0/go.mod h1:v0f6uXyyMGvRgIKkXu+yp6POWl0qKG85gN/melR3HDY= github.com/go-test/deep v1.0.1/go.mod h1:wGDj63lr65AM2AQyKZd/NYHGb0R+1RLqB8NKt3aSFNA= github.com/go-toolsmith/astcast v1.0.0/go.mod h1:mt2OdQTeAQcY4DQgPSArJjHCcOwlX+Wl/kwN+LbLGQ4= github.com/go-toolsmith/astcopy v1.0.0/go.mod h1:vrgyG+5Bxrnz4MZWPF+pI4R8h3qKRjjyvV/DSez4WVQ= github.com/go-toolsmith/astequal v0.0.0-20180903214952-dcb477bfacd6/go.mod h1:H+xSiq0+LtiDC11+h1G32h7Of5O3CYFJ99GVbS5lDKY= github.com/go-toolsmith/astequal v1.0.0/go.mod h1:H+xSiq0+LtiDC11+h1G32h7Of5O3CYFJ99GVbS5lDKY= github.com/go-toolsmith/astfmt v0.0.0-20180903215011-8f8ee99c3086/go.mod h1:mP93XdblcopXwlyN4X4uodxXQhldPGZbcEJIimQHrkg= github.com/go-toolsmith/astfmt v1.0.0/go.mod h1:cnWmsOAuq4jJY6Ct5YWlVLmcmLMn1JUPuQIHCY7CJDw= github.com/go-toolsmith/astinfo v0.0.0-20180906194353-9809ff7efb21/go.mod h1:dDStQCHtmZpYOmjRP/8gHHnCCch3Zz3oEgCdZVdtweU= github.com/go-toolsmith/astp v0.0.0-20180903215135-0af7e3c24f30/go.mod h1:SV2ur98SGypH1UjcPpCatrV5hPazG6+IfNHbkDXBRrk= github.com/go-toolsmith/astp v1.0.0/go.mod h1:RSyrtpVlfTFGDYRbrjyWP1pYu//tSFcvdYrA8meBmLI= github.com/go-toolsmith/pkgload v0.0.0-20181119091011-e9e65178eee8/go.mod h1:WoMrjiy4zvdS+Bg6z9jZH82QXwkcgCBX6nOfnmdaHks= github.com/go-toolsmith/pkgload v1.0.0/go.mod h1:5eFArkbO80v7Z0kdngIxsRXRMTaX4Ilcwuh3clNrQJc= github.com/go-toolsmith/strparse v1.0.0/go.mod h1:YI2nUKP9YGZnL/L1/DLFBfixrcjslWct4wyljWhSRy8= github.com/go-toolsmith/typep v1.0.0/go.mod h1:JSQCQMUPdRlMZFswiq3TGpNp1GMktqkR2Ns5AIQkATU= github.com/go-yaml/yaml v2.1.0+incompatible/go.mod h1:w2MrLa16VYP0jy6N7M5kHaCkaLENm+P+Tv+MfurjSw0= github.com/gobwas/glob v0.2.3/go.mod h1:d3Ez4x06l9bZtSvzIay5+Yzi0fmZzPgnTbPcKjJAkT8= github.com/goccy/go-graphviz v0.0.5/go.mod h1:wXVsXxmyMQU6TN3zGRttjNn3h+iCAS7xQFC6TlNvLhk= github.com/gocql/gocql v0.0.0-20180617115710-e06f8c1bcd78/go.mod h1:4Fw1eo5iaEhDUs8XyuhSVCVy52Jq3L+/3GJgYkwc+/0= github.com/gofrs/flock v0.0.0-20190320160742-5135e617513b/go.mod h1:F1TvTiK9OcQqauNUHlbJvyl9Qa1QvF/gOUDKA14jxHU= github.com/gogo/googleapis v1.1.0/go.mod h1:gf4bu3Q80BeJ6H1S1vYPm8/ELATdvryBaNFGgqEef3s= github.com/gogo/protobuf v0.0.0-20171007142547-342cbe0a0415/go.mod h1:r8qH/GZQm5c6nD/R0oafs1akxWv10x8SbQlK7atdtwQ= github.com/gogo/protobuf v0.0.0-20180717141946-636bf0302bc9/go.mod h1:r8qH/GZQm5c6nD/R0oafs1akxWv10x8SbQlK7atdtwQ= github.com/gogo/protobuf v1.1.1/go.mod h1:r8qH/GZQm5c6nD/R0oafs1akxWv10x8SbQlK7atdtwQ= github.com/gogo/protobuf v1.2.1/go.mod h1:hp+jE20tsWTFYpLwKvXlhS1hjn+gTNwPg2I6zVXpSg4= github.com/gogo/protobuf v1.2.2-0.20190723190241-65acae22fc9d/go.mod h1:SlYgWuQ5SjCEi6WLHjHCa1yvBfUnHcTbrrZtXPKa29o= github.com/gogo/protobuf v1.3.1/go.mod h1:SlYgWuQ5SjCEi6WLHjHCa1yvBfUnHcTbrrZtXPKa29o= github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q= github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q= github.com/golang-sql/civil v0.0.0-20190719163853-cb61b32ac6fe/go.mod h1:8vg3r2VgvsThLBIFL93Qb5yWzgyZWhEmBwUJWevAkK0= github.com/golang/freetype v0.0.0-20170609003504-e2365dfdc4a0/go.mod h1:E/TSTwGwJL78qG/PmXZO1EjYhfJinVAhrmmHX6Z8B9k= github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b h1:VKtxabqXZkF25pY9ekfRL6a582T4P37/31XEstQ5p58= github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b/go.mod h1:SBH7ygxi8pfUlaOkMMuAQtPIUF8ecWP5IEl/CR7VP2Q= github.com/golang/groupcache v0.0.0-20160516000752-02826c3e7903/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= github.com/golang/groupcache v0.0.0-20181024230925-c65c006176ff/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= github.com/golang/groupcache v0.0.0-20190129154638-5b532d6fd5ef/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= github.com/golang/groupcache v0.0.0-20190702054246-869f871628b6/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= github.com/golang/groupcache v0.0.0-20191227052852-215e87163ea7/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= github.com/golang/groupcache v0.0.0-20200121045136-8c9f03a8e57e/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= github.com/golang/lint v0.0.0-20180702182130-06c8688daad7/go.mod h1:tluoj9z5200jBnyusfRPU2LqT6J+DAorxEvtC7LHB+E= github.com/golang/mock v1.1.1/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A= github.com/golang/mock v1.2.0/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A= github.com/golang/mock v1.3.1/go.mod h1:sBzyDLLjw3U8JLTeZvSv8jJB+tU5PVekmnlKIyFUx0Y= github.com/golang/mock v1.4.0/go.mod h1:UOMv5ysSaYNkG+OFQykRIcU/QvvxJf3p21QfJ2Bt3cw= github.com/golang/mock v1.4.3/go.mod h1:UOMv5ysSaYNkG+OFQykRIcU/QvvxJf3p21QfJ2Bt3cw= github.com/golang/protobuf v0.0.0-20161109072736-4bd1920723d7/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= github.com/golang/protobuf v0.0.0-20180814211427-aa810b61a9c7/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= github.com/golang/protobuf v1.1.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= github.com/golang/protobuf v1.3.3/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw= github.com/golang/protobuf v1.3.4/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw= github.com/golang/protobuf v1.4.0-rc.1/go.mod h1:ceaxUfeHdC40wWswd/P6IGgMaK3YpKi5j83Wpe3EHw8= github.com/golang/protobuf v1.4.0-rc.1.0.20200221234624-67d41d38c208/go.mod h1:xKAWHe0F5eneWXFV3EuXVDTCmh+JuBKY0li0aMyXATA= github.com/golang/protobuf v1.4.0-rc.2/go.mod h1:LlEzMj4AhA7rCAGe4KMBDvJI+AwstrUpVNzEA03Pprs= github.com/golang/protobuf v1.4.0-rc.4.0.20200313231945-b860323f09d0/go.mod h1:WU3c8KckQ9AFe+yFwt9sWVRKCVIyN9cPHBJSNnbL67w= github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvqG2KuDX0= github.com/golang/protobuf v1.4.2 h1:+Z5KGCizgyZCbGh1KZqA0fcLLkwbsjIzS4aV2v7wJX0= github.com/golang/protobuf v1.4.2/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI= github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk= github.com/golang/protobuf v1.5.2 h1:ROPKBNFfQgOUMifHyP+KYbvpjbdoFNs+aK7DXlji0Tw= github.com/golang/protobuf v1.5.2/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY= github.com/golang/snappy v0.0.0-20170215233205-553a64147049/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q= github.com/golang/snappy v0.0.0-20180518054509-2e65f85255db/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q= github.com/golang/snappy v0.0.1/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q= github.com/golang/snappy v0.0.2-0.20190904063534-ff6b7dc882cf/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q= github.com/golangci/check v0.0.0-20180506172741-cfe4005ccda2/go.mod h1:k9Qvh+8juN+UKMCS/3jFtGICgW8O96FVaZsaxdzDkR4= github.com/golangci/dupl v0.0.0-20180902072040-3e9179ac440a/go.mod h1:ryS0uhF+x9jgbj/N71xsEqODy9BN81/GonCZiOzirOk= github.com/golangci/errcheck v0.0.0-20181223084120-ef45e06d44b6/go.mod h1:DbHgvLiFKX1Sh2T1w8Q/h4NAI8MHIpzCdnBUDTXU3I0= github.com/golangci/go-misc v0.0.0-20180628070357-927a3d87b613/go.mod h1:SyvUF2NxV+sN8upjjeVYr5W7tyxaT1JVtvhKhOn2ii8= github.com/golangci/goconst v0.0.0-20180610141641-041c5f2b40f3/go.mod h1:JXrF4TWy4tXYn62/9x8Wm/K/dm06p8tCKwFRDPZG/1o= github.com/golangci/gocyclo v0.0.0-20180528134321-2becd97e67ee/go.mod h1:ozx7R9SIwqmqf5pRP90DhR2Oay2UIjGuKheCBCNwAYU= github.com/golangci/gocyclo v0.0.0-20180528144436-0a533e8fa43d/go.mod h1:ozx7R9SIwqmqf5pRP90DhR2Oay2UIjGuKheCBCNwAYU= github.com/golangci/gofmt v0.0.0-20190930125516-244bba706f1a/go.mod h1:9qCChq59u/eW8im404Q2WWTrnBUQKjpNYKMbU4M7EFU= github.com/golangci/golangci-lint v1.21.0/go.mod h1:phxpHK52q7SE+5KpPnti4oZTdFCEsn/tKN+nFvCKXfk= github.com/golangci/ineffassign v0.0.0-20190609212857-42439a7714cc/go.mod h1:e5tpTHCfVze+7EpLEozzMB3eafxo2KT5veNg1k6byQU= github.com/golangci/lint-1 v0.0.0-20191013205115-297bf364a8e0/go.mod h1:66R6K6P6VWk9I95jvqGxkqJxVWGFy9XlDwLwVz1RCFg= github.com/golangci/maligned v0.0.0-20180506175553-b1d89398deca/go.mod h1:tvlJhZqDe4LMs4ZHD0oMUlt9G2LWuDGoisJTBzLMV9o= github.com/golangci/misspell v0.0.0-20180809174111-950f5d19e770/go.mod h1:dEbvlSfYbMQDtrpRMQU675gSDLDNa8sCPPChZ7PhiVA= github.com/golangci/prealloc v0.0.0-20180630174525-215b22d4de21/go.mod h1:tf5+bzsHdTM0bsB7+8mt0GUMvjCgwLpTapNZHU8AajI= github.com/golangci/revgrep v0.0.0-20180526074752-d9c87f5ffaf0/go.mod h1:qOQCunEYvmd/TLamH+7LlVccLvUH5kZNhbCgTHoBbp4= github.com/golangci/revgrep v0.0.0-20180812185044-276a5c0a1039/go.mod h1:qOQCunEYvmd/TLamH+7LlVccLvUH5kZNhbCgTHoBbp4= github.com/golangci/unconvert v0.0.0-20180507085042-28b1c447d1f4/go.mod h1:Izgrg8RkN3rCIMLGE9CyYmU9pY2Jer6DgANEnZ/L/cQ= github.com/gomodule/redigo v2.0.0+incompatible/go.mod h1:B4C85qUVwatsJoIUNIfCRsp7qO0iAmpGFZ4EELWSbC4= github.com/google/btree v0.0.0-20180813153112-4030bb1f1f0c/go.mod h1:lNA+9X1NB3Zf8V7Ke586lFgjr2dZNuvo3lPJSGZ5JPQ= github.com/google/btree v1.0.0/go.mod h1:lNA+9X1NB3Zf8V7Ke586lFgjr2dZNuvo3lPJSGZ5JPQ= github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M= github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-github/v27 v27.0.4/go.mod h1:/0Gr8pJ55COkmv+S/yPKCczSkUPIM/LnFyubufRNIS0= github.com/google/go-querystring v1.0.0/go.mod h1:odCYkC5MyYFN7vkCjXpyrEuKhc/BUO6wN/zVPAxq5ck= github.com/google/gofuzz v0.0.0-20161122191042-44d81051d367/go.mod h1:HP5RmnzzSNb993RKQDq4+1A4ia9nllfqcQFTQJedwGI= github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= github.com/google/martian v2.1.0+incompatible/go.mod h1:9I4somxYTbIHy5NJKHRl3wXiIaQGbYVAs8BPL6v8lEs= github.com/google/pprof v0.0.0-20181206194817-3ea8567a2e57/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc= github.com/google/pprof v0.0.0-20190515194954-54271f7e092f/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc= github.com/google/pprof v0.0.0-20190930153522-6ce02741cba3/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc= github.com/google/pprof v0.0.0-20191218002539-d4f498aebedc/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM= github.com/google/pprof v0.0.0-20200212024743-f11f1df84d12/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM= github.com/google/pprof v0.0.0-20200407044318-7d83b28da2e9/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM= github.com/google/renameio v0.1.0/go.mod h1:KWCgfxg9yswjAJkECMjeO8J8rahYeXnNhOm40UhjYkI= github.com/google/shlex v0.0.0-20181106134648-c34317bd91bf/go.mod h1:RpwtwJQFrIEPstU94h88MWPXP2ektJZ8cZ0YntAmXiE= github.com/google/shlex v0.0.0-20191202100458-e7afc7fbc510/go.mod h1:pupxD2MaaD3pAXIBCelhxNneeOaAeabZDe5s4K6zSpQ= github.com/google/uuid v1.0.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/google/uuid v1.1.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/googleapis/gax-go/v2 v2.0.4/go.mod h1:0Wqv26UfaUD9n4G6kQubkQ+KchISgw+vpHVxEJEs9eg= github.com/googleapis/gax-go/v2 v2.0.5/go.mod h1:DWXyrwAJ9X0FpwwEdw+IPEYBICEFu5mhpdKc/us6bOk= github.com/googleapis/gnostic v0.0.0-20170729233727-0c5108395e2d/go.mod h1:sJBsCZ4ayReDTBIg8b9dl28c5xFWyhBTVRp3pOg5EKY= github.com/googleapis/gnostic v0.2.0/go.mod h1:sJBsCZ4ayReDTBIg8b9dl28c5xFWyhBTVRp3pOg5EKY= github.com/gophercloud/gophercloud v0.1.0/go.mod h1:vxM41WHh5uqHVBMZHzuwNOHh8XEoIEcSTewFxm1c5g8= github.com/gopherjs/gopherjs v0.0.0-20181017120253-0766667cb4d1/go.mod h1:wJfORRmW1u3UXTncJ5qlYoELFm8eSnnEO6hX4iZ3EWY= github.com/gopherjs/gopherjs v0.0.0-20181103185306-d547d1d9531e/go.mod h1:wJfORRmW1u3UXTncJ5qlYoELFm8eSnnEO6hX4iZ3EWY= github.com/gorilla/handlers v1.4.2/go.mod h1:Qkdc/uu4tH4g6mTK6auzZ766c4CA0Ng8+o/OAirnOIQ= github.com/gorilla/handlers v1.5.1/go.mod h1:t8XrUpc4KVXb7HGyJ4/cEnwQiaxrX/hz1Zv/4g96P1Q= github.com/gorilla/mux v1.7.3/go.mod h1:1lud6UwP+6orDFRuTfBEV8e9/aOM/c4fVVCaMa2zaAs= github.com/gorilla/mux v1.7.4/go.mod h1:DVbg23sWSpFRCP0SfiEN6jmj59UnW/n46BH5rLB71So= github.com/gorilla/mux v1.8.0/go.mod h1:DVbg23sWSpFRCP0SfiEN6jmj59UnW/n46BH5rLB71So= github.com/gorilla/websocket v0.0.0-20170926233335-4201258b820c/go.mod h1:E7qHFY5m1UJ88s3WnNqhKjPHQ0heANvMoAMk2YaljkQ= github.com/gorilla/websocket v1.2.0/go.mod h1:E7qHFY5m1UJ88s3WnNqhKjPHQ0heANvMoAMk2YaljkQ= github.com/gorilla/websocket v1.4.0/go.mod h1:E7qHFY5m1UJ88s3WnNqhKjPHQ0heANvMoAMk2YaljkQ= github.com/gorilla/websocket v1.4.2/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= github.com/gostaticanalysis/analysisutil v0.0.0-20190318220348-4088753ea4d3/go.mod h1:eEOZF4jCKGi+aprrirO9e7WKB3beBRtWgqGunKl6pKE= github.com/gostaticanalysis/analysisutil v0.0.3/go.mod h1:eEOZF4jCKGi+aprrirO9e7WKB3beBRtWgqGunKl6pKE= github.com/gotestyourself/gotestyourself v2.2.0+incompatible/go.mod h1:zZKM6oeNM8k+FRljX1mnzVYeS8wiGgQyvST1/GafPbY= github.com/gregjones/httpcache v0.0.0-20180305231024-9cad4c3443a7/go.mod h1:FecbI9+v66THATjSRHfNgh1IVFe/9kFxbXtjV0ctIMA= github.com/grpc-ecosystem/go-grpc-middleware v1.0.0/go.mod h1:FiyG127CGDf3tlThmgyCl78X/SZQqEOJBCDaAfeWzPs= github.com/grpc-ecosystem/go-grpc-middleware v1.0.1-0.20190118093823-f849b5445de4/go.mod h1:FiyG127CGDf3tlThmgyCl78X/SZQqEOJBCDaAfeWzPs= github.com/grpc-ecosystem/go-grpc-middleware v1.1.0 h1:THDBEeQ9xZ8JEaCLyLQqXMMdRqNr0QAUJTIkQAUtFjg= github.com/grpc-ecosystem/go-grpc-middleware v1.1.0/go.mod h1:f5nM7jw/oeRSadq3xCzHAvxcr8HZnzsqU6ILg/0NiiE= github.com/grpc-ecosystem/go-grpc-prometheus v1.2.0/go.mod h1:8NvIoxWQoOIhqOTXgfV/d3M/q6VIi02HzZEHgUlZvzk= github.com/grpc-ecosystem/grpc-gateway v1.9.0/go.mod h1:vNeuVxBJEsws4ogUvrchl83t/GYV9WGTSLVdBhOQFDY= github.com/grpc-ecosystem/grpc-gateway v1.9.5/go.mod h1:vNeuVxBJEsws4ogUvrchl83t/GYV9WGTSLVdBhOQFDY= github.com/grpc-ecosystem/grpc-gateway v1.12.1/go.mod h1:8XEsbTttt/W+VvjtQhLACqCisSPWTxCZ7sBRjU6iH9c= github.com/gtank/cryptopasta v0.0.0-20170601214702-1f550f6f2f69/go.mod h1:YLEMZOtU+AZ7dhN9T/IpGhXVGly2bvkJQ+zxj3WeVQo= github.com/hailocab/go-hostpool v0.0.0-20160125115350-e80d13ce29ed/go.mod h1:tMWxXQ9wFIaZeTI9F+hmhFiGpFmhOHzyShyFUhRm0H4= github.com/hashicorp/consul v1.4.5/go.mod h1:mFrjN1mfidgJfYP1xrJCF+AfRhr6Eaqhb2+sfyn/OOI= github.com/hashicorp/consul/api v1.1.0/go.mod h1:VmuI/Lkw1nC05EYQWNKwWGbkg+FbDBtguAZLlVdkD9Q= github.com/hashicorp/consul/api v1.5.0/go.mod h1:LqwrLNW876eYSuUOo4ZLHBcdKc038txr/IMfbLPATa4= github.com/hashicorp/consul/sdk v0.1.1/go.mod h1:VKf9jXwCTEY1QZP2MOLRhb5i/I/ssyNV1vwHyQBF0x8= github.com/hashicorp/consul/sdk v0.5.0/go.mod h1:fY08Y9z5SvJqevyZNy6WWPXiG3KwBPAvlcdx16zZ0fM= github.com/hashicorp/errwrap v1.0.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4= github.com/hashicorp/go-bexpr v0.1.0/go.mod h1:ANbpTX1oAql27TZkKVeW8p1w8NTdnyzPe/0qqPCKohU= github.com/hashicorp/go-checkpoint v0.0.0-20171009173528-1545e56e46de/go.mod h1:xIwEieBHERyEvaeKF/TcHh1Hu+lxPM+n2vT1+g9I4m4= github.com/hashicorp/go-cleanhttp v0.5.0/go.mod h1:JpRdi6/HCYpAwUzNwuwqhbovhLtngrth3wmdIIUrZ80= github.com/hashicorp/go-cleanhttp v0.5.1/go.mod h1:JpRdi6/HCYpAwUzNwuwqhbovhLtngrth3wmdIIUrZ80= github.com/hashicorp/go-hclog v0.0.0-20180402200405-69ff559dc25f/go.mod h1:9bjs9uLqI8l75knNv3lV1kA55veR+WUPSiKIWcQHudI= github.com/hashicorp/go-hclog v0.12.0/go.mod h1:whpDNt7SSdeAju8AWKIWsul05p54N/39EeqMAyrmvFQ= github.com/hashicorp/go-immutable-radix v1.0.0/go.mod h1:0y9vanUI8NX6FsYoO3zeMjhV/C5i9g4Q3DwcSNZ4P60= github.com/hashicorp/go-immutable-radix v1.1.0/go.mod h1:0y9vanUI8NX6FsYoO3zeMjhV/C5i9g4Q3DwcSNZ4P60= github.com/hashicorp/go-memdb v0.0.0-20180223233045-1289e7fffe71/go.mod h1:kbfItVoBJwCfKXDXN4YoAXjxcFVZ7MRrJzyTX6H4giE= github.com/hashicorp/go-msgpack v0.5.3/go.mod h1:ahLV/dePpqEmjfWmKiqvPkv/twdG7iPBM1vqhUKIvfM= github.com/hashicorp/go-msgpack v0.5.5/go.mod h1:ahLV/dePpqEmjfWmKiqvPkv/twdG7iPBM1vqhUKIvfM= github.com/hashicorp/go-multierror v1.0.0/go.mod h1:dHtQlpGsu+cZNNAkkCN/P3hoUDHhCYQXV3UM06sGGrk= github.com/hashicorp/go-multierror v1.1.0/go.mod h1:spPvp8C1qA32ftKqdAHm4hHTbPw+vmowP0z+KUhOZdA= github.com/hashicorp/go-plugin v0.0.0-20180331002553-e8d22c780116/go.mod h1:JSqWYsict+jzcj0+xElxyrBQRPNoiWQuddnxArJ7XHQ= github.com/hashicorp/go-retryablehttp v0.5.3/go.mod h1:9B5zBasrRhHXnJnui7y6sL7es7NDiJgTc6Er0maI1Xs= github.com/hashicorp/go-rootcerts v1.0.0/go.mod h1:K6zTfqpRlCUIjkwsN4Z+hiSfzSTQa6eBIzfwKfwNnHU= github.com/hashicorp/go-rootcerts v1.0.2/go.mod h1:pqUvnprVnM5bf7AOirdbb01K4ccR319Vf4pU3K5EGc8= github.com/hashicorp/go-sockaddr v1.0.0/go.mod h1:7Xibr9yA9JjQq1JpNB2Vw7kxv8xerXegt+ozgdvDeDU= github.com/hashicorp/go-sockaddr v1.0.2/go.mod h1:rB4wwRAUzs07qva3c5SdrY/NEtAUjGlgmH/UkBUC97A= github.com/hashicorp/go-syslog v1.0.0/go.mod h1:qPfqrKkXGihmCqbJM2mZgkZGvKG1dFdvsLplgctolz4= github.com/hashicorp/go-uuid v0.0.0-20180228145832-27454136f036/go.mod h1:6SBZvOh/SIDV7/2o3Jml5SYk/TvGqwFJ/bN7x4byOro= github.com/hashicorp/go-uuid v1.0.0/go.mod h1:6SBZvOh/SIDV7/2o3Jml5SYk/TvGqwFJ/bN7x4byOro= github.com/hashicorp/go-uuid v1.0.1/go.mod h1:6SBZvOh/SIDV7/2o3Jml5SYk/TvGqwFJ/bN7x4byOro= github.com/hashicorp/go-uuid v1.0.2/go.mod h1:6SBZvOh/SIDV7/2o3Jml5SYk/TvGqwFJ/bN7x4byOro= github.com/hashicorp/go-version v0.0.0-20170202080759-03c5bf6be031/go.mod h1:fltr4n8CU8Ke44wwGCBoEymUuxUHl09ZGVZPK5anwXA= github.com/hashicorp/go.net v0.0.1/go.mod h1:hjKkEWcCURg++eb33jQU7oqQcI9XDCnUzHA0oac0k90= github.com/hashicorp/golang-lru v0.5.0/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8= github.com/hashicorp/golang-lru v0.5.1/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8= github.com/hashicorp/golang-lru v0.5.3/go.mod h1:iADmTwqILo4mZ8BN3D2Q6+9jd8WM5uGBxy+E8yxSoD4= github.com/hashicorp/golang-lru v0.5.4/go.mod h1:iADmTwqILo4mZ8BN3D2Q6+9jd8WM5uGBxy+E8yxSoD4= github.com/hashicorp/hcl v1.0.0/go.mod h1:E5yfLk+7swimpb2L/Alb/PJmXilQ/rhwaUYs4T20WEQ= github.com/hashicorp/hil v0.0.0-20160711231837-1e86c6b523c5/go.mod h1:KHvg/R2/dPtaePb16oW4qIyzkMxXOL38xjRN64adsts= github.com/hashicorp/logutils v1.0.0/go.mod h1:QIAnNjmIWmVIIkWDTG1z5v++HQmx9WQRO+LraFDTW64= github.com/hashicorp/mdns v1.0.0/go.mod h1:tL+uN++7HEJ6SQLQ2/p+z2pH24WQKWjBPkE0mNTz8vQ= github.com/hashicorp/mdns v1.0.1/go.mod h1:4gW7WsVCke5TE7EPeYliwHlRUyBtfCwuFwuMg2DmyNY= github.com/hashicorp/memberlist v0.1.3/go.mod h1:ajVTdAv/9Im8oMAAj5G31PhhMCZJV2pPBoIllUwCN7I= github.com/hashicorp/memberlist v0.1.4/go.mod h1:ajVTdAv/9Im8oMAAj5G31PhhMCZJV2pPBoIllUwCN7I= github.com/hashicorp/memberlist v0.2.0/go.mod h1:MS2lj3INKhZjWNqd3N0m3J+Jxf3DAOnAH9VT3Sh9MUE= github.com/hashicorp/memberlist v0.2.2/go.mod h1:MS2lj3INKhZjWNqd3N0m3J+Jxf3DAOnAH9VT3Sh9MUE= github.com/hashicorp/net-rpc-msgpackrpc v0.0.0-20151116020338-a14192a58a69/go.mod h1:/z+jUGRBlwVpUZfjute9jWaF6/HuhjuFQuL1YXzVD1Q= github.com/hashicorp/raft v1.0.1-0.20190409200437-d9fe23f7d472/go.mod h1:DVSAWItjLjTOkVbSpWQ0j0kUADIvDaCtBxIcbNAQLkI= github.com/hashicorp/raft-boltdb v0.0.0-20150201200839-d1e82c1ec3f1/go.mod h1:pNv7Wc3ycL6F5oOWn+tPGo2gWD4a5X+yp/ntwdKLjRk= github.com/hashicorp/serf v0.8.2/go.mod h1:6hOLApaqBFA1NXqRQAsxw9QxuDEvNxSQRwA/JwenrHc= github.com/hashicorp/serf v0.8.5/go.mod h1:UpNcs7fFbpKIyZaUuSW6EPiH+eZC7OuyFD+wc1oal+k= github.com/hashicorp/serf v0.9.0/go.mod h1:YL0HO+FifKOW2u1ke99DGVu1zhcpZzNwrLIqBC7vbYU= github.com/hashicorp/serf v0.9.2/go.mod h1:UWDWwZeL5cuWDJdl0C6wrvrUwEqtQ4ZKBKKENpqIUyk= github.com/hashicorp/vault v0.10.3/go.mod h1:KfSyffbKxoVyspOdlaGVjIuwLobi07qD1bAbosPMpP0= github.com/hashicorp/vault-plugin-secrets-kv v0.0.0-20190318174639-195e0e9d07f1/go.mod h1:VJHHT2SC1tAPrfENQeBhLlb5FbZoKZM+oC/ROmEftz0= github.com/hashicorp/vic v1.5.1-0.20190403131502-bbfe86ec9443/go.mod h1:bEpDU35nTu0ey1EXjwNwPjI9xErAsoOCmcMb9GKvyxo= github.com/hashicorp/yamux v0.0.0-20181012175058-2f1d1f20f75d/go.mod h1:+NfK9FKeTrX5uv1uIXGdwYDTeHna2qgaIlx54MXqjAM= github.com/howeyc/gopass v0.0.0-20190910152052-7cb4b85ec19c/go.mod h1:lADxMC39cJJqL93Duh1xhAs4I2Zs8mKS89XWXFGp9cs= github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= github.com/hypnoglow/gormzap v0.3.0/go.mod h1:5Wom8B7Jl2oK0Im9hs6KQ+Kl92w4Y7gKCrj66rhyvw0= github.com/iancoleman/strcase v0.0.0-20191112232945-16388991a334/go.mod h1:SK73tn/9oHe+/Y0h39VT4UCxmurVJkR5NA7kMEAOgSE= github.com/ianlancetaylor/demangle v0.0.0-20181102032728-5e5cf60278f6/go.mod h1:aSSvb/t6k1mPoxDqO4vJh6VOCGPwU4O0C2/Eqndh1Sc= github.com/icrowley/fake v0.0.0-20180203215853-4178557ae428/go.mod h1:uhpZMVGznybq1itEKXj6RYw9I71qK4kH+OGMjRC4KEo= github.com/imdario/mergo v0.3.5/go.mod h1:2EnlNZ0deacrJVfApfmtdGgDfMuh/nq6Ok1EcJh5FfA= github.com/imdario/mergo v0.3.6/go.mod h1:2EnlNZ0deacrJVfApfmtdGgDfMuh/nq6Ok1EcJh5FfA= github.com/inconshreveable/mousetrap v1.0.0/go.mod h1:PxqpIevigyE2G7u3NXJIT2ANytuPF1OarO4DADm73n8= github.com/jarcoal/httpmock v0.0.0-20180424175123-9c70cfe4a1da/go.mod h1:ks+b9deReOc7jgqp+e7LuFiCBH6Rm5hL32cLcEAArb4= github.com/jcmturner/gofork v0.0.0-20180107083740-2aebee971930/go.mod h1:MK8+TM0La+2rjBD4jE12Kj1pCCxK7d2LK/UM3ncEo0o= github.com/jefferai/jsonx v0.0.0-20160721235117-9cc31c3135ee/go.mod h1:N0t2vlmpe8nyZB5ouIbJQPDSR+mH6oe7xHB9VZHSUzM= github.com/jeremywohl/flatten v0.0.0-20190921043622-d936035e55cf/go.mod h1:4AmD/VxjWcI5SRB0n6szE2A6s2fsNHDLO0nAlMHgfLQ= github.com/jessevdk/go-flags v1.4.0/go.mod h1:4FA24M0QyGHXBuZZK/XkWh8h0e1EYbRYJSGM75WSRxI= github.com/jinzhu/gorm v1.9.12/go.mod h1:vhTjlKSJUTWNtcbQtrMBFCxy7eXTzeCAzfL5fBZT/Qs= github.com/jinzhu/inflection v1.0.0/go.mod h1:h+uFLlag+Qp1Va5pdKtLDYj+kHp5pxUVkryuEj+Srlc= github.com/jinzhu/now v1.0.1/go.mod h1:d3SSVoowX0Lcu0IBviAWJpolVfI5UJVZZ7cO71lE/z8= github.com/jmespath/go-jmespath v0.0.0-20180206201540-c2b33e8439af/go.mod h1:Nht3zPeWKUH0NzdCt2Blrr5ys8VGpn0CEB0cQHVjt7k= github.com/jmespath/go-jmespath v0.3.0/go.mod h1:9QtRXoHjLGCJ5IBSaohpXITPlowMeeYCZ7fLUTSywik= github.com/jmespath/go-jmespath v0.4.0/go.mod h1:T8mJZnbsbmF+m6zOOFylbeCJqk5+pHWvzYPziyZiYoo= github.com/jmespath/go-jmespath/internal/testify v1.5.1/go.mod h1:L3OGu8Wl2/fWfCI6z80xFu9LTZmf1ZRjMHUOPmWr69U= github.com/joho/godotenv v1.3.0/go.mod h1:7hK45KPybAkOC6peb+G5yklZfMxEjkZhHbwpqxOKXbg= github.com/joho/sqltocsv v0.0.0-20210208114054-cb2c3a95fb99/go.mod h1:mAVCUAYtW9NG31eB30umMSLKcDt6mCUWSjoSn5qBh0k= github.com/jonboulle/clockwork v0.1.0/go.mod h1:Ii8DK3G1RaLaWxj9trq07+26W01tbo22gdxWY5EU2bo= github.com/joomcode/errorx v1.0.1/go.mod h1:kgco15ekB6cs+4Xjzo7SPeXzx38PbJzBwbnu9qfVNHQ= github.com/joyent/triton-go v0.0.0-20180628001255-830d2b111e62/go.mod h1:U+RSyWxWd04xTqnuOQxnai7XGS2PrPY2cfGoDKtMHjA= github.com/json-iterator/go v0.0.0-20180612202835-f2b4162afba3/go.mod h1:+SdeFBvtyEkXs7REEP0seUULqWtbJapLOCVDaaPEHmU= github.com/json-iterator/go v1.1.5/go.mod h1:+SdeFBvtyEkXs7REEP0seUULqWtbJapLOCVDaaPEHmU= github.com/json-iterator/go v1.1.6/go.mod h1:+SdeFBvtyEkXs7REEP0seUULqWtbJapLOCVDaaPEHmU= github.com/json-iterator/go v1.1.7/go.mod h1:KdQUCv79m/52Kvf8AW2vK1V8akMuk1QjK/uOdHXbAo4= github.com/json-iterator/go v1.1.8/go.mod h1:KdQUCv79m/52Kvf8AW2vK1V8akMuk1QjK/uOdHXbAo4= github.com/json-iterator/go v1.1.9/go.mod h1:KdQUCv79m/52Kvf8AW2vK1V8akMuk1QjK/uOdHXbAo4= github.com/json-iterator/go v1.1.10/go.mod h1:KdQUCv79m/52Kvf8AW2vK1V8akMuk1QjK/uOdHXbAo4= github.com/jstemmer/go-junit-report v0.0.0-20190106144839-af01ea7f8024/go.mod h1:6v2b51hI/fHJwM22ozAgKL4VKDeJcHhJFhtBdhmNjmU= github.com/jstemmer/go-junit-report v0.9.1/go.mod h1:Brl9GWCQeLvo8nXZwPNNblvFj/XSXhF0NWZEnDohbsk= github.com/jtolds/gls v4.2.1+incompatible/go.mod h1:QJZ7F/aHp+rZTRtaJ1ow/lLfFfVYBRgL+9YlvaHOwJU= github.com/jtolds/gls v4.20.0+incompatible/go.mod h1:QJZ7F/aHp+rZTRtaJ1ow/lLfFfVYBRgL+9YlvaHOwJU= github.com/juju/ratelimit v1.0.1/go.mod h1:qapgC/Gy+xNh9UxzV13HGGl/6UXNN+ct+vwSgWNm/qk= github.com/julienschmidt/httprouter v1.2.0/go.mod h1:SYymIcj16QtmaHHD7aYtjjsJG7VTCxuUUipMqKk8s4w= github.com/keybase/go-crypto v0.0.0-20180614160407-5114a9a81e1b/go.mod h1:ghbZscTyKdM07+Fw3KSi0hcJm+AlEUWj8QLlPtijN/M= github.com/kisielk/errcheck v1.1.0/go.mod h1:EZBBE59ingxPouuu3KfxchcWSUPOHkagtvWXihfKN4Q= github.com/kisielk/errcheck v1.2.0/go.mod h1:/BMXB+zMLi60iA8Vv6Ksmxu/1UDYcXs4uQLJ+jE2L00= github.com/kisielk/errcheck v1.5.0/go.mod h1:pFxgyoBC7bSaBwPgfKdkLd5X25qrDl4LWUI2bnpBCr8= github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck= github.com/klauspost/compress v1.4.0/go.mod h1:RyIbtBH6LamlWaDj8nUwkbUhJ87Yi3uG0guNDohfE1A= github.com/klauspost/compress v1.4.1/go.mod h1:RyIbtBH6LamlWaDj8nUwkbUhJ87Yi3uG0guNDohfE1A= github.com/klauspost/compress v1.9.5/go.mod h1:RyIbtBH6LamlWaDj8nUwkbUhJ87Yi3uG0guNDohfE1A= github.com/klauspost/compress v1.9.7/go.mod h1:RyIbtBH6LamlWaDj8nUwkbUhJ87Yi3uG0guNDohfE1A= github.com/klauspost/compress v1.10.5/go.mod h1:aoV0uJVorq1K+umq18yTdKaF57EivdYsUV+/s2qKfXs= github.com/klauspost/cpuid v0.0.0-20170728055534-ae7887de9fa5/go.mod h1:Pj4uuM528wm8OyEC2QMXAi2YiTZ96dNQPGgoMS4s3ek= github.com/klauspost/cpuid v0.0.0-20180405133222-e7e905edc00e/go.mod h1:Pj4uuM528wm8OyEC2QMXAi2YiTZ96dNQPGgoMS4s3ek= github.com/klauspost/cpuid v1.2.0/go.mod h1:Pj4uuM528wm8OyEC2QMXAi2YiTZ96dNQPGgoMS4s3ek= github.com/klauspost/cpuid v1.2.1/go.mod h1:Pj4uuM528wm8OyEC2QMXAi2YiTZ96dNQPGgoMS4s3ek= github.com/klauspost/crc32 v1.2.0/go.mod h1:+ZoRqAPRLkC4NPOvfYeR5KNOrY6TD+/sAC3HXPZgDYg= github.com/klauspost/pgzip v1.2.0/go.mod h1:Ch1tH69qFZu15pkjo5kYi6mth2Zzwzt50oCQKQE9RUs= github.com/klauspost/pgzip v1.2.4/go.mod h1:Ch1tH69qFZu15pkjo5kYi6mth2Zzwzt50oCQKQE9RUs= github.com/konsorten/go-windows-terminal-sequences v1.0.1/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ= github.com/konsorten/go-windows-terminal-sequences v1.0.2 h1:DB17ag19krx9CFsz4o3enTrPXyIXCl+2iCXH/aMAp9s= github.com/konsorten/go-windows-terminal-sequences v1.0.2/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ= github.com/konsorten/go-windows-terminal-sequences v1.0.3/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ= github.com/kr/logfmt v0.0.0-20140226030751-b84e30acd515/go.mod h1:+0opPa2QZZtGFBFZlji/RkVcI2GknAs/DXo4wKdlNEc= github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo= github.com/kr/pretty v0.2.0/go.mod h1:ipq/a2n7PKx3OHsz4KJII5eveXtPO4qwEXGdVfWzfnI= github.com/kr/pretty v0.2.1 h1:Fmg33tUaq4/8ym9TJN1x7sLJnHVwhP33CNkpYV/7rwI= github.com/kr/pretty v0.2.1/go.mod h1:ipq/a2n7PKx3OHsz4KJII5eveXtPO4qwEXGdVfWzfnI= github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= github.com/kr/pty v1.1.5/go.mod h1:9r2w37qlBe7rQ6e1fg1S/9xpWHSnaqNdHD3WcMdbPDA= github.com/kr/pty v1.1.8/go.mod h1:O1sed60cT9XZ5uDucP5qwvh+TE3NnUj51EiZO/lmSfw= github.com/kr/text v0.1.0 h1:45sCR5RtlFHMR4UwH9sdQ5TC8v0qDQCHnXt+kaKSTVE= github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE= github.com/krishicks/yaml-patch v0.0.10/go.mod h1:Sm5TchwZS6sm7RJoyg87tzxm2ZcKzdRE4Q7TjNhPrME= github.com/ledisdb/ledisdb v0.0.0-20200510135210-d35789ec47e6/go.mod h1:n931TsDuKuq+uX4v1fulaMbA/7ZLLhjc85h7chZGBCQ= github.com/leodido/go-urn v1.1.0/go.mod h1:+cyI34gQWZcE1eQU7NVgKkkzdXDQHr1dBMtdAPozLkw= github.com/leodido/go-urn v1.2.0/go.mod h1:+8+nEpDfqqsY+g338gtMEUOtuK+4dEMhiQEgxpxOKII= github.com/lib/pq v1.0.0/go.mod h1:5WUZQaWbwv1U+lTReE5YruASi9Al49XbQIvNi/34Woo= github.com/lib/pq v1.1.1/go.mod h1:5WUZQaWbwv1U+lTReE5YruASi9Al49XbQIvNi/34Woo= github.com/lib/pq v1.2.0/go.mod h1:5WUZQaWbwv1U+lTReE5YruASi9Al49XbQIvNi/34Woo= github.com/logrusorgru/aurora v0.0.0-20181002194514-a7b3b318ed4e/go.mod h1:7rIyQOR62GCctdiQpZ/zOJlFyk6y+94wXzv6RNZgaR4= github.com/looplab/fsm v0.2.0/go.mod h1:p+IElwgCnAByqr2DWMuNbPjgMwqcHvTRZZn3dvKEke0= github.com/lyft/protoc-gen-validate v0.0.0-20180911180927-64fcb82c878e/go.mod h1:XbGvPuh87YZc5TdIa2/I4pLk0QoUACkjt2znoq26NVQ= github.com/magiconair/properties v1.8.0/go.mod h1:PppfXfuXeibc/6YijjN8zIbojt8czPbwD3XqdrwzmxQ= github.com/magiconair/properties v1.8.1/go.mod h1:PppfXfuXeibc/6YijjN8zIbojt8czPbwD3XqdrwzmxQ= github.com/mailru/easyjson v0.0.0-20160728113105-d5b7844b561a/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc= github.com/mailru/easyjson v0.0.0-20180823135443-60711f1a8329/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc= github.com/mailru/easyjson v0.0.0-20190312143242-1de009706dbe/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc= github.com/mailru/easyjson v0.0.0-20190614124828-94de47d64c63/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc= github.com/mailru/easyjson v0.0.0-20190626092158-b2ccc519800e/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc= github.com/mailru/easyjson v0.7.0/go.mod h1:KAzv3t3aY1NaHWoQz1+4F1ccyAH66Jk7yos7ldAVICs= github.com/martini-contrib/auth v0.0.0-20150219114609-fa62c19b7ae8/go.mod h1:ahTFgV/NtzY/CALneRrC67m1dis5arHTQDfyIhKk69E= github.com/martini-contrib/gzip v0.0.0-20151124214156-6c035326b43f/go.mod h1:jhUB0rZB2TPWqy0yGugKRRictO591eSO7If7O4MfCaA= github.com/martini-contrib/render v0.0.0-20150707142108-ec18f8345a11/go.mod h1:Ah2dBMoxZEqk118as2T4u4fjfXarE0pPnMJaArZQZsI= github.com/matoous/godox v0.0.0-20190911065817-5d6d842e92eb/go.mod h1:1BELzlh859Sh1c6+90blK8lbYy0kwQf1bYlBhBysy1s= github.com/mattn/go-colorable v0.0.9/go.mod h1:9vuHe8Xs5qXnSaW/c/ABM9alt+Vo+STaOChaDxuIBZU= github.com/mattn/go-colorable v0.1.2/go.mod h1:U0ppj6V5qS13XJ6of8GYAs25YV2eR4EVcfRqFIhoBtE= github.com/mattn/go-colorable v0.1.4/go.mod h1:U0ppj6V5qS13XJ6of8GYAs25YV2eR4EVcfRqFIhoBtE= github.com/mattn/go-colorable v0.1.6/go.mod h1:u6P/XSegPjTcexA+o6vUJrdnUu04hMope9wVRipJSqc= github.com/mattn/go-colorable v0.1.8/go.mod h1:u6P/XSegPjTcexA+o6vUJrdnUu04hMope9wVRipJSqc= github.com/mattn/go-ieproxy v0.0.0-20190610004146-91bb50d98149/go.mod h1:31jz6HNzdxOmlERGGEc4v/dMssOfmp2p5bT/okiKFFc= github.com/mattn/go-ieproxy v0.0.0-20190702010315-6dee0af9227d/go.mod h1:31jz6HNzdxOmlERGGEc4v/dMssOfmp2p5bT/okiKFFc= github.com/mattn/go-isatty v0.0.3/go.mod h1:M+lRXTBqGeGNdLjl/ufCoiOlB5xdOkqRJdNxMWT7Zi4= github.com/mattn/go-isatty v0.0.4/go.mod h1:M+lRXTBqGeGNdLjl/ufCoiOlB5xdOkqRJdNxMWT7Zi4= github.com/mattn/go-isatty v0.0.7/go.mod h1:Iq45c/XA43vh69/j3iqttzPXn0bhXyGjM0Hdxcsrc5s= github.com/mattn/go-isatty v0.0.8/go.mod h1:Iq45c/XA43vh69/j3iqttzPXn0bhXyGjM0Hdxcsrc5s= github.com/mattn/go-isatty v0.0.9/go.mod h1:YNRxwqDuOph6SZLI9vUUz6OYw3QyUt7WiY2yME+cCiQ= github.com/mattn/go-isatty v0.0.10/go.mod h1:qgIWMr58cqv1PHHyhnkY9lrL7etaEgOFcMEpPG5Rm84= github.com/mattn/go-isatty v0.0.11/go.mod h1:PhnuNfih5lzO57/f3n+odYbM4JtupLOxQOAqxQCu2WE= github.com/mattn/go-isatty v0.0.12/go.mod h1:cbi8OIDigv2wuxKPP5vlRcQ1OAZbq2CE4Kysco4FUpU= github.com/mattn/go-runewidth v0.0.2/go.mod h1:LwmH8dsx7+W8Uxz3IHJYH5QSwggIsqBzpuz5H//U1FU= github.com/mattn/go-runewidth v0.0.7/go.mod h1:H031xJmbD/WCDINGzjvQ9THkh0rPKHF+m2gUSrubnMI= github.com/mattn/go-runewidth v0.0.10/go.mod h1:RAqKPSqVFrSLVXbA8x7dzmKdmGzieGRCM46jaSJTDAk= github.com/mattn/go-shellwords v1.0.3/go.mod h1:3xCvwCdWdlDJUrvuMn7Wuy9eWs4pE8vqg+NOMyg4B2o= github.com/mattn/go-sqlite3 v1.14.0/go.mod h1:JIl7NbARA7phWnGvh0LKTyg7S9BA+6gx71ShQilpsus= github.com/mattn/go-sqlite3 v2.0.1+incompatible/go.mod h1:FPy6KqzDD04eiIsT53CuJW3U88zkxoIYsOqkbpncsNc= github.com/mattn/go-sqlite3 v2.0.3+incompatible/go.mod h1:FPy6KqzDD04eiIsT53CuJW3U88zkxoIYsOqkbpncsNc= github.com/mattn/goveralls v0.0.2/go.mod h1:8d1ZMHsd7fW6IRPKQh46F2WRpyib5/X4FOpevwGNQEw= github.com/matttproud/golang_protobuf_extensions v1.0.1 h1:4hp9jkHxhMHkqkrB3Ix0jegS5sx/RkqARlsWZ6pIwiU= github.com/matttproud/golang_protobuf_extensions v1.0.1/go.mod h1:D8He9yQNgCq6Z5Ld7szi9bcBfOoFv/3dc6xSMkL2PC0= github.com/mgechev/dots v0.0.0-20190921121421-c36f7dcfbb81/go.mod h1:KQ7+USdGKfpPjXk4Ga+5XxQM4Lm4e3gAogrreFAYpOg= github.com/mgechev/revive v1.0.2/go.mod h1:rb0dQy1LVAxW9SWy5R3LPUjevzUbUS316U5MFySA2lo= github.com/miekg/dns v1.0.14/go.mod h1:W1PPwlIAgtquWBMBEV9nkV9Cazfe8ScdGz/Lj7v3Nrg= github.com/miekg/dns v1.1.26/go.mod h1:bPDLeHnStXmXAq1m/Ch/hvfNHr14JKNPMBo3VZKjuso= github.com/minio/minio-go v0.0.0-20190131015406-c8a261de75c1/go.mod h1:vuvdOZLJuf5HmJAJrKV64MmozrSsk+or0PB5dzdfspg= github.com/mitchellh/cli v1.0.0/go.mod h1:hNIlj7HEI86fIcpObd7a0FcrxTWetlwJDGcceTlRvqc= github.com/mitchellh/cli v1.1.0/go.mod h1:xcISNoH86gajksDmfB23e/pu+B+GeFRMYmoHXxx3xhI= github.com/mitchellh/copystructure v0.0.0-20160804032330-cdac8253d00f/go.mod h1:eOsF2yLPlBBJPvD+nhl5QMTBSOBbOph6N7j/IDUw7PY= github.com/mitchellh/go-homedir v1.0.0/go.mod h1:SfyaCUpYCn1Vlf4IUYiD9fPX4A5wJrkLzIz1N1q0pr0= github.com/mitchellh/go-homedir v1.1.0/go.mod h1:SfyaCUpYCn1Vlf4IUYiD9fPX4A5wJrkLzIz1N1q0pr0= github.com/mitchellh/go-ps v0.0.0-20190716172923-621e5597135b/go.mod h1:r1VsdOzOPt1ZSrGZWFoNhsAedKnEd6r9Np1+5blZCWk= github.com/mitchellh/go-ps v1.0.0/go.mod h1:J4lOc8z8yJs6vUwklHw2XEIiT4z4C40KtWVN3nvg8Pg= github.com/mitchellh/go-testing-interface v1.0.0/go.mod h1:kRemZodwjscx+RGhAo8eIhFbs2+BFgRtFPeD/KE+zxI= github.com/mitchellh/go-testing-interface v1.14.0/go.mod h1:gfgS7OtZj6MA4U1UrDRp04twqAjfvlZyCfX3sDjEym8= github.com/mitchellh/go-wordwrap v1.0.0/go.mod h1:ZXFpozHsX6DPmq2I0TCekCxypsnAUbP2oI0UX1GXzOo= github.com/mitchellh/gox v0.4.0/go.mod h1:Sd9lOJ0+aimLBi73mGofS1ycjY8lL3uZM3JPS42BGNg= github.com/mitchellh/hashstructure v0.0.0-20170609045927-2bca23e0e452/go.mod h1:QjSHrPWS+BGUVBYkbTZWEnOh3G1DutKwClXU/ABz6AQ= github.com/mitchellh/iochan v1.0.0/go.mod h1:JwYml1nuB7xOzsp52dPpHFffvOCDupsG0QubkSMEySY= github.com/mitchellh/mapstructure v0.0.0-20160808181253-ca63d7c062ee/go.mod h1:FVVH3fgwuzCH5S8UJGiWEs2h04kUh9fWfEaFds41c1Y= github.com/mitchellh/mapstructure v1.1.2/go.mod h1:FVVH3fgwuzCH5S8UJGiWEs2h04kUh9fWfEaFds41c1Y= github.com/mitchellh/mapstructure v1.2.3/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= github.com/mitchellh/reflectwalk v1.0.1/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw= github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= github.com/modern-go/reflect2 v0.0.0-20180320133207-05fbef0ca5da/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0= github.com/modern-go/reflect2 v0.0.0-20180701023420-4b7aa43c6742/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0= github.com/modern-go/reflect2 v1.0.1/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0= github.com/montanaflynn/stats v0.0.0-20151014174947-eeaced052adb/go.mod h1:wL8QJuTMNUDYhXwkmfOly8iTdp5TEcJFWZD2D7SIkUc= github.com/montanaflynn/stats v0.0.0-20180911141734-db72e6cae808/go.mod h1:wL8QJuTMNUDYhXwkmfOly8iTdp5TEcJFWZD2D7SIkUc= github.com/montanaflynn/stats v0.5.0/go.mod h1:wL8QJuTMNUDYhXwkmfOly8iTdp5TEcJFWZD2D7SIkUc= github.com/montanaflynn/stats v0.6.3/go.mod h1:wL8QJuTMNUDYhXwkmfOly8iTdp5TEcJFWZD2D7SIkUc= github.com/mozilla/tls-observatory v0.0.0-20190404164649-a3c1b6cfecfd/go.mod h1:SrKMQvPiws7F7iqYp8/TX+IhxCYhzr6N/1yb8cwHsGk= github.com/munnerz/goautoneg v0.0.0-20120707110453-a547fc61f48d/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ= github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ= github.com/mwitkow/go-conntrack v0.0.0-20161129095857-cc309e4a2223/go.mod h1:qRWi+5nqEBWmkhHvq77mSJWrCKwh8bxhgT7d/eI7P4U= github.com/mxk/go-flowrate v0.0.0-20140419014527-cca7078d478f/go.mod h1:ZdcZmHo+o7JKHSa8/e818NopupXU1YMK5fe1lsApnBw= github.com/nbutton23/zxcvbn-go v0.0.0-20180912185939-ae427f1e4c1d/go.mod h1:o96djdrsSGy3AWPyBgZMAGfxZNfgntdJG+11KU4QvbU= github.com/ncw/directio v1.0.4/go.mod h1:CKGdcN7StAaqjT7Qack3lAXeX4pjnyc46YeqZH1yWVY= github.com/nfnt/resize v0.0.0-20160724205520-891127d8d1b5/go.mod h1:jpp1/29i3P1S/RLdc7JQKbRpFeM1dOBd8T9ki5s+AY8= github.com/ngaut/pools v0.0.0-20180318154953-b7bc8c42aac7/go.mod h1:iWMfgwqYW+e8n5lC/jjNEhwcjbRDpl5NT7n2h+4UNcI= github.com/ngaut/sync2 v0.0.0-20141008032647-7a24ed77b2ef/go.mod h1:7WjlapSfwQyo6LNmIvEWzsW1hbBQfpUO4JWnuQRmva8= github.com/ngdinhtoan/glide-cleanup v0.2.0/go.mod h1:UQzsmiDOb8YV3nOsCxK/c9zPpCZVNoHScRE3EO9pVMM= github.com/nicksnyder/go-i18n v1.10.0/go.mod h1:HrK7VCrbOvQoUAQ7Vpy7i87N7JZZZ7R2xBGjv0j365Q= github.com/nicolai86/scaleway-sdk v1.10.2-0.20180628010248-798f60e20bb2/go.mod h1:TLb2Sg7HQcgGdloNxkrmtgDNR9uVYF3lfdFIN4Ro6Sk= github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e/go.mod h1:zD1mROLANZcx1PVRCS0qkT7pwLkGfwJo4zjcN/Tysno= github.com/nkovacs/streamquote v0.0.0-20170412213628-49af9bddb229/go.mod h1:0aYXnNPJ8l7uZxf45rWW1a/uME32OF0rhiYGNQ2oF2E= github.com/oklog/run v0.0.0-20180308005104-6934b124db28/go.mod h1:dlhp/R75TPv97u0XWUtDeV/lRKWPKSdTuV0TZvrmrQA= github.com/oklog/ulid v1.3.1/go.mod h1:CirwcVhetQ6Lv90oh/F+FBtV6XMibvdAFo93nm5qn4U= github.com/oleiade/reflections v1.0.1/go.mod h1:rdFxbxq4QXVZWj0F+e9jqjDkc7dbp97vkRixKo2JR60= github.com/olekukonko/tablewriter v0.0.0-20170122224234-a0225b3f23b5/go.mod h1:vsDQFd/mU46D+Z4whnwzcISnGGzXWMclvtLoiIKAKIo= github.com/olekukonko/tablewriter v0.0.4/go.mod h1:zq6QwlOf5SlnkVbMSr5EoBv3636FWnp+qbPhuoO21uA= github.com/olekukonko/tablewriter v0.0.5-0.20200416053754-163badb3bac6/go.mod h1:zq6QwlOf5SlnkVbMSr5EoBv3636FWnp+qbPhuoO21uA= github.com/onsi/ginkgo v0.0.0-20170829012221-11459a886d9c/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= github.com/onsi/ginkgo v1.6.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= github.com/onsi/ginkgo v1.7.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= github.com/onsi/ginkgo v1.10.1/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= github.com/onsi/ginkgo v1.10.3/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= github.com/onsi/ginkgo v1.12.0/go.mod h1:oUhWkIvk5aDxtKvDDuw8gItl8pKl42LzjC9KZE0HfGg= github.com/onsi/gomega v0.0.0-20170829124025-dcabb60a477c/go.mod h1:C1qb7wdrVGGVU+Z6iS04AVkA3Q65CEZX59MT0QO5uiA= github.com/onsi/gomega v1.4.2/go.mod h1:ex+gbHU/CVuBBDIJjb2X0qEXbFg53c61hWP/1CpauHY= github.com/onsi/gomega v1.4.3/go.mod h1:ex+gbHU/CVuBBDIJjb2X0qEXbFg53c61hWP/1CpauHY= github.com/onsi/gomega v1.7.0/go.mod h1:ex+gbHU/CVuBBDIJjb2X0qEXbFg53c61hWP/1CpauHY= github.com/onsi/gomega v1.7.1/go.mod h1:XdKZgCCFLUoM/7CFJVPcG8C1xQ1AJ0vpAezJrB7JYyY= github.com/opencontainers/go-digest v1.0.0-rc1/go.mod h1:cMLVZDEM3+U2I4VmLI6N8jQYUd2OVphdqWwCJHrFt2s= github.com/opencontainers/image-spec v1.0.1/go.mod h1:BtxoFyWECRxE4U/7sNtV5W15zMzWCbyJoFRP3s7yZA0= github.com/opencontainers/runc v0.1.1/go.mod h1:qT5XzbpPznkRYVz/mWwUaVBUv2rmF59PVA73FjuZG0U= github.com/opentracing-contrib/go-grpc v0.0.0-20180928155321-4b5a12d3ff02/go.mod h1:JNdpVEzCpXBgIiv4ds+TzhN1hrtxq6ClLrTlT9OQRSc= github.com/opentracing/basictracer-go v1.0.0/go.mod h1:QfBfYuafItcjQuMwinw9GhYKwFXS9KnPs5lxoYwgW74= github.com/opentracing/opentracing-go v1.0.2/go.mod h1:UkNAQd3GIcIGf0SeVgPpRdFStlNbqXla1AfSYxPUl2o= github.com/opentracing/opentracing-go v1.1.0 h1:pWlfV3Bxv7k65HYwkikxat0+s3pV4bsqf19k25Ur8rU= github.com/opentracing/opentracing-go v1.1.0/go.mod h1:UkNAQd3GIcIGf0SeVgPpRdFStlNbqXla1AfSYxPUl2o= github.com/ory/dockertest v3.3.4+incompatible/go.mod h1:1vX4m9wsvi00u5bseYwXaSnhNrne+V0E6LAcBILJdPs= github.com/oxtoacart/bpool v0.0.0-20190530202638-03653db5a59c/go.mod h1:X07ZCGwUbLaax7L0S3Tw4hpejzu63ZrrQiUe6W0hcy0= github.com/packethost/packngo v0.1.1-0.20180711074735-b9cb5096f54c/go.mod h1:otzZQXgoO96RTzDB/Hycg0qZcXZsWJGJRSXbmEIJ+4M= github.com/pascaldekloe/goe v0.0.0-20180627143212-57f6aae5913c/go.mod h1:lzWF7FIEvWOWxwDKqyGYQf6ZUaNfKdP144TG7ZOy1lc= github.com/pascaldekloe/goe v0.1.0/go.mod h1:lzWF7FIEvWOWxwDKqyGYQf6ZUaNfKdP144TG7ZOy1lc= github.com/patrickmn/go-cache v0.0.0-20180527043350-9f6ff22cfff8/go.mod h1:3Qf8kWWT7OJRJbdiICTKqZju1ZixQ/KpMGzzAfe6+WQ= github.com/patrickmn/go-cache v2.1.0+incompatible/go.mod h1:3Qf8kWWT7OJRJbdiICTKqZju1ZixQ/KpMGzzAfe6+WQ= github.com/pborman/getopt v0.0.0-20180729010549-6fdd0a2c7117/go.mod h1:85jBQOZwpVEaDAr341tbn15RS4fCAsIst0qp7i8ex1o= github.com/pborman/uuid v1.2.0/go.mod h1:X/NO0urCmaxf9VXbdlT7C2Yzkj2IKimNn4k+gtPdI/k= github.com/pelletier/go-toml v1.0.1/go.mod h1:5z9KED0ma1S8pY6P1sdut58dfprrGBbd/94hg7ilaic= github.com/pelletier/go-toml v1.2.0/go.mod h1:5z9KED0ma1S8pY6P1sdut58dfprrGBbd/94hg7ilaic= github.com/pelletier/go-toml v1.3.0/go.mod h1:PN7xzY2wHTK0K9p34ErDQMlFxa51Fk0OUruD3k1mMwo= github.com/pelletier/go-toml v1.6.0/go.mod h1:5N711Q9dKgbdkxHL+MEfF31hpT7l0S0s/t2kKREewys= github.com/percona/go-mysql v0.0.0-20210427141028-73d29c6da78c h1:1SZ7nS+kSaO63IpaKspf/gf8602QcgP2eXNPMNOIc0M= github.com/percona/go-mysql v0.0.0-20210427141028-73d29c6da78c/go.mod h1:/SGLf9OMxlnK6jq4mkFiImBcJXXk5jwD+lDrwDaGXcw= github.com/peterbourgon/diskv v2.0.1+incompatible/go.mod h1:uqqh8zWWbv1HBMNONnaR/tNboyR3/BZd58JJSHlUSCU= github.com/peterh/liner v1.0.1-0.20171122030339-3681c2a91233/go.mod h1:xIteQHvHuaLYG9IFj6mSxM0fCKrs34IrEQUhOYuGPHc= github.com/petermattis/goid v0.0.0-20180202154549-b0b1615b78e5/go.mod h1:jvVRKCrJTQWu0XVbaOlby/2lO20uSCHEMzzplHXte1o= github.com/phayes/freeport v0.0.0-20180830031419-95f893ade6f2/go.mod h1:iIss55rKnNBTvrwdmkUpLnDpZoAHvWaiq5+iMmen4AE= github.com/phf/go-queue v0.0.0-20170504031614-9abe38d0371d/go.mod h1:lXfE4PvvTW5xOjO6Mba8zDPyw8M93B6AQ7frTGnMlA8= github.com/philhofer/fwd v1.0.0/go.mod h1:gk3iGcWd9+svBvR0sR+KPcfE+RNWozjowpeBVG3ZVNU= github.com/pingcap-incubator/tidb-dashboard v0.0.0-20200302022638-35a6e979dca9/go.mod h1:YUceA4BHY/MTtp63yZLTYP22waFSwMNo9lXq2FDtzVw= github.com/pingcap/badger v1.5.1-0.20200908111422-2e78ee155d19/go.mod h1:LyrqUOHZrUDf9oGi1yoz1+qw9ckSIhQb5eMa1acOLNQ= github.com/pingcap/br v5.1.0-alpha.0.20210526054934-d5f5f9df24f5+incompatible/go.mod h1:ymVmo50lQydxib0tmK5hHk4oteB7hZ0IMCArunwy3UQ= github.com/pingcap/check v0.0.0-20190102082844-67f458068fc8/go.mod h1:B1+S9LNcuMyLH/4HMTViQOJevkGiik3wW2AN9zb2fNQ= github.com/pingcap/check v0.0.0-20191107115940-caf2b9e6ccf4/go.mod h1:PYMCGwN0JHjoqGr3HrZoD+b8Tgx8bKnArhSq8YVzUMc= github.com/pingcap/check v0.0.0-20191216031241-8a5a85928f12/go.mod h1:PYMCGwN0JHjoqGr3HrZoD+b8Tgx8bKnArhSq8YVzUMc= github.com/pingcap/check v0.0.0-20200212061837-5e12011dc712/go.mod h1:PYMCGwN0JHjoqGr3HrZoD+b8Tgx8bKnArhSq8YVzUMc= github.com/pingcap/errcode v0.0.0-20180921232412-a1a7271709d9/go.mod h1:4b2X8xSqxIroj/IZ9MX/VGZhAwc11wB9wRIzHvz6SeM= github.com/pingcap/errcode v0.3.0/go.mod h1:4b2X8xSqxIroj/IZ9MX/VGZhAwc11wB9wRIzHvz6SeM= github.com/pingcap/errors v0.11.0/go.mod h1:Oi8TUi2kEtXXLMJk9l1cGmz20kV3TaQ0usTwv5KuLY8= github.com/pingcap/errors v0.11.4 h1:lFuQV/oaUMGcD2tqt+01ROSmJs75VG1ToEOkZIZ4nE4= github.com/pingcap/errors v0.11.4/go.mod h1:Oi8TUi2kEtXXLMJk9l1cGmz20kV3TaQ0usTwv5KuLY8= github.com/pingcap/errors v0.11.5-0.20190809092503-95897b64e011 h1:58naV4XMEqm0hl9LcYo6cZoGBGiLtefMQMF/vo3XLgQ= github.com/pingcap/errors v0.11.5-0.20190809092503-95897b64e011/go.mod h1:Oi8TUi2kEtXXLMJk9l1cGmz20kV3TaQ0usTwv5KuLY8= github.com/pingcap/errors v0.11.5-0.20200917111840-a15ef68f753d/go.mod h1:g4vx//d6VakjJ0mk7iLBlKA8LFavV/sAVINT/1PFxeQ= github.com/pingcap/errors v0.11.5-0.20201029093017-5a7df2af2ac7 h1:wQKuKP2HUtej2gSvx1cZmY4DENUH6tlOxRkfvPT8EBU= github.com/pingcap/errors v0.11.5-0.20201029093017-5a7df2af2ac7/go.mod h1:G7x87le1poQzLB/TqvTJI2ILrSgobnq4Ut7luOwvfvI= github.com/pingcap/errors v0.11.5-0.20201126102027-b0a155152ca3 h1:LllgC9eGfqzkfubMgjKIDyZYaa609nNWAyNZtpy2B3M= github.com/pingcap/errors v0.11.5-0.20201126102027-b0a155152ca3/go.mod h1:G7x87le1poQzLB/TqvTJI2ILrSgobnq4Ut7luOwvfvI= github.com/pingcap/failpoint v0.0.0-20191029060244-12f4ac2fd11d/go.mod h1:DNS3Qg7bEDhU6EXNHF+XSv/PGznQaMJ5FWvctpm6pQI= github.com/pingcap/failpoint v0.0.0-20200210140405-f8f9fb234798/go.mod h1:DNS3Qg7bEDhU6EXNHF+XSv/PGznQaMJ5FWvctpm6pQI= github.com/pingcap/failpoint v0.0.0-20200702092429-9f69995143ce/go.mod h1:w4PEZ5y16LeofeeGwdgZB4ddv9bLyDuIX+ljstgKZyk= github.com/pingcap/failpoint v0.0.0-20210316064728-7acb0f0a3dfd h1:I8IeI8MNiZVKnwuXhcIIzz6pREcOSbq18Q31KYIzFVM= github.com/pingcap/failpoint v0.0.0-20210316064728-7acb0f0a3dfd/go.mod h1:IVF+ijPSMZVtx2oIqxAg7ur6EyixtTYfOHwpfmlhqI4= github.com/pingcap/fn v0.0.0-20191016082858-07623b84a47d/go.mod h1:fMRU1BA1y+r89AxUoaAar4JjrhUkVDt0o0Np6V8XbDQ= github.com/pingcap/fn v0.0.0-20200306044125-d5540d389059/go.mod h1:fMRU1BA1y+r89AxUoaAar4JjrhUkVDt0o0Np6V8XbDQ= github.com/pingcap/goleveldb v0.0.0-20191226122134-f82aafb29989/go.mod h1:O17XtbryoCJhkKGbT62+L2OlrniwqiGLSqrmdHCMzZw= github.com/pingcap/kvproto v0.0.0-20191211054548-3c6b38ea5107/go.mod h1:WWLmULLO7l8IOcQG+t+ItJ3fEcrL5FxF0Wu+HrMy26w= github.com/pingcap/kvproto v0.0.0-20200214064158-62d31900d88e/go.mod h1:IOdRDPLyda8GX2hE/jO7gqaCV/PNFh8BZQCQZXfIOqI= github.com/pingcap/kvproto v0.0.0-20200221034943-a2aa1d1e20a8/go.mod h1:IOdRDPLyda8GX2hE/jO7gqaCV/PNFh8BZQCQZXfIOqI= github.com/pingcap/kvproto v0.0.0-20200228095611-2cf9a243b8d5/go.mod h1:IOdRDPLyda8GX2hE/jO7gqaCV/PNFh8BZQCQZXfIOqI= github.com/pingcap/kvproto v0.0.0-20200411081810-b85805c9476c/go.mod h1:IOdRDPLyda8GX2hE/jO7gqaCV/PNFh8BZQCQZXfIOqI= github.com/pingcap/kvproto v0.0.0-20210219064844-c1844a4775d6/go.mod h1:IOdRDPLyda8GX2hE/jO7gqaCV/PNFh8BZQCQZXfIOqI= github.com/pingcap/kvproto v0.0.0-20210507054410-a8152f8a876c h1:cy87vgUJT0U4JuxC7R14PuwBrabI9fDawYhyKTbjOBQ= github.com/pingcap/kvproto v0.0.0-20210507054410-a8152f8a876c/go.mod h1:IOdRDPLyda8GX2hE/jO7gqaCV/PNFh8BZQCQZXfIOqI= github.com/pingcap/log v0.0.0-20191012051959-b742a5d432e9/go.mod h1:4rbK1p9ILyIfb6hU7OG2CiWSqMXnp3JMbiaVJ6mvoY8= github.com/pingcap/log v0.0.0-20200117041106-d28c14d3b1cd h1:CV3VsP3Z02MVtdpTMfEgRJ4T9NGgGTxdHpJerent7rM= github.com/pingcap/log v0.0.0-20200117041106-d28c14d3b1cd/go.mod h1:4rbK1p9ILyIfb6hU7OG2CiWSqMXnp3JMbiaVJ6mvoY8= github.com/pingcap/log v0.0.0-20200511115504-543df19646ad h1:SveG82rmu/GFxYanffxsSF503SiQV+2JLnWEiGiF+Tc= github.com/pingcap/log v0.0.0-20200511115504-543df19646ad/go.mod h1:4rbK1p9ILyIfb6hU7OG2CiWSqMXnp3JMbiaVJ6mvoY8= github.com/pingcap/log v0.0.0-20201112100606-8f1e84a3abc8/go.mod h1:4rbK1p9ILyIfb6hU7OG2CiWSqMXnp3JMbiaVJ6mvoY8= github.com/pingcap/log v0.0.0-20210317133921-96f4fcab92a4 h1:ERrF0fTuIOnwfGbt71Ji3DKbOEaP189tjym50u8gpC8= github.com/pingcap/log v0.0.0-20210317133921-96f4fcab92a4/go.mod h1:4rbK1p9ILyIfb6hU7OG2CiWSqMXnp3JMbiaVJ6mvoY8= github.com/pingcap/parser v0.0.0-20200317021010-cd90cc2a7d87/go.mod h1:9v0Edh8IbgjGYW2ArJr19E+bvL8zKahsFp+ixWeId+4= github.com/pingcap/parser v0.0.0-20200325032611-b7d1e7e1b93d h1:rTWwJg7aC5ct8QVTcFZoRLiJ2dtjFOUFRlIdK5481bk= github.com/pingcap/parser v0.0.0-20200325032611-b7d1e7e1b93d/go.mod h1:9v0Edh8IbgjGYW2ArJr19E+bvL8zKahsFp+ixWeId+4= github.com/pingcap/parser v0.0.0-20210525032559-c37778aff307 h1:v7SipssMu4X1tVQOe3PIVE73keJNHCFXe4Cza5uNDZ8= github.com/pingcap/parser v0.0.0-20210525032559-c37778aff307/go.mod h1:xZC8I7bug4GJ5KtHhgAikjTfU4kBv1Sbo3Pf1MZ6lVw= github.com/pingcap/parser v3.1.2+incompatible h1:ZAtv2VBZitECpaHshSIp1bkBhEqJYerw7nO/HYsn8MM= github.com/pingcap/parser v3.1.2+incompatible/go.mod h1:1FNvfp9+J0wvc4kl8eGNh7Rqrxveg15jJoWo/a0uHwA= github.com/pingcap/pd/v4 v4.0.0-beta.1.0.20200305072537-61d9f9cc35d3/go.mod h1:25GfNw6+Jcr9kca5rtmTb4gKCJ4jOpow2zV2S9Dgafs= github.com/pingcap/sysutil v0.0.0-20200206130906-2bfa6dc40bcd/go.mod h1:EB/852NMQ+aRKioCpToQ94Wl7fktV+FNnxf3CX/TTXI= github.com/pingcap/sysutil v0.0.0-20200302022240-21c8c70d0ab1/go.mod h1:EB/852NMQ+aRKioCpToQ94Wl7fktV+FNnxf3CX/TTXI= github.com/pingcap/sysutil v0.0.0-20200309085538-962fd285f3bb/go.mod h1:EB/852NMQ+aRKioCpToQ94Wl7fktV+FNnxf3CX/TTXI= github.com/pingcap/sysutil v0.0.0-20210315073920-cc0985d983a3/go.mod h1:tckvA041UWP+NqYzrJ3fMgC/Hw9wnmQ/tUkp/JaHly8= github.com/pingcap/tidb v1.1.0-beta h1:d/Yw09RQoxh1IK/QNFm9H4ssfI9FqSlBCVowEfbBCmk= github.com/pingcap/tidb v1.1.0-beta.0.20200325081839-4a7d477399f4 h1:Ej+7Wu3RXhS5wvL5PA8e+iJbdATqc1Cjy+dfU0Rgxj4= github.com/pingcap/tidb v1.1.0-beta.0.20200325081839-4a7d477399f4/go.mod h1:4CGOiKZSaOU/Da3QYMtp0c3uBE2SxpcLOpESXmeQhcs= github.com/pingcap/tidb v1.1.0-beta.0.20210601085537-5d7c852770eb h1:tSZP1zie7y4arLuGFUaYQIGhTERUxCdLKd4SFujEqOQ= github.com/pingcap/tidb v1.1.0-beta.0.20210601085537-5d7c852770eb/go.mod h1:wDXJsUfKc+xXIuFBFY2vopJpfi1zl5EsNwbgU5k+iAQ= github.com/pingcap/tidb v2.0.11+incompatible h1:Shz+ry1DzQNsPk1QAejnM+5tgjbwZuzPnIER5aCjQ6c= github.com/pingcap/tidb-dashboard v0.0.0-20210312062513-eef5d6404638/go.mod h1:OzFN8H0EDMMqeulPhPMw2i2JaiZWOKFQ7zdRPhENNgo= github.com/pingcap/tidb-tools v4.0.0-beta.1.0.20200306084441-875bd09aa3d5+incompatible/go.mod h1:XGdcy9+yqlDSEMTpOXnwf3hiTeqrV6MN/u1se9N8yIM= github.com/pingcap/tidb-tools v4.0.9-0.20201127090955-2707c97b3853+incompatible/go.mod h1:XGdcy9+yqlDSEMTpOXnwf3hiTeqrV6MN/u1se9N8yIM= github.com/pingcap/tipb v0.0.0-20190428032612-535e1abaa330/go.mod h1:RtkHW8WbcNxj8lsbzjaILci01CtYnYbIkQhjyZWrWVI= github.com/pingcap/tipb v0.0.0-20200212061130-c4d518eb1d60/go.mod h1:RtkHW8WbcNxj8lsbzjaILci01CtYnYbIkQhjyZWrWVI= github.com/pingcap/tipb v0.0.0-20210425040103-dc47a87b52aa h1:lPZ5NmNel7RKlX4D9sU045y04knCMEaBTUrPAxb45os= github.com/pingcap/tipb v0.0.0-20210425040103-dc47a87b52aa/go.mod h1:nsEhnMokcn7MRqd2J60yxpn/ac3ZH8A6GOJ9NslabUo= github.com/pingcap/tipb v0.0.0-20210525032549-b80be13ddf6c/go.mod h1:nsEhnMokcn7MRqd2J60yxpn/ac3ZH8A6GOJ9NslabUo= github.com/pingcap/tipb v0.0.0-20210601083426-79a378b6d1c4 h1:n47+OwdI/uxKenfBT8Y2/be11MwbeLKNLdzOWnxNQKg= github.com/pingcap/tipb v0.0.0-20210601083426-79a378b6d1c4/go.mod h1:nsEhnMokcn7MRqd2J60yxpn/ac3ZH8A6GOJ9NslabUo= github.com/pires/go-proxyproto v0.0.0-20191211124218-517ecdf5bb2b/go.mod h1:Odh9VFOZJCf9G8cLW5o435Xf1J95Jw9Gw5rnCjcwzAY= github.com/pkg/errors v0.8.0/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/planetscale/pargzip v0.0.0-20201116224723-90c7fc03ea8a/go.mod h1:GJFUzQuXIoB2Kjn1ZfDhJr/42D5nWOqRcIQVgCxTuIE= github.com/pmezard/go-difflib v0.0.0-20151028094244-d8ed2627bdf0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/posener/complete v1.1.1/go.mod h1:em0nMJCgc9GFtwrmVmEMR/ZL6WyhyjMBndrE9hABlRI= github.com/posener/complete v1.2.3/go.mod h1:WZIdtGGp+qx0sLrYKtIRAruyNpv6hFCicSgv7Sy7s/s= github.com/pquerna/cachecontrol v0.0.0-20171018203845-0dec1b30a021/go.mod h1:prYjPmNq4d1NPVmpShWobRqXY3q7Vp+80DqgxxUrUIA= github.com/prometheus/client_golang v0.9.0/go.mod h1:7SWBe2y4D6OKWSNQJUaRYU/AaXPKyh/dDVn+NZz0KFw= github.com/prometheus/client_golang v0.9.1/go.mod h1:7SWBe2y4D6OKWSNQJUaRYU/AaXPKyh/dDVn+NZz0KFw= github.com/prometheus/client_golang v0.9.2/go.mod h1:OsXs2jCmiKlQ1lTBmv21f2mNfw4xf/QclQDMrYNZzcM= github.com/prometheus/client_golang v0.9.3/go.mod h1:/TN21ttK/J9q6uSwhBd54HahCDft0ttaMvbicHlPoso= github.com/prometheus/client_golang v1.0.0/go.mod h1:db9x61etRT2tGnBNRi70OPL5FsnadC4Ky3P0J6CfImo= github.com/prometheus/client_golang v1.2.1/go.mod h1:XMU6Z2MjaRKVu/dC1qupJI9SiNkDYzz3xecMgSW/F+U= github.com/prometheus/client_golang v1.4.1/go.mod h1:e9GMxYsXl05ICDXkRhurwBS4Q3OK1iX/F2sw+iXX5zU= github.com/prometheus/client_golang v1.5.1/go.mod h1:e9GMxYsXl05ICDXkRhurwBS4Q3OK1iX/F2sw+iXX5zU= github.com/prometheus/client_golang v1.7.0 h1:wCi7urQOGBsYcQROHqpUUX4ct84xp40t9R9JX0FuA/U= github.com/prometheus/client_golang v1.7.0/go.mod h1:PY5Wy2awLA44sXw4AOSfFBetzPP4j5+D6mVACh+pe2M= github.com/prometheus/client_model v0.0.0-20180712105110-5c3871d89910/go.mod h1:MbSGuTsp3dbXC40dX6PRTWyKYBIrTGTE9sqQNg2J8bo= github.com/prometheus/client_model v0.0.0-20190129233127-fd36f4220a90/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA= github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA= github.com/prometheus/client_model v0.2.0 h1:uq5h0d+GuxiXLJLNABMgp2qUWDPiLvgCzz2dUR+/W/M= github.com/prometheus/client_model v0.2.0/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA= github.com/prometheus/common v0.0.0-20181020173914-7e9e6cabbd39/go.mod h1:daVV7qP5qjZbuso7PdcryaAu0sAZbrN9i7WWcTMWvro= github.com/prometheus/common v0.0.0-20181113130724-41aa239b4cce/go.mod h1:daVV7qP5qjZbuso7PdcryaAu0sAZbrN9i7WWcTMWvro= github.com/prometheus/common v0.0.0-20181126121408-4724e9255275/go.mod h1:daVV7qP5qjZbuso7PdcryaAu0sAZbrN9i7WWcTMWvro= github.com/prometheus/common v0.4.0/go.mod h1:TNfzLD0ON7rHzMJeJkieUDPYmFC7Snx/y86RQel1bk4= github.com/prometheus/common v0.4.1/go.mod h1:TNfzLD0ON7rHzMJeJkieUDPYmFC7Snx/y86RQel1bk4= github.com/prometheus/common v0.7.0/go.mod h1:DjGbpBbp5NYNiECxcL/VnbXCCaQpKd3tt26CguLLsqA= github.com/prometheus/common v0.9.1/go.mod h1:yhUN8i9wzaXS3w1O07YhxHEBxD+W35wd8bs7vj7HSQ4= github.com/prometheus/common v0.10.0 h1:RyRA7RzGXQZiW+tGMr7sxa85G1z0yOpM1qq5c8lNawc= github.com/prometheus/common v0.10.0/go.mod h1:Tlit/dnDKsSWFlCLTWaA1cyBgKHSMdTB80sz/V91rCo= github.com/prometheus/procfs v0.0.0-20181005140218-185b4288413d/go.mod h1:c3At6R/oaqEKCNdg8wHV1ftS6bRYblBhIjjI8uT2IGk= github.com/prometheus/procfs v0.0.0-20181204211112-1dc9a6cbc91a/go.mod h1:c3At6R/oaqEKCNdg8wHV1ftS6bRYblBhIjjI8uT2IGk= github.com/prometheus/procfs v0.0.0-20190507164030-5867b95ac084/go.mod h1:TjEm7ze935MbeOT/UhFTIMYKhuLP4wbCsTZCD3I8kEA= github.com/prometheus/procfs v0.0.2/go.mod h1:TjEm7ze935MbeOT/UhFTIMYKhuLP4wbCsTZCD3I8kEA= github.com/prometheus/procfs v0.0.5/go.mod h1:4A/X28fw3Fc593LaREMrKMqOKvUAntwMDaekg4FpcdQ= github.com/prometheus/procfs v0.0.8/go.mod h1:7Qr8sr6344vo1JqZ6HhLceV9o3AJ1Ff+GxbHq6oeK9A= github.com/prometheus/procfs v0.1.3 h1:F0+tqvhOksq22sc6iCHF5WGlWjdwj92p0udFh1VFBS8= github.com/prometheus/procfs v0.1.3/go.mod h1:lV6e/gmhEcM9IjHGsFOCxxuZ+z1YqCvr4OA4YeYWdaU= github.com/prometheus/tsdb v0.7.1/go.mod h1:qhTCs0VvXwvX/y3TZrWD7rabWM+ijKTux40TwIPHuXU= github.com/quasilyte/go-consistent v0.0.0-20190521200055-c6f3937de18c/go.mod h1:5STLWrekHfjyYwxBRVRXNOSewLJ3PWfDJd1VyTS21fI= github.com/rcrowley/go-metrics v0.0.0-20200313005456-10cdbea86bc0/go.mod h1:bCqnVzQkZxMG4s8nGwiZ5l3QUCyqpo9Y+/ZMZ9VjZe4= github.com/remyoudompheng/bigfft v0.0.0-20170806203942-52369c62f446/go.mod h1:uYEyJGbgTkfkS4+E/PavXkNJcbFIpEtjt2B0KDQ5+9M= github.com/remyoudompheng/bigfft v0.0.0-20190728182440-6a916e37a237 h1:HQagqIiBmr8YXawX/le3+O26N+vPPC1PtjaF3mwnook= github.com/remyoudompheng/bigfft v0.0.0-20190728182440-6a916e37a237/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo= github.com/remyoudompheng/bigfft v0.0.0-20200410134404-eec4a21b6bb0 h1:OdAsTTz6OkFY5QxjkYwrChwuRruF69c169dPK26NUlk= github.com/remyoudompheng/bigfft v0.0.0-20200410134404-eec4a21b6bb0/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo= github.com/rivo/uniseg v0.1.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc= github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc= github.com/rogpeppe/fastuuid v0.0.0-20150106093220-6724a57986af/go.mod h1:XWv6SoW27p1b0cqNHllgS5HIMJraePCO15w5zCzIWYg= github.com/rogpeppe/fastuuid v1.2.0/go.mod h1:jVj6XXZzXRy/MSR5jhDC/2q6DgLz+nrA6LYCDYWNEvQ= github.com/rogpeppe/go-internal v1.3.0/go.mod h1:M8bDsm7K2OlrFYOpmOWEs/qY81heoFRclV5y23lUDJ4= github.com/rogpeppe/go-internal v1.3.2/go.mod h1:xXDCJY+GAPziupqXw64V24skbSoqbTEfhy4qGm1nDQc= github.com/rs/cors v1.7.0/go.mod h1:gFx+x8UowdsKA9AchylcLynDq+nNFfI8FkUZdN/jGCU= github.com/russross/blackfriday v1.5.2/go.mod h1:JO/DiYxRf+HjHt06OyowR9PTA263kcR/rfWxYHBV53g= github.com/russross/blackfriday v1.6.0 h1:KqfZb0pUVN2lYqZUYRddxF4OR8ZMURnJIG5Y3VRLtww= github.com/russross/blackfriday v1.6.0/go.mod h1:ti0ldHuxg49ri4ksnFxlkCfN+hvslNlmVHqNRXXJNAY= github.com/russross/blackfriday/v2 v2.0.1/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM= github.com/ryanuber/columnize v0.0.0-20160712163229-9b3edd62028f/go.mod h1:sm1tb6uqfes/u+d4ooFouqFdy9/2g9QGwK3SQygK0Ts= github.com/ryanuber/columnize v2.1.0+incompatible/go.mod h1:sm1tb6uqfes/u+d4ooFouqFdy9/2g9QGwK3SQygK0Ts= github.com/saintfish/chardet v0.0.0-20120816061221-3af4cd4741ca h1:NugYot0LIVPxTvN8n+Kvkn6TrbMyxQiuvKdEwFdR9vI= github.com/saintfish/chardet v0.0.0-20120816061221-3af4cd4741ca/go.mod h1:uugorj2VCxiV1x+LzaIdVa9b4S4qGAcH6cbhh4qVxOU= github.com/samuel/go-zookeeper v0.0.0-20200724154423-2164a8ac840e/go.mod h1:gi+0XIa01GRL2eRQVjQkKGqKF3SF9vZR/HnPullcV2E= github.com/sasha-s/go-deadlock v0.2.0/go.mod h1:StQn567HiB1fF2yJ44N9au7wOhrPS3iZqiDbRupzT10= github.com/satori/go.uuid v0.0.0-20160713180306-0aa62d5ddceb/go.mod h1:dA0hQrYB0VpLJoorglMZABFdXlWrHn1NEOzdhQKdks0= github.com/satori/go.uuid v1.2.0/go.mod h1:dA0hQrYB0VpLJoorglMZABFdXlWrHn1NEOzdhQKdks0= github.com/sean-/seed v0.0.0-20170313163322-e2103e2c3529/go.mod h1:DxrIzT+xaE7yg65j358z/aeFdxmN0P9QXhEzd20vsDc= github.com/securego/gosec v0.0.0-20191002120514-e680875ea14d/go.mod h1:w5+eXa0mYznDkHaMCXA4XYffjlH+cy1oyKbfzJXa2Do= github.com/securego/gosec v0.0.0-20191217083152-cb4f343eaff1/go.mod h1:sM2KJ/O9PKom+0jAmXpblJ8PWrLbGAk6F2Lzwj4H6wg= github.com/sergi/go-diff v1.0.0/go.mod h1:0CfEIISq7TuYL3j771MWULgwwjU+GofnZX9QAmXWZgo= github.com/sergi/go-diff v1.0.1-0.20180205163309-da645544ed44/go.mod h1:0CfEIISq7TuYL3j771MWULgwwjU+GofnZX9QAmXWZgo= github.com/sergi/go-diff v1.1.0/go.mod h1:STckp+ISIX8hZLjrqAeVduY0gWCT9IjLuqbuNXdaHfM= github.com/shiena/ansicolor v0.0.0-20151119151921-a422bbe96644 h1:X+yvsM2yrEktyI+b2qND5gpH8YhURn0k8OCaeRnkINo= github.com/shiena/ansicolor v0.0.0-20151119151921-a422bbe96644/go.mod h1:nkxAfR/5quYxwPZhyDxgasBMnRtBZd0FCEpawpjMUFg= github.com/shirou/gopsutil v0.0.0-20190901111213-e4ec7b275ada/go.mod h1:WWnYX4lzhCH5h/3YBfyVA3VbLYjlMZZAQcW9ojMexNc= github.com/shirou/gopsutil v2.19.10+incompatible h1:lA4Pi29JEVIQIgATSeftHSY0rMGI9CLrl2ZvDLiahto= github.com/shirou/gopsutil v2.19.10+incompatible/go.mod h1:5b4v6he4MtMOwMlS0TUMTu2PcXUg8+E1lC7eC3UO/RA= github.com/shirou/gopsutil v3.21.2+incompatible h1:U+YvJfjCh6MslYlIAXvPtzhW3YZEtc9uncueUNpD/0A= github.com/shirou/gopsutil v3.21.2+incompatible/go.mod h1:5b4v6he4MtMOwMlS0TUMTu2PcXUg8+E1lC7eC3UO/RA= github.com/shirou/w32 v0.0.0-20160930032740-bb4de0191aa4/go.mod h1:qsXQc7+bwAM3Q1u/4XEfrquwF8Lw7D7y5cD8CuHnfIc= github.com/shurcooL/go v0.0.0-20180423040247-9e1955d9fb6e/go.mod h1:TDJrrUr11Vxrven61rcy3hJMUqaf/CLWYhHNPmT14Lk= github.com/shurcooL/go-goon v0.0.0-20170922171312-37c2f522c041/go.mod h1:N5mDOmsrJOB+vfqUK+7DmDyjhSLIIBnXo9lvZJj3MWQ= github.com/shurcooL/httpfs v0.0.0-20171119174359-809beceb2371/go.mod h1:ZY1cvUeJuFPAdZ/B6v7RHavJWZn2YPVFQ1OSXhCGOkg= github.com/shurcooL/httpfs v0.0.0-20190707220628-8d4bc4ba7749/go.mod h1:ZY1cvUeJuFPAdZ/B6v7RHavJWZn2YPVFQ1OSXhCGOkg= github.com/shurcooL/httpgzip v0.0.0-20190720172056-320755c1c1b0/go.mod h1:919LwcH0M7/W4fcZ0/jy0qGght1GIhqyS/EgWGH2j5Q= github.com/shurcooL/sanitized_anchor_name v1.0.0/go.mod h1:1NzhyTcUVG4SuEtjjoZeVRXNmyL/1OwPU0+IJeTBvfc= github.com/shurcooL/vfsgen v0.0.0-20181020040650-a97a25d856ca/go.mod h1:TrYk7fJVaAttu97ZZKrO9UbRa8izdowaMIZcxYMbVaw= github.com/shurcooL/vfsgen v0.0.0-20181202132449-6a9ea43bcacd/go.mod h1:TrYk7fJVaAttu97ZZKrO9UbRa8izdowaMIZcxYMbVaw= github.com/siddontang/go v0.0.0-20170517070808-cb568a3e5cc0/go.mod h1:3yhqj7WBBfRhbBlzyOC3gUxftwsU0u8gqevxwIHQpMw= github.com/siddontang/goredis v0.0.0-20150324035039-760763f78400/go.mod h1:DDcKzU3qCuvj/tPnimWSsZZzvk9qvkvrIL5naVBPh5s= github.com/siddontang/rdb v0.0.0-20150307021120-fc89ed2e418d/go.mod h1:AMEsy7v5z92TR1JKMkLLoaOQk++LVnOKL3ScbJ8GNGA= github.com/sirupsen/logrus v1.2.0/go.mod h1:LxeOpSwHxABJmUn/MG1IvRgCAasNZTLOkJPxbbu5VWo= github.com/sirupsen/logrus v1.4.2 h1:SPIRibHv4MatM3XXNO2BJeFLZwZ2LvZgfQ5+UNI2im4= github.com/sirupsen/logrus v1.4.2/go.mod h1:tLMulIdttU9McNUspp0xgXVQah82FyeX6MwdIuYE2rE= github.com/sirupsen/logrus v1.6.0/go.mod h1:7uNnSEd1DgxDLC74fIahvMZmmYsHGZGEOFrfsX/uA88= github.com/sirupsen/logrus v1.8.1 h1:dJKuHgqk1NNQlqoA6BTlM1Wf9DOH3NBjQyu0h9+AZZE= github.com/sirupsen/logrus v1.8.1/go.mod h1:yWOB1SBYBC5VeMP7gHvWumXLIWorT60ONWic61uBYv0= github.com/sjmudd/stopwatch v0.0.0-20170613150411-f380bf8a9be1/go.mod h1:Pgf1sZ2KrHK8vdRTV5UHGp80LT7HMUKuNAiKC402abY= github.com/smartystreets/assertions v0.0.0-20180927180507-b2de0cb4f26d/go.mod h1:OnSkiWE9lh6wB0YB77sQom3nweQdgAjqCqsofrRNTgc= github.com/smartystreets/assertions v0.0.0-20190116191733-b6c0e53d7304/go.mod h1:OnSkiWE9lh6wB0YB77sQom3nweQdgAjqCqsofrRNTgc= github.com/smartystreets/goconvey v0.0.0-20181108003508-044398e4856c/go.mod h1:XDJAKZRPZ1CvBcN2aX5YOUTYGHki24fSF0Iv48Ibg0s= github.com/smartystreets/goconvey v1.6.4/go.mod h1:syvi0/a8iFYH4r/RixwvyeAJjdLS9QV7WQ/tjFTllLA= github.com/softlayer/softlayer-go v0.0.0-20180806151055-260589d94c7d/go.mod h1:Cw4GTlQccdRGSEf6KiMju767x0NEHE0YIVPJSaXjlsw= github.com/soheilhy/cmux v0.1.4/go.mod h1:IM3LyeVVIOuxMH7sFAkER9+bJ4dT7Ms6E4xg4kGIyLM= github.com/sourcegraph/go-diff v0.5.1/go.mod h1:j2dHj3m8aZgQO8lMTcTnBcXkRRRqi34cd2MNlA9u1mE= github.com/spaolacci/murmur3 v0.0.0-20180118202830-f09979ecbc72/go.mod h1:JwIasOWyU6f++ZhiEuf87xNszmSA2myDM2Kzu9HwQUA= github.com/spf13/afero v1.1.2/go.mod h1:j4pytiNVoe2o6bmDsKpLACNPDBIoEAkihy7loJ1B0CQ= github.com/spf13/afero v1.2.2/go.mod h1:9ZxEEn6pIJ8Rxe320qSDBk6AsU0r9pR7Q4OcevTdifk= github.com/spf13/cast v1.3.0/go.mod h1:Qx5cxh0v+4UWYiBimWS+eyWzqEqokIECu5etghLkUJE= github.com/spf13/cast v1.3.1/go.mod h1:Qx5cxh0v+4UWYiBimWS+eyWzqEqokIECu5etghLkUJE= github.com/spf13/cobra v0.0.3/go.mod h1:1l0Ry5zgKvJasoi3XT1TypsSe7PqH0Sj9dhYf7v3XqQ= github.com/spf13/cobra v0.0.5/go.mod h1:3K3wKZymM7VvHMDS9+Akkh4K60UwM26emMESw8tLCHU= github.com/spf13/cobra v1.0.0/go.mod h1:/6GTrnGXV9HjY+aR4k0oJ5tcvakLuG6EuKReYlHNrgE= github.com/spf13/cobra v1.1.1/go.mod h1:WnodtKOvamDL/PwE2M4iKs8aMDBZ5Q5klgD3qfVJQMI= github.com/spf13/jwalterweatherman v1.0.0/go.mod h1:cQK4TGJAtQXfYWX+Ddv3mKDzgVb68N+wFjFa4jdeBTo= github.com/spf13/jwalterweatherman v1.1.0/go.mod h1:aNWZUN0dPAAO/Ljvb5BEdw96iTZ0EXowPYD95IqWIGo= github.com/spf13/pflag v0.0.0-20170130214245-9ff6c6923cff/go.mod h1:DYY7MBk1bdzusC3SYhjObp+wFpr4gzcvqqNjLnInEg4= github.com/spf13/pflag v1.0.1/go.mod h1:DYY7MBk1bdzusC3SYhjObp+wFpr4gzcvqqNjLnInEg4= github.com/spf13/pflag v1.0.3/go.mod h1:DYY7MBk1bdzusC3SYhjObp+wFpr4gzcvqqNjLnInEg4= github.com/spf13/pflag v1.0.5/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg= github.com/spf13/viper v1.3.2/go.mod h1:ZiWeW+zYFKm7srdB9IoDzzZXaJaI5eL9QjNiN/DMA2s= github.com/spf13/viper v1.4.0/go.mod h1:PTJ7Z/lr49W6bUbkmS1V3by4uWynFiR9p7+dSq/yZzE= github.com/spf13/viper v1.6.1/go.mod h1:t3iDnF5Jlj76alVNuyFBk5oUMCvsrkbvZK0WQdfDi5k= github.com/spf13/viper v1.7.0/go.mod h1:8WkrPz2fc9jxqZNCJI/76HCieCp4Q8HaLFoCha5qpdg= github.com/spyzhov/ajson v0.4.2/go.mod h1:63V+CGM6f1Bu/p4nLIN8885ojBdt88TbLoSFzyqMuVA= github.com/ssdb/gossdb v0.0.0-20180723034631-88f6b59b84ec/go.mod h1:QBvMkMya+gXctz3kmljlUCu/yB3GZ6oee+dUozsezQE= github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= github.com/stretchr/objx v0.1.1/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= github.com/stretchr/objx v0.2.0/go.mod h1:qt09Ya8vawLte6SNmTgCsAVtYtaKzEcn8ATUoHMkEqE= github.com/stretchr/testify v0.0.0-20151208002404-e3a8ff8ce365/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs= github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs= github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4= github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA= github.com/stretchr/testify v1.6.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/subosito/gotenv v1.2.0/go.mod h1:N0PQaV/YGNqwC0u51sEeR/aUtSLEXKX9iv69rRypqCw= github.com/swaggo/files v0.0.0-20190704085106-630677cd5c14/go.mod h1:gxQT6pBGRuIGunNf/+tSOB5OHvguWi8Tbt82WOkf35E= github.com/swaggo/gin-swagger v1.2.0/go.mod h1:qlH2+W7zXGZkczuL+r2nEBR2JTT+/lX05Nn6vPhc7OI= github.com/swaggo/http-swagger v0.0.0-20200103000832-0e9263c4b516/go.mod h1:O1lAbCgAAX/KZ80LM/OXwtWFI/5TvZlwxSg8Cq08PV0= github.com/swaggo/http-swagger v0.0.0-20200308142732-58ac5e232fba/go.mod h1:O1lAbCgAAX/KZ80LM/OXwtWFI/5TvZlwxSg8Cq08PV0= github.com/swaggo/swag v1.5.1/go.mod h1:1Bl9F/ZBpVWh22nY0zmYyASPO1lI/zIwRDrpZU+tv8Y= github.com/swaggo/swag v1.6.3/go.mod h1:wcc83tB4Mb2aNiL/HP4MFeQdpHUrca+Rp/DRNgWAUio= github.com/swaggo/swag v1.6.5/go.mod h1:Y7ZLSS0d0DdxhWGVhQdu+Bu1QhaF5k0RD7FKdiAykeY= github.com/swaggo/swag v1.6.6-0.20200529100950-7c765ddd0476/go.mod h1:xDhTyuFIujYiN3DKWC/H/83xcfHp+UE/IzWWampG7Zc= github.com/syndtr/goleveldb v0.0.0-20160425020131-cfa635847112/go.mod h1:Z4AUp2Km+PwemOoO/VB5AOx9XSsIItzFjoJlOSiYmn0= github.com/syndtr/goleveldb v0.0.0-20180815032940-ae2bd5eed72d/go.mod h1:Z4AUp2Km+PwemOoO/VB5AOx9XSsIItzFjoJlOSiYmn0= github.com/syndtr/goleveldb v0.0.0-20181127023241-353a9fca669c/go.mod h1:Z4AUp2Km+PwemOoO/VB5AOx9XSsIItzFjoJlOSiYmn0= github.com/syndtr/goleveldb v1.0.1-0.20190318030020-c3a204f8e965/go.mod h1:9OrXJhf154huy1nPWmuSrkgjPUtUNhA+Zmy+6AESzuA= github.com/tchap/go-patricia v0.0.0-20160729071656-dd168db6051b/go.mod h1:bmLyhP68RS6kStMGxByiQ23RP/odRBOTVjwp2cDyi6I= github.com/tebeka/selenium v0.9.9/go.mod h1:5Fr8+pUvU6B1OiPfkdCKdXZyr5znvVkxuPd0NOdZCQc= github.com/tent/http-link-go v0.0.0-20130702225549-ac974c61c2f9/go.mod h1:RHkNRtSLfOK7qBTHaeSX1D6BNpI3qw7NTxsmNr4RvN8= github.com/thoas/go-funk v0.7.0/go.mod h1:+IWnUfUmFO1+WVYQWQtIJHeRRdaIyyYglZN7xzUPe4Q= github.com/tiancaiamao/appdash v0.0.0-20181126055449-889f96f722a2/go.mod h1:2PfKggNGDuadAa0LElHrByyrz4JPZ9fFx6Gs7nx7ZZU= github.com/tidwall/gjson v1.3.5/go.mod h1:P256ACg0Mn+j1RXIDXoss50DeIABTYK1PULOJHhxOls= github.com/tidwall/gjson v1.7.5 h1:zmAN/xmX7OtpAkv4Ovfso60r/BiCi5IErCDYGNJu+uc= github.com/tidwall/gjson v1.7.5/go.mod h1:5/xDoumyyDNerp2U36lyolv46b3uF/9Bu6OfyQ9GImk= github.com/tidwall/gjson v1.12.1 h1:ikuZsLdhr8Ws0IdROXUS1Gi4v9Z4pGqpX/CvJkxvfpo= github.com/tidwall/gjson v1.12.1/go.mod h1:/wbyibRr2FHMks5tjHJ5F8dMZh3AcwJEMf5vlfC0lxk= github.com/tidwall/match v1.0.1/go.mod h1:LujAq0jyVjBy028G1WhWfIzbpQfMO8bBZ6Tyb0+pL9E= github.com/tidwall/match v1.0.3 h1:FQUVvBImDutD8wJLN6c5eMzWtjgONK9MwIBCOrUJKeE= github.com/tidwall/match v1.0.3/go.mod h1:eRSPERbgtNPcGhD8UCthc6PmLEQXEWd3PRB5JTxsfmM= github.com/tidwall/match v1.1.1 h1:+Ho715JplO36QYgwN9PGYNhgZvoUSc9X2c80KVTi+GA= github.com/tidwall/match v1.1.1/go.mod h1:eRSPERbgtNPcGhD8UCthc6PmLEQXEWd3PRB5JTxsfmM= github.com/tidwall/pretty v1.0.0/go.mod h1:XNkn88O1ChpSDQmQeStsy+sBenx6DDtFZJxhVysOjyk= github.com/tidwall/pretty v1.1.0 h1:K3hMW5epkdAVwibsQEfR/7Zj0Qgt4DxtNumTq/VloO8= github.com/tidwall/pretty v1.1.0/go.mod h1:XNkn88O1ChpSDQmQeStsy+sBenx6DDtFZJxhVysOjyk= github.com/tidwall/pretty v1.2.0 h1:RWIZEg2iJ8/g6fDDYzMpobmaoGh5OLl4AXtGUGPcqCs= github.com/tidwall/pretty v1.2.0/go.mod h1:ITEVvHYasfjBbM0u2Pg8T2nJnzm8xPwvNhhsoaGGjNU= github.com/tikv/pd v1.1.0-beta.0.20210323121136-78679e5e209d h1:K0XnvsnT6ofLDuM8Rt3PuFQO4p8bNraeHYstspD316g= github.com/tikv/pd v1.1.0-beta.0.20210323121136-78679e5e209d/go.mod h1:Jw9KG11C/23Rr7DW4XWQ7H5xOgGZo6DFL1OKAF4+Igw= github.com/timakin/bodyclose v0.0.0-20190930140734-f7f2e9bca95e/go.mod h1:Qimiffbc6q9tBWlVV6x0P9sat/ao1xEkREYPPj9hphk= github.com/tinylib/msgp v1.1.1/go.mod h1:+d+yLhGm8mzTaHzB+wgMYrodPfmZrzkirds8fDWklFE= github.com/tklauser/go-sysconf v0.3.4/go.mod h1:Cl2c8ZRWfHD5IrfHo9VN+FX9kCFjIOyVklgXycLB6ek= github.com/tklauser/numcpus v0.2.1/go.mod h1:9aU+wOc6WjUIZEwWMP62PL/41d65P+iks1gBkr4QyP8= github.com/tmc/grpc-websocket-proxy v0.0.0-20170815181823-89b8d40f7ca8/go.mod h1:ncp9v5uamzpCO7NfCPTXjqaC+bZgJeR0sMTm6dMHP7U= github.com/tmc/grpc-websocket-proxy v0.0.0-20171017195756-830351dc03c6/go.mod h1:ncp9v5uamzpCO7NfCPTXjqaC+bZgJeR0sMTm6dMHP7U= github.com/tmc/grpc-websocket-proxy v0.0.0-20190109142713-0ad062ec5ee5/go.mod h1:ncp9v5uamzpCO7NfCPTXjqaC+bZgJeR0sMTm6dMHP7U= github.com/tv42/httpunix v0.0.0-20150427012821-b75d8614f926/go.mod h1:9ESjWnEqriFuLhtthL60Sar/7RFoluCcXsuvEwTV5KM= github.com/twmb/murmur3 v1.1.3/go.mod h1:Qq/R7NUyOfr65zD+6Q5IHKsJLwP7exErjN6lyyq3OSQ= github.com/uber-go/atomic v1.3.2/go.mod h1:/Ct5t2lcmbJ4OSe/waGBoaVvVqtO0bmtfVNex1PFV8g= github.com/uber-go/atomic v1.4.0/go.mod h1:/Ct5t2lcmbJ4OSe/waGBoaVvVqtO0bmtfVNex1PFV8g= github.com/uber/jaeger-client-go v2.15.0+incompatible/go.mod h1:WVhlPFC8FDjOFMMWRy2pZqQJSXxYSwNYOkTr/Z6d3Kk= github.com/uber/jaeger-client-go v2.16.0+incompatible/go.mod h1:WVhlPFC8FDjOFMMWRy2pZqQJSXxYSwNYOkTr/Z6d3Kk= github.com/uber/jaeger-client-go v2.22.1+incompatible h1:NHcubEkVbahf9t3p75TOCR83gdUHXjRJvjoBh1yACsM= github.com/uber/jaeger-client-go v2.22.1+incompatible/go.mod h1:WVhlPFC8FDjOFMMWRy2pZqQJSXxYSwNYOkTr/Z6d3Kk= github.com/uber/jaeger-lib v1.5.0/go.mod h1:ComeNDZlWwrWnDv8aPp0Ba6+uUTzImX/AauajbLI56U= github.com/uber/jaeger-lib v2.0.0+incompatible/go.mod h1:ComeNDZlWwrWnDv8aPp0Ba6+uUTzImX/AauajbLI56U= github.com/uber/jaeger-lib v2.4.0+incompatible h1:fY7QsGQWiCt8pajv4r7JEvmATdCVaWxXbjwyYwsNaLQ= github.com/uber/jaeger-lib v2.4.0+incompatible/go.mod h1:ComeNDZlWwrWnDv8aPp0Ba6+uUTzImX/AauajbLI56U= github.com/ugorji/go v0.0.0-20171122102828-84cb69a8af83/go.mod h1:hnLbHMwcvSihnDhEfx2/BzKp2xb0Y+ErdfYcrs9tkJQ= github.com/ugorji/go v1.1.4/go.mod h1:uQMGLiO92mf5W77hV/PUCpI3pbzQx3CRekS0kk+RGrc= github.com/ugorji/go v1.1.5-pre/go.mod h1:FwP/aQVg39TXzItUBMwnWp9T9gPQnXw4Poh4/oBQZ/0= github.com/ugorji/go v1.1.7/go.mod h1:kZn38zHttfInRq0xu/PH0az30d+z6vm202qpg1oXVMw= github.com/ugorji/go/codec v0.0.0-20181022190402-e5e69e061d4f/go.mod h1:VFNgLljTbGfSG7qAOspJ7OScBnGdDN/yBr0sguwnwf0= github.com/ugorji/go/codec v0.0.0-20181204163529-d75b2dcb6bc8/go.mod h1:VFNgLljTbGfSG7qAOspJ7OScBnGdDN/yBr0sguwnwf0= github.com/ugorji/go/codec v1.1.5-pre/go.mod h1:tULtS6Gy1AE1yCENaw4Vb//HLH5njI2tfCQDUqRd8fI= github.com/ugorji/go/codec v1.1.7/go.mod h1:Ax+UKWsSmolVDwsd+7N3ZtXu+yMGCf907BLYF3GoBXY= github.com/ultraware/funlen v0.0.2/go.mod h1:Dp4UiAus7Wdb9KUZsYWZEWiRzGuM2kXM1lPbfaF6xhA= github.com/ultraware/whitespace v0.0.4/go.mod h1:aVMh/gQve5Maj9hQ/hg+F75lr/X5A89uZnzAmWSineA= github.com/unrolled/render v0.0.0-20171102162132-65450fb6b2d3/go.mod h1:tu82oB5W2ykJRVioYsB+IQKcft7ryBr7w12qMBUPyXg= github.com/unrolled/render v1.0.1/go.mod h1:gN9T0NhL4Bfbwu8ann7Ry/TGHYfosul+J0obPf6NBdM= github.com/urfave/cli v1.20.0/go.mod h1:70zkFmudgCuE/ngEzBv17Jvp/497gISqfk5gWijbERA= github.com/urfave/cli v1.22.2/go.mod h1:Gos4lmkARVdJ6EkW0WaNv/tZAAMe9V7XWyB60NtXRu0= github.com/urfave/cli/v2 v2.1.1/go.mod h1:SE9GqnLQmjVa0iPEY0f1w3ygNIYcIJ0OKPMoW2caLfQ= github.com/urfave/negroni v0.3.0/go.mod h1:Meg73S6kFm/4PpbYdq35yYWoCZ9mS/YSx+lKnmiohz4= github.com/uudashr/gocognit v0.0.0-20190926065955-1655d0de0517/go.mod h1:j44Ayx2KW4+oB6SWMv8KsmHzZrOInQav7D3cQMJ5JUM= github.com/uudashr/gocognit v1.0.1/go.mod h1:j44Ayx2KW4+oB6SWMv8KsmHzZrOInQav7D3cQMJ5JUM= github.com/valyala/bytebufferpool v1.0.0/go.mod h1:6bBcMArwyJ5K/AmCkWv1jt77kVWyCJ6HpOuEn7z0Csc= github.com/valyala/fasthttp v1.2.0/go.mod h1:4vX61m6KN+xDduDNwXrhIAVZaZaZiQ1luJk8LWSxF3s= github.com/valyala/fasttemplate v1.0.1/go.mod h1:UQGH1tvbgY+Nz5t2n7tXsz52dQxojPUpymEIMZ47gx8= github.com/valyala/quicktemplate v1.2.0/go.mod h1:EH+4AkTd43SvgIbQHYu59/cJyxDoOVRUAfrukLPuGJ4= github.com/valyala/tcplisten v0.0.0-20161114210144-ceec8f93295a/go.mod h1:v3UYOV9WzVtRmSR+PDvWpU/qWl4Wa5LApYYX4ZtKbio= github.com/vektah/gqlparser v1.1.2/go.mod h1:1ycwN7Ij5njmMkPPAOaRFY4rET2Enx7IkVv3vaXspKw= github.com/vmihailenco/msgpack/v4 v4.3.11/go.mod h1:gborTTJjAo/GWTqqRjrLCn9pgNN+NXzzngzBKDPIqw4= github.com/vmihailenco/msgpack/v5 v5.0.0-beta.1/go.mod h1:xlngVLeyQ/Qi05oQxhQ+oTuqa03RjMwMfk/7/TCs+QI= github.com/vmihailenco/tagparser v0.1.1/go.mod h1:OeAg3pn3UbLjkWt+rN9oFYB6u/cQgqMEUPoW2WPyhdI= github.com/vmware/govmomi v0.18.0/go.mod h1:URlwyTFZX72RmxtxuaFL2Uj3fD1JTvZdx59bHWk6aFU= github.com/wendal/errors v0.0.0-20130201093226-f66c77a7882b/go.mod h1:Q12BUT7DqIlHRmgv3RskH+UCM/4eqVMgI0EMmlSpAXc= github.com/xiang90/probing v0.0.0-20190116061207-43a291ad63a2/go.mod h1:UETIi67q53MR2AWcXfiuqkDkRtnGDLqkBTpCHuJHxtU= github.com/xitongsys/parquet-go v1.5.1/go.mod h1:xUxwM8ELydxh4edHGegYq1pA8NnMKDx0K/GyB0o2bww= github.com/xitongsys/parquet-go v1.5.5-0.20201110004701-b09c49d6d457/go.mod h1:pheqtXeHQFzxJk45lRQ0UIGIivKnLXvialZSFWs81A8= github.com/xitongsys/parquet-go-source v0.0.0-20190524061010-2b72cbee77d5/go.mod h1:xxCx7Wpym/3QCo6JhujJX51dzSXrwmb0oH6FQb39SEA= github.com/xitongsys/parquet-go-source v0.0.0-20200817004010-026bad9b25d0/go.mod h1:HYhIKsdns7xz80OgkbgJYrtQY7FjHWHKH6cvN7+czGE= github.com/xordataexchange/crypt v0.0.3-0.20170626215501-b2862e3d0a77/go.mod h1:aYKd//L2LvnjZzWKhF00oedf4jCCReLcmhLdhm1A27Q= github.com/yookoala/realpath v1.0.0/go.mod h1:gJJMA9wuX7AcqLy1+ffPatSCySA1FQ2S8Ya9AIoYBpE= github.com/yuin/goldmark v1.1.25/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= github.com/yuin/gopher-lua v0.0.0-20171031051903-609c9cd26973/go.mod h1:aEV29XrmTYFr3CiRxZeGHpkvbwq+prZduBqMaascyCU= github.com/z-division/go-zookeeper v0.0.0-20190128072838-6d7457066b9b/go.mod h1:JNALoWa+nCXR8SmgLluHcBNVJgyejzpKPZk9pX2yXXE= go.etcd.io/bbolt v1.3.2/go.mod h1:IbVyRI1SCnLcuJnV2u8VeU0CEYM7e686BmAb1XKL+uU= go.etcd.io/bbolt v1.3.3/go.mod h1:IbVyRI1SCnLcuJnV2u8VeU0CEYM7e686BmAb1XKL+uU= go.etcd.io/etcd v0.0.0-20191023171146-3cf2f69b5738/go.mod h1:dnLIgRNXwCJa5e+c6mIZCrds/GIG4ncV9HhK5PX7jPg= go.etcd.io/etcd v0.5.0-alpha.5.0.20191023171146-3cf2f69b5738/go.mod h1:dnLIgRNXwCJa5e+c6mIZCrds/GIG4ncV9HhK5PX7jPg= go.etcd.io/etcd v0.5.0-alpha.5.0.20200824191128-ae9734ed278b h1:3kC4J3eQF6p1UEfQTkC67eEeb3rTk+shQqdX6tFyq9Q= go.etcd.io/etcd v0.5.0-alpha.5.0.20200824191128-ae9734ed278b/go.mod h1:yVHk9ub3CSBatqGNg7GRmsnfLWtoW60w4eDYfh7vHDg= go.mongodb.org/mongo-driver v1.0.3/go.mod h1:u7ryQJ+DOzQmeO7zB6MHyr8jkEQvC8vH7qLUO4lqsUM= go.mongodb.org/mongo-driver v1.1.1/go.mod h1:u7ryQJ+DOzQmeO7zB6MHyr8jkEQvC8vH7qLUO4lqsUM= go.mongodb.org/mongo-driver v1.1.2/go.mod h1:u7ryQJ+DOzQmeO7zB6MHyr8jkEQvC8vH7qLUO4lqsUM= go.opencensus.io v0.21.0/go.mod h1:mSImk1erAIZhrmZN+AvHh14ztQfjbGwt4TtuofqLduU= go.opencensus.io v0.22.0/go.mod h1:+kGneAE2xo2IficOXnaByMWTGM9T73dGwxeWcUqIpI8= go.opencensus.io v0.22.2/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw= go.opencensus.io v0.22.3/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw= go.uber.org/atomic v1.3.2/go.mod h1:gD2HeocX3+yG+ygLZcrzQJaqmWj9AIm7n08wl/qW/PE= go.uber.org/atomic v1.4.0/go.mod h1:gD2HeocX3+yG+ygLZcrzQJaqmWj9AIm7n08wl/qW/PE= go.uber.org/atomic v1.5.0/go.mod h1:sABNBOSYdrvTF6hTgEIbc7YasKWGhgEQZyfxyTvoXHQ= go.uber.org/atomic v1.6.0 h1:Ezj3JGmsOnG1MoRWQkPBsKLe9DwWD9QeXzTRzzldNVk= go.uber.org/atomic v1.6.0/go.mod h1:sABNBOSYdrvTF6hTgEIbc7YasKWGhgEQZyfxyTvoXHQ= go.uber.org/atomic v1.7.0 h1:ADUqmZGgLDDfbSL9ZmPxKTybcoEYHgpYfELNoN+7hsw= go.uber.org/atomic v1.7.0/go.mod h1:fEN4uk6kAWBTFdckzkM89CLk9XfWZrxpCo0nPH17wJc= go.uber.org/automaxprocs v1.2.0/go.mod h1:YfO3fm683kQpzETxlTGZhGIVmXAhaw3gxeBADbpZtnU= go.uber.org/dig v1.8.0/go.mod h1:X34SnWGr8Fyla9zQNO2GSO2D+TIuqB14OS8JhYocIyw= go.uber.org/fx v1.10.0/go.mod h1:vLRicqpG/qQEzno4SYU86iCwfT95EZza+Eba0ItuxqY= go.uber.org/goleak v0.10.0/go.mod h1:VCZuO8V8mFPlL0F5J5GK1rtHV3DrFcQ1R8ryq7FK0aI= go.uber.org/multierr v1.1.0/go.mod h1:wR5kodmAFQ0UK8QlbwjlSNy0Z68gJhDJUG5sjR94q/0= go.uber.org/multierr v1.3.0/go.mod h1:VgVr7evmIr6uPjLBxg28wmKNXyqE9akIJ5XnfpiKl+4= go.uber.org/multierr v1.4.0/go.mod h1:VgVr7evmIr6uPjLBxg28wmKNXyqE9akIJ5XnfpiKl+4= go.uber.org/multierr v1.5.0 h1:KCa4XfM8CWFCpxXRGok+Q0SS/0XBhMDbHHGABQLvD2A= go.uber.org/multierr v1.5.0/go.mod h1:FeouvMocqHpRaaGuG9EjoKcStLC43Zu/fmqdUMPcKYU= go.uber.org/multierr v1.6.0/go.mod h1:cdWPpRnG4AhwMwsgIHip0KRBQjJy5kYEpYjJxpXp9iU= go.uber.org/multierr v1.7.0 h1:zaiO/rmgFjbmCXdSYJWQcdvOCsthmdaHfr3Gm2Kx4Ec= go.uber.org/multierr v1.7.0/go.mod h1:7EAYxJLBy9rStEaz58O2t4Uvip6FSURkq8/ppBp95ak= go.uber.org/tools v0.0.0-20190618225709-2cfd321de3ee/go.mod h1:vJERXedbb3MVM5f9Ejo0C68/HhF8uaILCdgjnY+goOA= go.uber.org/zap v1.8.0/go.mod h1:vwi/ZaCAaUcBkycHslxD9B2zi4UTXhF60s6SWpuDF0Q= go.uber.org/zap v1.9.1/go.mod h1:vwi/ZaCAaUcBkycHslxD9B2zi4UTXhF60s6SWpuDF0Q= go.uber.org/zap v1.10.0/go.mod h1:vwi/ZaCAaUcBkycHslxD9B2zi4UTXhF60s6SWpuDF0Q= go.uber.org/zap v1.12.0/go.mod h1:zwrFLgMcdUuIBviXEYEH1YKNaOBnKXsx2IPda5bBwHM= go.uber.org/zap v1.13.0/go.mod h1:zwrFLgMcdUuIBviXEYEH1YKNaOBnKXsx2IPda5bBwHM= go.uber.org/zap v1.14.0 h1:/pduUoebOeeJzTDFuoMgC6nRkiasr1sBCIEorly7m4o= go.uber.org/zap v1.14.0/go.mod h1:zwrFLgMcdUuIBviXEYEH1YKNaOBnKXsx2IPda5bBwHM= go.uber.org/zap v1.15.0 h1:ZZCA22JRF2gQE5FoNmhmrf7jeJJ2uhqDUNRYKm8dvmM= go.uber.org/zap v1.15.0/go.mod h1:Mb2vm2krFEG5DV0W9qcHBYFtp/Wku1cvYaqPsS/WYfc= go.uber.org/zap v1.16.0/go.mod h1:MA8QOfq0BHJwdXa996Y4dYkAqRKB8/1K1QMMZVaNZjQ= go.uber.org/zap v1.17.0 h1:MTjgFu6ZLKvY6Pvaqk97GlxNBuMpV4Hy/3P6tRGlI2U= go.uber.org/zap v1.17.0/go.mod h1:MXVU+bhUf/A7Xi2HNOnopQOrmycQ5Ih87HtOu4q5SSo= golang.org/x/crypto v0.0.0-20180723164146-c126467f60eb/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= golang.org/x/crypto v0.0.0-20180904163835-0709b304e793/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= golang.org/x/crypto v0.0.0-20181029021203-45a5f77698d3/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= golang.org/x/crypto v0.0.0-20181203042331-505ab145d0a9/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= golang.org/x/crypto v0.0.0-20190128193316-c7b33c32a30b/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= golang.org/x/crypto v0.0.0-20190211182817-74369b46fc67/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= golang.org/x/crypto v0.0.0-20190320223903-b7391e95e576/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= golang.org/x/crypto v0.0.0-20190325154230-a5d413f7728c/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= golang.org/x/crypto v0.0.0-20190510104115-cbcb75029529/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= golang.org/x/crypto v0.0.0-20190605123033-f99c8df09eb5/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= golang.org/x/crypto v0.0.0-20190611184440-5c40567a22f8/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= golang.org/x/crypto v0.0.0-20190617133340-57b3e21c3d56/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= golang.org/x/crypto v0.0.0-20190820162420-60c769a6c586/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= golang.org/x/crypto v0.0.0-20190923035154-9ee001bba392/go.mod h1:/lpIB1dKB+9EgE3H3cr1v9wB50oz8l4C4h62xy7jSTY= golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= golang.org/x/crypto v0.0.0-20191205180655-e7c4368fe9dd/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= golang.org/x/crypto v0.0.0-20191206172530-e9b2fee46413/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= golang.org/x/crypto v0.0.0-20200204104054-c9f3fb736b72/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= golang.org/x/crypto v0.0.0-20200820211705-5c72a883971a/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= golang.org/x/exp v0.0.0-20190125153040-c74c464bbbf2/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= golang.org/x/exp v0.0.0-20190306152737-a1d7652674e8/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= golang.org/x/exp v0.0.0-20190312203227-4b39c73a6495/go.mod h1:ZjyILWgesfNpC6sMxTJOJm9Kp84zZh5NQWvqDGG3Qr8= golang.org/x/exp v0.0.0-20190510132918-efd6b22b2522/go.mod h1:ZjyILWgesfNpC6sMxTJOJm9Kp84zZh5NQWvqDGG3Qr8= golang.org/x/exp v0.0.0-20190829153037-c13cbed26979/go.mod h1:86+5VVa7VpoJ4kLfm080zCjGlMRFzhUhsZKEZO7MGek= golang.org/x/exp v0.0.0-20191030013958-a1ab85dbe136/go.mod h1:JXzH8nQsPlswgeRAPE3MuO9GYsAcnJvJ4vnMwN/5qkY= golang.org/x/exp v0.0.0-20191129062945-2f5052295587/go.mod h1:2RIsYlXP63K8oxa1u096TMicItID8zy7Y6sNkU49FU4= golang.org/x/exp v0.0.0-20191227195350-da58074b4299/go.mod h1:2RIsYlXP63K8oxa1u096TMicItID8zy7Y6sNkU49FU4= golang.org/x/exp v0.0.0-20200119233911-0405dc783f0a/go.mod h1:2RIsYlXP63K8oxa1u096TMicItID8zy7Y6sNkU49FU4= golang.org/x/exp v0.0.0-20200207192155-f17229e696bd/go.mod h1:J/WKrq2StrnmMY6+EHIKF9dgMWnmCNThgcyBT1FY9mM= golang.org/x/exp v0.0.0-20200224162631-6cc2880d07d6/go.mod h1:3jZMyOhIsHpP37uCMkUooju7aAi5cS1Q23tOzKc+0MU= golang.org/x/image v0.0.0-20190227222117-0694c2d4d067/go.mod h1:kZ7UVZpmo3dzQBMxlp+ypCbDeSB+sBbTgSJuh5dn5js= golang.org/x/image v0.0.0-20190802002840-cff245a6509b/go.mod h1:FeLwcggjj3mMvU+oOTbSwawSJRM1uh48EjtB4UJZlP0= golang.org/x/image v0.0.0-20200119044424-58c23975cae1/go.mod h1:FeLwcggjj3mMvU+oOTbSwawSJRM1uh48EjtB4UJZlP0= golang.org/x/lint v0.0.0-20181026193005-c67002cb31c3/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE= golang.org/x/lint v0.0.0-20190227174305-5b3e6a55c961/go.mod h1:wehouNa3lNwaWXcvxsM5YxQ5yQlVC4a0KAMCusXpPoU= golang.org/x/lint v0.0.0-20190301231843-5614ed5bae6f/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE= golang.org/x/lint v0.0.0-20190313153728-d0100b6bd8b3/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= golang.org/x/lint v0.0.0-20190409202823-959b441ac422/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= golang.org/x/lint v0.0.0-20190909230951-414d861bb4ac/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= golang.org/x/lint v0.0.0-20190930215403-16217165b5de/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= golang.org/x/lint v0.0.0-20191125180803-fdd1cda4f05f/go.mod h1:5qLYkcX4OjUUV8bRuDixDT3tpyyb+LUpUlRWLxfhWrs= golang.org/x/lint v0.0.0-20200130185559-910be7a94367/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY= golang.org/x/lint v0.0.0-20200302205851-738671d3881b/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY= golang.org/x/mobile v0.0.0-20190312151609-d3739f865fa6/go.mod h1:z+o9i4GpDbdi3rU15maQ/Ox0txvL9dWGYEHz965HBQE= golang.org/x/mobile v0.0.0-20190719004257-d2bd2a29d028/go.mod h1:E/iHnbuqvinMTCcRqshq8CkpyQDoeVncDDYHnLhea+o= golang.org/x/mod v0.0.0-20190513183733-4bf6d317e70e/go.mod h1:mXi4GBBbnImb6dmsKGUJ2LatrhH/nqhxcFungHvyanc= golang.org/x/mod v0.1.0/go.mod h1:0QHyrYULN0/3qlju5TqG8bIK38QM8yzMo5ekMj3DlcY= golang.org/x/mod v0.1.1-0.20191105210325-c90efee705ee/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg= golang.org/x/mod v0.1.1-0.20191107180719-034126e5016b/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg= golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= golang.org/x/mod v0.4.2/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= golang.org/x/net v0.0.0-20170114055629-f2499483f923/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20180218175443-cbe0f9307d01/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20180724234803-3673e40ba225/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20180826012351-8a410e7b638d/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20180906233101-161cd47e91fd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20180911220305-26e67e76b6c3/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20181005035420-146acd28ed58/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20181023162649-9b4f9f5ad519/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20181114220301-adae6a3d119a/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20181201002055-351d144fa1fc/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20181220203305-927f97764cc3/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20190108225652-1e06a53dbb7e/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20190125091013-d26f9f9a57f3/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20190213061140-3a22650c66bd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= golang.org/x/net v0.0.0-20190320064053-1272bf9dcd53/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= golang.org/x/net v0.0.0-20190501004415-9ce7a6920f09/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= golang.org/x/net v0.0.0-20190503192946-f4e77d36d62c/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= golang.org/x/net v0.0.0-20190522155817-f3200d17e092/go.mod h1:HSz+uSET+XFnRR8LxR5pz3Of3rY3CfYBVs4xY44aLks= golang.org/x/net v0.0.0-20190603091049-60506f45cf65/go.mod h1:HSz+uSET+XFnRR8LxR5pz3Of3rY3CfYBVs4xY44aLks= golang.org/x/net v0.0.0-20190611141213-3f473d35a33a/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20190613194153-d28f0bde5980/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20190724013045-ca1201d0de80/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20190813141303-74dc4d7220e7/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20190827160401-ba9fcec4b297/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20190923162816-aa69164e4478/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20191002035440-2ec189313ef0/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20191004110552-13f9640d40b9/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20191209160850-c0dbc17a3553/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20200114155413-6afb5195e5aa/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20200202094626-16171245cfb2/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20200222125558-5a598a2470a0/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20200301022130-244492dfa37a/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20200324143707-d3edc9973b7e/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= golang.org/x/net v0.0.0-20200520182314-0ba52f642ac2/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU= golang.org/x/net v0.0.0-20201110031124-69a78807bb2b h1:uwuIcX0g4Yl1NC5XAz37xsr2lTtcqevgzYNVt49waME= golang.org/x/net v0.0.0-20201110031124-69a78807bb2b/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU= golang.org/x/net v0.0.0-20210316092652-d523dce5a7f4 h1:b0LrWgu8+q7z4J+0Y3Umo5q1dL7NXBkKBWkaVkAq17E= golang.org/x/net v0.0.0-20210316092652-d523dce5a7f4/go.mod h1:RBQZq4jEuRlivfhVLdyRGr576XBO4/greRjx4P4O3yc= golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20191202225959-858c2ad4c8b6/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20200107190931-bf48bf16ab8d/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190227155943-e225da77a7e6/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9 h1:SQFwaSi55rU7vdNs9Yr0Z324VNlrF+0wMqRXT4St8ck= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sys v0.0.0-20170830134202-bb24a47a89ea/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20180823144017-11551d06cbcc/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20180905080454-ebe1bf3edb33/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20180909124046-d0be0721c37e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20181026203630-95b1ffbd15a5/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20181107165924-66b7b1311ac8/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20181116152217-5ac8a444bdc5/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20181205085412-a5c9d58dba9a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20181228144115-9a3f9b0469bb/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20190124100055-b90733256f2e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20190209173611-3b5209105503/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20190222072716-a9d3bda3a223/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20190312061237-fead79001313/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190321052220-f7bb7a8bee54/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190422165155-953cdadca894/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190502145724-3ef323f4f1fd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190507160741-ecd444e8653b/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190606165138-5da285871e9c/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190610200419-93c9922d18ae/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190616124812-15dcb6c0061f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190624142023-c5567b49c5d0/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190626221950-04f50cda93cb/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190726091711-fc99dfbffb4e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190813064441-fde4db37ae7a/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190826190057-c7b8b68b1456/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190922100055-0a153f010e69/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190924154521-2837fb4f24fe/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20191001151750-bb3f8db39f24/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20191008105621-543471e840be/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20191010194322-b09406accb47/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20191026070338-33540a1f6037/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20191120155948-bd437916bb0e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20191128015809-6d18c012aee9/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20191204072324-ce4227a45e2e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20191228213918-04cbcbbfeed8/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200106162015-b016eb3dc98e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200113162924-86b910548bc1/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200116001909-b77594299b42/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200122134326-e047566fdf82/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200124204421-9fbb57f87de9/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200202164722-d101bd2416d5/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200212091648-12a6c2dcc1e4/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200223170610-d5e6a3e2c0ae/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200323222414-85ca7c5b95cd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200615200032-f1bc736245b1/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f h1:+Nyd8tzPX9R7BWHguqsrbFdRx3WQ/1ib8I44HXV5yTA= golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20210119212857-b64e53b001e4/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20210217105451-b926d437f341/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20210315160823-c6e025ad8005/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20210324051608-47abb6519492/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20210601080250-7ecdf8ef093b h1:qh4f65QIVFjq9eBURLEYWqaEXmOyqdUyiBSgaXWccWk= golang.org/x/sys v0.0.0-20210601080250-7ecdf8ef093b/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/text v0.0.0-20160726164857-2910a502d2bf/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk= golang.org/x/text v0.3.3 h1:cokOdA+Jmi5PJGXLlLllQSgYigAEfHXJAERHVMaCc2k= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/text v0.3.6 h1:aRYxNxv6iGQlyVaZmk6ZgYEDa+Jg18DxebPSrd6bg1M= golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/time v0.0.0-20180412165947-fbb02b2291d2/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= golang.org/x/time v0.0.0-20190308202827-9d24e82272b4/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= golang.org/x/time v0.0.0-20191024005414-555d28b269f0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= golang.org/x/tools v0.0.0-20180221164845-07fd8470d635/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20180525024113-a5b4c53f6e8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20181011042414-1f849cf54d09/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20181030221726-6c7e314b6563/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20181117154741-2ddaf7f79a09/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20190110163146-51295c7ec13a/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20190114222345-bf090417da8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20190125232054-d66bd3c5d5a6/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20190206041539-40960b6deb8e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20190226205152-f727befe758c/go.mod h1:9Yl7xja0Znq3iFh3HoIrodX9oNMXvdceNzlUR8zjMvY= golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= golang.org/x/tools v0.0.0-20190311215038-5c2858a9cfe5/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= golang.org/x/tools v0.0.0-20190312151545-0bb0c0a6e846/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= golang.org/x/tools v0.0.0-20190312170243-e65039ee4138/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= golang.org/x/tools v0.0.0-20190322203728-c1a832b0ad89/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= golang.org/x/tools v0.0.0-20190328211700-ab21143f2384/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= golang.org/x/tools v0.0.0-20190425150028-36563e24a262/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= golang.org/x/tools v0.0.0-20190506145303-2d16b83fe98c/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= golang.org/x/tools v0.0.0-20190521203540-521d6ed310dd/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= golang.org/x/tools v0.0.0-20190524140312-2c0ae7006135/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= golang.org/x/tools v0.0.0-20190606050223-4d9ae51c2468/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= golang.org/x/tools v0.0.0-20190606124116-d0a3d012864b/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= golang.org/x/tools v0.0.0-20190611222205-d73e1c7e250b/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= golang.org/x/tools v0.0.0-20190614205625-5aca471b1d59/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= golang.org/x/tools v0.0.0-20190617190820-da514acc4774/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= golang.org/x/tools v0.0.0-20190621195816-6e04913cbbac/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= golang.org/x/tools v0.0.0-20190624190245-7f2218787638/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= golang.org/x/tools v0.0.0-20190628153133-6cdbf07be9d0/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= golang.org/x/tools v0.0.0-20190719005602-e377ae9d6386/go.mod h1:jcCCGcm9btYwXyDqrUWc6MKQKKGJCWEQ3AfLSRIbEuI= golang.org/x/tools v0.0.0-20190816200558-6889da9d5479/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20190907020128-2ca718005c18/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20190910044552-dd2b5c81c578/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20190911151314-feee8acb394c/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20190911174233-4f2ddba30aff/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20190920225731-5eefd052ad72/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20190930201159-7c411dea38b0/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191010075000-0337d82405ff/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191012152004-8de300cfc20a/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191029041327-9cc4af7d6b2c/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191029190741-b9c20aec41a5/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191030062658-86caa796c7ab/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191107010934-f79515f33823/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191112195655-aa38f8e97acc/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191113191852-77e3bb0ad9e7/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191114200427-caa0b0f7d508/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191115202509-3a792d9c32b2/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191125144606-a911d9008d1f/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191130070609-6e064ea0cf2d/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191216173652-a0e659d51361/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20191217033636-bbbf87ae2631/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20191219041853-979b82bfef62/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20191227053925-7b8e75db28f4/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200117161641-43d50277825c/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200122220014-bf1340f18c4a/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200130002326-2f3ba24bd6e7/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200204074204-1cc6d1ef6c74/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200207183749-b753a1ba74fa/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200212150539-ea181f53ac56/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200224181240-023911ca70b2/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200225230052-807dcd883420/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200301222351-066e0c02454c/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.0.0-20200313205530-4303120df7d8/go.mod h1:Sl4aGygMT6LrqrWclx+PTx3U+LnKx/seiNR+3G19Ar8= golang.org/x/tools v0.0.0-20200527183253-8e7acdbce89d/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE= golang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE= golang.org/x/tools v0.0.0-20201125231158-b5590deeca9b/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= golang.org/x/tools v0.0.0-20201202200335-bef1c476418a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= golang.org/x/tools v0.0.0-20210106214847-113979e3529a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= golang.org/x/tools v0.1.0/go.mod h1:xkSsbof2nBLbhDlRMhhhyNLN/zl3eTqcnHD5viDpcZ0= golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= gonum.org/v1/gonum v0.0.0-20190331200053-3d26580ed485/go.mod h1:2ltnJ7xHfj0zHS40VVPYEAAMTa3ZGguvHGBSJeRWqE0= gonum.org/v1/netlib v0.0.0-20190313105609-8cb42192e0e0/go.mod h1:wa6Ws7BG/ESfp6dHfk7C6KdzKA7wR7u/rKwOGE66zvw= gonum.org/v1/netlib v0.0.0-20190331212654-76723241ea4e/go.mod h1:kS+toOQn6AQKjmKJ7gzohV1XkqsFehRA2FbsbkopSuQ= google.golang.org/api v0.4.0/go.mod h1:8k5glujaEP+g9n7WNsDg8QP6cUVNI86fCNMcbazEtwE= google.golang.org/api v0.7.0/go.mod h1:WtwebWUNSVBH/HAw79HIFXZNqEvBhG+Ra+ax0hx3E3M= google.golang.org/api v0.8.0/go.mod h1:o4eAsZoiT+ibD93RtjEohWalFOjRDx6CVaqeizhEnKg= google.golang.org/api v0.9.0/go.mod h1:o4eAsZoiT+ibD93RtjEohWalFOjRDx6CVaqeizhEnKg= google.golang.org/api v0.13.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI= google.golang.org/api v0.14.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI= google.golang.org/api v0.15.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI= google.golang.org/api v0.17.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE= google.golang.org/api v0.18.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE= google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM= google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= google.golang.org/appengine v1.5.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= google.golang.org/appengine v1.6.1/go.mod h1:i06prIuMbXzDqacNJfV5OdTW448YApPu5ww/cMBSeb0= google.golang.org/appengine v1.6.5/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc= google.golang.org/genproto v0.0.0-20180817151627-c66870c02cf8/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc= google.golang.org/genproto v0.0.0-20181004005441-af9cb2a35e7f/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc= google.golang.org/genproto v0.0.0-20190307195333-5fe7a883aa19/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= google.golang.org/genproto v0.0.0-20190418145605-e7d98fc518a7/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= google.golang.org/genproto v0.0.0-20190425155659-357c62f0e4bb/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= google.golang.org/genproto v0.0.0-20190502173448-54afdca5d873/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= google.golang.org/genproto v0.0.0-20190626174449-989357319d63/go.mod h1:z3L6/3dTEVtUr6QSP8miRzeRqwQOioJ9I66odjN4I7s= google.golang.org/genproto v0.0.0-20190801165951-fa694d86fc64/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc= google.golang.org/genproto v0.0.0-20190819201941-24fa4b261c55/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc= google.golang.org/genproto v0.0.0-20190911173649-1774047e7e51/go.mod h1:IbNlFCBrqXvoKpeg0TB2l7cyZUmoaFKYIwrEpbDKLA8= google.golang.org/genproto v0.0.0-20190926190326-7ee9db18f195/go.mod h1:IbNlFCBrqXvoKpeg0TB2l7cyZUmoaFKYIwrEpbDKLA8= google.golang.org/genproto v0.0.0-20190927181202-20e1ac93f88c/go.mod h1:IbNlFCBrqXvoKpeg0TB2l7cyZUmoaFKYIwrEpbDKLA8= google.golang.org/genproto v0.0.0-20191108220845-16a3f7862a1a h1:Ob5/580gVHBJZgXnff1cZDbG+xLtMVE5mDRTe+nIsX4= google.golang.org/genproto v0.0.0-20191108220845-16a3f7862a1a/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= google.golang.org/genproto v0.0.0-20191115194625-c23dd37a84c9/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= google.golang.org/genproto v0.0.0-20191216164720-4f79533eabd1/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= google.golang.org/genproto v0.0.0-20191230161307-f3c370f40bfb/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= google.golang.org/genproto v0.0.0-20200115191322-ca5a22157cba/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= google.golang.org/genproto v0.0.0-20200122232147-0452cf42e150/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= google.golang.org/genproto v0.0.0-20200204135345-fa8e72b47b90/go.mod h1:GmwEX6Z4W5gMy59cAlVYjN9JhxgbQH6Gn+gFDQe2lzA= google.golang.org/genproto v0.0.0-20200212174721-66ed5ce911ce/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= google.golang.org/genproto v0.0.0-20200224152610-e50cd9704f63 h1:YzfoEYWbODU5Fbt37+h7X16BWQbad7Q4S6gclTKFXM8= google.golang.org/genproto v0.0.0-20200224152610-e50cd9704f63/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= google.golang.org/grpc v0.0.0-20180607172857-7a6a684ca69e/go.mod h1:yo6s7OP7yaDglbqo1J04qKzAhqBH6lvTonzMVmEdcZw= google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38= google.golang.org/grpc v1.21.0/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM= google.golang.org/grpc v1.21.1/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM= google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg= google.golang.org/grpc v1.23.1/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg= google.golang.org/grpc v1.24.0 h1:vb/1TCsVn3DcJlQ0Gs1yB1pKI6Do2/QNwxdKqmc/b0s= google.golang.org/grpc v1.24.0/go.mod h1:XDChyiUovWa60DnaeDeZmSW86xtLtjtZbwvSiRnRtcA= google.golang.org/grpc v1.25.1 h1:wdKvqQk7IttEw92GoRyKG2IDrUIpgpj6H6m81yfeMW0= google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY= google.golang.org/grpc v1.26.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= google.golang.org/grpc v1.27.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= google.golang.org/grpc v1.27.1 h1:zvIju4sqAGvwKspUQOhwnpcqSbzi7/H6QomNNjTL4sk= google.golang.org/grpc v1.27.1/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8= google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0= google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM= google.golang.org/protobuf v1.20.1-0.20200309200217-e05f789c0967/go.mod h1:A+miEFZTKqfCUM6K7xSMQL9OKL/b6hQv+e19PK+JZNE= google.golang.org/protobuf v1.21.0/go.mod h1:47Nbq4nVaFHyn7ilMalzfO3qCViNmqZ2kzikPIcrTAo= google.golang.org/protobuf v1.23.0 h1:4MY060fB1DLGMB/7MBTLnwQUY6+F09GEiz6SsrNqyzM= google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw= google.golang.org/protobuf v1.26.0 h1:bxAC2xTBsZGibn2RTntX0oH50xLsqy1OxA9tTL3p/lk= google.golang.org/protobuf v1.26.0/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc= gopkg.in/DataDog/dd-trace-go.v1 v1.17.0/go.mod h1:DVp8HmDh8PuTu2Z0fVVlBsyWaC++fzwVCaGWylTe3tg= gopkg.in/airbrake/gobrake.v2 v2.0.9/go.mod h1:/h5ZAUhDkGaJfjzjKLSjv6zCL6O0LLBxU4K+aSYdM/U= gopkg.in/alecthomas/gometalinter.v2 v2.0.12/go.mod h1:NDRytsqEZyolNuAgTzJkZMkSQM7FIKyzVzGhjB/qfYo= gopkg.in/alecthomas/kingpin.v2 v2.2.6/go.mod h1:FMv+mEhP44yOT+4EoQTLFTRgOQ1FBLkstjWtayDeSgw= gopkg.in/alecthomas/kingpin.v3-unstable v3.0.0-20180810215634-df19058c872c/go.mod h1:3HH7i1SgMqlzxCcBmUHW657sD4Kvv9sC3HpL3YukzwA= gopkg.in/asn1-ber.v1 v1.0.0-20181015200546-f715ec2f112d/go.mod h1:cuepJuh7vyXfUyUwEgHQXw849cJrilpS5NeIjOWESAw= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20200227125254-8fa46927fb4f/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= gopkg.in/cheggaaa/pb.v1 v1.0.25/go.mod h1:V/YB90LKu/1FcN3WVnfiiE5oMCibMjukxqG/qStrOgw= gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI= gopkg.in/fsnotify.v1 v1.4.7/go.mod h1:Tz8NjZHkW78fSQdbUxIjBTcgA1z1m8ZHf0WmKUhAMys= gopkg.in/gcfg.v1 v1.2.3/go.mod h1:yesOnuUOFQAhST5vPY4nbZsb/huCgGGXlipJsBn0b3o= gopkg.in/gemnasium/logrus-airbrake-hook.v2 v2.1.2/go.mod h1:Xk6kEKp8OKb+X14hQBKWaSkCsqBpgog8nAV2xsGOxlo= gopkg.in/go-playground/assert.v1 v1.2.1/go.mod h1:9RXL0bg/zibRAgZUYszZSwO/z8Y/a8bDuhia5mkpMnE= gopkg.in/go-playground/validator.v8 v8.18.2/go.mod h1:RX2a/7Ha8BgOhfk7j780h4/u/RRjR0eouCJSH80/M2Y= gopkg.in/go-playground/validator.v9 v9.29.1/go.mod h1:+c9/zcJMFNgbLvly1L1V+PpxWdVbfP1avr/N00E2vyQ= gopkg.in/go-playground/validator.v9 v9.31.0/go.mod h1:+c9/zcJMFNgbLvly1L1V+PpxWdVbfP1avr/N00E2vyQ= gopkg.in/inf.v0 v0.9.1/go.mod h1:cWUDdTG/fYaXco+Dcufb5Vnc6Gp2YChqWtbxRZE0mXw= gopkg.in/ini.v1 v1.41.0/go.mod h1:pNLf8WUiyNEtQjuu5G5vTm06TEv9tsIgeAvK8hOrP4k= gopkg.in/ini.v1 v1.51.0/go.mod h1:pNLf8WUiyNEtQjuu5G5vTm06TEv9tsIgeAvK8hOrP4k= gopkg.in/jcmturner/aescts.v1 v1.0.1/go.mod h1:nsR8qBOg+OucoIW+WMhB3GspUQXq9XorLnQb9XtvcOo= gopkg.in/jcmturner/dnsutils.v1 v1.0.1/go.mod h1:m3v+5svpVOhtFAP/wSz+yzh4Mc0Fg7eRhxkJMWSIz9Q= gopkg.in/jcmturner/goidentity.v3 v3.0.0/go.mod h1:oG2kH0IvSYNIu80dVAyu/yoefjq1mNfM5bm88whjWx4= gopkg.in/jcmturner/gokrb5.v7 v7.3.0/go.mod h1:l8VISx+WGYp+Fp7KRbsiUuXTTOnxIc3Tuvyavf11/WM= gopkg.in/jcmturner/rpc.v1 v1.1.0/go.mod h1:YIdkC4XfD6GXbzje11McwsDuOlZQSb9W4vfLvuNnlv8= gopkg.in/ldap.v2 v2.5.0/go.mod h1:oI0cpe/D7HRtBQl8aTg+ZmzFUAvu4lsv3eLXMLGFxWk= gopkg.in/mgo.v2 v2.0.0-20160818020120-3f83fa500528/go.mod h1:yeKp02qBN3iKW1OzL3MGk2IdtZzaj7SFntXj72NppTA= gopkg.in/mgo.v2 v2.0.0-20190816093944-a6b53ec6cb22/go.mod h1:yeKp02qBN3iKW1OzL3MGk2IdtZzaj7SFntXj72NppTA= gopkg.in/natefinch/lumberjack.v2 v2.0.0 h1:1Lc07Kr7qY4U2YPouBjpCLxpiyxIVoxqXgkXLknAOE8= gopkg.in/natefinch/lumberjack.v2 v2.0.0/go.mod h1:l0ndWWf7gzL7RNwBG7wST/UCcT4T24xpD6X8LsfU/+k= gopkg.in/ory-am/dockertest.v3 v3.3.4/go.mod h1:s9mmoLkaGeAh97qygnNj4xWkiN7e1SKekYC6CovU+ek= gopkg.in/resty.v1 v1.12.0/go.mod h1:mDo4pnntr5jdWRML875a/NmxYqAlA73dVijT2AXvQQo= gopkg.in/square/go-jose.v2 v2.2.2/go.mod h1:M9dMgbHiYLoDGQrXy7OpJDJWiKiU//h+vD76mk0e1AI= gopkg.in/square/go-jose.v2 v2.3.1/go.mod h1:M9dMgbHiYLoDGQrXy7OpJDJWiKiU//h+vD76mk0e1AI= gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7/go.mod h1:dt/ZhP58zS4L8KSrWDmTeBkI65Dw0HsyUHuEVlX15mw= gopkg.in/warnings.v0 v0.1.2/go.mod h1:jksf8JmL6Qr/oQM2OXTHunEvvTAsrWBLb6OOjuVWRNI= gopkg.in/yaml.v2 v2.0.0-20170812160011-eb3733d160e7/go.mod h1:JAlM8MvJe8wmxCU4Bli9HhUf9+ttbYbLASfIpnQbh74= gopkg.in/yaml.v2 v2.2.1/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.2.3/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.2.5/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.2.7/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.2.8/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY= gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ= gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= gopkg.in/yaml.v3 v3.0.0-20210107192922-496545a6307b/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= gotest.tools v2.2.0+incompatible/go.mod h1:DsYFclhRJ6vuDpmuTbkuFWG+y2sxOXAzmJt81HFBacw= honnef.co/go/tools v0.0.0-20190102054323-c2f93a96b099/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= honnef.co/go/tools v0.0.0-20190106161140-3f1c8253044a/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= honnef.co/go/tools v0.0.0-20190418001031-e561f6794a2a/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= honnef.co/go/tools v0.0.0-20190523083050-ea95bdfd59fc/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= honnef.co/go/tools v0.0.1-2019.2.3/go.mod h1:a3bituU0lyd329TUQxRnasdCoJDkEUEAqEt0JzvZhAg= honnef.co/go/tools v0.0.1-2020.1.3/go.mod h1:X/FiERA/W4tHapMX5mGpAtMSVEeEUOyHaw9vFzvIQ3k= honnef.co/go/tools v0.2.0/go.mod h1:lPVVZ2BS5TfnjLyizF7o7hv7j9/L+8cZY2hLyjP9cGY= k8s.io/api v0.17.3/go.mod h1:YZ0OTkuw7ipbe305fMpIdf3GLXZKRigjtZaV5gzC2J0= k8s.io/apiextensions-apiserver v0.17.3/go.mod h1:CJbCyMfkKftAd/X/V6OTHYhVn7zXnDdnkUjS1h0GTeY= k8s.io/apimachinery v0.17.3/go.mod h1:gxLnyZcGNdZTCLnq3fgzyg2A5BVCHTNDFrw8AmuJ+0g= k8s.io/apiserver v0.17.3/go.mod h1:iJtsPpu1ZpEnHaNawpSV0nYTGBhhX2dUlnn7/QS7QiY= k8s.io/client-go v0.17.3/go.mod h1:cLXlTMtWHkuK4tD360KpWz2gG2KtdWEr/OT02i3emRQ= k8s.io/code-generator v0.17.3/go.mod h1:l8BLVwASXQZTo2xamW5mQNFCe1XPiAesVq7Y1t7PiQQ= k8s.io/component-base v0.17.3/go.mod h1:GeQf4BrgelWm64PXkIXiPh/XS0hnO42d9gx9BtbZRp8= k8s.io/gengo v0.0.0-20190128074634-0689ccc1d7d6/go.mod h1:ezvh/TsK7cY6rbqRK0oQQ8IAqLxYwwyPxAX1Pzy0ii0= k8s.io/gengo v0.0.0-20190822140433-26a664648505/go.mod h1:ezvh/TsK7cY6rbqRK0oQQ8IAqLxYwwyPxAX1Pzy0ii0= k8s.io/klog v0.0.0-20181102134211-b9b56d5dfc92/go.mod h1:Gq+BEi5rUBO/HRz0bTSXDUcqjScdoY3a9IHpCEIOOfk= k8s.io/klog v0.3.0/go.mod h1:Gq+BEi5rUBO/HRz0bTSXDUcqjScdoY3a9IHpCEIOOfk= k8s.io/klog v1.0.0/go.mod h1:4Bi6QPql/J/LkTDqv7R/cd3hPo4k2DG6Ptcz060Ez5I= k8s.io/kube-openapi v0.0.0-20191107075043-30be4d16710a/go.mod h1:1TqjTSzOxsLGIKfj0lK8EeCP7K1iUG65v09OM0/WG5E= k8s.io/utils v0.0.0-20191114184206-e782cd3c129f/go.mod h1:sZAwmy6armz5eXlNoLmJcl4F1QuKu7sr+mFQ0byX7Ew= modernc.org/cc v1.0.0/go.mod h1:1Sk4//wdnYJiUIxnW8ddKpaOJCF37yAdqYnkxUpaYxw= modernc.org/golex v1.0.0/go.mod h1:b/QX9oBD/LhixY6NDh+IdGv17hgB+51fET1i2kPSmvk= modernc.org/mathutil v1.0.0/go.mod h1:wU0vUrJsVWBZ4P6e7xtFJEhFSNsfRLJ8H458uRjg03k= modernc.org/mathutil v1.2.2/go.mod h1:mZW8CKdRPY1v87qxC/wUdX5O1qDzXMP5TH3wjfpga6E= modernc.org/strutil v1.0.0/go.mod h1:lstksw84oURvj9y3tn8lGvRxyRC1S2+g5uuIzNfIOBs= modernc.org/xc v1.0.0/go.mod h1:mRNCo0bvLjGhHO9WsyuKVU4q0ceiDDDoEeWDJHrNx8I= mvdan.cc/interfacer v0.0.0-20180901003855-c20040233aed/go.mod h1:Xkxe497xwlCKkIaQYRfC7CSLworTXY9RMqwhhCm+8Nc= mvdan.cc/lint v0.0.0-20170908181259-adc824a0674b/go.mod h1:2odslEg/xrtNQqCYg2/jCoyKnw3vv5biOc3JnIcYfL4= mvdan.cc/unparam v0.0.0-20190720180237-d51796306d8f/go.mod h1:4G1h5nDURzA3bwVMZIVpwbkw+04kSxk3rAtzlimaUJw= mvdan.cc/unparam v0.0.0-20191111180625-960b1ec0f2c2/go.mod h1:rCqoQrfAmpTX/h2APczwM7UymU/uvaOluiVPIYCSY/k= rsc.io/binaryregexp v0.2.0/go.mod h1:qTv7/COck+e2FymRvadv62gMdZztPaShugOCi3I+8D8= rsc.io/quote/v3 v3.1.0/go.mod h1:yEA65RcK8LyAZtP9Kv3t0HmxON59tX3rD+tICJqUlj0= rsc.io/sampler v1.3.0/go.mod h1:T1hPZKmBbMNahiBKFy5HrXp6adAjACjK9JXDnKaTXpA= sigs.k8s.io/structured-merge-diff v0.0.0-20190525122527-15d366b2352e/go.mod h1:wWxsB5ozmmv/SG7nM11ayaAW51xMvak/t1r0CSlcokI= sigs.k8s.io/structured-merge-diff v1.0.1-0.20191108220359-b1b620dd3f06/go.mod h1:/ULNhyfzRopfcjskuui0cTITekDduZ7ycKN3oUT9R18= sigs.k8s.io/yaml v1.1.0/go.mod h1:UJmg0vDUVViEyp3mgSv9WPwZCDxu4rQW1olrI1uml+o= sourcegraph.com/sourcegraph/appdash v0.0.0-20180531100431-4c381bd170b4/go.mod h1:hI742Nqp5OhwiqlzhgfbWU4mW4yO10fP+LoT9WOswdU= sourcegraph.com/sourcegraph/appdash v0.0.0-20190731080439-ebfcffb1b5c0/go.mod h1:hI742Nqp5OhwiqlzhgfbWU4mW4yO10fP+LoT9WOswdU= sourcegraph.com/sourcegraph/appdash-data v0.0.0-20151005221446-73f23eafcf67/go.mod h1:L5q+DGLGOQFpo1snNEkLOJT2d1YTW66rWNzatr3He1k= sourcegraph.com/sqs/pbtypes v0.0.0-20180604144634-d3ebe8f20ae4/go.mod h1:ketZ/q3QxT9HOBeFhu6RdvsftgpsbFHBF5Cas6cDKZ0= sourcegraph.com/sqs/pbtypes v1.0.0/go.mod h1:3AciMUv4qUuRHRHhOG4TZOB+72GdPVz5k+c648qsFS4= vitess.io/vitess v0.0.0-20200325000816-eda961851d63 h1:kPgA1yZNgrc/AjBZ2k+103rN7/4pFmK9/GmvtegII2k= vitess.io/vitess v0.0.0-20200325000816-eda961851d63/go.mod h1:b+HPfM4HAckoHm+x/E2VWnRfLmq/ZRveGiCU1yNU3EE= vitess.io/vitess v0.9.0 h1:AiBFrhzTCqXcDutjPMp7FtkX2s3dXQBg252rGho6rn8= vitess.io/vitess v0.9.0/go.mod h1:0eX/mIMRc3Kl62gXTORUC/ozkV57fZ8gw7eSXmVIrz8= vitess.io/vitess/examples/are-you-alive v0.0.0-20200302220708-6b7695375ce9/go.mod h1:3Lnc7tMP/PtC7X4Yxu2tcqYbXAX4aGLDKEDsaQwPDp4= ================================================ FILE: retool-install.sh ================================================ #!/usr/bin/env bash set -euo pipefail # This script generates tools.json # It helps record what releases/branches are being used which retool >/dev/null || go get -u github.com/twitchtv/retool # This tool can run other checks in a standardized way retool add gopkg.in/alecthomas/gometalinter.v2 v2.0.11 # check spelling # misspell works with gometalinter retool add github.com/client9/misspell/cmd/misspell v0.3.4 # goword adds additional capability to check comments retool add github.com/chzchzchz/goword a9744cb52b033fe5c269df48eeef2c954526cd79 # checks correctness retool add github.com/gordonklaus/ineffassign 7bae11eba15a3285c75e388f77eb6357a2d73ee2 retool add honnef.co/go/tools/cmd/megacheck master retool add github.com/dnephin/govet 4a96d43e39d340b63daa8bc5576985aa599885f6 # slow checks retool add github.com/kisielk/errcheck v1.1.0 retool add github.com/securego/gosec/cmd/gosec 1.0.0 # linter retool add github.com/mgechev/revive 7773f47324c2bf1c8f7a5500aff2b6c01d3ed73b retool add github.com/golangci/golangci-lint/cmd/golangci-lint v1.10 ================================================ FILE: revive.toml ================================================ ignoreGeneratedHeader = false severity = "error" confidence = 0.8 errorCode = 0 warningCode = 0 [rule.blank-imports] [rule.context-as-argument] [rule.dot-imports] [rule.error-return] [rule.error-strings] [rule.error-naming] [rule.exported] [rule.if-return] [rule.var-naming] [rule.package-comments] [rule.range] [rule.receiver-naming] [rule.indent-error-flow] [rule.superfluous-else] [rule.modifies-parameter] # This can be checked by other tools like megacheck #[rule.unreachable-code] # Currently this makes too much noise, but should add it in # and perhaps ignore it in a few files #[rule.confusing-naming] # severity = "warning" #[rule.confusing-results] # severity = "warning" #[rule.unused-parameter] # severity = "warning" #[rule.deep-exit] # severity = "warning" #[rule.flag-parameter] # severity = "warning" # Adding these will slow down the linter # They are already provided by megacheck #[rule.unexported-return] #[rule.time-naming] #[rule.errorf] # Adding these will slow down the linter # Not sure if they are already provided by megacheck #[rule.var-declaration] #[rule.context-keys-type] ================================================ FILE: test/env.bats ================================================ #!/usr/bin/env bats load test_helper @test "Simple Query Optimizer" { ${SOAR_BIN_ENV} -query "select * from film where length > 120" | sed "s/ [0-9.]*%/ n%/g" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "$output" [ $status -eq 0 ] } @test "Run all test cases" { ${SOAR_BIN} -list-test-sqls | ${SOAR_BIN_ENV} | sed "s/ [0-9.]*%/ n%/g" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "$output" [ $status -eq 0 ] } @test "Check dial timeout" { run timeout 1 ${SOAR_BIN} -test-dsn "1.1.1.1" -check-config echo "$output" [ $status -eq 124 ] } # 12. 带数据库连接时黑名单功能是否正常 # soar 的日志和黑名单的相对路径都相对于 soar 的二进制文件路径说的 @test "Check Soar With Mysql Connect Blacklist" { run ${SOAR_BIN_ENV} -blacklist ../etc/soar.blacklist -query "show processlist;" [ $status -eq 0 ] [ -z ${output} ] } ================================================ FILE: test/fixture/test_Check_Max_Join_Table_Count_Default.golden ================================================ # Query: E813EA038141E9CE ★ ★ ★ ★ ★ 100分 ```sql SELECT a FROM b JOIN c JOIN d ``` ## OK ================================================ FILE: test/fixture/test_Check_Max_Join_Table_Count_Overflow.golden ================================================ # Query: E813EA038141E9CE ★ ★ ★ ★ ☆ 90分 ```sql SELECT a FROM b JOIN c JOIN d ``` ## 减少 JOIN 的数量 * **Item:** JOI.005 * **Severity:** L2 * **Content:** 太多的 JOIN 是复杂的裹脚布式查询的症状。考虑将复杂查询分解成许多简单的查询,并减少 JOIN 的数量。 ================================================ FILE: test/fixture/test_Check_Soar_Delimiter.golden ================================================ # Query: 8093354EDF76BFDA ★ ★ ★ ★ ☆ 80分 ```sql SELECT b FROM c ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 # Query: DD1A4C78C3479C1E ★ ★ ★ ★ ☆ 80分 ```sql SELECT a FROM b ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ================================================ FILE: test/fixture/test_Check_Soar_Max_Column_Count.golden ================================================ # Query: 7EC60923DD614DF2 ★ ☆ ☆ ☆ ☆ 30分 ```sql create table a (a int, b int, c int, d int) ``` ## 建议为表添加注释 * **Item:** CLA.011 * **Severity:** L1 * **Content:** 为表添加注释能够使得表的意义更明确,从而为日后的维护带来极大的便利。 ## 请为列添加默认值 * **Item:** COL.004 * **Severity:** L1 * **Content:** 请为列添加默认值,如果是 ALTER 操作,请不要忘记将原字段的默认值写上。字段无默认值,当表较大时无法在线变更表结构。 ## 列未添加注释 * **Item:** COL.005 * **Severity:** L1 * **Content:** 建议对表中每个列添加注释,来明确每个列在表中的含义及作用。 ## 表中包含有太多的列 * **Item:** COL.006 * **Severity:** L3 * **Content:** 表中包含有太多的列 ## 未指定主键或主键非 int 或 bigint * **Item:** KEY.007 * **Severity:** L4 * **Content:** 未指定主键或主键非 int 或 bigint,建议将主键设置为 int unsigned 或 bigint unsigned。 ## 请为表选择合适的存储引擎 * **Item:** TBL.002 * **Severity:** L4 * **Content:** 建表或修改表的存储引擎时建议使用推荐的存储引擎,如:innodb ================================================ FILE: test/fixture/test_Check_Soar_SQL_Fingerprint.golden ================================================ select * from film where length = ? select * from film where length is null select * from film having title = ? select * from sakila.film where length >= ? select * from sakila.film where length >= ? select * from film where length between ? and ? select * from film where title like ? select * from film where title is not null select * from film where length = ? and title = ? select * from film where length > ? and title = ? select * from film where length > ? and language_id < ? and title = ? select * from film where length > ? and language_id < ? select release_year, sum(length) from film where length = ? and language_id = ? group by release_year select release_year, sum(length) from film where length >= ? group by release_year select release_year, language_id, sum(length) from film group by release_year, language_id select release_year, sum(length) from film where length = ? group by language_id) select release_year, sum(film_id) from film group by release_year select * from address group by address,district select title from film where abs(language_id) = ? group by title select language_id from film where length = ? group by release_year order by language_id select release_year from film where length = ? group by release_year order by release_year select * from film where length = ? order by release_year, language_id desc select release_year from film where length = ? group by release_year order by release_year limit ? select * from film where length = ? order by release_year limit ? select * from film order by release_year limit ? select film_id from film order by release_year limit ? select * from film where length > ? order by length limit ? select * from film where length < ? order by length limit ? select * from customer where address_id in(?+) order by last_name select * from film where release_year = ? and length != ? order by title select title from film where release_year = ? select title, replacement_cost from film where language_id = ? and length = ? select title from film where language_id > ? and length > ? select * from film where length = ? and title = ? order by release_year select * from film where length > ? and title = ? order by release_year select * from film where length > ? order by release_year select * from city a inner join country b on a.country_id=b.country_id select * from city a left join country b on a.country_id=b.country_id select * from city a right join country b on a.country_id=b.country_id select * from city a left join country b on a.country_id=b.country_id where b.last_update is null select * from city a right join country b on a.country_id=b.country_id where a.last_update is null select * from city a left join country b on a.country_id=b.country_id union select * from city a right join country b on a.country_id=b.country_id select * from city a right join country b on a.country_id=b.country_id where a.last_update is null union select * from city a left join country b on a.country_id=b.country_id where b.last_update is null select country_id, last_update from city natural join country select country_id, last_update from city natural left join country select country_id, last_update from city natural right join country select a.country_id, a.last_update from city a straight_join country b on a.country_id=b.country_id select a.address, a.postal_code from sakila.address a where a.city_id in(?+) select city from( select city_id from city where city = ? order by last_update desc limit ?, ?) i join city on (i.city_id = city.city_id) join country on (country.country_id = city.country_id) order by city desc delete city, country from city inner join country using (country_id) where city.city_id = ? delete city from city left join country on city.country_id = country.country_id where country.country is null delete a1, a2 from city as a1 inner join country as a2 where a1.country_id=a2.country_id delete from a1, a2 using city as a1 inner join country as a2 where a1.country_id=a2.country_id delete from film where length > ? update city inner join country using(country_id) set city.city = ?, city.last_update = ?, country.country = ? where city.city_id=? update city inner join country on city.country_id = country.country_id inner join address on city.city_id = address.city_id set city.city = ?, city.last_update = ?, country.country = ? where city.city_id=? update city, country set city.city = ?, city.last_update = ?, country.country = ? where city.country_id = country.country_id and city.city_id=? update film set length = ? where language_id = ? insert into city (country_id) select country_id from country insert into city (country_id) values(?+) insert into city (country_id) values(?+) insert into city (country_id) select ? from dual replace into city (country_id) select country_id from country replace into city (country_id) values(?+) replace into city (country_id) values(?+) replace into city (country_id) select ? from dual select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from ( select film_id from film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film select * from film where language_id = (select language_id from language limit ?) select * from city i left join country o on i.city_id=o.country_id union select * from city i right join country o on i.city_id=o.country_id select * from (select * from actor where last_update=? and last_name=?) t where last_update=? and last_name=? group by first_name select * from city i left join country o on i.city_id=o.country_id union select * from city i right join country o on i.city_id=o.country_id select * from city i left join country o on i.city_id=o.country_id where o.country_id is null union select * from city i right join country o on i.city_id=o.country_id where i.city_id is null select first_name,last_name,email from customer straight_join address on customer.address_id=address.address_id select id,name from (select address from customer_list where sid=? order by phone limit ?,?) a join customer_list l on (a.address=l.address) join city c on (c.city=l.city) order by phone desc select * from film where date(last_update)=? select last_update from film group by date(last_update) select last_update from film order by date(last_update) select description from film where description in(?+) group by description alter table address add index idx_city_id(city_id) alter table inventory add index `idx_store_film` (`store_id`,`film_id`) alter table inventory add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`) select date_format(t.last_update, ?), count(distinct (t.city)) from city t where t.last_update > ? and t.city like ? and t.city = ? group by date_format(t.last_update, ?) order by date_format(t.last_update, ?) create table hello.t (id int unsigned) select * from tb where data >= ? alter table tb alter column id drop default select maxid, minid from (select max(film_id) maxid, min(film_id) minid from film where last_update > ?) as d select maxid, minid from (select max(film_id) maxid, min(film_id) minid from film) as d ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Alwaystrue_.golden ================================================ select count(col) from tbl where (a = 'b') ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Countstar_.golden ================================================ select count(*) from tbl group by 1 ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Delimiter_.golden ================================================ use sakila; ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Distinctstar_.golden ================================================ SELECT * FROM film ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Dml2select_.golden ================================================ select * from film where length > 100 ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Dmlorderby_.golden ================================================ delete from tbl where col1 = 1 ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Having_.golden ================================================ select state, COUNT(*) from Drivers where state in ('GA', 'TX') group by state order by state asc ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Mergealter_.golden ================================================ ALTER TABLE `address` add index idx_city_id(city_id) ; ALTER TABLE `inventory` add index `idx_store_film` (`store_id`,`film_id`), add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`),add index `idx_store_film` (`store_id`,`film_id`) ; ALTER TABLE `tb` alter column id drop default ; DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city.city_id = 1 DELETE city FROM city LEFT JOIN country ON city.country_id = country.country_id WHERE country.country IS NULL DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1.country_id=a2.country_id DELETE FROM film WHERE length > 100 INSERT INTO city (country_id) SELECT 10 FROM DUAL INSERT INTO city (country_id) SELECT country_id FROM country INSERT INTO city (country_id) VALUES (1),(2),(3) REPLACE INTO city (country_id) SELECT 10 FROM DUAL REPLACE INTO city (country_id) SELECT country_id FROM country REPLACE INTO city (country_id) VALUES (1),(2),(3) SELECT DATE_FORMAT(t.last_update, '%Y-%m-%d'), COUNT(DISTINCT (t.city)) FROM city t WHERE t.last_update > '2018-10-22 00:00:00' AND t.city LIKE '%Chrome%' AND t.city = 'eip' GROUP BY DATE_FORMAT(t.last_update, '%Y-%m-%d') ORDER BY DATE_FORMAT(t.last_update, '%Y-%m-%d') SELECT * FROM address GROUP BY address,district SELECT * FROM city a INNER JOIN country b ON a.country_id=b.country_id SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL SELECT * FROM city a RIGHT JOIN country b ON a.country_id=b.country_id WHERE a.last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a.country_id=b.country_id WHERE b.last_update IS NULL SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id SELECT * FROM city i left JOIN country o ON i.city_id=o.country_id WHERE o.country_id is null union SELECT * FROM city i right JOIN country o ON i.city_id=o.country_id WHERE i.city_id is null SELECT * FROM customer WHERE address_id in (224,510) ORDER BY last_name SELECT * FROM film HAVING title = 'abc' SELECT * FROM film ORDER BY release_year LIMIT 10 SELECT * FROM film WHERE date(last_update)='2006-02-15' SELECT * FROM film WHERE language_id = (SELECT language_id FROM language LIMIT 1) SELECT * FROM film WHERE length > 100 and language_id < 10 SELECT * FROM film WHERE length > 100 and language_id < 10 and title = 'xyz' SELECT * FROM film WHERE length > 100 and title = 'ALABAMA DEVIL' SELECT * FROM film WHERE length = 100 and title = 'xyz' ORDER BY release_year SELECT * FROM film WHERE length > 100 and title = 'xyz' ORDER BY release_year SELECT * FROM film WHERE length < 100 ORDER BY length LIMIT 10 SELECT * FROM film WHERE length > 100 ORDER BY length LIMIT 10 SELECT * FROM film WHERE length > 100 ORDER BY release_year SELECT * FROM film WHERE length = 114 and title = 'ALABAMA DEVIL' SELECT * FROM film WHERE length = 123 ORDER BY release_year ASC, language_id DESC SELECT * FROM film WHERE length = 123 ORDER BY release_year LIMIT 10 SELECT * FROM film WHERE length = 86 SELECT * FROM film WHERE length BETWEEN 60 AND 84 SELECT * FROM film WHERE length IS NULL SELECT * FROM film WHERE release_year = 2016 AND length != 1 ORDER BY title SELECT * FROM film WHERE title IS NOT NULL SELECT * FROM film WHERE title LIKE 'AIR%' SELECT * FROM sakila.film WHERE length >= 60 SELECT * FROM (SELECT * FROM actor WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE') t WHERE last_update='2006-02-15 04:34:33' and last_name='CHASE' GROUP BY first_name select * from tb where data >= '' SELECT a.address, a.postal_code FROM sakila.address a WHERE a.city_id IN (SELECT c.city_id FROM sakila.city c) SELECT a.country_id, a.last_update FROM city a STRAIGHT_JOIN country b ON a.country_id=b.country_id SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I.city_id = city.city_id) JOIN country ON (country.country_id = city.country_id) ORDER BY city DESC SELECT country_id, last_update FROM city NATURAL JOIN country SELECT country_id, last_update FROM city NATURAL LEFT JOIN country SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country SELECT description FROM film WHERE description IN('NEWS','asd') GROUP BY description SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film SELECT film_id FROM film ORDER BY release_year LIMIT 10 SELECT first_name,last_name,email FROM customer STRAIGHT_JOIN address ON customer.address_id=address.address_id SELECT ID,name FROM (SELECT address FROM customer_list WHERE SID=1 order by phone limit 50,10) a JOIN customer_list l ON (a.address=l.address) JOIN city c ON (c.city=l.city) order by phone desc SELECT language_id FROM film WHERE length = 123 GROUP BY release_year ORDER BY language_id SELECT last_update FROM film GROUP BY date(last_update) SELECT last_update FROM film order by date(last_update) select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film) as d select maxId, minId from (select max(film_id) maxId, min(film_id) minId from film where last_update > '2016-03-27 02:01:01') as d SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year SELECT release_year FROM film WHERE length = 123 GROUP BY release_year ORDER BY release_year LIMIT 10 SELECT release_year, language_id, sum(length) FROM film GROUP BY release_year, language_id SELECT release_year, sum(film_id) FROM film GROUP BY release_year SELECT release_year, sum(length) FROM film WHERE length = 123 AND language_id = 1 GROUP BY release_year SELECT release_year, sum(length) FROM film WHERE length >= 123 GROUP BY release_year SELECT release_year, sum(length) FROM film WHERE length = 123 GROUP BY release_year,(length+language_id) SELECT title FROM film WHERE ABS(language_id) = 3 GROUP BY title SELECT title FROM film WHERE language_id > 5 AND length > 70 SELECT title FROM film WHERE release_year = 1995 SELECT title, replacement_cost FROM film WHERE language_id = 5 AND length = 70 UPDATE city, country SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.country_id = country.country_id AND city.city_id=10 UPDATE city INNER JOIN country ON city.country_id = country.country_id INNER JOIN address ON city.city_id = address.city_id SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10 UPDATE city INNER JOIN country USING(country_id) SET city.city = 'Abha', city.last_update = '2006-02-15 04:45:25', country.country = 'Afghanistan' WHERE city.city_id=10 UPDATE film SET length = 10 WHERE language_id = 20 ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Or2in_.golden ================================================ select country_id from city where (col2 in (1, 2)) or col1 in (1, 3) ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Orderbynull_.golden ================================================ select sum(col1) from tbl group by col order by null ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Rmparenthesis_.golden ================================================ select col from a where col = 1 ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Standard_.golden ================================================ select sum(col1) from tbl group by 1 ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Star2columns_.golden ================================================ select film_id, title, description, release_year, language_id, original_language_id, rental_duration, rental_rate, length, replacement_cost, rating, special_features, last_update from film where length > 120 ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Truncate_.golden ================================================ truncate table tbl ================================================ FILE: test/fixture/test_Check_Soar_SQL_Rewrite_Unionall_.golden ================================================ select country_id from city union all select country_id from country ================================================ FILE: test/fixture/test_Check_Soar_SQL_pretty_And_Compress_.golden ================================================ SELECT * FROM film WHERE LENGTH = 86; SELECT * FROM film WHERE LENGTH IS NULL; SELECT * FROM film HAVING title = 'abc'; SELECT * FROM sakila. film WHERE LENGTH >= 60; SELECT * FROM sakila. film WHERE LENGTH >= '60'; SELECT * FROM film WHERE LENGTH BETWEEN 60 AND 84; SELECT * FROM film WHERE title LIKE 'AIR%'; SELECT * FROM film WHERE title IS NOT NULL; SELECT * FROM film WHERE LENGTH = 114 AND title = 'ALABAMA DEVIL'; SELECT * FROM film WHERE LENGTH > 100 AND title = 'ALABAMA DEVIL'; SELECT * FROM film WHERE LENGTH > 100 AND language_id < 10 AND title = 'xyz'; SELECT * FROM film WHERE LENGTH > 100 AND language_id < 10; SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH = 123 AND language_id = 1 GROUP BY release_year; SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH >= 123 GROUP BY release_year; SELECT release_year, language_id, SUM( LENGTH) FROM film GROUP BY release_year, language_id; SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH = 123 GROUP BY release_year, (LENGTH+ language_id); SELECT release_year, SUM( film_id) FROM film GROUP BY release_year; SELECT * FROM address GROUP BY address, district; SELECT title FROM film WHERE ABS( language_id) = 3 GROUP BY title; SELECT language_id FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY language_id; SELECT release_year FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY release_year; SELECT * FROM film WHERE LENGTH = 123 ORDER BY release_year ASC, language_id DESC; SELECT release_year FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY release_year LIMIT 10; SELECT * FROM film WHERE LENGTH = 123 ORDER BY release_year LIMIT 10; SELECT * FROM film ORDER BY release_year LIMIT 10; SELECT film_id FROM film ORDER BY release_year LIMIT 10; SELECT * FROM film WHERE LENGTH > 100 ORDER BY LENGTH LIMIT 10; SELECT * FROM film WHERE LENGTH < 100 ORDER BY LENGTH LIMIT 10; SELECT * FROM customer WHERE address_id in (224, 510) ORDER BY last_name; SELECT * FROM film WHERE release_year = 2016 AND LENGTH != 1 ORDER BY title; SELECT title FROM film WHERE release_year = 1995; SELECT title, replacement_cost FROM film WHERE language_id = 5 AND LENGTH = 70; SELECT title FROM film WHERE language_id > 5 AND LENGTH > 70; SELECT * FROM film WHERE LENGTH = 100 AND title = 'xyz' ORDER BY release_year; SELECT * FROM film WHERE LENGTH > 100 AND title = 'xyz' ORDER BY release_year; SELECT * FROM film WHERE LENGTH > 100 ORDER BY release_year; SELECT * FROM city a INNER JOIN country b ON a. country_id= b. country_id; SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id; SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id; SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id WHERE b. last_update IS NULL; SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id WHERE a. last_update IS NULL; SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id; SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id WHERE a. last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id WHERE b. last_update IS NULL; SELECT country_id, last_update FROM city NATURAL JOIN country; SELECT country_id, last_update FROM city NATURAL LEFT JOIN country; SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country; SELECT a. country_id, a. last_update FROM city a STRAIGHT_JOIN country b ON a. country_id= b. country_id; SELECT a. address, a. postal_code FROM sakila. address a WHERE a. city_id IN ( SELECT c. city_id FROM sakila. city c); SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I. city_id = city. city_id) JOIN country ON (country. country_id = city. country_id) ORDER BY city DESC; DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city. city_id = 1; DELETE city FROM city LEFT JOIN country ON city. country_id = country. country_id WHERE country. country IS NULL; DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1. country_id= a2. country_id; DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1. country_id= a2. country_id; DELETE FROM film WHERE LENGTH > 100; UPDATE city INNER JOIN country USING( country_id) SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. city_id= 10; UPDATE city INNER JOIN country ON city. country_id = country. country_id INNER JOIN address ON city. city_id = address. city_id SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. city_id= 10; UPDATE city, country SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. country_id = country. country_id AND city. city_id= 10; UPDATE film SET LENGTH = 10 WHERE language_id = 20; INSERT INTO city (country_id) SELECT country_id FROM country; INSERT INTO city (country_id) VALUES (1), (2), (3); INSERT INTO city (country_id) VALUES (10); INSERT INTO city (country_id) SELECT 10 FROM DUAL; REPLACE INTO city (country_id) SELECT country_id FROM country; REPLACE INTO city (country_id) VALUES (1), (2), (3); REPLACE INTO city (country_id) VALUES (10); REPLACE INTO city (country_id) SELECT 10 FROM DUAL; SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film; SELECT * FROM film WHERE language_id = ( SELECT language_id FROM language LIMIT 1); SELECT * FROM city i LEFT JOIN country o ON i. city_id= o. country_id UNION SELECT * FROM city i RIGHT JOIN country o ON i. city_id= o. country_id; SELECT * FROM ( SELECT * FROM actor WHERE last_update= '2006-02-15 04:34:33' AND last_name= 'CHASE' ) t WHERE last_update= '2006-02-15 04:34:33' AND last_name= 'CHASE' GROUP BY first_name; SELECT * FROM city i LEFT JOIN country o ON i. city_id= o. country_id UNION SELECT * FROM city i RIGHT JOIN country o ON i. city_id= o. country_id; SELECT * FROM city i LEFT JOIN country o ON i. city_id= o. country_id WHERE o. country_id is null UNION SELECT * FROM city i RIGHT JOIN country o ON i. city_id= o. country_id WHERE i. city_id is null; SELECT first_name, last_name, email FROM customer STRAIGHT_JOIN address ON customer. address_id= address. address_id; SELECT ID, name FROM ( SELECT address FROM customer_list WHERE SID= 1 ORDER BY phone LIMIT 50, 10) a JOIN customer_list l ON (a. address= l. address) JOIN city c ON (c. city= l. city) ORDER BY phone desc; SELECT * FROM film WHERE DATE( last_update) = '2006-02-15'; SELECT last_update FROM film GROUP BY DATE( last_update); SELECT last_update FROM film ORDER BY DATE( last_update); SELECT description FROM film WHERE description IN( 'NEWS', 'asd' ) GROUP BY description; ALTER TABLE address ADD index idx_city_id( city_id); ALTER TABLE inventory ADD index `idx_store_film` ( `store_id`, `film_id`); ALTER TABLE inventory ADD index `idx_store_film` ( `store_id`, `film_id`), ADD index `idx_store_film` ( `store_id`, `film_id`), ADD index `idx_store_film` ( `store_id`, `film_id`); SELECT DATE_FORMAT( t. last_update, '%Y-%m-%d' ), COUNT( DISTINCT ( t. city)) FROM city t WHERE t. last_update > '2018-10-22 00:00:00' AND t. city LIKE '%Chrome%' AND t. city = 'eip' GROUP BY DATE_FORMAT( t. last_update, '%Y-%m-%d' ) ORDER BY DATE_FORMAT( t. last_update, '%Y-%m-%d' ); create table hello. t (id int unsigned); SELECT * FROM tb WHERE data >= ''; ALTER TABLE tb alter column id DROP DEFAULT; SELECT maxId, minId FROM ( SELECT MAX( film_id) maxId, MIN( film_id) minId FROM film WHERE last_update > '2016-03-27 02:01:01' ) as d; SELECT maxId, minId FROM ( SELECT MAX( film_id) maxId, MIN( film_id) minId FROM film) as d; ================================================ FILE: test/fixture/test_Check_get_tables_from_SQL.golden ================================================ { "084DA3E3EE38DD85": [ "`unknown`.`tb`" ], "08CFE41C7D20AAC8": [ "`unknown`.`city`", "`unknown`.`country`" ], "0BE2D79E2F1E7CB0": [ "`unknown`.`film`" ], "0D0DABACEDFF5765": [ "`unknown`.`city`", "`unknown`.`country`" ], "105C870D5DFB6710": [ "`unknown`.`film`" ], "11EC7AAACC97DC0F": [ "`unknown`.`city`" ], "12FF1DAA3D425FA9": [ "`unknown`.`film`" ], "16C2B14E7DAA9906": [ "`unknown`.`film`", "`unknown`.`language`" ], "16CB4628D2597D40": [ "`unknown`.`city`", "`unknown`.`country`" ], "17D5BCF21DC2364C": [ "`unknown`.`city`", "`unknown`.`country`" ], "18A2AD1395A58EAE": [ "`unknown`.`film`" ], "1A53649C43122975": [ "`unknown`.`city`", "`unknown`.`country`" ], "1E2CF4145EE706A5": [ "`unknown`.`film`" ], "1E56C6CCEA2131CC": [ "`unknown`.`city`", "`unknown`.`country`" ], "1E8B70E30062FD13": [ "`unknown`.`address`", "`unknown`.`customer`" ], "1ED2B7ECBA4215E1": [ "`unknown`.`film`" ], "23D176AEA2947002": [ "`unknown`.`film`" ], "255BAC03F56CDBC7": [ "`unknown`.`address`" ], "291F95B7DCB74C21": [ "`unknown`.`tb`" ], "2BA1217F6C8CF0AB": [ "`unknown`.`address`" ], "2EAACFD7030EA528": [ "`unknown`.`film`" ], "2F7439623B712317": [ "`unknown`.`city`" ], "3656B13CC4F888E2": [ "`unknown`.`city`", "`unknown`.`country`" ], "3FF20E28EC9CBEF9": [ "`unknown`.`city`", "`unknown`.`country`" ], "466F1AC2F5851149": [ "`unknown`.`city`" ], "47044E1FE1A965A5": [ "`unknown`.`film`" ], "485D56FC88BBBDB9": [ "`unknown`.`city`", "`unknown`.`country`" ], "4A39009B402BAD9B": [ "`unknown`.`film`" ], "4E73AA068370E6A8": [ "`unknown`.`film`" ], "4ECCA9568BE69E68": [ "`unknown`.`city`", "`unknown`.`country`" ], "50F2AB4243CE2071": [ "`sakila`.`address`", "`sakila`.`city`" ], "584CCEC8069B6947": [ "`unknown`.`city`", "`unknown`.`country`" ], "5C547F08EADBB131": [ "`unknown`.`city`", "`unknown`.`country`" ], "5CE2F187DBF2A710": [ "`unknown`.`film`" ], "60F234BA33AAC132": [ "`unknown`.`film`" ], "626571EAE84E2C8A": [ "`unknown`.`city`", "`unknown`.`country`" ], "68E48001ECD53152": [ "`unknown`.`film`" ], "6A0F035BD4E01018": [ "`unknown`.`film`" ], "6E9B96CA3F0E6BDA": [ "`unknown`.`film`" ], "707FE669669FA075": [ "`unknown`.`film`" ], "73DDF6E6D9E40384": [ "`unknown`.`film`" ], "7598A4EDE6CFA6BE": [ "`unknown`.`city`", "`unknown`.`country`" ], "7F02E23D44A38A6D": [ "`unknown`.`city`", "`unknown`.`country`" ], "863A85207E4F410D": [ "`unknown`.`film`" ], "868317D1973FD1B0": [ "`unknown`.`film`" ], "8A106444D14B9880": [ "`unknown`.`film`" ], "965D5AC955824512": [ "`unknown`.`film`" ], "9BB74D074BA0727C": [ "`unknown`.`inventory`" ], "A0C5E62C724A121A": [ "`sakila`.`film`" ], "A314542EEE8571EE": [ "`unknown`.`customer`" ], "A3FAB6027484B88B": [ "`unknown`.`film`" ], "A4911095C201896F": [ "`unknown`.`city`", "`unknown`.`country`" ], "A7973BDD268F926E": [ "`unknown`.`city`" ], "AF0C1EB58B23D2FA": [ "`unknown`.`city`", "`unknown`.`country`" ], "AFEEBF10A8D74E32": [ "`unknown`.`film`" ], "B0BA5A7079EA16B3": [ "`unknown`.`film`" ], "B13E0ACEAF8F3119": [ "`unknown`.`film`" ], "B3C502B4AA344196": [ "`unknown`.`film`" ], "B48292EDB9D0E010": [ "`unknown`.`film`" ], "B862978586C6338B": [ "`unknown`.`city`", "`unknown`.`country`" ], "B9336971FF3D3792": [ "`unknown`.`film`" ], "BA7111449E4F1122": [ "`unknown`.`film`" ], "C11ECE7AE5F80CE5": [ "`hello`.`t`" ], "C15BDF2C73B5B7ED": [ "`unknown`.`address`", "`unknown`.`city`", "`unknown`.`country`" ], "C315BC4EE0F4E523": [ "`unknown`.`inventory`" ], "C3FAEDA6AD6D762B": [ "`unknown`.`film`" ], "C4A212A42400411D": [ "`unknown`.`film`" ], "C95B5C028C8FFF95": [ "`unknown`.`city`" ], "CB42080E9F35AB07": [ "`unknown`.`film`" ], "DF59FD602E4AA368": [ "`unknown`.`film`" ], "DF916439ABD07664": [ "`unknown`.`film`" ], "E3DDA1A929236E72": [ "`unknown`.`city`", "`unknown`.`country`" ], "E48A20D0413512DA": [ "`unknown`.`city`", "`unknown`.`customer_list`" ], "E75234155B5E2E14": [ "`unknown`.`film`" ], "E84CBAAC2E12BDEA": [ "`unknown`.`film`" ], "E969B9297DA79BA6": [ "`unknown`.`film`" ], "EA50643B01E139A8": [ "`unknown`.`actor`" ], "F16FD63381EF8299": [ "`unknown`.`film`" ], "F5D30BCAC1E206A1": [ "`unknown`.`city`", "`unknown`.`country`" ], "F6DBEAA606D800FC": [ "`unknown`.`film`" ], "F8314ABD1CBF2FF1": [ "`unknown`.`city`", "`unknown`.`country`" ], "FCD1ABF36F8CDAD7": [ "`unknown`.`city`", "`unknown`.`country`" ], "FE409EB794EE91CF": [ "`unknown`.`film`" ] } { "084DA3E3EE38DD85": [ "`sakila`.`tb`" ], "08CFE41C7D20AAC8": [ "`sakila`.`city`", "`sakila`.`country`" ], "0BE2D79E2F1E7CB0": [ "`sakila`.`film`" ], "0D0DABACEDFF5765": [ "`sakila`.`city`", "`sakila`.`country`" ], "105C870D5DFB6710": [ "`sakila`.`film`" ], "11EC7AAACC97DC0F": [ "`sakila`.`city`" ], "12FF1DAA3D425FA9": [ "`sakila`.`film`" ], "16C2B14E7DAA9906": [ "`sakila`.`film`", "`sakila`.`language`" ], "16CB4628D2597D40": [ "`sakila`.`city`", "`sakila`.`country`" ], "17D5BCF21DC2364C": [ "`sakila`.`city`", "`sakila`.`country`" ], "18A2AD1395A58EAE": [ "`sakila`.`film`" ], "1A53649C43122975": [ "`sakila`.`city`", "`sakila`.`country`" ], "1E2CF4145EE706A5": [ "`sakila`.`film`" ], "1E56C6CCEA2131CC": [ "`sakila`.`city`", "`sakila`.`country`" ], "1E8B70E30062FD13": [ "`sakila`.`address`", "`sakila`.`customer`" ], "1ED2B7ECBA4215E1": [ "`sakila`.`film`" ], "23D176AEA2947002": [ "`sakila`.`film`" ], "255BAC03F56CDBC7": [ "`sakila`.`address`" ], "291F95B7DCB74C21": [ "`sakila`.`tb`" ], "2BA1217F6C8CF0AB": [ "`sakila`.`address`" ], "2EAACFD7030EA528": [ "`sakila`.`film`" ], "2F7439623B712317": [ "`sakila`.`city`" ], "3656B13CC4F888E2": [ "`sakila`.`city`", "`sakila`.`country`" ], "3FF20E28EC9CBEF9": [ "`sakila`.`city`", "`sakila`.`country`" ], "466F1AC2F5851149": [ "`sakila`.`city`" ], "47044E1FE1A965A5": [ "`sakila`.`film`" ], "485D56FC88BBBDB9": [ "`sakila`.`city`", "`sakila`.`country`" ], "4A39009B402BAD9B": [ "`sakila`.`film`" ], "4E73AA068370E6A8": [ "`sakila`.`film`" ], "4ECCA9568BE69E68": [ "`sakila`.`city`", "`sakila`.`country`" ], "50F2AB4243CE2071": [ "`sakila`.`address`", "`sakila`.`city`" ], "584CCEC8069B6947": [ "`sakila`.`city`", "`sakila`.`country`" ], "5C547F08EADBB131": [ "`sakila`.`city`", "`sakila`.`country`" ], "5CE2F187DBF2A710": [ "`sakila`.`film`" ], "60F234BA33AAC132": [ "`sakila`.`film`" ], "626571EAE84E2C8A": [ "`sakila`.`city`", "`sakila`.`country`" ], "68E48001ECD53152": [ "`sakila`.`film`" ], "6A0F035BD4E01018": [ "`sakila`.`film`" ], "6E9B96CA3F0E6BDA": [ "`sakila`.`film`" ], "707FE669669FA075": [ "`sakila`.`film`" ], "73DDF6E6D9E40384": [ "`sakila`.`film`" ], "7598A4EDE6CFA6BE": [ "`sakila`.`city`", "`sakila`.`country`" ], "7F02E23D44A38A6D": [ "`sakila`.`city`", "`sakila`.`country`" ], "863A85207E4F410D": [ "`sakila`.`film`" ], "868317D1973FD1B0": [ "`sakila`.`film`" ], "8A106444D14B9880": [ "`sakila`.`film`" ], "965D5AC955824512": [ "`sakila`.`film`" ], "9BB74D074BA0727C": [ "`sakila`.`inventory`" ], "A0C5E62C724A121A": [ "`sakila`.`film`" ], "A314542EEE8571EE": [ "`sakila`.`customer`" ], "A3FAB6027484B88B": [ "`sakila`.`film`" ], "A4911095C201896F": [ "`sakila`.`city`", "`sakila`.`country`" ], "A7973BDD268F926E": [ "`sakila`.`city`" ], "AF0C1EB58B23D2FA": [ "`sakila`.`city`", "`sakila`.`country`" ], "AFEEBF10A8D74E32": [ "`sakila`.`film`" ], "B0BA5A7079EA16B3": [ "`sakila`.`film`" ], "B13E0ACEAF8F3119": [ "`sakila`.`film`" ], "B3C502B4AA344196": [ "`sakila`.`film`" ], "B48292EDB9D0E010": [ "`sakila`.`film`" ], "B862978586C6338B": [ "`sakila`.`city`", "`sakila`.`country`" ], "B9336971FF3D3792": [ "`sakila`.`film`" ], "BA7111449E4F1122": [ "`sakila`.`film`" ], "C11ECE7AE5F80CE5": [ "`hello`.`t`" ], "C15BDF2C73B5B7ED": [ "`sakila`.`address`", "`sakila`.`city`", "`sakila`.`country`" ], "C315BC4EE0F4E523": [ "`sakila`.`inventory`" ], "C3FAEDA6AD6D762B": [ "`sakila`.`film`" ], "C4A212A42400411D": [ "`sakila`.`film`" ], "C95B5C028C8FFF95": [ "`sakila`.`city`" ], "CB42080E9F35AB07": [ "`sakila`.`film`" ], "DF59FD602E4AA368": [ "`sakila`.`film`" ], "DF916439ABD07664": [ "`sakila`.`film`" ], "E3DDA1A929236E72": [ "`sakila`.`city`", "`sakila`.`country`" ], "E48A20D0413512DA": [ "`sakila`.`city`", "`sakila`.`customer_list`" ], "E75234155B5E2E14": [ "`sakila`.`film`" ], "E84CBAAC2E12BDEA": [ "`sakila`.`film`" ], "E969B9297DA79BA6": [ "`sakila`.`film`" ], "EA50643B01E139A8": [ "`sakila`.`actor`" ], "F16FD63381EF8299": [ "`sakila`.`film`" ], "F5D30BCAC1E206A1": [ "`sakila`.`city`", "`sakila`.`country`" ], "F6DBEAA606D800FC": [ "`sakila`.`film`" ], "F8314ABD1CBF2FF1": [ "`sakila`.`city`", "`sakila`.`country`" ], "FCD1ABF36F8CDAD7": [ "`sakila`.`city`", "`sakila`.`country`" ], "FE409EB794EE91CF": [ "`sakila`.`film`" ] } ================================================ FILE: test/fixture/test_Check_soar_for_pipe_input.golden ================================================ # Query: C3FAEDA6AD6D762B ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH = 86 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: E969B9297DA79BA6 ★ ★ ★ ★ ☆ 90分 ```sql SELECT * FROM film WHERE LENGTH IS NULL ``` ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 8A106444D14B9880 ★ ★ ★ ☆ ☆ 60分 ```sql SELECT * FROM film HAVING title = 'abc' ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 HAVING 子句 * **Item:** CLA.013 * **Severity:** L3 * **Content:** 将查询的 HAVING 子句改写为 WHERE 中的查询条件,可以在查询处理期间使用索引。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: A0C5E62C724A121A ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM sakila. film WHERE LENGTH >= 60 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 868317D1973FD1B0 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH BETWEEN 60 AND 84 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 707FE669669FA075 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE title LIKE 'AIR%' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: DF916439ABD07664 ★ ★ ★ ★ ☆ 90分 ```sql SELECT * FROM film WHERE title IS NOT NULL ``` ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: B9336971FF3D3792 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH = 114 AND title = 'ALABAMA DEVIL' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 68E48001ECD53152 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND title = 'ALABAMA DEVIL' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 12FF1DAA3D425FA9 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND language_id < 10 AND title = 'xyz' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: E84CBAAC2E12BDEA ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND language_id < 10 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 6A0F035BD4E01018 ★ ★ ★ ★ ☆ 85分 ```sql SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH = 123 AND language_id = 1 GROUP BY release_year ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: 23D176AEA2947002 ★ ★ ★ ★ ☆ 85分 ```sql SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH >= 123 GROUP BY release_year ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: 73DDF6E6D9E40384 ★ ★ ★ ☆ ☆ 65分 ```sql SELECT release_year, language_id, SUM( LENGTH) FROM film GROUP BY release_year, language_id ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: B3C502B4AA344196 ★ ★ ★ ☆ ☆ 75分 ```sql SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH = 123 GROUP BY release_year, (LENGTH+ language_id) ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## GROUP BY 的条件为表达式 * **Item:** CLA.010 * **Severity:** L2 * **Content:** 当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: 47044E1FE1A965A5 ★ ★ ★ ☆ ☆ 70分 ```sql SELECT release_year, SUM( film_id) FROM film GROUP BY release_year ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 # Query: 2BA1217F6C8CF0AB ★ ★ ☆ ☆ ☆ 45分 ```sql SELECT * FROM address GROUP BY address, district ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 非确定性的 GROUP BY * **Item:** RES.001 * **Severity:** L4 * **Content:** SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 # Query: 863A85207E4F410D ★ ★ ★ ★ ☆ 80分 ```sql SELECT title FROM film WHERE ABS( language_id) = 3 GROUP BY title ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 避免在 WHERE 条件中使用函数或其他运算符 * **Item:** FUN.001 * **Severity:** L2 * **Content:** 虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。 # Query: DF59FD602E4AA368 ★ ★ ★ ★ ☆ 80分 ```sql SELECT language_id FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY language_id ``` ## 非确定性的 GROUP BY * **Item:** RES.001 * **Severity:** L4 * **Content:** SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 # Query: F6DBEAA606D800FC ★ ★ ★ ★ ★ 100分 ```sql SELECT release_year FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY release_year ``` ## OK # Query: 6E9B96CA3F0E6BDA ★ ★ ★ ☆ ☆ 75分 ```sql SELECT * FROM film WHERE LENGTH = 123 ORDER BY release_year ASC, language_id DESC ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## ORDER BY 多个列但排序方向不同时可能无法使用索引 * **Item:** KEY.008 * **Severity:** L4 * **Content:** 在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。 # Query: 2EAACFD7030EA528 ★ ★ ★ ★ ★ 100分 ```sql SELECT release_year FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY release_year LIMIT 10 ``` ## OK # Query: 5CE2F187DBF2A710 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH = 123 ORDER BY release_year LIMIT 10 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: E75234155B5E2E14 ★ ★ ★ ☆ ☆ 75分 ```sql SELECT * FROM film ORDER BY release_year LIMIT 10 ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: AFEEBF10A8D74E32 ★ ★ ★ ★ ☆ 80分 ```sql SELECT film_id FROM film ORDER BY release_year LIMIT 10 ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 # Query: 965D5AC955824512 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 ORDER BY LENGTH LIMIT 10 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 1E2CF4145EE706A5 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH < 100 ORDER BY LENGTH LIMIT 10 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: A314542EEE8571EE ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM customer WHERE address_id in (224, 510) ORDER BY last_name ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 0BE2D79E2F1E7CB0 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE release_year = 2016 AND LENGTH != 1 ORDER BY title ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## '!=' 运算符是非标准的 * **Item:** STA.001 * **Severity:** L0 * **Content:** "<>"才是标准SQL中的不等于运算符。 # Query: 4E73AA068370E6A8 ★ ★ ★ ★ ★ 100分 ```sql SELECT title FROM film WHERE release_year = 1995 ``` ## OK # Query: BA7111449E4F1122 ★ ★ ★ ★ ★ 100分 ```sql SELECT title, replacement_cost FROM film WHERE language_id = 5 AND LENGTH = 70 ``` ## OK # Query: B13E0ACEAF8F3119 ★ ★ ★ ★ ★ 100分 ```sql SELECT title FROM film WHERE language_id > 5 AND LENGTH > 70 ``` ## OK # Query: A3FAB6027484B88B ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH = 100 AND title = 'xyz' ORDER BY release_year ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: CB42080E9F35AB07 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND title = 'xyz' ORDER BY release_year ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: C4A212A42400411D ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 ORDER BY release_year ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 4ECCA9568BE69E68 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM city a INNER JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 485D56FC88BBBDB9 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 0D0DABACEDFF5765 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 1E56C6CCEA2131CC ★ ★ ★ ★ ☆ 90分 ```sql SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id WHERE b. last_update IS NULL ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: F5D30BCAC1E206A1 ★ ★ ★ ★ ☆ 90分 ```sql SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id WHERE a. last_update IS NULL ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 17D5BCF21DC2364C ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: A4911095C201896F ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id WHERE a. last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id WHERE b. last_update IS NULL ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: 3FF20E28EC9CBEF9 ★ ★ ★ ★ ★ 100分 ```sql SELECT country_id, last_update FROM city NATURAL JOIN country ``` ## OK # Query: 5C547F08EADBB131 ★ ★ ★ ★ ★ 100分 ```sql SELECT country_id, last_update FROM city NATURAL LEFT JOIN country ``` ## OK # Query: AF0C1EB58B23D2FA ★ ★ ★ ★ ★ 100分 ```sql SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country ``` ## OK # Query: 626571EAE84E2C8A ★ ★ ★ ★ ★ 100分 ```sql SELECT a. country_id, a. last_update FROM city a STRAIGHT_JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 # Query: 50F2AB4243CE2071 ★ ★ ★ ☆ ☆ 60分 ```sql SELECT a. address, a. postal_code FROM sakila. address a WHERE a. city_id IN ( SELECT c. city_id FROM sakila. city c) ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 584CCEC8069B6947 ★ ★ ★ ☆ ☆ 60分 ```sql SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I. city_id = city. city_id) JOIN country ON (country. country_id = city. country_id) ORDER BY city DESC ``` ## 同一张表被连接两次 * **Item:** JOI.002 * **Severity:** L4 * **Content:** 相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 7F02E23D44A38A6D ★ ★ ★ ★ ☆ 80分 ```sql DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city. city_id = 1 ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: F8314ABD1CBF2FF1 ★ ★ ★ ★ ☆ 80分 ```sql DELETE city FROM city LEFT JOIN country ON city. country_id = country. country_id WHERE country. country IS NULL ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: 1A53649C43122975 ★ ★ ★ ★ ☆ 80分 ```sql DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1. country_id= a2. country_id ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: B862978586C6338B ★ ★ ★ ★ ☆ 80分 ```sql DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1. country_id= a2. country_id ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: F16FD63381EF8299 ★ ★ ★ ★ ★ 100分 ```sql DELETE FROM film WHERE LENGTH > 100 ``` ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: 08CFE41C7D20AAC8 ★ ★ ★ ★ ☆ 80分 ```sql UPDATE city INNER JOIN country USING( country_id) SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. city_id= 10 ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 # Query: C15BDF2C73B5B7ED ★ ★ ★ ★ ☆ 80分 ```sql UPDATE city INNER JOIN country ON city. country_id = country. country_id INNER JOIN address ON city. city_id = address. city_id SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. city_id= 10 ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 # Query: FCD1ABF36F8CDAD7 ★ ★ ★ ★ ★ 100分 ```sql UPDATE city, country SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. country_id = country. country_id AND city. city_id= 10 ``` ## OK # Query: FE409EB794EE91CF ★ ★ ★ ★ ★ 100分 ```sql UPDATE film SET LENGTH = 10 WHERE language_id = 20 ``` ## OK # Query: 3656B13CC4F888E2 ★ ★ ★ ☆ ☆ 65分 ```sql INSERT INTO city (country_id) SELECT country_id FROM country ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: 2F7439623B712317 ★ ★ ★ ★ ★ 100分 ```sql INSERT INTO city (country_id) VALUES (1), (2), (3) ``` ## OK # Query: 11EC7AAACC97DC0F ★ ★ ★ ★ ☆ 85分 ```sql INSERT INTO city (country_id) SELECT 10 FROM DUAL ``` ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: E3DDA1A929236E72 ★ ★ ★ ☆ ☆ 65分 ```sql REPLACE INTO city (country_id) SELECT country_id FROM country ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: 466F1AC2F5851149 ★ ★ ★ ★ ★ 100分 ```sql REPLACE INTO city (country_id) VALUES (1), (2), (3) ``` ## OK # Query: A7973BDD268F926E ★ ★ ★ ★ ☆ 85分 ```sql REPLACE INTO city (country_id) SELECT 10 FROM DUAL ``` ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: 105C870D5DFB6710 ★ ★ ★ ☆ ☆ 65分 ```sql SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 执行计划中嵌套连接深度过深 * **Item:** SUB.004 * **Severity:** L3 * **Content:** MySQL对子查询的优化效果不佳,MySQL将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。 # Query: 16C2B14E7DAA9906 ★ ☆ ☆ ☆ ☆ 35分 ```sql SELECT * FROM film WHERE language_id = ( SELECT language_id FROM language LIMIT 1) ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 未使用 ORDER BY 的 LIMIT 查询 * **Item:** RES.002 * **Severity:** L4 * **Content:** 没有 ORDER BY 的 LIMIT 会导致非确定性的结果,这取决于查询执行计划。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 16CB4628D2597D40 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city i LEFT JOIN country o ON i. city_id= o. country_id UNION SELECT * FROM city i RIGHT JOIN country o ON i. city_id= o. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: EA50643B01E139A8 ★ ★ ☆ ☆ ☆ 45分 ```sql SELECT * FROM ( SELECT * FROM actor WHERE last_update= '2006-02-15 04:34:33' AND last_name= 'CHASE' ) t WHERE last_update= '2006-02-15 04:34:33' AND last_name= 'CHASE' GROUP BY first_name ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 非确定性的 GROUP BY * **Item:** RES.001 * **Severity:** L4 * **Content:** SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 7598A4EDE6CFA6BE ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city i LEFT JOIN country o ON i. city_id= o. country_id WHERE o. country_id is null UNION SELECT * FROM city i RIGHT JOIN country o ON i. city_id= o. country_id WHERE i. city_id is null ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: 1E8B70E30062FD13 ★ ★ ★ ★ ★ 100分 ```sql SELECT first_name, last_name, email FROM customer STRAIGHT_JOIN address ON customer. address_id= address. address_id ``` ## OK # Query: E48A20D0413512DA ★ ★ ★ ☆ ☆ 60分 ```sql SELECT ID, name FROM ( SELECT address FROM customer_list WHERE SID= 1 ORDER BY phone LIMIT 50, 10) a JOIN customer_list l ON (a. address= l. address) JOIN city c ON (c. city= l. city) ORDER BY phone desc ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 同一张表被连接两次 * **Item:** JOI.002 * **Severity:** L4 * **Content:** 相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: B0BA5A7079EA16B3 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE DATE( last_update) = '2006-02-15' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 避免在 WHERE 条件中使用函数或其他运算符 * **Item:** FUN.001 * **Severity:** L2 * **Content:** 虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。 # Query: 18A2AD1395A58EAE ★ ★ ★ ☆ ☆ 60分 ```sql SELECT last_update FROM film GROUP BY DATE( last_update) ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## GROUP BY 的条件为表达式 * **Item:** CLA.010 * **Severity:** L2 * **Content:** 当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 # Query: 60F234BA33AAC132 ★ ★ ★ ☆ ☆ 70分 ```sql SELECT last_update FROM film ORDER BY DATE( last_update) ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## ORDER BY 的条件为表达式 * **Item:** CLA.009 * **Severity:** L2 * **Content:** 当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 # Query: 1ED2B7ECBA4215E1 ★ ★ ★ ★ ☆ 90分 ```sql SELECT description FROM film WHERE description IN( 'NEWS', 'asd' ) GROUP BY description ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 # Query: 255BAC03F56CDBC7 ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE address ADD index idx_city_id( city_id) ``` ## OK # Query: C315BC4EE0F4E523 ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE inventory ADD index `idx_store_film` ( `store_id`, `film_id`) ``` ## 提醒:请将索引属性顺序与查询对齐 * **Item:** KEY.004 * **Severity:** L0 * **Content:** 如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。 # Query: 9BB74D074BA0727C ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE inventory ADD index `idx_store_film` ( `store_id`, `film_id`), ADD index `idx_store_film` ( `store_id`, `film_id`), ADD index `idx_store_film` ( `store_id`, `film_id`) ``` ## 提醒:请将索引属性顺序与查询对齐 * **Item:** KEY.004 * **Severity:** L0 * **Content:** 如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。 # Query: C95B5C028C8FFF95 ★ ★ ☆ ☆ ☆ 40分 ```sql SELECT DATE_FORMAT( t. last_update, '%Y-%m-%d' ), COUNT( DISTINCT ( t. city)) FROM city t WHERE t. last_update > '2018-10-22 00:00:00' AND t. city LIKE '%Chrome%' AND t. city = 'eip' GROUP BY DATE_FORMAT( t. last_update, '%Y-%m-%d' ) ORDER BY DATE_FORMAT( t. last_update, '%Y-%m-%d' ) ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用前项通配符查找 * **Item:** ARG.001 * **Severity:** L4 * **Content:** 例如 "%foo",查询参数有一个前项通配符的情况无法使用已有索引。 ## ORDER BY 的条件为表达式 * **Item:** CLA.009 * **Severity:** L2 * **Content:** 当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 ## GROUP BY 的条件为表达式 * **Item:** CLA.010 * **Severity:** L2 * **Content:** 当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 ## ORDER BY 多个列但排序方向不同时可能无法使用索引 * **Item:** KEY.008 * **Severity:** L4 * **Content:** 在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。 # Query: C11ECE7AE5F80CE5 ★ ★ ☆ ☆ ☆ 45分 ```sql create table hello. t (id int unsigned) ``` ## 建议为表添加注释 * **Item:** CLA.011 * **Severity:** L1 * **Content:** 为表添加注释能够使得表的意义更明确,从而为日后的维护带来极大的便利。 ## 请为列添加默认值 * **Item:** COL.004 * **Severity:** L1 * **Content:** 请为列添加默认值,如果是 ALTER 操作,请不要忘记将原字段的默认值写上。字段无默认值,当表较大时无法在线变更表结构。 ## 列未添加注释 * **Item:** COL.005 * **Severity:** L1 * **Content:** 建议对表中每个列添加注释,来明确每个列在表中的含义及作用。 ## 未指定主键或主键非 int 或 bigint * **Item:** KEY.007 * **Severity:** L4 * **Content:** 未指定主键或主键非 int 或 bigint,建议将主键设置为 int unsigned 或 bigint unsigned。 ## 请为表选择合适的存储引擎 * **Item:** TBL.002 * **Severity:** L4 * **Content:** 建表或修改表的存储引擎时建议使用推荐的存储引擎,如:innodb # Query: 291F95B7DCB74C21 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM tb WHERE data >= '' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 084DA3E3EE38DD85 ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE tb alter column id DROP DEFAULT ``` ## OK # Query: B48292EDB9D0E010 ★ ★ ☆ ☆ ☆ 50分 ```sql SELECT maxId, minId FROM ( SELECT MAX( film_id) maxId, MIN( film_id) minId FROM film WHERE last_update > '2016-03-27 02:01:01' ) as d ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 ## 不建议在子查询中使用函数 * **Item:** SUB.006 * **Severity:** L2 * **Content:** MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。 # Query: 4A39009B402BAD9B ★ ★ ☆ ☆ ☆ 50分 ```sql SELECT maxId, minId FROM ( SELECT MAX( film_id) maxId, MIN( film_id) minId FROM film) as d ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 ## 不建议在子查询中使用函数 * **Item:** SUB.006 * **Severity:** L2 * **Content:** MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。 ================================================ FILE: test/fixture/test_Check_soar_query_for_input_file.golden ================================================ # Query: C3FAEDA6AD6D762B ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH = 86 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: E969B9297DA79BA6 ★ ★ ★ ★ ☆ 90分 ```sql SELECT * FROM film WHERE LENGTH IS NULL ``` ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 8A106444D14B9880 ★ ★ ★ ☆ ☆ 60分 ```sql SELECT * FROM film HAVING title = 'abc' ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 HAVING 子句 * **Item:** CLA.013 * **Severity:** L3 * **Content:** 将查询的 HAVING 子句改写为 WHERE 中的查询条件,可以在查询处理期间使用索引。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: A0C5E62C724A121A ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM sakila. film WHERE LENGTH >= 60 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 868317D1973FD1B0 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH BETWEEN 60 AND 84 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 707FE669669FA075 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE title LIKE 'AIR%' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: DF916439ABD07664 ★ ★ ★ ★ ☆ 90分 ```sql SELECT * FROM film WHERE title IS NOT NULL ``` ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: B9336971FF3D3792 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH = 114 AND title = 'ALABAMA DEVIL' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 68E48001ECD53152 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND title = 'ALABAMA DEVIL' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 12FF1DAA3D425FA9 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND language_id < 10 AND title = 'xyz' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: E84CBAAC2E12BDEA ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND language_id < 10 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 6A0F035BD4E01018 ★ ★ ★ ★ ☆ 85分 ```sql SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH = 123 AND language_id = 1 GROUP BY release_year ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: 23D176AEA2947002 ★ ★ ★ ★ ☆ 85分 ```sql SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH >= 123 GROUP BY release_year ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: 73DDF6E6D9E40384 ★ ★ ★ ☆ ☆ 65分 ```sql SELECT release_year, language_id, SUM( LENGTH) FROM film GROUP BY release_year, language_id ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: B3C502B4AA344196 ★ ★ ★ ☆ ☆ 75分 ```sql SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH = 123 GROUP BY release_year, (LENGTH+ language_id) ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## GROUP BY 的条件为表达式 * **Item:** CLA.010 * **Severity:** L2 * **Content:** 当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: 47044E1FE1A965A5 ★ ★ ★ ☆ ☆ 70分 ```sql SELECT release_year, SUM( film_id) FROM film GROUP BY release_year ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 # Query: 2BA1217F6C8CF0AB ★ ★ ☆ ☆ ☆ 45分 ```sql SELECT * FROM address GROUP BY address, district ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 非确定性的 GROUP BY * **Item:** RES.001 * **Severity:** L4 * **Content:** SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 # Query: 863A85207E4F410D ★ ★ ★ ★ ☆ 80分 ```sql SELECT title FROM film WHERE ABS( language_id) = 3 GROUP BY title ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 避免在 WHERE 条件中使用函数或其他运算符 * **Item:** FUN.001 * **Severity:** L2 * **Content:** 虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。 # Query: DF59FD602E4AA368 ★ ★ ★ ★ ☆ 80分 ```sql SELECT language_id FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY language_id ``` ## 非确定性的 GROUP BY * **Item:** RES.001 * **Severity:** L4 * **Content:** SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 # Query: F6DBEAA606D800FC ★ ★ ★ ★ ★ 100分 ```sql SELECT release_year FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY release_year ``` ## OK # Query: 6E9B96CA3F0E6BDA ★ ★ ★ ☆ ☆ 75分 ```sql SELECT * FROM film WHERE LENGTH = 123 ORDER BY release_year ASC, language_id DESC ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## ORDER BY 多个列但排序方向不同时可能无法使用索引 * **Item:** KEY.008 * **Severity:** L4 * **Content:** 在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。 # Query: 2EAACFD7030EA528 ★ ★ ★ ★ ★ 100分 ```sql SELECT release_year FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY release_year LIMIT 10 ``` ## OK # Query: 5CE2F187DBF2A710 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH = 123 ORDER BY release_year LIMIT 10 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: E75234155B5E2E14 ★ ★ ★ ☆ ☆ 75分 ```sql SELECT * FROM film ORDER BY release_year LIMIT 10 ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: AFEEBF10A8D74E32 ★ ★ ★ ★ ☆ 80分 ```sql SELECT film_id FROM film ORDER BY release_year LIMIT 10 ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 # Query: 965D5AC955824512 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 ORDER BY LENGTH LIMIT 10 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 1E2CF4145EE706A5 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH < 100 ORDER BY LENGTH LIMIT 10 ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: A314542EEE8571EE ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM customer WHERE address_id in (224, 510) ORDER BY last_name ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 0BE2D79E2F1E7CB0 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE release_year = 2016 AND LENGTH != 1 ORDER BY title ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## '!=' 运算符是非标准的 * **Item:** STA.001 * **Severity:** L0 * **Content:** "<>"才是标准SQL中的不等于运算符。 # Query: 4E73AA068370E6A8 ★ ★ ★ ★ ★ 100分 ```sql SELECT title FROM film WHERE release_year = 1995 ``` ## OK # Query: BA7111449E4F1122 ★ ★ ★ ★ ★ 100分 ```sql SELECT title, replacement_cost FROM film WHERE language_id = 5 AND LENGTH = 70 ``` ## OK # Query: B13E0ACEAF8F3119 ★ ★ ★ ★ ★ 100分 ```sql SELECT title FROM film WHERE language_id > 5 AND LENGTH > 70 ``` ## OK # Query: A3FAB6027484B88B ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH = 100 AND title = 'xyz' ORDER BY release_year ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: CB42080E9F35AB07 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND title = 'xyz' ORDER BY release_year ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: C4A212A42400411D ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE LENGTH > 100 ORDER BY release_year ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 4ECCA9568BE69E68 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM city a INNER JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 485D56FC88BBBDB9 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 0D0DABACEDFF5765 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 1E56C6CCEA2131CC ★ ★ ★ ★ ☆ 90分 ```sql SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id WHERE b. last_update IS NULL ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: F5D30BCAC1E206A1 ★ ★ ★ ★ ☆ 90分 ```sql SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id WHERE a. last_update IS NULL ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 17D5BCF21DC2364C ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: A4911095C201896F ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id WHERE a. last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id WHERE b. last_update IS NULL ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: 3FF20E28EC9CBEF9 ★ ★ ★ ★ ★ 100分 ```sql SELECT country_id, last_update FROM city NATURAL JOIN country ``` ## OK # Query: 5C547F08EADBB131 ★ ★ ★ ★ ★ 100分 ```sql SELECT country_id, last_update FROM city NATURAL LEFT JOIN country ``` ## OK # Query: AF0C1EB58B23D2FA ★ ★ ★ ★ ★ 100分 ```sql SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country ``` ## OK # Query: 626571EAE84E2C8A ★ ★ ★ ★ ★ 100分 ```sql SELECT a. country_id, a. last_update FROM city a STRAIGHT_JOIN country b ON a. country_id= b. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 # Query: 50F2AB4243CE2071 ★ ★ ★ ☆ ☆ 60分 ```sql SELECT a. address, a. postal_code FROM sakila. address a WHERE a. city_id IN ( SELECT c. city_id FROM sakila. city c) ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 584CCEC8069B6947 ★ ★ ★ ☆ ☆ 60分 ```sql SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I. city_id = city. city_id) JOIN country ON (country. country_id = city. country_id) ORDER BY city DESC ``` ## 同一张表被连接两次 * **Item:** JOI.002 * **Severity:** L4 * **Content:** 相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 7F02E23D44A38A6D ★ ★ ★ ★ ☆ 80分 ```sql DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city. city_id = 1 ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: F8314ABD1CBF2FF1 ★ ★ ★ ★ ☆ 80分 ```sql DELETE city FROM city LEFT JOIN country ON city. country_id = country. country_id WHERE country. country IS NULL ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: 1A53649C43122975 ★ ★ ★ ★ ☆ 80分 ```sql DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1. country_id= a2. country_id ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: B862978586C6338B ★ ★ ★ ★ ☆ 80分 ```sql DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1. country_id= a2. country_id ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: F16FD63381EF8299 ★ ★ ★ ★ ★ 100分 ```sql DELETE FROM film WHERE LENGTH > 100 ``` ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: 08CFE41C7D20AAC8 ★ ★ ★ ★ ☆ 80分 ```sql UPDATE city INNER JOIN country USING( country_id) SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. city_id= 10 ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 # Query: C15BDF2C73B5B7ED ★ ★ ★ ★ ☆ 80分 ```sql UPDATE city INNER JOIN country ON city. country_id = country. country_id INNER JOIN address ON city. city_id = address. city_id SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. city_id= 10 ``` ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 # Query: FCD1ABF36F8CDAD7 ★ ★ ★ ★ ★ 100分 ```sql UPDATE city, country SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. country_id = country. country_id AND city. city_id= 10 ``` ## OK # Query: FE409EB794EE91CF ★ ★ ★ ★ ★ 100分 ```sql UPDATE film SET LENGTH = 10 WHERE language_id = 20 ``` ## OK # Query: 3656B13CC4F888E2 ★ ★ ★ ☆ ☆ 65分 ```sql INSERT INTO city (country_id) SELECT country_id FROM country ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: 2F7439623B712317 ★ ★ ★ ★ ★ 100分 ```sql INSERT INTO city (country_id) VALUES (1), (2), (3) ``` ## OK # Query: 11EC7AAACC97DC0F ★ ★ ★ ★ ☆ 85分 ```sql INSERT INTO city (country_id) SELECT 10 FROM DUAL ``` ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: E3DDA1A929236E72 ★ ★ ★ ☆ ☆ 65分 ```sql REPLACE INTO city (country_id) SELECT country_id FROM country ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: 466F1AC2F5851149 ★ ★ ★ ★ ★ 100分 ```sql REPLACE INTO city (country_id) VALUES (1), (2), (3) ``` ## OK # Query: A7973BDD268F926E ★ ★ ★ ★ ☆ 85分 ```sql REPLACE INTO city (country_id) SELECT 10 FROM DUAL ``` ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: 105C870D5DFB6710 ★ ★ ★ ☆ ☆ 65分 ```sql SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 执行计划中嵌套连接深度过深 * **Item:** SUB.004 * **Severity:** L3 * **Content:** MySQL对子查询的优化效果不佳,MySQL将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。 # Query: 16C2B14E7DAA9906 ★ ☆ ☆ ☆ ☆ 35分 ```sql SELECT * FROM film WHERE language_id = ( SELECT language_id FROM language LIMIT 1) ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 未使用 ORDER BY 的 LIMIT 查询 * **Item:** RES.002 * **Severity:** L4 * **Content:** 没有 ORDER BY 的 LIMIT 会导致非确定性的结果,这取决于查询执行计划。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 16CB4628D2597D40 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city i LEFT JOIN country o ON i. city_id= o. country_id UNION SELECT * FROM city i RIGHT JOIN country o ON i. city_id= o. country_id ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: EA50643B01E139A8 ★ ★ ☆ ☆ ☆ 45分 ```sql SELECT * FROM ( SELECT * FROM actor WHERE last_update= '2006-02-15 04:34:33' AND last_name= 'CHASE' ) t WHERE last_update= '2006-02-15 04:34:33' AND last_name= 'CHASE' GROUP BY first_name ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 非确定性的 GROUP BY * **Item:** RES.001 * **Severity:** L4 * **Content:** SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 7598A4EDE6CFA6BE ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city i LEFT JOIN country o ON i. city_id= o. country_id WHERE o. country_id is null UNION SELECT * FROM city i RIGHT JOIN country o ON i. city_id= o. country_id WHERE i. city_id is null ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: 1E8B70E30062FD13 ★ ★ ★ ★ ★ 100分 ```sql SELECT first_name, last_name, email FROM customer STRAIGHT_JOIN address ON customer. address_id= address. address_id ``` ## OK # Query: E48A20D0413512DA ★ ★ ★ ☆ ☆ 60分 ```sql SELECT ID, name FROM ( SELECT address FROM customer_list WHERE SID= 1 ORDER BY phone LIMIT 50, 10) a JOIN customer_list l ON (a. address= l. address) JOIN city c ON (c. city= l. city) ORDER BY phone desc ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 同一张表被连接两次 * **Item:** JOI.002 * **Severity:** L4 * **Content:** 相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: B0BA5A7079EA16B3 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE DATE( last_update) = '2006-02-15' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 避免在 WHERE 条件中使用函数或其他运算符 * **Item:** FUN.001 * **Severity:** L2 * **Content:** 虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。 # Query: 18A2AD1395A58EAE ★ ★ ★ ☆ ☆ 60分 ```sql SELECT last_update FROM film GROUP BY DATE( last_update) ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## GROUP BY 的条件为表达式 * **Item:** CLA.010 * **Severity:** L2 * **Content:** 当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 # Query: 60F234BA33AAC132 ★ ★ ★ ☆ ☆ 70分 ```sql SELECT last_update FROM film ORDER BY DATE( last_update) ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## ORDER BY 的条件为表达式 * **Item:** CLA.009 * **Severity:** L2 * **Content:** 当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 # Query: 1ED2B7ECBA4215E1 ★ ★ ★ ★ ☆ 90分 ```sql SELECT description FROM film WHERE description IN( 'NEWS', 'asd' ) GROUP BY description ``` ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 # Query: 255BAC03F56CDBC7 ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE address ADD index idx_city_id( city_id) ``` ## OK # Query: C315BC4EE0F4E523 ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE inventory ADD index `idx_store_film` ( `store_id`, `film_id`) ``` ## 提醒:请将索引属性顺序与查询对齐 * **Item:** KEY.004 * **Severity:** L0 * **Content:** 如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。 # Query: 9BB74D074BA0727C ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE inventory ADD index `idx_store_film` ( `store_id`, `film_id`), ADD index `idx_store_film` ( `store_id`, `film_id`), ADD index `idx_store_film` ( `store_id`, `film_id`) ``` ## 提醒:请将索引属性顺序与查询对齐 * **Item:** KEY.004 * **Severity:** L0 * **Content:** 如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。 # Query: C95B5C028C8FFF95 ★ ★ ☆ ☆ ☆ 40分 ```sql SELECT DATE_FORMAT( t. last_update, '%Y-%m-%d' ), COUNT( DISTINCT ( t. city)) FROM city t WHERE t. last_update > '2018-10-22 00:00:00' AND t. city LIKE '%Chrome%' AND t. city = 'eip' GROUP BY DATE_FORMAT( t. last_update, '%Y-%m-%d' ) ORDER BY DATE_FORMAT( t. last_update, '%Y-%m-%d' ) ``` ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用前项通配符查找 * **Item:** ARG.001 * **Severity:** L4 * **Content:** 例如 "%foo",查询参数有一个前项通配符的情况无法使用已有索引。 ## ORDER BY 的条件为表达式 * **Item:** CLA.009 * **Severity:** L2 * **Content:** 当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 ## GROUP BY 的条件为表达式 * **Item:** CLA.010 * **Severity:** L2 * **Content:** 当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 ## ORDER BY 多个列但排序方向不同时可能无法使用索引 * **Item:** KEY.008 * **Severity:** L4 * **Content:** 在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。 # Query: C11ECE7AE5F80CE5 ★ ★ ☆ ☆ ☆ 45分 ```sql create table hello. t (id int unsigned) ``` ## 建议为表添加注释 * **Item:** CLA.011 * **Severity:** L1 * **Content:** 为表添加注释能够使得表的意义更明确,从而为日后的维护带来极大的便利。 ## 请为列添加默认值 * **Item:** COL.004 * **Severity:** L1 * **Content:** 请为列添加默认值,如果是 ALTER 操作,请不要忘记将原字段的默认值写上。字段无默认值,当表较大时无法在线变更表结构。 ## 列未添加注释 * **Item:** COL.005 * **Severity:** L1 * **Content:** 建议对表中每个列添加注释,来明确每个列在表中的含义及作用。 ## 未指定主键或主键非 int 或 bigint * **Item:** KEY.007 * **Severity:** L4 * **Content:** 未指定主键或主键非 int 或 bigint,建议将主键设置为 int unsigned 或 bigint unsigned。 ## 请为表选择合适的存储引擎 * **Item:** TBL.002 * **Severity:** L4 * **Content:** 建表或修改表的存储引擎时建议使用推荐的存储引擎,如:innodb # Query: 291F95B7DCB74C21 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM tb WHERE data >= '' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 084DA3E3EE38DD85 ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE tb alter column id DROP DEFAULT ``` ## OK # Query: B48292EDB9D0E010 ★ ★ ☆ ☆ ☆ 50分 ```sql SELECT maxId, minId FROM ( SELECT MAX( film_id) maxId, MIN( film_id) minId FROM film WHERE last_update > '2016-03-27 02:01:01' ) as d ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 ## 不建议在子查询中使用函数 * **Item:** SUB.006 * **Severity:** L2 * **Content:** MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。 # Query: 4A39009B402BAD9B ★ ★ ☆ ☆ ☆ 50分 ```sql SELECT maxId, minId FROM ( SELECT MAX( film_id) maxId, MIN( film_id) minId FROM film) as d ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 ## 不建议在子查询中使用函数 * **Item:** SUB.006 * **Severity:** L2 * **Content:** MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。 ================================================ FILE: test/fixture/test_Check_soar_report_for_html.golden ================================================ soar report check

Query: 687D590364E29465

★ ★ ★ ☆ ☆ 75分

select * from film

最外层 SELECT 未指定 WHERE 条件

  • Item: CLA.001

  • Severity: L4

  • Content: SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。

不建议使用 SELECT * 类型查询

  • Item: COL.001

  • Severity: L1

  • Content: 当表结构变更时,使用 * 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。

================================================ FILE: test/fixture/test_Check_soar_report_for_json.golden ================================================ [ { "ID": "687D590364E29465", "Fingerprint": "select * from film", "Score": 75, "Sample": "select * from film", "Explain": null, "HeuristicRules": [ { "Item": "CLA.001", "Severity": "L4", "Summary": "最外层 SELECT 未指定 WHERE 条件", "Content": "SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。", "Case": "select id from tbl", "Position": 0 }, { "Item": "COL.001", "Severity": "L1", "Summary": "不建议使用 SELECT * 类型查询", "Content": "当表结构变更时,使用 * 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。", "Case": "select * from tbl where id=1", "Position": 0 } ], "IndexRules": null, "Tables": [ "`information_schema`.`film`" ] } ] ================================================ FILE: test/fixture/test_Check_soar_report_for_markdown.golden ================================================ # Query: 687D590364E29465 ★ ★ ★ ☆ ☆ 75分 ```sql SELECT * FROM film ``` ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ================================================ FILE: test/fixture/test_Check_the_default_config_of_the_changes.golden ================================================ online-dsn: user: online-test password: '********' net: tcp addr: 192.168.12.200:3307 schema: information_schema charset: utf8mb4 collation: utf8mb4_general_ci loc: GMT tls: dsfsfdsf server-public-key: AAAAB3NzaC1yc2EAAAADAQABAAABAQC0JFhoEgrl5/51UHlIIlfWwhiJLR/EEeF8enGnY0PnAldLQ8STdWD8Um2BUtVjgE9COl1X3mN4vMvnSm8A6aPn66enHn0hKzwh1GvcuZNTPgeaZyGKWG0kcvbziUjAPsxxvRvvoaUspSkRYAP/9vpq3SImJKuIHCPfjnGMurKV1n7W/QfpmNjUEwYOswDjL1Ik6Jy6Lrzf8T0hQEy+dYoV4zNM0HcROCXFuu1LyG+WTch3FW660BecNT8+c4sVTHuUMXgGot8OUtwgfXrt5ZL5as7cuyKiWsLVrtrtvL3T0ZHlV8qxQ3DT1gqjSw6jBOzyDOx3jwthAbdsWjyK4Oqp max-allowed-packet: 419437 params: charset: utf8mb4 timeout: 60s read-timeout: 70s write-timeout: 80s allow-native-passwords: false allow-old-passwords: true disable: false test-dsn: user: test-user password: '********' net: tcp addr: 192.168.12.34:3309 schema: information_schema charset: utf8mb4 collation: utf8mb4_general_ci loc: GMT tls: aabbbaa server-public-key: this is a tset serverpublic max-allowed-packet: 4194309 params: charset: utf8mb4 timeout: 50s read-timeout: 40s write-timeout: 30s allow-native-passwords: false allow-old-passwords: true disable: false allow-online-as-test: true disable-version-check: false drop-test-temporary: false cleanup-test-database: true only-syntax-check: true sampling-statistic-target: 110 sampling: true sampling-condition: aaa profiling: true trace: true explain: false delimiter: ; log-level: 3 log-output: /dev/null report-type: html report-css: sdfs report-javascript: sdfsd report-title: SQL优化分析报告-test markdown-extensions: 92 markdown-html-flags: 10 ignore-rules: - COL.012 rewrite-rules: - delimiter - orderbynull - groupbyconst - dmlorderby - having - star2columns - insertcolumns - distinctstar blacklist: /tmp/blacklist max-join-table-count: 12 max-group-by-cols-count: 15 max-distinct-count: 7 max-index-cols-count: 2 max-text-cols-count: 3 max-total-rows: 9999991 max-query-cost: 9992 spaghetti-query-length: 2041 allow-drop-index: true max-in-count: 101 max-index-bytes-percolumn: 762 max-index-bytes: 3073 allow-charsets: - utf8 - utf8mb4 allow-collates: [] allow-engines: - innodb - tokudb max-index-count: 12 max-column-count: 41 max-value-count: 102 index-prefix: idx_ unique-key-prefix: uk_ max-subquery-depth: 6 max-varchar-length: 1022 column-not-allow-type: - boolean min-cardinality: 2 explain-sql-report-type: pretty explain-type: extended explain-format: traditional explain-warn-select-type: - "" explain-warn-access-type: - ALL explain-max-keys: 31 explain-min-keys: 10 explain-max-rows: 10002 explain-warn-extra: - Using temporary - Using filesort explain-max-filtered: 120 explain-warn-scalability: - O(log(n)) show-warnings: true show-last-query-cost: true query: "" list-heuristic-rules: true list-rewrite-rules: true list-test-sqls: true list-report-types: true verbose: true dry-run: false max-pretty-sql-length: 1022 ================================================ FILE: test/fixture/test_Run_all_test_cases.golden ================================================ # Query: C3FAEDA6AD6D762B ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH = 86 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: E969B9297DA79BA6 ★ ★ ★ ★ ☆ 80分 ```sql SELECT * FROM film WHERE LENGTH IS NULL ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 8A106444D14B9880 ★ ★ ★ ☆ ☆ 60分 ```sql SELECT * FROM film HAVING title = 'abc' ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 HAVING 子句 * **Item:** CLA.013 * **Severity:** L3 * **Content:** 将查询的 HAVING 子句改写为 WHERE 中的查询条件,可以在查询处理期间使用索引。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: A0C5E62C724A121A ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM sakila. film WHERE LENGTH >= 60 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 868317D1973FD1B0 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH BETWEEN 60 AND 84 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 707FE669669FA075 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM film WHERE title LIKE 'AIR%' ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | range | idx\_title | idx\_title | 767 | NULL | 2 | ☠️ **100.00%** | O(log n)+ | Using index condition | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **range**: 只检索给定范围的行, 使用一个索引来选择行. key列显示使用了哪个索引. key_len包含所使用索引的最长关键元素. #### Extra信息解读 * **Using index condition**: 在5.6版本后加入的新特性(Index Condition Pushdown)。Using index condition 会先条件过滤索引,过滤完索引后找到所有符合索引条件的数据行,随后用 WHERE 子句中的其他条件去过滤这些数据行。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: DF916439ABD07664 ★ ★ ★ ★ ☆ 90分 ```sql SELECT * FROM film WHERE title IS NOT NULL ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: B9336971FF3D3792 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH = 114 AND title = 'ALABAMA DEVIL' ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ref | idx\_title | idx\_title | 767 | const | 1 | n% | O(log n) | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列title添加索引,散粒度为: n%; 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_title\_length\` (\`title\`,\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 68E48001ECD53152 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND title = 'ALABAMA DEVIL' ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ref | idx\_title | idx\_title | 767 | const | 1 | n% | O(log n) | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列title添加索引,散粒度为: n%; 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_title\_length\` (\`title\`,\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 12FF1DAA3D425FA9 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND language_id < 10 AND title = 'xyz' ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ref | idx\_title,
idx\_fk\_language\_id | idx\_title | 767 | const | 1 | n% | O(log n) | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列title添加索引,散粒度为: n%; 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_title\_length\` (\`title\`,\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: E84CBAAC2E12BDEA ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND language_id < 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | idx\_fk\_language\_id | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 6A0F035BD4E01018 ★ ★ ★ ☆ ☆ 75分 ```sql SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH = 123 AND language_id = 1 GROUP BY release_year ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | idx\_fk\_language\_id | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using temporary | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; 为列language\_id添加索引,散粒度为: n%; 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\_language\_id\_release\_year\` (\`length\`,\`language\_id\`,\`release\_year\`) ; ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: 23D176AEA2947002 ★ ★ ★ ☆ ☆ 75分 ```sql SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH >= 123 GROUP BY release_year ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using temporary | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\_release\_year\` (\`length\`,\`release\_year\`) ; ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: 73DDF6E6D9E40384 ★ ★ ☆ ☆ ☆ 55分 ```sql SELECT release_year, language_id, SUM( LENGTH) FROM film GROUP BY release_year, language_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using temporary | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列release\_year添加索引,散粒度为: n%; 为列language\_id添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_release\_year\_language\_id\` (\`release\_year\`,\`language\_id\`) ; ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: B3C502B4AA344196 ★ ★ ★ ☆ ☆ 65分 ```sql SELECT release_year, SUM( LENGTH) FROM film WHERE LENGTH = 123 GROUP BY release_year, (LENGTH+ language_id) ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using temporary | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## GROUP BY 的条件为表达式 * **Item:** CLA.010 * **Severity:** L2 * **Content:** 当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 ## 使用 SUM(COL) 时需注意 NPE 问题 * **Item:** FUN.006 * **Severity:** L1 * **Content:** 当某一列的值全是 NULL 时,COUNT(COL) 的返回结果为0,但 SUM(COL) 的返回结果为 NULL,因此使用 SUM() 时需注意 NPE 问题。可以使用如下方式来避免 SUM 的 NPE 问题: SELECT IF(ISNULL(SUM(COL)), 0, SUM(COL)) FROM tbl # Query: 47044E1FE1A965A5 ★ ★ ★ ☆ ☆ 60分 ```sql SELECT release_year, SUM( film_id) FROM film GROUP BY release_year ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using temporary | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_release\_year\` (\`release\_year\`) ; ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 # Query: 2BA1217F6C8CF0AB ★ ☆ ☆ ☆ ☆ 35分 ```sql SELECT * FROM address GROUP BY address, district ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *address* | NULL | ALL | NULL | NULL | NULL | NULL | 603 | ☠️ **100.00%** | ☠️ **O(n)** | Using temporary | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的address表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列address添加索引,散粒度为: n%; 为列district添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`address\` add index \`idx\_address\_district\` (\`address\`,\`district\`) ; ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 非确定性的 GROUP BY * **Item:** RES.001 * **Severity:** L4 * **Content:** SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 # Query: 863A85207E4F410D ★ ★ ★ ★ ☆ 80分 ```sql SELECT title FROM film WHERE ABS( language_id) = 3 GROUP BY title ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | index | idx\_title | idx\_title | 767 | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **index**: 全表扫描, 只是扫描表的时候按照索引次序进行而不是行. 主要优点就是避免了排序, 但是开销仍然非常大. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 避免在 WHERE 条件中使用函数或其他运算符 * **Item:** FUN.001 * **Severity:** L2 * **Content:** 虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。 # Query: DF59FD602E4AA368 ★ ★ ★ ☆ ☆ 70分 ```sql SELECT language_id FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY language_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using temporary; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\_release\_year\` (\`length\`,\`release\_year\`) ; ## 非确定性的 GROUP BY * **Item:** RES.001 * **Severity:** L4 * **Content:** SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 # Query: F6DBEAA606D800FC ★ ★ ★ ★ ☆ 90分 ```sql SELECT release_year FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY release_year ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using temporary; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\_release\_year\` (\`length\`,\`release\_year\`) ; # Query: 6E9B96CA3F0E6BDA ★ ★ ★ ☆ ☆ 65分 ```sql SELECT * FROM film WHERE LENGTH = 123 ORDER BY release_year ASC, language_id DESC ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## ORDER BY 多个列但排序方向不同时可能无法使用索引 * **Item:** KEY.008 * **Severity:** L4 * **Content:** 在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。 # Query: 2EAACFD7030EA528 ★ ★ ★ ★ ☆ 90分 ```sql SELECT release_year FROM film WHERE LENGTH = 123 GROUP BY release_year ORDER BY release_year LIMIT 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using temporary; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\_release\_year\` (\`length\`,\`release\_year\`) ; # Query: 5CE2F187DBF2A710 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH = 123 ORDER BY release_year LIMIT 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\_release\_year\` (\`length\`,\`release\_year\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: E75234155B5E2E14 ★ ★ ★ ☆ ☆ 75分 ```sql SELECT * FROM film ORDER BY release_year LIMIT 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: AFEEBF10A8D74E32 ★ ★ ★ ★ ☆ 80分 ```sql SELECT film_id FROM film ORDER BY release_year LIMIT 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 # Query: 965D5AC955824512 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH > 100 ORDER BY LENGTH LIMIT 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 1E2CF4145EE706A5 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH < 100 ORDER BY LENGTH LIMIT 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: A314542EEE8571EE ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM customer WHERE address_id in (224, 510) ORDER BY last_name ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *customer* | NULL | range | idx\_fk\_address\_id | idx\_fk\_address\_id | 2 | NULL | 2 | ☠️ **100.00%** | O(log n)+ | Using index condition; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **range**: 只检索给定范围的行, 使用一个索引来选择行. key列显示使用了哪个索引. key_len包含所使用索引的最长关键元素. #### Extra信息解读 * **Using index condition**: 在5.6版本后加入的新特性(Index Condition Pushdown)。Using index condition 会先条件过滤索引,过滤完索引后找到所有符合索引条件的数据行,随后用 WHERE 子句中的其他条件去过滤这些数据行。 * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的customer表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列address\_id添加索引,散粒度为: n%; 为列last\_name添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`customer\` add index \`idx\_address\_id\_last\_name\` (\`address\_id\`,\`last\_name\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 0BE2D79E2F1E7CB0 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE release_year = 2016 AND LENGTH != 1 ORDER BY title ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列release\_year添加索引,散粒度为: n%; 为列length添加索引,散粒度为: n%; 为列title添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_release\_year\_length\_title\` (\`release\_year\`,\`length\`,\`title\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## '!=' 运算符是非标准的 * **Item:** STA.001 * **Severity:** L0 * **Content:** "<>"才是标准SQL中的不等于运算符。 # Query: 4E73AA068370E6A8 ★ ★ ★ ★ ☆ 90分 ```sql SELECT title FROM film WHERE release_year = 1995 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_release\_year\` (\`release\_year\`) ; # Query: BA7111449E4F1122 ★ ★ ★ ★ ☆ 90分 ```sql SELECT title, replacement_cost FROM film WHERE language_id = 5 AND LENGTH = 70 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ref | idx\_fk\_language\_id | idx\_fk\_language\_id | 1 | const | 1 | n% | O(log n) | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; 为列language\_id添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\_language\_id\` (\`length\`,\`language\_id\`) ; # Query: B13E0ACEAF8F3119 ★ ★ ★ ★ ☆ 90分 ```sql SELECT title FROM film WHERE language_id > 5 AND LENGTH > 70 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | range | idx\_fk\_language\_id | idx\_fk\_language\_id | 1 | NULL | 1 | n% | O(log n)+ | Using index condition; Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **range**: 只检索给定范围的行, 使用一个索引来选择行. key列显示使用了哪个索引. key_len包含所使用索引的最长关键元素. #### Extra信息解读 * **Using index condition**: 在5.6版本后加入的新特性(Index Condition Pushdown)。Using index condition 会先条件过滤索引,过滤完索引后找到所有符合索引条件的数据行,随后用 WHERE 子句中的其他条件去过滤这些数据行。 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; # Query: A3FAB6027484B88B ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH = 100 AND title = 'xyz' ORDER BY release_year ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ref | idx\_title | idx\_title | 767 | const | 1 | n% | O(log n) | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列title添加索引,散粒度为: n%; 为列length添加索引,散粒度为: n%; 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_title\_length\_release\_year\` (\`title\`,\`length\`,\`release\_year\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: CB42080E9F35AB07 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH > 100 AND title = 'xyz' ORDER BY release_year ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ref | idx\_title | idx\_title | 767 | const | 1 | n% | O(log n) | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列title添加索引,散粒度为: n%; 为列length添加索引,散粒度为: n%; 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_title\_length\_release\_year\` (\`title\`,\`length\`,\`release\_year\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: C4A212A42400411D ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH > 100 ORDER BY release_year ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; 为列release\_year添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\_release\_year\` (\`length\`,\`release\_year\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 4ECCA9568BE69E68 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM city a INNER JOIN country b ON a. country_id= b. country_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *b* | NULL | ALL | PRIMARY | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *a* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.b.country\_id | 5 | ☠️ **100.00%** | O(log n) | NULL | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 485D56FC88BBBDB9 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *a* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *b* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.a.country\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 0D0DABACEDFF5765 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *b* | NULL | ALL | NULL | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *a* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.b.country\_id | 5 | ☠️ **100.00%** | O(log n) | NULL | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 1E56C6CCEA2131CC ★ ★ ★ ★ ☆ 80分 ```sql SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id WHERE b. last_update IS NULL ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *a* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *b* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.a.country\_id | 1 | n% | O(log n) | Using where; Not exists | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Not exists**: MySQL能够对LEFT JOIN查询进行优化, 并且在查找到符合LEFT JOIN条件的行后, 则不再查找更多的行. * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的country表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列last\_update添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`country\` add index \`idx\_last\_update\` (\`last\_update\`) ; ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: F5D30BCAC1E206A1 ★ ★ ★ ★ ☆ 80分 ```sql SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id WHERE a. last_update IS NULL ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *b* | NULL | ALL | NULL | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *a* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.b.country\_id | 5 | n% | O(log n) | Using where; Not exists | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Not exists**: MySQL能够对LEFT JOIN查询进行优化, 并且在查找到符合LEFT JOIN条件的行后, 则不再查找更多的行. * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的city表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列last\_update添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`city\` add index \`idx\_last\_update\` (\`last\_update\`) ; ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 应尽量避免在 WHERE 子句中对字段进行 NULL 值判断 * **Item:** ARG.006 * **Severity:** L1 * **Content:** 使用 IS NULL 或 IS NOT NULL 将可能导致引擎放弃使用索引而进行全表扫描,如:select id from t where num is null;可以在num上设置默认值0,确保表中 num 列没有 NULL 值,然后这样查询: select id from t where num=0; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 17D5BCF21DC2364C ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id UNION SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | PRIMARY | *a* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | PRIMARY | *b* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.a.country\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | | 2 | UNION | *b* | NULL | ALL | NULL | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 2 | UNION | *a* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.b.country\_id | 5 | ☠️ **100.00%** | O(log n) | NULL | | 2 | UNION | *a* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.b.country\_id | 5 | ☠️ **100.00%** | O(log n) | NULL | ### Explain信息解读 #### SelectType信息解读 * **PRIMARY**: 最外层的select. * **UNION**: UNION中的第二个或后面的SELECT查询, 不依赖于外部查询的结果集. #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: A4911095C201896F ★ ★ ★ ☆ ☆ 65分 ```sql SELECT * FROM city a RIGHT JOIN country b ON a. country_id= b. country_id WHERE a. last_update IS NULL UNION SELECT * FROM city a LEFT JOIN country b ON a. country_id= b. country_id WHERE b. last_update IS NULL ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | PRIMARY | *b* | NULL | ALL | NULL | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | PRIMARY | *a* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.b.country\_id | 5 | n% | O(log n) | Using where; Not exists | | 2 | UNION | *a* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 2 | UNION | *b* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.a.country\_id | 1 | n% | O(log n) | Using where; Not exists | | 2 | UNION | *b* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.a.country\_id | 1 | n% | O(log n) | Using where; Not exists | ### Explain信息解读 #### SelectType信息解读 * **PRIMARY**: 最外层的select. * **UNION**: UNION中的第二个或后面的SELECT查询, 不依赖于外部查询的结果集. #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Not exists**: MySQL能够对LEFT JOIN查询进行优化, 并且在查找到符合LEFT JOIN条件的行后, 则不再查找更多的行. * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的city表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列last\_update添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`city\` add index \`idx\_last\_update\` (\`last\_update\`) ; ## 为sakila库的country表添加索引 * **Item:** IDX.002 * **Severity:** L2 * **Content:** 为列last\_update添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`country\` add index \`idx\_last\_update\` (\`last\_update\`) ; ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: 3FF20E28EC9CBEF9 ★ ★ ★ ★ ★ 100分 ```sql SELECT country_id, last_update FROM city NATURAL JOIN country ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *country* | NULL | ALL | PRIMARY | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *city* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.country.country\_id | 5 | n% | O(log n) | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. # Query: 5C547F08EADBB131 ★ ★ ★ ★ ★ 100分 ```sql SELECT country_id, last_update FROM city NATURAL LEFT JOIN country ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *city* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *country* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.city.country\_id | 1 | ☠️ **100.00%** | O(log n) | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. # Query: AF0C1EB58B23D2FA ★ ★ ★ ★ ★ 100分 ```sql SELECT country_id, last_update FROM city NATURAL RIGHT JOIN country ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *country* | NULL | ALL | NULL | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *city* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.country.country\_id | 5 | ☠️ **100.00%** | O(log n) | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. # Query: 626571EAE84E2C8A ★ ★ ★ ★ ★ 100分 ```sql SELECT a. country_id, a. last_update FROM city a STRAIGHT_JOIN country b ON a. country_id= b. country_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *a* | NULL | ALL | idx\_fk\_country\_id | NULL | NULL | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *b* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.a.country\_id | 1 | ☠️ **100.00%** | O(log n) | Using index | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 # Query: 50F2AB4243CE2071 ★ ★ ★ ☆ ☆ 60分 ```sql SELECT a. address, a. postal_code FROM sakila. address a WHERE a. city_id IN ( SELECT c. city_id FROM sakila. city c) ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *c* | NULL | index | PRIMARY | idx\_fk\_country\_id | 2 | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | Using index | | 1 | SIMPLE | *a* | NULL | ref | idx\_fk\_city\_id | idx\_fk\_city\_id | 2 | sakila.c.city\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **index**: 全表扫描, 只是扫描表的时候按照索引次序进行而不是行. 主要优点就是避免了排序, 但是开销仍然非常大. * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 584CCEC8069B6947 ★ ★ ☆ ☆ ☆ 50分 ```sql SELECT city FROM( SELECT city_id FROM city WHERE city = "A Corua (La Corua)" ORDER BY last_update DESC LIMIT 50, 10) I JOIN city ON (I. city_id = city. city_id) JOIN country ON (country. country_id = city. country_id) ORDER BY city DESC ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | PRIMARY | ** | NULL | ALL | NULL | NULL | NULL | NULL | 60 | ☠️ **100.00%** | ☠️ **O(n)** | Using temporary; Using filesort | | 1 | PRIMARY | *city* | NULL | eq\_ref | PRIMARY,
idx\_fk\_country\_id | PRIMARY | 2 | I.city\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | | 1 | PRIMARY | *country* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.city.country\_id | 1 | ☠️ **100.00%** | O(log n) | Using index | | 2 | DERIVED | *city* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | n% | ☠️ **O(n)** | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **DERIVED**: 用于from子句里有子查询的情况. MySQL会递归执行这些子查询, 把结果放在临时表里. * **PRIMARY**: 最外层的select. #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的city表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列city添加索引,散粒度为: n%; 为列last\_update添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`city\` add index \`idx\_city\_last\_update\` (\`city\`,\`last\_update\`) ; ## 同一张表被连接两次 * **Item:** JOI.002 * **Severity:** L4 * **Content:** 相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 7F02E23D44A38A6D ★ ★ ★ ★ ☆ 80分 ```sql DELETE city, country FROM city INNER JOIN country using (country_id) WHERE city. city_id = 1 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | DELETE | *city* | NULL | const | PRIMARY,
idx\_fk\_country\_id | PRIMARY | 2 | const | 1 | ☠️ **100.00%** | O(1) | NULL | | 1 | DELETE | *country* | NULL | const | PRIMARY | PRIMARY | 2 | const | 1 | ☠️ **100.00%** | O(1) | NULL | ### Explain信息解读 #### Type信息解读 * **const**: const用于使用常数值比较PRIMARY KEY时, 当查询的表仅有一行时, 使用system. 例:SELECT * FROM tbl WHERE col = 1. ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: F8314ABD1CBF2FF1 ★ ★ ★ ☆ ☆ 70分 ```sql DELETE city FROM city LEFT JOIN country ON city. country_id = country. country_id WHERE country. country IS NULL ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | DELETE | *city* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *country* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.city.country\_id | 1 | n% | O(log n) | Using where; Not exists | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Not exists**: MySQL能够对LEFT JOIN查询进行优化, 并且在查找到符合LEFT JOIN条件的行后, 则不再查找更多的行. * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的country表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列country添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`country\` add index \`idx\_country\` (\`country\`) ; ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: 1A53649C43122975 ★ ★ ★ ★ ☆ 80分 ```sql DELETE a1, a2 FROM city AS a1 INNER JOIN country AS a2 WHERE a1. country_id= a2. country_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | DELETE | *a2* | NULL | ALL | PRIMARY | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | DELETE | *a1* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.a2.country\_id | 5 | ☠️ **100.00%** | O(log n) | NULL | ### Explain信息解读 #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: B862978586C6338B ★ ★ ★ ★ ☆ 80分 ```sql DELETE FROM a1, a2 USING city AS a1 INNER JOIN country AS a2 WHERE a1. country_id= a2. country_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | DELETE | *a2* | NULL | ALL | PRIMARY | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | DELETE | *a1* | NULL | ref | idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.a2.country\_id | 5 | ☠️ **100.00%** | O(log n) | NULL | ### Explain信息解读 #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: F16FD63381EF8299 ★ ★ ★ ★ ☆ 90分 ```sql DELETE FROM film WHERE LENGTH > 100 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | DELETE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using where | ### Explain信息解读 #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 使用DELETE/DROP/TRUNCATE等操作时注意备份 * **Item:** SEC.003 * **Severity:** L0 * **Content:** 在执行高危操作之前对数据进行备份是十分有必要的。 # Query: 08CFE41C7D20AAC8 ★ ★ ★ ★ ☆ 80分 ```sql UPDATE city INNER JOIN country USING( country_id) SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. city_id= 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | UPDATE | *city* | NULL | const | PRIMARY,
idx\_fk\_country\_id | PRIMARY | 2 | const | 1 | ☠️ **100.00%** | O(1) | NULL | | 1 | UPDATE | *country* | NULL | const | PRIMARY | PRIMARY | 2 | const | 1 | ☠️ **100.00%** | O(1) | NULL | ### Explain信息解读 #### Type信息解读 * **const**: const用于使用常数值比较PRIMARY KEY时, 当查询的表仅有一行时, 使用system. 例:SELECT * FROM tbl WHERE col = 1. ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 # Query: C15BDF2C73B5B7ED ★ ★ ★ ★ ☆ 80分 ```sql UPDATE city INNER JOIN country ON city. country_id = country. country_id INNER JOIN address ON city. city_id = address. city_id SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. city_id= 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | UPDATE | *city* | NULL | const | PRIMARY,
idx\_fk\_country\_id | PRIMARY | 2 | const | 1 | ☠️ **100.00%** | O(1) | NULL | | 1 | UPDATE | *country* | NULL | const | PRIMARY | PRIMARY | 2 | const | 1 | ☠️ **100.00%** | O(1) | NULL | | 1 | SIMPLE | *address* | NULL | ref | idx\_fk\_city\_id | idx\_fk\_city\_id | 2 | const | 1 | ☠️ **100.00%** | O(log n) | Using index | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **const**: const用于使用常数值比较PRIMARY KEY时, 当查询的表仅有一行时, 使用system. 例:SELECT * FROM tbl WHERE col = 1. * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. ## 不建议使用联表删除或更新 * **Item:** JOI.007 * **Severity:** L4 * **Content:** 当需要同时删除或更新多张表时建议使用简单语句,一条 SQL 只删除或更新一张表,尽量不要将多张表的操作在同一条语句。 # Query: FCD1ABF36F8CDAD7 ★ ★ ★ ★ ★ 100分 ```sql UPDATE city, country SET city. city = 'Abha', city. last_update = '2006-02-15 04:45:25', country. country = 'Afghanistan' WHERE city. country_id = country. country_id AND city. city_id= 10 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | UPDATE | *city* | NULL | const | PRIMARY,
idx\_fk\_country\_id | PRIMARY | 2 | const | 1 | ☠️ **100.00%** | O(1) | NULL | | 1 | UPDATE | *country* | NULL | const | PRIMARY | PRIMARY | 2 | const | 1 | ☠️ **100.00%** | O(1) | NULL | ### Explain信息解读 #### Type信息解读 * **const**: const用于使用常数值比较PRIMARY KEY时, 当查询的表仅有一行时, 使用system. 例:SELECT * FROM tbl WHERE col = 1. # Query: FE409EB794EE91CF ★ ★ ★ ★ ★ 100分 ```sql UPDATE film SET LENGTH = 10 WHERE language_id = 20 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | UPDATE | *film* | NULL | range | idx\_fk\_language\_id | idx\_fk\_language\_id | 1 | const | 1 | ☠️ **100.00%** | O(log n)+ | Using where | ### Explain信息解读 #### Type信息解读 * **range**: 只检索给定范围的行, 使用一个索引来选择行. key列显示使用了哪个索引. key_len包含所使用索引的最长关键元素. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. # Query: 3656B13CC4F888E2 ★ ★ ★ ☆ ☆ 65分 ```sql INSERT INTO city (country_id) SELECT country_id FROM country ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | INSERT | *city* | NULL | ALL | NULL | NULL | NULL | NULL | 0 | n% | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *country* | NULL | index | NULL | PRIMARY | 2 | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | Using index | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **index**: 全表扫描, 只是扫描表的时候按照索引次序进行而不是行. 主要优点就是避免了排序, 但是开销仍然非常大. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: 2F7439623B712317 ★ ★ ★ ★ ★ 100分 ```sql INSERT INTO city (country_id) VALUES (1), (2), (3) ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | INSERT | *city* | NULL | ALL | NULL | NULL | NULL | NULL | 0 | n% | ☠️ **O(n)** | NULL | ### Explain信息解读 #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. # Query: 11EC7AAACC97DC0F ★ ★ ★ ★ ☆ 85分 ```sql INSERT INTO city (country_id) SELECT 10 FROM DUAL ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | INSERT | *city* | NULL | ALL | NULL | NULL | NULL | NULL | 0 | n% | ☠️ **O(n)** | NULL | ### Explain信息解读 #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: E3DDA1A929236E72 ★ ★ ★ ☆ ☆ 65分 ```sql REPLACE INTO city (country_id) SELECT country_id FROM country ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | REPLACE | *city* | NULL | ALL | NULL | NULL | NULL | NULL | 0 | n% | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *country* | NULL | index | NULL | PRIMARY | 2 | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | Using index | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **index**: 全表扫描, 只是扫描表的时候按照索引次序进行而不是行. 主要优点就是避免了排序, 但是开销仍然非常大. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: 466F1AC2F5851149 ★ ★ ★ ★ ★ 100分 ```sql REPLACE INTO city (country_id) VALUES (1), (2), (3) ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | REPLACE | *city* | NULL | ALL | NULL | NULL | NULL | NULL | 0 | n% | ☠️ **O(n)** | NULL | ### Explain信息解读 #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. # Query: A7973BDD268F926E ★ ★ ★ ★ ☆ 85分 ```sql REPLACE INTO city (country_id) SELECT 10 FROM DUAL ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | REPLACE | *city* | NULL | ALL | NULL | NULL | NULL | NULL | 0 | n% | ☠️ **O(n)** | NULL | ### Explain信息解读 #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## INSERT INTO xx SELECT 加锁粒度较大请谨慎 * **Item:** LCK.001 * **Severity:** L3 * **Content:** INSERT INTO xx SELECT 加锁粒度较大请谨慎 # Query: 105C870D5DFB6710 ★ ★ ★ ☆ ☆ 65分 ```sql SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM ( SELECT film_id FROM film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ) film ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | index | NULL | idx\_fk\_language\_id | 1 | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using index | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **index**: 全表扫描, 只是扫描表的时候按照索引次序进行而不是行. 主要优点就是避免了排序, 但是开销仍然非常大. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 执行计划中嵌套连接深度过深 * **Item:** SUB.004 * **Severity:** L3 * **Content:** MySQL对子查询的优化效果不佳,MySQL将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。 # Query: 16C2B14E7DAA9906 ★ ☆ ☆ ☆ ☆ 35分 ```sql SELECT * FROM film WHERE language_id = ( SELECT language_id FROM language LIMIT 1) ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | PRIMARY | *film* | NULL | ALL | idx\_fk\_language\_id | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using where | | 2 | SUBQUERY | *language* | NULL | index | NULL | PRIMARY | 1 | NULL | 6 | ☠️ **100.00%** | ☠️ **O(n)** | Using index | ### Explain信息解读 #### SelectType信息解读 * **PRIMARY**: 最外层的select. * **SUBQUERY**: 子查询中的第一个SELECT查询, 不依赖于外部查询的结果集. #### Type信息解读 * **index**: 全表扫描, 只是扫描表的时候按照索引次序进行而不是行. 主要优点就是避免了排序, 但是开销仍然非常大. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 未使用 ORDER BY 的 LIMIT 查询 * **Item:** RES.002 * **Severity:** L4 * **Content:** 没有 ORDER BY 的 LIMIT 会导致非确定性的结果,这取决于查询执行计划。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 16CB4628D2597D40 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city i LEFT JOIN country o ON i. city_id= o. country_id UNION SELECT * FROM city i RIGHT JOIN country o ON i. city_id= o. country_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | PRIMARY | *i* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | PRIMARY | *o* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.i.city\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | | 2 | UNION | *o* | NULL | ALL | NULL | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 2 | UNION | *i* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.o.country\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | | 2 | UNION | *i* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.o.country\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | ### Explain信息解读 #### SelectType信息解读 * **PRIMARY**: 最外层的select. * **UNION**: UNION中的第二个或后面的SELECT查询, 不依赖于外部查询的结果集. #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: EA50643B01E139A8 ★ ☆ ☆ ☆ ☆ 35分 ```sql SELECT * FROM ( SELECT * FROM actor WHERE last_update= '2006-02-15 04:34:33' AND last_name= 'CHASE' ) t WHERE last_update= '2006-02-15 04:34:33' AND last_name= 'CHASE' GROUP BY first_name ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *actor* | NULL | ref | idx\_actor\_last\_name | idx\_actor\_last\_name | 137 | const | 2 | n% | O(log n) | Using where; Using temporary | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的actor表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列last\_name添加索引,散粒度为: n%; 为列last\_update添加索引,散粒度为: n%; 为列first\_name添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`actor\` add index \`idx\_last\_name\_last\_update\_first\_name\` (\`last\_name\`,\`last\_update\`,\`first\_name\`) ; ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 非确定性的 GROUP BY * **Item:** RES.001 * **Severity:** L4 * **Content:** SQL返回的列既不在聚合函数中也不是 GROUP BY 表达式的列中,因此这些值的结果将是非确定性的。如:select a, b, c from tbl where foo="bar" group by a,该 SQL 返回的结果就是不确定的。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: 7598A4EDE6CFA6BE ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM city i LEFT JOIN country o ON i. city_id= o. country_id WHERE o. country_id is null UNION SELECT * FROM city i RIGHT JOIN country o ON i. city_id= o. country_id WHERE i. city_id is null ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | PRIMARY | *i* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | PRIMARY | *o* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.i.city\_id | 1 | ☠️ **100.00%** | O(log n) | Using where; Not exists | | 2 | UNION | *o* | NULL | ALL | NULL | NULL | NULL | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 2 | UNION | *i* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.o.country\_id | 1 | ☠️ **100.00%** | O(log n) | Using where; Not exists | | 2 | UNION | *i* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.o.country\_id | 1 | ☠️ **100.00%** | O(log n) | Using where; Not exists | ### Explain信息解读 #### SelectType信息解读 * **PRIMARY**: 最外层的select. * **UNION**: UNION中的第二个或后面的SELECT查询, 不依赖于外部查询的结果集. #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Not exists**: MySQL能够对LEFT JOIN查询进行优化, 并且在查找到符合LEFT JOIN条件的行后, 则不再查找更多的行. * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 如果您不在乎重复的话,建议使用 UNION ALL 替代 UNION * **Item:** SUB.002 * **Severity:** L2 * **Content:** 与去除重复的UNION不同,UNION ALL允许重复元组。如果您不关心重复元组,那么使用UNION ALL将是一个更快的选项。 # Query: 1E8B70E30062FD13 ★ ★ ★ ★ ★ 100分 ```sql SELECT first_name, last_name, email FROM customer STRAIGHT_JOIN address ON customer. address_id= address. address_id ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *customer* | NULL | ALL | idx\_fk\_address\_id | NULL | NULL | NULL | 599 | ☠️ **100.00%** | ☠️ **O(n)** | NULL | | 1 | SIMPLE | *address* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.customer.address\_id | 1 | ☠️ **100.00%** | O(log n) | Using index | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. # Query: E48A20D0413512DA ★ ★ ☆ ☆ ☆ 50分 ```sql SELECT ID, name FROM ( SELECT address FROM customer_list WHERE SID= 1 ORDER BY phone LIMIT 50, 10) a JOIN customer_list l ON (a. address= l. address) JOIN city c ON (c. city= l. city) ORDER BY phone desc ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | PRIMARY | *country* | NULL | index | PRIMARY | PRIMARY | 2 | NULL | 109 | ☠️ **100.00%** | ☠️ **O(n)** | Using index; Using temporary; Using filesort | | 1 | PRIMARY | *city* | NULL | ref | PRIMARY,
idx\_fk\_country\_id | idx\_fk\_country\_id | 2 | sakila.country.country\_id | 5 | ☠️ **100.00%** | O(log n) | NULL | | 1 | PRIMARY | *c* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | n% | ☠️ **O(n)** | Using where; Using join buffer (hash join) | | 1 | PRIMARY | *a* | NULL | ref | PRIMARY,
idx\_fk\_city\_id | idx\_fk\_city\_id | 2 | sakila.city.city\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | | 1 | PRIMARY | *cu* | NULL | ref | idx\_fk\_address\_id | idx\_fk\_address\_id | 2 | sakila.a.address\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | | 1 | PRIMARY | ** | NULL | ref | | | 152 | sakila.a.address | 6 | ☠️ **100.00%** | O(log n) | Using index | | 2 | DERIVED | *a* | NULL | ALL | PRIMARY,
idx\_fk\_city\_id | NULL | NULL | NULL | 603 | ☠️ **100.00%** | ☠️ **O(n)** | Using filesort | | 2 | DERIVED | *cu* | NULL | ref | idx\_fk\_store\_id,
idx\_fk\_address\_id | idx\_fk\_address\_id | 2 | sakila.a.address\_id | 1 | n% | O(log n) | Using where | | 2 | DERIVED | *city* | NULL | eq\_ref | PRIMARY,
idx\_fk\_country\_id | PRIMARY | 2 | sakila.a.city\_id | 1 | ☠️ **100.00%** | O(log n) | NULL | | 2 | DERIVED | *country* | NULL | eq\_ref | PRIMARY | PRIMARY | 2 | sakila.city.country\_id | 1 | ☠️ **100.00%** | O(log n) | Using index | ### Explain信息解读 #### SelectType信息解读 * **DERIVED**: 用于from子句里有子查询的情况. MySQL会递归执行这些子查询, 把结果放在临时表里. * **PRIMARY**: 最外层的select. #### Type信息解读 * **eq_ref**: 除const类型外最好的可能实现的连接类型. 它用在一个索引的所有部分被连接使用并且索引是UNIQUE或PRIMARY KEY, 对于每个索引键, 表中只有一条记录与之匹配. 例: 'SELECT * FROM RefTbl, tbl WHERE RefTbl.col=tbl.col;'. * **index**: 全表扫描, 只是扫描表的时候按照索引次序进行而不是行. 主要优点就是避免了排序, 但是开销仍然非常大. * **ref**: 连接不能基于关键字选择单个行, 可能查找到多个符合条件的行. 叫做ref是因为索引要跟某个参考值相比较. 这个参考值或者是一个数, 或者是来自一个表里的多表查询的结果值. 例:'SELECT * FROM tbl WHERE idx_col=expr;'. * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using index**: 只需通过索引就可以从表中获取列的信息, 无需额外去读取真实的行数据. 如果查询使用的列值仅仅是一个简单索引的部分值, 则会使用这种策略来优化查询. * **Using join buffer**: 从已有连接中找被读入缓存的数据, 并且通过缓存来完成与当前表的连接. * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的city表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列city添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`city\` add index \`idx\_city\` (\`city\`) ; ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 同一张表被连接两次 * **Item:** JOI.002 * **Severity:** L4 * **Content:** 相同的表在 FROM 子句中至少出现两次,可以简化为对该表的单次访问。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 # Query: B0BA5A7079EA16B3 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE DATE( last_update) = '2006-02-15' ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ## 避免在 WHERE 条件中使用函数或其他运算符 * **Item:** FUN.001 * **Severity:** L2 * **Content:** 虽然在 SQL 中使用函数可以简化很多复杂的查询,但使用了函数的查询无法利用表中已经建立的索引,该查询将会是全表扫描,性能较差。通常建议将列名写在比较运算符左侧,将查询过滤条件放在比较运算符右侧。也不建议在查询比较条件两侧书写多余的括号,这会对阅读产生比较大的困扰。 # Query: 18A2AD1395A58EAE ★ ★ ★ ☆ ☆ 60分 ```sql SELECT last_update FROM film GROUP BY DATE( last_update) ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using temporary | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 ## GROUP BY 的条件为表达式 * **Item:** CLA.010 * **Severity:** L2 * **Content:** 当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 # Query: 60F234BA33AAC132 ★ ★ ★ ☆ ☆ 70分 ```sql SELECT last_update FROM film ORDER BY DATE( last_update) ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | ☠️ **100.00%** | ☠️ **O(n)** | Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## ORDER BY 的条件为表达式 * **Item:** CLA.009 * **Severity:** L2 * **Content:** 当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 # Query: 1ED2B7ECBA4215E1 ★ ★ ★ ★ ☆ 80分 ```sql SELECT description FROM film WHERE description IN( 'NEWS', 'asd' ) GROUP BY description ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where; Using temporary | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using temporary**: 表示MySQL在对查询结果排序时使用临时表. 常见于排序order by和分组查询group by. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列description添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_description\` (\`description\`(191)) ; ## 请为 GROUP BY 显示添加 ORDER BY 条件 * **Item:** CLA.008 * **Severity:** L2 * **Content:** 默认 MySQL 会对 'GROUP BY col1, col2, ...' 请求按如下顺序排序 'ORDER BY col1, col2, ...'。如果 GROUP BY 语句不指定 ORDER BY 条件会导致无谓的排序产生,如果不需要排序建议添加 'ORDER BY NULL'。 # Query: 255BAC03F56CDBC7 ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE address ADD index idx_city_id( city_id) ``` ## OK # Query: C315BC4EE0F4E523 ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE inventory ADD index `idx_store_film` ( `store_id`, `film_id`) ``` ## 提醒:请将索引属性顺序与查询对齐 * **Item:** KEY.004 * **Severity:** L0 * **Content:** 如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。 # Query: 9BB74D074BA0727C ★ ★ ★ ★ ☆ 90分 ```sql ALTER TABLE inventory ADD index `idx_store_film` ( `store_id`, `film_id`), ADD index `idx_store_film` ( `store_id`, `film_id`), ADD index `idx_store_film` ( `store_id`, `film_id`) ``` ## 索引名称已存在 * **Item:** IDX.001 * **Severity:** L2 * **Content:** Duplicate key name 'idx\_store\_film' * **Case:** alter table inventory add index \`idx\_store\_film\` (\`store\_id\`,\`film\_id\`),add index \`idx\_store\_film\` (\`store\_id\`,\`film\_id\`),add index \`idx\_store\_film\` (\`store\_id\`,\`film\_id\`) ## 提醒:请将索引属性顺序与查询对齐 * **Item:** KEY.004 * **Severity:** L0 * **Content:** 如果为列创建复合索引,请确保查询属性与索引属性的顺序相同,以便DBMS在处理查询时使用索引。如果查询和索引属性订单没有对齐,那么DBMS可能无法在查询处理期间使用索引。 # Query: C95B5C028C8FFF95 ★ ☆ ☆ ☆ ☆ 30分 ```sql SELECT DATE_FORMAT( t. last_update, '%Y-%m-%d' ), COUNT( DISTINCT ( t. city)) FROM city t WHERE t. last_update > '2018-10-22 00:00:00' AND t. city LIKE '%Chrome%' AND t. city = 'eip' GROUP BY DATE_FORMAT( t. last_update, '%Y-%m-%d' ) ORDER BY DATE_FORMAT( t. last_update, '%Y-%m-%d' ) ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *t* | NULL | ALL | NULL | NULL | NULL | NULL | 600 | n% | ☠️ **O(n)** | Using where; Using filesort | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. * ☠️ **Using filesort**: MySQL会对结果使用一个外部索引排序,而不是从表里按照索引次序读到相关内容. 可能在内存或者磁盘上进行排序. MySQL中无法利用索引完成的排序操作称为'文件排序'. ## 为sakila库的city表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列city添加索引,散粒度为: n%; 为列last\_update添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`city\` add index \`idx\_city\_last\_update\` (\`city\`,\`last\_update\`) ; ## 建议使用 AS 关键字显示声明一个别名 * **Item:** ALI.001 * **Severity:** L0 * **Content:** 在列或表别名(如"tbl AS alias")中, 明确使用 AS 关键字比隐含别名(如"tbl alias")更易懂。 ## 不建议使用前项通配符查找 * **Item:** ARG.001 * **Severity:** L4 * **Content:** 例如 "%foo",查询参数有一个前项通配符的情况无法使用已有索引。 ## ORDER BY 的条件为表达式 * **Item:** CLA.009 * **Severity:** L2 * **Content:** 当 ORDER BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 ## GROUP BY 的条件为表达式 * **Item:** CLA.010 * **Severity:** L2 * **Content:** 当 GROUP BY 条件为表达式或函数时会使用到临时表,如果在未指定 WHERE 或 WHERE 条件返回的结果集较大时性能会很差。 ## ORDER BY 多个列但排序方向不同时可能无法使用索引 * **Item:** KEY.008 * **Severity:** L4 * **Content:** 在 MySQL 8.0 之前当 ORDER BY 多个列指定的排序方向不同时将无法使用已经建立的索引。 # Query: C11ECE7AE5F80CE5 ★ ★ ☆ ☆ ☆ 45分 ```sql create table hello. t (id int unsigned) ``` ## 建议为表添加注释 * **Item:** CLA.011 * **Severity:** L1 * **Content:** 为表添加注释能够使得表的意义更明确,从而为日后的维护带来极大的便利。 ## 请为列添加默认值 * **Item:** COL.004 * **Severity:** L1 * **Content:** 请为列添加默认值,如果是 ALTER 操作,请不要忘记将原字段的默认值写上。字段无默认值,当表较大时无法在线变更表结构。 ## 列未添加注释 * **Item:** COL.005 * **Severity:** L1 * **Content:** 建议对表中每个列添加注释,来明确每个列在表中的含义及作用。 ## 未指定主键或主键非 int 或 bigint * **Item:** KEY.007 * **Severity:** L4 * **Content:** 未指定主键或主键非 int 或 bigint,建议将主键设置为 int unsigned 或 bigint unsigned。 ## 请为表选择合适的存储引擎 * **Item:** TBL.002 * **Severity:** L4 * **Content:** 建表或修改表的存储引擎时建议使用推荐的存储引擎,如:innodb # Query: 291F95B7DCB74C21 ★ ★ ★ ★ ☆ 95分 ```sql SELECT * FROM tb WHERE data >= '' ``` ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 # Query: 084DA3E3EE38DD85 ★ ★ ★ ★ ★ 100分 ```sql ALTER TABLE tb alter column id DROP DEFAULT ``` # Query: B48292EDB9D0E010 ★ ★ ☆ ☆ ☆ 40分 ```sql SELECT maxId, minId FROM ( SELECT MAX( film_id) maxId, MIN( film_id) minId FROM film WHERE last_update > '2016-03-27 02:01:01' ) as d ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | PRIMARY | ** | NULL | system | NULL | NULL | NULL | NULL | 1 | ☠️ **100.00%** | O(1) | NULL | | 2 | DERIVED | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **DERIVED**: 用于from子句里有子查询的情况. MySQL会递归执行这些子查询, 把结果放在临时表里. * **PRIMARY**: 最外层的select. #### Type信息解读 * **system**: 这是const连接类型的一种特例, 该表仅有一行数据(=系统表). * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列last\_update添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_last\_update\` (\`last\_update\`) ; ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 ## 不建议在子查询中使用函数 * **Item:** SUB.006 * **Severity:** L2 * **Content:** MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。 # Query: 4A39009B402BAD9B ★ ★ ☆ ☆ ☆ 50分 ```sql SELECT maxId, minId FROM ( SELECT MAX( film_id) maxId, MIN( film_id) minId FROM film) as d ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | PRIMARY | ** | NULL | system | NULL | NULL | NULL | NULL | 1 | ☠️ **100.00%** | O(1) | NULL | | 2 | DERIVED | *NULL* | NULL | NULL | NULL | NULL | NULL | NULL | 0 | n% | NULL | Select tables optimized away | ### Explain信息解读 #### SelectType信息解读 * **DERIVED**: 用于from子句里有子查询的情况. MySQL会递归执行这些子查询, 把结果放在临时表里. * **PRIMARY**: 最外层的select. #### Type信息解读 * **system**: 这是const连接类型的一种特例, 该表仅有一行数据(=系统表). #### Extra信息解读 * **Select tables optimized away**: 仅通过使用索引,优化器可能仅从聚合函数结果中返回一行。如:在没有 GROUP BY 子句的情况下,基于索引优化 MIN/MAX 操作,或者对于 MyISAM 存储引擎优化 COUNT(*) 操作,不必等到执行阶段再进行计算,查询执行计划生成的阶段即完成优化。 ## 最外层 SELECT 未指定 WHERE 条件 * **Item:** CLA.001 * **Severity:** L4 * **Content:** SELECT 语句没有 WHERE 子句,可能检查比预期更多的行(全表扫描)。对于 SELECT COUNT(\*) 类型的请求如果不要求精度,建议使用 SHOW TABLE STATUS 或 EXPLAIN 替代。 ## MySQL 对子查询的优化效果不佳 * **Item:** SUB.001 * **Severity:** L4 * **Content:** MySQL 将外部查询中的每一行作为依赖子查询执行子查询。 这是导致严重性能问题的常见原因。这可能会在 MySQL 5.6 版本中得到改善, 但对于5.1及更早版本, 建议将该类查询分别重写为 JOIN 或 LEFT OUTER JOIN。 ## 不建议在子查询中使用函数 * **Item:** SUB.006 * **Severity:** L2 * **Content:** MySQL将外部查询中的每一行作为依赖子查询执行子查询,如果在子查询中使用函数,即使是semi-join也很难进行高效的查询。可以将子查询重写为OUTER JOIN语句并用连接条件对数据进行过滤。 ================================================ FILE: test/fixture/test_Run_default_printconfig_cases.golden ================================================ online-dsn: user: "" password: '********' net: tcp addr: 127.0.0.1:3306 schema: information_schema charset: utf8 collation: utf8mb4_general_ci loc: UTC tls: "" server-public-key: "" max-allowed-packet: 4194304 params: charset: utf8 timeout: 3s read-timeout: 0s write-timeout: 0s allow-native-passwords: true allow-old-passwords: false disable: false test-dsn: user: "" password: '********' net: tcp addr: 127.0.0.1:3306 schema: information_schema charset: utf8 collation: utf8mb4_general_ci loc: UTC tls: "" server-public-key: "" max-allowed-packet: 4194304 params: charset: utf8 timeout: 3s read-timeout: 0s write-timeout: 0s allow-native-passwords: true allow-old-passwords: false disable: false allow-online-as-test: false disable-version-check: false drop-test-temporary: true cleanup-test-database: false only-syntax-check: false sampling-statistic-target: 100 sampling: false sampling-condition: "" profiling: false trace: false explain: true delimiter: ; log-level: 3 log-output: /dev/null report-type: markdown report-css: "" report-javascript: "" report-title: SQL优化分析报告 markdown-extensions: 94 markdown-html-flags: 0 ignore-rules: - COL.011 rewrite-rules: - delimiter - orderbynull - groupbyconst - dmlorderby - having - star2columns - insertcolumns - distinctstar blacklist: "" max-join-table-count: 5 max-group-by-cols-count: 5 max-distinct-count: 5 max-index-cols-count: 5 max-text-cols-count: 2 max-total-rows: 9999999 max-query-cost: 9999 spaghetti-query-length: 2048 allow-drop-index: false max-in-count: 10 max-index-bytes-percolumn: 767 max-index-bytes: 3072 allow-charsets: - utf8 - utf8mb4 allow-collates: [] allow-engines: - innodb max-index-count: 10 max-column-count: 40 max-value-count: 100 index-prefix: idx_ unique-key-prefix: uk_ max-subquery-depth: 5 max-varchar-length: 1024 column-not-allow-type: - boolean min-cardinality: 0 explain-sql-report-type: pretty explain-type: extended explain-format: traditional explain-warn-select-type: - "" explain-warn-access-type: - ALL explain-max-keys: 3 explain-min-keys: 0 explain-max-rows: 10000 explain-warn-extra: - Using temporary - Using filesort explain-max-filtered: 100 explain-warn-scalability: - O(n) show-warnings: false show-last-query-cost: false query: "" list-heuristic-rules: false list-rewrite-rules: false list-test-sqls: false list-report-types: false verbose: false dry-run: true max-pretty-sql-length: 1024 ================================================ FILE: test/fixture/test_Simple_Query_Optimizer.golden ================================================ # Query: 5767EE37339B2402 ★ ★ ★ ★ ☆ 85分 ```sql SELECT * FROM film WHERE LENGTH > 120 ``` ## Explain信息 | id | select\_type | table | partitions | type | possible_keys | key | key\_len | ref | rows | filtered | scalability | Extra | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 1 | SIMPLE | *film* | NULL | ALL | NULL | NULL | NULL | NULL | 1000 | n% | ☠️ **O(n)** | Using where | ### Explain信息解读 #### SelectType信息解读 * **SIMPLE**: 简单SELECT(不使用UNION或子查询等). #### Type信息解读 * ☠️ **ALL**: 最坏的情况, 从头到尾全表扫描. #### Extra信息解读 * **Using where**: WHERE条件用于筛选出与下一个表匹配的数据然后返回给客户端. 除非故意做的全表扫描, 否则连接类型是ALL或者是index, 且在Extra列的值中没有Using Where, 则该查询可能是有问题的. ## 为sakila库的film表添加索引 * **Item:** IDX.001 * **Severity:** L2 * **Content:** 为列length添加索引,散粒度为: n%; * **Case:** ALTER TABLE \`sakila\`.\`film\` add index \`idx\_length\` (\`length\`) ; ## 不建议使用 SELECT * 类型查询 * **Item:** COL.001 * **Severity:** L1 * **Content:** 当表结构变更时,使用 \* 通配符选择所有列将导致查询的含义和行为会发生更改,可能导致查询返回更多的数据。 ================================================ FILE: test/main.bats ================================================ #!/usr/bin/env bats load test_helper # 1. 检查版本输出格式是否正确 # 2. 检查版本是否为当天编译的 @test "Test soar version" { run ${SOAR_BIN} -version [ "$status" -eq 0 ] [ "${lines[0]%% *}" == "Version:" ] [ "${lines[1]%% *}" == "Branch:" ] [ "${lines[2]%% *}" == "Compile:" ] [ $(expr "${lines[2]}" : "Compile: $(date +'%Y-%m-%d').*") -ne 0 ] # 检查当前版本是否为今日编译的 } # 3. 无参数执行是否正确 @test "No arguments prints message" { run ${SOAR_BIN} [ $status -eq 1 ] [ "${lines[0]}" == 'Args format error, use --help see how to use it!' ] } # 4. 检查输出的默认值是否改变 soar -print-config 加log-outpt 是因为日志默认是相对路径 @test "Run default printconfig cases" { ${SOAR_BIN} -print-config -log-output=/dev/null > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # 5. soar 使用 config 配置文件路径是否正确 # 13. soar -check-config 数据库连接配置检查 * # soar 数据库测试(线上、线下、-allow-online-as-test) @test "Check config cases" { run ${SOAR_BIN_ENV} -check-config [ $status -eq 0 ] [ -z ${output} ] } # 6. soar 使用配置文件修改默认参数是否正确 # 注意:不启用的配置为默认配置项目 @test "Check the default config of the changes" { ${SOAR_BIN} -config ${BATS_FIXTURE_DIRNAME}/${BATS_TEST_NAME}.golden -print-config -log-output=/dev/null > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # 8. 执行 soar -query 为文件时是否正常 @test "Check soar query for input file" { ${SOAR_BIN} -query <(${SOAR_BIN} -list-test-sqls) > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # 9. 管道输入 SQL 是否正常 @test "Check soar for pipe input" { ${SOAR_BIN} -list-test-sqls |${SOAR_BIN} > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # 10. report 为 json 格式是否正常 @test "Check soar report for json" { ${SOAR_BIN} -query "select * from film" \ -report-type json > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # 10. report 为 markdown 格式是否正常 @test "Check soar report for markdown" { ${SOAR_BIN} -query "select * from film" \ -report-type markdown > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # 11. report 格式 html 检查 @test "Check soar report for html" { ${SOAR_BIN} -query "select * from film" \ -report-title "soar report check" \ -report-type html > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # 12. 黑名单功能是否正常 # soar 的日志和黑名单的相对路径都相对于 soar 的二进制文件路径说的 @test "Check soar blacklist" { run ${SOAR_BIN} -blacklist ../etc/soar.blacklist -query "show processlist;" [ $status -eq 0 ] [ -z ${output} ] } # 13. soar -check-config 数据库连接配置检查 * # 参见 5 # 14. soar -help 检查 @test "Check soar help" { run ${SOAR_BIN} -help [ $status -eq 0 ] [ "${#lines[@]}" -gt 30 ] } # 15. soar 数据库测试(线上、线下、-allow-online-as-test) # 参见 5 # 16. 语法检查(正确) @test "Syntax Check OK" { run ${SOAR_BIN} -query "select * from film" -only-syntax-check [ $status -eq 0 ] [ -z $ouput ] } # 16. 语法检查(错误) @test "Syntax Check Error" { run ${SOAR_BIN} -query "select * frm film" -only-syntax-check [ $status -eq 1 ] [ -n $ouput ] } # 17. dsn 检查 @test "Check soar test dsn root:passwd@host:port/db" { run ${SOAR_BIN} -online-dsn="root:pase@D@192.168.12.11:3306/testDB" -print-config [ $(expr "$output" : ".*user: root") -ne 0 ] [ $(expr "$output" : ".*addr: 192.168.12.11:3306") -ne 0 ] [ $(expr "$output" : ".*schema: testDB") -ne 0 ] [ $(expr "$output" : ".*charset: utf8") -ne 0 ] } # 18. 日志中是否含有密码 @test "Check log has password" { ${SOAR_BIN_ENV} -query "select * from film" -log-level=7 run grep "1tIsB1g3rt" ${SOAR_BIN}.log [ ${status} -eq 1 ] } # 18. 输出中是否含有密码 @test "Check stdout has password" { run ${SOAR_BIN_ENV} -query "select * from film" -log-level=7 [ $(expr "$output" : ".*1tIsB1g3rt.*") -eq 0 ] [ ${status} -eq 0 ] } # 20. 单条 SQL 中 JOIN 表的最大数量超过 2 @test "Check Max Join Table Count Overflow" { ${SOAR_BIN} -max-join-table-count 2 -query="select a from b join c join d" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # 21. 单条 SQL 中 JOIN 表未超过时是否正常默认为 5 @test "Check Max Join Table Count Default" { ${SOAR_BIN} -query="select a from b join c join d" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } ================================================ FILE: test/other.bats ================================================ #!/usr/bin/env bats load test_helper ================================================ FILE: test/query.bats ================================================ #!/usr/bin/env bats load test_helper @test "Check Query Optimizer" { run ${SOAR_BIN} -query "select * from film where length > 120" [ $status -eq 0 ] } # @test "Check get tables from SQL" { ${SOAR_BIN} -list-test-sqls | ${SOAR_BIN} -report-type tables > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden ${SOAR_BIN} -list-test-sqls | ${SOAR_BIN} -report-type tables -test-dsn "/sakila" >> ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # SQL 语法检查 # 1. soar SQL 分隔符是否正常 (-delimiter) @test "Check Soar Delimiter" { ${SOAR_BIN} -delimiter "@" -query "select b from c @ select a from b" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 2. max-column-count (ddl 中才会有提示) @test "Check Soar Max Column Count" { ${SOAR_BIN} -query "create table a (a int,b int,c int,d int)" --max-column-count 3 > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # SQL 指纹检查 # 1. 检测各种类型的 SQL 语句,以及多条 SQL 语句的情况下,指纹是否正确 @test "Check Soar SQL Fingerprint" { ${SOAR_BIN} -list-test-sqls | ${SOAR_BIN} -report-type "fingerprint" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 1. 检测各种类型的 SQL 语句,以及多条SQL语句的情况下,压缩是否正确 # 1. 检测各种类型的 SQL 语句,以及多条SQL语句的情况下,美化是否正确 @test "Check Soar SQL pretty And Compress " { ${SOAR_BIN} -list-test-sqls |${SOAR_BIN} -report-type "pretty"| ${SOAR_BIN} -report-type "compress" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # SQL 改写检查 # 1. 检查 SQL 改写 dml2select @test "Check Soar SQL Rewrite Dml2select " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "dml2select" \ -query "DELETE FROM film WHERE length > 100" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 2. 检查 SQL 改写 Star2columns @test "Check Soar SQL Rewrite Star2columns " { ${SOAR_BIN_ENV} -report-type "rewrite" -rewrite-rules "star2columns" \ -query "select * from film where length > 120" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 4. 检查 SQL 改写 Having @test "Check Soar SQL Rewrite Having " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "having" \ -query "SELECT state, COUNT(*) FROM Drivers GROUP BY state HAVING state IN ('GA', 'TX') ORDER BY state" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 5. 检查 SQL 改写 orderbynull @test "Check Soar SQL Rewrite Orderbynull " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "orderbynull" \ -query "SELECT sum(col1) FROM tbl GROUP BY col" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 6. 检查 SQL 改写 unionall @test "Check Soar SQL Rewrite Unionall " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "unionall" \ -query "select country_id from city union select country_id from country" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 7. 检查 SQL 改写 or2in @test "Check Soar SQL Rewrite Or2in " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "or2in" \ -query "select country_id from city where col1 = 1 or (col2 = 1 or col2 = 2 ) or col1 = 3;" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 7. 检查 SQL 改写 dmlorderby @test "Check Soar SQL Rewrite Dmlorderby " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "dmlorderby" \ -query "DELETE FROM tbl WHERE col1=1 ORDER BY col" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 8. 检查 SQL 改写 distinctstar @test "Check Soar SQL Rewrite Distinctstar " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "distinctstar" \ -query "SELECT DISTINCT * FROM film;" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 9. 检查 SQL 改写 standard @test "Check Soar SQL Rewrite Standard " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "standard" \ -query "SELECT sum(col1) FROM tbl GROUP BY 1;" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 10. 检查 SQL 改写 mergealter # Linux macOS sort 排序不一致 https://unix.stackexchange.com/questions/362728/why-does-gnu-sort-sort-differently-on-my-osx-machine-and-linux-machine @test "Check Soar SQL Rewrite Mergealter " { ${SOAR_BIN} -list-test-sqls |${SOAR_BIN} -report-type rewrite -rewrite-rules mergealter | sort -bdfi > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff echo "${output}" [ $status -eq 0 ] } # 11. 检查 SQL 改写 alwaystrue @test "Check Soar SQL Rewrite Alwaystrue " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "alwaystrue" \ -query "SELECT count(col) FROM tbl where 'a'= 'a' or ('b' = 'b' and a = 'b');" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 12. 检查 SQL 改写 countstar @test "Check Soar SQL Rewrite Countstar " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "countstar" \ -query "SELECT count(col) FROM tbl GROUP BY 1;" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 16. 检查 SQL 改写 truncate @test "Check Soar SQL Rewrite Truncate " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "truncate" \ -query "DELETE FROM tbl" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 17. 检查 SQL 改写 rmparenthesis @test "Check Soar SQL Rewrite Rmparenthesis " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "rmparenthesis" \ -query "select col from a where (col = 1)" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } # 18. 检查 SQL 改写 delimiter @test "Check Soar SQL Rewrite Delimiter " { ${SOAR_BIN} -report-type "rewrite" -rewrite-rules "delimiter" \ -query "use sakila" > ${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden run golden_diff [ $status -eq 0 ] } ================================================ FILE: test/sql/README.md ================================================ # Test Database ## sakila * Download MySQL sakila database from http://downloads.mysql.com/docs/sakila-db.tar.gz . * InnoDB added FULLTEXT support in 5.6.10, you should add version comment `/*!50610 xxx */` for `film_text` table and it's triggers. * Merge schema and data into one file `sakila.sql` ## world\_x world\_x contain JSON datatype, SOAR use this database for JSON testing. * Download MySQL world\_x database from http://downloads.mysql.com/docs/world_x-db.tar.gz . * MySQL support JSON datatype since 5.7.8, you should add version comment `/*!50708 xxx */` for `city`, `countryinfo`. * Merge `sakila.sql`, `world_x.sql` into init.sql. ```bash gzip init.sql ``` ================================================ FILE: test/test_helper.bash ================================================ setup() { export SOAR_DEV_DIRNAME="${BATS_TEST_DIRNAME}/../" export SOAR_BIN="${SOAR_DEV_DIRNAME}/bin/soar" export SOAR_BIN_ENV="${SOAR_DEV_DIRNAME}/bin/soar -config ${SOAR_DEV_DIRNAME}/etc/soar.yaml" export BATS_TMP_DIRNAME="${BATS_TEST_DIRNAME}/tmp" export BATS_FIXTURE_DIRNAME="${BATS_TEST_DIRNAME}/fixture" export LC_ALL=C # Linux macOS 下 sort 排序问题 mkdir -p "${BATS_TMP_DIRNAME}" } # golden_diff like gofmt golden file check method, use this function check output different with template golden_diff() { diff "${BATS_TMP_DIRNAME}/${BATS_TEST_NAME}.golden" "${BATS_FIXTURE_DIRNAME}/${BATS_TEST_NAME}.golden" } ================================================ FILE: tools.json ================================================ { "Tools": [ { "Repository": "gopkg.in/alecthomas/gometalinter.v2", "Commit": "46cc1ea3778b247666c2949669a3333c532fa9c6" }, { "Repository": "github.com/client9/misspell/cmd/misspell", "Commit": "7888c6b6ce89353cd98e196bce3c3f9e4cdf31f6" }, { "Repository": "github.com/chzchzchz/goword", "Commit": "a9744cb52b033fe5c269df48eeef2c954526cd79" }, { "Repository": "github.com/gordonklaus/ineffassign", "Commit": "7bae11eba15a3285c75e388f77eb6357a2d73ee2" }, { "Repository": "github.com/dnephin/govet", "Commit": "4a96d43e39d340b63daa8bc5576985aa599885f6" }, { "Repository": "github.com/securego/gosec/cmd/gosec", "Commit": "5fb530cda357c16175f2c049577d2030de735b28" }, { "Repository": "github.com/kisielk/errcheck", "Commit": "55d8f507faff4d6eddd0c41a3e713e2567fca4e5" }, { "Repository": "github.com/mgechev/revive", "Commit": "7773f47324c2bf1c8f7a5500aff2b6c01d3ed73b" }, { "Repository": "github.com/golangci/golangci-lint/cmd/golangci-lint", "Commit": "a2b901227c37337bce9860499a413db2b464481b" }, { "Repository": "honnef.co/go/tools/cmd/megacheck", "Commit": "88497007e8588ea5b6baee991f74a1607e809487" } ], "RetoolVersion": "1.3.7" }