嵌入式 DQL 部署

元数据文件在本地时，用户可使用嵌入式方法，将DQL快速集成到自己的项目中，此时无需部署DQL Server。具体步骤如下：

(一) 加载所需jar包

将以下jar包添加到项目lib目录，获取路径为[集算器安装根目录]/esProc/lib：

esproc-bin-***.jar  DQL计算引擎及DQL JDBC驱动包

esproc-ext-***.jar  DQL计算引擎及DQL JDBC驱动包

esproc-ent-***.jar  DQL计算引擎及DQL JDBC驱动包

json-20240303.jar  解析json格式串

lz4-1.3.0.jar  压缩ctx文件

(二) 配置文件

当元数据文件中配置的组表文件路径为相对路径时，则相对于主目录，主目录在raqsoftConfig.xml文件的<mainPath>节点中设置，内容如下：

<?xml version="1.0" encoding="UTF-8"?><Config Version="3">

<Runtime>

<esProc>

<mainPath>D:\ctxFile</mainPath>

<!—配置专业版/企业版系列号 -->

<serialNo>ACTAYQQPWIQOU</serialNo> 

</esProc>

</Runtime>

</Config>

(三) DQL JDBC的连接方法

驱动 — com.esproc.dql.jdbc.DQLDriver

URL — jdbc:esproc:dql://?config=[]&glmd=[]&gdct=[]&gvsb=[]&macro=[]&user=[]&querymode=[]

参数说明：

config：上一步的xml配置文件，文件名称可自定义。参数可省略，缺省为类路径下的raqsoftConfig.xml文件。

glmd：元数据文件。

gdct：字典文件。

gvsb：可视文件。

macro：宏配置文件。

user：角色名，用来读取宏文件macro中user对应的宏，当macro中配置了多个角色时，则需要通过参数user指定角色，如果只配置了一个角色，可省略user。

querymode：查询模式设置，参数值可设为dql或sql，为sql时表示查询语句为sql语法，执行查询时自动翻译成dql语法，sql语句中使用的函数必须为标准函数。参数缺省为dql。该参数适用于java调用等需要手动编辑sql查询语句的场景。

注：参数中配置的文件路径可以是绝对路径或类路径。