{"id":41784339,"url":"https://github.com/colorknight/moql-transx","last_synced_at":"2026-01-25T04:08:30.087Z","repository":{"id":41158852,"uuid":"372250677","full_name":"colorknight/moql-transx","owner":"colorknight","description":"Translate moql syntax to syntax of X database","archived":false,"fork":false,"pushed_at":"2025-12-03T05:11:50.000Z","size":206,"stargazers_count":23,"open_issues_count":2,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-12-05T04:18:42.379Z","etag":null,"topics":["elasticsearch","mongodb","mysql","oracle","sql","translation"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/colorknight.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-05-30T15:31:17.000Z","updated_at":"2025-12-03T05:11:54.000Z","dependencies_parsed_at":"2023-02-07T14:31:04.751Z","dependency_job_id":"0d21e790-a4ee-4ab2-af7c-1dcc49d380ee","html_url":"https://github.com/colorknight/moql-transx","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/colorknight/moql-transx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colorknight%2Fmoql-transx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colorknight%2Fmoql-transx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colorknight%2Fmoql-transx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colorknight%2Fmoql-transx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/colorknight","download_url":"https://codeload.github.com/colorknight/moql-transx/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colorknight%2Fmoql-transx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28742983,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T02:46:29.005Z","status":"ssl_error","status_checked_at":"2026-01-25T02:44:29.968Z","response_time":113,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["elasticsearch","mongodb","mysql","oracle","sql","translation"],"created_at":"2026-01-25T04:08:30.017Z","updated_at":"2026-01-25T04:08:30.072Z","avatar_url":"https://github.com/colorknight.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## MOQL-Transx简介\n\n​\tMOQL-Transx是MOQL工程的姊妹工程，其早期与MOQL工程在一起，后独立出来。其核心思想是想让数据库使用者只掌握一种语言，即SQL语言，就可以去查询访问各类不同的数据库，以此减小开发者，使用者的学习成本。由于各类数据库语法差异比较大，MOQL-Transx并不追求从SQL语义到各类数据库DSL语义的完整映射，更多是将最常用到的语法功能进行了映射。目前MOQL-Transx已经完成了从标准的MOQL语法(SQL92语法的子集)到MySQL、Oracle、DB2、SQLServer、Postgresql等关系数据库间的语法转换(注：这些关系数据库间的语法基本相同，有微小的差异)。同时，也完成了MOQL语法到ElasticSearch DSL，MongoDB DSL及DynamoDB DSL的语法转换。由于ElasticSearch，MongoDB都属于文档型数据库，其返回结构非我们常用的关系型数据库的二维表格，故MOQL-Transx还进一步提供了这两个数据库的查询器。这些查询器可以接受一个sql作为参数，并返回一个二维表结构的对象，使开发者使用起来更直观方便。\n\n​\tMOQL-Transx内部包括两个模块，moql-translator用于完成从MOQL语法到各类数据库DSL语法的转换；moql-querier用于为特殊的数据库提供可以接受sql语句返回二维表结构的查询器。\n\n## SQL to ElasticSearch DSL\n\n​\t众所周知ElasticSearch目前是一个应用最为广泛的分布式搜索与分析引擎，它的功能强大，能够已很高的性能访问大规模数据。它拥有强大的查询分析语法，能够完成模糊查询、精准查询及聚集计算等诸多功能的表达。但对于那些用惯了SQL语言的数据分析人员来说，掌握ElasticSearch的DSL语言来做以前熟悉的事情，还是有比较陡的学习曲线的。\n\n​\tMOQL转换器用于完成从MOQL语法(SQL语法的一个子集，涵盖了绝大多数常用语法)到各类不同数据库SQL语法的转换，如它提供到Oracle、SqlServer以及DB2等不同SQL方言的转换，也提供了到ElasticSearch DSL的语法转换。有了这种转换，可以大大降低数据分析人员学习不同分析语言的学习曲线，能够快速的享受新的分析引擎技术带来的便利。\n\n​\tMOQL本质上是一个开发程序包，应用它进行SQL到ElasticSearch DSL的转换非常方便，如下代码示例：\n\n```\nString sql = \"select ip.src, max(ip.sport), min(ip.sport) from ip3 ip group by ip.src order by ip.src desc limit 10 \";\n try {\t\t\t\t\t\t\t\n    String es = MoqlTranslator\n        .translateMoql2Dialect(sql, SqlDialectType.ELASTICSEARCH);\n    es = es.trim();\n    System.out.println(es);\n  } catch (MoqlException e) {\n    e.printStackTrace();\n  }\n}\n```\n\n该代码执行完转换后，输出的ElasticSearch DSL语法为：\n\n```\n{\t\n  \"size\": 10,\n  \"sort\": [\n    {\t\n      \"src\": {\n        \"order\": \"desc\"\n      }\n    }\n  ],\n  \"query\": {\t\n    \"match_all\": {}\n  },\t\n  \"aggs\": {\n    \"src\": {\n      \"terms\": {\n        \"field\": \"src\"\n      },\n      \"aggs\": {\n        \"max$ip_sport$\": {// 程序自动起的别名\n          \"max\": {\n            \"field\": \"sport\"\n          }\n        },\n        \"min$ip_sport$\": {// 程序自动起的别名\n          \"min\": {\n            \"field\": \"sport\"\n          }\n        }\n      }\n    }\n  }\n}\n```\n\n​\t将该结果提交给ElasticSearch引擎可以达到与程序中sql语句匹配的执行效果。就是这样简单，可以立刻去\u003chttps://github.com/colorknight/moql\u003e下载个源码试试了。\n\n​\t当然由于ElasticSearchDSL语法的能力过于强大，MOQL目前还无法提供完整的转换能力，并且为适应两种不同语法间的差异还做了些技巧性的设计，需要使用者在使用时加以注意。\n\n​\tElsaticSearch DSL的query子句中有query上下文与filter上下文两种上下文(本文不解释两种上下文的差异，请参见相关资料)，这两种上下文分别对应了SQL语法的两个子句。query上下文对应了where子句，filter上下文对应了having子句。这样的对应关系主要是技巧性的对应，并不体现各部分在ElasticSerach上的执行顺序。所以在应用ElasticSearch DSL的此类特性时需要留意，不要写错SQL子句。\n\n​\t另外，对于MOQL现在不能支持的ElasticSearch DSL的特殊语法，MOQL建议通过编写函数(UDF,User Define Function)的方式予以扩展。扩展时通过继承org.moql.sql.es.ESFunctionTranslator接口来实现扩展函数，然后再去org.moql.sql.es. ElasticSearchTranslator中注册函数即可。\n\n​\t下面将给出SQL与ElasticSearch DSL的语法转换对照表，方便使用者全面了解SQL转换成ElasticSearch DSL后能达到的语法能力。\n\n| MOQL                                  | ElasticSearch DSL                        |\n| ------------------------------------- | ---------------------------------------- |\n| UNION,INTERSECT,EXCEPT等集合操作子句         | 未转换映射                                    |\n| SELECT子句                              | 当MOQL语句中不含DISTINCT和GROUP子句时，映射为ElasticSearch  DSL的_source子句。若SQL语法的select子句非”.*”模式时，即有具体的投映列时，这些列字段将被放入_source子句的includes属性中，否则则忽略_source子句;而当MOQL含有DISTINCT和GROUP子句时，映射为ElasticSearch的Aggs。此时SELECT子句中的投影列需遵循SQL语法的约定，这样才能正确转换。 |\n| DISTINCT子句                            | 转换为ElasticSearch的Aggs子句。                 |\n| FROM子句                                | 不进行转换                                    |\n| WHERE子句,HAVING子句                      | WHERE子句映射为query子句的query上下文，HAVING子句映射为query子句的filter上下文 |\n| and                                   | 在WHERE子句中时被转换为must;在HAVING子句中时被转换为filter |\n| or                                    | 转换为should                                |\n| not                                   | 转换为must_not                              |\n| \u003c\u003e(不等于)                               | 转换为must_not+term                         |\n| =(等于)                                 | 转换为term                                  |\n| \u003e(大于)、\u003c(小于)、\u003e=(大于等于)、\u003c=(小于等于)、between | 转换为range                                 |\n| like                                  | 转换为regexp                                |\n| in                                    | 转换为terms                                 |\n| is                                    | 转换为must_not+exists                       |\n| 用于改变优先级的括号                            | 转换为层级关系                                  |\n| GROUP BY                              | 转换为ElasticSearch的Aggs子句                  |\n| LIMIT子句                               | 当MOQL语句中不含有DISTINCT和GROUP子句时，该子句被转换为ElasticSearch  DSL的from和size属性；而当含有这两个子句时，该值会被映射到terms aggregation子句的size 属性中。 |\n| ORDER子句                               | 当MOQL语句中不含有DISTINCT和GROUP子句时，该子句被转换为ElasticSearch  DSL的sort子句；而当含有这两个子句时，该值会被映射到terms aggregation子句的order 子句中。 |\n\n​\tMOQL用扩展函数的方式来支持ElasticSearch DSL语法中SQL无法描述的部分，如下：\n\n| ElasticSearch DSL   | MOQL                                                                                                                                                                                                                                                             |\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| match               | match(fields,queryString)  fields：字符串数组，表示多个字段时，字段间用“,”隔开。如：‘field1,field2’。当只有一个field值时，该函数被映射为match子句，当fields字段有多个值时，该函数被映射为malti_match子句  queryString：字符串，表示检索条件，等同与match与multi_match中的query属性                                                                |\n| multi_match         | 见match                                                                                                                                                                                                                                                           |\n| match_phrase        | matchPhrase(field,  queryString)或matchPhrase(field, queryString, analyzer)  field：字符串，match_phrase子句的名字  queryString：字符串，表示match_phrase子句的query属性  analyzer：字符串，与match_phrase的同名属性一致                                                                             |\n| match_phrase_prefix | matchPhrasePrefix(field,  queryString)或matchPhrasePrefix(field, queryString, analyzer)  field：字符串，match_phrase_prefix子句的名字  queryString：字符串，表示match_phrase_prefix子句的query属性  analyzer：字符串，与match_phrase的同名属性一致                                                   |\n| terms_set           | termsSet(field,  valueSet, minMatchField)  field：字符串，terms_set子句的名字  valueSet：字符串数组，表示terms数组，当需要输入多个值时，值与值之间用”,”隔开。  minMatchField：字符串，表示minimum_should_match_field属性                                                                                           |\n| regex               | regex(field,pattern)  field：字符串，字段名  pattern：字符串，表示正则表达式的模式。                                                                                                                                                                                                     |\n| fuzzy               | fuzzy(field,  value)  或fuzzy(field,value,fuzziness,prefix_length,max_expansions)  field：字符串，字段名  value：字符串，字段值  fuzziness：整数，与fuzzy子句同名属性一致  prefix_length：整数，与fuzzy子句同名属性一致  prefix_length：整数，与fuzzy子句同名属性一致                                                    |\n| type                | type(value)  value：字符串，字段值                                                                                                                                                                                                                                       |\n| ids                 | ids(type,  values)  type：字符串，与ids子句同名属性一致。  values：字符串数组，多个值之间用”,”隔开。与ids子句同名属性一致。                                                                                                                                                                               |\n| more_like_this      | moreLike(fields,likeText,minTermFreq,maxQueryTerms)  fields：字符串数组，表示多个字段时，字段间用“,”隔开。表示more_like_this的fields属性  likeText：字符串，表示表示more_like_this的like_text属性  minTermFreq：整数，表示more_like_this的min_term_freq属性  maxQueryTerms：整数，表示more_like_this的max_query_terms属性 |\n| knn                 | knn(field, query_vector,k,num_candidates) field: 要搜索的向量字段的名称。query_vector：查询向量。必须与要搜索的向量场具有相同的维数。k：作为优先命中返回的最近邻居数。值必须小于 num_candidates。num_candidates：每个分片要考虑的最近邻候选数。不能超过 10,000。                                                                                                           |\n\n## SQL to ElasticSearch DSL改进\n\n​\t最近团队在使用MOQL的SQL到ElasticSearch DSL转换时提出，该转换器不能完成深度分页场景的应用。而ElasticSearch为该类应用提供了“search_after”的参数解决方案。ElasticSearch的这个解决方案使得前后两个QUERY DSL有了上下文依赖，后续的查询要依赖上一个查询结果中返回的内容作为条件拼装检索语句。为满足这个需求，MOQL升级了moql-translator和moql-querier两个模块。\n\n \t在moql-translator中整体升级了SqlTranslator接口，允许传入一个Map类型的translationContext参数，该参数可以带入语法转换时所需的参数，这样所有的语法转换器都可以支持有上下文依赖的语法转换了。示例代码如下：\n\n```\n// 带有limit的SQL语句，按照search_after的说明，limit语法中的数字20表示from，将被忽略\n\nString sql = \"select w.* from web w where w.port=443 limit 20,10\";\n\nMap\u003cString, Object\u003e translationContext = new HashMap\u003cString, Object\u003e();\n\nObject[] features = new Object[] { 133, \"test\" };\n\n// RESULT_SORT_FEATURES常量为传递给search_after语法的参数的名字\n\ntranslationContext\n\n    .put(EsTranslationContextConstants.RESULT_SORT_FEATURES, features);\n\ntestESDialect(sql, translationContext);\n```\n\n该代码执行完转换后，输出的ElasticSearch DSL语法为：\n\n```\n{\n  \"search_after\": [\n    133,\n    \"test\"\n  ],\n  \"size\": 10,\n  \"query\": {\n    \"term\": {\n      \"port\": \"443\"\n    }\n  }\n}\n```\n\n\n\n​\t即然语法转换有了上下文的需求，后续的查询依赖于前序查询的结果，就需要能够从结果中取出后续查询所依赖的上下文信息。之前的moql-querier只能读取结果中的部分数据，并以RecordSet的形式返回。而search_after所依赖的结果中的sort字段无法获得。故此次也对DataQuerier接口进行了升级，为接口中加入了一个SupplementReader参数。用户可以通过实现SupplementReader接口读取返回结果集中的其它信息。MOQL提供了一个CommonSupplementReader的缺省实现，可以读取检索结果中的total，max_score及sort等字段信息。\n\n​\t示例代码如下：\n\n```\nString sql = \"select t.DVC_ADDRESS, t.MESSAGE from ins_test t order by t.SEVERITY LIMIT 5\";\n\ntry {\n\n  CommonSupplementReader supplementReader = new CommonSupplementReader();\n\n  RecordSet recordSet = dataQuerier.query(sql, supplementReader);\n\n  outputRecordSet(recordSet);\n\n  System.out.println(supplementReader.getTotalHits());\n\n} catch (IOException e) {\n\n  e.printStackTrace();\n\n}\n```\n\n​\t使用者可以通过访问supplementReader获取结果集中返回的其它结果信息。\n\n## 用SQL访问MongoDB\n\n​\tMOQL-Transx提供了一个轻量级的访问MongoDB数据库的解决方案，并不需要安装额外的数据库引擎。与MOQL-Transx提供的用SQL访问ElasticSearch数据库的解决方案一样。该解决方案首先将SQL语法映射为MongoDB的DSL，然后又提供了查询器执行DSL并将查询结果以二维表结构的形式返回。由于MongoDB不像ElasticSearch，其有一个完整的DSL。其语法由多个语法片段组成，这些语法片段需要作为参数传入不同的api才能完成一次完整意义的查询语义。由于我们无法抽象描述这种片段+API调用的带有交互的逻辑，故在做这种语义翻译时，参考MongoDB中，aggregate计算的片段语法结构，设计了一个能够基本完成SQL语义映射的伪MongoDB DSL。使用者可以不必了解该DSL，直接使用moql-querier中提供的MongoDBQuerier直接访问MongoDB数据库。\n\n​\t下面是一个使用MongoDBTranslator将SQL转换为MongoDB伪DSL的例子，可以帮助使用者大致了解MOQL-Transx如何设计实现了SQL到MongoDB的语法映射。\n\n```\nselect w.dns, w.ip from db.web w where (w.port=443 or w.port=8080) and w.ip='127.0.0.1' or w.ip='127.0.0.2' order by w.ip desc limit 2\n```\n\n​\t\t上面的SQL语句通过MongoDBTranslator转换为如下格式：\n\n```\n[\n  {\n    \"queryType\": \"find\"\n  },\n  {\n    \"queryCollection\": \"db.web\"\n  },\n  {\n    \"$project\": {\n      \"dns\": 1,\n      \"ip\": 1,\n      \"_id\": 0\n    }\n  },\n  {\n    \"$match\": {\n      \"$or\": [\n        {\n          \"$and\": [\n            {\n              \"$or\": [\n                {\n                  \"port\": {\n                    \"$eq\": 443\n                  }\n                },\n                {\n                  \"port\": {\n                    \"$eq\": 8080\n                  }\n                }\n              ]\n            },\n            {\n              \"ip\": {\n                \"$eq\": \"127.0.0.1\"\n              }\n            }\n          ]\n        },\n        {\n          \"ip\": {\n            \"$eq\": \"127.0.0.2\"\n          }\n        }\n      ]\n    }\n  },\n  {\n    \"$sort\": {\n      \"ip\": -1\n    }\n  },\n  {\n    \"$limit\": 2\n  }\n]\n```\n\n​\tqueryType标签表示了检索类型，该值只有find和aggregate两个值，分别对应MongoCollection的find和aggregate方法。queryCollection对应需要检索的集合。\\$match,\\$sort , \\$limit标签则是借鉴MongoDb的aggregate语法结构，将其移植到find方法的调用上了。MongoDBQuerier将解释该DSL，将其拆解成多个语法片段，而后调用MongoCollection提供的不同的功能接口，完成文档的检索，并最终将文档转换为二维表形式返回。\n\n​\t下表将给出SQL子句到MongoDB DSL的映射，使用者可根据表中所列的子句能力编写SQL访问MongoDB。\n\n| MOQL                                                  | MongoDB DSL                                                  |\n| ----------------------------------------------------- | ------------------------------------------------------------ |\n| UNION,INTERSECT,EXCEPT等集合操作子句                  | 未转换映射                                                   |\n| SELECT子句                                            | 投影子句，映射为$project标签                                 |\n| DISTINCT子句                                          | 未支持                                                       |\n| FROM子句                                              | queryCollection标签                                          |\n| LEFT JOIN子句                                         | 映射为$lookup标签                                            |\n| WHERE子句,HAVING子句                                  | 均映射为\\$match标签，其中,当存在HAVING子句时，DSL中会存在两个\\$match标签，二者位置不同，表示HAVING子句的\\$match标签会在GroupBy子句之后 |\n| and                                                   | 映射为\\$and                                                  |\n| or                                                    | 映射为$or                                                    |\n| not                                                   | 支持not and语义，映射为$nor                                  |\n| \u003c\u003e(不等于)                                            | 映射为\\$ne                                                   |\n| =(等于)                                               | 映射为\\$eq                                                   |\n| \u003e(大于)、\u003c(小于)、\u003e=(大于等于)、\u003c=(小于等于)、between | 分别映射为\\$lt,\\$gt,\\$gte,$lte以及 \\$gte与\\$lt的组合         |\n| like                                                  | 映射为\\$regex                                                |\n| in                                                    | 映射为\\$in,其否定语义会被映射为\\$nin                         |\n| is                                                    | 其肯定语义被映射为\\$eq null；否定语义被映射为\\$ne null       |\n| exists                                                | 映射为\\$exists                                               |\n| 用于改变优先级的括号                                  | 映射为层级关系                                               |\n| GROUP BY                                              | 映射为\\$group,支持mongoDB中声明的sum、avg、min、max、push、addToSet、first、last以及count聚合运算 |\n| LIMIT子句                                             | 映射为$limit, limit子句的偏移部分被映射为\\$skip              |\n| ORDER子句                                             | 映射为$sort                                                  |\n\n​\t由于MongoDB实际没有DSL，所以MOQL-Transx提供的这层转换不具有通用性，故MOQL-Transx提供了MongoDBQuerier来提供更加通用的用法。使用方法如下，非常简单：\n\n```\nMongoDBQuerier dataQuerier = new MongoDBQuerier();\nString[] serverIps = new String[] { \"172.30.30.8\" };\nProperties properties = new Properties();\ndataQuerier.connect(serverIps, properties);\nRecordSet recordSet = dataQuerier.query(\"select w.dns, w.ip from mydb.web w where (w.port=443 or w.port=8080) and w.ip='127.0.0.1' or w.ip='127.0.0.2'\");\noutputRecordSet(RecordSet recordSet)\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolorknight%2Fmoql-transx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcolorknight%2Fmoql-transx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolorknight%2Fmoql-transx/lists"}