Updated SQL Parser (markdown)

高铁
2017-10-03 23:24:32 -05:00
parent b4577a565e
commit d36aa032b3
+9 -9
@@ -1,10 +1,10 @@
# 1. 简介
SQL Parser是Druid的一个重要组成部分,Druid内置使用SQL Parser来实现防御SQL注入([WallFilter](https://github.com/alibaba/druid/wiki/%E7%AE%80%E4%BB%8B_WallFilter))、合并统计没有参数化的SQL([StatFilter](https://github.com/alibaba/druid/wiki/%E9%85%8D%E7%BD%AE_StatFilter)的mergeSql)、[SQL格式化](https://github.com/alibaba/druid/wiki/SQL%E6%A0%BC%E5%BC%8F%E5%8C%96)、分库分表。
## 1.1 和Antlr生成Parser的区别
## 1.1. 和Antlr生成Parser的区别
和Antlr生成的SQL有很大不同的是,Druid SQL Parser性能非常好,可以用于生产环境直接对SQL进行分析处理。
## 1.2 Druid SQL Parser的使用场景
## 1.2. Druid SQL Parser的使用场景
* MySql SQL全量统计
* Hive/ODPS SQL执行安全审计
* 分库分表SQL解析引擎
@@ -33,7 +33,7 @@ SELECT ID, NAME, AGE FROM USER WHERE ID = ?
```
这样的SQL,druid parser处理大约是600纳秒,也就是说单线程每秒可以处理1500万次以上。在1.1.3~1.1.4版本中,SQL Parser的性能有极大提升,完全可以适用于生产环境中对SQL进行处理。
## 3.1 测试代码看这里
## 3.1. 测试代码看这里
[MySqlPerfTest.java](https://github.com/alibaba/druid/blob/master/src/test/java/com/alibaba/druid/benckmark/sql/MySqlPerfTest.java)
# 4. Druid SQL Parser的代码结构
@@ -42,10 +42,10 @@ Druid SQL Parser分三个模块:
* AST
* Visitor
## 4.1 parser
## 4.1. parser
parser是将输入文本转换为ast(抽象语法树),parser有包括两个部分,Parser和Lexer,其中Lexer实现词法分析,Parser实现语法分析。
## 4.2 AST
## 4.2. AST
AST是Abstract Syntax Tree的缩写,也就是抽象语法树。AST是parser输出的结果。下面是获得抽象语法树的一个例子:
```java
final String dbType = JdbcConstants.MYSQL; // 可以是ORACLE、POSTGRESQL、SQLSERVER、ODPS等
@@ -55,7 +55,7 @@ List<SQLStatement> stmtList = SQLUtils.parseStatements(sql, dbType);
* Druid SQL AST介绍 https://github.com/alibaba/druid/wiki/Druid_SQL_AST
## 4.3 Visitor
## 4.3. Visitor
Visitor是遍历AST的手段,是处理AST最方便的模式,Visitor是一个接口,有缺省什么都没做的实现VistorAdapter。
我们可以实现不同的Visitor来满足不同的需求,Druid内置提供了如下Visitor:
@@ -66,13 +66,13 @@ Visitor是遍历AST的手段,是处理AST最方便的模式,Visitor是一个
* ExportParameterVisitor用来提取SQL中的变量参数
* [SchemaStatVisitor](https://github.com/alibaba/druid/wiki/SchemaStatVisitor) 用来统计SQL中使用的表、字段、过滤条件、排序表达式、分组表达式
## 4.4 自定义Visitor
## 4.4. 自定义Visitor
每种方言的Visitor都有一个缺省的VisitorAdapter,使得编写自定义的Visitor更方便。
https://github.com/alibaba/druid/wiki/SQL_Parser_Demo_visitor
## 4.5 方言
## 4.5. 方言
SQL-92、SQL-99等都是标准SQL,mysql/oracle/pg/sqlserver/odps等都是方言,也就是dialect。parser/ast/visitor都需要针对不同的方言进行特别处理。
# SchemaRepository
# 5. SchemaRepository
Druid SQL Parser内置了一个SchemaRepository,在内存中缓存SQL Schema信息,用于SQL语义解析中的ColumnResolve等操作。
https://github.com/alibaba/druid/wiki/SQL_Schema_Repository