【HANA系列】SAP HANA XS的JavaScript API詳解

前言部分

本文介紹SAP HANA XS使用伺服器端JavaScript API。

SAP HANA擴展應用程式服務（SAP HANA XS）提供了一組伺服器端JavaScript應用程式編程介面（API），可配置應用程式與SAP HANA進行交互。

API介紹

SAP HANA XS JavaScript Reference列出了在應用程式和SAP HANA之間編程交互時可用的所有功能。例如，可以使用資料庫API從應用程式內部調用SQL語句，或使用請求處理API訪問SAP HANA數據的當前HTTP請求的詳細信息.AP HANA XS包含以下伺服器端JavaScript API集：Database、Outbound connectivity、Request processing、Session、Job Schedule、Security、Trace、Utilities、XS Data Services、XS Procedures這裡不再詳細介紹每一個API的用處。

介紹幾個API

簡單說幾個如下：

1、Database API

SAP HANA XS資料庫API（$ .hdb）提供了能夠簡單方便地訪問資料庫的工具。

$ .hdb命名空間旨在替代舊的$ .db命名空間。 由於$ .hdb和$ .db API使用不同的資料庫連接，因此避免在單個http請求中使用這兩個API，例如更新相同的表，可能會導致死鎖等等等這樣的問題。

那麼，$.hdb有哪些可用選項呢。

$ .hdb.Connection：與SAP HANA資料庫建立連接。

$ .hdb.ProcedureResult：表示對SAP HANA資料庫的存儲過程調用的結果。

$ .hdb.ResultSet：表示資料庫查詢的結果。

舉例前，說明一點：預設情況下，自動提交模式被禁用，這意味著所有的資料庫更改都必須被明確的提交。

var connection = $.hdb.getConnection();
connection.executeUpdate('UPDATE "DB_EXAMPLE"."ICECREAM" SET QUANTITY=? WHERE FLAVOR=?', 9, 'CHOCOLATE');
connection.commit();

以下SAP HANA XS資料庫API的使用示例顯示瞭如何建立與SAP HANA的連接並從指定的過程調用返回結果集。請看存儲過程參數部分：

這樣可用訪問結果集，最好訪問結果集的JSON格式，還要註意一點$ resultSets不可枚舉。

2、JOB API

在SAP HANA XS中，通過.xsjob文件創建計劃作業，該文件是提交（並激活）SAP HANA存儲庫的設計時文件。 .xsjob文件可用於定義在後臺運行的迴圈任務; 作業計劃API允許開發人員從這些作業中添加和刪除計劃。 作業計劃API提供以下工具：

$ .jobs.Job：表示預定的XS作業。

$ .jobs.JobLog：提供對計劃作業的日誌條目的訪問。

$ .jobs.JobSchedules：可以控制XS作業的計劃。

作為XS作業的一部分，不可能調用$ .request和$ .response對象。XS作業API $ .jobs.Job能夠在其中定義的作業添加計劃（並從中刪除計劃）一個.xsjob文件。

舉個慄子，來說明，伺服器端JavaScript如何使用作業計劃API向現有作業添加計劃並從現有作業中刪除計劃。

如果URI中引用的XS作業文件與被調用的XS JavaScript或SQLScript函數不在同一個包中，則必須將完整的包路徑添加到上述示例第1行中所示的URI中指定的XS作業文件 ，例如</ path / to / package>> MyXSjob.xsjob。

此外，sqlcc / otheruser.xssqlcc中定義的SQL連接用於修改作業; 它不用於執行myJob.xsjob中指定的作業。要瞭解xscron作業調度程式所需的類似cron的語法，我就來簡單講解一下這裡的參數，其實很簡單啦，下麵就和matinal一起解析這些參數。

比如：2013 * * fri 12 0 0

這樣寫就代表：2013年每周五12點執行此JOB。是不是很簡單。

好了，本文就暫時講解這兩種SAP HANA XS的JavaScript API的用法。