CN111104421A - 一种基于数据接口标准配置的数据查询方法及装置 - Google Patents

Abstract

本发明适用于数据接口开发技术领域，提供了一种基于数据接口标准配置的数据查询方法及装置，方法包括：创建数据接口，并根据标准配置对应配置数据接口；根据获取的接口调用指令，提取对应的数据接口中配置的第一结构化查询语言；将查询目标的条件参数替换代入第一结构化查询语言中，以获取第二结构化查询语言；发送第二结构化查询语言至数据库执行查询操作；获取数据库返回的查询结果；将查询结果以目标格式封装，并返回至数据接口调用者。本发明在需要调用接口进行数据查询时，无需再重新对接口进行设置参数，直接传入查询的条件参数即可快速执行查询操作，节省了每个数据接口之间重复确定接口参数的过程，简化了接口开发时的工作。

Description

一种基于数据接口标准配置的数据查询方法及装置

技术领域

本发明属于数据接口开发技术领域，尤其涉及一种基于数据接口标准配置的数据查询方法及装置。

背景技术

能源行业数据类型繁多，几乎每个主题的数据都对应上百个数据查询接口，每种接口的开发工作基本相似，都是查询数据库，封装数据，并发布成接口，存在大量的重复工作。如最常见的开发数据接口方式为：首先创建接口名称，连接数据库，执行结构化查询语言(Structured Query Language，以下简称为SQL)查询数据接口；然后，将SQL查询的结果封装成某种格式的数据结果；再将数据结果通过服务的方式发布出去，以确定接口参数；最后，需要调用上一步发布的接口，传入必要的条件参数，进行数据查询，获取期望的数据。这种方式在仅开发几个接口时可能感受不到其中的低效，但是要开发数百上千个接口的时候，会发现上述的中间步骤是一种无效的重复工作，几乎是开发多少个接口，就会重复多少次：将SQL查询的结果封装成某种格式的数据结果；再将数据结果通过服务的方式发布出去，以确定接口参数的步骤，形成成倍的无效工作量。

因此，随着开发的接口的增多，像接口封装、接口发布的重复操作会越来越多，无形中降低了工作效率。

发明内容

有鉴于此，本发明实施例提供了一种基于数据接口标准配置的数据查询方法及装置，可以简化接口开发的工作，解决现有技术中随着开发接口多而产生的效率低的问题。

本发明实施例的第一方面提供了一种基于数据接口标准配置的数据查询方法，包括：

创建数据接口，并根据标准配置对应配置所述数据接口；

根据获取的接口调用指令，提取对应的所述数据接口中配置的第一结构化查询语言；

将查询目标的条件参数替换代入所述第一结构化查询语言中，以获取第二结构化查询语言；

发送所述第二结构化查询语言至数据库执行查询操作；

获取数据库返回的查询结果；

将所述查询结果以目标格式封装，并返回至数据接口调用者。

本发明实施例的第二方面提供了一种基于数据接口标准配置的数据查询装置，包括：

创建与配置模块，用于创建数据接口，并根据标准配置对应配置所述数据接口；

第一结构化查询语言获取模块，用于获取接口调用指令，提取对应的所述数据接口中配置的第一结构化查询语言；

第二结构化查询语言获取模块，用于将查询目标的条件参数替换代入所述第一结构化查询语言中，组成第二结构化查询语言；

查询模块，用于发送所述第二结构化查询语言至数据库执行查询操作；

结果获取模块，用于获取数据库返回的查询结果；

封装与发送模块，用于将所述查询结果以目标格式封装，并返回至数据接口调用者。

本发明实施例的第三方面提供了一种终端设备，包括存储器、处理器以及存储在所述存储器中并可在所述处理器上运行的计算机程序，所述处理器执行所述计算机程序时实现上述方法的步骤。

本发明实施例的第四方面提供了一种计算机可读存储介质，所述计算机可读存储介质存储有计算机程序，所述计算机程序被处理器执行时实现上述方法的步骤。

本发明实施例与现有技术相比存在的有益效果至少在于：

本发明实施例先配置数据接口以作备用，针对不同数据主题或数据库分别配置相应的数据接口，当需要调用接口进行数据查询时，无需再重新对接口进行设置参数，直接传入查询的条件参数即可快速执行查询操作，节省了每个数据接口之间重复确定接口参数的过程，简化了接口开发时的工作。

附图说明

为了更清楚地说明本发明实施例中的技术方案，下面将对实施例或现有技术描述中所需要使用的附图作简单地介绍，显而易见地，下面描述中的附图仅仅是本发明的一些实施例，对于本领域普通技术人员来讲，在不付出创造性劳动的前提下，还可以根据这些附图获得其它的附图。

图1是本发明实施例一提供的一种基于数据接口标准配置的数据查询方法的实现流程示意图；

图2是本发明实施例一提供的创建数据接口，并根据标准配置对应配置所述数据接口步骤的实现流程示意图；

图3是本发明实施例二提供的一种基于数据接口标准配置的数据查询方法的实现流程示意图；

图4是本发明实施例二提供的数据接口配置界面的示意图；

图5是本发明实施例二提供的数据查询工作流程示意图；

图6是本发明实施例提供的一种基于数据接口标准配置的数据查询装置的示意图；

图7是本发明实施例提供的创建与配置模块的示意图；

图8是本发明实施例提供的终端设备的示意图。

具体实施方式

以下描述中，为了说明而不是为了限定，提出了诸如特定系统结构、技术之类的具体细节，以便透彻理解本发明实施例。然而，本领域的技术人员应当清楚，在没有这些具体细节的其它实施例中也可以实现本发明。在其它情况中，省略对众所周知的系统、装置、电路以及方法的详细说明，以免不必要的细节妨碍本发明的描述。基于所描述的本发明的实施例，本领域普通技术人员所获得的所有其他实施例，都属于本发明保护的范围。若未特别指明，实施例中所用的技术手段为本领域技术人员所熟知的常规手段。

应当理解，当在本说明书和所附权利要求书中使用时，术语“包括”指示所描述特征、整体、步骤、操作、元素和/或组件的存在，但并不排除一个或多个其它特征、整体、步骤、操作、元素、组件和/或其集合的存在或添加。

还应当理解，在此本申请说明书中所使用的术语仅仅是出于描述特定实施例的目的而并不意在限制本申请。如在本申请说明书和所附权利要求书中所使用的那样，除非上下文清楚地指明其它情况，否则单数形式的“一”、“一个”及“该”意在包括复数形式。

还应当进一步理解，在本申请说明书和所附权利要求书中使用的术语“和/或”是指相关联列出的项中的一个或多个的任何组合以及所有可能组合，并且包括这些组合。

如在本说明书和所附权利要求书中所使用的那样，术语“如果”可以依据上下文被解释为“当...时”或“一旦”或“响应于确定”或“响应于检测到”。类似地，短语“如果确定”或“如果检测到[所描述条件或事件]”可以依据上下文被解释为意指“一旦确定”或“响应于确定”或“一旦检测到[所描述条件或事件]”或“响应于检测到[所描述条件或事件]”。

为了说明本发明所述的技术方案，下面通过具体实施例来进行说明。

实施例一：

参见图1，是本发明一实施例提供的一种基于数据接口标准配置的数据查询方法，包括：

步骤S10：创建数据接口，并根据标准配置对应配置所述数据接口；

步骤S20：根据获取的接口调用指令，提取对应的所述数据接口中配置的第一结构化查询语言；

步骤S30：将查询目标的条件参数替换代入所述第一结构化查询语言中，以获取第二结构化查询语言；

步骤S40：发送所述第二结构化查询语言至数据库执行查询操作；

步骤S50：获取数据库返回的查询结果；

步骤S60：将所述查询结果以目标格式封装，并返回至数据接口调用者。

区别于现有发开数据接口的方式中：先查询并封装查询结果，后确定接口参数再传输查询结果的流程，本实施例采用的方式为：先配置数据接口以作备用，针对不同数据主题或数据库分别配置相应的数据接口，当需要调用接口进行数据查询时，无需再重新对接口进行设置参数，直接传入查询的条件参数即可快速执行查询操作，节省了每个数据接口之间重复确定接口参数的过程，简化了接口开发时的工作。

同时，数据库与查询者的工作没有变化，数据库解析查询内容并返回查询结果，查询者发起查询指令等待接收查询结果，十分便捷。

作为优选，本实施例中所述标准配置包括接口信息、结构化查询语言、调试结果、请求参数、输出结果以及所述请求参数与输出结果对应的数据交换格式。

接口信息为对该接口进行描述说明的信息，通常为用户自定义的内容以及接口所对应的数据库信息，本实施例中，所述接口信息包括以下至少一项：数据名称、数据描述、时间粒度、数据编码以及数据库。

结构化查询语言为SQL语句，采用标准的查询语句格式，当查询时对应修改其中的语句内容为查询的条件参数，就能实现查询操作。

调试结果是对SQL语句进行校验的验证信息，在接口配置过程中，主要是对SQL语句的格式是否正确、是否为非法操作进行验证，而在具体执行SQL查询时，则还需对查询内容是否存在等进行验证。

请求参数与输出结果均为SQL格式的参数，其中，请求参数为查询时的输入参数，在配置接口时可能为空，而具体查询时则为主要替换为条件参数的内容，输出结果则为查询结果的输出形式。

数据交换格式则为方便查询者理解的形式，可以为JSON(JavaScript ObjectNotation，也可说JSON对象)示例，也可以是其他语言示例。

参见图2，本实施例中步骤S10：创建数据接口，并根据标准配置对应配置所述数据接口，包括：

步骤S101：创建数据接口；

步骤S102：根据对应的数据接口设置接口信息；

步骤S103：根据标准查询语句配置所述结构化查询语言；

步骤S104：校验所述结构化查询语言的正确性，并对应输出结果至所述调试结果；

若所述调试结果为正确，则进入步骤S105：完成所述数据接口的配置。

下面以报表平台作为主题示例进行具体实施说明，实施例二：

参见图3，是本发明一实施例提供的一种基于数据接口标准配置的数据查询方法，包括：

步骤S101：创建数据接口：报表平台；

本实施例优选的标准配置包括：数据名称、数据描述、时间粒度、数据编码DataCode、数据库、SQL语句、系统编码(SystemID)可用的占位符、调试结果、请求参数、输出结果、请求参数的JSON示例、输出结果的JSON示例；

其中，SystemID可用的占位符为SQL语句中用于替换的特殊标识，为备选内容，如图4所示的配置页面中包括有：${entld}、${deviceld}、${stationld}、${systemCode}。

步骤S102：根据对应的数据接口设置接口信息，实施接口信息包括：数据名称、数据描述、时间粒度、数据编码DataCode以及数据库；

本实施例配置实例如图4所示，数据名称为数据预测，数据描述则设为数据预测，时间粒度设为1，间隔为小时hour，数据编码DataCode设置为数据仓库DW、小时hour、预测Forecast，对应的数据库包括数据采集/data-colloctor

步骤S103：根据SQL语句的标准查询语句配置所述结构化查询语言，包括SELECT、FROM和WHERE，SELECT表示查询对应表格中的目标对象，如图4所示的设置包括cimedSystem和iotSystem，FROM表示查询的表格，图4所示的表格为rpt_day operation value，WHERE则表示查询的筛选格式，图4所示的示例为statData＝date sub(‘$[statData]’，interval1day)，表示设置筛选条件为时间，间隔一天；

步骤S104：校验所述结构化查询语言的正确性，并对应输出结果至所述调试结果，图4所示的SQL语句校验结果为正确，显示为{“flag”:true,“msg”:“SQL校验通过。”}；

若所述调试结果为正确，则进入步骤S105：完成所述数据接口的配置；

步骤S106：将所述数据接口配置的结构化查询语言作为第一结构化查询语言存储至接口服务库中。

步骤S20：根据获取的接口调用指令，提取对应的所述数据接口中配置的第一结构化查询语言；

步骤S30：将查询目标的条件参数替换代入所述第一结构化查询语言中，以获取第二结构化查询语言；

由于图4所示的本实施例的请求参数：参数名称、数据类型、格式、描述分别设为statData、date、yyyy-mm-dd、统计日期，则当查询目标的条件参数“2019-07-12”输入SQL语句中，对应替换WHERE中的“statData”，然后执行校验，查看调试结果是否正确，若正确，则执行下一步，否则提醒有误；

步骤S40：发送所述第二结构化查询语言至数据库执行查询操作；

步骤S50：获取数据库返回的查询结果，本实施例的结果如图4所示：输出结果包括2个参数：cimedSystem和iotSystem，数据类型均为int，查询“2019-07-12”的输出结果为：“cimedSystem”:2013，“iotSystem”:882；

步骤S60：将所述查询结果以目标格式封装，并返回至数据接口调用者，本实施例的封装格式即为数据交换格式：JSON对象。

本实施例可以灵活配置查询语句，通过一个可配置化的界面对外提供查询语句配置，在该配置界面可以针对不通主题的数据库进行查询语句的配置；可自动识别出查询语句的入参和出参，且针对不同主题设置的查询语句，能够验证语法是否正确。

本实施例还可以从图5所示的流程进行理解：

创建数据接口与配置的过程为图中从上至下的流程，对应上述基于数据接口标准配置的数据查询方法的步骤S10：创建数据接口，并根据标准配置对应配置所述数据接口：

首先通过配置界面配置要针对主题数据库进行查询操作的SQL，包括3个数据库均配置；然后，将这些不同主题查询操作的SQL语句存储入库，并将该SQL通过接口发布出去；

而查询过程可以对应基于数据接口标准配置的数据查询方法的步骤S20至步骤S40：当调用者对接口进行查询时，传入必要的查询参数，当接口收到参数后，将传入的查询参数在指定的SQL中进行变量替换；将这些可执行的SQL发动到对应主题的数据库进行数据查询。

最后从数据库从上至下发送查询结果到查询者即完成查询操作。

实施例三：

参见图6，是本发明一实施例提供的一种基于数据接口标准配置的数据查询装置，包括：创建与配置模块71、第一结构化查询语言获取模块72、第二结构化查询语言获取模块73、查询模块74、结果获取模块75和封装与发送模块76，其中，

所述创建与配置模块71用于创建数据接口，并根据标准配置对应配置所述数据接口；

所述第一结构化查询语言获取模块72用于获取接口调用指令，提取对应的所述数据接口中配置的第一结构化查询语言；

所述第二结构化查询语言获取模块73用于将查询目标的条件参数替换代入所述第一结构化查询语言中，组成第二结构化查询语言；

所述查询模块74用于发送所述第二结构化查询语言至数据库执行查询操作；

所述结果获取模块75用于获取数据库返回的查询结果；

所述封装与发送模块76用于将所述查询结果以目标格式封装，并返回至数据接口调用者。

当然，本实施例中创建与配置模块71还可以包括：创建单元711、设置单元712、配置单元713、校验单元714、发布单元715和存储单元716，如图7所示，其中，

所述创建单元711用于创建数据接口；

所述设置单元712用于根据对应的数据接口设置接口信息；

所述配置单元713用于根据标准查询语句配置所述结构化查询语言；

所述校验单元714用于校验所述结构化查询语言的正确性，并对应输出结果至所述调试结果；

所述发布单元715用于完成所述数据接口的配置发布所述数据接口；

所述存储单元716用于将所述数据接口配置的结构化查询语言作为第一结构化查询语言存储至接口服务库中。

图8是本发明一实施例提供的终端设备8的示意图。如图8所示，该实施例的终端设备8包括处理器80、存储器81以及存储在所述存储器81中并可在所述处理器80上运行的计算机程序82，例如基于数据接口标准配置的数据查询程序。所述处理器80执行所述计算机程序82时实现上述各个基于数据接口标准配置的数据查询方法实施例中的步骤，例如图1所示的步骤S10至S60，或图3所示的步骤S101至S60。或者，所述处理器80执行所述计算机程序82时实现上述各装置实施例中各模块/单元的功能，例如图4所示模块71至76的功能。

示例性的，所述计算机程序82可以被分割成一个或多个模块/单元，所述一个或者多个模块/单元被存储在所述存储器81中，并由所述处理器80执行，以完成本发明。所述一个或多个模块/单元可以是能够完成特定功能的一系列计算机程序指令段，该指令段用于描述所述计算机程序82在所述终端设备8中的执行过程。

所述终端设备8可以是桌上型计算机、笔记本、掌上电脑及云端服务器等计算设备。所述终端设备8可包括，但不仅限于，处理器80、存储器81。本领域技术人员可以理解，图8仅仅是终端设备8的示例，并不构成对终端设备8的限定，可以包括比图示更多或更少的部件，或者组合某些部件，或者不同的部件，例如所述终端设备8还可以包括输入输出设备、网络接入设备、总线等。

所称处理器80可以是中央处理单元(Central Processing Unit，CPU)，还可以是其它通用处理器、数字信号处理器(Digital Signal Processor，DSP)、专用集成电路(Application Specific Integrated Circuit，ASIC)、现场可编程门阵列(Field-Programmable Gate Array，FPGA)或者其它可编程逻辑器件、分立门或者晶体管逻辑器件、分立硬件组件等。通用处理器可以是微处理器或者该处理器也可以是任何常规的处理器等。

所述存储器81可以是所述终端设备8的内部存储单元，例如终端设备8的硬盘或内存。所述存储器81也可以是所述终端设备8的外部存储设备，例如所述终端设备8上配备的插接式硬盘，智能存储卡(Smart Media Card,SMC)，安全数字(Secure Digital,SD)卡，闪存卡(Flash Card)等。进一步地，所述存储器81还可以既包括所述终端设备8的内部存储单元也包括外部存储设备。所述存储器81用于存储所述计算机程序以及所述终端设备8所需的其它程序和数据。所述存储器81还可以用于暂时地存储已经输出或者将要输出的数据。

所属领域的技术人员可以清楚地了解到，为了描述的方便和简洁，仅以上述各功能单元、模块的划分进行举例说明，实际应用中，可以根据需要而将上述功能分配由不同的功能单元、模块完成，即将所述装置的内部结构划分成不同的功能单元或模块，以完成以上描述的全部或者部分功能。当然，上述各单元、模块也可以用包含有计算机程序的处理器来替代，以纯软件的形式完成各部分的工作

实施例中的各功能单元、模块可以集成在一个处理单元中，也可以是各个单元单独物理存在，也可以两个或两个以上单元集成在一个单元中，上述集成的单元既可以采用硬件的形式实现，也可以采用软件功能单元的形式实现。另外，各功能单元、模块的具体名称也只是为了便于相互区分，并不用于限制本申请的保护范围。上述系统中单元、模块的具体工作过程，可以参考前述方法实施例中的对应过程，在此不再赘述。

在上述实施例中，对各个实施例的描述都各有侧重，某个实施例中没有详述或记载的部分，可以参见其它实施例的相关描述。

本领域普通技术人员可以意识到，结合本文中所公开的实施例描述的各示例的单元及算法步骤，能够以电子硬件、或者计算机软件和电子硬件的结合来实现。这些功能究竟以硬件还是软件方式来执行，取决于技术方案的特定应用和设计约束条件。专业技术人员可以对每个特定的应用来使用不同方法来实现所描述的功能，但是这种实现不应认为超出本发明的范围。

在本发明所提供的实施例中，应该理解到，所揭露的装置/终端设备和方法，可以通过其它的方式实现。例如，以上所描述的装置/终端设备实施例仅仅是示意性的，例如，所述模块或单元的划分，仅仅为一种逻辑功能划分，实际实现时可以有另外的划分方式，例如多个单元或组件可以结合或者可以集成到另一个系统，或一些特征可以忽略，或不执行。另一点，所显示或讨论的相互之间的耦合或直接耦合或通讯连接可以是通过一些接口，装置或单元的间接耦合或通讯连接，可以是电性，机械或其它的形式。

所述作为分离部件说明的单元可以是或者也可以不是物理上分开的，作为单元显示的部件可以是或者也可以不是物理单元，即可以位于一个地方，或者也可以分布到多个网络单元上。可以根据实际的需要选择其中的部分或者全部单元来实现本实施例方案的目的。

另外，在本发明各个实施例中的各功能单元可以集成在一个处理单元中，也可以是各个单元单独物理存在，也可以两个或两个以上单元集成在一个单元中。上述集成的单元既可以采用硬件的形式实现，也可以采用软件功能单元的形式实现。

所述集成的模块/单元如果以软件功能单元的形式实现并作为独立的产品销售或使用时，可以存储在一个计算机可读取存储介质中。基于这样的理解，本发明实现上述实施例方法中的全部或部分流程，也可以通过计算机程序来指令相关的硬件来完成，所述的计算机程序可存储于一计算机可读存储介质中，该计算机程序在被处理器执行时，可实现上述各个方法实施例的步骤。其中，所述计算机程序包括计算机程序代码，所述计算机程序代码可以为源代码形式、对象代码形式、可执行文件或某些中间形式等。所述计算机可读介质可以包括：能够携带所述计算机程序代码的任何实体或装置、记录介质、U盘、移动硬盘、磁碟、光盘、计算机存储器、只读存储器(ROM，Read-Only Memory)、随机存取存储器(RAM，Random Access Memory)、电载波信号、电信信号以及软件分发介质等。需要说明的是，所述计算机可读介质包含的内容可以根据司法管辖区内立法和专利实践的要求进行适当的增减，例如在某些司法管辖区，根据立法和专利实践，计算机可读介质不包括电载波信号和电信信号。

以上所述实施例仅用以说明本发明的技术方案，而非对其限制；尽管参照前述实施例对本发明进行了详细的说明，本领域的普通技术人员应当理解：其依然可以对前述各实施例所记载的技术方案进行修改，或者对其中部分技术特征进行等同替换；而这些修改或者替换，并不使相应技术方案的本质脱离本发明各实施例技术方案的精神和范围，均应包含在本发明的保护范围之内。

Claims (10)

1.一种基于数据接口标准配置的数据查询方法，其特征在于，包括：

创建数据接口，并根据标准配置对应配置所述数据接口；

根据获取的接口调用指令，提取对应的所述数据接口中配置的第一结构化查询语言；

将查询目标的条件参数替换代入所述第一结构化查询语言中，以获取第二结构化查询语言；

发送所述第二结构化查询语言至数据库执行查询操作；

获取数据库返回的查询结果；

将所述查询结果以目标格式封装，并返回至数据接口调用者。

2.如权利要求1所述的基于数据接口标准配置的数据查询方法，其特征在于，所述标准配置包括接口信息、结构化查询语言、调试结果、请求参数、输出结果以及所述请求参数与输出结果对应的数据交换格式。

3.如权利要求2所述的基于数据接口标准配置的数据查询方法，其特征在于，所述接口信息包括以下至少一项：数据名称、数据描述、时间粒度、数据编码以及数据库。

4.如权利要求2所述的基于数据接口标准配置的数据查询方法，其特征在于，所述创建数据接口，并根据标准配置对应配置所述数据接口步骤，包括：

创建数据接口；

根据对应的数据接口设置接口信息；

根据标准查询语句配置所述结构化查询语言；

校验所述结构化查询语言的正确性，并对应输出结果至所述调试结果；

若所述调试结果为正确，则完成所述数据接口的配置。

5.如权利要求4所述的基于数据接口标准配置的数据查询方法，其特征在于，所述完成所述数据接口的配置步骤后还包括：

将所述数据接口配置的结构化查询语言作为第一结构化查询语言存储至接口服务库中。

6.如权利要求2所述的基于数据接口标准配置的数据查询方法，其特征在于，所述数据交换格式为JSON对象。

7.如权利要求2所述的基于数据接口标准配置的数据查询方法，其特征在于，所述标准配置还包括系统编码可用的占位符。

8.一种基于数据接口标准配置的数据查询装置，其特征在于，包括：

创建与配置模块，用于创建数据接口，并根据标准配置对应配置所述数据接口；

第一结构化查询语言获取模块，用于获取接口调用指令，提取对应的所述数据接口中配置的第一结构化查询语言；

第二结构化查询语言获取模块，用于将查询目标的条件参数替换代入所述第一结构化查询语言中，组成第二结构化查询语言；

查询模块，用于发送所述第二结构化查询语言至数据库执行查询操作；

结果获取模块，用于获取数据库返回的查询结果；

封装与发送模块，用于将所述查询结果以目标格式封装，并返回至数据接口调用者。

9.一种终端设备，包括存储器、处理器以及存储在所述存储器中并可在所述处理器上运行的计算机程序，其特征在于，所述处理器执行所述计算机程序时实现如权利要求1至7任一项所述方法的步骤。

10.一种计算机可读存储介质，所述计算机可读存储介质存储有计算机程序，其特征在于，所述计算机程序被处理器执行时实现如权利要求1至7任一项所述方法的步骤。

Images