标签:moql sql elasticsearch translation
MOQL除提供从MOQL语法到Oracle、SQL Server、DB2、MySQL、PostgreSQL等SQL方言的语法转换器外,目前还支持了到ElasticSearch语法的转换。转换器的类名字为org.moql.sql.es.ElasticSearchTranslator。由于MOQL是SQL Like的,所以这个转换器可以完成从SQL语法到ElasticSearch查询语法的转换。由于ElasticSearch查询语法的语义与SQL语法语义各有所长,故MOQL只完成了部分二者语义存在交集的语法的转换工作。但该部分转换对于熟悉SQL,又想初步使用ElasticSearch进行查询的开发者已经足够。下面将对该转换器的用法及语法转换关系进行详细的描述。
ElasticSearch转换器的使用非常简单,示例代码如下:
public static void main(String[] args) { String sql = "select w.country, max(w.port), min(w.port) from web w group by w.country"; try { //将sql语句串转换为ELASTICSEARCH方言的语法串 String es = MoqlUtils.translateMoql2Dialect(sql, SqlDialectType.ELASTICSEARCH); es = es.trim(); //打印输出转换后的语法串 System.out.println(es); } catch (MoqlException e) { e.printStackTrace(); } } |
以上代码的执行结果如下:
{ "size":0, "aggs":{ "condition":{ "filter":{ "match_all":{} }, "aggs":{ "group":{ "terms":{ "field":"country" }, "aggs":{ "column1":{ "max":{ "field":"port" } }, "column2":{ "min":{ "field":"port" } } } } } } } } |
其它关于转换器的更多说明,可参考文章《MOQL—转换器(Translator)》。关于SQL到ElasticSearch DSL转换的更多示例可参见MOQL源码的org.moql.core.test.TestElasticSearchTranslator.java文件。
MOQL转换器不能完整的转换SQL与ElasticSearch的语义,下面将对二者的语义转换关系进行详细的说明。
MOQL |
ElasticSearch |
|
UNION,INTERSECT,EXCEPT等集合操作子句 |
未转换映射 |
|
SELECT子句 |
当MOQL语句中不含DISTINCT和GROUP子句时,映射为ElasticSearch的Filter子句。此时在SELECT子句中指明具体的投影列不起作用,会被统一认为是选择全部列,即SELECT *;而当MOQL含有DISTINCT和GROUP子句时,映射为ElasticSearch的Aggs。此时SELECT子句中的投影列需遵循SQL语法的约定,这样才能正确转换。 |
|
DISTINCT子句 |
转换为ElasticSearch的Aggs子句。 |
|
FROM子句 |
不进行转换 |
|
WHERE子句 |
(注:WHERE子句都被转换为ElasticSearch的Filter子句,但当整个语句中存在GROUP子句时,Filter子句会嵌套在Aggs子句中) |
|
and、or |
映射为and filter和or filter |
|
not、<>(不等于) |
映射为not filter |
|
=(等于) |
映射为term filter |
|
>(大于)、<(小于)、>=(大于等于)、<=(小于等于)、between |
映射为range filter |
|
like |
映射为regexp filter |
|
in |
映射为terms filter |
|
is |
映射为exists filter |
|
用于改变优先级的括号 |
映射为层级关系 |
|
附加部分: regex(field, pattern)函数,用于正则表达式匹配。匹配模式比like更丰富,可参见正则表达式的相关文档。Field参数表示要进行匹配的字段;pattern参数表示匹配串。 |
映射为regexp filter |
|
LIMIT子句 |
映射为ElasticSearch中的size属性。MOQL语句中含有或不含有DISTINCT和GROUP子句,该值会被映射到不同ElasticSearch子句的size属性上。 |
|
ORDER子句 |
当MOQL语句中不含DISTINCT和GROUP子句时,映射为ElasticSearch的sort子句;而当MOQL语句含有以上子句时,映射为Aggs中terms子句的order属性。 |
|
q*() |
ElasticSearch中的Query子句(全文检索)在SQL中没有对应的语法,故该部分语法在MOQL中被设计为了一组前缀为q然后紧跟ElasticSearch对应Query子句名的函数,如:qmatch(…)对应match query子句。目前,MOQL只支持qmatch(field,message)一个函数。field可以是字段名也可以是字符串,当是字段名或字符串中只有一个字段名时转换为match query,如:field1, ’field1’分别是字段名和包含字段名的字符串,均转换为match query;当field为包括多个字段名的字符串,字段名间用’,’号隔开时,转换为multi match query,如:’field1,field2’。 |
MOQL的相关路径如下:
项目地址:http://sourceforge.net/projects/moql/
代码路径:svn://svn.code.sf.net/p/moql/code/trunk
MOQL—ElasticSearch转换器(Translator)
标签:moql sql elasticsearch translation
原文地址:http://blog.csdn.net/colorknight/article/details/43964063