【公众号系列】超详细SAP HANA JOB全解析

公众号：SAP Technical

本文作者：matinal

原文出处：http://www.cnblogs.com/SAPmatinal/

写在前面

你一定知道SM36/SM37，ERP里的JOB我们都很熟悉，可以让一些功能性的程序定期地完成一些我们需要的指定性的操作。这样既可以节省时间，又可以避开服务器使用的高峰期，所以很多时候JOB是项目实施的必要手段。

那么，这些事情（定时执行定时任务的功能）是否可以在HANA里来完成呢，由于HANA显著的性能优势，在和外部系统集成的时候，也需要这样的功能来做一些任务。这个功能使用还是很普遍的，我也在博客中写了很多这方面的内容，今天在公众号上我想详细的说一下使用HANA JOB的全过程。

前提条件

1、服务器版本

首先HANA服务器的版本要高于SPS07，因为从Revision 70之后的版本才添加了这个功能。

2、XSEngine服务

确保XSEngine可以使用，测试方法，打开浏览器，输入下面这个URL：

http://<Web_Server_Host>:80<HANA_instance>

或者：

http://<Web_Server_Host>:80<HANA_instance>/sap/hana/xs/admin/

如果出现下面两张图的内容，说明XS服务没有问题

公众号：SAP Technical

SAP HANA登录界面

3、参数修改

我们需要为后面的JOB修改一下参数，在indexserver.ini参数文件里，默认情况下，repository下的sqlscript_mode是default，建议修改为UNSECURE。因为default模式下是read only状态，无法进行insert操作。

还有一点，在xsengine.ini参数文件里，添加scheduler节点，并且添加enabled属性，值设置为true。这两点的参数分别如下图所示：

公众号：SAP Technical

HANA XS参数文件

4、权限参数

要给登录的账号授予sap.hana.xs.admin.roles :: JobAdministrator的权限和sap.hana.xs.admin.roles :: HTTPDestAdministrator的权限。当然，该用户的Schema权限也要赋给用户_SYS_REPO。

公众号：SAP Technical

以上四个步骤完成之后，说明我们的前期准备工作已经做完，相当于环境准备完成。接下来就是创建JOB的具体操作了，下面我来讲一下具体的流程。

创建步骤

1、创建XSProject

选择Project后，找到XSProject，这里的一些步骤我这里就不那么详细写了，因为重点在后面的参数介绍，这些步骤读者朋友可以自己操作一下，很容易做出来。

公众号：SAP Technical

找到XSProject，如下图所示：

公众号：SAP Technical

这里强调一点，当要给project指定一个workspace时，你可以新建一个workspace或者使用缺省的workspace。

2、所需文件

创建完Project后，我们需要在Project里有几个必要的文件，.xsapp文件、. xsaccess文件、.xsjob文件和.xsjs文件。这几个文件是必要的，而且创建Project的时候，会带出来前两个文件，我下面会重点说一下比较重要的文件，其他的可能会直接带过。

其他的就是填写名称，一路NEXT下来就好。最后，我们可以在Project Explorer里看到新建的project。如下图所示

公众号：SAP Technical

.xsaccess文件内容，这个文件里面主要是控制权限缓存之类的参数，我这里写上最简单的参数内容，如下图所示：

公众号：SAP Technical

.xsapp文件内容为空即可，因为这个是整个Project访问的入口，所以没有内容也要有这个文件，这里我就不在多说了。

3、调用文件

JOB能调用的内容，包括表，存储过程，模型等等。比如表，我就可以直接通过js的function来实现调用，然后放入到job文件中，而存储过程就可以直接放入job文件中，写法略有不同，这个后面会详细讲解

调用展示

这里我简单的做一个调用展示的例子，希望大家看到例子后知道整个过程的操作。

1、创建表

首先，我需要一张表，我想通过JOB来完成表里的数据存储，那现在来创建一个简单的存储表，如下图所示：

公众号：SAP Technical

2、创建js文件

我需要一个js文件来完成对表的数据操作，创建的方法，如下图所示：

公众号：SAP Technical

创建js文件后，需要些一点代码，代码的内容就是SQL执行数据连接操作，这段代码很简单，我就不解释太多了，直接看代码，如下图所示：

公众号：SAP Technical

3、创建job文件

我需要一个JOB文件作为载体，用于定时完成任务，创建过程也很简单，和步骤2类似，只是要选择JOB文件即可，.xsjob文件生成之后，可以在XS Job文件里定义任务了。如下图所示：

公众号：SAP Technical

创建JOB文件后，也需要写一点参数的代码，在action里指定刚才新建的XS JavaScript文件里的function。在schedules中指定调度时间，其中的xscron同Linux环境的crontab的语法类似，这里我们指定每5秒钟执行一次。代码如下图所示：

公众号：SAP Technical

JOB配置

以上步骤完成之后，现在来到了最后一步，也就是如何启动任务。此时，打开浏览器，进入到Admin界面，输入账号和密码之后，我可以在HANA XS Administration Tool里看到刚才新建的Job。在这里我也可以新建Job，来完成我想要定时的任何任务。

输入User和Locale，勾选Active，然后，点击Save之后XS Job就开始执行了。当然，我们也可以在此监控任务。如下图所示：

配置界面如下图所示：

公众号：SAP Technical

参数解析

我这里重点说一下Job的参数，我把Job文件拆分开来，每一个都具体说一下。

1、description参数

参数的具体使用，如下图所示：

公众号：SAP Technical

只是单纯的描述描述这个Job的作用，方便查找和日志查询。

2、action参数

参数的具体使用，如下图所示：

公众号：SAP Technical

使用action关键字可以定义要作为XS作业的一部分运行的函数，例如，XS JavaScript或SQLScript。需要以下语法：

“action” : “<package.path>:<XSJS_Service>.xsjs::<functionName>”.

由于js的function比较特殊，所以这里拿出来举例说明。

3、schedules参数

description（可选）

描述Job的具体执行规则

xscron

使用类似cron的语法来定义作业运行的计划，所以xscron关键字允许我们定义在运行作业的计划。（下面有详解）

parameter（可选）

定义作为作业一部分调用的（XSJS或SQLScript）函数用作输入参数

XS作业文件中的xscron语法详解：

公众号：SAP Technical

举个栗子说明一下，比如：* * * * * */5 20表示预定作业应每五分钟运行一次，并且还应在指定分钟内的第20秒运行。作业从指定分钟的正好20秒开始，仅运行一次。

为了更清晰的弄清楚这个问题，我再来详细的列一个表格，帮你解决困惑。

公众号：SAP Technical

那现在我再来举个正常的例子

比如：2019 * * fri 12 0 0 表示2019年每周五中午12:00开始执行。

再比如：* * 3：-2 * 12:14 0 0 表示每月的第三天和第二天之间的每个月的每个小时的12:00至14:00之间的每小时定时执行。

存储过程

使用Job调用存储过程的方式和前面差不多，我这里就简单的说一下关键步骤，创建存储过程的步骤我这里就省略了，创建完存储过程之后，需要在存储过程里写一下简单的测试代码，很简单，就是在上述我创建的表格里，插入一行代码，具体代码如下图所示：

公众号：SAP Technical

调用过程

创建完存储过程之后，将其保存并激活。然后同样新建一个XS Job来执行这个Procedure。创建JOB的过程这里也省略了，在Project右键就可以直接创建（创建的过程可以直接在过滤条件里输入关键字），具体代码如下图所示：

公众号：SAP Technical

在这里有需要注意的地方就是，注意action的语法，和刚才的XS JavaScript是不同的。这里我指定了每10秒钟执行一次。这一部分就先介绍到这里。

删除计划

创建JOB的部分差不多已经全部介绍完，那么，可以创建JOB，当然也可以删除，删除的方法也不止一种，可以在浏览器中进入到admin里，找到要删除的JOB，选择delete schedule直接删除，也可以使用$.jobs JavaScript API在运行时向作业添加或删除JOB。第一种方法就不用说了，进入界面找到，直接删除。现在来说一下第二种方法，使用API进行删除。

公众号：SAP Technical

现在我来创建一个xsjs在运行时为xsjob中定义的XS作业添加新JOB或者是删除JOB，代码如下图所示：

公众号：SAP Technical

保存并激活上述文件，调用XS JavaScript在运行时添加新的JOB或者删除JOB。但相对来说，还是推荐第一种做法，进入admin后可以直接删除，不用考虑API的内容。

公众号：SAP Technical

以上讲了很多关于HANA JOB的操作，这篇文章也基本涵盖了HANA Job的所有内容，并且重点在详细解析了参数，这个地方很多人可能没有搞清楚，希望你看完这篇文章之后，对这些参数有个清晰的了解。

参考文档：

SAP HANA Administration Guide；

SAP HANA Developer Guide；