[Consuming CDS View Entities Using ODBC-Based Client Tools](https://blogs.sap.com/2021/08/25/consuming-cds-view-entities-using-odbc-based-client-tools/)

本文介紹透過基於 ODBC(Open Database Connectivity) 的 SQL 語句訪問 ABAP 系統 CDS view 資料的方法。

ODBC 是一套標準的訪問資料庫的 API.

# Why an ODBC Driver for ABAP?

在某些情況下，您希望對 ABAP 系統擁有的 CDS 物件進行外部 SQL 讀取訪問。對 ABAP 系統底層 SAP HANA 資料庫的直接 SQL 讀取訪問不是一個好的選擇。 SAP Note 2511210 中列出了一些問題。ABAP 資料庫中的名稱和內部結構可能不穩定，因為生命週期由 ABAP 系統管理。型別轉換可能不會按預期執行，例如，NUMC 資料型別可能未正確填充，或者貨幣資料可能未正確移動。只有從 ABAP 系統訪問檢視時，資料庫會話變數才能正確設定。如果直接用底層 SQL 語句查詢，這樣繞過了 ABAP 級別的安全概念。

當您透過使用 ODBC 直接訪問 ABAP 系統將 ABAP 系統本身視為資料庫時，所有這些問題都會消失。在這種情況下，身份驗證和授權是使用 ABAP 使用者完成的。應用完整的 ABAP SQL 語義，甚至可以使用應用程式伺服器級別的緩衝以及 ABAP 級別的訪問控制和讀取訪問日誌記錄。

與 ODATA 介面相比，ODBC 介面的優勢在於它允許對所有公開的 ABAP CDS 檢視實體進行無限制的 SQL 訪問。來自不同實體的資料可以臨時方式連線起來，並且可以聚合資料以進行分析查詢。

在其當前版本中，“用於 ABAP 的 ODBC 驅動程式”僅支援在 ABAP 系統中使用具有特權訪問許可權（無 DCL）的技術使用者。只允許對公開的 ABAP CDS 物件進行讀取訪問。

# Overview of Steps and Prerequisites

要透過 ODBC 訪問 ABAP 系統中的 CDS 檢視實體，這些實體首先需要在後端系統中正確被暴露，然後才能透過 ODBC 應用程式中的“用於 ABAP 的 ODBC 驅動程式”訪問它們。

ODBC 應用程式可以是任何能夠載入 ODBC 驅動程式的客戶端工具，也可以是用能夠使用 ODBC 驅動程式的程式語言（例如 C、C++、python、node.js、PHP）編寫的程式。

本文將展示 Windows 上的 Microsoft Excel 用例。

“適用於 ABAP 的 ODBC 驅動程式”本身在 Windows 和 Linux 上可用。

(1) Create and fill some test tables

首先建立兩個測試資料庫表，用於儲存訂單的抬頭和行專案：

```sql
@EndUserText.label : 'ORDER ITEMS'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
@AbapCatalog.tableCategory : #TRANSPARENT
@AbapCatalog.deliveryClass : #A
@AbapCatalog.dataMaintenance : #RESTRICTED
define table zorderitems {
  key orderid : abap.numc(10) not null;
  key pos     : abap.int4 not null;
  item        : abap.char(100) not null;
  amount      : abap.int4 not null;

}
```

```sql
@EndUserText.label : 'Jerry ORDERS'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
@AbapCatalog.tableCategory : #TRANSPARENT
@AbapCatalog.deliveryClass : #A
@AbapCatalog.dataMaintenance : #RESTRICTED
define table zorders {
  key id       : abap.numc(10) not null;
  creationdate : abap.datn;

}
```

建立一個 ABAP class，用於填充資料：

```ABAP
class zcl_fill_orders definition

public
  final
  create public.

public section.
    interfaces if_oo_adt_classrun.
  protected section.
  private section.

endclass.

class zcl_fill_orders implementation.

method if_oo_adt_classrun~main.

data: lt_orders type table of zorders.
    delete from zorders.
    lt_orders = value #(
      ( id = '1' creationdate = '20210801' )
      ( id = '2' creationdate = '20210802'  )
      ( id = '3' creationdate = '20210803' )
    ).
    insert zorders from table @lt_orders.
    out->write( sy-dbcnt ).

data: lt_orderitems type table of zorderitems.
    delete from zorderitems.
    lt_orderitems = value #(
      ( orderid = '1' pos = '1' item = 'Apple' amount = '5' )
      ( orderid = '1' pos = '2' item = 'Banana' amount = '5' )
      ( orderid = '1' pos = '3' item = 'Orange Juice' amount = '2' )

( orderid = '2' pos = '1' item = 'Orange' amount = '10' )
      ( orderid = '2' pos = '2' item = 'Apple' amount = '5' )

( orderid = '3' pos = '1' item = 'Bottle Water' amount = '5' )
    ).
    insert zorderitems from table @lt_orderitems.
    out->write( sy-dbcnt ).

endmethod.

endclass.
```

插入的測試資料如下圖所示：

![](https://img-blog.csdnimg.cn/img_convert/bf1215c2541df1ba6cb6d822aebd4bd2.png)

下面給這些資料庫表建立 CDS view，因為只有 CDS view 才能暴露給 ODBC 消費端。

```sql
@AccessControl.authorizationCheck: #NOT_REQUIRED
@EndUserText.label: 'ORDERS'
define view entity ZORDERSVIEW as select from zorders {
  key id as Id,
  creationdate as CreationDate
}

```

```sql
@AccessControl.authorizationCheck: #NOT_REQUIRED
@EndUserText.label: 'ORDER ITEMS'
define view entity ZORDERITEMSVIEW as select from zorderitems {
  key orderid as OrderId,
  key pos as Pos,
  item as Item,
  amount as Amount
}

```

現在我們需要一個 Service definition 和一個對應的 SQL 型別的 Service binding 來定義新的 CDS 檢視實體, 並透過 SQL 服務公開。

要定義新的服務定義，請右鍵單擊專案資源管理器中的 ZORDERSVIEW 或 ZORDERITEMSVIEW 檢視之一，然後選擇“New Service Definition”併為服務定義命名，例如 Z_SERVICE_DEF_SQL。

![](https://img-blog.csdnimg.cn/img_convert/5e32162cc15832cf4ba9d3f4276df7d3.png)

![](https://img-blog.csdnimg.cn/img_convert/ed0b07ea182610afe6a826c1d68a7e1c.png)

```sql
@EndUserText.label: 'test SQL service'
define service Z_SERVICE_DEF_SQL {
  expose ZORDERSVIEW as Orders;
  expose ZORDERITEMSVIEW as OrderItems;
}
```

這個新的 service 定義可以用在一個 service binding 裡了。選中 service definition，右鍵選單裡建立 service binding：

![](https://img-blog.csdnimg.cn/img_convert/35cc3ec7900c2836d0354b9016c8e775.png)

binding 型別一定要選擇成：SQL1 - Web API

![](https://img-blog.csdnimg.cn/img_convert/69e9a4dcc06a96973b1cce6501d66cfe.png)

這個 Service Binding 的名稱 ZORDERS,稍後將成為外部 ODBC 消費端使用的 schema 名稱。

由於我們要使用ABAP系統中的技術使用者來訪問服務繫結，我們現在需要在SAP BTP ABAP Environment系統中建立一個通訊場景 communication scenario：Z_COMM_SCENARIO_SQL 和一個通訊安排 communication arrangement.

![](https://img-blog.csdnimg.cn/img_convert/64503e93f700d395ee633f8cbdb9bf1e.png)

在生成的 communication scenario 裡，點選 inbound 標籤頁。Inbound Service ID，選擇 S_PRIVILEGED_SQL1:

![](https://img-blog.csdnimg.cn/img_convert/9c883f4e6b0614f80ce8f7316432e8d9.png)

S_PRIVILEGED_SQL1 是預配置的服務，用於對 CDS 檢視實體的特權訪問。DCL 代表 Data Control Language，它提供了一種訪問控制機制，根據條件對從資料庫中 CDS 檢視返回的結果進行過濾。

Authentication method 選擇 Basic：
![](https://img-blog.csdnimg.cn/img_convert/0e0ed5a22221d28d54de2106f42fc8f7.png)

切換到 Authorization 標籤頁，新增新的 Authorization 物件：S_SQL_VIEW
![](https://img-blog.csdnimg.cn/img_convert/740261d3ac0bf45f9cfd92ac1fa00c42.png)

![](https://img-blog.csdnimg.cn/img_convert/60a62ef80bdee4d85cd7a909c6d493b6.png)

給這個 Authorization object 的三個欄位分別維護上對應的值。

![](https://img-blog.csdnimg.cn/img_convert/89dfb29cd56b94e0858bf986703a4cca.png)

SQL_SCHEMA 必須包含我們要授予訪問許可權的服務繫結的名稱。 在這種情況下，大寫符號是可以的。

SQL_VIEW 的值“*”意味著我們允許訪問附加到服務繫結 ZORDERS 的服務定義中的所有檢視。

由於當前只允許只讀訪問，因此 SQL_VIEWOP=SELECT 是必需的。

實際上，我們將模式 ZORDERS 中所有檢視的 SELECT 許可權授予通訊場景的使用者，就像我們在資料庫中發出 GRANT 語句一樣。

點選 publish locally：

![](https://img-blog.csdnimg.cn/img_convert/230b442edbf2c7e16bf988958cb7a6f6.png)

右鍵單擊 ABAP Development Tool 裡的 ABAP 專案，選擇屬性，找到該 ABAP 環境的 Fiori url：
![](https://img-blog.csdnimg.cn/img_convert/4d36a2da1d281754e5dc720f322b7f28.png)

建立一個新的 communication system：
![](https://img-blog.csdnimg.cn/img_convert/5655c69990e8ce46a7ad4c04081405e2.png)

![](https://img-blog.csdnimg.cn/img_convert/a297b495b9408ee0755406de75e50903.png)

勾上 Inbound Only：

![](https://img-blog.csdnimg.cn/img_convert/bd34750b2b6c3f2e95af1eb8b7c8bd4c.png)

建立一個新的 communication user，維護長度為 20 的密碼，比如 S!重複三遍。
![](https://img-blog.csdnimg.cn/img_convert/8deef6f69b8eae5bf930590cdb81319e.png)

最後一步，建立 Communication arrangement，將 ADT 裡建立的 Communication scenario 同剛剛建立的 Communication system 連線起來。

![](https://img-blog.csdnimg.cn/img_convert/6624626682b8d42ad21735cf44e2f223.png)

輸入 Communication system，可以自動把 user 也帶出來：
![](https://img-blog.csdnimg.cn/img_convert/10767ba544a0f59f4b0f606c09dac4c9.png)

把 Service url 抄下來：

https://\<guid>.abap.eu10.hana.ondemand.com/sap/bc/sql/sql1/sap/S_PRIVILEGED

# Install the ODBC driver on Windows

訪問 SAP support portal 的 software download 區域：

https://launchpad.support.sap.com/#/softwarecenter

搜尋關鍵字：ODBC DRIVER FOR ABAP

![](https://img-blog.csdnimg.cn/img_convert/3295de7837280304fc1e9f5256d96657.png)

根據作業系統的不同，下載對應的驅動：
![](https://img-blog.csdnimg.cn/img_convert/64b28717147dbd9dc580843806b89d38.png)

同理，下載 SAPCRYPTOLIB：

![](https://img-blog.csdnimg.cn/img_convert/6ef663421ade094e67c78ec049275ddc.png)

副檔名為 .SAR, 需要用專門的解壓工具 SAPCAR 來解壓：

![](https://img-blog.csdnimg.cn/img_convert/677827c513882084dac40e7abeee2ef1.png)

解壓之後的檔案列表如下圖所示：

![](https://img-blog.csdnimg.cn/img_convert/7f9c6251d993663d7fd11f73ee525823.png)

啟動 ODBC data source 應用，這是 Windows10 自帶的應用：
![](https://img-blog.csdnimg.cn/img_convert/faae10dbb3cd6566359c23eca1e15190.png)

點選 Add 按鈕：
![](https://img-blog.csdnimg.cn/img_convert/dcb098b27861b527d1b83db8157495a5.png)

驅動型別選擇 ODBC driver for ABAP：

![](https://img-blog.csdnimg.cn/img_convert/27d3100c48effde1117bc5df8952857f.png)

新建一條 User Data Source Name：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/c276fc79b5724ab4ad4a4feadbdc61a6.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA5rGq5a2Q54aZ,size_20,color_FFFFFF,t_70,g_se,x_16)

最後就可以在 Excel 等客戶程式裡透過 ODBC 消費 CDS view 資料了：
![](https://img-blog.csdnimg.cn/img_convert/a33f910dd963222d823938d86e7bbe7d.png)

選擇剛剛建立的 User DataSource Name:

![](https://img-blog.csdnimg.cn/img_convert/6ecf694b6249fc61c33bb6079e32ae52.png)

輸入之前建立的 technical user credential：
![](https://img-blog.csdnimg.cn/img_convert/6434e7855e014d77db9db8e192c3c308.png)

點選 Connect 按鈕之後，我們能在 excel 裡看到 service binding ZORDERS 暴露的全部資料：
![](https://img-blog.csdnimg.cn/img_convert/d8c2f5c955e46f0226559f1b322f5c3a.png)

我們也可以在 Excel From ODBC 的 Advanced Options 裡，指定我們想要執行的 SQL 語句：

![](https://img-blog.csdnimg.cn/img_convert/8763593fd5305596cbad84bde04e6c3c.png)

可以直接在 Excel 裡看到執行結果：
![](https://img-blog.csdnimg.cn/img_convert/f3d6bf1dc4b1c54439e552f2ef31b860.png)</guid>

在 Excel 內使用 ODBC 消費 SAP ABAP CDS view

相關文章