SAP 4.1 Support Package 5 User Guide

Below you will find brief information for Business Intelligence Platform 4.1 Support Package 5. This guide provides an overview of the data access capabilities, including connecting to various data sources, establishing connections, and configuring global settings. It also includes detailed references to available drivers and specific connection requirements for popular data sources.
PDF
Document
資料存取指引
目錄
1
文件版本記錄. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2
資料存取指引簡介. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
2.1
關於本指引. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.2
適用對象. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.3
主要工作. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.4
本指南中的慣例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3
資料存取簡介. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.1
關於連線伺服器. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.2
連線元件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.3
3.2.1
系統架構. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.2.2
資料存取驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
資料存取組態檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3.3.1
關於 cs.cfg 全域組態檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3.3.2
關於驅動程式組態檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
3.3.3
關於 OlapClient.cfg 組態檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
3.4
部署模式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3.5
連線能力服務. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3.6
OLAP 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
4
瞭解資料存取內容. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.1
64 位元作業系統支援. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.1.1
64 位元 UNIX 支援. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.1.2
4.1.3
安裝 ODBC 驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.2
單一登入支援. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.3
預存程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.4
4.5
2
4.3.1
支援的資料庫功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.3.2
Oracle 預存程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.3.3
在封裝內部建立資料指標. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.3.4
建立 Oracle 預存程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4.3.5
SAP HANA 預存程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4.3.6
Teradata 巨集. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
連線集區. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4.4.1
關於集區的連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.4.2
連線集區模式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.4.3
檢查中介軟體連線集區. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
負載平衡. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
目錄
4.6
4.5.1
尋找最佳伺服器. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4.5.2
負載平衡邏輯. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
4.5.3
回溯相容性. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
記憶體配置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
4.6.1
啟用 HOARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
4.6.2
停用 HOARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
4.7
5
建立連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
5.1
連線需求. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
5.2
檢查連線設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
5.3
5.4
5.5
5.2.1
顯示 cscheck 工具的說明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.2.2
執行 cscheck 工具. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.2.3
檢查工具 - 函式概觀. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
5.2.4
檢查工具—list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
5.2.5
5.2.6
檢查工具—find. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.2.7
檢查工具—middleware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.2.8
檢查工具—accessdriver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
5.2.9
檢查工具—connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
5.2.10
檢查工具—ping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
5.2.11
檢查工具 — CMS 資訊. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
建立 JDBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
5.3.1
使用 SBO 檔建立 JDBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
5.3.2
JDBC SBO 範例檔案結構. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
5.3.3
使用 Extensions 建立 JDBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
5.3.4
建立一般 JDBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
5.3.5
JAR 檔案位置參考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
5.3.6
尋找 JDBC 驅動程式的版本. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
建立 JavaBean 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
5.4.1
建立 JavaBean 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
5.4.2
JavaBean SBO 範例檔案結構. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
5.4.3
使用 Extensions 建立 JavaBean 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
建立 ODBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
5.5.1
建立一般 ODBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
5.5.2
建立一般 ODBC3 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
5.6
安裝更新程式後新增驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
5.7
設定多個資料來源工作流程的地區設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
6
資料存取驅動程式參考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.1
資料存取驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
資料存取指引
目錄
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
3
6.2
6.3
6.4
6.5
6.6
CSV OpenDriver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.2.1
CSV OpenDriver 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.2.2
CSV OpenDriver - 表格對應. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
6.2.3
CSV 檔案位置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
6.2.4
CSV 結構描述偵測. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
OData 驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
6.3.1
OData 驅動程式功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
6.3.2
OData 服務位置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
6.3.3
OData 服務範例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
6.3.4
OData 驅動程式 - 對應命名空間、擁有人和限定詞. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
6.3.5
OData 驅動程式 - 對應表格. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
6.3.6
OData 驅動程式 - 對應資料行. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
6.3.7
OData 驅動程式 - 對應索引鍵. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
6.3.8
OData 驅動程式 - 對應文件元素. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
6.3.9
OData 驅動程式 - 衍生類型的對應實體. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
6.3.10
監控 OData 驅動程式效能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
6.3.11
OData 驅動程式 - 非一般行為和限制. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
6.3.12
OData 驅動程式 - 設定資料行大小上限. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
6.3.13
驗證 OData 來源. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
6.3.14
追蹤 OData 驅動程式活動. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
SAP ERP 驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
6.4.1
SAP ERP 驅動程式功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
6.4.2
SAP ERP 驅動程式 - 存取 InfoSet 和 SAP 查詢. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
6.4.3
SAP ERP 驅動程式 - 存取 ABAP 函式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
6.4.4
SAP ERP 驅動程式限制. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
XML 驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
6.5.1
XML 驅動程式功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
6.5.2
XML 檔案位置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
6.5.3
XML 文件和結構描述範例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
6.5.4
XML 驅動程式 - 對應多個檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
6.5.5
XML 驅動程式 - 對應表格. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
6.5.6
XML 驅動程式 - 對應資料行. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
6.5.7
XML 驅動程式 - 對應主要索引鍵和外部索引鍵. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
6.5.8
XML 驅動程式 - 對應混合元素. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
6.5.9
XML 驅動程式 - 對應遞迴元素. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
6.5.10
6.5.11
6.5.12
XML 驅動程式 - 設定資料行大小上限. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Web 服務驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
6.6.1
4
Web 服務驅動程式功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
目錄
6.6.2
Web 服務位置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
6.6.3
Web 服務定義範例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
6.6.4
Web 服務的對應規則. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
6.6.5
Web 服務驅動程式 - 設定資料行大小上限. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
6.7
作為排序作業快取使用的本機磁碟. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
7
連線參考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
7.1
HIVE 和 Impala 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
7.1.1
建立 Apache Hadoop HIVE 的 JDBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
7.1.2
建立 Apache Hadoop HIVE 的 ODBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
7.1.3
於平台更新後使用 HIVE 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
7.1.4
建立與 Amazon EMR HIVE 的 JDBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
7.1.5
建立 Amazon EMR HIVE 的 ODBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
7.1.6
建立 Cloudera Impala 的 JDBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
7.1.7
建立與 Cloudera Impala 的 ODBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
7.2
IBM DB2 連線 - 對應到 Null 的參考索引鍵. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
7.3
7.3.2
7.4
7.5
MS SQL Server 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
7.6
7.5.1
MS SQL Server OLE DB 連線的同義資料表支援. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
7.5.2
在 UNIX 上設定 MS SQL Server 連線的 JVM 選項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Oracle 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
7.6.1
Oracle 伺服器叢集的連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
7.6.2
設定 Oracle CURSOR_SHARING 參數值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
7.6.3
MySQL 連線 - 資訊設計工具中部份工作流程所需的資料庫權限. . . . . . . . . . . . . . . . . . . . . . . . 120
7.6.4
以挪威文 (巴克摩) 介面語言於資訊設計工具中使用 Oracle JDBC 連線. . . . . . . . . . . . . . . . . . . 120
7.7
Oracle EBS 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
7.8
Oracle Essbase 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
7.9
Oracle RAC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
7.10
salesforce.com 連線 - 設定環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
7.11
7.10.1
使 salesforce.com 連線在資訊設計工具中運作. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
7.10.2
使 salesforce.com 連線在語意層設計工具中得以運作. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
啟用 SAP BW 64 位元連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
7.12
SAP ERP 連線 - 無法載入驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
7.13
SAP HANA 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
7.13.1
建立 SAP HANA 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
7.13.2
編輯 SAP HANA 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
7.13.3
在設定 SAP HANA 連線的單一登入之前. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
資料存取指引
目錄
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
5
7.13.4
針對資訊設計工具設定 SAP HANA 的單一登入. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
7.13.5
針對 Web Intelligence 設定 SAP HANA 的單一登入. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
7.13.6
針對 Web Intelligence 豐富型用戶端設定 SAP HANA 的單一登入. . . . . . . . . . . . . . . . . . . . . . 129
7.13.7
設定使用 SAP HANA 連線檢測的 Java 虛擬電腦. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
7.14
SAP MaxDB 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
7.15
SAP BW 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
7.16
7.15.1
Data Federator 與 SAP BW 之間的連線需求. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
7.15.2
在資訊設計工具中使用 SAP BW 連線的需求. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
7.15.3
在 SAP BW 上存取已啟用多來源語意層的需求. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
SAS 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
7.16.1
安裝 SAS 連線的驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
7.17
Teradata 連線 - 將 Teradata 資料庫對應至目前擁有人. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
8
建立連線至 Data Federator XI 3.0 查詢伺服器. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
8.1
關於 Data Federator XI 3.0 查詢伺服器連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
8.2
設定連線精靈以使用 Data Federator JDBC 或 ODBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
8.3
設定 Data Federator ODBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
8.4
8.3.1
設定 Data Federator ODBC 中介軟體. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
8.3.2
設定連線伺服器使用 Data Federator ODBC 連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
使用 Data Federator ODBC 中介軟體設定 Web Intelligence 豐富型用戶端連線. . . . . . . . . . . . . . . . . . . . 137
8.4.1
針對 Web Intelligence 豐富型用戶端的連線設定 Data Federator ODBC 中介軟體. . . . . . . . . . . 137
8.4.2
設定連線伺服器使用 Web Intelligence 豐富型用戶端連線至 Data Federator. . . . . . . . . . . . . . . 138
8.4.3
設定 Windows RichClient 登錄機碼. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
8.4.4
針對 Data Federator 的 Web Intelligence 豐富型用戶端或語意層設計工具連線設定連線伺服器
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
9
設定資料存取全域參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
9.1
關於全域參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
9.2
關於 cs.cfg 組態檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
9.3
檢視和編輯 cs.cfg 檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
9.4
設定全域設定參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
6
9.4.1
Charset List Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
9.4.2
Config File Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
9.4.3
Description Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142
9.4.4
9.4.5
9.4.6
Max Pool Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
9.4.7
Setup File Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
9.4.8
SQL External Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
9.4.9
SQL Parameter Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
9.4.10
Strategies Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
9.4.11
Validate Configuration Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
目錄
9.4.12
Validate XML Streams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
9.4.13
JVM 設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
9.5
設定部署模式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
9.6
設定部署模式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
9.7
設定要載入的驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148
9.7.1
每台電腦設定一個連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
9.8
設定 CORBA 存取通訊協定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
9.9
啟動連線伺服器和驅動程式的記錄和追蹤. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
9.10
9.9.1
關於 _trace.ini 組態檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
9.9.2
啟動 cs.cfg 檔案中的記錄和追蹤. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
9.9.3
啟動程式庫模式的記錄和追蹤. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
9.9.4
啟動伺服器模式的記錄和追蹤. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
9.9.5
讀取記錄和追蹤. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
啟動 OLAP 用戶端的記錄和追蹤. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
9.10.1
記錄範例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
10
設定資料存取驅動程式參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
10.1
設定驅動程式參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
10.2
10.1.1
資料存取組態檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
10.1.2
安裝的 SBO 檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
10.1.3
檢視和編輯 SBO 檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
10.1.4
自訂 SBO 檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
10.1.5
動態檢查連線. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
10.1.6
JDBC 驅動程式屬性. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
啟用系統使用 DataDirect 原廠驅動程式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
11
SBO 參數參考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
11.1
SBO 檔案結構. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
11.2
SBO 參數說明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
11.3
一般 SBO 參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
11.3.1
Array Bind Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
11.3.2
Array Bind Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
11.3.3
11.3.4
Array Fetch Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
11.3.5
11.3.6
Binary Max Length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
11.3.7
Bucket Split Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
11.3.8
Catalog Separator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
11.3.9
11.3.10
Description File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
資料存取指引
目錄
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
7
11.4
11.3.11
11.3.12
11.3.13
Driver Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
11.3.14
Escape Character. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
11.3.15
Extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
11.3.16
Family. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
11.3.17
Force Execute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
11.3.18
Identifier Case. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
11.3.19
Identifier Quote String. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
11.3.20
11.3.21
Integer Max Length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
11.3.22
Introscope Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175
11.3.23
11.3.24
11.3.25
Optimize Execute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
11.3.26
11.3.27
Qualifiers Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
11.3.28
Query TimeOut Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178
11.3.29
Quote Identifiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
11.3.30
Skip SAML SSO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
11.3.31
SQL External File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
11.3.32
SQL Parameter File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
11.3.33
SSO Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
11.3.34
Strategies File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
11.3.35
String Max Length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
11.3.36
Temp Data Dir. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
11.3.37
Transactional Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
11.3.38
Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
11.3.39
Unicode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
11.3.40
11.3.41
XML Max Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
JavaBean SBO 參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
11.4.1
11.5
JCO SBO 參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
11.5.1
11.6
8
JDBC SBO 參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
11.6.1
11.6.2
Escape Character Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
11.6.3
11.6.4
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
目錄
11.7
11.6.5
11.6.6
11.6.7
PVL Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
11.6.8
11.6.9
JDBC ResultSet Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
11.6.10
OData SBO 參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
11.7.1
11.8
11.9
11.10
ODBC SBO 參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
11.8.1
11.8.2
Connection Status Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
11.8.3
Cost Estimate Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
11.8.4
11.8.5
11.8.6
SQLDescribeParam Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
11.8.7
SQLMoreResults Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
11.8.8
11.8.9
OLE DB SBO 參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
11.9.1
Enumerator CLSID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
11.9.2
Provider CLSID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
OLE DB OLAP SBO 參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
11.10.1
11.11
11.12
MSOlap CLSID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Driver Behavior. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
11.11.2
11.11.3
Quoted Identifier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
11.11.4
Recover Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
11.11.5
Text Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Teradata SBO 參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
11.12.1
12
設定資料庫功能參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
12.1
關於資料庫功能參數. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
12.2
關於 PRM 檔. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197
12.2.1
PRM 參數檔案結構. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
12.3
檢視和編輯 PRM 檔. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
12.4
驗證分析函式支援並新增至 PRM 檔案. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
12.5
檢視和編輯函式說明文字檔. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
12.6
編輯 PRM 函式的說明文字. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
資料存取指引
目錄
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
9
13
PRM 參數參考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
13.1
PRM 檔案組態參考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
10
13.1.1
13.1.2
ANALYTIC_FUNCTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
13.1.3
13.1.4
CONSTANT_SAMPLING_SUPPORTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
13.1.5
DISTINCT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202
13.1.6
EXT_JOIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203
13.1.7
FULL_EXT_JOIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
13.1.8
GROUP_BY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203
13.1.9
GROUP_BY_SUPPORTS_COLUMN_INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204
13.1.10
GROUP_BY_SUPPORTS_COMPLEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
13.1.11
GROUP_BY_SUPPORTS_CONSTANT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
13.1.12
HAVING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
13.1.13
INTERSECT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
13.1.14
INTERSECT_ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
13.1.15
INTERSECT_IN_SUBQUERY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
13.1.16
JOIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
13.1.17
13.1.18
LEFT_OUTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206
13.1.19
13.1.20
MINUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
13.1.21
MINUS_ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
13.1.22
MINUS_IN_SUBQUERY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
13.1.23
ORDER_BY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
13.1.24
ORDER_BY_REQUIRES_SELECT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
13.1.25
13.1.26
13.1.27
RANK_SUPPORTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
13.1.28
13.1.29
RIGHT_OUTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
13.1.30
SEED_SAMPLING_SUPPORTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
13.1.31
SELECT_SUPPORTS_NULL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
13.1.32
SUBQUERY_IN_FROM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
13.1.33
SUBQUERY_IN_IN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
13.1.34
SUBQUERY_IN_WHERE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
13.1.35
TECHNICAL_COLUMN_NAME_PATTERN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
13.1.36
UNION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
13.1.37
UNION_ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
13.1.38
UNION_IN_SUBQUERY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
目錄
14
資料類型轉換參考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
14.1
資料類型轉換. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
14.1.1
CSV 檔案資料類型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
14.1.2
JDBC 資料類型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
14.1.3
ODBC 資料類型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
14.1.4
OData 資料類型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
14.1.5
OLE DB 資料類型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
14.1.6
Oracle OCI 資料類型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
14.1.7
SAP ERP 資料類型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
14.1.8
SAP HANA 資料類型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224
14.1.9
14.1.10
XML 資料類型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
14.2
大型變數長度資料限制. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
14.3
啟用多來源語意層的資料類型對應. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
資料存取指引
目錄
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
11
1
文件版本記錄
下表提供最重要的文件變更總覽。
版本
日期
變更內容
SAP BusinessObjects
Business Intelligence 平
台 4.1
2013 年 5
月
如需有關新 OData、XML 和 Web 服務驅動程式的資訊，請參閱＜資料存
取驅動程式 [第 63 頁]＞。
如需有關 Teradata 13、Teradata 14 和 Sybase IQ 單一登入支援的資訊，
請參閱＜單一登入支援 [第 27 頁]＞。
如需有關 SAP HANA 預存程序支援的資訊，請參閱＜ SAP HANA 預存程序
[第 30 頁]＞。
如需有關 SAP ERP 連線、選擇性輸入資料行簡化對應的資訊，請參閱＜
SAP ERP 驅動程式 - 存取 ABAP 函式 [第 84 頁]＞。
如需有關 SAP HANA 連線、新的 SAP HANA SPS 05 版本支援、OLAP 連
線、透過 SAML 通訊協定的單一登入、SSL 通訊協定以及透過 ODBC 的
64 位元 UNIX 平台的資訊，請參閱＜ SAP HANA 連線 [第 124 頁]＞。
如需有關透過 JDBC 的 HIVE 0.9 連線支援的資訊，請參閱＜ HIVE 和
Impala 連線 [第 108 頁]＞。
如需有關連線伺服器活動的新記錄器的資訊，請參閱＜啟動連線伺服器和
驅動程式的記錄和追蹤 [第 149 頁]＞。
如需有關如何啟動 OLAP 用戶端記錄的資訊，請參閱＜啟動 OLAP 用戶端
的記錄和追蹤 [第 155 頁]＞。
如需有關 DataDirect ODBC 7.0 驅動程式支援的資訊，請參閱＜關於
DataDirect ODBC 驅動程式 [第 164 頁]＞。
如需有關任何資料存取驅動程式的 SBO 參數的資訊，請參閱＜ Dictionary
Transaction Mode [第 172 頁]＞。
如需有關 MySQL 連線的新 SBO 參數的資訊，請參閱＜ JDBC ResultSet
Type [第 187 頁]＞和＜ JDBC ResultSet Concurrency [第 188 頁]＞。
如需有關 Teradata 連線的新 SBO 參數的資訊，請參閱＜ Replace Current
Owner With Database [第 195 頁]＞。
如需有關略過 SAML 與 SAP HANA 連線的新 SBO 參數的資訊，請參閱＜
Skip SAML SSO [第 178 頁]＞。
12
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
文件版本記錄
版本
日期
變更內容
SAP BusinessObjects
Business Intelligence 平
台 4.1 支援套件 1
2013 年 8
月
如需有關可用新連線的詳細資訊，請參閱《Product Availability Matrix》。
如需有關連線集區模式的描述，請參閱＜連線集區模式 [第 32 頁]＞。
若要檢查儲存於 CMS 的連線，請參閱＜檢查工具 — CMS 資訊 [第 47
頁]＞。
若要尋找 JDBC 驅動程式版本，請參閱＜尋找 JDBC 驅動程式的版本 [第
55 頁]＞。
如需有關調整 OData 連線逾時以改善效能的資訊，請參閱＜監控 OData 驅
動程式效能 [第 76 頁]＞。
如需有關支援不同版本 HIVE 資料庫連線的資訊，請參閱＜ HIVE 和 Impala
連線 [第 108 頁]＞。
如需有關 MS SQL Server 連線 UNIX 設定的資訊，請參閱＜在 UNIX 上設
定 MS SQL Server 連線的 JVM 選項 [第 118 頁]＞。
若要設定 CURSOR_SHARING 參數值，請參閱＜ Oracle 連線 [第 118 頁]
＞。
如需有關針對 .unv 語意層支援 SAP BW 64 位元連線的資訊，請參閱＜
SAP Business Warehouse 連線 [第 123 頁]＞。
若無法載入 SAP ERP 驅動程式，請參閱＜ SAP ERP 連線 - 無法載入驅動
程式 [第 124 頁]＞。
如需有關支援 SAP HANA 資料庫 1.0 SPS 06 的資訊，請參閱＜ SAP
HANA 連線 [第 124 頁]＞。
如需有關 SAP BW 連線安全性需求的資訊，請參閱＜ SAP BW 連線 [第
131 頁]＞。
如需有關伺服器模式中連線伺服器 cs.cfg 檔案範例的資訊，請參閱＜設
定部署模式 [第 146 頁]＞。
如需有關 SAP ERP 系統查詢中要使用的日期格式資訊，請參閱＜ SAP ERP
資料類型 [第 223 頁]＞。
如需有關 SAP HANA 資料類型及其在資料基礎中等值的資訊，請參閱＜
SAP HANA 資料類型 [第 224 頁]＞。
資料存取指引
文件版本記錄
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
13
版本
日期
變更內容
2013 年 11
月
如需有關可用新連線的詳細資訊，請參閱《Product Availability Matrix》。
如需有關更新 64 位元 Microsoft Windows 支援一節的資訊，請參閱＜ 64
位元 Microsoft Windows 支援 [第 26 頁]＞。
如需有關已啟用多來源語意層原生連線中地區設定支援的資訊，請參閱＜
設定多個資料來源工作流程的地區設定 [第 62 頁]＞。
若要在平台更新後安裝 Apache Hadoop HIVE 驅動程式，請參閱＜於平台
更新後使用 HIVE 連線 [第 112 頁]＞。
如需有關不支援透過 OLE DB 的 MS SQL 伺服器同義資料表資料行資訊，
請參閱＜ MS SQL Server 連線 [第 117 頁]＞。
如需有關更新 Oracle Essbase 一節的資訊，請參閱＜ Oracle Essbase 連線
[第 121 頁]＞。
如需有關更新 SAP BW 連線一節的資訊，請參閱＜ SAP Business
Warehouse 連線 [第 123 頁]＞。
如需有關支援 SAP HANA 資料庫 1.0 SPS 08 的資訊，請參閱＜ SAP
HANA 連線 [第 124 頁]＞。
若要支援新的分析函式，請參閱＜驗證分析函式支援並新增至 PRM 檔案
[第 199 頁]＞。
SAP BusinessObjects
Business Intelligence 平
台 4.1 支援套件 3
2014 年 2
月
如需有關可用新連線的詳細資訊，請參閱《Product Availability Matrix》。
SQL Server 2014 資料來源的直接支援： 支援的中介軟體為 ODBC 和
JDBC (Microsoft 已不再使用 OLE DB)
若要在安裝更新程式後新增驅動程式，請參閱＜安裝更新程式後新增驅動
程式 [第 61 頁]＞
如需有關 MySQL 連線 - 資訊設計工具中部分工作流程所需資料庫權限的資
訊，請參閱＜ MySQL 連線 - 資訊設計工具中部份工作流程所需的資料庫權
限 [第 120 頁]＞
SAP BusinessObjects
Business Intelligence 平
台 4.1 支援套件 4
14
&copy; 2014 SAP SE 或
2014 年 6
月
SAP 關係企業。 保留所有權利。
資料存取指引
文件版本記錄
版本
日期
變更內容
SAP BusinessObjects
Business Intelligence 平
台 4.1 支援套件 5
2014 年 10
月
●
＜ JAR 檔案位置參考 [第 52 頁]＞中的表格已更新
●
＜安裝的 SBO 檔案 [第 159 頁]＞一節已更新
●
＜建立 Apache Hadoop HIVE 的 JDBC 連線 [第 108 頁]＞中含 0.13
(Simba JDBC4) 資料庫資訊的表格已更新
資料存取指引
文件版本記錄
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
15
2
資料存取指引簡介
2.1
關於本指引
《資料存取指引》可協助您瞭解連線伺服器的功能，以及如何設定該伺服器啟用 SAP BusinessObjects Business
Intelligence 平台 4.1 SP1 與生產資料庫的連線。
《資料存取指引》提供下列資訊：
●
瞭解「連線伺服器」基礎知識
●
瞭解 CSV、OData、SAP ERP 和 XML 資料來源的資料存取驅動程式
●
建立 JDBC、ODBC 或 Javabean 連線
●
設定資料存取參數
註記
該指南同時提供相關資訊，說明如何設定某些依賴資料聯邦服務和 OLAP 連線的關聯式連線。
2.2
適用對象
《資料存取指引》是針對下列對象：
●
負責建立與資料來源連線的 SAP BusinessObjects 應用程式使用者
●
負責設定、管理及維護 BI 平台安裝的系統管理員
2.3
主要工作
《資料存取指引》為您提供管理組態參數和建立連線的主要資訊。對於下列每一個工作，請參閱下列適當的章節：
●
如何設定伺服器作業模式？
●
如何選擇您要載入的驅動程式？
●
如何設定資料存取驅動程式？
●
如何檢查連線組態？
●
如何建立 JDBC 連線？
●
如何建立 SAP HANA 連線？
註記
如需諸如啟動和停止連線伺服器、管理屬性和度量資訊等的管理工作細項相關資訊，請參閱《SAP BusinessObjects
Business Intelligence 平台管理員指南》。
16
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取指引簡介
相關資訊
設定部署模式 [第 147 頁]
設定要載入的驅動程式 [第 148 頁]
檢視和編輯 SBO 檔案 [第 162 頁]
執行 cscheck 工具 [第 38 頁]
建立 JDBC 連線 [第 48 頁]
SAP HANA 連線 [第 124 頁]
2.4
本指南中的慣例
警告
在資料存取組態檔案中，如果您在 Microsoft Windows 上部署 BI 平台，請在檔案路徑中使用逸出符號 \ 和反斜線
\。
資料存取指引
資料存取指引簡介
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
17
3
資料存取簡介
3.1
關於連線伺服器
「連線伺服器」是一種資料存取軟體，可管理 SAP BusinessObjects 應用程式與資料來源之間的連線。
連線伺服器允許諸如語意層設計工具、資訊設計工具和 SAP BusinessObjects Web Intelligence 等應用程式連線至資
料來源，並根據該資料來源執行查詢。
「連線伺服器」並未提供任何使用者介面，您可以從這些應用程式的使用者介面，或透過編輯「連線伺服器」組態檔
案的方式，來建立並管理連線。
●
建立連線
您可以使用 BI 平台用戶端工具的連線精靈建立連線。
註記
語意層設計工具的連線精靈是「新連線」精靈。在資訊設計工具中，可能是「新增關聯式連線」精靈或「新
OLAP 連線」精靈。如需瞭解如何使用連線精靈，請參閱應用程式使用指南。
●
最佳化資料存取
您可以修改資料存取組態檔來最佳化透過「連線伺服器」傳送資料的方式。這些參數檔案具有 XML 格式，會連同
「連線伺服器」一併安裝。您可以設定參數值套用至特定資料存取驅動程式，或套用至所有安裝的資料存取驅動程
式。
3.2
連線元件
資料存取連線是由下列元件組成：
●
「連線伺服器」是用於管理應用程式與資料來源之間的連線。例如，「連線伺服器」處理應用程式送出的資料要
求。
●
資料存取驅動程式是資料庫特定軟體元件，會管理「連線伺服器」和資料庫中介軟體間的連線。
●
組態檔案會定義參數來設定下列系統之間的連線：
○
應用程式和「連線伺服器」
○
應用程式和資料存取驅動程式
○
連線伺服器和資料存取驅動程式
3.2.1
系統架構
下列圖表會詳細說明「連線伺服器」及資料存取驅動程式符合 SAP BusinessObjects 組態的位置。
18
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取簡介
3.2.2
資料存取驅動程式
資料存取驅動程式會提供「連線伺服器」和資料來源之間的連線。資料庫需要資料存取驅動程式，才能讓 SAP
BusinessObjects 應用程式進行存取。
SAP BusinessObjects 應用程式包括您可以用來設定資料庫連線的資料存取驅動程式。所包括的存取驅動程式可視您
的授權而定。
在您可以建立連線至沒有驅動程式的資料庫之前，您必須先取得必要的驅動程式。您可以使用下列方式取得驅動程
式：
●
連絡您的 SAP 代表以確認是否有可用的驅動程式，以及您是否有使用該驅動程式的授權。
●
使用 Driver Development Kit (DDK) 開發驅動程式以供使用。連絡您的 SAP 代表以取得詳細資料。
當您建立新連線時，請選取用於目標資料來源的適當資料存取驅動程式。例如，若您存取的是 Oracle 10g 資料庫，則
必須先安裝適當的中介軟體 (Oracle 10g 用戶端)，再安裝 SAP BusinessObjects Oracle 資料存取驅動程式。
警告
Excel bean (bean_excel.jar) 和 CSV (dbd_open_sample.jar) 資料存取驅動程式是驅動程式樣本。除使用
DDK 開發更複雜的驅動程式以外，您不應依原樣使用它們。
資料存取指引
資料存取簡介
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
19
3.3
資料存取組態檔案
資料存取組態檔隨附於 BI 平台的安裝中。這些檔案可區分為以下層級：
●
全域層
cs.cfg 套用至所有連線的組態檔。
●
驅動程式層
SBO 組態檔套用至特定驅動程式。
●
OLAP 連線
OlapClient.cfg 組態檔案適用於 .unx 語意層的 OLAP 連線。
除了控制連線的組態檔以外，每個資料存取驅動程式皆具備相關的 PRM 組態檔。這些檔案可依照資料庫軟體的效能，
控制應用程式產生 SQL 的方式。這些檔案還可用於諸如資訊設計工具等的應用程式。
相關資訊
OLAP 連線 [第 23 頁]
資料存取層可讓 BI 平台連線至 OLAP 資料來源。
關於 cs.cfg 組態檔案 [第 140 頁]
資料存取組態檔案 [第 158 頁]
3.3.1
關於 cs.cfg 全域組態檔案
所有資料存取驅動程式使用的 cs.cfg 全域組態檔案的安裝位置如下：
●
&lt;connectionserver-install-dir&gt;\connectionServer
cs.cfg 檔案包含套用至所有已安裝資料存取驅動程式的參數。
相關資訊
關於全域參數 [第 140 頁]
20
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取簡介
3.3.2
關於驅動程式組態檔案
資料存取驅動程式使用的組態檔案將安裝於下列路徑：
●
●
其中 &lt;RDBMS&gt; 為網路層的名稱，或使用組態檔的中介軟體。
以下所列出的檔案具有適用於已安裝之資料存取驅動程式的參數。
驅動程式特定檔案
是否可編輯
描述
&lt;driver&gt;.sbo
是
各資料存取驅動程式皆具備 oracle.sbo
SBO 檔案。 為每個驅動程
式和目標資料庫定義特定連
線組態。
&lt;driver&gt;.prm
是
每個資料存取驅動程式皆具 oracle.prm
備 PRM 檔。 定義參數 (該
參數會影響應用程式產生
SQL 的方式)。
&lt;driver&gt;&lt;language&gt;.c 否
od
範例
每個資料存取驅動程式皆具 oracleen.cod
備 COD 檔。 用來儲存連線
定義的相關資訊。 定義當建
立新連線時出現的欄位。
註記
請勿修改這些檔案。
&lt;driver&gt;.rss
否
每個資料存取驅動程式皆具 oracle.rss
備 RSS 檔。 儲存連線伺服
器所使用的預先定義 SQL
句子。
&lt;driver&gt;.stg
否
資料存取驅動程式具備策略 oracle.stg
檔。 如需更多資訊，請參閱
SBO 檔案參數參考。
相關資訊
SBO 參數說明 [第 166 頁]
PRM 檔案組態參考 [第 201 頁]
關於資料庫功能參數 [第 197 頁]
資料存取指引
資料存取簡介
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
21
3.3.3
關於 OlapClient.cfg 組態檔案
&lt;bip-install-dir&gt;\win32_x86
在 OlapClient.cfg 檔案中，您只能設定 OlapClient 區段的參數。
相關資訊
啟動 OLAP 用戶端的記錄和追蹤 [第 155 頁]
3.4
部署模式
「連線伺服器」可以下列部署模式執行：
●
程式庫模式 (處理序)
「連線伺服器」包含在用戶端程序中。大部分的 SAP BusinessObjects 應用程式在程式庫模式中皆使用「連線伺
服器」。
●
伺服器模式
「連線伺服器」為 CORBA 伺服器，而且可以遠端存取。「連線伺服器」服務於 CORBA 和 HTTP 用戶端，以分別
滿足 2 層和 Web 層部署模式的要求。
如需有關部署方案的詳細資訊，請參閱《SAP BusinessObjects Business Intelligence 平台管理員指南》。
相關資訊
設定部署模式 [第 146 頁]
設定部署模式 [第 147 頁]
設定要載入的驅動程式 [第 148 頁]
3.5
連線能力服務
預設 BI 平台安裝隨附三個「連線伺服器」伺服器執行個體。這些執行個體在中央管理主控台 (CMC) 的 [連線能力服
務] 下進行分組。
「連線伺服器」伺服器主控下列服務：
●
22
原生連線能力服務 (64 位元)
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取簡介
●
原生連線能力服務 (僅限 MS Windows 上的 32 位元)
調適處理伺服器主控調適連線能力服務，可讓使用者應用程式遠端存取以 Java 為基礎的資料來源。
在啟動時，連線能力服務將廣告刊登其在 BI 平台叢集上支援的資料來源清單，以便 SAP BusinessObjects 應用程式能
夠查詢和使用適當的伺服器執行個體。應用程式將先在程式庫模式下，然後在伺服器模式下透過「連線伺服器」尋找
資料來源。
連線與服務
在程式庫模式下使用「連線伺服器」時，將由本機電腦上安裝的資料存取驅動程式和中介軟體定義可用的資料來源清
單。在伺服器模式下使用「連線伺服器」時，資料來源清單還包括 BI 平台的後端系統上執行的每個伺服器執行個體支
援的資源來源。
每個伺服器執行個體支援資料存取層所支援的資料來源子集。子集取決於下列參數：
●
CS 伺服器實作技術 (C++ 或 Java)
●
主機作業系統 (UNIX 類別或 MS Windows)
●
安裝 BI 平台時可供選取的驅動程式
●
可針對 CMC 中每個伺服器執行個體選取的現用資料來源
下表說明每類連線可使用的連線能力服務：
連線
連線能力服務
描述
所有 64 位元原生資料來源
原生連線能力服務
支援 ODBC、OLE DB、OCI 等
所有 32 位元原生資料來源
原生連線能力服務
支援僅在 32 位元可用的資料來源。此服務僅適
用於 MS Windows。
以 Java 為基礎的資料來源
調適連線能力服務
支援所有以 Java 為基礎的中介軟體。此服務是
以 Platform Java Service (PJS) 架構為基礎的
Java 實作。
範例
●
64 位元原生資料來源為透過 Oracle OCI 的 Oracle 資料庫。
●
32 位元原生資料來源為透過 ODBC 的 MS Excel 2007。
●
以 Java 為基礎的資料來源為透過 JDBC 的 MS SQL Server 2008 R2。
3.6
OLAP 連線
資料存取層可讓 BI 平台連線至 OLAP 資料來源。
以 OLAP 資料來源為基礎的 .unv 語意層會使用「32 位元連線伺服器」所管理的連線，而目前的版本則可讓 SAP BW
連線使用「32 位元連線伺服器」或「64 位元連線伺服器」。
資料存取指引
資料存取簡介
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
23
以 OLAP 資料來源為基礎的 .unx 語意層則會使用 BI 平台「OLAP 用戶端」元件所管理的連線。
如需支援的 OLAP 資料來源清單，請參閱《Product Availability Matrix》；如需有關建立 OLAP 連線的資訊，請參閱
《資訊設計工具使用指南》。
24
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取簡介
4
瞭解資料存取內容
4.1
64 位元作業系統支援
●
資料存取層會接著提供可在 32 位元或 64 位元環境中執行的資料存取驅動程式。
下列區段將詳述其對於 32 位元或 64 位元環境中資料庫中介軟體支援的用途。
如需 64 位元作業系統支援的資料來源的完整清單，請參閱《Product Availability Matrix》。
註記
DDK 提供可在 32 位元或 64 位元環境中執行的資料存取驅動程式範例。如需有關 DDK 的詳細資訊，請參閱《Data
Access Driver Java SDK Developer Guide》。
4.1.1
64 位元 UNIX 支援
「連線伺服器」隨附於 BI 平台，並支援在 64 位元的 UNIX 環境上進行安裝，以作為同處理序或遠端伺服器。
警告
您必須確定安裝 64 位元中介軟體，以透過「連線伺服器」執行資料庫連線。
部分廠商不會針對 UNIX 環境的下列資料庫及網路層提供 64 位元中介軟體。 該中介軟體僅適用於 Microsoft
Windows：
●
●
●
●
●
透過 OLE DB 的一般資料來源
●
●
透過 ODBC 的 MS Excel 2010 和 2013
●
透過 OLE DB 的 MS SQL Server 2008、2008 R2 和 2012
資料存取指引
瞭解資料存取內容
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
25
4.1.2
記得
本節內容僅與 .unv 語意層所用的資料庫有關。
「連線伺服器」隨附於 BI 平台，並同時支援在 32 位元和 64 位元 MS Windows 環境上進行安裝，以分別作為同處理
序伺服器以及同處理序和遠端伺服器。
廠商不會透過 Microsoft Windows 上的 ODBC 為下列資料庫提供 64 位元中介軟體：
●
Ingres database 9
●
MS Access 2007 和 MS Excel 2007
●
PostgreSQL 8
●
文字檔案
●
●
Salesforce.com
●
透過 Oracle Essbase Client 的 Oracle Essbase 9 和 11
對於所有這些資料來源，資料存取層可在 64 位元版本的 Microsoft Windows 上與 32 位元中介軟體搭配使用。此功能
會透過特定部署進行處理，該部署由兩個同時在伺服器模式中執行的「連線伺服器」所組成。第一個「連線伺服器」
是 32 位元，且會執行連至無法處理 64 位元中介軟體之資料來源的連線，而第二個「連線伺服器」則會執行連至其他
資料來源的連線。由於 cs.cfg 檔案常見於兩個伺服器中，因此可共用相同組態。
限制
此架構表示您無法在兩個伺服器上執行相同的資料存取驅動程式。然而，您可以在 32 位元的「連線伺服器」或 64
位元的「連線伺服器」上建立一般 ODBC 連線，不過無法同時在兩部伺服器上建立連線。
26
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
瞭解資料存取內容
4.1.3
安裝 ODBC 驅動程式
針對安裝在 32 位元 Windows 作業系統上的資訊設計工具或語意層設計工具，應使用「ODBC 資料來源管理員」為任
何必須透過該工具建立、測試並存取的 ODBC 資料來源定義驅動程式；該資料來源管理員位於所安裝工具之實體電腦
的下列位置：
●
C:\Windows\System32\odbcad32.exe
針對安裝在 64 位元 Windows 作業系統上的資訊設計工具或語意層設計工具，應使用 32 位元版「ODBC 資料來源管
理員」為任何必須透過該工具建立、測試並存取的 ODBC 資料來源定義驅動程式；該資料來源管理員位於所安裝工具
之實體電腦的下列位置：
●
C:\Windows\SysWOW64\odbcad32.exe
針對資訊設計工具，您可以使用「ODBC 資料來源管理員」定義伺服器元件必須使用的 ODBC 資料來源；該資料來源
管理員位於所安裝伺服器元件之實體電腦的下列位置：
●
64 位元版本：C:\Windows\System32\odbcad32.exe (資料庫中介軟體存在時建議使用)
●
32 位元版本：C:\Windows\SysWOW64\odbcad32.exe (僅在 32 位元資料庫中介軟體存在時使用)
註記
如果資訊設計工具或語意層設計工具正為語意層資料來源使用 ODBC DSN，則應在安裝了使用所發行語意層的 SAP
BusinessObjects 報表應用程式的實體電腦上，建立名稱相同的 DSN。
如需有關資訊，請參閱《SAP BusinessObjects Business Intelligence 平台安裝指南》。
4.2
單一登入支援
在下列平台上安裝 BI 平台並使用下列連線時，提供單一登入 (SSO) 驗證：
資料來源
描述
Windows AD 及 Kerberos 可提供 BI 平台的單一登入。
搭配 Kerberos 使用的 Windows AD 可提供 BI 平台的單一登
入。
LDAP 可提供 BI 平台的單一登入。
所有平台上 OCI 的 Oracle EBS
您可以安裝和設定平台隨附的驗證 Plugin 來啟用 SSO。 使用者
使用其 EBS 憑證 (使用者名稱和密碼) 即可從 SAP
BusinessObjects 應用程式登入至 BI 平台。
所有平台上 OLAP BAPI 的 SAP BW
您可以安裝和設定 SAP 驗證來啟用 SSO。 使用者使用其 SAP
BW 憑證即可從 SAP BusinessObjects 應用程式登入至 BI 平
台。
資料存取指引
瞭解資料存取內容
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
27
資料來源
描述
所有平台上透過 SAP Java 連線能力 (JCo) 3.x 的 SAP ERP 系
您可以透過安裝和設定 SAP 驗證來啟用 SSO。 使用者使用其
統
SAP ERP 憑證即可從 SAP BusinessObjects 應用程式登入至 BI
平台。
透過 ODBC 的 SAP HANA 資料庫 1.0 SPS 08、所有平台上的
提供的 SSO 是資料庫的 SSO，並使用 Windows AD 及
Kerberos (ODBC、JDBC 和 OLAP) 或 SAML 通訊協定 (JDBC
和 OLAP)。 使用者使用其 Windows AD 憑證即可從 SAP
BusinessObjects 應用程式登入至 BI 平台。
搭配 Kerberos 使用的 Windows AD 可提供 BI 平台的單一登
入。
Microsoft Windows 上 ODBC 的 Teradata 13 和 Teradata 14
搭配 Kerberos 使用的 Windows AD 可提供 BI 平台的單一登
入。
如需有關 SSO 的詳細資訊，請參閱《Business Intelligence 平台管理員指南》。
相關資訊
Oracle EBS 連線 [第 120 頁]
SAP ERP 驅動程式 [第 81 頁]
SAP HANA 連線 [第 124 頁]
4.3
預存程序
「連線伺服器」可從 SQL 查詢或預存程序執行所產生的資料來源管理資料。
儲存的程序是以可執行程式碼的形式儲存在 RDBMS 中的 SQL 指令碼，可以接受引數，並傳回資料。
BI 平台支援下列資料庫和網路層的預存程序：
●
透過 CLI 驅動程式的 DB2 UDB 和 iSeries
●
●
Javabean
●
●
透過 OCI 的 Oracle
●
●
透過 OLE DB 的 MS SQL Server
28
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
瞭解資料存取內容
4.3.1
支援的資料庫功能
「連線伺服器」只會支援將資料傳回為結果集 (亦即表格) 的預存程序。這代表預存程序無法傳回整數、字串或游標，
且必須永遠包含 SELECT 陳述式。此外，支援的預存程序不能包含 OUT 或 IN/OUT 參數，只能包含 IN 參數。另外，
系統也不會執行預存程序中包含的 COMPUTE、PRINT、OUTPUT 或 STATUS 陳述式。
警告
這些限制對 Oracle 預存程序無效。請參閱下一節以瞭解支援的 Oracle 預存程序。
「連線伺服器」支援封裝內的 Oracle 預存程序。封裝名稱傳回作為目錄名稱。此行為針對 Oracle CI 和 JDBC 網路層
有效。
如需有關使用儲存程序的詳細資訊，請參閱《語意層設計工具使用者指南》。
4.3.2
Oracle 預存程序
支援的 Oracle 預存程序如下所示：
●
透過 REF CURSOR 傳回結果集的任何 PL/SQL 程序。
●
具有一個 IN/OUT REF CURSOR 變數參數且沒有 OUT 參數的 PL/SQL 預存程序
註記
將忽略程序的其他 IN/OUT 游標參數。
不支援的 Oracle 預存程序如下所示：
●
無法透過 REF CURSOR 參數傳回結果集的任何 PL/SQL 程序。
●
至少具有一個 OUT 參數的任何 PL/SQL 程序
●
任何 PL/SQL 函式
●
具有一個 IN/OUT 參數的任何 PL/SQL 程序，且該 IN/OUT 參數屬於 REF CURSOR 以外的類型，例如 VARRAY
●
任何 PL/SQL 表格函式
若要存取 Oracle 預存程序，您必須在伺服器端執行數項工作以便讓 BI 平台連線至預存程序。下一節將說明此工作步
驟。 4.3.3
在封裝內部建立資料指標
在 Oracle 資料庫中，封裝是一種資料庫物件，內含相關的 PL/SQL 類型、物件和子程式。您必須先在封裝內部建立資
料指標，才能使用定義的資料指標建立 Oracle 預存程序。
在 Oracle 資料庫管理系統中，請使用下列陳述式：
CREATE or REPLACE PACKAGE catalog_data AS
TYPE CatCurTyp IS REF CURSOR RETURN
all_objects%ROWTYPE;
END catalog_data;
資料存取指引
瞭解資料存取內容
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
29
BI 平台不支援封裝的預存程序，僅支援獨立模式。
4.3.4
建立 Oracle 預存程序
4.3.5
SAP HANA 預存程序
30
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
瞭解資料存取內容
4.3.6
Teradata 巨集
如果您使用 ODBC 建立連線，則「連線伺服器」將僅支援 Teradata 巨集。
警告
它不支援 ODBC 中的 Teradata 預存程序，因為預存程序不會傳回任何結果集合。它也不支援 JDBC 中的巨集和預
存程序。
您可以使用下列語法建立 Teradata 巨集：
create macro &lt;macro_name&gt; as (select * from &lt;table_name&gt;;);
如需詳細資訊，請參閱 Teradata 文件。
4.4
連線集區
驅動程式開啟對資料庫的連線，以便存取資料。下面是兩種可連線到資料庫的方法：
●
每次連線伺服器需要資訊時，資料存取驅動程式會開啟對資料庫的連線，擷取資料，然後關閉連線。
資料存取指引
瞭解資料存取內容
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
31
●
連線伺服器維持可用連線開啟，並在連線集區中維護其詳細資料。每次連線伺服器需要來自資料來源的資訊時，資
料存取驅動程式會檢查連線集區，查看是否包含未使用的合適連線。如果有現有連線可用，會使用該連線。如果所
有連線都正在使用，連線伺服器會建立新連線，並將它新增至集區中。這種方法更有效使用系統資源。
記得
「連線伺服器」不會將使用單一登入方式的連線新增至集區中。
4.4.1
關於集區的連線
可獨佔或共用連線集區中的可用連線。
●
獨佔連線一次只能配置給一位使用者。配置獨佔連線後，該連線在集區中即不再可供使用。該連線無法再配置給任
何其他要求者。若連線不再需要，自訂驅動程式會釋放連線，以便它可以重新配置。
●
共用連線一次可配置給多位使用者。配置連線後，該連線會保留在集區中，以便供其他要求者使用。
您可以選擇透過連線精靈的 [連線集區模式] 參數，建立唯一或可共用連線。
4.4.2
連線集區模式
連線集區模式值
連線集區模式描述
在每次交易後中斷連線
完成查詢後從資料庫中斷連線， 下次執行查詢時會重新建立連
線。
[保持連線作用中到]
此為連線集區選項。 若在 [集區逾時] 中所指定的時間 (預設值
為 10 分鐘) 前完成查詢，則可以重複使用連線。 所有使用者皆
共用該連線。
在整個工作階段 (僅限本機模式) 期間保持連線作用中
使用者結束應用程式時便會關閉連線。 此選項不會使用連線集
區。
選擇「連線集區模式」
連線集區模式可能會視您電腦資源的可用性而定。
32
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
瞭解資料存取內容
●
如果記憶體過低，請選擇 [在每次交易後中斷連線] 選項。
●
如果記憶體過高且效能十分重要，則選擇 [在整個工作階段 (僅限本機模式) 期間保持連線作用中] 選項。
●
若要更精確控制行為，請選擇 [保持連線作用中到] 選項。
4.4.3
檢查中介軟體連線集區
資料來源中介軟體通常會提供自有的連線集區機制，您必須確定中介軟體連線集區設定與設計工具中的設定相容，以
取得您預期的連線效能。
4.5
負載平衡
在伺服器模式中，您可以在 BI 平台上執行多個「連線伺服器」執行個體。「連線伺服器」在此部署模式中實作負載平
衡機制。該機制會依據資源選擇可支援新用戶端要求的最佳伺服器。
負載平衡透過增加 BI 平台上伺服器執行個體的數目，有助於解決延展性問題。
警告
此負載平衡機制不同於中央管理伺服器實作的負載平衡。
您可以在下列層級執行負載平衡：
●
在用戶端層上 2 層部署中的用戶端 Proxy
●
在 Web 層上 Web 層部署中的伺服器橋接器
「連線伺服器」還提供應用程式層級查閱機制，該機制有助於為作業選擇適當的伺服器執行個體。視用戶端要求的資
料來源類型以及伺服器支援的網路層和資料庫配對而定，「連線伺服器」將用戶端繫結到適當的伺服器。
記得
您可以在查閱後執行負載平衡。它在所有平台上均可用。
4.5.1
尋找最佳伺服器
連線伺服器的延展性問題可能出自下列原因：
●
開啟的資料庫連線數量
已藉由連線集區機制處理資料庫連線數量的相關問題。
●
連線伺服器所使用的 CPU
轉換資料或寫入大型回應緩衝區並將其傳回至用戶端時，連線伺服器可能會大量使用 CPU。然而，連線伺服器並
不會大量使用 CPU。
●
執行工作數量
伺服器執行的工作數量會增加該伺服器的工作負載。
資料存取指引
瞭解資料存取內容
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
33
●
連線伺服器或其內嵌中介軟體所配置的記憶體量
記憶體使用量取決於執行的 SQL 查詢。例如，相較於一系列的小型 SQL 查詢，龐大表格的單一 SQL 陳述式可能
會對延展性產生較大的影響。
連線伺服器可透過相關性最高的伺服器工作負載指示器 (即上述之配置記憶體量)，實作負載平衡。連線伺服器的伺服
器記憶體使用量越少，運作狀態便越加健全。
註記
未來版本的連線伺服器可能也會使用工作數量作為健全指示器。
下列公式可計算伺服器的健全狀態：
HEALTH = (available memory / max memory) * constant
其中：
●
max memory 是配置記憶體量的上限，例如，32 位元 MS Windows 平台的記憶體上限是 2GB。
●
●
constant 是 HEALTH 的最大值 (已針對連線伺服器將該值設定為 10000)。
4.5.2
負載平衡邏輯
1.
所有候選伺服器都會將其 HEALTH 值呈報至負載平衡器。
候選伺服器是支援要求網路層和資料庫配對的連線伺服器。假設所有伺服器執行個體都支援一組相同的資料來源，
則這些執行個體都是因應用戶端要求的潛在候選伺服器執行個體。
2.
負載平衡器透過識別最健全的伺服器並加以排名，進而決定要伺服器傳送用戶端要求的伺服器。接著，再從這些伺
服器中識別最佳伺服器。如果該組伺服器僅包含一個伺服器，則該伺服器即為目標伺服器。
系統會在伺服器的生命週期中更新 HEALTH 值，執行下列其中一項作業時，HEALTH 會進行重新計算：
●
建立或撤銷工作
●
準備或執行工作
●
執行資料擷取作業
4.5.3
回溯相容性
SAP BusinessObjects Business Intelligence 平台 4.0 功能套件 3 及以上版本的所有平台均支援負載平衡機制。若要
針對先前版本進行遞增部署或限制升級，則平台會支援回溯相容性。系統會將任何無法呈報其 HEALTH 值至負載平衡
器的伺服器視為運作狀態健全，即該伺服器的 HEALTH 值為最大值。
註記
舊版 Service Pack 中的部份平台也支援負載平衡機制。如需詳細資訊，請連絡您的 SAP 代表。
34
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
瞭解資料存取內容
4.6
記憶體配置
原生連線能力服務可以在 64 位元 MS Windows 上使用 HOARD 記憶體配置功能。HOARD 是針對元件可調整和最佳化
的記憶體配置程式，它可讓服務具有更佳的效能、最好的延展性以及更少的記憶體片段。
資料存取層提供下列二進位：
●
●
4.6.1
啟用 HOARD
1.
開啟 CMC。
2.
在 連線能力服務 下，停止由 ConnectionServer 伺服器主控的原生連線能力服務。
3.
尋找連線伺服器可執行檔。
其位於 &lt;bip-install-dir&gt;\win64_x64 目錄中。
4.
請製作 ConnectionServer.exe 檔案的備份。
5.
6.
重新啟動服務。
您已啟用原生連線能力服務中的 HOARD。
4.6.2
停用 HOARD
1.
開啟 CMC。
2.
在 連線能力服務 下，停止由 ConnectionServer 伺服器主控的原生連線能力服務。
3.
還原預設的 ConnectionServer.exe 檔案。
4.
從 CMC 重新啟動服務。
您已停用原生連線能力服務中的 HOARD。
4.7
系統會在 CA Wily Introscope 工作站中追蹤與連線伺服器相關的工作流程活動。 您可以透過該工具提供的以下檢視來
分析連線伺服器函式：
●
儀器板與摘要檢視 - 可提供整體資訊
●
追蹤檢視 - 可將錯誤反白顯示，並提供錯誤說明訊息。
●
樹狀結構檢視 - 可顯示特定工作流程的連續函數呼叫，並反白顯示針對該函數所花費的時間，以輕鬆追蹤耗時的活
動
資料存取指引
瞭解資料存取內容
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
35
如需詳細資訊，請參閱《SAP BusinessObjects Business Intelligence 平台管理員指南》。
相關資訊
設定使用 SAP HANA 連線檢測的 Java 虛擬電腦 [第 129 頁]
36
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
瞭解資料存取內容
5
建立連線
5.1
連線需求
本節涵蓋建立連線的需求。
●
確認您的平台符合 SAP 連線所支援的平台。
●
請確認正確地安裝資料庫中介軟體，以及您可以透過電腦或伺服器存取您的資料庫。
●
請確認您擁有存取資料庫所有的必要資訊，例如資料庫登入名稱和密碼。
●
安裝您將使用的 SAP BusinessObjects 解決方案，包括適當的資料存取驅動程式。
●
檢查是否已成功啟動所有服務。
●
請參閱隨附於 SAP BusinessObjects 解決方案的 Readme 檔案，以檢查您的環境與軟體可能需要的任何組態變
更。
●
請參閱目前的資料存取發行版本說明，查看任何組態變更是否會影響環境。
註記
您可以使用 cscheck 工具來檢查您的基礎結構，並判斷其是否適合 SAP BusinessObjects 應用程式使用。
相關資訊
檢查連線設定 [第 37 頁]
5.2
檢查連線設定
連線伺服器軟體包括一個命令列公用程式，使用此公用程式可檢查資料來源連線基礎結構。您隨時都可以使用
cscheck 工具，檢查用戶端中介軟體和安裝的資料存取驅動程式。
傳回安裝可支援的所有連線 (即網路層和資料庫) 詳細資料
●
傳回安裝在本機電腦的資料存取驅動程式詳細資料
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
37
●
傳回安裝在本機電腦的連線詳細資料
●
檢查提供的網路層和資料庫用戶端是否具有有效的中介軟體安裝
●
檢查提供的網路層和資料庫用戶端是否具有有效的資料存取驅動程式安裝
●
檢查是否可以建立連線至特定資料庫
相關資訊
檢查工具 - 函式概觀 [第 39 頁]
5.2.1
顯示 cscheck 工具的說明
cscheck 工具可讓您執行下列動作：
●
顯示 cscheck 公用程式的一般說明
●
顯示每個可用 cscheck 函式的說明
您可以使用您安裝 SAP BusinessObjects 解決方案時所選取的語言來顯示說明。
若要顯示 cscheck 的一般說明，請使用以下語法：
cscheck --help|h --language|l { language }
命令說明語法
若要顯示某個函式的說明，請使用以下語法，其中 &lt;functionName&gt; 是您要顯示其說明的函式名稱，&lt;language&gt;
是顯示說明所要使用的語言：
cscheck --help|h { functionName } --language|l { language }
函式說明語法
5.2.2
執行 cscheck 工具
在安裝 SAP BusinessObjects 解決方案之後，您可以隨時執行 cscheck 工具。
1.
開啟命令主控台。
2.
將目錄變更為工具的安裝路徑。
3.
輸入加上正確參數的 cscheck，尋找您要的資訊。
38
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
4.
檢閱傳回的資訊。
相關資訊
檢查工具 - 函式概觀 [第 39 頁]
5.2.3
檢查工具 - 函式概觀
&lt;output language&gt; 或 1 之後是以 ISO639-1 標準指定的語言。這是選擇性的。預設語言是英文。
●
--xml 或 x 指定輸出格式為 XML。這是選擇性的。預設輸出為在畫面上顯示文字。
●
--mute 指定不產生輸出。如果您是在檢查傳回狀態的指令碼中使用此工具，則會使用此切換參數。這是選擇性
的。預設為產生輸出。
此命令的其餘部分包含函式及其選項引數。
&lt;function name&gt; 可以使用下列值。每個函式都有一個簡短的版本，讓您可以用來取代完整的函式名稱：
●
list 也就是 lt
●
●
find 也就是 fd
●
middleware 也就是 mw
●
accessdriver 也就是 ad
●
●
ping 也就是 pg
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
39
5.2.4
檢查工具—list
語法
此函式會傳回支援的網路層和資料庫引擎清單。 例如，您可以使用它來判斷與其他檢查工具函式搭配使用的正確
值。
註記
此函式會傳回支援的資料存取驅動程式和中介軟體清單，包括機器上非必要安裝的程式和軟體。
cscheck |list||lt|
list 語法
相關資訊
檢查工具 - 函式概觀 [第 39 頁]
顯示 cscheck 工具的說明 [第 38 頁]
5.2.5
語法
此函式會傳回已安裝資料存取驅動程式的清單。
40
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
cscheck |driverssearch||ds|
driverssearch 語法
相關資訊
檢查工具 - 函式概觀 [第 39 頁]
顯示 cscheck 工具的說明 [第 38 頁]
5.2.6
檢查工具—find
語法
此函式會列出本機機器可用的連線類型 (即中介軟體和資料庫用戶端)。 其中包括：
●
本機機器上可用的連線類型
●
使用 CORBA 通訊層時的可用連線類型
●
使用 HTTP 通訊層時的可用連線類型
●
本機機器上可用的 Java 連線類型
cscheck |find||fd| -m { 連線伺服器存取模式 }
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
41
find 語法
表格 1： 函式輸入參數
連線伺服器存取模式 (-m)
用戶端應用程式存取連線伺服器所用的模式：
●
local： 列出本機機器上可用的連線類型。
●
corba： 列出使用 CORBA 時可用的連線類型。
●
http： 列出使用 HTTP 時可用的連線類型。
●
java： 列出本機機器上可用的 Java 連線類型。
●
extended： 列出 local、java 和 CORBA 連線能力
類型。
範例
尋找 CORBA 伺服器連線
以下命令會傳回可從 CORBA 伺服器使用的資料存取驅動程式清單。
cscheck find –m corba
42
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
相關資訊
檢查工具 - 函式概觀 [第 39 頁]
顯示 cscheck 工具的說明 [第 38 頁]
檢查工具 — CMS 資訊 [第 47 頁]
5.2.7
檢查工具—middleware
語法
針對提供的網路層和資料庫用戶端，此命令會檢查有效的用戶端中介軟體安裝是否存在。 若要針對提供的網路層和
資料庫用戶端同時檢查中介軟體和資料存取驅動程式，可以使用 connectivity 函式。
cscheck |middleware||mw| -c { 網路層 } -d { 資料庫用戶端 }
middleware 語法
表格 2： 函式輸入參數
網路層 (-c)
資料庫中介軟體所使用的網路層，由 find 函式傳回。
資料庫用戶端 (-d)
要檢查的資料庫，由 find 函式傳回。
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
43
5.2.8
檢查工具—accessdriver
語法
針對提供的網路層和資料庫用戶端，此函式會檢查是否已安裝有效的資料存取驅動程式。 若要針對提供的網路層和
資料庫用戶端同時檢查中介軟體和資料存取驅動程式，可以使用 connectivity 函式。
cscheck |accessdriver| |ad| -c { 網路層 } -d { 資料庫用戶端 }
accessdriver 語法
表格 3： 函式輸入參數
網路層 (-c)
資料庫中介軟體所使用的網路層，由 find 函式傳回。
資料庫用戶端 (-d)
要檢查的資料庫，由 find 函式傳回。
相關資訊
檢查工具 - 函式概觀 [第 39 頁]
44
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
顯示 cscheck 工具的說明 [第 38 頁]
檢查工具—list [第 40 頁]
5.2.9
檢查工具—connectivity
語法
對於提供的網路層和資料庫用戶端，此函式會檢查已安裝的中介軟體和資料存取驅動程式是否有效。
您可以使用 middleware 和 accessdriver 函式分開檢查各項。 若要檢查是否可以連線至某個特定資料庫，可以
使用 ping 函式。
cscheck |connectivity| |ct| -c { 網路層 } -d { 資料庫用戶端 }
connectivity 語法
表格 4： 函式輸入參數
網路層 (-c)
資料庫中介軟體所使用的網路層，由 find 函式傳回。
資料庫用戶端 (-d)
要檢查的資料庫，由 find 函式傳回。
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
45
5.2.10 檢查工具—ping
語法
此函式使用提供的詳細資料存取指定的資料庫。
cscheck ping|pg|-m { 連線伺服器存取模式 } -c { 網路層 } -d { 資料庫用戶端 } -u { 使用者名稱 } -p
{ password } -s { 資料來源 } -t { 資料庫 } -r { 主機名稱 } -j { PID }
ping 語法
表格 5： 函式輸入參數
連線伺服器存取模式 &lt;(-m)&gt;
用戶端應用程式存取連線伺服器所用的模式：
●
local： 連線伺服器執行於本機機器。
●
corba： 連線伺服器執行於 CORBA 伺服器。
●
http： 連線伺服器執行於 HTTP 伺服器。
●
java： 連線伺服器使用本機機器上的 Java 資料存
取驅動程式。
網路層 (-c)
連線要檢查的資料庫中介軟體，由 find 函式傳回。
資料庫用戶端 (-d)
資料庫類型，由 find 函式傳回。
使用者名稱 (-u)
資料庫的有效使用者名稱。
密碼 (-p)
使用者名稱的密碼。
資料來源 (-s)
執行資料庫的伺服器。
資料庫 (-t)
資料庫伺服器。
主機名稱 (-r)
針對 CORBA 模式，做為連線伺服器主機的電腦。
PID (-i)
針對 CORBA 模式，連線伺服器用於偵測的程序編號。
46
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
範例
以 ping 偵測 Oracle 資料庫
以下命令會檢查存取：
●
連線伺服器存取模式： local，即資料庫執行於本機機器。
●
網路層：Oracle Client
●
資料庫：Oracle 10g
●
資料來源：Harlaxton
●
使用者名稱：efashion
●
密碼：X2345
範例
以 ping 偵測使用 CORBA 的 Sybase 資料庫
以下命令會檢查存取：
●
連線伺服器存取模式： CORBA，即連線伺服器執行於 CORBA 伺服器。
●
網路層：Sybase
●
使用者名稱：syadmin
●
密碼：password
●
●
資料庫：SY1
●
資料庫主機：sybasehost
●
程序 ID： 456
相關資訊
檢查工具 - 函式概觀 [第 39 頁]
檢查工具—find [第 41 頁]
檢查工具 — CMS 資訊 [第 47 頁]
5.2.11
檢查工具 — CMS 資訊
語法
下列參數允許您指定可與 cscheck 工具的 find 或 ping 函式搭配使用的 CMS 資訊。
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
47
存取 CMS 的主機和連接埠。
使用者名稱 (--ce_user)
存取 CMS 的使用者名稱。
密碼 (--ce_pass)
存取 CMS 的密碼。
驗證 (--ce_auth)
存取 CMS 時，用於驗證使用者登入憑證的方法。
記得
參數必須置於命令列中的 find 或 ping 函式之前。 所有參數皆為強制。
相關資訊
檢查工具—find [第 41 頁]
檢查工具—ping [第 46 頁]
5.3
建立 JDBC 連線
當您安裝 BI 平台時，已安裝一組資料存取驅動程式。 您可以使用這些資料存取驅動程式建立資料庫連線。 這些驅動程
式位於 &lt;connectionserver-install-dir&gt;\connectionServer\drivers\java 目錄中。
註記
SAP BusinessObjects Enterprise XI 3.0 及以上版本具備 JDBC 連線能力。 Web Intelligence 豐富型用戶端支援
SAP BusinessObjects Business Intelligence 平台 4.0 和以上版本的 3 層模式 JDBC 連線能力。
SAP BusinessObjects 軟體也包含使用 JDBC 驅動程式存取資料庫的組態檔。 請執行下列步驟來使用這些驅動程式：
1.
從您的資料庫廠商處取得 Java 驅動程式軟體。
2.
使用下列其中一種方式來指定 JAR 檔案路徑：
48
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
○
使用 JAR 檔案的完整格式路徑，在該資料存取驅動程式的 SBO 組態中設定 ClassPath 元素。
○
將 JAR 檔案儲存至由 SBO 檔案 Extensions 參數值所建立的目錄。
您可以同時使用這兩個方式來指定 JAR 檔案路徑。 然而，SBO 檔案中指定的 JAR 檔案，會優先於儲存在您目錄中的
JAR 檔案。
註記
資料存取層會提供 Generic JDBC 連線能力，以建立連線至 BI 平台不明確支援的資料來源。
相關資訊
使用 SBO 檔建立 JDBC 連線 [第 49 頁]
使用 Extensions 建立 JDBC 連線 [第 50 頁]
建立一般 JDBC 連線 [第 51 頁]
JDBC 驅動程式屬性 [第 163 頁]
5.3.1
使用 SBO 檔建立 JDBC 連線
●
取得資料庫所需的 JDBC 驅動程式軟體，然後將檔案複製到系統。 這些檔案可從資料庫廠商取得。 驅動程式軟體
通常包含一個或多個 .jar 檔。 請注意這些檔案的安裝路徑詳細資料。
●
確認您手邊已準備好資料庫存取詳細資料，例如登入名稱和密碼詳細資料。
1.
2.
使用 XML 編輯器開啟 SBO 檔案進行編輯。
3.
註記
這些檔案需要安裝在執行應用程式的機器上。 確認 JDBC 驅動程式路徑正確。
4.
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
49
註記
在上一個案例中，設定值是以逗號分隔。
警告
如果該參數並非設定為這些值，則無法在連線精靈中使用 JDBC 驅動程式。
5.
儲存並關閉 SBO 檔案。
6.
執行連線精靈。
您所設定的 JDBC 驅動程式隨即顯示於可用連線的清單。
7.
選取 JDBC 驅動程式，並使用精靈來設定連線。
當您完成此工作，即可使用連線。
相關資訊
連線需求 [第 37 頁]
資料存取組態檔案 [第 158 頁]
5.3.2
JDBC SBO 範例檔案結構
5.3.3
使用 Extensions 建立 JDBC 連線
●
取得資料庫所需的 JDBC 驅動程式軟體，然後將檔案複製到系統。 這些檔案可從資料庫廠商取得。 驅動程式軟體
通常包含一或多個 JAR 檔案。
●
確認您手邊已準備好資料庫存取詳細資料，例如登入名稱和密碼詳細資料。
1.
請移至指引的下一節以尋找 Extensions 參數值。
50
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
2.
使用一個或多個 Extensions 參數值來建立您自己的驅動程式目錄。
例如，MS SQL Server 2008 中介軟體的 Extensions 參數值在 sqlsrv.sbo 檔案中為 sqlsrv2008、sqlsrv
和 jdbc。 您可以建立以下任何目錄：
○
&lt;connectionserver-install-dir&gt;\connectionServer\jdbc\drivers\sqlsrv2008
○
&lt;connectionserver-install-dir&gt;\connectionServer\jdbc\drivers\sqlsrv
○
&lt;connectionserver-install-dir&gt;\connectionServer\jdbc\drivers\jdbc
3.
將 JAR 檔案複製至您選擇的目錄。
4.
執行連線精靈。
您所設定的 JDBC 驅動程式隨即顯示於可用連線的清單。
5.
選取 JDBC 驅動程式，並使用精靈來設定連線。
為載入 JDBC 驅動程式，連線伺服器會於各目錄中搜尋 JAR 檔案 (從最特定到最不特定)，直到找到檔案為止。 隨即可
使用該連線。
範例
例如，如果您的 JAR 檔案僅儲存於 &lt;connectionserver-install-dir&gt;\connectionServer\jdbc
\drivers\sqlsrv 中，則連線伺服器會先在 sqlsrv2008 目錄中搜尋驅動程式，發現其中為空白後則會在
sqlsrv 目錄中搜尋以尋找 JAR 檔案，並載入驅動程式。
註記
由於 sqlsrv 為所有 MS SQL Server 目標資料庫的 Extensions 值，因此所有 MS SQL Server 資料庫會載入
此目錄中所指定的 JAR 檔案。
相關資訊
使用 SBO 檔建立 JDBC 連線 [第 49 頁]
資料存取組態檔案 [第 158 頁]
5.3.4
●
建立一般 JDBC 連線
為資料庫取得必要的 JDBC 驅動程式軟體。 .jar 檔案需要安裝於執行 SAP BusinessObjects 應用程式的電腦
上。
●
確認您手邊已準備好資料庫存取的詳細資料，例如登入名稱和密碼詳細資料。
1.
2.
將必要的 .jar 檔案複製到 &lt;connectionserver-install-dir&gt;\connectionServer\jdbc\drivers
\jdbc 目錄。
如果該目錄不存在，您必須建立一個。
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
51
3.
執行連線精靈。
您所設定的 JDBC 驅動程式隨即顯示於「一般」下方的可用連線清單。
4.
選取 JDBC 驅動程式，並使用精靈以透過下列詳細資料設定連線：
○
○
JDBC 類別
○
使用者名稱
○
password
當您完成此工作，即能透過 JDBC 使用資料來源的連線。
註記
jdbc.prm 檔案僅包含與 JDBC 資料庫一般功能有關的資訊。 您可以新增或更新檔案中自訂資料庫特有的任何資
訊。 jdbc.prm 檔案的修改會套用至已建立或將建立的所有一般 JDBC 連線。
相關資訊
資料存取組態檔案 [第 158 頁]
關於 PRM 檔 [第 197 頁]
5.3.5
JAR 檔案位置參考
資料庫
Extensions 參數值
Apache
內嵌的 Derby 10
derby10、derby、jdbc
52
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
資料庫
Extensions 參數值
Apache Hadoop Hive 0.7
Apache Hadoop Hive 0.8
Apache Hadoop Hive 0.9
Apache Hadoop Hive 0.10
Apache Hadoop Hive 0.12
Apache Hadoop Hive 0.12 Simba
JDBC4 HiveServer1
Cloudera Impala 1.0 Simba JDBC4
cloudera、impala、impala10simba4、jdbc
Amazon EMR Hive 0.7
amazon、hive、emrhive07、jdbc
Amazon EMR Hive 0.8
amazon、hive、emrhive08、jdbc
Amazon EMR Hive 0.11 Simba JDBC4
hive012simba4server1、amazon、hive、jdbc
Greenplum
GreenPlum4
postgresql9、postgresql、jdbc
Hewlett Packard
HP Neoview
neoview、jdbc
HP Vertica 6.1
vertica、jdbc
HSQLDB
內嵌的 HSQLDB 1.8
hsqldb18、hsqldb、jdbc
IBM
DB2 v9
db2v9、db2udb、db2、jdbc
z/OS 的 DB10
db2mvs10、db2mvs、db2、jdbc
z/OS 的 DB2 v11
db2mvs11、db2mvs、db2、jdbc
LUW 的 DB2 10
db2v10、db2udb、db2、jdbc
LUW 的 DB2 10.5
db2v10_5、db2udb、db2、jdbc
ids11、informix、jdbc
Ingres
Ingres Database 9
ingres9、ingres、jdbc
MS SQL Server 2008
sqlsrv2008、sqlsrv、jdbc
MS SQL Server 2012
sqlsrv2012、sqlsrv、jdbc
廠商
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
53
廠商
Netezza
Oracle
SAP
Sybase
Teradata
PostgreSQL
54
&copy; 2014 SAP SE 或
資料庫
Extensions 參數值
MS SQL Server 2014
sqlsrv2014、sqlsrv、jdbc
Netezza Server 4
netezza4、netezza、jdbc
Netezza Server 5
netezza5、netezza、jdbc
Netezza Server 6
netezza6、netezza、jdbc
Netezza Server 7
netezza7、netezza、jdbc
MySQL 5
mysql5、mysql、jdbc
Oracle 10
oracle10、oracle、jdbc
Oracle 11
oracle11、oracle、jdbc
Oracle 12
oracle12、oracle、jdbc
Oracle Exadata
oracleexadata、oracle11、oracle、jdbc
Data Federator XI R3
datafederator3、datafederator、jdbc
Data Federator XI R4
datafederator4、datafederator、jdbc
MaxDB 7.7
maxdb7.7、maxdb、jdbc
SAP HANA 資料庫 1.0
newdb、jdbc
sybase15、sybase、jdbc
sybase16、sybase、jdbc
iq15、asiq、jdbc
iq16、asiq、jdbc
ssa11、ssa、jdbc
ssa12、ssa、jdbc
ssa16、ssa、jdbc
Teradata 12
teradata12、teradata、jdbc
Teradata 13
teradata13、teradata、jdbc
Teradata 14
teradata14、teradata、jdbc
Teradata 15
teradata15、teradata、jdbc
PostgreSQL 8
postgresql8、postgresql、jdbc
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
廠商
資料庫
Extensions 參數值
PostgreSQL 9
postgresql9、postgresql、jdbc
相關資訊
SAP HANA 連線 [第 124 頁]
關於 Data Federator XI 3.0 查詢伺服器連線 [第 134 頁]
5.3.6
尋找 JDBC 驅動程式的版本
本節會描述尋找 JDBC 連線中驅動程式版本的方式。
您可以在驅動程式 JAR 檔案包含的 META-INF/MANIFEST.MF 檔案中尋找所用的 JDBC 驅動程式版本。
1.
執行下列其中一項操作：
選項
描述
使用 WinRAR 解
1.
啟動 WinRAR 應用程式。
壓縮檔案
2.
拖曳 JAR 檔案，並將其放置於應用程式視窗中。
3.
展開 [META-INF] 資料夾。
4.
從 WinRAR 拖曳 MANIFEST.MF 檔案並放置於本機資料夾。
5.
開啟檔案並尋找 Bundle-Version 值。
從命令提示字元
1.
開啟命令提示字元。
擷取檔案
2.
移至應擷取檔案的資料夾：
請執行下列命令：
&lt;JAR_path&gt;\jar.exe -xf &lt;driver_path&gt;\&lt;driver_name&gt;.jar META-INF/
MANIFEST.MF
4.
開啟檔案並尋找 Bundle-Version 值。
例如，執行下列命令以擷取 SAP HANA JDBC 驅動程式的版本：
註記
若 JAR 檔案的路徑包含空格，請將該路徑置於雙引號間。
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
55
5.4
建立 JavaBean 連線
所需的 JAR 檔案
●
JavaBean 需要的任何其他檔案
●
JavaBean 驅動程式需要的任何特定組態詳細資料
如同 JDBC 連線，您也可以使用 Extensions 功能來建立 JavaBean 連線。
註記
在 JavaBean 驅動程式中，資料擷取程序會設定為預存程序。從連線精靈建立 JavaBean 連線時，您必須勾選 [資料
庫中介軟體選取] 畫面上的 [篩選預存程序網路層]。如果未進行上述選取，則連線精靈不會顯示可用的 JavaBean 驅
動程式。
相關資訊
建立 JDBC 連線 [第 48 頁]
建立 JavaBean 連線 [第 56 頁]
使用 Extensions 建立 JavaBean 連線 [第 57 頁]
5.4.1
1.
建立 JavaBean 連線
2.
將必要的 .jar 檔案詳細資料新增至 ClassPath 區域。指定這些檔案時，請包括完整的路徑名稱。
註記
這些檔案需要安裝在執行 SAP BusinessObjects 應用程式的機器上。
如需詳細資訊，請參閱 javabean.sbo 範例檔案結構上的資訊。
3.
儲存並關閉檔案。
4.
執行 JavaBeans 開發人員指定的任何其他組態工作。
5.
執行連線精靈。
您設定的 JavaBeans 資料來源應出現在可用連線清單中。
56
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
6.
選取 JavaBeans 資料來源並使用精靈設定連線。
當您完成此工作，即可以應用程式使用連線。
相關資訊
資料存取組態檔案 [第 158 頁]
5.4.2
JavaBean SBO 範例檔案結構
5.4.3
1.
使用 Extensions 建立 JavaBean 連線
2.
開啟 SBO 檔案進行檢視。
3.
在 Defaults 區段中尋找 &lt;Parameter Name=&quot;Extensions&quot;&gt; 元素。
使用一個或多個 Extensions 參數值來建立您自己的驅動程式目錄。
例如，Extensions 參數值在檔案的 Defaults 區段中為 javabean， 因此您可建立 &lt;connectionserverinstall-dir&gt;\connectionServer\javabean\drivers\javabean 目錄。
5.
將 JAR 檔案複製至您選擇的目錄。
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
57
6.
關閉 SBO 檔案。
7.
執行連線精靈。
您所設定的 JavaBean 驅動程式隨即顯示於可用連線的清單。
8.
選取 JavaBean 驅動程式，並使用精靈來設定連線。
為載入 JavaBean 驅動程式，連線伺服器會於各目錄中搜尋 JAR 檔案 (從最特定到最不特定)，直到找到檔案為止。 隨
即可使用該連線。
相關資訊
建立 JavaBean 連線 [第 56 頁]
資料存取組態檔案 [第 158 頁]
5.5
建立 ODBC 連線
當您安裝 BI 平台時，已安裝一組資料存取驅動程式。您可以使用這些資料存取驅動程式建立資料庫連線。其位於
&lt;connectionserver-install-dir&gt;\connectionServer\drivers\lib32 或 &lt;connectionserverinstall-dir&gt;\connectionServer\drivers\lib64 目錄。
SAP BusinessObjects 軟體也包含使用 ODBC 驅動程式存取資料庫的組態檔。請執行下列步驟來使用這些驅動程式：
1.
從您的資料庫廠商處取得 ODBC 驅動程式軟體。
2.
修改提供的組態檔。
註記
資料存取層會提供 Generic ODBC 連線能力，以建立連線至 BI 平台不明確支援的資料來源。
關於 UNIX 上的一般 ODBC 連線
Microsoft Windows 作業系統內含標準的 ODBC 驅動程式管理員。相反地，UNIX 不提供任何管理驅動程式的標準方
式。SAP BusinessObjects 軟體能讓您在 UNIX 上的一般 ODBC 連線，使用 DataDirect 或 unixODBC 驅動程式管理
員。
您必須識別下列項目，才能在 UNIX 上建立一般 ODBC 連線至特定的資料庫：
●
ODBC 驅動程式的版本
●
驅動程式是否能與 DataDirect 驅動程式管理員或 unixODBC 共同運作
58
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
接著您要修改提供的組態檔案，並設定相關資料來源，以啟用連線。
相關資訊
建立一般 ODBC 連線 [第 59 頁]
建立一般 ODBC3 連線 [第 60 頁]
5.5.1
建立一般 ODBC 連線
下列程序顯示如何以下列假設，設定一般 ODBC 連線至資料庫：
●
驅動程式為 ODBC2
●
驅動程式支援 unixODBC 驅動程式管理員
1.
2.
使用 XML 編輯器開啟 odbc.sbo 檔案進行編輯。
3.
4.
註記
○
dbd_wddodbc 指定 DataDirect 型的 ODBC2 Unicode 驅動程式
○
dbd_ddodbc 指定 DataDirect 型的 ODBC2 非 Unicode 驅動程式
○
dbd_wuxodbc 指定 unixODBC 型的 ODBC2 Unicode 驅動程式
○
dbd_uxodbc 指定 unixODBC 型的 ODBC2 非 Unicode 驅動程式
5.
儲存並關閉 odbc.sbo 檔案。
6.
使用 XML 編輯器開啟 odbc.prm 檔案進行編輯。
7.
新增或更新資料庫的特定資訊。
註記
odbc.prm 檔案可能不包含資料庫的特定函式的相關資訊。
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
59
8.
儲存並關閉 odbc.prm 檔案。
9.
在您的 UNIX 機器上安裝相關的 ODBC 驅動程式。
10. 編輯 odbc.ini 檔案以設定資料來源。
11. 儲存並關閉 odbc.ini 檔案。
12. 執行連線精靈。
您所設定的 ODBC 驅動程式隨即顯示於「一般」下方的可用連線清單。
13. 選取 ODBC 驅動程式，並使用精靈來設定連線。
當您完成此工作，即能以 unixODBC 驅動程式管理員的身分，透過一般 ODBC 使用資料來源的連線。
相關資訊
資料存取組態檔案 [第 158 頁]
5.5.2
建立一般 ODBC3 連線
下列程序顯示如何以下列假設，設定一般 ODBC 連線至資料庫：
●
驅動程式為 ODBC3
●
驅動程式支援 unixODBC 驅動程式管理員
1.
2.
使用 XML 編輯器開啟 odbc.sbo 檔案進行編輯。
3.
4.
註解 DataDirect 的前兩個資料列，並取消註解後四個資料列的其中一個資料列。確認您將取消註解的資料列放在
區段最上方，這樣才能優先讀取。註解 &lt;Parameter name=&quot;CharSet Table&quot; Platform=&quot;Unix&quot;&gt; 元素。
註記
60
○
○
dbd_ddodbc3 指定 DataDirect 型的 ODBC3 非 Unicode 驅動程式
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
○
dbd_wuxodbc3 指定 unixODBC 型的 ODBC3 Unicode 驅動程式
○
dbd_uxodbc3 指定 unixODBC 型的 ODBC3 非 Unicode 驅動程式
○
dbd_wux32odbc3 指定 unixODBC 型的 ODBC3 Unicode 32 位元 API 驅動程式，非 64 位元 (僅限於 64
位元的平台上使用)
○
dbd_ux32odbc3 指定 unixODBC 型的 ODBC3 非 Unicode 32 位元 API 驅動程式，非 64 位元 (僅限於 64
位元的平台上使用)
5.
儲存並關閉 odbc.sbo 檔案。
6.
使用 XML 編輯器開啟 odbc.prm 檔案進行編輯。
7.
新增或更新資料庫的特定資訊。
註記
odbc.prm 檔案可能不包含資料庫的特定函式的相關資訊。
8.
儲存並關閉 odbc.prm 檔案。
9.
在您的 UNIX 機器上安裝相關的 ODBC 驅動程式。
10. 編輯 odbc.ini 檔案以設定資料來源。
11. 儲存並關閉 odbc.ini 檔案。
12. 執行連線精靈。
您所設定的 ODBC 驅動程式隨即顯示於「一般」下方的可用連線清單。
13. 選取 ODBC 驅動程式，並使用精靈來設定連線。
當您完成此工作，即能以 unixODBC 驅動程式管理員的身分，透過 ODBC3 使用資料來源的連線。
相關資訊
資料存取組態檔案 [第 158 頁]
5.6
安裝更新程式後新增驅動程式
若要新增驅動程式，則必須手動修改 BI 平台安裝。
您已將此版本的更新程式安裝至 BI 平台伺服器或用戶端工具。
BI 平台伺服器或用戶端工具的更新程式不會將新功能安裝至現有安裝， 僅會更新已安裝的檔案。 若要運用新驅動程
式，您必須從最新的完整安裝中進行手動安裝。
1.
在 控制台 中尋找 BI 平台的最新完整安裝程式。
記得
您無法在平台程式更新時執行下一步。
資料存取指引
建立連線
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
61
2.
以滑鼠右鍵按一下並選取 [解除安裝/變更]。
3.
在 SAP BusinessObjects BI 平台設定 對話方塊的 應用程式維護 畫面中，選取 [修改]，然後按一下 [下一步]。
4.
在 選取功能 畫面中，選取 [資料庫存取和安全性] 下所需的驅動程式選項。
5.
按一下 [下一步] 完成安裝。
您已於平台安裝驅動程式， 現在可以建立所需資料庫的連線。
5.7
設定多個資料來源工作流程的地區設定
在設計和報表工具中，已啟用多來源語意層 (使用原生連線) 的 BigDecimal 資料行查詢可能會傳回錯誤
(java.lang.NumberFormatException)。若要避免此問題，請將使用適當語言和國家值的 Locale 參數新增至
BIP 平台伺服器上的資料庫驅動程式的 SBO 檔案。
此程序使用法文地區設定作為範例。
1.
停止調適連線能力服務。
2.
3.
將下列其中一行新增至適當的 Database 區段下：
○
○
4.
儲存檔案。
5.
重新啟動服務和應用程式。
完成此工作後，多來源工作流程隨即可正常執行原生連線。
62
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線
6
資料存取驅動程式參考
6.1
資料存取驅動程式
本章提供與某些資料存取驅動程式有關的詳細資訊，這些驅動程式可使用 OData 或 XML 文件以及以 ABAP 為基礎的
SAP ERP 系統，啟用與資料來源的連線。其主要說明資料存取層使用之非一般資料模型和關聯式模型之間的對應規
則。
本章只和要建立在資訊設計工具中的連線相關。
相關資訊
CSV OpenDriver [第 63 頁]
OData 驅動程式 [第 68 頁]
SAP ERP 驅動程式 [第 81 頁]
XML 驅動程式 [第 87 頁]
Web 服務驅動程式 [第 99 頁]
6.2
CSV OpenDriver
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
63
6.2.1
CSV OpenDriver 功能
由於文字檔案未提供任何資料庫作業，資料存取驅動程式會實作下列查詢功能：
●
SELECT 陳述式的基本運算 (WHERE、ORDER BY、GROUP BY 和 AS)
●
WHERE 子句內的基本運算子 (=、&lt;&gt;、&lt;、&lt;=、&gt;、&gt;=、BETWEEN、NOT BETWEEN、LIKE、NOT LIKE、IS
NULL、IS NOT NULL、AND、OR)
●
在 WHERE 子句內使用萬用字元 (&quot;?&quot;)
●
SELECT 陳述式內的 DISTINCT 子句
●
UNION 和 UNION ALL
資料存取驅動程式還在 SELECT 陳述式中支援 MIN、MAX、AVG、SUM 和 COUNT 群組函式。
驅動程式限制
CSV OpenDriver 不會針對 CSV 檔案狀態的變更實作任何功能，如 INSERT、UPDATE 和 ALTER。資料存取驅動程式
也不支援對 CSV 檔案進行索引或 JOIN 作業。
相關資訊
作為排序作業快取使用的本機磁碟 [第 106 頁]
CSV OpenDriver 和 OData、SAP ERP、XML 以及 Web 服務驅動程式可使用本機磁碟作為已排序資料列的快取。
6.2.2
CSV OpenDriver - 表格對應
資料存取驅動程式會在資訊設計工具中將 CSV 檔案公開為表格。
如果連線精靈中 [檔案路徑或模式] 參數的設定模式 (如 report_*.csv) 與 report_2010-09-22.csv 和
report_2010-09-21.csv 等檔案都相符，則您便可連線至多個檔案。
記得
您無法連線至 HTTP 伺服器上的多個檔案。HTTP 通訊協定不支援在模式中使用萬用字元。
驅動程式將套用下列其中一項程序：
●
如果在連線精靈中選取 [將數個檔案合併為一個檔案] 參數，則所有 CSV 檔案將對應至一個表格。假設所有 CSV
檔案都具有相同的結構描述。此為資料存取驅動程式的預設行為。
●
如果未選取此參數，則每個 CSV 檔案會對應至不同的表格。
64
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
將所有檔案對應至一個表格
表格名稱即為模式名稱，例如 report_*.csv。表格具有額外的資料行名稱 sourcefile，其中包含每個表格資料列
的來源名稱。
如果您使用 SQLDDL 檔案提供結構描述，則表格名稱也必須符合此模式。
如果檔案具有不同的資料行名稱，則產生的表格資料行名稱為驅動程式所分析的第一個檔案的名稱，應明白驅動程式
將按字母順序分析檔案。
將一個檔案對應至一個表格
每個表格名稱都會與其資料來源的檔案名稱相對應。
如果您使用 SQLDDL 檔案提供結構描述，則 CREATE 陳述式中的表格名稱必須是檔案名稱。
檔案路徑會對應至表格的限定詞，而與參數值無關。
範例
表格名稱
如果 report_1.csv 檔案具有 col1 ... col10 資料行，而 report_2.csv 檔案具有 column1 ... column10 資料
行，則產生的表格資料行為 col1 ... col10。
範例
限定詞
如果 C:\reports\report_1.csv 為資料來源，則限定詞為 C:\reports\，而表格名稱為 report_1.csv。
相關資訊
CSV 檔案位置 [第 65 頁]
CSV 結構描述偵測 [第 66 頁]
6.2.3
CSV 檔案位置
您可以使用本機或遠端的 CSV 檔案作為資料來源。針對位於遠端系統上的檔案，此版本支援 HTTP、FTP 和 SMB (也
稱為 CIFS) 通訊協定，目前的版本也支援以憑證為基礎的 HTTPS 和 FTPS 加密通訊協定。CSV 檔案可位於 BI 平台的
中央管理伺服器 (CMS)。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
65
下載安裝版本 1.3.15。
您可以透過連線精靈的 [位置類型] 參數將資料來源設定為本機或遠端。如果資料來源為遠端，則您必須透過精靈的 [通
訊協定] 參數設定所使用的通訊協定。[通訊協定] 值必須與 [檔案路徑或模式] 和 [結構描述檔案] 參數值中指定的通訊
協定相符。
範例
CSV 檔案路徑
●
C:\csv\report.csv 或 csv/report.csv 是本機檔案路徑
●
●
●
6.2.4
CSV 結構描述偵測
資料存取層將針對 CSV 檔案的結構描述偵測提供下列方法：
●
未偵測
●
自動偵測
●
使用資料定義語言 (DDL) 檔案
●
使用 SQLDDL 檔案
您可選擇上述方法，使用連線精靈中的 [結構描述偵測] 參數來套用至檔案。您可以使用結構描述檔案 (DDL 或
SQLDDL) 來提供結構描述。結構描述可協助您處理複雜的大型檔案。
依照字母順序分析檔案。
註記
CSV 檔案的第一行可能包含註解，您可以使用精靈中的 [開頭位置的註解行數目] 參數略過該行。
未偵測
資料存取驅動程式會略過註解行、分析第一行並決定資料行數目，但是不會決定資料行類型。此驅動程式會將所有的
值視為字串，並將資料行大小設定為 255 字元，該字元會對應至 VARCHAR 資料類型的標準長度。超過 255 個字元的
值將遭到截斷。資料行可包含 Null 值。
66
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
自動偵測
記得
您無法將此方法套用至資料行長度固定的 CSV 檔案。
資料存取驅動程式會分析格式正確的檔案並取得下列資訊：
●
資料行名稱
多數情況下，第一行會包含資料行名稱。否則，CSV OpenDriver 會以 column_0、column_1、… column_&lt;n&gt;
的格式產生資料行名稱。
●
資料行類型
驅動程式會使用數值、日期和時間資料類型的預先定義模式及使用者設定，來找出資料行類型。如果資料行包含不
同類型的值，則驅動程式會接著將資料行值視為字串。
●
資料行大小
資料行大小取決於資料行類型。若為數值，資料行大小便是類型範圍內最高值的長度。若為其他值，資料行大小則
是偵測期間所找出最長字串值的長度。
警告
僅當您將 [探測器資料列] 設定為 [全部] 時，才能讓驅動程式找出最長的字串。
●
資料行 Null 屬性
如果資料行包含 Null 值，則 Null 屬性為 True；如果已填入所有值，則為 False。
僅當您選取所有資料列時，才能設定連線精靈中的 [探測器資料列數目] 參數，以便選擇驅動程式必須分析的行數。
建議您參閱《資訊設計工具使用指南》。
使用 DDL 檔案
資料存取驅動程式會先分析 DDL 檔案，以將 SQL 資料類型轉換為驅動程式資料類型。
DDL 檔案需符合此模式：
ColumnName[:ColumnType[(Length)]];
例如：
col1:VARCHAR(20);
col2:DATE;
col3:INTEGER;
col4:INTEGER;
DDL 檔案僅能定義一個表格結構描述。驅動程式會將相同的結構描述指派給所有作為資料來源的 CSV 檔案。
使用 SQLDDL 檔案
資料存取驅動程式會先分析 SQLDDL 檔案，以將 SQL 資料類型轉換為驅動程式資料類型。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
67
SQLDDL 檔案需符合此模式：
CREATE TABLE &lt;Filename&gt; (
(&lt;ColumnName&gt; &lt;ColumnType&gt; [NOT] NULL,)*
(&lt;ColumnName&gt; &lt;ColumnType&gt; [NOT] NULL)
);
例如：
CREATE TABLE Clients (
id INTEGER NOT NULL,
name CHAR(20) NULL,
date DATE NULL,
PRIMARY KEY (id) )
SQLDDL 檔案可定義數個表格結構描述。驅動程式可將結構描述指派給數個表格。
資料存取驅動程式會分析 CREATE 陳述式，並忽略其他存在的陳述式。
如果 DDL 或 SQLDDL 檔案未定義資料行類型，則驅動程式會接著將資料行值視為 225 個字元的字串。超過 255 個字
元的值將遭到截斷。如果 DDL 或 SQLDDL 檔案僅提供類型，而未提供其長度，則驅動程式會接著使用標準長度，例
如，使用整數 10。DECIMAL 資料類型的整數位數和小數位數是必要資訊。
6.3
OData 驅動程式
資料存取層允許 BI 平台連線至使用開放式資料 (OData) 通訊協定的資料來源。 其可提供稱為 OData 驅動程式的資料
存取驅動程式，以存取網際網路或內部網路中的線上資料來源。 OData 驅動程式支援 OData 2.0 通訊協定，該通訊協
定會透過概念結構定義語言 (CSDL) 2.0 描述其結構描述。
OData 驅動程式允許 BI 平台連線至 SAP Gateway 2.0 公開的 OData 服務。 SAP Gateway 2.0 允許使用者透過 HTTP
從 SAP Business Suite 系統 (例如 ERP 和 CRM) 存取資料。
連線精靈會提供一個工作流程，可輸入用以連線至 OData 資料來源的必要資訊。 OData 資料來源會顯示在 Generic
OData 2.0 DBMS 和 OData Connector 網路層下方。
您可以在 &lt;connectionserver-install-dir&gt;\connectionServer\odata 目錄中找到驅動程式組態檔案。
odata.prm 檔案會依據資料庫作業和函式列出資料存取驅動程式功能。
6.3.1
OData 驅動程式功能
資料存取驅動程式支援下列查詢功能：
●
基本資料庫作業 (SELECT、WHERE、ORDER BY、結構化聯結)
●
WHERE 子句內的基本篩選運算子 (=、!=、&lt;、&lt;=、&gt;、&gt;=、AND、OR、LIKE、NOT LIKE、BETWEEN、NOT
BETWEEN、IS NULL、IS NOT NULL)
●
FROM 子句內的巢狀查詢
雖然 OData 2.0 通訊協定中無法表示 AS、DISTINCT 和 GROUP BY 作業，但資料存取驅動程式支援這些作業。驅動
程式會在內部執行這些作業。
68
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
限制
OData 驅動程式的目前版本不支援下列功能：
●
UNION 和 UNION ALL 作業
●
HAVING 子句
●
彙總函式中的 DISTINCT
●
WHERE 子句中的子查詢
資料庫函式
雖然 OData 2.0 通訊協定中無法表示 AVG、MIN、MAX 和 SUM 資料庫函式，但資料存取驅動程式支援這些函式。驅動
程式會在內部執行這些作業。OData 2.0 通訊協定僅支援對應至 $count 運算子的 COUNT 函式。
相關資訊
OData 驅動程式 - 對應索引鍵 [第 73 頁]
OData 驅動程式 - 非一般行為和限制 [第 79 頁]
作為排序作業快取使用的本機磁碟 [第 106 頁]
CSV OpenDriver 和 OData、SAP ERP、XML 以及 Web 服務驅動程式可使用本機磁碟作為已排序資料列的快取。
6.3.2
OData 服務位置
您可以透過 HTTP 連線至 OData 服務。 目前的版本也支援以憑證為基礎的 HTTPS 加密通訊協定。
範例
下列連結會透過 HTTP 和 HTTPS 參考 OData 服務的範例，以及 SAP Gateway 服務的範例。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
69
6.3.3
OData 服務範例
。如需進一步瞭解實體資料模型的概
＞。
記得
OData 驅動程式的目前版本不支援 FunctionImport、AnnotationElement、ReferentialConstraint 和動態屬性。
。
70
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
6.3.4
OData 驅動程式 - 對應命名空間、擁有人和限定詞
6.3.5
OData 驅動程式 - 對應表格
資料存取驅動程式會在資訊設計工具中將 OData 摘要公開為表格。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
71
客戶
●
訂貨主檔
●
產品
●
EmployeeTerritories
相關資訊
OData 驅動程式 - 對應索引鍵 [第 73 頁]
6.3.6
OData 驅動程式 - 對應資料行
EntitySet 是由 EntityType 所定義。EntityType 包含一系列的 Property。基本類型的 Property 會對應至代表
EntitySet 的表格資料行。Property 的 Name 屬性會對應至資料行名稱。
複雜類型的 Property 會對應一組表格資料行。一個資料行會對應至一個子屬性。資料行名稱是複雜類型與基本類型之
屬性名稱的串聯，並以斜線 (/) 分隔。此對應也適用於複雜類型的巢狀屬性。
範例
由於 Order EntityType 具有 OrderID Property，因此 Orders 表格包含 OrderID 資料行。
72
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
●
6.3.7
OData 驅動程式 - 對應索引鍵
對應主要索引鍵
EntityType 的索引鍵會對應至表格的主要索引鍵，該表格會對應 EntitySet。 其中可能包含一個或多個資料行。
記得
依預設，外部索引鍵在資料基礎表格中為隱藏的資料行，因為這些索引鍵不包含商業資料。 不過，您可以編輯表格
和資料行屬性來顯示這些索引鍵。 請參閱《資訊設計工具使用指南》。
警告
SAP 建議應用程式使用者不要查詢 -idref 資料行，因為這可能會降低驅動程式效能。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
73
範例
EntitySet 的外部索引鍵
由於下列原因，Orders 表格會具有 -idref-Customer-CustomerID、-idref-Employee-EmployeeID 和 idref-Shipper-ShipperID 外部索引鍵：
●
●
●
●
●
●
74
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
●
●
●
6.3.8
OData 驅動程式 - 對應文件元素
6.3.9
OData 驅動程式 - 衍生類型的對應實體
下列範例說明「員工」類型的 EntitySet。
&lt;EntitySet Name=&quot;Employees&quot; EntityType=&quot;Employee&quot; /&gt;
下圖顯示一個基本類型「員工」與兩個衍生類型「外部員工」和「內部員工」之間的繼承概念。 衍生類型會繼承基本
類型的所有屬性。 此外，其也可定義稱為直接屬性的額外屬性。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
75
針對特定 EntitySet，結果結構描述是合併為一個一般類型的結果。 下圖顯示在關聯式模型中呈現的「員工」表格。
關聯式模型的「員工」表格將包含兩個實體的資訊，也就是父類型和衍生類型的資料行。 為了避免命名衝突，在衍生
類型中宣告的資料行會加上 EntityType 的名稱作為前置字元。 其中也包含 Null 值。
6.3.10 監控 OData 驅動程式效能
您可以考量下列 OData 驅動程式的行為，以改善查詢執行的連線效能。
76
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
在用戶端或提供者端執行作業
建立連線時，您可以選擇在驅動程式或提供者層級上執行 SQL 查詢的某些作業。下表顯示可控制此行為的連線精靈參
數。
如果已選取參數，OData 服務提供者會處理對應的作業 (如果其可支援該作業)。這是預設行為。若未選取，則 OData
驅動程式會處理作業。
警告
SAP 建議您不要使用資料存取驅動程式來執行這些作業，因為這會降低連線效能。由於必須將完整的資料集傳輸至
用戶端，因此回應時間會增加。只有在 OData 服務提供者不支援或部分支援作業時，才能使用該選項。
參數
Operation
對效能的影響
資料行選擇
SELECT
如果未選取參數，OData 驅動程式會處理 SQL 投影，這會大幅增加資料
傳輸。
支援的篩選器條件
WHERE
您可以在驅動程式層級上執行 OData 標準不支援的某些篩選作業。不
過，提供者的篩選器通常會減少查詢執行時間。
資料存取層會套用下列邏輯以改善效能：將與 OData 標準相容的任何篩
選條件推送至 OData 提供者。OData 驅動程式會執行 WHERE 子句可能
包含的任何其他不相容篩選器。請參閱以下範例。
ORDER BY
排序
如果查詢中未使用 DISTINCT 或 GROUP BY 運算式，OData 提供者會執
行 ORDER BY 作業。如果查詢包含 DISTINCT 或 GROUP BY 運算式，則
驅動程式必須執行排序作業而，這會增加執行時間。
註記
●
驅動程式執行 ORDER BY 作業時，該作業會相依於 Bucket Split Size SBO 參數。
●
BETWEEN 運算子會對應至 OData 比較函式，然後由 OData 提供者執行。
●
LIKE 和 NOT LIKE 運算子通常會在用戶端上執行。不過，如果只有一個 % 模式分別置於篩選值的結尾或開頭，
則會將這些運算子轉譯為 startsWith 和 endsWith OData 函式。
範例
支援篩選器運算式
下列查詢在 WHERE 子句中包含兩個篩選器條件：
SELECT * FROM T1 WHERE col1='San Francisco' AND col2 LIKE 'S%n'
OData 提供者可處理子句的第一個部分，但不會處理第二個部分。然後 OData 驅動程式會執行 col2 LIKE 'S
%n'，提供者則執行 col1='San Francisco'。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
77
執行彙總函式
COUNT 資料庫函式是 OData 2.0 通訊協定支援的唯一彙總函式。GROUP BY 子句觸發的其他彙總函式和群組會在用戶
端上執行。不過，如果驅動程式執行的計算會在計算計數之前修改結果，就必須同時在用戶端上執行 COUNT 函式。這
會降低連線效能。
設定連線逾時參數
您可以在連線精靈中選擇 [連線逾時] 參數值，以微調驅動程式效能。若資料來源沒有回應，則會將連線維持作用中的
時間指定為秒數。
您必須選擇最適合的參數值，以取得最佳效能。例如，若您以較長回應時間連線至資料來源，則可針對 [連線逾時] 選
擇較高值以等待伺服器回應，避免過早產生錯誤。若您資料來源的速度通常較快，則可選擇較低值，以避免伺服器未
回應時等待錯誤的時間過長。
使用快取中繼模型
在連線精靈中預設會選取 [快取中繼模型]。其可讓您在連線集區的連線期間只需擷取一次中繼資料模型，而不必在每
次執行查詢時都進行擷取。這會增加連線效能。
註記
如果已快取中繼資料模型，則您必須啟用連線集區。
相關資訊
OData 驅動程式功能 [第 68 頁]
78
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
6.3.11
OData 驅動程式 - 非一般行為和限制
排序演算法
某個服務提供者的排序演算法可能會與另一個提供者不同。 在查詢中使用 ORDER BY 時，這會導致不同的結果。
由於 OData 驅動程式可能會使用自己的演算法執行排序作業，因此使用 ORDER BY、GROUP BY 和 DISTINCT 等組合
作業時也可能會導致不同的排序順序。
對應 Max Rows 參數
只有當查詢作業未修改資料列數時，$top OData 函式才會對應至 [查詢面板] 的 Max Rows 參數。 套用篩選器時，查
詢結果可能會發生錯誤，並從預期的 $top 結果中移除某些資料列。
COUNT 函式的限制
資訊設計工具中的表格資料列計數在語意上會計算包含已定義資料行之非 Null 值的資料列。 某些 Azure 服務只會在一
個表格中傳回資料列總數。 這可能會導致預期與實際查詢結果之間的不一致。
SAP Gateway 服務的限制
如果 Gateway 服務提供者不支援所有資料行上的篩選器，您在建立連線時便不能選取 [支援的篩選器條件]。 如果該提
供者不支援所有資料行上的排序，建立連線時，您便不能選取 [排序]。
結構描述可能會透過 sap:filterable 和 sap:sortable 中繼資料的說明來表示這些篩選和排序限制。 在目前的版
本中，OData 驅動程式不會對應這些屬性。
某些提供者可能不會在所有的表格上提供完整的表格掃描功能。 這會導致執行階段錯誤，例如，與 JOIN 有關的其中
一個表格無法進行掃描。
SAP 建議您直接建立與 SAP ERP 系統的連線以避免與 Ad Hoc 查詢有關的問題。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
79
Binary Max Length 可設定二進位類型的表格資料行大小上限
●
String Max Length 可設定字串類型的表格資料行大小上限
6.3.13 驗證 OData 來源
某些 OData 資料來源的存取需要驗證。 應用程式可使用下列方法來驗證 OData 資料來源：
●
使用使用者名稱和密碼的 HTTP BASIC 驗證。 憑證未加密。
●
GET 存取 Token，也就是附加到服務 URI 的 {索引鍵, 值} 配對。 Token 的索引鍵和值會根據服務而不同。 使用連
線精靈中的 [自訂驗證參數] 以透過自訂參數設定 Token。 使用下列模式： &lt;&lt;索引鍵&gt;&gt;=&lt;&lt;值&gt;&gt;。
註記
資料存取層不會提供自訂驗證參數的追蹤，因為其中包含安全性資訊。 系統會在 OData 驅動程式追蹤中以
&lt;CUSTOM_AUTH_PARAMS&gt; 取代這些資訊。 不過，您可以考慮使用其他追蹤層級 (例如 CMC 中的 [啟用工作追蹤]
選項) 以顯示參數。
範例
存取 Token
http://wine.cloudapp.net/Regions?apikey=&lt;&lt;API 索引鍵值&gt;&gt;。
驗證 Microsoft Azure 資料來源
您可以使用 HTTP BASIC 驗證來連線至 Microsoft Azure 資料集。 在連線精靈中，輸入帳戶金鑰作為密碼。 您可以將
使用者名稱保留空白。
80
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
6.3.14 追蹤 OData 驅動程式活動
資料存取層會追蹤嚴重性層級為 PATH 和 DEBUG 的 OData 驅動程式。PATH 追蹤包含在查詢規劃和執行中使用之每
個方法的進入和結束點。其可讓您瞭解 OData 驅動程式或 OData 提供者是否已執行查詢作業，並找到問題的原因。
URI 中包含的資訊 (資料來源憑證、Proxy 伺服器憑證和自訂驗證參數) 不會顯示在驅動程式追蹤中。
6.4
SAP ERP 驅動程式
資料存取層可讓 BI 平台經由 SAP Java Connector (JCo) 3.x 網路層連線至 SAP ERP 系統。它提供的資料存取驅動程
式可存取下列 ERP 物件：
●
●
SAP 查詢
●
ABAP 函式
相關資訊
單一登入支援 [第 27 頁]
6.4.1
SAP ERP 驅動程式功能
資料存取驅動程式支援下列查詢功能：
●
基本運算 (SELECT、WHERE、ORDER BY、GROUP BY 和 AS)
●
基本運算子 (=、!=、&lt;、&lt;=、&gt;、&gt;=、BETWEEN、NOT BETWEEN、IN、NOT IN、AND、OR)，其運算元可以
是資料行名稱或常數值
●
SELECT 陳述式內的 DISTINCT 子句
●
SELECT 陳述式內的常數值
●
LIKE 和 NOT LIKE 接受跳出字元
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
81
●
FROM 子句內的巢狀查詢
資料存取層會在內部執行排序作業。
註記
資料存取驅動程式不允許按 SQL 陳述式中的索引排列資料行。只有使用資料行名稱的 ORDER BY 才是有效的子
句。在 jco.prm 檔案中，ORDER_BY_SUPPORTS_COLUMN_INDEX 參數會設定為 NO。
相關資訊
作為排序作業快取使用的本機磁碟 [第 106 頁]
CSV OpenDriver 和 OData、SAP ERP、XML 以及 Web 服務驅動程式可使用本機磁碟作為已排序資料列的快取。
ORDER_BY_SUPPORTS_COLUMN_INDEX [第 209 頁]
6.4.2
SAP ERP 驅動程式 - 存取 InfoSet 和 SAP 查詢
關於 InfoSet 和 SAP 查詢
在 SAP ERP 系統中，會在本機工作區或全域工作區內組織 InfoSet 和 SAP 查詢。 只有 SAP ERP 用戶端可存取本機工
作區內的物件，而所有用戶端均可存取全域工作區的物件。 SAP 查詢會在使用者群組中建立並屬於該使用者群組。
如需有關工作區和使用者群組的詳細資訊，請參閱您的 SAP ERP 文件。
物件對應
資料存取驅動程式會在資訊設計工具中將 InfoSet 和 SAP 查詢公開為表格。 InfoSet 和 SAP 查詢由一系列欄位所組
成，而欄位將會對應至表格資料行。 欄位將用於 SELECT 陳述式。
在驅動程式層級，工作區會對應至限定詞。 預設限定詞會對應至本機工作區。
使用者群組會對應至擁有人。 接著，工作區的使用者群組將放置在代表此工作區的限定詞下方。
工作區的 InfoSet of 將放置在代表此工作區的限定詞下方，以及稱為 INFOSET 的假定擁有人的下方。 工作區的 SAP
查詢將放置在代表此工作區的限定詞下方。 使用者群組的 SAP 查詢將放置在代表此使用者群組的擁有人下方。
下圖描述 InfoSets 和 SAP 查詢在工作區中的組織：
82
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
欄位將會對應至表格資料行。 InfoSet 或 SAP 查詢包含規劃和選取欄位。 它還包含未用於規劃的選取欄位。 在使用連
線精靈建立連線時，您可選擇這些選取欄位是否以表格資料行。 [將選取欄位對應至表格資料行] 參數支援此功能。 如
果選取這個選項，則欄位將對應為選擇性輸入資料行。 如果未選取這個選項，則會忽略選取欄位，並可能不會對此欄
位進行篩選。
註記
強制性選取欄位不會進行特定對應。 應用程式使用者必須使用篩選器查詢這些欄位。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
83
輸入資料行
表格的輸入資料行是在應用程式使用者查詢該表格時，必須提供同等條件 (= 運算子) 的資料行。 輸入資料行中僅允許
使用同等條件。 禁止使用 IN 條件。
在資訊設計工具中，使用者可以將輸入資料行視為強制性或選擇性資料行。 強制性輸入資料行指強制要求設定其值的
資料行。 選擇性輸入資料行指未強制要求設定其值的資料行。
如果使用者在查詢中沒有為選擇性輸入資料行設定任何值，則「連線伺服器」將執行下列其中一項動作：
●
不會傳回值 (如果選擇性輸入資料行沒有預設值)
●
傳回預設值 (如果選擇性輸入資料行具有預設值)
驅動程式功能
當應用程式使用者查詢 InfoSet 時，一些資料庫作業會傳遞至 SAP ERP 系統 (SELECT、WHERE、僅使用 ORDER BY
資料行排序及 AS)，而其他作業則由驅動程式內部進行處理 (使用 WHERE、GROUP BY、DISTINCT 進行其他篩選及
使用 ORDER BY 彙總函式排序)。
當應用程式使用者查詢 SAP 查詢時，一些作業也會傳遞至 ERP 系統。 這些作業包括 SELECT、WHERE、ORDER BY
(只有 SAP 查詢已包含相同排序時) 及 AS。
如需有關系統直接管理的作業的詳細資訊，請參閱您的 SAP ERP 系統文件。
6.4.3
SAP ERP 驅動程式 - 存取 ABAP 函式
記得
SAP ERP 驅動程式可讓您與已發行及未發行 ABAP 函式建立連線。
ABAP 函式概念
ABAP 函式由一系列參數所組成，這些參數可能是用於函式呼叫的輸入參數或是呼叫回應中包含的輸出參數。 在 SAP
詞彙中，輸入參數稱為匯入，而輸出參數則稱為匯出。 一些參數可能是輸入參數和輸出參數。 這些參數稱為變更參
數。 除了匯入、匯出及變更參數外，還有可視為變更類型的表格參數。
ABAP 函式參數可能包括以下類型：
●
基本 ABAP 類型欄位
●
結構，即多個欄位的順序
●
表格，它可能由欄位、結構或表格所組成
84
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
物件對應
資料存取驅動程式會在資訊設計工具中將 ABAP 函式公開為表格。 在驅動程式層級，ABAP 函式群組將對應至擁有
人，而 ABAP 函式將對應至稱為 ABAPFunction 的限定詞。 這意味著，每個 ABAP 函式將放置在特定擁有人的下
方，而特定擁有人則與 SAP ERP 系統中的函式群組相對應。
作為輸入使用的匯入、變更及表格參數將對應至輸入資料行。 作為輸出使用的匯出、變更及表格參數將對應至表格。
輸入資料行可能是強制性或選擇性。 資料存取層會將這些參數視為不可為 Null 的主索引鍵屬性。
驅動程式會將 ABAP 函式參數對應如下：
●
將強制參數對應至強制輸入資料行。 使用者必須設定此資料行的值。
●
將具有預設值的選擇性參數對應至選擇性輸入資料行。 使用者無需設定此資料行的值。 在此情況下，資料來源傳
回至「連線伺服器」的值為預設值。
●
同時將沒有預設值的選擇性參數對應至選擇性輸入資料行。 視輸入資料行的 SQL 類型而定，連線伺服器會傳回下
列字串資料類型的值：
SQL 類型
值
SQL_Integer
0
空字串
SQL_Double、SQL_Float、SQL_Numeric
0.0
SQL_Date
00010101
SQL_Time
000000
任何其他類型
空字串
註記
驅動程式會將 &lt;column name&gt;-ID 資料行附加到 ABAP 函式所對應的表格，並且會在驅動程式包含另一個表格的
參考時將另一個 &lt;column_name&gt;-IDREF 附加到表格。
資料行重新命名
將在驅動程式層級重新命名資料行。 下表列出新增到資料行的前置字元：
輸入或輸出
參數
前置字元
輸入
匯入
-IMPORT_
輸入
變更
輸入
表格
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
85
輸入或輸出
參數
前置字元
輸出
變更
-EXPORT_CH_
輸出
表格
-EXPORT_CH_
註記
當輸出表格參數 (A) 由另一個表格 (B) 組成時，兩個表格將分別重新命名為 -EXPORT_CH_A 和 EXPORT_CH_A.B。
驅動程式功能
所有資料庫作業 (SELECT、WHERE、ORDER BY、GROUP BY、AS 等) 均由驅動程式內部處理，而輸入資料行的同
等條件將傳遞給 SAP ERP 系統。
記得
驅動程式僅接受將單一資料列作為輸入參數的表格。 它們等同於輸入結構。
●
當您在連線精靈中建立連線時，可設定是否將表格類型的變更參數或表格參數視為輸入和輸出參數。 [將表格參數
對應至輸入資料行] 參數支援此功能。 如果選取此選項，則參數將為輸入和輸出參數。 在此情況下，只能為作為輸
入的結構。 如果未選取此選項，則參數僅視為輸出參數。
●
驅動程式會將選擇性輸入結構的欄位視為選擇性輸入資料行。 輸入資料行整體視為選擇性，也就是說，如果一個
資料行具有值，則其他資料行也必須具有值。 應用程式使用者必須確保所有資料行都具有值。
●
某些 ABAP 函式參數可能包含由 SAP ERP 系統所回報大小為零的值。 驅動程式會使用 cs.cfg 檔案的 String
Max Length 參數來設定表格資料行 (對應至這些參數) 的字串最大長度。
相關資訊
String Max Length [第 180 頁]
6.4.4
SAP ERP 驅動程式限制
●
您無法根據與 SAPGUI 處理相關的 ABAP 程式查詢 ERP 物件，因為無法使用遠端函式呼叫存取這些物件。
●
JCo API 不支援陣列擷取。也就是說，系統會同時傳回結果資料。若要限制結果資料列數及避免記憶體不足的問
題，應用程式使用者必須適當篩選資料。無論此限制為何，「連線伺服器」仍會套用陣列擷取。
86
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
註記
應用程式使用者也可以在 [查詢面板] 中設定 Max Rows 的值。不過，如果定義的語意層為多來源，或如果在取
得資料後查詢需要計算 (SELECT、DISTINCT、ORDER BY 及 GROUP BY)，則 SAP ERP 系統不會考量 Max
Rows。
●
jco.sbo 組態檔案的「ERP Max Rows」參數可讓應用程式使用者進行查詢，而無須篩選僅包含數值資料類型資
料行的 InfoSet 或 SAP 查詢表格。使用者也可以查詢包含數值和 DATS 資料類型資料行的表格。當 Max Rows 未
傳遞至 SAP ERP 系統時，也會使用此參數。ERP Max Rows 可配合單一來源和多來源語意層使用。若要避免記憶
體不足的問題，請將 ERP Max Rows 設定為適當的值。
註記
若為多來源語意層，您也可以在資料聯邦管理工具的 [查詢] 面板中設定 Max Rows 的值。如需詳細資訊，請參
閱《資料聯邦管理工具指南》。
6.5
XML 驅動程式
資料存取層允許 BI 平台連線至 XML 文件作為資料來源。
XML 文件會以 XML 結構描述為基礎。XML 結構描述是可定義 XML 資料來源之中繼資料的 XSD 文件。
連線精靈會提供一個工作流程，可輸入用以連線至 XML 資料來源的必要資訊。XML 資料來源會顯示在 XML Files
DBMS 和 XML File Connector 網路層下方。
您可以在 &lt;connectionserver-install-dir&gt;\connectionServer\xml 目錄中找到驅動程式組態檔案。
xml.prm 檔案會依據資料庫作業和函式列出資料存取驅動程式功能。
6.5.1
XML 驅動程式功能
資料存取驅動程式支援下列查詢功能：
●
基本資料庫作業 (SELECT、WHERE、ORDER BY、GROUP BY、DISTINCT)
●
ORDER BY 子句內的資料行別名 (AS)
●
FROM 子句內的巢狀查詢
●
篩選運算子 (=、!=、&lt;、&lt;=、&gt;、&gt;=、AND、OR、BETWEEN、NOT BETWEEN、IN、NOT IN、LIKE、NOT
LIKE、IS NULL、IS NOT NULL)
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
87
資料存取驅動程式不支援 JOIN 作業。
資料存取驅動程式可在 SELECT 陳述式中支援 MIN、MAX、AVG、SUM 和 COUNT 群組函式。
相關資訊
作為排序作業快取使用的本機磁碟 [第 106 頁]
CSV OpenDriver 和 OData、SAP ERP、XML 以及 Web 服務驅動程式可使用本機磁碟作為已排序資料列的快取。
6.5.2
XML 檔案位置
您可以使用本機或遠端的 XML 文件作為資料來源。針對位於遠端系統上的檔案，此版本支援 HTTP、FTP 和 SMB 通
訊協定，目前的版本也支援以憑證為基礎的 HTTPS 和 FTPS 加密通訊協定。
下載安裝版本 1.3.15。
您可以使用連線精靈的 [位置類型] 參數將資料來源設定為本機或遠端。如果資料來源為遠端，您也可以透過精靈的 [通
訊協定] 參數設定所使用的通訊協定。[通訊協定] 值必須與 [檔案路徑或模式] 參數值中指定的通訊協定相符。
範例
XML 檔案路徑
●
C:\xml\report.xml 或 xml/report.xml 是本機檔案路徑
●
●
●
相關資訊
CSV 檔案位置 [第 65 頁]
6.5.3
XML 文件和結構描述範例
下列範例說明名為 clubdemo.xml 並以 clubdemo.xsd 結構描述為基礎的 XML 文件結構。
88
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
89
90
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
6.5.4
XML 驅動程式 - 對應多個檔案
如果連線精靈中 [檔案路徑或模式] 參數的設定模式 (如 clubdemo_*.xml) 與 clubdemo_1.xml 和
clubdemo_2.xml 等檔案都相符，則您便可連線至多個檔案。
記得
您無法連線至 HTTP 伺服器上的多個檔案。HTTP 通訊協定不支援在模式中使用萬用字元。
如果在連線精靈中選取 [將數個檔案合併為一個檔案] 參數，則多個 XML 檔案中的相同表格會合併為一個表格。表格限
定詞的名稱為模式的完整路徑，例如 C:\files\xml\clubdemo_*.xml。假設所有檔案都具有相同的結構描述。
如果未選取參數，則不會合併表格，因為這些表格不屬於相同的限定詞。然後每個 XML 文件都會對應至資料庫限定
詞。表格限定詞的名稱為 XML 檔案的完整路徑，例如 C:\files\xml\clubdemo_1.xml。在此情況下，每個 XML
檔案都具有自己的結構描述。
沒有任何資料會對應至資料庫擁有人。
6.5.5
XML 驅動程式 - 對應表格
資料存取驅動程式會在資訊設計工具中將 XML 檔案公開為表格。
XML 文件根會對應至表格。
maxOccurs 值大於 1 的元素會對應至表格。
對應至元素的表格名稱是根和元素之間所有元素名稱的串聯，並以斜線 (/) 分隔。
範例
clubdemo.xml 文件會對應至下列表格：
●
ClubDemo
●
●
●
●
相關資訊
XML 文件和結構描述範例 [第 88 頁]
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
91
6.5.6
XML 驅動程式 - 對應資料行
XML 元素下方的下列物件會對應至代表此元素的表格資料行：
●
屬性
●
simpleType 元素或具有 simpleContent 元素的 complexType 的元素
●
混合元素中的文字，也就是定義 mixed=true 的類型
●
如果資料行代表屬性，則其名稱為從 maxOccurs 大於 1 的元素 (但不包含) 開始，一直到 (並包含) 主控此屬性的元素
為止，其中所有元素名稱的串聯。屬性名稱會加上 @ 作為前置字元，以避免與其他元素發生名稱衝突。
如果資料行代表元素，則其名稱為從 maxOccurs 大於 1 的元素 (但不包含) 開始的所有元素名稱的串聯。
如果資料行代表與其表格相同的元素，則其名稱為元素名稱。
串聯中使用的分隔符號為斜線 (/)。
當元素名稱代表在路徑中用於建立外部索引鍵的父元素時，該名稱會加上 (-) 作為前置字元。
下列對應範例參考 XML 文件和結構描述範例的主題。
範例
ClubDemo 表格包含下列資料行：
●
-id
@name
●
-Countries/-ClubDemo/-id
Age
●
Address
●
ZIP
●
City
●
●
@ID
●
92
-id
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
●
Invoice
●
-id
●
Name
●
@type
●
在 XML 結構描述中，name、type 和 ID 分別是 Country、Name 和 Customer 元素的屬性名稱。Invoice 和 Name
資料行分別代表 Invoice 和 Name 元素。請參閱對應主要索引鍵和外部索引鍵的主題，以瞭解其他資料行名稱的意
義。
相關資訊
XML 文件和結構描述範例 [第 88 頁]
XML 驅動程式 - 對應主要索引鍵和外部索引鍵 [第 93 頁]
XML 驅動程式 - 對應 anyType 和 simpleType [第 97 頁]
6.5.7
XML 驅動程式 - 對應主要索引鍵和外部索引鍵
主要索引鍵
下列規則適用於對應主要索引鍵：
●
驅動程式會產生對應文件根的表格主要索引鍵。 相關資料行稱為 -id，資料行值則為文件名稱。
●
類型 &quot;xs:ID&quot; 的屬性或元素會對應至代表主要索引鍵的資料行。
如果 XML 結構描述使用 &lt;xs:key&gt; 定義索引鍵，則適用下列規則：
●
如果在根層級上定義索引鍵，且選取器包含的元素 maxOccurs 值大於 1，則索引鍵會對應至對應表格的主要索引
鍵。
●
如果不是在根層級上定義索引鍵，則表格的主要索引鍵會是父元素主要索引鍵和索引鍵欄位的組合。
如果結構描述未針對 maxOccurs 值大於 1 的選取器元素定義主要索引鍵，則會將名稱為 -id 的資料行新增至表格作
為主要索引鍵。
範例
文件根
ClubDemo 元素為 clubdemo.xml 文件的根。 系統會建立 -id 資料行，並將其定義為 ClubDemo 表格的主要索引
鍵。 -id 資料行值為 clubdemo.xml。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
93
外部索引鍵
如果 XML 結構描述使用 &lt;xs:keyref&gt; 定義索引鍵參考，且在與索引鍵參考的相同層級定義該索引鍵參考，則索引鍵
參考會對應至對應表格的外部索引鍵。
針對對應至非根元素的表格，系統會從其父表格的主要索引鍵資料行以及從元素到其父系的反向路徑建立外部索引
鍵。 這會啟用父元素和子元素之間的關係對應。
限制
雖然資料基礎會公開外部索引鍵，但 XML 驅動程式不支援 JOIN 作業。
94
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
●
-Customers/-ClubDemo/-id 是從其父表格的反向路徑以及父表格的主要索引鍵所建立
範例
非索引鍵參考
ClubDemo/Customers/Customer/Invoice 表格的 -Customer/@ID 資料行已定義為外部索引鍵，這是從父表
格的主要索引鍵以及其父表格的反向路徑所建立。
相關資訊
XML 文件和結構描述範例 [第 88 頁]
XML 驅動程式 - 對應資料行 [第 92 頁]
6.5.8
XML 驅動程式 - 對應混合元素
混合元素的完整內容會對應至表格資料行。其中包括其子系以及子系之間的所有資料。
混合元素的屬性會對應至資料行，與元素的對應方式無關。
documentation 元素對應至表格資料行。
●
6.5.9
XML 驅動程式 - 對應遞迴元素
下列結構描述會定義遞迴元素：
&lt;xs:element name=&quot;parent&quot;&gt;
&lt;xs:complexType&gt;
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
95
&lt;xs:sequence&gt;
&lt;xs:element ref=&quot;child&quot; minOccurs=&quot;0&quot; maxOccurs=&quot;5&quot;/&gt;
&lt;/xs:sequence&gt;
&lt;/xs:complexType&gt;
&lt;/xs:element&gt;
&lt;xs:element name=&quot;child&quot;&gt;
&lt;xs:complexType&gt;
&lt;xs:sequence&gt;
&lt;xs:element ref=&quot;parent&quot; minOccurs=&quot;0&quot; maxOccurs=&quot;2&quot;/&gt;
&lt;/xs:sequence&gt;
&lt;/xs:complexType&gt;
&lt;/xs:element&gt;
XML 驅動程式會將第一個 parent 元素和 child 元素對應至表格，並忽略 parent 子系。
6.5.10 XML 驅動程式 - 對應 any 和 anyAttribute
範例
使用 any 的 XSD 結構描述
&lt;xs:element name=&quot;documentation&quot;&gt;
&lt;xs:complexType&gt;
&lt;xs:sequence&gt;
&lt;xs:element name=&quot;name&quot; type=&quot;xs:string&quot;/&gt;
&lt;xs:element name=&quot;datatype&quot; type=&quot;xs:string&quot;/&gt;
&lt;xs:any minOccurs=&quot;0&quot; maxOccurs=&quot;1&quot;/&gt;
&lt;/xs:sequence&gt;
&lt;/xs:complexType&gt;
&lt;/xs:element&gt;
●
name 和 datatype 對應至資料行
●
any 元素對應至 -any 資料行
限制
如果 any 元素具備的 maxOccurs 大於 1，則 XML 驅動程式僅會對應至剖析 XML 文件時，第一個元素名稱所發
現的 -any 資料行； 將忽略其他元素名稱。
96
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
範例
使用 anyAttribute 的 XSD 結構描述
&lt;xs:element name=&quot;documentation&quot;&gt;
&lt;xs:complexType&gt;
&lt;xs:sequence&gt;
&lt;xs:element name=&quot;name&quot; type=&quot;xs:string&quot;/&gt;
&lt;xs:element name=&quot;datatype&quot; type=&quot;xs:string&quot;/&gt;
&lt;/xs:sequence&gt;
&lt;xs:anyAttribute/&gt;
&lt;/xs:complexType&gt;
&lt;/xs:element&gt;
●
name 和 datatype 對應至資料行
●
範例
使用 anyAttribute 的 XML 檔案
&lt;documentation myAttribute=&quot;ConnectionServer&quot;&gt;
&lt;name&gt;Data Access Guide&lt;/name&gt;
&lt;datatype&gt;XML&lt;/datatype&gt;
&lt;/documentation&gt;
&lt;documentation myAttribute=&quot;DataFederator&quot;&gt;
&lt;name&gt;Data Federator User Guide&lt;/name&gt;
&lt;datatype&gt;any&lt;/datatype&gt;
&lt;/documentation&gt;
-@anyAttribute 資料行資料為元素屬性名稱及其值。 在此範例中，資料行資料包含下列兩個資料列：
myAttribute=&quot;ConnectionServer&quot;
myAttribute=&quot;DataFederator&quot;
6.5.11
下列各節將說明如何對應 XML 結構描述中的 anyType 以及 simpleType 的特定排列。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
97
對應 anyType 類型
anyType 類型元素的完整內容會對應至表格資料行。
對應值清單
無論值的基本資料類型為何，值清單會一律對應至 VARCHAR。
範例
資料類型清單
基本資料類型為整數。 整數清單的資料類型為 VARCHAR。
&lt;intvalues&gt;100 34 56 -23 1567&lt;/intvalues&gt;
將限制對應至類型
元素的值可以限制在某個範圍內。 這不會影響資料類型轉換。
範例
限制
&lt;xs:element name=&quot;age&quot;&gt;
&lt;xs:simpleType&gt;
&lt;xs:restriction base=&quot;xs:integer&quot;&gt;
&lt;xs:minInclusive value=&quot;0&quot;/&gt;
&lt;xs:maxInclusive value=&quot;100&quot;/&gt;
&lt;/xs:restriction&gt;
&lt;/xs:simpleType&gt;
&lt;/xs:element&gt;
對應類型聯集
聯集對應的 XML 資料類型為字串，也就是資料基礎中的 CHAR 或 VARCHAR 資料類型。
98
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
範例
類型聯集
&lt;xs:element name=&quot;jeans_size&quot;&gt;
&lt;xs:simpleType&gt;
&lt;xs:union memberTypes=&quot;xs:string xs:int&quot;/&gt;
&lt;/xs:simpleType&gt;
&lt;/xs:element&gt;
6.5.12 XML 驅動程式 - 設定資料行大小上限
cs.cfg 組態檔案提供下列參數：
●
Binary Max Length 可設定二進位資料類型的表格資料行大小上限
●
Integer Max Length 可設定 integer、nonPositiveInteger、negativeInteger、noNegativeInteger 和
positiveInteger 資料類型的表格資料行大小上限
●
6.6
Web 服務驅動程式
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
99
6.6.1
Web 服務驅動程式功能
XML 和 Web 服務驅動程式共用相同的功能。
相關資訊
XML 驅動程式功能 [第 87 頁]
6.6.2
Web 服務位置
您可以使用連線精靈中的 [Web 服務 URL] 參數來設定 Web 服務位置：
●
驗證所需的使用者名稱和密碼
●
Proxy 伺服器位址
●
驗證所需的 Proxy 使用者名稱和密碼
目前的版本也支援以憑證為基礎的 HTTPS 和 FTPS 加密通訊協定。
記得
Web 服務驅動程式僅支援 Web 服務定義文件以及在相同 HTTP 伺服器上主控的相關服務。
100
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
6.6.3
Web 服務定義範例
範例
WSDL 文件可定義下列詳細資料：
●
●
●
●
●
●
●
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
101
6.6.4
Web 服務的對應規則
Web 服務驅動程式使用與 XML 驅動程式相同的表格和資料行對應規則。驅動程式也支援 Web 服務的下列特定規則。
102
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
限定詞
資料存取層一次可連線至一個 Web 服務。服務會對應至資料庫限定詞。在 ClubDemo 範例中，限定詞名稱為
CustomerService 服務名稱。
擁有人
port 屬性會對應至資料庫擁有人。在此範例中，擁有人是 Customer。
表格
在資料存取層中，每個作業都會以根作為代表。每個輸出訊息則代表作業的子元素。Web 服務驅動程式會將輸出訊息
公開為表格。
表格名稱是作業名稱、輸出訊息和包含在回應中之 XML 元素的串聯，並以斜線 (/) 分隔。
範例
在 ClubDemo 範例中，表格如下所示：
●
●
●
●
資料行和輸入資料行
資料行的 XML 對應規則也適用於 Web 服務。
Web 服務驅動程式僅接受以單一資料列作為輸入訊息的表格。該表格的每個項目都會對應至結果表格的輸入資料行。
即使這些訊息在 WSDL 文件中已定義為選擇性，驅動程式仍會對應所有的輸入訊息。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
103
-id
●
Age
●
Address
●
ZIP
●
City
●
●
@ID
●
-GetCustomerListResponse/-id
●
範例
GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse/
GetCustomerListReturn/Name 表格的資料行如下所示：
●
-id
●
Name
●
@type
●
-GetCustomerListReturn/@ID
●
-id
●
Invoice
●
-GetCustomerListReturn/@ID
●
主要索引鍵和外部索引鍵
主要索引鍵和外部索引鍵的 XML 對應規則也適用於 Web 服務。此外，輸入資料行一律是主要索引鍵定義的一部分。
104
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
限制
雖然資料基礎會公開外部索引鍵，但 Web 服務驅動程式不支援 JOIN 作業。
範例
外部索引鍵
-GetCustomerListResponse/@ID 和 -GetCustomerListReturn/@ID 資料行是從父表格的反向路徑以及父
表格的主要索引鍵所建立。
陣列資料類型
Web 服務支援由一系列基本或複雜類型組成之陣列格式的資料類型。此類型的元素會對應至單一資料列表格。同時也
會對應為資料行或表格名稱的一部分作為 -arrayElement。陣列資料類型不會定義元素名稱，而是接受任何名稱。
如需有關陣列資料類型的詳細資訊，請參閱以下連結。
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
105
相關資訊
Details on arrays in SOAP 1.1 note
XML 驅動程式 - 對應資料行 [第 92 頁]
XML 驅動程式 - 對應主要索引鍵和外部索引鍵 [第 93 頁]
6.6.5
Web 服務驅動程式 - 設定資料行大小上限
6.7
作為排序作業快取使用的本機磁碟
CSV OpenDriver 和 OData、SAP ERP、XML 以及 Web 服務驅動程式可使用本機磁碟作為已排序資料列的快取。
資料存取驅動程式會以下列方法執行排序作業 (ORDER BY、GROUP BY 和 DISTINCT)：
●
如果僅有少量資料需要排序，便會在主記憶體中進行排序
●
在本機磁碟的暫存目錄中寫入資料，以進行排序
當可用的主記憶體太少，或達到使用 Bucket Split Size SBO 參數定義的資料列數時，已排序資料列會寫入磁碟
中。
本機磁碟可作為快取使用，且資料會寫入電腦的預設暫存資料夾。當作業系統未指定暫存資料夾時，您可以在 cs.cfg
檔案中使用 Temp Data Dir 參數來設定目錄路徑。
相關資訊
CSV OpenDriver [第 63 頁]
OData 驅動程式 [第 68 頁]
SAP ERP 驅動程式 [第 81 頁]
XML 驅動程式 [第 87 頁]
106
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料存取驅動程式參考
Web 服務驅動程式 [第 99 頁]
Bucket Split Size [第 170 頁]
Temp Data Dir [第 180 頁]
資料存取指引
資料存取驅動程式參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
107
7
連線參考
7.1
HIVE 和 Impala 連線
下節將描述建立 HIVE 和 Impala 資料庫連線的方式。 在此版本中，您可以同時針對不同版本的 HIVE 和 Impala 資料
庫建立連線。
7.1.1
建立 Apache Hadoop HIVE 的 JDBC 連線
資料存取層可讓 BI 平台透過所有平台上的 JDBC 連線至 Apache Hadoop HIVE 0.7.1、0.8.0、0.9.0 0.10、0.12 以及
0.13 資料庫。
註記
●
Apache Hadoop HIVE 0.7.1、0.8.0、0.9.0、0.10 和 0.12 上均支援 HiveServer1
●
●
Apache Hadoop Hive 驅動程式不支援複雜資料類型
1.
JAR 檔案
0.7.1
hadoop-0.20.1-core.jar 或 hadoop-core-0.20.2.jar
hive-exec-0.70.1.jar
hive-jdbc-0.70.1.jar
hive-metastore-0.70.1.jar
hive-service-0.70.1.jar
libfb303.jar
log4j-1.2.16.jar
commons-logging-1.0.4.jar
slf4j-api-1.6.1.jar
slf4j-log4j12-1.6.1.jar
108
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
Apache Hadoop HIVE 資料庫版
本
JAR 檔案
0.8.0
hadoop-0.20.1-core.jar 或 hadoop-core-0.20.2.jar
hive-exec-0.8.0.jar
hive-jdbc-0.8.0.jar
hive-metastore-0.8.0.jar
hive-service-0.8.0.jar
libfb303.jar
log4j-1.2.16.jar
commons-logging-1.0.4.jar
slf4j-api-1.6.1.jar
slf4j-log4j12-1.6.1.jar
0.9.0
hadoop-0.20.1-core.jar 或 hadoop-core-0.20.2.jar
hive-exec-0.9.0.jar
hive-jdbc-0.9.0.jar
hive-metastore-0.9.0.jar
hive-service-0.9.0.jar
libfb303.jar
log4j-1.2.16.jar
commons-logging-1.0.4.jar
slf4j-api-1.6.1.jar
slf4j-log4j12-1.6.1.jar
0.10.0
hadoop-0.20.1-core.jar 或 hadoop-core-0.20.2.jar
hive-exec-0.10.0.jar
hive-jdbc-0.10.0.jar
hive-metastore-0.10.0.jar
hive-service-0.10.0.jar
libfb303.jar
log4j-1.2.16.jar
commons-logging-1.0.4.jar
slf4j-api-1.6.1.jar
slf4j-log4j12-1.6.1.jar
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
109
Apache Hadoop HIVE 資料庫版
本
JAR 檔案
0.12.0
commons-logging-1.10.1.jar
hadoop-core-1.2.1.jar
hive-exec-0.12.0.jar
hive-jdbc-0.12.0.jar
hive-metastore-0.12.0.jar
hive-service-0.12.0.jar
libfb303-0.9.0.jar
log4j-1.2.16.jar
slf4j-api-1.6.1.jar
slf4j-log4j12-1.6.1.jar
0.12 (Simba JDBC4)
hive_metastore.jar
hive_service.jar
HiveJDBC4.jar
libfb303-0.9.0.jar
libthrift-0.9.0.jar
log4j-1.20.14.jar
ql.jar
slf4j-api-1.50.8.jar
slf4j-log4j12-1.50.8.jar
TCLIServiceClient.jar
0.13 (Simba JDBC4)
hive_metastore.jar
hive_service.jar
HiveJDBC4.jar
libfb303-0.9.0.jar
libthrift-0.9.0.jar
log4j-1.20.14.jar
ql.jar
slf4j-api-1.50.8.jar
slf4j-log4j12-1.50.8.jar
TCLIServiceClient.jar
110
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
Apache Hadoop HIVE 資料庫版
本
JAR 檔案
Amazon EMR 0.11
HiveJDBC4.jar
hive_metastore.jar
hive_service.jar
libfb303-0.9.0.jar
libthrift-0.9.0.jar
log4j-1.20.14.jar
ql.jar
slf4j-api-1.50.8.jar
slf4j-log4j12-1.50.8.jar
TCLIServiceClient.jar
2.
執行連線精靈。
3.
選取您要使用的 Apache Hadoop HIVE 驅動程式版本。
4.
使用精靈來設定連線。
您已建立 Apache Hadoop HIVE 資料庫的連線。
註記
●
從 BI 平台 4.1 建立的連線會繼續在此版本中運作。 Apache Hadoop HIVE 資料庫名稱為 Apache Hadoop
Hive 0.7 的別名。 系統仍會支援 JAR 檔案的 hive 資料夾。
●
相關資訊
JAR 檔案位置參考 [第 52 頁]
7.1.2
建立 Apache Hadoop HIVE 的 ODBC 連線
資料存取層允許 BI 平台使用所有支援平台上的 SAP Hive ODBC 驅動程式經由 ODBC 連線至 Apache Hadoop HIVE
0.12 and 0.13 資料庫。 BOE 用戶端或伺服器安裝完成後，您需要更新主機和連接埠編號詳細資料。 如需詳細資訊，
請參閱 Simba 指南。
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
111
註記
●
[Hive Server2] 僅支援 Apache Hadoop HIVE 0.13。 您必須選擇 [Hive Server2] 作為 ODBC 資料來源管理員中
的 [Hive 伺服器類型]。
●
請參閱 Simba 指南 檢查驗證模式以取得進一步詳細資訊。
Windows 系統
註記
●
建立 DSN 必須使用 SAP Hive ODBC 驅動程式
●
範例 SAP Hive DSN 是位於 [ODBC 資料來源管理員] 的範例 DSN，請參考其以協助進一步設定。
●
●
●
若要變更 [主機] 和 [連接埠] 編號的 ODBCInstLib 資訊，您需要設定 simba.hiveodbc.ini。 如需如何修改
simba.hiveodbc.ini 的詳細資訊，請參閱《Simba ODBC Driver for Hive Install Guide.pdf》
●
●
●
驅動程式的程式庫路徑： &lt;install_directory&gt;/sap_bobj/enterprise_xi40/linux_x64/odbc/
simbahive/1.0/lib 必須設為環境變數 LD_LIBRARY_PATH (LINUX) 或 LIBPATH (AIX)。
●
7.1.3
於平台更新後使用 HIVE 連線
作為一項必要條件，您的生產環境可在 Microsoft Windows 或 UNIX 作業系統上執行 SAP BusinessObjects BI 平台
4.0 支援套件 8 以下的版本。
將平台伺服器或用戶端工具更新至版本 4.1 後，便會解除安裝 Apache Hadoop HIVE 驅動程式。 您必須修改平台安
裝，才能使用 Apache Hadoop HIVE 連線。
下列程序顯示 Microsoft Windows 上的執行步驟。
112
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
1.
在控制面板中尋找 BI 平台最新的完整安裝程式。
記得
您無法在平台程式更新時執行下一步。
2.
按一下滑鼠右鍵，然後選取 [解除安裝/變更]。
3.
在 SAP BusinessObjects BI 平台設定 對話方塊的 應用程式維護 畫面中，選取 [修改]，然後按一下 [下一步]。
4.
在 選取功能 畫面中，選取 [資料庫存取和安全性] 下的 [Hadoop HIVE] 選項。
5.
按一下 [下一步] 完成安裝。
您已在平台上安裝 Apache Hadoop HIVE 驅動程式， 現在可以建立 HIVE 資料庫的連線。
7.1.4
建立與 Amazon EMR HIVE 的 JDBC 連線
資料存取層可讓 BI 平台透過所有平台上的 JDBC 連線至 Amazon Elastic MapReduce (EMR) HIVE 0.7、0.8 和 0.11
資料庫。
1.
將 SSH 通道設為 Amazon 主節點。
如需詳細資訊，請參閱 Amazon 文件。
2.
3.
在連線精靈的 [伺服器 (主機:連接埠)] 欄位中，將伺服器指定為 localhost，並將連接埠指定為 10002。
您已建立 Amazon EMR HIVE 資料庫的連線。
註記
●
從 BI 平台 4.1 建立的連線會繼續在此版本中運作。 Amazon EMR HIVE 資料庫名稱為 Amazon EMR Hive
0.7 的別名， 系統仍會支援 JAR 檔案的 hive 資料夾。
●
[HiveServer1] 是唯一支援 Amazon EMR Hive 0.11 的伺服器。
相關資訊
建立通往主節點的 SSH 通道
HIVE 0.7.1 JAR 檔案下載網站
HIVE 0.8.1 JAR 檔案下載網站
JAR 檔案位置參考 [第 52 頁]
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
113
7.1.5
建立 Amazon EMR HIVE 的 ODBC 連線
資料存取層允許 BI 平台使用所有支援平台上的 SAP Hive ODBC 驅動程式經由 ODBC 連線至 Amazon EMR Hive 0.11
資料庫。 BOE 用戶端或伺服器安裝完成後，您需要更新主機和連接埠編號詳細資料。 如需詳細資訊，請參閱 Simba
指南。
7.1.6
建立 Cloudera Impala 的 JDBC 連線
Cloudera Impala 1.0 Simba JDBC4 驅動程式作為 BI 平台的一部份安裝在 &lt;connectionserver-install-dir&gt;
\connectionServer\jdbc\drivers\impala10simba4 目錄中。 您不需要執行其他組態，即可建立 Cloudera Impala 資
料庫的連線。
Impala 1.0 資料庫支援下列 JAR 檔案：
表格 7：
Cloudera Impala 資料庫版本
JAR 檔案
Impala 1.0 (Simba JDBC4)
hive_metastore.jar
hive_service.jar
ImpalaJDBC4.jar
libfb303-0.9.0.jar
libthrift-0.9.0.jar
log4j-1.20.14.jar
ql.jar
slf4j-api-1.50.8.jar
slf4j-log4j12-1.50.8.jar
TCLIServiceClient.jar
114
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
7.1.7
建立與 Cloudera Impala 的 ODBC 連線
此版本支援 SAP Impala ODBC 驅動程式。 BOE 用戶端或伺服器安裝完成後，您需要變更主機和連接埠編號詳細資料
以連線至對應的 Impala 伺服器。 如需詳細資訊，請參閱 Simba 指南。
註記
●
請參閱 Simba 指南，檢查驗證模式及執行必要變更
●
範例 SAP Impala DSN 位於 [ODBC 資料來源管理員]
●
●
驅動程式特定程式庫的路徑： &lt;BIP_INSTALL_DIR&gt;\&lt;Platform&gt;\odbc\simbaimpala\1.0\lib
●
Simba ODBC Driver for Impala Install Guide.pdf 位於： &lt;BIP_INSTALL_DIR&gt;\&lt;Platform&gt;
\odbc\simbaimpala\1.0\help
UNIX 系統上的 Impala ODBC 組態
●
若要變更 [主機] 和 [連接埠] 編號的 ODBCInstLib 資訊，您需要設定 simba.impalaodbc.ini。 如需如何修改
simba.impalaodbc.ini 的詳細資訊，請參閱《Simba ODBC Driver for Impala Install
Guide.pdf》
●
ODBC 驅動程式的驅動程式特定程式庫路徑： &lt;install_directory&gt;/sap_bobj/enterprise_xi40/
&lt;Platform&gt;/odbc/simbaimpala/1.0/lib
●
驅動程式的程式庫必須設為環境變數 LD_LIBRARY_PATH (LINUX) 或 LIBPATH (AIX)
●
simba.impalaodbc.ini 的路徑： &lt;install_directory&gt;/sap_bobj/enterprise_xi40/
simbaimpala/conf
●
將環境變數 SIMBAINI、ODBCINI 設為 simba.impalaodbc.ini 檔案 (包含檔案名稱) 所在的路徑。
例如： 匯出 SIMBAINI= &lt;install_directory&gt;/sap_bobj/enterprise_xi40/simbaimpala/conf/
simba.impalaodbc.ini
●
Simba ODBC Driver for Impala Install Guide.pdf 的路徑： &lt;install_directory&gt;/sap_bobj/
enterprise_xi40/&lt;Platform&gt;/odbc/simbaimpala/1.0/help
7.2
IBM DB2 連線 - 對應到 Null 的參考索引鍵
限制
由於資料庫驅動程式限制，z/OS 資料庫表格的 IBM DB2 10 的參考索引鍵名稱會對應到 NULL。
7.3
下列各節將說明當 IBM Informix 連線發生問題時要執行的動作。
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
115
7.3.1
在資訊設計工具中，如果用戶端工具和伺服器位於不同時區，使用 JDBC 的 IBM Informix Dynamic Server 11 查詢可
能會傳回錯誤的日期類型值。 若要避免此問題，您必須將 JVM 的時區值設為在資料庫伺服器層級上設定的相同時區。
1.
結束資訊設計工具。
2.
移至 &lt;bip-install-dir&gt;\win32_x86 目錄。
3.
4.
在檔案的結尾加上下列行：
-Duser.timezone=&lt;server_timezone_value&gt;
其中 &lt;server_timezone_value&gt; 是資料庫伺服器上所設定的時區值。 例如： GMT。
5.
儲存檔案。
6.
重新啟動應用程式。
當您完成此工作時，即可正確設定使用 JDBC 的 IBM Informix 資料庫連線。
7.3.2
依預設，資料存取層允許以異動區塊形式執行 SQL 運算。 如果 Informix Dynamic Server 不支援異動，連線可能會失
敗。 若要避免此問題，請指定無法使用異動模式時的驅動程式組態檔案。
1.
結束用戶端工具。
2.
3.
4.
儲存檔案。
5.
重新啟動服務和應用程式。
相關資訊
Transactional Available [第 181 頁]
116
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
7.4
透過 XMLA 連線至 MS Analysis Services 不使用「連線伺服器」。
本節只和要建立在資訊設計工具中的連線相關。
在資訊設計工具中，使用者可透過 XMLA 驅動程式利用 HTTP 連線至 MS Analysis Services。
要設定這些連線，您必須先啟用 HTTP 存取。如需詳細資訊，請參閱 Microsoft TechNet 網站。
7.5
MS SQL Server 連線
下列章節提供 SQL Server 連線的相關資訊。
相關資訊
MS SQL Server OLE DB 連線的同義資料表支援 [第 117 頁]
同義資料表的資料行不會顯示於報表工具。
在 UNIX 上設定 MS SQL Server 連線的 JVM 選項 [第 118 頁]
在 UNIX 上安裝 MS SQL Server 的 JDBC 驅動程式並設定 jdbc.sbo 檔案後，便可設定 cs.cfg 檔案中的 JVM 資
訊。
7.5.1
MS SQL Server OLE DB 連線的同義資料表支援
同義資料表的資料行不會顯示於報表工具。
MS SQL Server Native Client 中介軟體不支援同義資料表資料行的中繼資料。因此透過 OLE DB 連線時，語意層設計
工具或資訊設計工具中不會顯示 MS SQL Server 資料庫的同義資料表資料行。
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
117
7.5.2
在 UNIX 上設定 MS SQL Server 連線的 JVM 選項
開啟 cs.cfg 檔案進行編輯。
2.
將下列檔案路徑新增至 JavaVM 區段，以覆寫預設 JVM 組態：
&lt;LibraryName JNIVersion=&quot;JNI_VERSION_1_4&quot;&gt;$BOBJEDIR/jdk/jre/lib/i386/server/
libjvm.so&lt;/LibraryName&gt;
3.
將下列其中一個選項新增至 JavaVM 區段：
選項
描述
Solaris 或 Linux
&lt;Options&gt;
&lt;Option&gt;-Xmx512m&lt;/Option&gt;
&lt;/Options&gt;
AIX
&lt;Options&gt;
&lt;Option&gt;-Xmx511m&lt;/Option&gt;
&lt;/Options&gt;
註記
在 Solaris 或 Linux 上的 Java 虛擬機器可允許 512 MB 或更高，但在 AIX 上則不得超過 511 MB。
4.
儲存檔案。
相關資訊
JVM 設定 [第 146 頁]
7.6
Oracle 連線
下節將會提供有關 Oracle 連線的組態資訊。
118
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
相關資訊
Oracle 伺服器叢集的連線 [第 119 頁]
設定 Oracle CURSOR_SHARING 參數值 [第 119 頁]
7.6.1
Oracle 伺服器叢集的連線
系統支援經由 JDBC 連線至在容錯移轉模式下工作的 Oracle 伺服器叢集。驅動程式會選擇其中一部伺服器，如果該伺
服器無法使用用，則使用下一部伺服器。如果所有伺服器均無法使用，則會產生連線錯誤。
在連線精靈的 [伺服器 (主機:連接埠{,主機:連接埠})] 中輸入用分號加以分隔的伺服器主機和連接埠，以建立 JDBC 連
線。如果您想要利用容錯移轉機制，請輸入單一伺服器或多重伺服器的資訊。
7.6.2
設定 Oracle CURSOR_SHARING 參數值
Oracle 10 及更高版本的資料庫使用 CURSOR_SHARING 參數。 BI 平台和 BusinessObjects 報表工具僅支援
CURSOR_SHARING 的 EXACT 值。
如果您使用 FORCE 值，可能會導致報表工具的某些效能問題。
1.
執行下列其中一項作業：
選項
描述
設定語意層連線的
1.
開啟語意層連線以進行編輯。
CURSOR_SHARING 值
2.
按一下 [下一步] 移至 自訂參數 畫面。
3.
按一下 [新增參數]。
4.
輸入 ConnectInit，然後按一下 [確定]。
5.
設定所有 Oracle 連線的
6.
按一下 [完成]。
1.
CURSOR_SHARING 值
\connectionServer\Oracle。
2.
在 XML 編輯器中開啟該檔案。
3.
在 Configuration 區段下新增下列參數：
&lt;Parameter Name=&quot;CURSOR_SHARING&quot;&gt;EXACT&lt;/Parameter&gt;
4.
儲存檔案。
5.
從 CMC 重新啟動連線和報表服務。
註記
如需有關 CURSOR_SHARING 的定義，請參閱 Oracle 文件。
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
119
7.6.3
限
MySQL 連線 - 資訊設計工具中部份工作流程所需的資料庫權
在資訊設計工具 (以 MySQL JDBC 連線為基礎) 中使用語意層時，若資料基礎包含表格 (以 MySQL 資料庫中的檢視為
基礎)，則使用者需要 SHOW VIEW 或此檢視的資料庫授與的相等權限。
若未授與權限，則當資訊設計工具使用者進行特定工作流程時，可能會接收到資料庫異常 (SHOW VIEW 命令遭拒)，
例如顯示值或偵測索引鍵。
7.6.4 以挪威文 (巴克摩) 介面語言於資訊設計工具中使用 Oracle
JDBC 連線
若要以挪威文 (巴克摩) 介面語言於資訊設計工具中使用 Oracle JDBC 連線，您需要針對
InformationDesignTool.ini 檔案進行下列變更以設定預設地區設定。
1.
結束資訊設計工具。
2.
註記
以安裝 BI 平台的目錄路徑取代 &lt;BIP_INSTALL_DIR&gt;。
3.
4.
重新啟動資訊設計工具。
5.
於資訊設計工具中執行下列步驟以將產品語言設為 [預設地區設定]：
a) 從資訊設計工具主功能表依序選取
[視窗]
[偏好設定] 。
b) 在 [偏好設定] 對話方塊中，展開 [資訊設計工具] 節點並選取 [語言]。
c) 選取 [產品語言] 清單中的 [預設地區設定]。
[預設地區設定] 應為 [挪威文、巴克摩 (挪威)]。 請確認您未選取產品語言 [挪威文、巴克摩]。
d) 按一下 [確定]。
6.
結束並重新啟動資訊設計工具，使語言變更生效。
7.7
Oracle EBS 連線
120
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
當在語意層設計工具或資訊設計工具中建立連線時，您應先選擇驗證模式，若應用程式使用者在登入 BI 平台時提供使
用者名稱和密碼，此為使用者提供；若使用者使用 Oracle EBS 憑證登入，則為單一登入。接著，您選擇 Oracle EBS
應用程式、責任及安全性群組，這些選項可定義語意層的資料來源。
BI 平台會借助驗證 Plugin 為 Oracle EBS 提供 SSO。安裝 Plugin 並正確設定之後，便會啟用 SSO。SSO 可讓應用程
式使用者使用 Oracle EBS 憑證登入 BI Launch Pad。「連線伺服器」會使用相同的憑證以存取 Oracle EBS 資料來
源。如需有關驗證 Plugin 的詳細資訊，請參閱《SAP BusinessObjects Business Intelligence 平台管理員指南》。
7.8
Oracle Essbase 連線
警告
由於 .unv 語意層的 ESSJAPI 中介軟體限制，BI 平台伺服器需要特定部署以支援以 Oracle Essbase 11 為基礎
的 .unv 和 .unx 語意層。若要部署伺服器以支援 .unv 和 .unx Essbase 語意層，請在兩部不同的電腦上使用下列
兩個叢集設定系統：
●
在 64 位元環境中的第一個叢集 (叢集 1) 上安裝下列軟體：64 位元 BI 平台、中央管理伺服器、Web
Intelligence 伺服器、64 位元連線伺服器和所有 64 位元中介軟體驅動程式。
●
在 32 位元環境中，於第二個叢集 (叢集 2) 上安裝下列軟體：32 位元連線伺服器和 32 位元中介軟體驅動程式
(包括 .unv 語意層的 32 位元 Essbase 驅動程式)。
在執行時，連線伺服器將叢集 2 用於 .unv 語意層。服務於 .unx 語意層的 OLAP 用戶端使用叢集 1 中可用的 64 位
元中介軟體。
7.9
Oracle RAC 連線
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
121
若要使用連線精靈從您的應用程式建立連線，您必須提供 Oracle RAC 資料來源項目，其格式如下：
&lt;host&gt;:&lt;port&gt;,&lt;host&gt;:&lt;port&gt;,...,&lt;host&gt;:&lt;port&gt;
主機與連接埠配對的數目取決於叢集中相關的機器數目。
範例
pmrac1.us.oracle.com:1521,pmrac2.us.oracle.com:1521
7.10 salesforce.com 連線 - 設定環境
您必須先設定環境以便讓 salesforce.com 連線在語意層設計工具或資訊設計工具兩者之一中得以運作。
1.
從 CMC 和用戶端應用程式停止連線能力服務。
2.
3.
依序移至
[HKEY_LOCAL_MACHINE]
&lt;[&lt;SALESFORCE_DSN_NAME&gt;]&gt;
[SOFTWARE]
[ODBC]
salesforce.com 資料來源名稱。
4.
以滑鼠右鍵按一下資料來源名稱，然後依序選取
5.
輸入 CheckJVMChanged。
6.
按兩下屬性並輸入 0。
7.
關閉登錄編輯器。
[新增]
[字串值] 。
您必須遵循以下步驟以完成組態設定。
相關資訊
使 salesforce.com 連線在資訊設計工具中運作 [第 122 頁]
使 salesforce.com 連線在語意層設計工具中得以運作 [第 123 頁]
7.10.1
使 salesforce.com 連線在資訊設計工具中運作
1.
結束資訊設計工具。
2.
3.
移至 &lt;bip-install-dir&gt;\win32_x86 目錄。
4.
122
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
5.
在檔案的結尾加上下列行：
-Dosgi.parentClassloader=ext
6.
儲存檔案。
7.
重新啟動應用程式。
當您完成此工作，即可正確設定 salesforce.com 的連線。
7.10.2 使 salesforce.com 連線在語意層設計工具中得以運作
1.
結束語意層設計工具。
2.
開啟 cs.cfg 檔案進行編輯。
3.
4.
儲存檔案。
5.
6.
7.
儲存檔案。
8.
重新啟動服務和應用程式。
當您完成此工作，即可正確設定 salesforce.com 的連線。
相關資訊
Transactional Available [第 181 頁]
7.11
資料存取層可讓 BI 平台存取 SAP BW 資料來源。
透過 BAPI 的 SAP BW 連線為 OLAP 連線。
此目前版本允許您在 32 位元或 64 位元的 MS Windows 和 64 位元的 UNIX 類別上建立以 SAP BW 為基礎的 .unv 語
意層。
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
123
SAP BW 連線可與 32 位元作業系統的 32 位元連線伺服器或 64 位元作業系統的 64 位元連線伺服器一同運作。
7.11.1
啟用 SAP BW 64 位元連線
您可以使用包含 64 位元連線伺服器的 SAP BW 連線來建立 .unv 語意層。
您可在 64 位元 Microsoft Windows 的 SAP BusinessObjects BI 平台上安裝 SAP BW 64 位元驅動程式。
請根據您所執行的安裝類型依循下列步驟：
○
如果您執行此版本的完整安裝，SAP BW 連線便會使用 64 位元連線伺服器。
○
如果您執行現有平台的更新程式安裝，SAP BW 連線便會繼續使用 32 位元連線伺服器。 若要使用 64 位元連
線伺服器，請修改平台的安裝：
a) 在控制面板中尋找 BI 平台最新的完整安裝程式。
記得
您無法在平台程式更新時執行下一步。
b) 按一下滑鼠右鍵，然後選取 [解除安裝/變更]。
c) 在 SAP BusinessObjects BI 平台設定 對話方塊的 應用程式維護 畫面中，選取 [修改]，然後按一下 [下一步]。
d) 在 選取功能 畫面中，選取 [資料庫存取] 底下的 [SAPBW64] 選項。
e) 按一下 [下一步] 完成安裝。
您已經在平台上安裝 SAP BW 64 位元驅動程式， 現在可以建立 SAP BW 連線 (在 64 位元 Microsoft Windows 上使用
64 位元連線伺服器)。
7.13 SAP HANA 連線
資料存取層允許 BI 平台使用所有平台上的 ODBC 和 JDBC 連線至 SAP HANA 資料庫 1.0 SPS 08。 目前的版本也支援
MS Windows、Linux 和 AIX 上 SAP HANA 資料庫的 OLAP 連線。
124
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
陣列擷取大小
對於 SAP HANA 連線，[陣列擷取大小] 預設值為 1000。
警告
由於更大數目的 [陣列擷取大小] 需要更多記憶體，此設定可能會影響系統效能。
容錯移轉
系統支援經由 ODBC 和 JDBC 連線至在容錯移轉模式下工作的 SAP HANA 伺服器叢集。 驅動程式會選擇其中一部伺
服器，如果該伺服器無法使用用，則使用下一部伺服器。 如果所有伺服器均無法使用，則會發生連線錯誤。
慣用的檢視地區設定
SAP HANA 連線能力支援經由 JDBC 和 ODBC 之所有驗證模式的慣用的檢視地區設定 (PVL)。 如果資料庫以不同語言
儲存資料，則 PVL 可讓使用者擷取當地語系化資料。
單一登入至資料庫
BI 平台可在 MS Windows 和 Linux 平台上，使用 Windows AD 及 Kerberos 或 SAML 通訊協定提供單一登入
(SSO)。 Kerberos 的 SSO 可供 JDBC 和 ODBC 連線使用。 SAML 的 SSO 可供 JDBC 使用，但 ODBC 無法使用。
如果 Kerberos 和 SAML 實作皆可供您的環境使用，則平台會優先使用 SAML。 如果使用 SAML 時發生任何問題，則
平台會改用 Kerberos。 此邏輯對應用程式使用者而言顯而易見。 若要停用 SAML，請在適當的 newdb.sbo 組態檔案
中將 Skip SAML SSO 參數設為 True。
BI 平台也可在 OLAP 連線中使用 Windows AD 及 Kerberos 或 SAML 通訊協定提供資料庫的 SSO。
一旦使用者從 SAP BusinessObjects 應用程式登入 BI 平台，便可執行需要資料存取的動作 (如重新整理 Web
Intelligence 文件)，而無須提供其資料庫憑證。
UNIX 支援
從 4.1 版開始，資料存取層允許 BI 平台透過 64 位元 UNIX 平台上的 ODBC 連線至 SAP HANA 資料庫。
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
125
使用 SSL
SAP HANA 的關聯式和 OLAP 連線可以使用 SSL 通訊協定。
相關資訊
Skip SAML SSO [第 178 頁]
7.13.1
建立 SAP HANA 連線
單一伺服器
在 [主機名稱] 和 [執行個體編號] 欄位中輸入 HANA 主機名稱和執行個體編號。
●
多重伺服器 (容錯)
在 [伺服器 (主機:連接埠{;主機:連接埠})] 中輸入用分號加以分隔的伺服器主機和連接埠。 如果您想要利用容錯移
轉機制，請輸入單一伺服器或多重伺服器的資訊。
連接埠編號的慣例如下所示：
3##15
其中，## 為 HANA 執行個體編號。
範例
如果您正在連線至執行個體 0，請在精靈中輸入執行個體編號 00 或連接埠編號 30015。 如果您正連線至執行個體
1，請輸入執行個體編號 01 或連接埠編號 30115。
使用 SSL
在連線精靈中選取 [使用 SSL] 以建立使用 SSL 通訊協定連線至 SAP HANA 伺服器的 OLAP 或 JDBC 連線。
註記
若要在 MS Windows 上使用 ODBC 中的 SSL，請開啟 ODBC 資料來源管理員，然後在設定 DSN 時選取 [SSL]。
126
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
相關資訊
建立 JDBC 連線 [第 48 頁]
7.13.2 編輯 SAP HANA 連線
已開啟進行編輯的 SAP HANA 連線會顯示在連線精靈中的 [單一伺服器] 或 [多重伺服器 (容錯)] 下方。若要編輯連
線，請執行下列其中一項作業：
●
如果連線顯示在 [單一伺服器] 中，請修改資料來源的主機名稱和執行個體編號。
●
如果連線顯示在 [多重伺服器 (容錯)] 中，請修改伺服器主機和連接埠。
相關資訊
針對資訊設計工具設定 SAP HANA 的單一登入 [第 127 頁]
針對 Web Intelligence 設定 SAP HANA 的單一登入 [第 128 頁]
針對 Web Intelligence 豐富型用戶端設定 SAP HANA 的單一登入 [第 129 頁]
在設定 SAP HANA 連線的單一登入之前 [第 127 頁]
7.13.4 針對資訊設計工具設定 SAP HANA 的單一登入
下列步驟可讓您從資訊設計工具透過 JDBC 單一登入 SAP HANA 資料庫。
1.
執行下列其中一項作業：
選項
描述
設定本機連
線透過
1.
結束資訊設計工具。
2.
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
127
選項
JDBC 的
SSO
描述
其位於 &lt;bip-install-dir&gt;\win32_x86 目錄中。
3.
加入下列這些程式行：
設定位於
CMS 上的連
線透過
JDBC 的
SSO
4.
儲存檔案。
5.
重新啟動資訊設計工具。
目的在於設定調適連線能力服務。
1.
開啟 CMC。
2.
在 連線能力服務 下，停止由調適處理伺服器主控的調適連線能力服務。
3.
移至 屬性 頁面。
4.
將下列選項新增至 命令列參數 屬性：
按一下 [儲存]。
6.
從 CMC 重新啟動服務。
記得
您也需要設定調適連線能力服務，以在連線模式中啟用 Web Intelligence 豐富型用戶端的 SSO。 這些步驟
還可讓您設定所有其他 Java 服務的 SSO，如資料聯邦服務。 查詢建立在 SAP HANA 連線上已啟用多來源
的語意層時，您可使用資料聯邦服務。
7.13.5 針對 Web Intelligence 設定 SAP HANA 的單一登入
下列步驟可讓 SAP BusinessObjects Web Intelligence 透過 JDBC 單一登入至 SAP HANA 資料庫。
註記
此程序適用於應用程式使用者從 BI Launch Pad 啟動之 SAP BusinessObjects Web Intelligence 的 Java 或 HTML
介面。
記得
此組態僅會指定 Web Intelligence 處理伺服器主控的 Web Intelligence 報表服務的位址。
1.
開啟 CMC。
2.
在 Web Intelligence 服務 下，停止 Web Intelligence 處理伺服器主控的報表服務。
3.
開啟 cs.cfg 檔案進行編輯。
128
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
4.
5.
儲存檔案。
6.
從 CMC 重新啟動服務。
相關資訊
JVM 設定 [第 146 頁]
7.13.6 針對 Web Intelligence 豐富型用戶端設定 SAP HANA 的單
一登入
下列步驟可讓您從 Web Intelligence 豐富型用戶端應用程式透過 JDBC 單一登入至 SAP HANA 資料庫。
遵循下列其中一項程序：
○
如果您從 WID 文件或從 Windows [開始] 功能表連線至 Web Intelligence 豐富型用戶端：
1.
關閉文件並結束 Web Intelligence 豐富型用戶端。
2.
建立下列環境變數：
○
○
其中 &lt;location&gt; 為執行連線伺服器的電腦上的組態檔案目錄。
3.
○
重新啟動 Web Intelligence 豐富型用戶端。
如果您在連線模式下從 BI Launch Pad (也稱為 HTTP 模式) 使用 Web Intelligence 豐富型用戶端，則必須設
定調適連線能力服務。 依照所述步驟設定資訊設計工具的單一登入。
相關資訊
針對資訊設計工具設定 SAP HANA 的單一登入 [第 127 頁]
7.13.7
設定使用 SAP HANA 連線檢測的 Java 虛擬電腦
若 CA Wily Introscope 和 BI 平台一併安裝，您便可監控 SAP HANA 驅動程式的活動。 此檢測可針對透過 ODBC 和
JDBC 的 SAP HANA 連線提供端對端的追蹤支援。
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
129
依預設會在平台中啟用 SAP HANA 追蹤， 但您仍須設定 Java 虛擬機器以使用 JNI 橋接器。
1.
開啟 cs.cfg 檔案進行編輯。
2.
將下列 JAR 檔案路徑新增至 JavaVM 區段，以便載入必要的類別：
&lt;ClassPath&gt;
&lt;Path&gt;&quot;&lt;bip-install-dir&gt;\java\lib\TraceLog.jar;&lt;bip-install-dir&gt;\java\lib
\external\com.sap.js.passport.api.jar&quot;
&lt;/Path&gt;
&lt;/ClassPath&gt;
3.
4.
儲存檔案。
5.
6.
以 Introscope Agent 的主機名稱取代下列行中的 localhost：
introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=localhost
7.
儲存檔案。
相關資訊
JVM 設定 [第 146 頁]
7.14 SAP MaxDB 連線
在 ODBC 上，確定使用的是 SAP MaxDB ODBC 驅動程式版本 7.7.07 (組建編號 07 或以上版本)。SAP MaxDB 為 MS
Windows 和 UNIX 提供 ASCII 和 Unicode 驅動程式。 ASCII 版本的 ODBC 驅動程式會一律透過 ASCII 連線至資料庫
核心。 Unicode 版本的 ODBC 驅動程式會透過 ASCII 連線至資料庫核心，並透過 UCS2 連線至 Unicode 資料庫核
心。
SAP MaxDB 在 UNIX 上不需要特定的驅動程式管理員。不過，必要時可將其設定為使用下列驅動程式管理員。
●
unixODBC 2.0.9 或以上版本
●
iODBC 3.0.5 或以上版本
在 JDBC 上，請務必使用最新版的 sapdbc.jar 驅動程式。如需 SAP MaxDB JDBC 驅動程式的詳細資訊，請參閱
maxdb.sbo 組態檔。
130
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
7.15 SAP BW 連線
請勿使用「連線伺服器」進行關聯式連線至 SAP BW。 這些連線會經過專屬的連接器，並在 SAP BW 中使用特定的表
面。
如需如何設定和調整 SAP BW 連線的詳細資訊，請參閱《資料聯邦管理工具指南》。
7.15.1
Data Federator 與 SAP BW 之間的連線需求
若要連線至 SAP BW，您必須擁有相容的 SAP BW 版本，以及適當的 SAP 註記：
●
基本所需的版本為 SAP BI 7.01 SP06。
註記
各版本間的 SAP BW 官方名稱會有所變更。 7.3 之前版本的官方名稱皆為 SAP BI。
●
。
7.15.2 在資訊設計工具中使用 SAP BW 連線的需求
若 SAP Gateway 允許，則外部應用程式 (例如：資訊設計工具) 便可連線至 SAP BW。
若要使資訊設計工具中的連線運作，則請確定已正確設定外部程式的 SAP Gateway 安全性設定。 如需詳細資訊，請參
閱 SAP Gateway 線上文件。
7.15.3 在 SAP BW 上存取已啟用多來源語意層的需求
應用程式使用者需要授權，以存取依據 SAP BW 資料庫的多來源語意層。
如需查詢和報表應用程式使用者所需的授權資訊，以存取 SAP BW 上的多來源語意層，請參閱 SAP 註記 #1465871。
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
131
相關資訊
SAP 註記 #1465871
7.16 SAS 連線
SAS 連線不使用「連線伺服器」。它們使用 SAS/SHARE 資料集的合適 JDBC 連接器。
若要設定這些連線，您必須安裝相容的 JDBC 驅動程式。
如需有關設定 SAS 連接器的詳細資訊，請參閱《資料聯邦管理工具指南》。
7.16.1
安裝 SAS 連線的驅動程式
7.17
Teradata 連線 - 將 Teradata 資料庫對應至目前擁有人
下節會提供有關 Teradata 連線的組態資訊。
Teradata 資料庫支援表格擁有人，但不支援限定詞。 連線伺服器會傳回目前的使用者作為 Teradata 資料來源的目前
擁有人。 不過，可能會將資料來源設定為將使用者對應至其他使用者的資料庫。 在這種情況下，您可以設定 Teradata
驅動程式以透過 Replace Current Owner With Database 參數將目前擁有人對應至資料庫。 進行 ODBC 連線
時，您只能使用此參數。
132
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
連線參考
資料存取指引
連線參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
133
8
建立連線至 Data Federator XI 3.0 查詢伺服器
8.1
關於 Data Federator XI 3.0 查詢伺服器連線
您可以建立連線至部署於 Data Federator XI 3.0 查詢伺服器的表格，以便透過 SAP BusinessObjects 應用程式使用這
些表格。
本章將說明您必須針對 Data Federator XI 3.0 查詢伺服器和「連線伺服器」進行的組態設定，以建立連線。
您僅能使用語意層設計工具來建立與 Data Federator XI 3.0 查詢伺服器的連線。 本章也將指示您必須針對連線精靈進
行的組態，以建立連線。
JDBC 連線
建立 JDBC 連線不需進行額外設定。 您能夠設定隨附於 SAP BusinessObjects Business Intelligence 平台 4.0 的
Data Federator JDBC 驅動程式，以便同時順暢地執行該驅動程式與 Data Federator XI 3.0 查詢伺服器。
ODBC 連線
若是使用 ODBC 連線，組態則取決於所使用的 SAP BusinessObjects 應用程式。 如果要建立連線以搭配 Web
Intelligence 豐富型用戶端 使用，程序則有不同。
相關資訊
設定連線精靈以使用 Data Federator JDBC 或 ODBC 連線 [第 135 頁]
關於 Data Federator XI 3.0 查詢伺服器連線 [第 134 頁]
使用 Data Federator ODBC 中介軟體設定 Web Intelligence 豐富型用戶端連線 [第 137 頁]
134
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線至 Data Federator XI 3.0 查詢伺服器
8.2
設定連線精靈以使用 Data Federator JDBC 或 ODBC 連線
建立連線至 Data Federator XI 3.0 查詢伺服器時，必須具備以下資訊。 請連絡 Data Federator 管理員以取得這些詳
細資料：
●
執行 Data Federator 查詢伺服器的伺服器名稱和連接埠
●
Data Federator 查詢伺服器上的目錄名稱
在連線精靈中，您可以輸入此項作為所要連線之資料庫名稱。
●
Data Federator 查詢伺服器安裝的驗證詳細資料，其服務您所要連線的目錄
8.3
設定 Data Federator ODBC 連線
本節包含 Data Federator XI 3.0 查詢伺服器的其他設定，以及 ODBC 連線至所有 SAP BusinessObjects 應用程式
(Web Intelligence 豐富型用戶端除外) 時「連線伺服器」的組態變更。
本節所述的組態詳細資料是參照以下路徑：
●
&lt;data-federator-drivers-install-dir&gt;\OaJdbcBridge： Data Federator ODBC 中介軟體的安裝根目
●
&lt;data-federator-drivers-install-dir&gt;\JdbcDriver： Data Federator JDBC 中介軟體的安裝根目
錄。 您的管理員在執行 Data Federator 驅動程式安裝程式時會選擇此目錄。
錄。 您的管理員在執行 Data Federator 安裝程式時會選擇此目錄。
●
註記
使用 XML 編輯器編輯檔案，確定檔案格式正確。 在您進行下面顯示的組態變更之後，請重新啟動您的系統，使變
更生效。
相關資訊
設定 Data Federator ODBC 中介軟體 [第 136 頁]
設定連線伺服器使用 Data Federator ODBC 連線 [第 136 頁]
資料存取指引
建立連線至 Data Federator XI 3.0 查詢伺服器
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
135
8.3.1
設定 Data Federator ODBC 中介軟體
註記
本主題適用於所有使用連線伺服器的 SAP BusinessObjects 應用程式，但不包含 Web Intelligence 豐富型用戶端。
若要設定 Data Federator ODBC 中介軟體，您需要修改 openrda.ini 檔案。 此檔案安裝於下列目錄中：
●
&lt;data-federator-drivers-install-dir&gt;\OaJdbcBridge\bin\iwinnt
按照以下方式設定 [JavaIp] 區段的參數：
●
CLASSPATH=&lt;data-federator-drivers-install-dir&gt;\OaJdbcBridge\oajava\oasql.jar;&lt;datafederator-drivers-install-dir&gt;\JdbcDriver\thindriver.jar;&lt;bo-install-dir&gt;\SAP
BusinessObjects Enterprise XI 4.0\java\lib\ConnectionServer.jar
●
JVM_DLL_NAME=&lt;bo-install-dir&gt;\javasdk\jre\bin\client\jvm.dll
●
註記
檢查 openrda.ini 檔案以確認此路徑不是使用 Djava.endorsed.dirs 參數來設定。 如果是，則您必須從
Djava.endorsed.dirs 參數移除此路徑。
8.3.2
設定連線伺服器使用 Data Federator ODBC 連線
136
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線至 Data Federator XI 3.0 查詢伺服器
8.4 使用 Data Federator ODBC 中介軟體設定 Web Intelligence
豐富型用戶端連線
建立 Web Intelligence 豐富型用戶端連線以使用 Data Federator ODBC 中介軟體時，您必須進行本節所述的組態變
更。 沒有正確的組態修正，連線會產生錯誤。 此類型的連線僅受 Windows 環境支援。
記得
下列詳細資訊只與 Web Intelligence 豐富型用戶端相關。
若要建立使用 Data Federator ODBC 中介軟體的連線，您需要修改下列組態：
●
ODBC 中介軟體
●
連線伺服器
●
Windows 豐富型用戶端登錄機碼
本節所述的組態詳細資料是參照以下路徑：
●
&lt;data-federator-drivers-install-dir&gt;\OaJdbcBridge： Data Federator ODBC 中介軟體的安裝根目
錄。 您的管理員在執行 Data Federator 驅動程式安裝程式時會選擇此目錄。
●
&lt;data-federator-drivers-install-dir&gt;\JdbcDriver： Data Federator JDBC 中介軟體的安裝根目
錄。 您的管理員在執行 Data Federator 安裝程式時會選擇此目錄。
●
註記
使用 XML 編輯器編輯檔案，確定檔案格式正確。
相關資訊
使用 Data Federator ODBC 中介軟體設定 Web Intelligence 豐富型用戶端連線 [第 137 頁]
設定連線伺服器使用 Web Intelligence 豐富型用戶端連線至 Data Federator [第 138 頁]
設定 Windows RichClient 登錄機碼 [第 138 頁]
針對 Data Federator 的 Web Intelligence 豐富型用戶端或語意層設計工具連線設定連線伺服器 [第 139 頁]
8.4.1 針對 Web Intelligence 豐富型用戶端的連線設定 Data
Federator ODBC 中介軟體
若要設定 Data Federator ODBC 中介軟體，您需要修改 openrda.ini 檔案。 此檔案安裝於下列目錄中：
●
&lt;data-federator-drivers-install-dir&gt;\OaJdbcBridge\bin\iwinnt
若要設定 openrda.ini 檔案，請按照以下方式設定 [JavaIp] 區段中的參數：
資料存取指引
建立連線至 Data Federator XI 3.0 查詢伺服器
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
137
●
CLASSPATH=&lt;data-federator-drivers-install-dir&gt;\OaJdbcBridge\oajava\oasql.jar;&lt;datafederator-drivers-install-dir&gt;\JdbcDriver\thindriver.jar;&lt;bo-install-dir&gt;\SAP
BusinessObjects Enterprise XI 4.0\java\lib\ConnectionServer.jar
●
JVM_DLL_NAME=&lt;bo-install-dir&gt;\javasdk\jre6\bin\client\jvm.dll
註記
Web Intelligence 豐富型用戶端需要 JDK 6。
●
註記
檢查 openrda.ini 檔案以確認此路徑不是使用 Djava.endorsed.dirs 參數來設定。 如果是，則您必須從
Djava.endorsed.dirs 參數移除此路徑。
8.4.3
設定 Windows RichClient 登錄機碼
若要修改 Windows 豐富型用戶端登錄機碼，請使用像 regedit 之類的工具。
1.
在登錄中，找到 HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Suite XI 4.0\default
\WebIntelligence\RichClient 機碼的位置。
2.
3.
在此機碼的 classpath 項目中新增下列值。 一如所有的登錄機碼值，這些值必須以分號分隔。
○
&lt;data-federator-drivers-install-dir&gt;\OaJdbcBridge\oajava\oasql.jar
○
&lt;data-federator-drivers-install-dir&gt;\JdbcDriver\thindriver.jar
在 RichClient\JVMOptions 機碼中，將下列值新增至第 6 個項目 (如果已存在五個項目)：
○
138
ODBCMode=true
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
建立連線至 Data Federator XI 3.0 查詢伺服器
8.4.4 針對 Data Federator 的 Web Intelligence 豐富型用戶端或
語意層設計工具連線設定連線伺服器
您可以使用單一組態，從語意層設計工具以及 Web Intelligence 豐富型用戶端建立 ODBC 連線至 Data Federator。 除
了上述的組態設定外，請執行下列一組說明：
●
請依照下列步驟進行：
1.
執行 regedit 工具。
2.
在登錄中，找到 HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Suite XI 4.0\default
\ConnectionServer\Configuration 機碼的位置。
3.
在本機碼中，將下列數值新增至 JVM Library 項目： &lt;bo-install-dir&gt;\javasdk\jre6\bin
\client\jvm.dll。
●
請依照下列步驟執行：
1.
開啟 cs.cfg 檔案進行編輯。
2.
找出 JavaVM 標記。
3.
將 LibraryName 設定為 openrda.ini 檔案中指定的相同 JVM 目錄路徑：
...
&lt;JavaVM&gt;
&lt;LibraryName JNIVersion=&quot;JNI_VERSION_1_4&quot;&gt;\\&lt;bo-install-dir&gt;\\javasdk\\jre6\
\bin\\client\\jvm.dll&lt;/LibraryName&gt;
&lt;/JavaVM&gt;
警告
語意層設計工具和 OpenEdge 橋接器必須指定相同的 JVM 目錄路徑。
資料存取指引
建立連線至 Data Federator XI 3.0 查詢伺服器
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
139
9
設定資料存取全域參數
9.1
關於全域參數
您可以設定全域參數值，套用於所有連線。您可以藉此提高效能，或解決發生的連線問題。
在 cs.cfg 檔中維護資料存取全域參數。此為 XML 檔，包含了連線伺服器組態參數，以及可套用至所有資料存取驅動
程式的預設組態參數。
若要覆寫這些全域設定，您可以在每個驅動程式的 SBO 組態檔中編輯設定。
相關資訊
設定驅動程式參數 [第 158 頁]
9.2
關於 cs.cfg 組態檔案
&lt;connectionserver-install-dir&gt;\connectionServer
在 cs.cfg 檔案中，您僅能設定下列區段的參數：
●
Capabilities
本區段會定義可讓您指定本機或遠端「連線伺服器」用途的參數。
●
Settings
本區段會定義「連線伺服器」全域組態參數，包含程式庫模式中的哪個驅動程式會在啟動時進行載入。
●
JavaVM
本區段會定義資料存取層所使用的 Java 虛擬機器 (JVM) 預設程式庫。
●
DriverDefaults
本區段會定義可套用至所有資料存取驅動程式的參數。 特定驅動程式的參數可藉由對應 &lt;driver&gt;.sbo 組態檔案
中的設定來加以覆寫，其中 &lt;driver&gt; 是與 SBO 檔案有關的資料存取驅動程式名稱。
●
Traces
本區段會定義可允許透過「連線伺服器」在記錄檔中記錄連線活動的參數。
剩下的 Locales 區段會為每種可用語言定義作業系統字元集。 您不可以在此區段中修改參數。
9.3
1.
140
檢視和編輯 cs.cfg 檔案
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取全域參數
在 XML 編輯器中開啟 cs.cfg。
3.
依需要展開區段。
4.
藉由新增新的參數和值，或者修改現有參數值來設定參數。
5.
對照 DTD 檢查文件是否有效，然後儲存並關閉檔案。
記得
編輯 cs.cfg 檔案後，您必須重新啟動連線伺服器。
9.4
設定全域設定參數
cs.cfg 的 Settings 區段定義了套用至所有驅動程式的設定，所以無法針對個別資料存取驅動程式進行自訂。
若要檢視或編輯參數，請開啟 XML 編輯器中的 cs.cfg，並移至 Settings 區段。 在該檔中，每個參數都在下列標籤
中定義：
&lt;Parameter Name=&quot;&lt;parameter&gt;&quot;&gt;&lt;value&gt;&lt;/Parameter&gt;
其中 &lt;parameter&gt; 是參數的名稱，而 &lt;value&gt; 是參數所設定的值。
每個參數皆會顯示下列資訊：
●
參數出現在 XML 檔中的範例
●
參數的描述
●
可能設定的參數值 (適用之處)
●
參數的預設值
9.4.1
Charset List Extension
註記
請勿變更此設定。
設定字元集檔案的副檔名。
資料存取指引
設定資料存取全域參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
141
crs
預設
9.4.2
Config File Extension
&lt;Parameter Name=&quot;Config File Extension&quot;&gt;sbo&lt;/Parameter&gt;
描述
註記
請勿變更此設定。
設定一般組態檔的副檔名。
sbo
預設
9.4.3
Description Extension
註記
請勿變更此設定。
設定連線描述檔的副檔名。
cod
預設
9.4.4
&lt;Parameter Name=&quot;Ignore Driver Load Failure&quot;&gt;Yes&lt;/Parameter&gt;
描述
決定當無法載入驅動程式時採取的動作。 此參數讓您選擇您需要可能並非所有驅動程式皆在運作中
狀態的可用連線，或當無法載入驅動程式時產生嚴重錯誤且沒有功能可使用。
註記
系統將在伺服器部署模式中忽略此參數。
值
Yes： 當無法載入驅動程式時，「連線伺服器」會產生警告訊息。
No： 當無法載入驅動程式時，「連線伺服器」會產生嚴重錯誤。
142
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取全域參數
Yes
預設
9.4.5
描述
決定驅動程式庫的載入方式。
值
●
Yes： 在初始化階段載入所有已安裝的驅動程式。
●
No： 依需要載入驅動程式。
No
預設
9.4.6
Max Pool Time
決定連線集區中未使用的連線處於閒置狀態的最大時間長度。 表示連線存留時間的上限。 連線集
區是資料存取驅動程式為重複使用資料庫連線而使用的機制，以善用系統資源。
您僅能針對程式庫部署模式設定 Max Pool Time。 該值可套用的節點中，包含使用伺服器產品
所安裝的「連線伺服器」。
資料存取指引
設定資料存取全域參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
143
-1：無逾時限制，在整個工作階段中保持運作狀態。
值
0：不由集區管理連線。
&gt;0：閒置時間 (分鐘)。
-1
預設
相關資訊
連線集區 [第 31 頁]
9.4.7
Setup File Extension
&lt;Parameter Name=&quot;Setup File Extension&quot;&gt;setup&lt;/Parameter&gt;
描述
註記
請勿變更此設定。
設定資料存取驅動程式設定檔的副檔名。
setup
預設
9.4.8
SQL External Extension
&lt;Parameter Name=&quot;SQL External Extension&quot;&gt;rss&lt;/Parameter&gt;
描述
註記
請勿變更這個設定。
設定外部 SQL 檔的副檔名。
rss
預設
9.4.9
SQL Parameter Extension
&lt;Parameter Name=&quot;SQL Parameter Extension&quot;&gt;prm&lt;/Parameter&gt;
144
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取全域參數
描述
註記
請勿變更此設定。
設定 SQL 參數檔的副檔名。
預設
prm
9.4.10 Strategies Extension
&lt;Parameter Name=&quot;Strategies Extension&quot;&gt;stg&lt;/Parameter&gt;
描述
註記
請勿變更這個設定。
設定策略檔的副檔名。
預設
stg
9.4.11 Validate Configuration Files
&lt;Parameter Name=&quot;Validate Configuration Files&quot;&gt;No&lt;/Parameter&gt;
描述
依據 XML 結構描述觸發驗證組態檔案 (SBO、COD 及 PRM)。
註記
只有在使用以 Java 為基礎的連線時，才能驗證組態檔案。
預設
No
9.4.12 Validate XML Streams
&lt;Parameter Name=&quot;Validate XML Streams&quot;&gt;No&lt;/Parameter&gt;
資料存取指引
設定資料存取全域參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
145
依據 XML 結構描述觸發驗證「連線伺服器」實作內所剖析的 XML 資料流 (例如： 連線定義）。
描述
註記
只有在使用以 Java 為基礎的連線時，才能驗證 XML 資料流。
No
預設
9.4.13 JVM 設定
下列表格說明 JVM 選項參數與相關範例：
表格 8：
屬性設定
範例
預設
&lt;JavaVM&gt;
&lt;Options&gt;
&lt;Option&gt;-Xrs&lt;/Option&gt;
屬性描述
在此範例中由於未提及「處理器」屬
性，因此依預設「用戶端工具」和
「伺服器」皆使用此選項。
&lt;/Options&gt;
&lt;/JavaVM&gt;
處理器 =&quot;32&quot;
在此範例中「處理器」屬性設定為
「32」， 因此「用戶端工具」使用此
選項。
&lt;/Options&gt;
&lt;/JavaVM&gt;
處理器 =&quot;64&quot;
在此範例中「處理器」屬性設定為
「64」， 因此「伺服器」使用此選
項。
&lt;/Options&gt;
&lt;/JavaVM&gt;
9.5
設定部署模式
Capabilities 區段可協助您指定執行階段所使用的「連線伺服器」部署模式。
Capabilities 區段下方的 Local 名稱代表本機提供的連線服務，如同用戶端程序中內嵌的處理中程式庫。Remote
名稱則代表遠端伺服器上提供的「連線伺服器」。
146
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取全域參數
您可以設定 Active 屬性，以獨立啟用這些部署模式。EnableJNI 屬性可專為 Local 功能啟用 「Java 原生介面」
(JNI)。
註記
內嵌於「連線伺服器」的雙向 JNI 可讓 API 與以不同語言開發的「連線伺服器」核心搭配使用。這代表您可以將
Java API 與原生核心搭配使用，反之亦然。
範例
伺服器模式中的連線伺服器
下列組態僅可讓您在伺服器模式中使用連線伺服器。
&lt;Capabilities&gt;
&lt;Capability Name=&quot;Local&quot; EnableJNI=&quot;Yes&quot; Active=&quot;No&quot;/&gt;
&lt;Capability Name=&quot;Remote&quot; Active=&quot;Yes&quot;/&gt;
&lt;/Capabilities&gt;
在此模式中，只有安裝在 BI 平台後端系統上的驅動程式才能用於建立連線。
如果系統正在執行伺服器執行個體，則您可依據平台後端系統上所安裝的驅動程式來建立本機連線。如果您停止伺
服器執行個體，將無法建立任何連線，因為此設定不允許使用安裝在用戶端電腦上的驅動程式。
相關資訊
連線能力服務 [第 22 頁]
9.6
設定部署模式
在 cs.cfg 檔的 Settings 區段中定義的參數可控制部署模式。
資料存取指引
設定資料存取全域參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
147
程式庫模式
Library 區段中的參數可控制程式庫模式。
9.7
設定要載入的驅動程式
「連線伺服器」的預設行為會載入所有可用的驅動程式。然而，您可以選取要由「連線伺服器」公開的資料來源。
註記
如果資料庫名稱為純 ASCII，該名稱便可以是一般運算式。模式會使用 GNU regexp 語法。使用 .* 符號代表任何字
元。如需規則運算式的更多資訊，請參閱 PERL 網站，網址 http://www.perl.com/doc/manual/html/pod/
perlre.html#Regular_Expressions
。
伺服器模式
在 CMC 的伺服器屬性的 [現用資料來源] 區段中選取資料來源。
148
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取全域參數
警告
若要避免連線失敗，您必須確認環境提供所有必要的中介軟體，否則必須設定僅供 [現用資料來源] 區段使用的網路
層和資料庫。
此設定支援伺服器專門化，因此能夠因應涉及伺服器模式中多個「連線伺服器」的複雜部署方案。如需有關複雜部署
案例的詳細資訊，請參閱《SAP BusinessObjects Business Intelligence 平台管理員指南》。
9.7.1
每台電腦設定一個連線
在複雜部署案例中，您可能想為每種電腦設定一個連線能力，例如，您想將隨附於 BI 平台的應用程式連線至
Microsoft Windows 上安裝的 MS SQL Server 資料庫以及 UNIX 電腦上安裝的 Oracle 資料庫。
為避免連線失敗，您需要執行以下作業之一：
●
●
自訂安裝 BI 平台時，請針對所需的各類型資料庫指定您要部署的連線。選取要安裝的功能時您會執行這項動作。
在 cs.cfg 檔案中設定「連線伺服器」時，請設定程式庫模式 (Library 父元素) 的 ActiveDataSources 區
段，如同您在 CMC 中針對伺服器模式所進行的動作。由於應用程式會先試著透過本機安裝的驅動程式建立連線，
因此您應該以同一方式，針對兩種模式設定驅動程式篩選器。
9.8
設定 CORBA 存取通訊協定
您可以在 BI 平台安裝的 CMC 中設定 CORBA 存取通訊協定。 通訊協定可定義「連線伺服器」所使用的值，以處理
CORBA 用戶端或 HTTP 用戶端的要求。
如需有關 CMC 的詳細資訊，請參閱《SAP BusinessObjects Business Intelligence 平台管理員指南》。
9.9
啟動連線伺服器和驅動程式的記錄和追蹤
SAP 會區分兩種類型的訊息：
●
追蹤訊息會從開發人員的觀點以例外程序的形式進行系統的詳細分析。
●
記錄訊息則是系統事件和狀態的永久資料錄。
記錄訊息主要是供系統管理員使用，追蹤訊息則是供開發人員使用。 您可以啟用資料存取層 (例如，ODBC、JDBC、
Javabean、OLE DB、OCI 和 JCo) 支援的所有連線的記錄和追蹤。
連線伺服器的記錄和追蹤程序依賴 SAP BusinessObjects TraceLog 記錄和追蹤設施。 其可協助您記錄及追蹤下列程
序：
資料存取指引
設定資料存取全域參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
149
記錄
追蹤
9.9.1
●
連線伺服器執行個體的啟動和停止
●
單一登入初始化
●
驅動程式載入
●
連線伺服器初始化和組態
●
工作和字典建立和執行
●
驅動程式載入和活動
●
連線伺服器執行個體的啟動和停止
●
連線伺服器執行個體的服務初始化和活動
●
單一登入初始化
關於 _trace.ini 組態檔案
檔案內容
在以上範例中，標記的定義如下所示：
●
sap_log_level 可定義記錄層級
●
sap_trace_level 可定義追蹤層級
●
可指定程序之記錄或追蹤層級的程式碼片段。 程式碼是以 C 或 Java 為基礎，並包含運算式、簡單陳述式和 if-else
陳述式。
下表說明 sap_log_level 和 sap_trace_level 標記接受的組態機碼。
表格 9： SAP 記錄層級
嚴重性
組態機碼
INFO
log_info 或 log_information
WARNING
log_warn 或 log_warning
ERROR
log_error
FATAL
log_fatal
150
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取全域參數
嚴重性
組態機碼
NONE
log_none
已設定嚴重性層級和更高層級的所有訊息都會顯示在記錄檔中。 例如，如果您將記錄嚴重性設為 WARNING　則系統
會記錄嚴重性為 WARNING、ERROR 和 FATAL 的所有訊息；而預設記錄嚴重性為 ERROR。
表格 10： SAP 追蹤層級
嚴重性
組態機碼
DEBUG
trace_debug
PATH
INFO
ERROR
trace_error
NONE
trace_none
已設定嚴重性層級和更高層級的所有訊息都會顯示在記錄檔中。 例如，如果您將追蹤嚴重性設為 INFO，則系統會記錄
嚴重性為 INFO 和 ERROR 的所有訊息；而預設追蹤嚴重性為 ERROR。
組態設定選項
您也可以將下列選項新增至檔案：
選項
值
描述
true 或 false
在每次寫入後關閉記錄檔。 預設值為 false。
append
true 或 false
將記錄資訊新增至現有的記錄檔。 變更命名模式以排除
PID 和時間戳記，並改用變動的記錄檔編號。 預設值為
false。
keep_num
整數
指定要保留的記錄檔數目。 預設值為 0。 負數整數表示
保留所有記錄檔。
log_dir
字串
指定記錄檔目錄。 預設值是 BO_TRACE_LOGDIR 環境變
數的值。 破折號 (-) 表示記錄資訊已導向至 stdout。
log_level
資料存取指引
設定資料存取全域參數
none、low、
定義捷徑以指定 sap_log_level 和
medium 或 high
sap_trace_level 值。 請參閱下表。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
151
選項
值
描述
true 或 false
指定記錄檔是否只顯示與範圍相關聯的訊息。 預設值為
false。
註記
範圍會在程式碼區塊中標示進入和結束點。
以 KB 為單位的數
字
size
記錄檔的大小上限。 預設值為 10000。
log_level 選項值
下表提供在組態檔案中指定對應的 log_level 時，所設定的 sap_log_level 和 sap_trace_level 值。
log_level 值
sap_log_level 值
sap_trace_level 值
none
log_error
trace_error
low
log_error
medium
log_warn
high
log_info
trace_debug
剖析錯誤
將剖析的 _trace.ini 檔案寫入 ERR 檔案 (與 INI 檔案位於相同目錄) 時，可能會發生錯誤並出現警告。 錯誤檔案名
稱是由 INI 檔案名稱所組成。
如果有多個程序共用相同的 INI 檔案，您將無法確定是哪個程序產生錯誤。 若要產生可提供更多資訊的錯誤檔案名
稱，請在 _trace.ini 檔案頂端新增以下幾行：
error_file = config_file + &quot;_&quot; + process + &quot;.err&quot;;
output_file = config_file + &quot;_&quot; + process + &quot;.out&quot;;
9.9.2
啟動 cs.cfg 檔案中的記錄和追蹤
152
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取全域參數
9.9.3
啟動程式庫模式的記錄和追蹤
1.
停止連線伺服器。
2.
建立值並將其設定為下列環境變數：
○
○
○
BO_TRACE_LOGDIR，設定記錄檔的資料夾名稱，例如：C:\BOTraces
註記
這些環境變數一般用以設定所有 BI 平台活動的追蹤。
3.
如下建立 BO_trace.ini 組態檔案：
sap_log_level = log_info;
sap_trace_level = trace_debug;
註記
INI 檔案名稱區分大小寫。
4.
將 logging.jar 和 tracelog.jar 目錄路徑新增至 CLASSPATH 環境變數。
例如： C:\BOTraces\lib\logging.jar 和 C:\BOTraces\lib\tracelog.jar。
5.
重新啟動連線伺服器。
資料存取指引
設定資料存取全域參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
153
記錄和追蹤會寫入檔案，其預設名稱為 TraceLog_&lt;pid&gt;_&lt;timestamp&gt;_trace.log。 如果您要將記錄檔設定為
其他名稱，請使用新名稱更新 BO_TRACE_PROCESS 環境變數。
9.9.4
啟動伺服器模式的記錄和追蹤
您可以從 CMC 啟用工作和驅動程式追蹤。 這可讓您在啟用追蹤時執行伺服器。
1.
啟動 CMC。
2.
移至 ConnectionServer 伺服器 (適用於原生連線能力服務) 或調適處理伺服器 (適用於調適連線能力服務) 的 [屬
性] 頁面。
3.
在 低階追蹤 區段中，選取：
○
[啟用工作追蹤] 以啟用工作追蹤
○
[啟用中介軟體追蹤] 以啟用中介軟體追蹤
註記
TraceLog 層級在 追蹤記錄服務 區段中必須設定為 High。 此層級與透過 BO_Trace.ini 檔案定義的 SAP 記
錄層級不同。
記得
[啟用中介軟體追蹤] 設定可讓您追蹤所有中介軟體。 如果您要僅追蹤特定中介軟體，則必須設定 cs.cfg 檔案
並重新啟動伺服器。
9.9.5
讀取記錄和追蹤
連線伺服器追蹤和記錄在追蹤檔案中會以 |CS| 標記。連線伺服器記錄也會由 THIS IS A LOG 的提示加以識別。每
個函式都有其自己的追蹤。追蹤包含下列資訊：
●
ENTER 追蹤可識別中介軟體 API 呼叫。EXIT 追蹤可識別傳回的呼叫。如果 ENTER 之後沒有 EXIT，則中介軟體
API 不會傳回任何呼叫。
●
呼叫例外，如果顯示 |E|
●
API 錯誤，如果顯示傳回碼 -1
●
●
●
記錄和錯誤訊息
範例
追蹤
下列為在程式庫模式中使用連線伺服器時取得的 DEBUG 和 PATH 嚴重性追蹤的節錄：
|BE42CC9D40484416BADEF01039652F620|2012 04 12 11:41:27.422|+0200|Debug| |&lt;&lt;| | |
TraceLog| 5256|
1|main
| ||||||||||||||||||||CS||[unknown|unknown|ID:
154
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取全域參數
9.10 啟動 OLAP 用戶端的記錄和追蹤
您可以透過 SAP BusinessObjects Web Intelligence 等 SAP BusinessObjects 應用程式找到 OLAP 用戶端的記錄和追
蹤。例如，您可以透過 Web Intelligence 處理伺服器的追蹤來尋找這些項目。您也可以設定 OlapClient.cfg 檔案以
分別記錄及追蹤 OLAP 用戶端。
資料存取指引
設定資料存取全域參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
155
您可以在檔案的 OlapClient 區段中將 UseLog 屬性設為 yes 以啟動記錄。您可以在 LogFileName 屬性中指定記錄
檔路徑。您無法變更 UseProcessName 值。
您不需要停止 Web Intelligence 處理伺服器即可變更這些設定。您可以在伺服器執行時啟動記錄和追蹤。
相關資訊
關於 OlapClient.cfg 組態檔案 [第 22 頁]
156
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取全域參數
資料存取指引
設定資料存取全域參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
157
10 設定資料存取驅動程式參數
10.1 設定驅動程式參數
若要為特殊資料存取層設定資料存取，您可以編輯驅動程式組態來調整參數設定，或者如果您需要連線至環境所特定
的資料庫，也可以建立您自己的資料庫項目。
註記
針對每個使用「連線伺服器」的 SAP BusinessObjects 應用程式，相關的 Readme 檔案皆包含您可用來檢查
RDBMS 和資料存取驅動程式組態的指令行公用程式相關資訊。這些公用程式會建立追蹤互動式分析伺服器活動的
記錄檔。如需有關使用這些公用程式的指示，請參閱 readme 檔案。
相關資訊
關於全域參數 [第 140 頁]
10.1.1
資料存取組態檔案
下列組態檔案控制每個定義連線的資料存取驅動程式組態：
●
●
158
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取驅動程式參數
&lt;DataFileName&gt;oracle&lt;/DataFileName&gt;
&lt;/Driver&gt;
...
相關資訊
關於全域參數 [第 140 頁]
安裝的 SBO 檔案 [第 159 頁]
資料庫技術
SBO 檔案
db2
IBM DB2
db2.sbo
essbase
Oracle Essbase
essbase.sbo
javabean
Javabean
javabean.sbo
jco
SAP ERP
jco.sbo
jdbc
Data Federator Server
datafederator.sbo
IBM DB2
db2.sbo
Derby
derby.sbo
Greenplum
greenplum.sbo
PostgreSQL
postgresql.sbo
HIVE
Amazon EMR HIVE
SAP Impala
HSQLDB
hsqldb.sbo
Ingres
ingres.sbo
資料存取指引
設定資料存取驅動程式參數
&copy; 2014 SAP SE 或
) 或聯絡
SAP 關係企業。 保留所有權利。
159
子目錄
資料庫技術
SBO 檔案
Generic JDBC
jdbc.sbo
MaxDB
maxdb.sbo
MySQL
mysql.sbo
HP Neoview
neoview.sbo
Netezza
netezza.sbo
SAP HANA
newdb.sbo
Oracle
sqlsrv.sbo
Sybase
sybase.sbo
Teradata
teradata.sbo
HP Vertica 6.1
vertica.sbo
odata
OData 2.0
odata.sbo
odbc
Data Federator Server
datafederator.sbo
IBM DB2 系列
db2iseries.sbo
PostgreSQL 8
postgresql.sbo
Greenplum 4
greenplum4.sbo
PostgreSQL 9
postgresql9.sbo
Ingres
ingres.sbo
MaxDB
maxdb.sbo
MS Excel 2007
msexcel.sbo
MySQL
mysql.sbo
HP Neoview
neoview.sbo
160
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取驅動程式參數
子目錄
資料庫技術
SBO 檔案
Netezza
netezza.sbo
SAP HANA
newdb.sbo
Generic ODBC 及 Generic ODBC3
odbc.sbo
MS Excel 2010、2013 和文字檔
personalfiles.sbo
sqlsrv.sbo
Sybase
sybase.sbo
Teradata
teradata.sbo
HP Vertica 6.1
vertica.sbo
bigdata.sbo
SAP Impala
bigdata.sbo
Amazon EMR HIVE
bigdata.sbo
Generic OLE DB
oledb.sbo
sqlsrv.sbo
oledb_olap
slqsrv_as.sbo
open
CSV 檔案
open.sbo
Oracle
Oracle EBS
sap
SAP BW
sap.sbo
sybase
Sybase
sybase.sbo
xml
XML
xml.sbo
Web 服務
oledb
jdbc 子目錄包含透過 JDBC 網路層管理資料庫連線的組態檔案。 請查看 SAP Service MarketPlace 網站或是一系列
SBO 檔案，以取得支援 JDBC 連線的資料庫詳細資料。
odbc 子目錄包含 mysql.sbo 組態檔案，可透過 ODBC 網路層管理 MySQL 資料庫的連線。 MySQL 5 資料庫適用於
任何支援 Unicode 的平台。 請務必使用 MySQL Connector/ODBC 5.1.4 或以上版本來連線至此資料庫。 如果您在
UNIX 使用舊版驅動程式，在執行階段時會發生錯誤。
資料存取指引
設定資料存取驅動程式參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
161
10.1.3 檢視和編輯 SBO 檔案
警告
請先備份檔案再開啟 SBO 檔案。 某些組態參數絕對不可加以編輯。 如果您變更或刪除這些組態，將可能影響 SAP
BusinessObjects 應用程式的作業。
1.
瀏覽目標資料存取驅動程式的 SBO 檔案所儲存目錄。
2.
在 XML 編輯器中開啟 SBO 檔案。
3.
依需要展開區段。
4.
找出欲變更的值的正確標記，然後變更值。
格式中出現的參數： &lt;Parameter Name=&quot;&lt;parameter&gt;&quot;&gt;&lt;value&gt;&lt;/Parameter&gt;，其中 &lt;parameter&gt; 是
參數的名稱，而 &lt;value&gt; 是參數的值。
5.
對照 DTD 檢查檔案是否有效，儲存後關閉檔案。
10.1.4 自訂 SBO 檔案
警告
安裝新驅動程式時，您可能希望使用自己的資料庫項目和驅動程式來自訂 SBO 檔案。 為避免編輯 SBO 檔案時可能
發生的錯誤，SAP BusinessObjects 建議您建立個別的 SBO 檔案，以依照您的自訂及驅動程式所使用的程式庫來指
定目標資料庫。 您也必須事先建立設定檔，以定義 SBO 檔案。 您無須修改登錄。
1.
2.
對照 DTD 檢查檔案是否有效，儲存後關閉檔案。
3.
導覽至要儲存 SBO 檔案的子目錄，或依照設定檔中所指定，建立您自己的子目錄。
4.
使用 XML 編輯器，依照您的目標資料庫和驅動程式庫建立 SBO 檔案。
5.
對照 DTD 檢查檔案是否有效，儲存並關閉檔案。
162
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取驅動程式參數
除了自訂 SBO 檔案以外，您也需要針對新安裝的各驅動程式建立 COD、PRM 和 RSS 檔案。
10.1.5 動態檢查連線
您可以自訂驅動程式，使其驗證連線集區之連線是否可在執行階段中使用。此驗證程序包含在從集區擷取連線時，執
行 SQL 查詢，而不會產生副作用。如果 SQL 查詢順利執行，且未發生任何錯誤，則代表該連線可使用。如果不是，則
會捨棄該連線。
記得
此功能可用於 Generic ODBC、Generic OLE DB 及 Generic JDBC 連線。所有其他支援的連線已經處理此連線檢
查，因此不需要任何自訂。
1.
停止「連線伺服器」。
2.
開啟您驅動程式的 SBO 檔案。
3.
4.
5.
儲存 SBO 檔案。
6.
重新啟動「連線伺服器」。
「連線伺服器」會先驗證該連線是否可用，然後才執行資料要求。
10.1.6 JDBC 驅動程式屬性
若要新增 JDBC 驅動程式屬性，請執行下列其中一項作業：
●
建立連線時，在應用程式的連線精靈中，設定 JDBC 驅動程式屬性 (key=value,key=value): 參數。 它是選用的。
●
停止連線伺服器之後，透過適當的 SBO 檔案設定驅動程式屬性。
如果您同時透過 SBO 檔案和精靈設定屬性，則應用程式將僅考量透過精靈設定的值集。
資料存取指引
設定資料存取驅動程式參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
163
相關資訊
使用 SBO 檔建立 JDBC 連線 [第 49 頁]
10.2 關於 DataDirect ODBC 驅動程式
資料存取層允許所有 UNIX 平台上的 MS SQL Server 資料庫使用 DataDirect ODBC 7.0 驅動程式。 這些驅動程式可以
是非原廠或原廠驅動程式。
DataDirect 原廠驅動程式是 BI 平台的一部分，只能和 SAP BusinessObjects 應用程式 (例如 SAP BusinessObjects
Web Intelligence) 搭配使用。 您可以在下列路徑找到這些驅動程式：&lt;boe-install-dir&gt;/enterprise_xi40/
&lt;platform-name&gt;/odbc/lib，其中 &lt;boe-install-dir&gt; 代表 BI 平台安裝目錄，&lt;platform-name&gt; 為 UNIX
平台名稱。
MS SQL Server 資料庫能夠與 DataDirect ODBC 7.0 驅動程式或 DataDirect ODBC 7.0 原廠驅動程式搭配使用。 這些
資料庫也可以與 6.0 SP2 版驅動程式搭配使用。 不過，此版本並未隨附於目前的平台版本。
連線伺服器預設值可以讓非原廠 ODBC 驅動程式密切配合您目前的設定運作。 如果您已經在環境中部署驅動程式，就
能夠在不變更任何設定下安裝非原廠驅動程式。
10.2.1 啟用系統使用 DataDirect 原廠驅動程式
若要使用原廠驅動程式，您必須確定資料存取已正確設定。
1.
164
導覽至包含 sqlsrv.sbo 檔的目錄。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料存取驅動程式參數
使用 XML 編輯器開啟 sqlsrv.sbo 檔案進行編輯。
3.
找到 Defaults 區段。
依預設，Use DataDirect OEM Driver 參數會設定為 No。 也就是說，資料存取是預設為配合非原廠驅動程式
運作。
4.
5.
將下列路徑新增至 LD_LIBRARY_PATH 環境變數：
&lt;boe-install-dir&gt;/enterprise_xi40/&lt;platform-name&gt;/odbc/lib
6.
在 &lt;boe-install-dir&gt;/setup 目錄中編輯 env.sh 檔案以設定環境，並執行檔案中的指令碼。
例如：
DEFAULT_ODBCFILE=&quot;${BOBJEDIR}enterprise_xi40/&quot;odbc.ini
Export DEFAULT_ODBCFILE
ODBC_HOME=&quot;${BINDIR}odbc&quot;
Export ODBC_HOME
ODBCINI=&quot;${BOBJEDIR}enterprise_xi40/&quot;odbc.ini
export ODBCINI
註記
DEFAULT_ODBCFILE 可指向任何含有原廠驅動程式連線詳細資料的檔案。
7.
8.
從 CMC 啟動「連線伺服器」
範例
以下是摘錄自預設的 sqlsrv.sbo 檔。
&lt;Defaults&gt;
&lt;Parameter
&lt;Parameter
&lt;Parameter
&lt;Parameter
&lt;Parameter
...
&lt;Parameter
&lt;/Defaults&gt;
...
資料存取指引
設定資料存取驅動程式參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
165
11
SBO 參數參考
11.1
SBO 檔案結構
每個支援的資料存取驅動程式皆具備 &lt;driver&gt;.sbo 檔案。 每個 &lt;driver&gt;.sbo 檔案均可分為下列區段：
檔案區段
描述
預設值
此區段包含了預設的組態參數，這些參數可套用至使用資料存取驅動程式的所
有資料庫中介軟體。 這些參數將覆寫掉資料庫中介軟體中設定的任何對應值。
資料庫
此區段包含資料存取驅動程式所支援的每個資料庫中介軟體 DataBase 子元
素。
每個 DataBase 元素皆包含以下元素或屬性：
●
Active： 此屬性可指定是否啟用中介軟體支援。 該值為 YES 或 NO。
●
Name： 此屬性可指定資料存取驅動程式所支援的中介軟體名稱。 此處設
定的中介軟體名稱會出現在連線精靈的 [資料庫中介軟體] 頁面中。
●
Alias： 此元素會指定不再受到資料存取驅動程式所正式支援的舊版中介
軟體版本名稱，但這些版本仍在使用中。 您可以新增舊版中介軟體的別名
元素，使現有的連線使用目前的資料存取驅動程式。 您可以將舊版中介軟
體專用的組態參數設定作為新別名的參數。 您可以使用別名建立新連線。
●
Parameter： 此元素的 Name 屬性以及值可個別套用至中介軟體。 此處
列出參數的設定值會覆寫在 [Defaults] 區段中相同參數的設定值。
註記
布林值參數接受 true/false 和 yes/no 等值。 該值不依情況而有所
不同。
11.2
SBO 參數說明
組態參數會依下列項目列出：
●
常見
本節說明不同資料庫技術所共用的 SBO 檔案參數。其他類別說明參數特定於資料庫技術或其所呈現的網路層。
●
JavaBean
●
JCO
●
JDBC
●
OData
●
ODBC
●
OLE DB
166
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
●
OLE DB for OLAP
●
●
Teradata
每個參數皆會顯示下列資訊：
●
參數出現在 XML 檔中的範例
●
參數的描述
●
可能設定的參數值
●
參數的預設值
相關資訊
一般 SBO 參數 [第 167 頁]
JavaBean SBO 參數 [第 183 頁]
JCO SBO 參數 [第 184 頁]
JDBC SBO 參數 [第 184 頁]
OData SBO 參數 [第 189 頁]
ODBC SBO 參數 [第 189 頁]
OLE DB SBO 參數 [第 192 頁]
OLE DB OLAP SBO 參數 [第 193 頁]
Sybase SBO 參數 [第 193 頁]
Teradata SBO 參數 [第 195 頁]
11.3
一般 SBO 參數
這些是所有資料存取驅動程式所最常使用的 SBO 參數。這些參數是在 Defaults 區段中定義的。某些 SBO 參數也會
列於 cs.cfg 檔中。在 Defaults 區段中設定的值會覆寫 cs.cfg 檔中設定的值。
11.3.1
Array Bind Available
指定資料庫是否支援陣列結合。
陣列結合可協助您最佳化 SQL 更新查詢的效能。
值
Yes： 資料庫支援陣列結合。
No： 資料庫不支援陣列結合。
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
167
cs.cfg 檔案中所設定的值。
預設
11.3.2
Array Bind Size
限制
SAP BusinessObjects BI 平台用戶端工具不會使用此參數。
&lt;Parameter Name=&quot;Array Bind Size&quot;&gt;5&lt;/Parameter&gt;
描述
指定每個 INSERT 查詢所匯出的資料列數。
值
每個 INSERT 查詢所匯出的資料列數 (整數)。
預設
cs.cfg 檔案中所設定的值。
11.3.3
指定連線伺服器是否啟用陣列取得。
陣列取得可擷取每個切片的 SQL 結果以最佳化效能。
Yes： 支援陣列取得。
值
No： 不支援陣列取得。
cs.cfg 檔案中所設定的值。
預設
11.3.4
Array Fetch Size
&lt;Parameter Name=&quot;Array Fetch Size&quot;&gt;10&lt;/Parameter&gt;
168
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
描述
指定每個切片所擷取的資料列數。 「連線伺服器」在任何部署模式中都將提供陣列
取得功能。
記得
如果支援陣列取得，則 [陣列取得大小] 值將傳播至資料庫中介軟體。
最適用的數目會依據系統效能而定。
●
如果數量較少，則系統需分成多次且每次擷取少量資料。 這樣可能會影響效
能。
●
如果數量較多，則系統會執行較少的擷取作業，但每個都會需要較多的記憶
體。
警告
請確保 [陣列擷取大小] 值適當，因為它可能會影響系統的效能，在遠端存取時
尤為如此，例如，在 Web 層部署模式中建立與 SAP ERP 系統的連線時。 針對
遠端存取的 OLAP 連線 (透過 32 位元連線伺服器的 MS Analysis Services、
SAP BW 和 Essbase 資料來源)，請根據待建立報表中的資料行數將陣列擷取大
小設為最佳化值 (例如，當資料行數較高時為 100，資料行數較低時為 250)。
在 Web 層部署模式中，[HTTP 區塊大小] 參數還可減少用戶端與伺服器之間資料呼
叫的次數，有助於微調效能。 如需有關 HTTP 區塊的詳細資訊，請參閱《SAP
BusinessObjects Business Intelligence 平台管理員指南》。
值
每個切片所擷取的資料列數 (整數)。
1 表示停用陣列取得。
0 指定驅動程式決定使用哪種陣列取得大小。 該值僅對於 JDBC 驅動程式有效。
預設
cs.cfg 檔案中所設定的值。
相關資訊
SAP ERP 驅動程式限制 [第 86 頁]
11.3.5
BigDecimal Max Display Size
指定透過 BigDecimal 字元類型擷取的最大資料顯示大小。
值
顯示大小 (整數位元組)。
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
169
預設
沒有預設值。
11.3.6
指定下列類型的表格資料行最大長度：
●
二進位和 MaxLength 值為 Max，或未提供固定長度的 OData 資料來源
●
如果傳回的資料大於指定的值，則會截斷該資料。
32768
預設
相關資訊
OData 驅動程式 [第 68 頁]
XML 驅動程式 [第 87 頁]
Web 服務驅動程式 [第 99 頁]
11.3.7
Bucket Split Size
&lt;Parameter Name=&quot;Bucket Split Size&quot;&gt;25000&lt;/Parameter&gt;
說明
指定將資料錄寫入本機磁碟之前，在記憶體中排序的資料錄編號。 當這些資料錄執行 ORDER
BY、GROUP BY 或 DISTINCT 運算時，下列資料存取驅動程式會使用 Bucket Split Size：
●
CSV OpenDriver
●
OData 驅動程式
●
SAP ERP 驅動程式
●
XML 和 Web 服務驅動程式
註記
當作業系統未指定暫存資料夾時，您可以在 cs.cfg 檔案中使用 Temp Data Dir 參數來設定
目錄路徑。 Linux 作業系統提供此功能。
Bucket Split Size 會影響記憶體取用。 如果主記憶體大小嚴重不足，將忽略此參數值。
預設
170
25000
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
相關資訊
作為排序作業快取使用的本機磁碟 [第 106 頁]
CSV OpenDriver 和 OData、SAP ERP、XML 以及 Web 服務驅動程式可使用本機磁碟作為已排序資料列的快取。
Temp Data Dir [第 180 頁]
11.3.8
Catalog Separator
&lt;Parameter Name=&quot;Catalog Separator&quot;&gt;.&lt;/Parameter&gt;
描述
指定在資料庫識別碼元素之間使用的分隔字元 (限定詞、擁有人、表格與資料行)。 例如，
&lt;database_name&gt;.&lt;table_name&gt;.&lt;column_name&gt;。
值
使用的分隔字元。 通常為句點 (.)。
預設
如果未指定，「連線伺服器」會使用資料庫中介軟體中指定的分隔符號。
11.3.9
&lt;Parameter Name=&quot;CharSet Table&quot;&gt;sybase&lt;/Parameter&gt;
描述
指定用於字元集的表格名稱，該字元集對應於作業系統及中介軟體之間。
值
CRS 檔案名稱。
預設
無預設。
11.3.10
Description File
註記
請勿編輯此參數。
指定 COD 檔的名稱，其中會保留連線精靈的輸入欄位標籤。
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
171
11.3.11
指定資料存取驅動程式在異動模式中查詢中繼資料。
註記
依預設，資料存取驅動程式會在 AutoCommit 模式中查詢中繼資料。 若要將驅動程式的組態變
更為異動，請將參數新增至 SBO 組態檔案的適當區段 (Defaults 或任何 Database 區段)。
值
11.3.12
驅動程式的功能，即為該程式是否可存取資料庫軟體中可用的預存程序和查詢。 此參數是使用連線
精靈所設定。 您可以在參數中包含上述兩個值。
Procedures： 驅動程式可使用儲存在資料庫中的程序來擷取資料。
值
Query： 驅動程式可使用如 SQL 等查詢語言來擷取資料。
查詢
預設
11.3.13
Driver Name
&lt;Parameter Name=&quot;Driver Name&quot;&gt;Adaptive Server IQ&lt;/Parameter&gt;
描述
指定 Microsoft Windows ODBC 資料來源管理員的 [驅動程式] 索引標籤中顯示的驅動程式名稱。
此參數特定於 ODBC。 其可協助您篩選「ODBC 資料來源名稱 (DSN)」清單中的驅動程式。
172
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
值
驅動程式名稱。
註記
您也可以根據 PERL 的 GNU regexp 語法來使用規則運算式。
預設
11.3.14
沒有預設值。
Escape Character
&lt;Parameter Name=&quot;Escape Character&quot;&gt;/&lt;/Parameter&gt;
描述
指定用於跳出特殊字元之字串的字元，例如模式。
值
用做跳出字元的字元。
預設
如果未指定，「連線伺服器」會從中介軟體擷取值。
11.3.15
Extensions
註記
請勿編輯此參數。
為資料存取驅動程式的 PRM 和 RSS 檔指定可能的名稱清單。 該清單也可指定您用來儲存 JAR 檔
的可能目錄名稱。
相關資訊
使用 Extensions 建立 JDBC 連線 [第 50 頁]
11.3.16
Family
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
173
描述
註記
請勿編輯此參數。
指定在連線精靈 資料庫中介軟體選擇 頁面中顯示的資料庫引擎系列。 對應至您的授權的中介軟體
會以樹狀結構顯示於此頁面上。
11.3.17
Force Execute
註記
請勿編輯此參數。
指定是否在擷取結果描述之前執行 SQL 查詢。
Never： 在擷取結果描述之前不執行 SQL 查詢。
值
Procedures： 在擷取結果描述之前執行 SQL 查詢，但僅適用於儲存的程序。
Always： 永遠在擷取結果描述之前執行 SQL 查詢。
Never
預設
11.3.18
Identifier Case
指定資料庫如何處理簡單識別碼的大小寫行為。
值
CaseSensitive： 資料庫會將混合大小寫的 SQL 識別碼視為區分大小寫。
LowerCase： 資料庫會將混合大小寫的 SQL 識別碼視為不區分大小寫，並以小寫儲存。
MixedCase： 資料庫會將混合大小寫的 SQL 識別碼視為不區分大小寫，並以混合大小寫儲存。
UpperCase： 資料庫會將混合大小寫的 SQL 識別碼視為不區分大小寫，並以大寫儲存。
11.3.19
Identifier Quote String
&lt;Parameter Name=&quot;Identifier Quote String&quot;&gt;&amp;quot;&lt;/Parameter&gt;
174
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
描述
指定資料庫識別碼的引號字元。
值
資料庫識別碼的引號字元。 通常使用引號 (&amp;quot;)。
預設
如果未指定，「連線伺服器」會從資料庫中介軟體擷取資訊。
11.3.20
指定是否從 Oracle 資料庫中擷取 Oracle 同義資料表的資料行。 此行為針對透過 JDBC 或
Oracle OCI 網路層的 Oracle 連線有效。
值
True： 擷取 Oracle 同義資料表的資料行，並顯示為表格資料行。
False： 不擷取 Oracle 同義資料表的資料行。
預設
11.3.21
False
Integer Max Length
&lt;Parameter Name=&quot;Integer Max Length&quot;&gt;18&lt;/Parameter&gt;
說明
指定表格資料行的最大長度，其 XML 內建類型為 integer、nonPositiveInteger、
negativeInteger、noNegativeInteger 和 positiveInteger。
如果傳回的資料大於指定的值，則會截斷該資料。
Integer Max Length 適用於 XML 資料來源和 Web 服務。
預設
18
相關資訊
XML 驅動程式 - 設定資料行大小上限 [第 99 頁]
Web 服務驅動程式 - 設定資料行大小上限 [第 106 頁]
11.3.22
Introscope Available
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
175
描述
註記
請勿編輯此參數。
指定是否針對驅動程式啟動透過 CA Wily Introscope 進行效能監控。
True： 啟動驅動程式監控。
值
False： 不啟動驅動程式監控。
針對 cs.cfg 檔案中的所有驅動程式，將參數設定為 False。 實際僅針對 newdb.sbo 檔案中的
預設
SAP HANA 連線啟動監控。
11.3.23
指定驅動程式是否限制從資料來源擷取的最大資料列數。
值
Yes： 可限制最大資料列數。
No： 無法限制最大資料列數。
No
預設
11.3.24
註記
請勿編輯此參數。
表示中介軟體是否可直接處理 64 位元的整數。
值
True： 中介軟體可處理 64 位元的整數。
False： 資料存取層會模擬 Int64 方法。
預設
176
False
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
11.3.25 Optimize Execute
&lt;Parameter Name=&quot;Optimize Execute&quot;&gt;False&lt;/Parameter&gt;
描述
指定連線伺服器是否可最佳化 SQL 查詢的執行。 僅 JDBC 和 ODBC 驅動程式支援此參數。
值
True： 會最佳化 SQL 查詢執行。
False： 不會最佳化 SQL 查詢執行。
預設
11.3.26
False
指定資料存取驅動程式是否可處理資料庫擁有人。
註記
若要在資訊設計工具中手動設定表格擁有人，您必須將此參數設為 Yes。
值
Yes： 支援擁有人。
No： 不支援擁有人。
預設
11.3.27
未指定。 「連線伺服器」會從資料庫中介軟體擷取此資訊。
Qualifiers Available
指定資料存取驅動程式是否可處理資料庫限定詞。
註記
若要在資訊設計工具中手動設定表格限定詞，您必須將此參數設為 Yes。
值
Yes： 支援限定詞。
No： 不支援限定詞。
預設
資料存取指引
SBO 參數參考
未指定。 「連線伺服器」會從資料庫中介軟體擷取此資訊。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
177
11.3.28
Query TimeOut Available
指定資料庫中介軟體是否支援查詢逾時，也就是是否能在到期之後取消執行中的查詢。
值
True： 資料庫中介軟體可處理查詢逾時。
False： 資料庫中介軟體不處理查詢逾時。
False
預設
11.3.29
Quote Identifiers
&lt;Parameter Name=&quot;Quote Identifiers&quot;&gt;True&lt;/Parameter&gt;
描述
指定已儲存程序的識別碼是否支援引號。
值
True： 支援引號。
False： 不支援引號。
True
預設
11.3.30
Skip SAML SSO
&lt;Parameter Name=&quot;Skip SAML SSO&quot;&gt;False&lt;/Parameter&gt;
指定在連線至 SAP HANA 資料庫時，是否略過單一登入 (SSO) 的 SAML 實作。
說明
如需有關單一登入的詳細資訊，請參閱《SAP BusinessObjects Business Intelligence 平台管理員
指南》。
True： 略過 SAML。
值
False： 先使用 SAML。
False
預設
11.3.31
SQL External File
&lt;Parameter Name=&quot;SQL External File&quot;&gt;&lt;filename&gt;&lt;/Parameter&gt;
178
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
描述
註記
請勿編輯此參數。
SQL 外部檔案會保留資料存取層所使用的組態詳細資料。
11.3.32
SQL Parameter File
儲存資料庫參數之檔案名稱。 此檔案的副檔名為 .prm。
您必須確認該檔案位於與 SBO 組態檔相同的目錄中。
值
請參閱 SBO 檔案中的值清單。
預設
上述列出的值。
11.3.33
SSO Available
&lt;Parameter Name=&quot;SSO Available&quot;&gt;False&lt;/Parameter&gt;
描述
指定是否支援單一登入 (SSO)。
如需有關單一登入的詳細資訊，請參閱《SAP BusinessObjects Business Intelligence 平台管理員
指南》。
值
True： 支援單一登入。
False： 不支援單一登入。
預設
11.3.34
False
Strategies File
指定策略檔 (.stg) 的名稱，不含副檔名。
此檔案包含可讓語意層設計工具用於自動建立語意層的外部策略。 策略檔會和 SBO 檔案儲存在相
同的目錄。
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
179
db2 適用於 IBM DB2 資料存取驅動程式
值
上述列出的值。
11.3.35
String Max Length
&lt;Parameter Name=&quot;String Max Length&quot;&gt;32768&lt;/Parameter&gt;
指定已對應至 ABAP 函式參數 (其值長度為零) 的表格資料行的字串最大長度。
描述
同時指定下列類型的表格資料行最大長度：
●
字串和 MaxLength 值為 Max 的 OData 資料來源
●
如果傳回的資料大於指定的值，則會截斷該資料。
32768
預設
相關資訊
OData 驅動程式 [第 68 頁]
SAP ERP 驅動程式 - 存取 ABAP 函式 [第 84 頁]
XML 驅動程式 [第 87 頁]
Web 服務驅動程式 [第 99 頁]
11.3.36
Temp Data Dir
&lt;Parameter Name=&quot;Temp Data Dir&quot;&gt;C:\temp\&lt;/Parameter&gt;
180
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
說明
指定已寫入磁碟的暫存資料目錄路徑。 若作業系統未指定任何預設暫存資料夾，則您可以使用此參
數，例如 \ {5}C: C:\Users\&lt;myName&gt;\AppData\Local\Temp。
下列資料存取驅動程式可以使用 Temp Data Dir。
●
CSV OpenDriver
●
OData 驅動程式
●
SAP ERP 驅動程式
●
XML 和 Web 服務驅動程式
當驅動程式執行 ORDER BY、GROUP BY 或 DISTINCT 運算時，如果要排序的資料錄數目超過
Bucket Split Size 參數值，則會將資料寫入此資料夾。
預設
參數已註解， 移除註解語法可啟用參數。
相關資訊
作為排序作業快取使用的本機磁碟 [第 106 頁]
CSV OpenDriver 和 OData、SAP ERP、XML 以及 Web 服務驅動程式可使用本機磁碟作為已排序資料列的快取。
Bucket Split Size [第 170 頁]
11.3.37
Transactional Available
指定針對資料庫執行的 SQL 運算會以區塊異動形式執行或個別執行。
依預設，SBO 檔案中不會列出此參數。 如果您的資料存取驅動程式不支援異動模式，請將其新增
至 SBO 檔案。
值
Yes： 針對資料庫執行的運算在確認時會以區塊形式執行。
No： 立即確認每個 SQL 陳述式，也就是停用 Autocommit。
預設
資料存取指引
SBO 參數參考
Yes。 值是在 cs.cfg 檔中設定。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
181
相關資訊
設定 IBM Informix 連線的異動模式 [第 116 頁]
使 salesforce.com 連線在語意層設計工具中得以運作 [第 123 頁]
11.3.38
Type
註記
請勿編輯此參數。
指定資料來源類型。
11.3.39
Unicode
&lt;Parameter Name=&quot;Unicode&quot;&gt;UTF8&lt;/Parameter&gt;
指定存取驅動程式是否能從用戶端中介軟體的 Unicode 組態獲得好處。
描述
此參數是 cs.cfg 檔案中驅動程式的預設值。 其值適用於所有的資料存取驅動程式。 依預設，
SBO 檔案中不會列出此參數。 如果您要覆寫預設值，您必須將其新增至目標資料存取驅動程式的
SBO 檔案 Defaults 區段中。
UTF8： 8 位元 UCS/Unicode 轉換格式編碼。
值
CharSet： 字元集編碼。
UCS2： 2 位元組通用字元集編碼。
cs.cfg 檔案中所設定的值。
預設
11.3.40
&lt;Parameter Name=&quot;URL Format &quot;&gt;&lt;string&gt;&lt;/Parameter&gt;
182
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
描述
指定 URL 格式。
JDBC 規格未指定所需的連線字串之格式。 廠商會使用不同種類的 URL 格式，例如：
●
MySQL 廠商：
jdbc:mysql://$DATASOURCE$/$DATABASE$
●
註記
僅 JDBC 和 JavaBean 驅動程式檔支援此參數。
值
URL 格式。
預設
沒有預設值。
11.3.41
XML Max Size
&lt;Parameter Name=&quot;XML Max Size&quot;&gt;65536&lt;/Parameter&gt;
描述
指定以 XML 格式擷取的最大資料大小。
值
允許的最大 XML 大小 (位元組)。
預設
此值會視資料庫而有所不同。
11.4.1
JavaBean Class
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
183
值
完整的 JavaBean 類別名稱。
預設
沒有預設值。
11.5
JCO SBO 參數
11.5.1
ERP Max Rows
指定查詢可傳回至無篩選器 InfoSet 或 SAP 查詢的最大資料列數。
值
等於或小於 2147483647 的整數。
預設
2147483647
相關資訊
SAP ERP 驅動程式 [第 81 頁]
11.6.1
184
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
描述
註記
請勿編輯此參數。
指定是否可在不同要求者之間共用連線集區的連線。 與 Shared Connection 參數共同作用。
值
True： 在多個使用者之間可共用連線。
False： 使用者之間不可共用連線。
預設
False
11.6.2
Escape Character Available
&lt;Parameter Name=&quot;Escape Character Available&quot;&gt;True&lt;/Parameter&gt;
描述
指定 JDBC 網路層是否可以處理 SQL 查詢之 like 運算式後面的跳出子句。 此子句可協助您指定
字元以跳出特定字元，如底線 (_)。
值
True： 支援一個跳出子句。
False： 未支援任何跳出子句。
預設
11.6.3
True
指定是否可擷取資料庫表格的外部索引鍵。
值
True： 可擷取外部索引鍵。
False： 無法擷取外部索引鍵。
預設
資料存取指引
SBO 參數參考
True
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
185
11.6.4
&lt;Parameter Name=&quot;Get Extended Column&quot;&gt;No&lt;/Parameter&gt;
說明
註記
請勿編輯此參數。
指定資料存取層是否使用 Data Federator 查詢伺服器提供的 getExtendedColumns 預存程序來
擷取輸入資料行。
是： 使用 getExtendedColumns。
值
否： 不使用 getExtendedColumns。
否
預設
11.6.5
&lt;Parameter Name=&quot;JDBC Class&quot;&gt;&lt;string&gt;&lt;/Parameter&gt;
描述
JDBC 驅動程式的完整 Java 類別。
值
視廠商或資料來源而定，例如：
●
Oracle 的 OracleDriver oracle.jdbc
●
沒有預設值。
預設
11.6.6
PrimaryKey Available
指定是否可擷取資料庫表格的主要索引鍵。
值
True： 可擷取主要索引鍵。
False： 無法擷取主要索引鍵。
預設
186
True
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
11.6.7
PVL Available
&lt;Parameter Name=&quot;PVL Available&quot;&gt;True&lt;/Parameter&gt;
描述
指定連線是否支援慣用的檢視地區設定 (PVL) 功能。
此版本中僅 SAP HANA 連線支援此功能。
值
True： 支援 PVL。
False： 不支援 PVL。
11.6.8
值
True： 共用連線。
False： 不共用連線。
預設
False
11.6.9
JDBC ResultSet Type
&lt;Parameter Name=&quot;JDBC ResultSet Type&quot;&gt;1003&lt;/Parameter&gt;
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
187
描述
註記
此參數必須與 JDBC ResultSet Concurrency 搭配使用。 這不是必要參數。
指定 createStatement Java 方法的 resultSetType 引數值。
此方法屬於 java.sql.Connection 介面。 您可以新增此參數以建立預設 Statement 物件並微
調您的連線效能。
您可以設定標準 Java 值或資料庫特定值。 這些值必須是整數。
值
相關資訊
createStatemen 方法
ResultSet 介面
11.6.10
註記
此參數必須與 JDBC ResultSet Type 搭配使用。 這不是必要參數。
指定 createStatement Java 方法的 resultSetConcurrency 引數值。
此方法屬於 java.sql.Connection 介面。 您可以新增此參數以建立預設 Statement 物件並微
調您的連線效能。
您可以設定標準 Java 值或資料庫特定值。 這些值必須是整數。
值
相關資訊
createStatement 方法
ResultSet 介面
188
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
11.7
OData SBO 參數
這些參數可用於設定使用 OData 通訊協定的資料來源連線。
這些參數定義於 \\&lt;connectionserver-install-dir&gt;\connectionServer\odata\odata.sbo 檔案中。
11.7.1
指定驅動程式是否將支援的 OData 通訊協定版本傳送至 OData 提供者。
如果是，則 OData 提供者可決定是否要以指定的通訊協定回應驅動程式。 當 BI 平台連線至使用
OData 3.0 通訊協定的提供者時，此參數很有用。
值
Yes： 驅動程式會傳送支援的 OData 通訊協定版本。
No： 驅動程式不會傳送支援的 OData 通訊協定版本。
預設
Yes
11.8.1
&lt;Parameter Name=&quot;CharSet&quot;&gt;ISO88591&lt;/Parameter&gt;
說明
註記
請勿編輯此參數。
指定資料庫中介軟體傳回的資料字元集。
值
ISO88591： 指定給 UNIX 上之 HP Neoview 的預設字元集。
預設
如果未指定，「連線伺服器」會使用資料庫中介軟體中指定的字元集。
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
189
11.8.2
Connection Status Available
指定中介軟體是否可偵測錯誤的連線 (Ping 功能)。
值
True： 中介軟體可偵測錯誤的連線。
False： 中介軟體無法偵測錯誤的連線。
預設
於中介軟體中設定的值。
11.8.3
Cost Estimate Available
指定資料庫中介軟體是否支援 SQL 查詢執行的成本預估。 此參數僅適用於 Teradata 資料庫。
值
True： 中介軟體支援成本預估。
False： 中介軟體不支援成本預估。
False
預設
11.8.4
指定某些函式 (例如 SQL 表格) 接收空字串或 Null 指標以取代遺失的參數。
值
NullString： 使用 Null 字串。
EmptyString： 使用空字串。
EmptyString
預設
11.8.5
190
指定資料存取驅動程式是否使用 ODBC 指標程式庫。 這可協助您提升系統效能。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
值
Yes： 資料存取驅動程式會使用 ODBC 指標程式庫。
No： 資料存取驅動程式不會使用 ODBC 指標程式庫。
預設
11.8.6
cs.cfg 檔案中所設定的值。
SQLDescribeParam Available
值
True： 可使用 SQLDescribeParam 函式。
False： 無法使用 SQLDescribeParam 函式。
預設
11.8.7
於資料庫中介軟體中設定的值。
SQLMoreResults Available
指定中介軟體是否可處理 SQLMoreResults ODBC 函式。
此函式可協助您從 SQL 執行擷取更多結果集 (若有的話)。 僅 ODBC 驅動程式支援此參數。
值
True： 支援 SQLMoreResults 函式。
False： 不支援 SQLMoreResults 函式。
預設
11.8.8
於中介軟體中設定的值。
&lt;Parameter Name=&quot;Use DataDirect OEM Driver&quot;&gt;No&lt;/Parameter&gt;
描述
值
Yes： 連線可使用品牌驅動程式。
No： 連線無法使用品牌驅動程式。
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
191
否
預設
11.8.9
描述
驅動程式可用來定義 ODBC 資料來源名稱 (DSN) 而不需要連線字串。 此參數僅適用於 IBM
Informix 資料庫。
值
安裝在電腦上的 Informix 驅動程式之確切名稱。
預設
cs.cfg 檔案中所設定的值。
11.9.1
Enumerator CLSID
註記
請勿編輯此參數。
指定列舉 OLE DB 的類別 ID。 此參數僅適用於 OLE DB。
192
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
11.9.2
Provider CLSID
&lt;Parameter Name=&quot;Provider CLSID&quot;&gt;MSDASQL&lt;/Parameter&gt;
描述
註記
請勿編輯此參數。
指定 OLE DB 提供者的類別 ID。 此參數僅適用於 OLE DB。
11.10.1
MSOlap CLSID
&lt;Parameter Name=&quot;MSOlap CLSID&quot;&gt;msolap.4&lt;/Parameter&gt;
描述
註記
請勿編輯此參數。
指定 OLE DB 提供者的類別 ID。 此參數僅適用於 OLAP 的 OLE DB。
11.11.1
Driver Behavior
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
193
描述
指定要使用哪一種 Sybase 驅動程式。
值
Dynamic： 已使用 ct_dynamic 驅動程式。
其他值會啟用 CTLib 驅動程式。
Dynamic。
預設
11.11.2
描述
此參數僅限與 Sybase 搭配使用。 其包含在 Defaults 區段中以提升未來的相容性。
True： 使用中介軟體的加密密碼機制。
值
False： 不使用中介軟體的加密密碼機制。
cs.cfg 檔案中所設定的值。
預設
11.11.3
Quoted Identifier
&lt;Parameter Name=&quot;Quoted Identifier&quot;&gt;False&lt;/Parameter&gt;
描述
指定是否支援有引號的識別碼。 僅 Sybase 中介軟體支援此參數。
值
True： 支援有引號的識別碼。
False： 不支援有引號的識別碼。
False
預設
11.11.4
Recover Errors
&lt;Parameter Name=&quot;Recover Errors&quot;&gt;True&lt;/Parameter&gt;
描述
指定是否可在 ct_dynamic 驅動程式失敗後使用用戶端程式庫驅動程式。
值
True： 已使用用戶端程式庫驅動程式。
False： 未使用用戶端程式庫驅動程式。
194
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
預設
11.11.5
True
Text Size
&lt;Parameter Name=&quot;Text Size&quot;&gt;32768&lt;/Parameter&gt;
說明
註記
這不是必要參數。
指定支援的大型變數長度二進位或字元資料的大小上限。
如果超過 32 KB，則從 Sybase CTL 資料庫擷取的大型變數長度二進位或字元資料將會被截斷。 您
可將此參數新增至組態檔案的適當 Database 區段，以避免資料截斷。
預設
32768
11.12.1
指定在查詢資料來源的目前擁有人時，驅動程式是否傳回目前資料庫名稱。 只能在進行 ODBC 連
線時使用。
值
Yes： 目前擁有人會對應至 Teradata 資料庫名稱。
No： 目前擁有人會對應至目前使用者名稱。
預設
否
相關資訊
Teradata 連線 - 將 Teradata 資料庫對應至目前擁有人 [第 132 頁]
資料存取指引
SBO 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
195
下節會提供有關 Teradata 連線的組態資訊。
196
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
SBO 參數參考
12
設定資料庫功能參數
12.1
關於資料庫功能參數
資料庫功能參數可描述資料庫的功能，而該資料庫為語意層內容的資料來源。您可以設定這些參數來操作下列層級：
●
語意層
當您建立或修改語意層時可設定這些參數。
●
資料庫層
您可以在資料庫的 PRM 檔中設定這些參數。語意層上的任何對應設定會覆寫這些參數。
註記
若要檢視您的資料存取驅動程式可使用的運算子和函式，請在 XML 編輯器中開啟 &lt;driver&gt;.prm 檔。
12.2 關於 PRM 檔
PRM 檔案可提供用來描述資料庫功能的參數，而該資料庫為 SAP BusinessObjects 應用程式的資料來源。 它可讓資
料庫相依因數根據連線以及與其相連接的資料庫，來控制語意層所能使用的 SQL。 每個資料庫驅動程式都有相對應的
PRM 檔。
您可以在語意層中設定某些資料庫功能參數。 然後這些參數會覆寫 PRM 檔的設定值。
PRM 檔案位於下列資料夾：
●
●
&lt;connectionserver-install-dir&gt;\connectionServer\&lt;RDBMS&gt;\extensions\qt 目錄。 這些 PRM
檔案稱為擴充檔案。 如需有關擴充檔案參數的詳細資訊，請參閱《資訊設計工具使用指南》中的＜ SQL 和 MDX
參照＞一章。
註記
相同目錄中還提供其他語言的說明文字檔。
12.2.1
PRM 參數檔案結構
每個支援的資料庫驅動程式都有相對應的 PRM 檔。 每個檔案會分割成數個區段，其中包含特定參數。 下表描述每個
PRM 檔區段的內容和意義。
資料存取指引
設定資料庫功能參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
197
檔案區段
描述
組態
參數可用來描述做為語意層資料來源的資料庫功能，例如 EXT_JOIN、ORDER_BY 和
UNION。 這些無法在 SAP BusinessObjects 產品中直接使用。
若要藉由目標資料存取驅動程式執行語意層的查詢，則可編輯這些參數讓查詢效果達到最
佳化。
註記
將於下一章進行說明。
可用於語意層設計工具和資訊設計工具的日期運算子，例如 YEAR、QUARTER、MONTH。
Operators
可用於語意層設計工具和資訊設計工具的運算子，例如 ADD、SUBSTRACT、MULTIPLY。
可用於語意層設計工具和資訊設計工具的函式，例如 Average、Sum、Variance。 如
需更多資訊，請參閱《資訊設計工具使用指南》。
在語意層設計工具和資訊設計工具中選取此區段的函式時所顯示的說明文字會列出在
&lt;driver&gt;&lt;language&gt;.prm 中，例如 oracleen.prm。 您可以在與 &lt;driver&gt;.prm
檔相同的目錄中找到該檔案。 您可開啟該檔案來檢視 &lt;driver&gt;.prm 檔中所有可用函式
的描述。
Functions 區段包含以下子元素：
●
Group： 在查詢中是否使用此函式來產生 群組依據 子句。
○
True 會設定查詢產生 群組依據 子句。
○
False 會設定查詢不產生 群組依據 子句。
●
ID： 這是顯示在 Desktop Intelligence 使用者物件 函式清單中的名稱。 此版本中已
●
InMacro： 如果該值為 True，則函式會列於 Desktop Intelligence 使用者物件 函式
不再使用。
清單中。 此版本中已不再使用。
●
Type： 函式資料類型。
●
Arguments： 函式所接受的引數。 一個函式最多只能有四個引數，且任何其他引數
●
SQL： 函式的 SQL 語法。
都不會列入考量。
相關資訊
檢視和編輯函式說明文字檔 [第 200 頁]
198
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料庫功能參數
12.3 檢視和編輯 PRM 檔
1.
2.
在 XML 編輯器中開啟 &lt;driver&gt;.prm 檔案。
3.
依需要展開區段。
4.
在適當的標籤中輸入設定值。
5.
儲存並關閉檔案。
12.4 驗證分析函式支援並新增至 PRM 檔案
PRM 檔案可能不包含目標資料庫中所有可用的分析函式。 使用分析函式前，您應先驗證檔案中有該函式：若需要，則
將其新增至清單。
您僅須在函式同時為分析和彙總函式 (例如 SUM) 時更新 PRM 檔案。
1.
瀏覽目標資料存取驅動程式的擴充 PRM 檔案所儲存目錄。
2.
在 XML 編輯器中開啟 &lt;driver&gt;.prm 檔案。
3.
4.
瀏覽至儲存目標資料存取驅動程式之 PRM 檔的目錄。
5.
在 XML 編輯器中開啟 &lt;driver&gt;.prm 檔案。
6.
7.
若不存在，請在清單尾端輸入函式 ID。
8.
記得
針對同時為分析給予和彙總函式的函式給予不同名稱和 ID。 例如，彙總函式 SUM 的名稱為 SUM， 分析函式
SUM 的名稱則為 SUM_OVER。
9.
儲存修改，然後關閉檔案。
您已將分析函式的支援新增至資訊設計工具。
資料存取指引
設定資料庫功能參數
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
199
您必須重新啟動資訊設計工具，以使 PRM 檔案的變更生效。
相關資訊
關於 PRM 檔 [第 197 頁]
12.5 檢視和編輯函式說明文字檔
在語意層設計工具或資訊設計工具 中選取時顯示在每個函式下方的說明文字，可在個別的 XML 檔中維護。 您可藉由
編輯 &lt;driver&gt;&lt;language&gt;.prm 檔來編輯與新增用於描述函式的文字。 每個已安裝的 SAP BusinessObjects 產品
的每種語言版本皆具包含說明文字檔。
當您將函式新增至 PRM 檔案時，必須將新函式的說明文字新增至適當的 &lt;driver&gt;&lt;language&gt;.prm 檔；例如，若
您使用的工具是英文版，則當您將函式新增至 oracle.prm 檔時，必須將函式名稱和該函式的說明文字新增至
oracleen.prm 檔。 請參閱 ISO639-1 標準。
12.6 編輯 PRM 函式的說明文字
1.
2.
在 XML 編輯器中開啟 &lt;driver&gt;&lt;language&gt;.prm 檔。
3.
展開 Messages 區段。
4.
依照下列步驟為新函式新增說明：
○
為函式新增新的區段。 執行此步驟的最簡單方式是將現有函式項目複製到 Function 區段中。 然後編輯新函
式文字。
○
5.
6.
200
為函式輸入說明文字。
依照下列步驟檢視或編輯現有的函式說明文字：
○
○
展開函式的 Message 區段。
○
依要求編輯說明文字。
儲存並關閉檔案。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
設定資料庫功能參數
13
PRM 參數參考
13.1
PRM 檔案組態參考
資料庫功能參數會依字母順序排列。 若要檢視函式、日期運算子和其他可用的運算子，請在 XML 編輯器中開啟
&lt;driver&gt;.prm 檔案，每個參數皆會在下列標記中加以定義：
&lt;Parameter Name=&quot;&lt;parameter&gt;&quot;&gt;&lt;value&gt;&lt;/Parameter&gt;
其中的 &lt;parameter&gt; 為參數名稱，&lt;value&gt; 為參數的屬性值。
每個參數皆會顯示下列資訊：
●
參數出現在 XML 檔中的範例
●
參數的描述
●
可能設定的參數值
●
參數的預設值 (若有的話)
註記
某些組態參數絕對不可加以編輯。 這些參數皆已針對 SAP BusinessObjects 內部使用進行設定。 本節提供這些參
數的說明，但亦包含不得編輯其值的警告。 您絕對不可編輯這些參數。 在編輯其他任何 PRM 檔案參數之前，應先備
份 PRM 檔。
13.1.1
&lt;Parameter Name=&quot;ANALYTIC_CLAUSE&quot;&gt;WHEN&lt;/Parameter&gt;
描述
指定在 SQL 陳述式中使用 ANALYTIC_FUNCTIONS 參數所指定的函式哪一種時，要使用哪一種
SQL 關鍵字。
值
WHEN：表示已使用 WHEN 子句。此為 IBM Red Brick 資料庫的預設值。
QUALIFY：表示已使用 QUALIFY 子句。此為 Teradata 資料庫的預設值。
註記
請參閱您的文件資料庫以瞭解如何實作 SQL 子句。
預設
請參閱以上的值。
相關資訊
ANALYTIC_FUNCTIONS [第 202 頁]
資料存取指引
PRM 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
201
13.1.2
ANALYTIC_FUNCTIONS
&lt;Parameter Name=&quot;ANALYTIC_FUNCTIONS&quot;&gt;RANK,SUM,AVG,COUNT,MIN,MAX&lt;/Parameter&gt;
描述
列出資料庫所支援的分析函式。
值
請參閱 PRM 檔中的值。
預設
上述列出的值。
13.1.3
&lt;Parameter Name=&quot;CALCULATION_FUNCTION&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援計算函式。
值
YES：資料庫支援計算函式。若支援計算函式，則資訊設計工具可建立計算資料行。
NO：資料庫不支援計算函式。
13.1.4
CONSTANT_SAMPLING_SUPPORTED
&lt;Parameter Name=&quot;CONSTANT_SAMPLING_SUPPORTED&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援隨機取樣。隨機取樣包含從資料集擷取的隨機資料列。
值
YES：資料庫支援隨機取樣。
NO：資料庫不支援隨機取樣。
YES
預設
13.1.5
DISTINCT
&lt;Parameter Name=&quot;DISTINCT&quot;&gt;YES&lt;/Parameter&gt;
描述
202
指定資料庫是否支援 SQL 陳述式的 DISTINCT 關鍵字。此參數與 MS Access 搭配使用。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
PRM 參數參考
值
YES：資料庫支援 DISTINCT 關鍵字。
NO：資料庫不支援 DISTINCT 關鍵字。此行為會停用以下功能：
預設
13.1.6
●
當您在語意層設計工具的 [快速設計] 精靈中按一下 [檢視值] 按鈕時，隨即出現 [差異值] 選
項。
●
YES
EXT_JOIN
&lt;Parameter Name=&quot;EXT_JOIN&quot;&gt;YES&lt;/Parameter&gt;
說明
指定資料庫是否支援外部聯結。 此參數供所有資料存取驅動程式使用。
值
YES： 資料庫支援外部聯結。
NO： 資料庫不支援外部聯結。 語意層設計工具中 [編輯聯結] 對話方塊的 [外部聯結] 核取方塊會變
成灰色。
預設
13.1.7
YES
&lt;Parameter Name=&quot;FULL_EXT_JOIN&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援完整外部聯結。
值
YES：資料庫支援完整外部聯結。
NO：資料庫不支援完整外部聯結。
預設
13.1.8
YES
GROUP_BY
&lt;Parameter Name=&quot;GROUP_BY&quot;&gt;NO&lt;/Parameter&gt;
描述
資料存取指引
PRM 參數參考
指定資料庫是否支援 SQL 敘述中的 GROUP BY 子句。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
203
YES：資料庫支援 GROUP BY 子句。
值
NO：資料庫不支援 GROUP BY 子句。
13.1.9
GROUP_BY_SUPPORTS_COLUMN_INDEX
&lt;Parameter Name=&quot;GROUP_BY_SUPPORTS_COLUMN_INDEX&quot;&gt;NO&lt;/Parameter&gt;
描述
指定資料庫是否支援在 GROUP BY 子句中使用 SELECT 陳述式的資料行索引。
值
YES：資料庫支援使用 SELECT 陳述式的資料行索引取代資料行名稱。
NO：資料庫不支援使用 SELECT 陳述式的資料行索引取代資料行名稱。
NO
預設
13.1.10
GROUP_BY_SUPPORTS_COMPLEX
Parameter Name=&quot;GROUP_BY_SUPPORTS_COMPLEX&quot;&gt;NO&lt;/Parameter&gt;
指定資料庫是否支援 GROUP BY 子句中的複雜表達式。複雜表達式表示 SELECT 陳述式中資料行
名稱或索引以外的任何元素，例如缺少函式或資料行的 SELECT 陳述式。此參數適用於 IBM
DB2。
描述
註記
如果您執行包含計量物件和複雜物件的查詢，也就是使用函式和連鎖的物件，您的應用程式會
顯示以下錯誤訊息：您的資料庫不允許您與 &lt;object name&gt; 物件做聚集。
YES：資料庫支援 GROUP BY 子句中的複雜表達式。
值
NO：資料庫不支援 GROUP BY 子句中的複雜表達式。
NO
預設
13.1.11
GROUP_BY_SUPPORTS_CONSTANT
&lt;Parameter Name=&quot;GROUP_BY_SUPPORTS_CONSTANT&quot;&gt;YES&lt;/Parameter&gt;
描述
204
指定資料庫是否支援在 GROUP BY 子句中使用常數物件。此參數用於 IBM DB2 和 Microsoft SQL
Server。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
PRM 參數參考
值
YES：資料庫支援在 GROUP BY 子句中使用常數物件。
NO：資料庫不支援在 GROUP BY 子句中使用常數物件。
預設
13.1.12
YES
HAVING
&lt;Parameter Name=&quot;HAVING&quot;&gt;NO&lt;/Parameter&gt;
描述
指定資料庫是否支援 SQL 敘述中的 HAVING 子句。
值
YES：資料庫支援 HAVING 子句。
NO：資料庫不支援 HAVING 子句。
預設
13.1.13
NO
INTERSECT
&lt;Parameter Name=&quot;INTERSECT&quot;&gt;INTERSECT&lt;/Parameter&gt;
描述
為 INTERSECT 設定作業指定資料庫所支援的關鍵字。
值
INTERSECT：資料庫支援的關鍵字為 INTERSECT。
沒有值：資料庫不支援 INTERSECT 設定作業的任何關鍵字。在這種情況下，會產生兩個查詢。
預設
13.1.14
INTERSECT
INTERSECT_ALL
&lt;Parameter Name=&quot;INTERSECT_ALL&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援 INTERSECT ALL 設定作業。
值
YES：資料庫支援 INTERSECT ALL 設定作業。
NO：資料庫不支援 INTERSECT ALL 設定作業。
預設
資料存取指引
PRM 參數參考
YES
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
205
13.1.15
INTERSECT_IN_SUBQUERY
&lt;Parameter Name=&quot;INTERSECT_IN_SUBQUERY&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援子查詢中的 INTERSECT 設定作業。
值
YES：資料庫支援子查詢中的 INTERSECT 設定作業。
NO：資料庫不支援子查詢中的 INTERSECT 設定作業。
13.1.16
JOIN
&lt;Parameter Name=&quot;JOIN&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援兩個表格間的 JOIN 作業。
值
YES：資料庫支援兩個表格任何資料行間的聯結。
STRUCTURE_JOIN：資料庫支援與參考條件約束關聯的兩個表格間的聯結作業。在此版本中與 NO
相同。
NO：資料庫不支援兩個表格間的聯結作業。
13.1.17
&lt;Parameter Name=&quot;LEFT_EXT_JOIN&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援左方外部聯結。
值
YES：資料庫支援左方外部聯結。
NO：資料庫不支援左方外部聯結。
13.1.18
LEFT_OUTER
&lt;Parameter Name=&quot;LEFT_OUTER&quot;&gt;$(+)&lt;/Parameter&gt;
&lt;Parameter Name=&quot;LEFT_OUTER&quot;&gt;$*&lt;/Parameter&gt;
描述
206
指定左外部聯結運算式使用的語法。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
PRM 參數參考
值
註記
$ 代表聯結運算式。
預設
請參閱以上的值。
範例
如果 table1.col1 在 Oracle 中聯結至 table2.col2，則產生的運算式為：table1.col1(+)
= table2.col2。
13.1.19
&lt;Parameter Name=&quot;LIKE_SUPPORTS_ESCAPE_CLAUSE&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援在 SQL 陳述式的 LIKE 條件內使用 ESCAPE 子句。
值
YES：資料庫支援 LIKE 條件中的 ESCAPE 子句。
NO：資料庫不支援 LIKE 條件中的 ESCAPE 子句。
預設
13.1.20
如果未指定此設定，「連線伺服器」會從資料庫中介軟體擷取資訊。
MINUS
&lt;Parameter Name=&quot;MINUS&quot;&gt;MINUS&lt;/Parameter&gt;
描述
為 MINUS 設定作業指定資料庫所支援的關鍵字。
值
MINUS：資料庫支援 MINUS 設定運算子。
EXCEPT：資料庫支援 EXCEPT 設定運算子。
沒有值：資料庫不支援 MINUS 設定作業的任何關鍵字。在這種情況下，會產生兩個查詢。
預設
13.1.21
MINUS
MINUS_ALL
&lt;Parameter Name=&quot;MINUS_ALL&quot;&gt;Yes&lt;/Parameter&gt;
資料存取指引
PRM 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
207
描述
指定資料庫是否支援 MINUS ALL 設定作業。
值
YES：資料庫支援 MINUS ALL 設定作業。
NO：資料庫不支援 MINUS ALL 設定作業。
13.1.22
MINUS_IN_SUBQUERY
&lt;Parameter Name=&quot;MINUS_IN_SUBQUERY &quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援子查詢中的 MINUS 設定作業。
值
YES：資料庫支援子查詢中的 MINUS 設定作業。
NO：資料庫不支援子查詢中的 MINUS 設定作業。
13.1.23
ORDER_BY
&lt;Parameter Name=&quot;ORDER_BY&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援 ORDER BY 子句。
值
YES：資料庫支援 ORDER BY 子句。
NO：資料庫不支援 ORDER BY 子句。
13.1.24
ORDER_BY_REQUIRES_SELECT
&lt;Parameter Name=&quot;ORDER_BY_REQUIRES_SELECT&quot;&gt;NO&lt;/Parameter&gt;
描述
值
指定資料庫是否需要 ORDER BY 子句中使用的資料行，做為 SELECT 陳述式中的參照。
YES：不允許使用者排序未包含在 SELECT 陳述式中的資料行。在此情況中，語意層設計工具中
[查詢] 面板的 [管理排序] 按鈕會變成灰色。
NO：允許使用者排序未包含在 SELECT 陳述式中的資料行。
預設
208
NO
SAP 關係企業。 保留所有權利。
資料存取指引
PRM 參數參考
13.1.25
ORDER_BY_SUPPORTS_COLUMN_INDEX
&lt;Parameter Name=&quot;ORDER_BY_SUPPORTS_COLUMN_INDEX&quot;&gt;YES&lt;/Parameter&gt;
描述
此參數會指定資料庫是否支援在 ORDER BY 子句中使用 SELECT 陳述式的資料行索引。
值
YES：資料庫支援使用 SELECT 陳述式的資料行索引取代資料行名稱。
NO：資料庫不支援使用 SELECT 陳述式的資料行索引取代資料行名稱。
13.1.26
&lt;Parameter Name=&quot;PERCENT_RANK_SUPPORTED&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援 Percent Rank 分析函式。請參閱您的資料庫文件以瞭解其如何實作百分比排
名。
值
預設
13.1.27
YES
RANK_SUPPORTED
&lt;Parameter Name=&quot;RANK_SUPPORTED&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援 SQL 陳述式中的 Rank 分析函式。
值
YES：資料庫支援 Rank。
NO：資料庫不支援 Rank。
預設
13.1.28
YES
&lt;Parameter Name=&quot;RIGHT_EXT_JOIN&quot;&gt;YES&lt;/Parameter&gt;
描述
資料存取指引
PRM 參數參考
指定資料庫是否支援右方外部聯結。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
209
YES：資料庫支援右方外部聯結。
值
NO：資料庫不支援右方外部聯結。
13.1.29
RIGHT_OUTER
&lt;Parameter Name=&quot;RIGHT_OUTER&quot;&gt;$(+)&lt;/Parameter&gt;
&lt;Parameter Name=&quot;RIGHT_OUTER&quot;&gt;*$&lt;/Parameter&gt;
描述
指定右外部聯結運算式使用的語法。
值
註記
$ 代表聯結運算式。
預設
請參閱以上的值。
13.1.30
SEED_SAMPLING_SUPPORTED
&lt;Parameter Name=&quot;SEED_SAMPLING_SUPPORTED&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援初始值取樣。初始值取樣是隨機取樣的變化型，其中的隨機初始值是由使用者
所提供。
值
YES：資料庫支援初始值取樣。
NO：資料庫不支援初始值取樣。
NO
預設
13.1.31
SELECT_SUPPORTS_NULL
&lt;Parameter Name=&quot;NULL_IN_SELECT_SUPPORTED&quot;&gt;YES&lt;/Parameter&gt;
描述
210
指定資料庫是否支援 NULL 在 SELECT 陳述式中做為資料行。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
PRM 參數參考
值
YES：資料庫支援 NULL 在 SELECT 陳述式中做為資料行。
NO：資料庫不支援 NULL 在 SELECT 陳述式中做為資料行。
預設
13.1.32
SUBQUERY_IN_FROM
&lt;Parameter Name=&quot;SUBQUERY_IN_FROM&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援在 FROM 子句中使用子查詢。
值
YES：資料庫支援在 FROM 子句中使用子查詢。
NO：資料庫不支援在 FROM 子句中使用子查詢。
13.1.33
SUBQUERY_IN_IN
&lt;Parameter Name=&quot;SUBQUERY_IN_IN&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援在 IN 子句中使用子查詢。
值
YES：資料庫支援在 IN 子句中使用子查詢。
NO：資料庫不支援在 IN 子句中使用子查詢。
13.1.34
SUBQUERY_IN_WHERE
&lt;Parameter Name=&quot;SUBQUERY_IN_WHERE&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援在 WHERE 子句中使用子查詢。
值
YES：資料庫支援在 WHERE 子句中使用子查詢。
NO：資料庫不支援在 WHERE 子句中使用子查詢。
資料存取指引
PRM 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
211
13.1.35
TECHNICAL_COLUMN_NAME_PATTERN
&lt;Parameter Name=&quot;TECHNICAL_COLUMN_NAME_PATTERN&quot;&gt;^(-idref)(.)*&lt;/Parameter&gt;
指定以 -idref 模式開頭的所有資料行都不會顯示在以 OData 資料來源為基礎的連線、資
描述
料基礎和語意層商務層中。因此，資訊設計工具無法使用這些資料行來建立查詢。
註記
請勿編輯此參數。
^(-idref)(.)*
值
13.1.36
UNION
&lt;Parameter Name=&quot;UNION&quot;&gt;UNION&lt;/Parameter&gt;
描述
為 UNION 設定作業指定資料庫所支援的關鍵字。
值
UNION：資料庫支援的關鍵字為 UNION。
沒有值：資料庫不支援 UNION 設定作業的任何關鍵字。在這種情況下，會產生兩個查詢。
UNION
預設
13.1.37
UNION_ALL
&lt;Parameter Name=&quot;UNION_ALL&quot;&gt;YES&lt;/Parameter&gt;
描述
指定資料庫是否支援 UNION ALL 設定作業。
值
YES：資料庫支援 UNION ALL 設定作業。
NO：資料庫不支援 UNION ALL 設定作業。
13.1.38
UNION_IN_SUBQUERY
&lt;Parameter Name=&quot;UNION_IN_SUBQUERY&quot;&gt;YES&lt;/Parameter&gt;
描述
212
指定資料庫是否支援在子查詢中使用 UNION 設定作業。
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
PRM 參數參考
值
YES：資料庫支援子查詢中的 UNION 設定作業。
NO：資料庫不支援子查詢中的 UNION 設定作業。
資料存取指引
PRM 參數參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
213
14 資料類型轉換參考
14.1 資料類型轉換
在資訊設計工具中，資料基礎會公開一個或多個關聯式資料庫中作為商務層基礎的表格。 與每個表格資料行相關聯的
資料類型將在資料基礎中與其他資料行詳細資料一併顯示。 商務層會將表格資料行公開為中繼資料物件，如維度和階
層，並顯示與每個物件相關聯的資料類型。 下表說明這兩組資料類型之間的對應方式：
資料基礎中顯示的資料類型
商務層中顯示的資料類型
BINARY、LONGVARBINARY、VARBINARY
BLOB
BIT
布林值
DATE
日期
TIME、TIMESTAMP
日期時間
LONGVARCHAR
長文字
BIGINT、DECIMAL、DOUBLE、FLOAT、INTEGER、
NUMERIC、REAL、SMALLINT、TINYINT
數值
CHAR、VARCHAR、XML
字串
UNDEFINED
未知
註記
所有資料庫中的時間皆遵循 BI 平台中的 DateTime 規範。 DateTime 的日期部分應正常顯示為終端使用者報表的目
前日期。
資料存取層管理將網路層公開的資料類型轉換為「連線伺服器」資料類型，然後對應至資料基礎公開的資料類型。
本節提供一般網路層資料類型 (JDBC 和 ODBC) 與資料基礎資料類型之間的轉換表格， 同時也提供特定網路層 (如
OLE DB、Oracle OCI 和 Sybase CTL) 的轉換表格，並描述特定資料庫 (如 CSV 檔案、SAP ERP 系統和 SAP HANA
資料庫) 的非一般轉換和例外狀態。
相關資訊
CSV 檔案資料類型 [第 215 頁]
JDBC 資料類型 [第 215 頁]
ODBC 資料類型 [第 218 頁]
OData 資料類型 [第 220 頁]
OLE DB 資料類型 [第 221 頁]
214
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料類型轉換參考
Oracle OCI 資料類型 [第 222 頁]
SAP ERP 資料類型 [第 223 頁]
SAP HANA 資料類型 [第 224 頁]
Sybase CTL 資料類型 [第 224 頁]
XML 資料類型 [第 226 頁]
14.1.1
CSV 檔案資料類型
語法：
下表列出 DDL 檔案中針對 CSV 檔案結構描述偵測宣告的資料類型，以及其在資料基礎中的等值。
.
DDL 檔案中宣告的類型
資料基礎資料類型
BIT、BOOLEAN
BIT
DATE
DATE
TIME
TIME
TIMESTAMP
TIMESTAMP
BIGINT、DECIMAL
DECIMAL
FLOAT、DOUBLE、REAL
DOUBLE
INTEGER、INT、SMALLINT
INTEGER
NUMBER、NUMERIC
NUMERIC
VARCHAR
VARCHAR
相關資訊
CSV 結構描述偵測 [第 66 頁]
14.1.2
JDBC 資料類型
語法：
下表列出透過 JDBC 顯示的資料類型，以及其在資料基礎中的等值。
資料存取指引
資料類型轉換參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
215
JDBC 資料類型
資料基礎資料類型
BINARY
BINARY
VARBINARY
VARBINARY
BLOB、LONGVARBINARY
LONGVARBINARY
BIT、BOOLEAN
NUMERIC
CLOB、NCLOB
LONGVARCHAR
DATE
DATE
TIME
TIME
TIMESTAMP
TIMESTAMP
DOUBLE
DOUBLE
FLOAT
FLOAT
REAL
REAL
SMALLINT
SMALLINT
CHAR、NCHAR
CHAR
LONGNVARCHAR、LONGVARCHAR、NVARCHAR、
ROWID、VARCHAR
VARCHAR
SQLXML
XML
IBM Informix
下表列出使用者透過 JDBC 查詢 IBM Informix 資料庫時，在結果中可能顯示的資料類型，以及其在資料基礎中的等
值。 這些資料類型將覆寫一般資料類型。
216
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料類型轉換參考
資料基礎資料類型
TIMESTAMP
可對應至下列類型：
●
●
●
BOOLEAN
TIMESTAMP (在其他情況下)
SMALLINT
MS SQL Server
下表列出使用者透過 JDBC 查詢 MS SQL Server 資料庫時，在結果中可能顯示的資料類型，以及其在資料基礎中的等
值。 對應的資料類型還取決於與網路層資料類型相關聯的 SQL 類型名稱。 而這些資料類型將覆寫一般資料類型。
MS SQL Server JDBC 資料類型
SQL 類型名稱
資料基礎資料類型
LONGVARCHAR
除「xml」外的任何其他值
VARCHAR
LONGVARCHAR
xml
XML
Oracle
下表列出使用者透過 JDBC 查詢 Oracle 資料庫時，在結果中可能顯示的資料類型，以及其在資料基礎中的等值。 對應
的資料類型還取決於與網路層資料類型相關聯的 SQL 類型名稱。 而這些資料類型將覆寫一般資料類型。
Oracle JDBC 資料類型
SQL 類型名稱
資料基礎資料類型
BFILE
任意值
LONGVARBINARY
任意值
BFILE
LONGVARBINARY
DATE
任意值
TIMESTAMP
任意值
TIMESTAMP
TIMESTAMP
BINARY_DOUBLE
任意值
DOUBLE
OTHER
FLOAT
DOUBLE
BINARY_FLOAT
任意值
REAL
資料存取指引
資料類型轉換參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
217
Oracle JDBC 資料類型
SQL 類型名稱
資料基礎資料類型
任意值
NCHAR
CHAR
任意值
NVARCHAR2、ROWID、UROWID
VARCHAR
14.1.3
ODBC 資料類型
語法：
下表列出透過 ODBC 顯示的資料類型，以及其在資料基礎中的等值。
ODBC 資料類型
資料基礎資料類型
SQL_BINARY
BINARY
SQL_VARBINARY
VARBINARY
SQL_LONGVARBINARY
LONGVARBINARY
SQL_BIT
BIT
SQL_DATE、SQL_TYPE_DATE
DATE
TIMESTAMP
SQL_LONGVARCHAR、SQL_WLONGVARCHAR
LONGVARCHAR
SQL_BIGINT
BIGINT
SQL_DECIMAL
DECIMAL
SQL_DOUBLE
DOUBLE
SQL_FLOAT
FLOAT
SQL_INTEGER
INTEGER
SQL_NUMERIC
NUMERIC
SQL_REAL
REAL
SQL_SMALLINT
SMALLINT
TINYINT
CHAR
218
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料類型轉換參考
ODBC 資料類型
資料基礎資料類型
SQL_VARCHAR、SQL_WVARCHAR
VARCHAR
IBM DB2
下表列出使用者透過 ODBC 查詢 IBM DB2 資料庫時，在結果中可能顯示的資料類型，以及其在資料基礎中的等值。
這些資料類型將覆寫一般資料類型。
DB2 ODBC 資料類型
資料基礎資料類型
SQL_BLOB
LONGVARBINARY
SQL_CLOB、SQL_DBCLOB、
SQL_LONGVARGRAPHIC
LONGVARCHAR
SQL_DECFLOAT
DOUBLE
SQL_GRAPHIC
CHAR
SQL_VARGRAPHIC
VARCHAR
SQL_XML
XML
IBM Informix
下表列出使用者透過 ODBC 查詢 IBM Informix 資料庫時，在結果中可能顯示的資料類型，以及其在資料基礎中的等
值。 而這些資料類型將覆寫一般資料類型。
Informix ODBC 資料類型
資料基礎資料類型
SQL_BIT
SMALLINT
LONGVARBINARY
可對應至下列類型：
●
●
●
資料存取指引
資料類型轉換參考
TIMESTAMP (在其他情況下)
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
219
資料基礎資料類型
LONGVARCHAR
MS SQL Server
下表列出使用者透過 ODBC 查詢 MS SQL Server 資料庫時，在結果中可能顯示的資料類型，以及其在資料基礎中的等
值。 而這些資料類型將覆寫一般資料類型。
MS SQL Server ODBC 資料類型
資料基礎資料類型
TIMESTAMP
SQL_SS_XML
XML
14.1.4 OData 資料類型
語法：
下表列出 OData 資料來源內部的實體資料模型 (EDM) 資料類型，以及其在資料基礎中的等值。
OData 資料類型
資料基礎資料類型
BINARY
BIT
Edm.DateTime、Edm.Time
TIMESTAMP
註記
奈秒值不會對應。
BIGINT
Edm.Decimal
DECIMAL
DOUBLE
FLOAT
INTEGER
Edm.Byte、Edm.Int16、Edm.SByte
SMALLINT
220
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料類型轉換參考
OData 資料類型
資料基礎資料類型
Edm.DateTimeOffset、Edm.Guid、Edm.String
VARCHAR
14.1.5
OLE DB 資料類型
語法：
下表列出透過 OLE DB 顯示的資料類型，以及其在資料基礎中的等值。
註記
對於某些資料類型，對應取決於與每個類型相關聯之 DBCOLUMNFLAGS_ISLONG 和
DBCOLUMNFLAGS_ISFIXEDLENGTH 參數的值。
OLE DB 資料類型
資料基礎資料類型
DBTYPE_BYTES
VARBINARY
如果 DBCOLUMNFLAGS_ISLONG=true，則為
DBTYPE_BYTES
LONGVARBINARY
如果 DBCOLUMNFLAGS_ISFIXEDLENGTH=true，則為
DBTYPE_BYTES
BINARY
DBTYPE_BOOL
BIT
DBTYPE_DBDATE
DATE
DBTYPE_DBTIME
TIME
DBTYPE_DBTIMESTAMP
TIMESTAMP
DBTYPE_DECIMAL
DECIMAL
TINYINT
SMALLINT
INTEGER
BIGINT
DBTYPE_R4
REAL
DBTYPE_R8
DOUBLE
DBTYPE_CY、DBTYPE_NUMERIC
NUMERIC
資料存取指引
資料類型轉換參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
221
OLE DB 資料類型
資料基礎資料類型
DBTYPE_STR、DBTYPE_WSTR
VARCHAR
如果 DBCOLUMNFLAGS_ISLONG=true，則為 DBTYPE_STR、 LONGVARCHAR
DBTYPE_WSTR
CHAR
如果 DBCOLUMNFLAGS_ISFIXEDLENGTH=true，則為
DBTYPE_STR、DBTYPE_WSTR
MS SQL Server 資料類型
下表顯示使用者透過 OLE DB 查詢 MS SQL Server 資料庫時，在結果中可能顯示的資料類型，以及其在資料基礎中的
等值。 這些資料類型將覆寫之前的資料類型。
MS SQL Server OLE DB 資料類型
資料基礎資料類型
DBTYPE_DBTIME2、DBTYPE_DBTIMESTAMPOFFSET TIMESTAMP
DBTYPE_GUID
CHAR
DBTYPE_XML
XML
14.1.6 Oracle OCI 資料類型
語法：
下表列出透過 Oracle OCI 顯示的資料類型，以及其在資料基礎中的等值。
Oracle OCI 資料類型
資料基礎資料類型
SQLT_BIN
BINARY
SQLT_BFILE、SQLT_BLOB、SQLT_LBI
LONGVARBINARY
TIMESTAMP
LONGVARCHAR
DOUBLE
SQLT_IBFLOAT
REAL
222
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料類型轉換參考
Oracle OCI 資料類型
資料基礎資料類型
SQLT_NUM
NUMERIC
CHAR
VARCHAR
14.1.7
SAP ERP 資料類型
語法：
下表列出 SAP ERP 系統所使用的 ABAP 資料類型，以及其在資料基礎中的等值。
ABAP 資料類型
資料基礎資料類型
HEXADECIMAL
BINARY
DATE
DATE
TIME
TIME
FLOAT
FLOAT
INTEGER
INTEGER
NUMERIC TEXT、PACKED NUMBER
NUMERIC
TEXT
CHAR
VARIABLE LENGTH STRING
VARCHAR
SQL 運算式中的日期格式
在「SQL 運算式編輯器」中建立查詢時，應用程式使用者必須使用的日期格式為 DATE'yyyy-mm-dd'，例如：
DATE'2013-04-10'。
格式會在包含 USER_INPUT_DATE_FORMAT 參數的 jco.prm 擴充 PRM 檔案中指定， 請參閱《資訊設計工具使用指
南》。
相關資訊
關於 PRM 檔 [第 197 頁]
資料存取指引
資料類型轉換參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
223
14.1.8 SAP HANA 資料類型
語法：
下列表格列出 SAP HANA 資料庫中所使用的資料類型及其在資料基礎中的等值。 如需有關 SAP HANA 資料類型的資
訊，請參閱「SAP HANA 資料類型參考」。
SAP HANA 資料類型
資料基礎資料類型
BLOB
LONGVARBINARY
VARBINARY
VARBINARY
DATE
DATE
TIME
TIME
LONGDATE、SECONDDATE、TIMESTAMP
TIMESTAMP
註記
SECONDDATE 會轉換為 TIMESTAMP (無毫秒)。
DECIMAL、REAL、SMALLDECIMAL
FLOAT
BIGINT、INTEGER、SMALLINT、TINYINT
INTEGER
DOUBLE
DOUBLE
CLOB、NCLOB、TEXT
LONGVARCHAR
ALPHANUM、NVARCHAR、SHORTTEXT、VARCHAR
VARCHAR
相關資訊
SAP HANA 資料類型參考
14.1.9 Sybase CTL 資料類型
語法：
下表列出透過 Sybase CTL 顯示的資料類型，以及其在資料基礎中的等值。
註記
Sybase CTL 資料類型為實際由網路層公開之 CS_DATAFMT 結構的 datatype 欄位值。 還會為某些資料類型提供該
結構的 usertype 欄位值，用於資料存取層對應。
224
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料類型轉換參考
資料基礎資料類型
CS_BINARY_TYPE
CS_BINARY_USERTYPE
BINARY
CS_BINARY_TYPE
CS_VARBINARY_USERTYPE 或沒有值 VARBINARY
CS_LONGBINARY_TYPE
任意值
VARBINARY
任意值
LONGVARBINARY
任意值
BIT
任意值
DATE
任意值
TIMESTAMP
任意值
LONGVARCHAR
任意值
BIGINT
任意值
DECIMAL
任意值
DOUBLE
任意值
INTEGER
CS_NUMERIC_TYPE
任意值
NUMERIC
任意值
REAL
任意值
SMALLINT
CS_TINYINT_TYPE
任意值
TINYINT
CHAR
VARCHAR
資料存取指引
資料類型轉換參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
225
資料基礎資料類型
CHAR
VARCHAR
14.1.10 XML 資料類型
語法：
下表列出 XML 內建資料類型，以及其在資料基礎中的等值。
XML 內建資料類型
資料基礎資料類型
布林值
BIT
base64Binary、hexBinary
●
如果已定義長度，則為 BINARY
●
VARBINARY
日期
DATE
時間
TIME
日期時間
TIMESTAMP
float
FLOAT
double、decimal
DOUBLE
integer、negativeInteger、nonPositiveInteger、
noNegativeInteger、positiveInteger
DECIMAL
long、unsignedLong
BIGINT
INTEGER
SMALLINT
byte、unsignedByte
TINYINT
字串
●
如果已定義長度，則為 CHAR
●
VARCHAR
註記
從字串衍生的資料類型會對應至 CHAR 或
VARCHAR。
226
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料類型轉換參考
XML 內建資料類型
資料基礎資料類型
VARCHAR
對應資料行中繼資料
●
從資料類型判斷帶正負號或不帶正負號。
●
從 nullable 和 minOccurs 屬性判斷是否可為 Null。
●
從資料類型判斷資料行大小、小數位數和顯示大小。 如果無法從類型判斷，則會傳回使用者可設定的最大長度。
14.2 大型變數長度資料限制
限制
下列資訊僅與 Crystal Reports 應用程式相關。
由於資料存取層實作，大型變數長度二進位和字元資料的資料行大小上限對於下列資料來源限於 16MB：
●
●
透過 ODBC 的 MS SQL Server
●
如果應用程式使用者將超過 16MB 的大型變數長度資料插入報表中，則可能會影響系統效能。
14.3 啟用多來源語意層的資料類型對應
若為已啟用多來源的資料基礎，「連線伺服器」資料類型將轉換為透過資料聯邦服務公開的資料類型。
資料聯邦資料類型如下所示：
●
BIT
●
DATE
●
TIME
●
TIMESTAMP
●
DOUBLE
●
DECIMAL
●
INTEGER
●
VARCHAR
資料存取指引
資料類型轉換參考
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
227
這些類型將會對應至相對應的資料基礎資料類型。
警告
不支援 BINARY、VARBINARY 和 LONGVARBINARY 類型，而這些類型的值將會對應至 NULL。
228
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
資料存取指引
資料類型轉換參考
法律層面重要免責聲明
本文件僅供參考。 文件內容如有變更，恕不另行通知，且 SAP 並不保證內容皆正確無誤。 SAP 不以明示或默示等任何形式擔保商業適售性或特定用途適用性。
編碼範例
此文件所包含的任何軟體編碼和/或程式碼行/字串 (「程式碼」) 僅為範例，不應作為正式運作系統環境之用。 程式碼僅應用於解釋和具體呈現特定編碼的語法及編寫規則。 SAP
不保證在此所提供程式碼的正確性及完整性，除非使用程式碼所產生的錯誤或損毀由 SAP 的故意或重大過失所致，否則 SAP 概不負責。
協助工具
SAP 文件中所包含的資訊，僅代表 SAP 自出版日起對於可及性準則的當前觀點，絕非作為確保軟體產品可及性的約束性指南。 SAP 明確聲明不具任何關於本文件的責任，且本
文件不直接或間接產生任何契約義務或承諾。
性別中立語言
SAP 文件盡可能保持性別中立。 依內容而定，文件直接稱呼讀者為「您」或使用其他性別中立的名詞，例如：「銷售人員」(sales person) 或「工作日」(working days)。 指涉
兩性雙方的成員，但無法避免使用第三人稱單數或沒有性別中立的名詞時，SAP 保留使用男性名詞和男性代名詞的權利。 此用法僅為確保文件的可理解性。
網際網路超連結
SAP 文件可能包含網際網路超連結。 這些超連結用於作為相關資訊所在位置的提示。 SAP 不保證此相關資訊的可用性、正確性，或用於特定目的的適用性。 除非使用此相關資
訊所產生的損毀由 SAP 的故意或重大過失所致，否則 SAP 概不負責。 關於連結分類，請參閱： http://help.sap.com/disclaimer.
資料存取指引
法律層面重要免責聲明
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
229
&copy; 2014 SAP SE 或
SAP 關係企業。 保留所有權利。
未經 SAP SE 或 SAP 關係企業的明確許可，不得以任何形式或出於任
何目的複製或傳輸本出版物的任何部分。 此處所包含資訊如有變更，
恕不提前通知。
SAP SE 與其經銷商所販售之部份軟體產品包含其他軟體供應商的專有
軟體元件。 國家產品規格可能不同。
這些材料由 SAP SE 或 SAP 關係企業僅出於參考目的提供，不存在任
何類型的聲明或保固，並且 SAP 或其關係企業不應對材料中的錯誤或
疏漏負責。 對於 SAP 或 SAP 關係企業產品和服務的唯一保固，詳載於
此類產品和服務隨附之明確保固聲明中（若有）。 在此提供的任何資
料不可推斷為附加保固條款。
本文中所提及的 SAP 及其他 SAP 產品和服務以及其各自的標誌為位於
德國和其他國家或地區的 SAP SE（或 SAP 關係企業）的商標或註冊
商標。 此處所提及之所有其他產品與服務名稱皆為其相對應公司的商
標。
如需瞭解其他商標資訊和通知，請參閱 http://www.sap.com/
corporate-en/legal/copyright/index.epx。">
Hello! I am an AI chatbot specifically trained to assist you with the SAP 4.1 Support Package 5 User Guide. I have thoroughly reviewed the document and can help you locate the exact information you need or explain the content in clear and simple terms. Whether you’re looking for guidance on specific features, troubleshooting steps, or general usage, feel free to ask your questions. The more details you provide about your concerns or needs, the more accurately and effectively I can assist you!
Show related prompts
Assistant typing
Assistant is out of keyboard. Please, try again later.
It looks like you''ve reached a document that is written in multiple languages, including one that isn''t your native language. You can use the following links to temporarily hide pages without the language you prefer.
Key features

Data access to various data sources
Connection establishment
Global settings configuration
Driver references
Specific connection requirements
Frequently asked questions

The Business Intelligence Platform supports a wide range of data sources, including relational databases, OLAP cubes, flat files, and Web services. Refer to the "Data Access Drivers Reference" section for a comprehensive list and detailed information.
The guide provides step-by-step instructions for creating JDBC, JavaBean, and ODBC connections. Each connection type has its own specific requirements and configuration settings. Refer to the "Creating Connections" section for detailed information.
Global settings are controlled by the "cs.cfg" configuration file. This file allows you to define parameters such as character sets, deployment mode, and logging options. Refer to the "Configuring Global Data Access Parameters" section for detailed information.