SAP Business Intelligence Platform Data Access Guide

SAP BusinessObjects Business Intelligence 平台
文档版本： 4.1 Support Package 5 - 2014-11-14
数据访问指南
目录
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 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4
了解数据访问细节. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.1
64 位操作系统支持. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.1.1
64 位 UNIX 支持. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.1.2
64 位 Microsoft Windows 支持. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.1.3
安装 ODBC 驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.2
单一登录支持. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.3
存储过程. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.4
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
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
目录
4.5
4.6
负载平衡. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
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
CA Wily Introscope 工作站中的活动. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
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
Check Tool— list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
5.2.5
检查工具 － driverssearch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
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 信息. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
创建 JDBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
5.3.1
使用 SBO 文件创建 JDBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
5.3.2
JDBC SBO 示例文件结构. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
5.3.3
使用 Extensions 创建 JDBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
5.3.4
创建通用 JDBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
5.3.5
JAR 文件位置参考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
5.3.6
查找 JDBC 驱动程序的版本. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
创建 JavaBean 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
5.4.1
创建 JavaBean 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
5.4.2
JavaBean SBO 示例文件结构. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
5.4.3
使用 Extensions 创建 JavaBean 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
创建 ODBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
5.5.1
创建通用 ODBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
5.5.2
创建通用 ODBC3 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
5.6
在执行修补程序安装后添加新的驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
5.7
设置多数据源工作流中的区域设置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
数据访问指南
目录
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
3
6
数据访问驱动程序参考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
6.1
数据访问驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.2
CSV OpenDriver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.3
6.4
6.5
4
6.2.1
CSV OpenDriver 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
6.2.2
CSV OpenDriver － 表映射. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
6.2.3
CSV 文件位置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
6.2.4
CSV 模式检测. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
OData 驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
6.3.1
OData 驱动程序功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
6.3.2
OData 服务位置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
6.3.3
OData 服务示例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
6.3.4
OData 驱动程序 － 映射命名空间、所有者和限定符. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
6.3.5
OData 驱动程序 － 映射表. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
6.3.6
OData 驱动程序 － 映射列. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
6.3.7
OData 驱动程序 － 映射键. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
6.3.8
OData 驱动程序 － 映射 Documentation 元素. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
6.3.9
OData 驱动程序 － 映射派生类型的实体. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
6.3.10
监控 OData 驱动程序性能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
6.3.11
OData 驱动程序 － 重要行为与限制. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
6.3.12
OData 驱动程序 － 配置列最大大小. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
6.3.13
OData 源身份验证. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
6.3.14
跟踪 OData 驱动程序活动. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
SAP ERP 驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
6.4.1
SAP ERP 驱动程序功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
6.4.2
SAP ERP 驱动程序 － 访问 InfoSet 和 SAP 查询. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
6.4.3
SAP ERP 驱动程序 － 访问 ABAP 函数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
6.4.4
SAP ERP 驱动程序限制. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
XML 驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
6.5.1
XML 驱动程序功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
6.5.2
XML 文件位置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
6.5.3
XML 文档和模式示例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
6.5.4
XML 驱动程序 － 映射多个文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
6.5.5
XML 驱动程序 － 映射表. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
6.5.6
XML 驱动程序 － 映射列. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
6.5.7
XML 驱动程序 － 映射主键和外键. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
6.5.8
XML 驱动程序 － 映射混合元素. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
6.5.9
XML 驱动程序 － 映射递归元素. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
6.5.10
XML 驱动程序 － 映射 any 和 anyAttribute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
6.5.11
XML 驱动程序 － 映射 anyType 和 simpleType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
目录
6.5.12
6.6
XML 驱动程序 － 配置列最大大小. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Web 服务驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
6.6.1
Web 服务驱动程序功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
6.6.2
Web 服务位置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
6.6.3
Web 服务定义示例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
6.6.4
Web 服务的映射规则. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
6.6.5
Web 服务驱动程序 － 配置列最大大小. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
6.7
本地磁盘用作排序操作的缓存. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
7
连接参考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
7.1
HIVE 和 Impala 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
7.1.1
创建与 Apache Hadoop HIVE 的 JDBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
7.1.2
创建与 Apache Hadoop HIVE 的 ODBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
7.1.3
执行平台更新后使 HIVE 连接可用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
7.1.4
创建与 Amazon EMR HIVE 的 JDBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
7.1.5
创建与 Amazon EMR HIVE 的 ODBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
7.1.6
创建到 Cloudera Impala 的 JDBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
7.1.7
创建到 Cloudera Impala 的 ODBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
7.2
IBM DB2 连接 － 引用键映射到 NULL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
7.3
IBM Informix 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
7.3.1
为 IBM Informix 连接设置 JVM 时区. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
7.3.2
为 IBM Informix 连接设置事务模式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
7.4
MS Analysis Services 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
7.5
MS SQL Server 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
7.6
7.5.1
到 MS SQL Server 的 OLE DB 连接的同义词支持. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
7.5.2
在 UNIX 上设置到 MS SQL Server 的连接的 JVM 选项. . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Oracle 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
7.6.1
到 Oracle 服务器群集的连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
7.6.2
设置 Oracle CURSOR_SHARING 参数值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
7.6.3
MySQL 连接 － 信息设计工具中某些工作流所需的数据库权限. . . . . . . . . . . . . . . . . . . . . . 121
7.6.4
在挪威语（伯克梅尔）界面语言下在信息设计工具中使用 Oracle JDBC 连接. . . . . . . . . . . . 121
7.7
Oracle EBS 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
7.8
Oracle Essbase 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
7.9
Oracle RAC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
7.10
salesforce.com 连接 － 配置环境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
7.11
7.10.1
使 salesforce.com 连接在信息设计工具中工作. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
7.10.2
使 salesforce.com 连接在 Universe 设计工具中工作. . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
SAP Business Warehouse 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
7.11.1
数据访问指南
目录
启用 SAP BW 64 位连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
5
7.12
SAP ERP 连接 － 驱动程序加载失败. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
7.13
SAP HANA 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
7.13.1
创建 SAP HANA 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
7.13.2
编辑 SAP HANA 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
7.13.3
为 SAP HANA 连接配置单一登录之前. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
7.13.4
为信息设计工具配置到 SAP HANA 的单一登录. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
7.13.5
为 Web Intelligence 配置到 SAP HANA 的单一登录. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
7.13.6
为 Web Intelligence 胖客户端配置到 SAP HANA 的单一登录. . . . . . . . . . . . . . . . . . . . . . . 131
7.13.7
配置 Java 虚拟机使用 SAP HANA 连接进行检测. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
7.14
SAP MaxDB 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
7.15
SAP BW 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
7.16
7.15.1
将 Data Federator 连接到 SAP BW 的要求. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
7.15.2
使 SAP BW 连接在信息设计工具中工作的要求. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
7.15.3
访问基于 SAP BW 的启用多源的 Universe 的要求. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
SAS 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
7.16.1
安装用于 SAS 连接的驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134
7.17
Teradata 连接 － 将 Teradata 数据库映射到当前所有者. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
8
创建与 Data Federator XI 3.0 查询服务器的连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136
8.1
关于 Data Federator XI 3.0 查询服务器连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
8.2
为 Data Federator JDBC 或 ODBC 连接配置连接向导. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
8.3
配置 Data Federator ODBC 连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
8.4
8.3.1
配置 Data Federator ODBC 中间件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
8.3.2
为 Data Federator ODBC 连接配置连接服务器. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
使用 Data Federator ODBC 中间件配置 Web Intelligence 胖客户端连接. . . . . . . . . . . . . . . . . . . . . . 139
8.4.1
为 Web Intelligence 胖客户端连接配置 Data Federator ODBC 中间件. . . . . . . . . . . . . . . . 139
8.4.2
为 Data Federator 的 Web Intelligence 胖客户端连接配置连接服务器. . . . . . . . . . . . . . . . .140
8.4.3
设置 Windows RichClient 注册表项. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
8.4.4
为 Web Intelligence 胖客户端或 Universe 设计工具与 Data Federator 之间的连接配置连接
服务器. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
9
配置数据访问全局参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
9.1
关于全局参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
9.2
关于 cs.cfg 配置文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
9.3
查看和编辑 cs.cfg 文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
9.4
配置全局设置参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
6
9.4.1
Charset List Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
9.4.2
Config File Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
9.4.3
Description Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
9.4.4
Ignore Driver Load Failure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
目录
9.4.5
Load Drivers On Startup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
9.4.6
Max Pool Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
9.4.7
Setup File Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
9.4.8
SQL External Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
9.4.9
SQL Parameter Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
9.4.10
Strategies Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
9.4.11
Validate Configuration Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
9.4.12
Validate XML Streams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
9.4.13
JVM 设置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
9.5
设置部署模式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
9.6
配置部署模式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
9.7
配置要加载的驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
9.7.1
为每台计算机设置一个连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
9.8
配置 CORBA 访问协议. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
9.9
激活连接服务器和驱动程序的日志和跟踪。. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
9.10
9.9.1
关于 _trace.ini 配置文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
9.9.2
在 cs.cfg 文件中激活日志和跟踪. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
9.9.3
以库模式激活日志和跟踪. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155
9.9.4
以服务器模式激活日志和跟踪. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
9.9.5
读取日志和跟踪. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
激活 OLAP 客户端的日志和跟踪. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
9.10.1
日志示例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
10
配置数据访问驱动程序参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
10.1
配置驱动程序参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
10.2
10.1.1
数据访问配置文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
10.1.2
已安装的 SBO 文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161
10.1.3
查看和编辑 SBO 文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
10.1.4
自定义 SBO 文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
10.1.5
动态检查连接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
10.1.6
JDBC 驱动程序属性. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
关于 DataDirect ODBC 驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
10.2.1
启用有品牌的 DataDirect 驱动程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167
11
SBO 参数参考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
11.1
SBO 文件结构. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
11.2
SBO 参数说明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
11.3
公共 SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170
11.3.1
Array Bind Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
11.3.2
Array Bind Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
数据访问指南
目录
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
7
11.4
8
11.3.3
Array Fetch Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
11.3.4
Array Fetch Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
11.3.5
BigDecimal Max Display Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
11.3.6
Binary Max Length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
11.3.7
Bucket Split Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
11.3.8
Catalog Separator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
11.3.9
CharSet Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
11.3.10
Description File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
11.3.11
Dictionary Transaction Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
11.3.12
Driver Capabilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
11.3.13
Driver Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175
11.3.14
Escape Character. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
11.3.15
Extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176
11.3.16
Family. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
11.3.17
Force Execute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
11.3.18
Identifier Case. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
11.3.19
Identifier Quote String. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
11.3.20
Include Synonyms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
11.3.21
Integer Max Length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
11.3.22
Introscope Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
11.3.23
Max Rows Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
11.3.24
Native Int64 Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
11.3.25
Optimize Execute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
11.3.26
Owners Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
11.3.27
Qualifiers Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
11.3.28
Query TimeOut Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
11.3.29
Quote Identifiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
11.3.30
Skip SAML SSO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
11.3.31
SQL External File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
11.3.32
SQL Parameter File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
11.3.33
SSO Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182
11.3.34
Strategies File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
11.3.35
String Max Length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
11.3.36
Temp Data Dir. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
11.3.37
Transactional Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
11.3.38
Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
11.3.39
Unicode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
11.3.40
URL Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
11.3.41
XML Max Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186
JavaBean SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
目录
11.4.1
11.5
JCO SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
11.5.1
11.6
11.7
11.9
11.10
11.6.1
Connection Shareable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
11.6.2
Escape Character Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
11.6.3
ForeignKeys Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
11.6.4
Get Extended Column. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
11.6.5
JDBC Class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
11.6.6
PrimaryKey Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
11.6.7
PVL Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
11.6.8
Shared Connection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
11.6.9
JDBC ResultSet Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
11.6.10
JDBC ResultSet Concurrency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
OData SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
11.12
11.8.1
CharSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
11.8.2
Connection Status Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
11.8.3
Cost Estimate Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
11.8.4
Empty String. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193
11.8.5
ODBC Cursors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194
11.8.6
SQLDescribeParam Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
11.8.7
SQLMoreResults Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
11.8.8
Use DataDirect OEM Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
11.8.9
V5toV6DriverName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
OLE DB SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
11.9.1
Enumerator CLSID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
11.9.2
Provider CLSID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196
OLE DB OLAP SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196
MSOlap CLSID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196
Sybase SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
11.11.1
Driver Behavior. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
11.11.2
Password Encryption. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
11.11.3
Quoted Identifier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
11.11.4
Recover Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198
11.11.5
Text Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Teradata SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
11.12.1
12
Enforce Max Protocol Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
ODBC SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
11.10.1
11.11
ERP Max Rows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187
JDBC SBO 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
11.7.1
11.8
JavaBean Class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186
Replace Current Owner With Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198
配置数据库功能参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
数据访问指南
目录
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
9
12.1
关于数据库功能参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
12.2
关于 PRM 文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
12.2.1
PRM 参数文件结构. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
12.3
查看和编辑 PRM 文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
12.4
验证 PRM 文件的分析函数支持以及添加分析函数支持. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
12.5
查看和编辑函数帮助文本文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
12.6
编辑 PRM 函数的帮助文本. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
13
PRM 参数参考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
13.1
PRM 文件配置参考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
10
13.1.1
ANALYTIC_CLAUSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
13.1.2
ANALYTIC_FUNCTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
13.1.3
CALCULATION_FUNCTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
13.1.4
CONSTANT_SAMPLING_SUPPORTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
13.1.5
DISTINCT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
13.1.6
EXT_JOIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
13.1.7
FULL_EXT_JOIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
13.1.8
GROUP_BY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
13.1.9
GROUP_BY_SUPPORTS_COLUMN_INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
13.1.10
GROUP_BY_SUPPORTS_COMPLEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
13.1.11
GROUP_BY_SUPPORTS_CONSTANT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
13.1.12
HAVING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
13.1.13
INTERSECT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
13.1.14
INTERSECT_ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
13.1.15
INTERSECT_IN_SUBQUERY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
13.1.16
JOIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
13.1.17
LEFT_EXT_JOIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
13.1.18
LEFT_OUTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
13.1.19
LIKE_SUPPORTS_ESCAPE_CLAUSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
13.1.20
MINUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
13.1.21
MINUS_ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
13.1.22
MINUS_IN_SUBQUERY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
13.1.23
ORDER_BY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
13.1.24
ORDER_BY_REQUIRES_SELECT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
13.1.25
ORDER_BY_SUPPORTS_COLUMN_INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
13.1.26
PERCENT_RANK_SUPPORTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
13.1.27
RANK_SUPPORTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
13.1.28
RIGHT_EXT_JOIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
13.1.29
RIGHT_OUTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
13.1.30
SEED_SAMPLING_SUPPORTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
目录
13.1.31
SELECT_SUPPORTS_NULL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
13.1.32
SUBQUERY_IN_FROM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
13.1.33
SUBQUERY_IN_IN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
13.1.34
SUBQUERY_IN_WHERE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
13.1.35
TECHNICAL_COLUMN_NAME_PATTERN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
13.1.36
UNION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
13.1.37
UNION_ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
13.1.38
UNION_IN_SUBQUERY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
14
数据类型转换参考. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
14.1
数据类型转换. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
14.1.1
CSV 文件数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
14.1.2
JDBC 数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
14.1.3
ODBC 数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
14.1.4
OData 数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
14.1.5
OLE DB 数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
14.1.6
Oracle OCI 数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
14.1.7
SAP ERP 数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226
14.1.8
SAP HANA 数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
14.1.9
Sybase CTL 数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
14.1.10
XML 数据类型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
14.2
大型变量长度数据的限制. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231
14.3
启用多源的 Universe 的数据类型映射. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
数据访问指南
目录
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
11
1
文档版本历史记录
下表概述了最重要的文档更改。
版本
SAP
BusinessObjects
Business Intelligence 平
台 4.1
日期
更改的内容
2013 年
提供新的 OData、XML 和 Web 服务驱动程序，请参阅数据访问驱动
5月
程序 [第 64 页]。
支持 Teradata 13、Teradata 14 和 Sybase IQ 的单一登录，请参阅单
一登录支持 [第 27 页]。
支持 SAP HANA 存储过程，请参阅 SAP HANA 存储过程 [第 30
页]。
对于 SAP ERP 连接，简化了可选输入列的映射，请参阅 SAP ERP 驱
动程序 － 访问 ABAP 函数 [第 85 页]。
对于 SAP HANA 连接，支持新的 SAP HANA SPS 05 版本、OLAP
连接、通过 SAML 协议和 SSL 协议的单一登录以及通过 ODBC 的 64 位
UNIX 平台，请参阅 SAP HANA 连接 [第 126 页]。
支持通过 JDBC 的 HIVE 0.9 连接，请参阅 HIVE 和 Impala 连接 [第
109 页]。
为连接服务器活动提供新的记录程序，请参阅激活连接服务器和驱动
程序的日志和跟踪。 [第 152 页]。
有关如何激活 OLAP 客户端日志，请参阅激活 OLAP 客户端的日志和
跟踪 [第 158 页]。
DataDirect ODBC 7.0 驱动程序的支持信息，请参阅关于 DataDirect
ODBC 驱动程序 [第 166 页]。
为任何数据访问驱动程序提供新的 SBO 参数，请参阅 Dictionary
Transaction Mode [第 175 页]。
为 MySQL 连接提供新的 SBO 参数，请参阅 JDBC ResultSet Type
[第 191 页]和 JDBC ResultSet Concurrency [第 191 页]。
为 Teradata 连接提供新的 SBO 参数，请参阅 Replace Current
Owner With Database [第 198 页]。
为通过 SAP HANA 连接跳过 SAML 提供新的 SBO 参数，请参阅
Skip SAML SSO [第 181 页]。
12
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
文档版本历史记录
版本
SAP
BusinessObjects
Business Intelligence 平
台 4.1 支持包 1
日期
2013 年
8月
更改的内容
新的可用连接，有关更多信息，请参阅“Product Availability Matrix”
（产品可用性矩阵）。
有关连接池模式的说明，请参阅连接池模式 [第 32 页]。
要检查存储在 CMS 上的连接，请参阅检查工具 － CMS 信息 [第 48
页]。
要查找 JDBC 驱动程序的版本，请参阅查找 JDBC 驱动程序的版本
[第 55 页]
有关调整 OData 连接超时以提高性能的信息，请参阅监控 OData 驱
动程序性能 [第 77 页]。
有关对与各种版本的 HIVE 数据库的连接的支持，请参阅 HIVE 和
Impala 连接 [第 109 页]。
有关 MS SQL Server 连接的 UNIX 设置，请参阅在 UNIX 上设置到
MS SQL Server 的连接的 JVM 选项 [第 119 页]。
要设置 CURSOR_SHARING 参数值，请参阅 Oracle 连接 [第 120
页]。
有关对 .unv Universe 与 SAP BW 的 64 位连接的支持，请参阅 SAP
Business Warehouse 连接 [第 125 页]。
如果 SAP ERP 驱动程序加载失败，请参阅 SAP ERP 连接 － 驱动程
序加载失败 [第 126 页]。
有关 SAP HANA 数据库 1.0 SPS 06 支持，请参阅 SAP HANA 连接
[第 126 页]。
有关 SAP BW 连接的安全要求，请参阅 SAP BW 连接 [第 133 页]。
有关处于服务器模式的连接服务器的 cs.cfg 文件示例，请参阅设置
部署模式 [第 149 页]。
有关提交到 SAP ERP 系统的查询中使用的日期格式，请参阅 SAP
ERP 数据类型 [第 226 页]。
有关 SAP HANA 数据类型及其在数据基础中的等同数据类型，请参
阅 SAP HANA 数据类型 [第 227 页]。
数据访问指南
文档版本历史记录
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
13
版本
SAP
BusinessObjects
日期
2013 年
11 月
Business Intelligence 平
更改的内容
新的可用连接，有关更多信息，请参阅“Product Availability Matrix”
（产品可用性矩阵）。
有关 64 位 Microsoft Windows 支持的节已更新，请参阅 64 位
台 4.1 支持包 2
Microsoft Windows 支持 [第 26 页]。
支持启用多源的 Universe 的本机连接中的区域设置，请参阅设置多
数据源工作流中的区域设置 [第 63 页]。
要在平台更新后安装 Apache Hadoop HIVE 驱动程序，请参阅执行平
台更新后使 HIVE 连接可用 [第 113 页]。
不支持 MS SQL Server（通过 OLE DB）的同义词列，请参阅 MS
SQL Server 连接 [第 118 页]。
有关 Oracle Essbase 的节已更新，请参阅 Oracle Essbase 连接 [第
122 页]。
有关 SAP BW 连接的节已更新，请参阅 SAP Business Warehouse 连
接 [第 125 页]。
有关 SAP HANA 数据库 1.0 SPS 08 支持，请参阅 SAP HANA 连接
[第 126 页]。
要支持新的分析函数，请参阅验证 PRM 文件的分析函数支持以及添
加分析函数支持 [第 202 页]。
SAP
BusinessObjects
2014 年
2月
Business Intelligence 平
新的可用连接，有关更多信息，请参阅“Product Availability Matrix”
（产品可用性矩阵）。
直接支持 SQL Server 2014 数据源： 支持的中间件为 ODBC 和
台 4.1 支持包 3
JDBC（Microsoft 有不赞成使用的 OLE DB）
要在执行修补程序安装后添加新的驱动程序，请参阅在执行修补程序
安装后添加新的驱动程序 [第 62 页]
有关 MySQL 连接的信息 － 信息设计工具中某些工作流所需的数据库
权限，请参阅 MySQL 连接 － 信息设计工具中某些工作流所需的数据库
权限 [第 121 页]
SAP
BusinessObjects
Business Intelligence 平
台 4.1 支持包 4
14
2014 年
6月
新的可用连接，有关更多信息，请参阅“Product Availability Matrix”
（产品可用性矩阵）。
要了解新功能 － JVM 设置，请参阅 JVM 设置 [第 148 页]
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
文档版本历史记录
版本
SAP
BusinessObjects
Business Intelligence 平
台 4.1 支持包 5
日期
2014 年
10 月
更改的内容
●
更新了 JAR 文件位置参考 [第 52 页]中的表
●
更新了 已安装的 SBO 文件 [第 161 页] 章节
●
更新了创建与 Apache Hadoop HIVE 的 JDBC 连接 [第 109 页]
中具有 0.13 (Simba JDBC4) 信息的表
要创建与 Apache Hadoop HIVE 的 ODBC 连接，请参阅创建与
Apache Hadoop HIVE 的 ODBC 连接 [第 112 页]
创建与 Amazon EMR HIVE 的 ODBC 连接，请参阅创建与 Amazon
EMR HIVE 的 ODBC 连接 [第 115 页]
要创建与 Cloudera Impala 的 ODBC 连接，请参阅创建到 Cloudera
Impala 的 ODBC 连接 [第 116 页]
数据访问指南
文档版本历史记录
© 2014 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
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问指南简介
相关信息
配置部署模式 [第 150 页]
配置要加载的驱动程序 [第 150 页]
查看和编辑 SBO 文件 [第 164 页]
运行 cscheck 工具 [第 38 页]
创建 JDBC 连接 [第 49 页]
SAP HANA 连接 [第 126 页]
2.4
本指南中的约定
在本指南中，变量 <connectionserver-install-dir> 是 SAP BusinessObjects 客户端工具使用的数据访
问文件的安装根路径。在 Microsoft Windows 上，默认的 <connectionserver-install-dir> 是 C:
\Program Files\SAP Business Objects\SAP BusinessObjects Enterprise XI
4.0\dataAccess。
变量 <bip-install-dir> 是 BI 平台或客户端工具的安装根路径。在 Microsoft Windows（64 位）上，是指
C:\Program Files (x86)\SAP Business Objects\SAP BusinessObjects Enterprise XI 4.0。
警告
如果在 Microsoft Windows 上部署 BI 平台，则在数据访问配置文件中的文件路径中，对反斜杠 \ 使用转义
符 \。
数据访问指南
数据访问指南简介
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
17
3
数据访问简介
3.1
关于连接服务器
连接服务器是用于管理 SAP BusinessObjects 应用程序与数据源之间连接的数据访问软件。
通过连接服务器可将各种应用程序（如 Universe 设计工具、信息设计器工具和 SAP BusinessObjects Web
Intelligence）连接到数据源并运行对数据源的查询。
连接服务器没有用户界面。连接的创建和管理工作通过这些应用程序的用户界面或通过编辑连接服务器配置文
件来完成。
●
创建连接
可以使用 BI 平台客户端工具的连接向导创建连接。
注意
Universe 设计工具的连接向导是“新建连接”向导。在信息设计工具中，则为“新建关系连接”向导或“新建
OLAP 连接”向导。请参阅应用程序用户指南以了解如何使用连接向导。
●
优化数据访问
可通过修改数据访问配置文件来优化通过连接服务器传递数据的方式。这些文件是随连接服务器一起安装的
XML 格式文件。用户可以设置要应用于特定数据访问驱动程序或所有已安装的数据访问驱动程序的参数值。
3.2
连接的构成
数据访问连接由下列项构成：
●连接服务器是用于管理应用程序和数据源之间连接的软件。例如，连接服务器处理从应用程序发出的数据请
求。
●数据访问驱动程序是特定于数据库的软件组件，用于管理连接服务器和数据库中间件之间的连接。
●
配置文件会定义参数，以配置下列系统之间的连接：
○应用程序和连接服务器
○应用程序和数据访问驱动程序
○连接服务器和数据访问驱动程序
3.2.1
系统体系结构
下图详细说明了连接服务器和数据访问驱动程序在 SAP BusinessObjects 配置中所处的位置。
18
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问简介
3.2.2
数据访问驱动程序
数据访问驱动程序提供了连接服务器与数据源之间的连接。数据库需要数据访问驱动程序，才能由 SAP
BusinessObjects 应用程序访问。
SAP BusinessObjects 应用程序包括用于配置数据库连接的数据访问驱动程序。所包含的数据访问驱动程序取
决于许可。
在创建一个连接以连到尚不具备其驱动程序的数据库之前，需要先获取所需的驱动程序。下列选项可用于获得
驱动程序：
●
请联系 SAP 代表以确定是否有可用的驱动程序，以及您是否有权使用该驱动程序。
●
使用驱动程序开发包（DDK）开发要使用的驱动程序。有关详细信息，请与 SAP 代表联系。
新建连接时，请为目标数据源选择适当的数据访问驱动程序。例如，如果要访问 Oracle 10g 数据库，则必须安
装相应的中间件（Oracle 10g 客户端），然后安装 SAP BusinessObjects Oracle 数据访问驱动程序。
警告
Excel Bean (bean_excel.jar) 和 CSV (dbd_open_sample.jar) 数据访问驱动程序是驱动程序示例。不应
未经修改即使用这些驱动程序，但是可以将其用作使用 DDK 开发更复杂驱动程序的起点。
数据访问指南
数据访问简介
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
19
有关受支持的数据访问驱动程序的最新列表，请查看 SAP Service Marketplace（网址为 http://
service.sap.com/bosap-support
），或与 SAP 代表联系。
有关 DDK 的更多信息，请参阅《Data Access Driver Java SDK Developer Guide》（数据访问驱动程序 Java
SDK 开发人员指南），网址为 http://boc.sdn.sap.com
3.3
。
数据访问配置文件
BI 平台的安装随附了数据访问配置文件。 这些配置文件可分为以下两个级别：
●
全局级别
cs.cfg 配置文件应用于所有连接。
●
驱动程序级别
SBO 配置文件应用于特定驱动程序。
●
OLAP 连接
OlapClient.cfg 配置文件适用于 .unx Universe 的 OLAP 连接。
除控制连接的配置文件之外，每个数据访问驱动程序还具有一个关联的 PRM 配置文件。这些文件控制应用程序
根据数据库软件功能生成 SQL 的方式。这些文件由诸如信息设计工具之类的应用程序使用。
相关信息
OLAP 连接 [第 24 页]
数据访问层允许 BI 平台连接到 OLAP 数据源。
关于 cs.cfg 配置文件 [第 142 页]
数据访问配置文件 [第 160 页]
3.3.1
关于 cs.cfg 全局配置文件
cs.cfg 全局配置文件供所有数据访问驱动程序使用，该文件安装在以下位置：
●<ConnectionServer 安装目录>\connectionServer
cs.cfg 文件包含适用于所有已安装数据访问驱动程序的参数。
相关信息
关于全局参数 [第 142 页]
20
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问简介
3.3.2
关于驱动程序配置文件
数据访问驱动程序使用的配置文件安装在以下路径中：
●在 Microsoft Windows 系统中：
<connectionserver-install-dir>\connectionServer\<RDBMS>
●在 UNIX 系统中：
<connectionserver-install-dir>/connectionServer/<RDBMS>
其中，<RDBMS> 为使用该配置文件的网络层或数据库中间件的名称。
下列文件具有适用于安装的数据访问驱动程序的参数。
特定于驱动程序的文件
可编辑性
<driver>.sbo
Yes
说明
每个数据访问驱动程序
都具有一个 SBO 文件。 为
示例
oracle.sbo
每个驱动程序和目标数据
库定义特定的连接配置。
<driver>.prm
Yes
每个数据访问驱动程序
都具有一个 PRM 文件。
oracle.prm
定义影响应用程序生成
SQL 的方式的参数。
<driver><language
>.cod
No
每个数据访问驱动程序
都具有一个 COD 文件。
oracleen.cod
存储与连接定义相关的信
息。 定义在创建新连接时
出现的字段。
注意
请不要修改这些文件。
<driver>.rss
No
每个数据访问驱动程序
都具有一个 RSS 文件。 存
oracle.rss
储供连接服务器使用的预
定义 SQL 语句。
<driver>.stg
No
数据访问驱动程序可以
具有策略文件。 有关更多
oracle.stg
信息，请参阅 SBO 文件参
数参考。
相关信息
SBO 参数说明 [第 169 页]
数据访问指南
数据访问简介
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
21
PRM 文件配置参考 [第 204 页]
关于数据库功能参数 [第 200 页]
3.3.3
关于 OlapClient.cfg 配置文件
在 Microsoft Windows 中，OlapClient.cfg 文件存储在以下位置：
●<bip-install-dir>\win32_x86
在 OlapClient.cfg 文件中，只能配置 OlapClient 部分的参数。
相关信息
激活 OLAP 客户端的日志和跟踪 [第 158 页]
3.4
部署模式
连接服务器可以下列部署模式运行：
●
库模式（进程内）
连接服务器包含在客户端进程内。大部分 SAP BusinessObjects 应用程序以库模式使用连接服务器。
●
服务器模式
连接服务器是一个可远程访问的 CORBA 服务器。连接服务器为 CORBA 和 HTTP 客户端提供服务，可分别处
理 2 层和 Web 层部署模式。
有关部署方案的更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理员指南》。
相关信息
设置部署模式 [第 149 页]
配置部署模式 [第 150 页]
配置要加载的驱动程序 [第 150 页]
3.5
连接服务
默认 BI 平台安装附带了三个“连接服务器”服务器实例。在中央管理控制台（CMC）中，它们分组在“连接服务”
下方。
22
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问简介
“连接服务器”服务器承载以下服务：
●
本机连接服务（64 位）
●
本机连接服务（仅限 MS Windows 32 位）
自适应处理服务器承载自适应连接服务，用户应用程序可借此远程访问基于 Java 的数据源。
连接服务在启动时会提示在 BI 平台群集上受支持的数据源列表，因此 SAP BusinessObjects 应用程序可查找并
使用相应的服务器实例。应用程序首先会通过连接服务器以库模式查找数据源，再以服务器模式进行查找。
连接与服务
以库模式使用连接服务器时，本地计算机上安装的数据访问驱动程序和中间件将定义可用数据源列表。以服务
器模式使用连接服务器时，数据源列表也包括 BI 平台后台系统上运行的每个服务器实例支持的数据源。
每个服务器实例均支持受数据访问层支持的数据源子集。该子集视以下参数而定：
●
CS 服务器实现技术（C++ 或 Java）
●
主机操作系统（UNIX 系统或 MS Windows）
●
可在安装 BI 平台时选择的驱动程序
●
在 CMC 中可为每个服务器实例选择的活动数据源
下表描述了每种连接可使用的连接服务。
连接
连接访问
所有 64 位本机数据源
本机连接服务
所有 32 位本机数据源
本机连接服务
说明
支持 ODBC、OLE DB、OCI 等。
仅支持 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。
数据访问指南
数据访问简介
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
23
3.6
OLAP 连接
数据访问层允许 BI 平台连接到 OLAP 数据源。
基于 OLAP 数据源的 .unv Universe 使用由 32 位连接服务器管理的连接。现有版本允许 SAP BW 连接使用 32
位或 64 位连接服务器。
基于 OLAP 数据源的 .unx Universe 使用由 BI 平台的 OLAP 客户端组件管理的连接。
有关受支持的 OLAP 数据源的列表，请参阅《Product Availability Matrix》（产品可用性矩阵）。有关创建
OLAP 连接的信息，请参阅《信息设计工具用户指南》。
相关信息
64 位 Microsoft Windows 支持 [第 26 页]
SAP Business Warehouse 连接 [第 125 页]
数据访问层允许 BI 平台访问 SAP BW 数据源。
24
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问简介
4
了解数据访问细节
4.1
64 位操作系统支持
SAP BusinessObjects 提供适用于下列操作系统的 BI 平台版本：
●
Microsoft Windows 的 32 位版本
●
Microsoft Windows 和 UNIX 系统的 64 位版本
数据访问层则提供可在 32 位或 64 位环境中运行的数据访问驱动程序。
以下节详述这一点对于 32 位或 64 位环境中的数据库中间件支持的意义。
如需 64 位操作系统上支持的数据源的完整列表，请参阅《Product Availability Matrix》（产品可用性矩阵）。
注意
DDK 提供可在 32 位或 64 位环境中运行的数据访问驱动程序示例。有关 DDK 的更多信息，请参阅《Data
Access Driver Java SDK Developer Guide》（数据访问驱动程序 Java SDK 开发人员指南）。
4.1.1
64 位 UNIX 支持
连接服务器随附 BI 平台提供，支持在 64 位 UNIX 环境中作为进程内服务器或远程服务器进行安装。
警告
必须确保安装 64 位中间件以通过连接服务器运行数据库连接。
对于 UNIX 上的以下数据库和网络层，某些供应商不提供 64 位中间件。 以下项仅用于 Microsoft Windows：
●
使用 Client Access AS400 的 DB2 UDB for iSeries V5
●
使用 Client Access AS400 的 DB2 UDB for iSeries V6
●
使用 Client Access AS400 的 DB2 for i v6.1
●
使用 Client Access AS400 的 DB2 for i v7.1
●
通过 OLE DB 访问的通用数据源
●
通过 ODBC 访问的 MS Access 2010 和 2013
●
通过 ODBC 访问的 MS Excel 2010 和 2013
●
通过 OLE DB 访问的 MS SQL Server 2008、2008 R2 和 2012
数据访问指南
了解数据访问细节
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
25
4.1.2
64 位 Microsoft Windows 支持
记忆
此节只和用于 .unv Universe 的数据库有关。
连接服务器随附 BI 平台提供，支持在 32 位（作为进程内服务器）和 64 位 MS Windows 环境中（作为进程内
服务器和远程服务器）进行安装。
在 Microsoft Windows 上，供应商不提供对通过 ODBC 访问的以下数据库的支持：
●
Ingres 数据库 9
●
MS Access 2007 和 MS Excel 2007
●
PostgreSQL 8
●
文本文件
●
Data Federator XI 3.0 查询服务器
●
Salesforce.com
64 位 Microsoft Windows 也不支持以下 OLAP 数据库及其中间件：
●
通过 OLE DB for OLAP 访问的 MS Analysis Services 数据库
●
通过 Oracle Essbase 客户端访问的 Oracle Essbase 9 和 11
对于所有这些数据源，可在 64 位版本的 Microsoft Windows 上将数据访问层与 32 位中间件一起使用。此功能
通过特定的部署方式实现，即两台连接服务器同时以服务器模式运行。其中一个为 32 位服务器，用于运行无法处
理 64 位中间件的数据源连接，另外一个为 64 位服务器，用于运行其他数据源连接。因为两个服务器共用 cs.cfg
文件，所以它们具有相同的配置。
限制
此架构意味着用户无法在两台服务器上运行相同的数据访问驱动程序。但是，可在 32 位连接服务器或 64 位连
接服务器上创建通用 ODBC 连接，但不能同时在这两种服务器上创建通用 ODBC 连接。
相关信息
Oracle Essbase 连接 [第 122 页]
数据访问层允许 BI 平台访问 Oracle Essbase 数据源。
SAP Business Warehouse 连接 [第 125 页]
数据访问层允许 BI 平台访问 SAP BW 数据源。
Array Fetch Size [第 171 页]
26
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
了解数据访问细节
4.1.3
安装 ODBC 驱动程序
对于在 32 位 Windows 操作系统上安装的信息设计工具或 Universe 设计工具，应使用 ODBC 数据源管理器定
义需要在工具中创建、测试和访问的任何 ODBC 数据源的驱动程序，而 ODBC 数据源管理器则位于安装工具的物
理计算机上以下位置中：
●
C:\Windows\System32\odbcad32.exe
对于在 64 位 Windows 操作系统上安装的信息设计工具或 Universe 设计工具，应使用 32 位版的 ODBC 数据
源管理器定义需要在工具中创建、测试和访问的任何 ODBC 数据源的驱动程序，而 ODBC 数据源管理器则位于安
装工具的物理计算机上以下位置中：
●
C:\Windows\SysWOW64\odbcad32.exe
对于信息设计工具，服务器组件需使用的 ODBC 数据源通过使用 ODBC 数据源管理器定义，ODBC 数据源管理
器位于安装服务器组件的物理计算机上以下位置中：
●
64 位版本：C:\windows\system32\odbcad32.exe（建议存在 64 位数据库中间件时使用）
●
32 位版本：C:\Windows\SysWOW64\odbcad32.exe（仅存在 32 位数据库中间件时使用）
注意
如果信息设计工具或 Universe 设计工具将要对 Universe 数据源使用 ODBC DSN，则应在为使用所发布
Universe 的 SAP BusinessObjects 报表应用程序安装服务器组件的物理计算机上创建同名 DSN。
有关信息，请参阅《SAP BusinessObjects Business Intelligence 平台安装指南》。
4.2
单一登录支持
当安装在以下平台上并采用以下连接时，BI 平台提供单一登录（SSO）身份验证：
数据源
说明
Microsoft Windows 上的 MS 分析服务
BI 平台单一登录由具有 Kerberos 的 Windows AD 提供。
Microsoft Windows 上通过 ODBC 或 OLE DB 访问的 MS
BI 平台单一登录由具有 Kerberos 的 Windows AD 提供。
SQL Server
Microsoft Windows 上通过 OCI 访问的 Oracle
BI 平台单一登录由 LDAP 提供。
所有平台上通过 OCI 访问的 Oracle EBS
可以通过安装并配置平台随附的身份验证插件来启用
SSO。 用户可以从 SAP BusinessObjects 应用程序中使用
EBS 凭据（用户名和密码）登录到 BI 平台。
所有平台上通过 OLAP BAPI 访问的 SAP BW
可以通过安装并配置 SAP 身份验证来启用 SSO。 用户可
以从 SAP BusinessObjects 应用程序中使用 SAP BW 凭据登
录到 BI 平台。
数据访问指南
了解数据访问细节
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
27
数据源
说明
通过 SAP Java Connectivity (JCo) 3.x 访问的 SAP ERP
系统（所有平台）
可以通过安装并配置 SAP 身份验证来启用 SSO。 用户可
以从 SAP BusinessObjects 应用程序中使用 SAP ERP 凭据登
录到 BI 平台。
通过 ODBC 和 JDBC 访问的 SAP HANA 数据库 1.0 SPS
提供的 SSO 是到数据库的 SSO，并且使用具有 Kerberos
08（所有平台）以及通过 OLAP 访问的 SAP HANA 数据库
的 Windows AD（通过 ODBC、JDBC 和 OLAP）或 SAML 协
1.0 SPS 07（Microsoft Windows、Linux 和 AIX）
议（通过 JDBC and OLAP）。 用户可以从 SAP
BusinessObjects 应用程序中使用 Windows AD 凭据登录到
BI 平台。
通过 ODBC 访问的 Sybase IQ 数据库（Microsoft
BI 平台单一登录由具有 Kerberos 的 Windows AD 提供。
Windows）
通过 ODBC 访问的 Teradata 13 和 Teradata 14
BI 平台单一登录由具有 Kerberos 的 Windows AD 提供。
（Microsoft Windows）
有关 SSO 的更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理员指南》。
相关信息
Oracle EBS 连接 [第 122 页]
SAP ERP 驱动程序 [第 82 页]
SAP HANA 连接 [第 126 页]
4.3
存储过程
连接服务器可管理通过执行 SQL 查询或存储过程生成的数据源中的数据。
存储过程是以可执行代码形式存储在 RDBMS 中的 SQL 脚本。它们可以接收参数并返回数据。
BI 平台中支持以下数据库和网络层的存储过程：
●
DB2 UDB 和 iSeries（通过 CLI 驱动程序）
●
Sybase Adaptive Server（通过 CTLIB）
●
Javabean
●
DB2 UDB、Derby、HSQL DB、Informix、MS SQL Server、MySQL 5、Oracle、SAP HANA 和 Sybase（均
●
Oracle（通过 OCI）
●
DB2 iSeries、Informix、MS SQL Server、SAP HANA、Sybase ASIQ、Sybase SQL Anywhere 和 Teradata
通过 JDBC）
（仅宏）（均通过 ODBC）
●
28
MS SQL Server（通过 OLE DB）
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
了解数据访问细节
4.3.1
支持的数据库功能
连接服务器仅支持以结果集形式（即表）返回数据的存储过程。这意味着存储过程不能返回整数、字符串或游
标，且必须始终包含 SELECT 语句。另外，受支持的存储过程不可包含 OUT 或 IN/OUT 参数，只可包含 IN 参数。
此外，不会执行存储过程中包含的 COMPUTE、PRINT、OUTPUT 或 STATUS 语句。
警告
这些限制对 Oracle 存储过程无效。请参阅下一节以了解受支持的 Oracle 存储过程。
连接服务器支持在包内执行 Oracle 存储过程。包名称将作为目录名称返回。此行为对 Oracle CI 和 JDBC 网络
层有效。
有关使用存储过程的更多信息，请参阅《SAP BusinessObjects Universe 设计工具用户指南》。
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 函数
●
具有一个类型不是 REF CURSOR（例如，VARRAY）的 IN/OUT 参数的任何 PL/SQL 过程
●
任何 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
数据访问指南
了解数据访问细节
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
29
all_objects%ROWTYPE;
END catalog_data;
BI 平台不支持打包的存储过程，仅支持独立的存储过程。
4.3.4
创建 Oracle 存储过程
在以下过程中，使用先前在包中创建的 catcurtyp 游标和 catalog_data.catcurtyp。
执行以下操作之一：
a) 编写以下语句：
CREATE or REPLACE PROCEDURE get_allobjects(cat_cv IN OUT
catalog_data.catcurtyp) AS
BEGIN
OPEN cat_cv FOR SELECT * FROM all_objects;
END;
b) 使用若干参数编写以下语句：
CREATE or REPLACE PROCEDURE get_ownerobjects(owner_name IN
varchar2, cat_cv IN OUT catalog_data.catcurtyp) AS
BEGIN
OPEN cat_cv FOR SELECT * FROM all_objects WHERE
owner=owner_name;
END;
有关如何创建包和存储过程的更多信息，请参阅 Oracle 文档。
4.3.5
SAP HANA 存储过程
连接服务器支持通过 JDBC 和 ODBC 的 SAP HANA 存储过程。
可以用以下语法创建 SAP HANA 存储过程：
CREATE PROCEDURE <procedure_name>
{LANGUAGE <lang>} {SQL SECURITY <mode>}
{READS SQL DATA {WITH RESULT VIEW <view_name>}} AS
BEGIN
select ... from <table_name>;
END
LANGUAGE、SQL SECURITY 和 READS SQL DATA 为可选。默认语言为 SQLScript。有关更多信息，请参阅
《SAP HANA Database SQLScript Reference》（SAP HANA 数据库 SQLScript 参考）。
示例
简单存储过程：
CREATE PROCEDURE Proc
LANGUAGE SQLSCRIPT READS SQL DATA AS
BEGIN
30
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
了解数据访问细节
select * from CUSTOMER;
END
带有参数和结果视图的存储过程：
CREATE PROCEDURE ProcWithResultView(IN id int)
LANGUAGE SQLSCRIPT READS SQL DATA WITH RESULT VIEW ProcView AS
BEGIN
select * from CUSTOMER where CUST_ID = :id;
END
4.3.6
Teradata 宏
当建立的连接使用 ODBC 时，连接服务器仅支持 Teradata 宏。
警告
在 ODBC 中不支持 Teradata 存储过程，因为存储过程不返回任何结果集。在 JDBC 中也不支持宏和存储过程。
可以使用以下语法创建 Teradata 宏：
create macro <macro_name> as (select * from <table_name>;);
有关更多信息，请参阅 Teradata 文档。
示例
简单宏：
create macro GUEST95 as (select * from guest where TYear='FY95';);
带参数的宏：
create macro MGUESTIN (inyear VARCHAR(12)) as (select * from GUEST where
TYear=:inyear;);
带多个结果集的宏：
create macro MGUEST as
(
select * from guest where TYear='FY95';
select count(*) from guest;
);
4.4
连接池
驱动程序将打开与数据库的连接，以便访问数据。下面两种方法可用于连接到数据库：
数据访问指南
了解数据访问细节
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
31
●只要连接服务器需要信息，数据访问驱动程序都将打开与数据库的连接，检索数据，然后关闭连接。
●连接服务器使可用连接保持打开状态，并将这些连接的详细信息保留在连接池内。只要连接服务器需要来自该
数据源的信息，数据访问驱动程序都将检查该连接池中是否包含未经使用的适当连接。如果现有连接可用，将
使用该连接。如果所有连接都正在使用，连接服务器将新建一个连接并将其添加到连接池。这种方法对系统资
源的利用效率更高。
记忆
连接服务器不会将使用单一登录的连接添加到池中。
4.4.1
关于池的连接
连接池中的可用连接可以是独占连接，也可以是共享连接。
●
独占连接一次只能分配给一位用户。独占连接一经分配，在池中就不再可用。因此就不能分配给其他任何请求
者。该连接不再需要时，会被自定义驱动程序释放，这样就可以再次分配该连接。
●
共享连接一次可分配给多位用户。连接被分配之后，仍然会保留在池中，这样就可以供其他请求者使用。
可以选择通过连接向导的“连接池模式”参数创建独占连接或共享连接。
相关信息
Connection Shareable [第 188 页]
Shared Connection [第 190 页]
Max Pool Time [第 145 页]
4.4.2
连接池模式
连接池模式值
在每个事务后断开连接
连接池模式说明
查询完成后断开与数据库的连接。 下次运行查询时重新创
建连接。
保持连接活动
这是连接共用选项。 如果查询在“池超时”中指定的时间
（默认为 10 分钟）之前完成，则可以重复使用该连接。 所有
用户均共享该连接。
在整个会话期间保持连接活动（仅限本地模式）
连接将在用户退出应用程序时关闭。 此选项不使用连接共
用。
32
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
了解数据访问细节
选择连接池模式
连接池模式可能取决于计算机资源的可用性。
●
如果内存不足，则选择“在每个事务后断开连接”选项。
●
如果内存充足并且性能很重要，则选择“在整个会话期间保持连接活动（仅限本地模式）”选项。
●
要更加精确地控制行为，请选择“保持连接活动”选项。
4.4.3
检查中间件连接共用
数据源中间件通常提供自身的连接池机制。必须确保中间件连接池设置与设计工具中的相应设置兼容，以便实
现预期的连接性能。
4.5
负载平衡
在服务器模式下，可以在 BI 平台上运行多个连接服务器实例。在该部署模式下，连接服务器实施负载平衡机
制。该机制将选择在资源方面可支持新客户端请求的最佳服务器。
负载平衡通过在 BI 平台上增加服务器实例数量来帮助解决伸缩性问题。
警告
这种负载平衡机制有别于中央管理服务器实施的负载平衡。
在以下级别执行负载平衡：
●
2 层部署中的客户端代理（在客户端层中）
●
Web 层部署中的服务器桥（在 Web 层中）
连接服务器还提供了应用程序级别的查找机制，帮助为作业选择正确的服务器实例。连接服务器根据客户端请
求的数据源类型以及服务器支持的网络层和数据库对，将客户端绑定到适当的服务器。
记忆
在查找之后执行负载平衡。可在所有平台上执行负载平衡。
4.5.1
查找最佳服务器
连接服务器的可扩展性问题可能来自以下因素：
●
已打开的数据库连接数
有关数据库连接数的问题已通过连接池机制处理。
数据访问指南
了解数据访问细节
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
33
●
连接服务器使用的 CPU
转换数据或写入并向客户端发回较大的响应缓冲区时，连接服务器可能会耗用大量的 CPU 资源。但是，连接
服务器本身的 CPU 用量并不大。
●
正在运行的作业数
服务器上运行的作业数会增加其工作量。
●
连接服务器或嵌入其中的中间件分配的内存量
使用的内存量取决于执行的 SQL 查询。例如，根据一个大表执行的单一 SQL 语句对可扩展性的影响可能会比
一系列小规模的 SQL 查询更大。
连接服务器使用与服务器工作量最相关的指标实现负载平衡。此例中需要使用的指标为分配的内存量。连接服
务器使用的内存越少，健康状况就越好。
注意
在将来的版本中，连接服务器还可以将作业数用作健康状况指标。
服务器的健康度（HEALTH）由以下公式计算得到：
HEALTH = (available memory / max memory) * constant
其中：
●
max memory 表示可分配内存量的最大值，如在 32 位 MS Windows 平台上共有 2GB 内存可以分配
●
available memory 表示 max memory 与当前已分配内存量之差
●
constant 表示健康度的最大值（对于连接服务器设置为 10000）。
4.5.2
负载平衡逻辑
1.
每一台候选服务器都要向负载平衡器报告其健康度。
候选服务器是指支持请求的网络层与数据库对的连接服务器。假如所有服务器实例都支持同一组数据源，那么
这些服务器都是服务客户端请求的潜在候选服务器。
2.
负载平衡器会确定和评估一组最健康的服务器，借此决定将客户端请求发往的服务器。然后，它会在这些服务
器中确定最佳的服务器。如果这组服务器中只含有一台服务器，那么这台服务器就是目标服务器。
健康度会在服务器的生命周期期间进行更新。执行以下操作之一时会重新计算健康度：
●
创建或销毁作业
●
准备或执行作业
●
数据提取操作
4.5.3
向后兼容性
从 SAP BusinessObjects Business Intelligence 平台 4.0 Feature Pack 3 版开始，所有平台上都支持负载平衡
机制。如果是增量部署或对先前版本进行有限升级的情况，则支持向后兼容性。未能向负载平衡器报告其健康度的
服务器均被认为健康，即健康度为最大值。
34
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
了解数据访问细节
注意
负载平衡也可用于部分平台先前版本的 Service Pack。有关更多信息，请与 SAP 代表联系。
4.6
内存分配
本机连接服务可以在 64 位 MS Windows 上使用 HOARD 内存分配功能。HOARD 是一种针对 C++ 组件的、经
过优化的可伸缩内存分配器，帮助提高服务的性能和可伸缩性，并减少内存分段。
数据访问层提供以下二进制文件：
●
ConnectionServer.exe，这是默认的二进制文件。不启用 HOARD。
●
ConnectionServerOptimized.exe，这是启用了 HOARD 的二进制文件
4.6.1
启用 HOARD
1.
打开 CMC。
2.
在“连接服务”下，停止由 ConnectionServer 服务器承载的本机连接服务。
3.
找到连接服务器可执行文件。
它位于 <BIP 安装目录>\win64_x64 目录。
4.
创建 ConnectionServer.exe 文件的备份副本。
5.
将 ConnectionServerOptimized.exe 重命名为 ConnectionServer.exe。
6.
重新启动服务。
即已在本机连接服务中启用了 HOARD。
4.6.2
禁用 HOARD
1.
打开 CMC。
2.
在“连接服务”下，停止由 ConnectionServer 服务器承载的本机连接服务。
3.
恢复默认的 ConnectionServer.exe 文件。
4.
从 CMC 重新启动服务。
即已在本机连接服务中禁用了 HOARD。
数据访问指南
了解数据访问细节
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
35
4.7
CA Wily Introscope 工作站中的活动
在 CA Wily Introscope 工作站中会跟踪涉及连接服务器的工作流活动。 可通过工具建议的不同视图（如下所
示）分析连接服务器功能：
●
有关总体信息的仪表盘和汇总视图
●
跟踪视图，其中错误突出显示，并通过消息加以说明
●
树视图，其中显示了对特定工作流连续的函数调用，并突出显示某个函数所用时间，以便轻松跟踪耗时的活动
有关更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理员指南》。
相关信息
配置 Java 虚拟机使用 SAP HANA 连接进行检测 [第 131 页]
36
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
了解数据访问细节
5
创建连接
5.1
连接要求
本节介绍创建连接的要求。
●
确保所用平台是支持用于 SAP 连接的平台。
●
确保已正确安装数据库中间件，并且可通过自己的计算机或服务器访问自己的数据库。
●
确保具备访问数据库所需的所有信息，例如数据库登录名和密码。
●
安装要使用的 SAP BusinessObjects 解决方案，包括相应的数据访问驱动程序。
●
检查是否已成功启动所有服务。
●
参阅 SAP BusinessObjects 解决方案随附的自述文件内容，检查需要针对自己的环境和软件执行的任何配置更
●
参阅最近的数据访问发行说明，检查是否存在任何可能影响用户环境的配置更改。
改。
注意
可使用 cscheck 工具检查基础结构，确定其是否适用于 SAP BusinessObjects 应用程序。
相关信息
检查连接配置 [第 37 页]
5.2
检查连接配置
连接服务器软件包括一个命令行实用程序，用户可使用它来检查数据源连接基础结构。用户可以随时使用
cscheck 工具检查客户端中间件和已安装的数据访问驱动程序。
注意
所有检查的结果将应用于本地计算机，即运行此工具的计算机。
cscheck 工具安装在 <boe-install-dir>\<platform_dir> 中，其中 <boe-install-dir> 是 BOE 的
安装目录，<platform_dir> 是 win32x_86、win64_x64，等等。
请从命令控制台（DOS 或 Shell）运行 cscheck 工具。工具的输出显示在屏幕上。用户可以指定按 XML 格式
生成输出，也可以抑制输出，以在脚本中使用此工具。
cscheck 工具可在本地计算机上执行以下功能：
●返回安装可支持的所有连接（网络层和数据库）的详细信息
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
37
●返回安装在本地计算机上的数据访问驱动程序的详细信息
●返回安装在本地计算机上的连接的详细信息
●检查所提供的网络层和数据库客户端的中间件安装是否有效
●检查所提供的网络层和数据库客户端的数据访问驱动程序安装是否有效
●检查是否可建立与给定数据库的连接
相关信息
检查工具 － 函数概述 [第 39 页]
5.2.1
显示关于 cscheck 工具的帮助
cscheck 工具提供用于执行以下操作的功能：
●显示关于 cscheck 实用程序的常规帮助
●显示关于每个可用 cscheck 函数的帮助
帮助文本能够以安装 SAP BusinessObjects 解决方案时选择的任何语言显示。
要显示关于 cscheck 的常规帮助，请使用以下语法：
cscheck --help|h --language|l { 语言 }
命令帮助语法
要显示关于函数的帮助，请使用以下语法，其中<“函数名称”>是要了解其帮助信息的函数的名称，<“语言”>是
显示帮助时采用的语言：
cscheck --help|h { 函数名称 } --language|l { 语言 }
函数帮助语法
示例
要以英文显示关于 cscheck 工具的帮助，请使用以下命令：
cscheck --help
要以法文显示关于 connectivity 函数的帮助，请使用以下命令：
cscheck --language fr --help connectivity
5.2.2
运行 cscheck 工具
安装 SAP BusinessObjects 后，用户可随时运行 cscheck 工具。
1.
38
打开命令控制台。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
2.
更改安装此工具的路径目录。
3.
使用正确参数输入 cscheck，以查找所需的信息。
4.
检查返回的信息。
相关信息
检查工具 － 函数概述 [第 39 页]
5.2.3
检查工具 － 函数概述
从命令控制台中，可以使用带相应函数及其参数的 cscheck 命令以返回所需的结果。
cscheck 命令具有以下结构。有些参数是可选的。
cscheck --language|l { 输出语言 } --xml|x --mute|m 函数名称 函数选项
cscheck 语法
命令的第一部分控制输出格式：
●<输出语言>或“l”后面跟随按 ISO639-1 标准指定的语言。这是可选的。默认语言为英语。
●“--xml”或“x”指定输出采用 XML 格式。这是可选的。默认输出是显示在屏幕上的文本。
●“--mute”指定不生成输出。如果曾在检查返回状态的脚本中使用此工具，则会使用此切换。这是可选的。默
认为生成输出。
命令的其余部分由函数及其选项参数组成。
<函数名称>可采用以下值。每个函数都具有一个可用于替代函数完整名称的简称：
●list 或 lt
●driverssearch 或 ds
●find 或 fd
●middleware 或 mw
●accessdriver 或 ad
●connectivity 或 ct
●ping 或 pg
相关信息
检查工具 － accessdriver [第 44 页]
检查工具 － connectivity [第 45 页]
检查工具 － driverssearch [第 41 页]
检查工具 － find [第 41 页]
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
39
Check Tool— list [第 40 页]
检查工具 － middleware [第 43 页]
检查工具 － ping [第 46 页]
5.2.4
Check Tool— list
语法
此函数返回所支持的网络层和数据库引擎列表。 例如，可以使用它来确定要用于其他检查工具函数的正确
值。
注意
此函数会返回所支持的数据访问驱动程序和中间件的完整列表，包括那些不是必须安装在用户计算机上的
数据访问驱动程序和中间件。
cscheck |list||lt|
list 语法
示例
以下命令将列出当前计算机上已安装的 SAP BusinessObjects 解决方案支持的所有网络层和数据库引擎。
cscheck list
以下是结果列表的摘录：
Oracle Client
Oracle 10
Oracle 11
Sybase Open Client
Sybase Adaptive Server 15.5
Informix ODBC Driver
Informix Dynamic Server 11
Teradata ODBC Driver
Teradata 12
Teradata 13
Teradata 14
ODBC Drivers
Generic ODBC Datasource
Generic ODBC3 Datasource
...
相关信息
检查工具 － 函数概述 [第 39 页]
显示关于 cscheck 工具的帮助 [第 38 页]
40
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
5.2.5
检查工具 － driverssearch
语法
此函数返回已安装的数据访问驱动程序列表。
cscheck |driverssearch| |ds|
driverssearch 语法
示例
以下命令将列出此计算机上已安装的所有连接服务器驱动程序。
cscheck driverssearch
以下是结果列表的摘录：
This access driver is installed: Oracle OCI access driver
Client layer: Oracle Client
Database engine(s):
Oracle 10
Oracle 11
This access driver is installed: Sybase Open Client access driver
Client layer: Sybase Open Client
Database engine(s):
Sybase Adaptive Server 15.5
This access driver is installed: Informix ODBC access driver
Client layer: Informix ODBC Driver
Database engine(s):
Informix Dynamic Server 11
This access driver is installed: Teradata ODBC access driver
Client layer: Teradata ODBC Driver
Database engine(s):
Teradata 12
Teradata 13
Teradata 14
...
相关信息
检查工具 － 函数概述 [第 39 页]
显示关于 cscheck 工具的帮助 [第 38 页]
5.2.6
检查工具 － find
语法
此函数列出可从本地计算机使用的可用连接类型（中间件和数据库客户端）。 这包括：
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
41
●
本地计算机上的可用连接类型
●
使用 CORBA 通信层的可用连接类型
●
使用 HTTP 通信层的可用连接类型
●
本地计算机上的可用 Java 连接类型
cscheck |find| |fd| -m { 连接服务器访问模式 }
find 语法
表 1： 函数输入参数
连接服务器访问模式 (-m)
客户端应用程序访问连接服务器时所用的模式：
●local： 列出本地计算机上的可用连接类型。
●corba： 列出使用 CORBA 的可用连接类型。
●http： 列出使用 HTTP 的可用连接类型。
●java： 列出本地计算机上的可用 Java 连接类
型。
●extended： 列出 local、java 和 CORBA 的连接
类型。
示例
查找 local 连接
以下命令将返回连接服务器可加载的本地计算机上的数据访问驱动程序列表。
cscheck find –m local
以下是结果列表的摘录：
Local Library Mode
IBM DB2 Client
DB2 10 for LUW
DB2 10 for z/OS
DB2 for i v6
DB2 for i v7
DB2 for z/OS v9
DB2 UDB for iSeries v5
DB2 v9
Essbase Provider
Hyperion Essbase 7
Hyperion Essbase 9
Informix ODBC Driver
Informix Dynamic Server 11
ODBC Drivers
Generic ODBC datasource
Generic ODBC3 datasource
MS SQL Server 2008
MS SQL Server 2012
Sybase SQL Anywhere 10
...
42
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
示例
查找 CORBA 服务器连接
以下命令将列出可从 CORBA 服务器使用的数据访问驱动程序列表。
cscheck find –m corba
相关信息
检查工具 － 函数概述 [第 39 页]
显示关于 cscheck 工具的帮助 [第 38 页]
检查工具 － CMS 信息 [第 48 页]
5.2.7
检查工具 － middleware
语法
对于提供的网络层和数据库客户端，此函数检查客户端中间件的安装是否有效。 要同时检查所提供的网络层
和数据库客户端的中间件及数据访问驱动程序，请使用 connectivity 函数。
cscheck |middleware| |mw| -c { 网络层 } -d { 数据库客户端 }
middleware 语法
表 2： 函数输入参数
网络层 (-c)
数据库中间件使用的网络层，由 find 函数返回。
数据库客户端 (-d)
要检查的数据库，由 find 函数返回。
示例
以下命令将检查本地计算机上是否存在 Oracle Client 10g 中间件的有效安装。 它将输出生成到 XML 文件
中：c:\result.xml
cscheck --xml middleware -c "Oracle Client" -d "Oracle 9" > c:\result.xml
如果没有正确安装中间件，结果将如下所示：
Starting to check the middleware component installation...
Begin AND operator...
ORACLE_HOME... The environment setting does not exist.
End AND operator: failure.
The middleware is not correctly installed.
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
43
相关信息
检查工具 － 函数概述 [第 39 页]
显示关于 cscheck 工具的帮助 [第 38 页]
检查工具 － connectivity [第 45 页]
检查工具 － accessdriver [第 44 页]
5.2.8
检查工具 － accessdriver
语法
对于提供的网络层和数据库客户端，此函数会检查数据访问驱动程序的安装是否有效。 要同时检查所提供的
网络层和数据库客户端的中间件及数据访问驱动程序，请使用 connectivity 函数。
cscheck |accessdriver| |ad| -c { 网络层 } -d { 数据库客户端 }
accessdriver 语法
表 3： 函数输入参数
网络层 (-c)
数据库中间件使用的网络层，由 find 函数返回。
数据库客户端 (-d)
要检查的数据库，由 find 函数返回。
示例
以下命令将检查是否存在 Oracle 10 数据访问驱动程序的有效安装，并以法语显示输出：
cscheck -l fr accessdriver -c "Oracle Client" -d "Oracle 10"
如果没有安装法语，结果将如下所示：
The language specified is not installed. Please use an installed language.
English ([en]).
示例
以下命令将检查是否存在 Oracle 10 数据访问驱动程序的有效安装：
cscheck ad -c "Oracle Client" -d "Oracle 10"
结果如下所示：
Starting to check the access driver component installation...
Begin AND operator...
Config Directory... success.
%SharedRoot%\ConnectionServer\Network Layers\Oracle OCI... success.
Directory... success.
/<连接服务器安装目录>/connectionServer//oracle... success.
Library... success.
/<连接服务器安装目录>/connectionServer//libdbd_oci10.so... success.
44
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
/<连接服务器安装目录>/connectionServer//libdbd_oci11.so... success.
Data File Name... success.
/<连接服务器安装目录>/connectionServer//oracle/oracle.sbo... success.
End AND operator: success.
The access driver is installed.
相关信息
检查工具 － 函数概述 [第 39 页]
显示关于 cscheck 工具的帮助 [第 38 页]
Check Tool— list [第 40 页]
5.2.9
检查工具 － connectivity
语法
对于提供的网络层和数据库客户端，此函数会同时检查已安装的中间件和数据访问驱动程序是否有效。
可以使用 middleware 和 accessdriver 函数逐个检查中间件和数据访问驱动程序。 可以使用 ping 函数
检查是否可连接到特定的数据库。
cscheck |connectivity| |ct| -c { 网络层 } -d { 数据库客户端 }
connectivity 语法
表 4： 函数输入参数
网络层 (-c)
数据库中间件使用的网络层，由 find 函数返回。
数据库客户端 (-d)
要检查的数据库，由 find 函数返回。
示例
以下命令将检查已安装的 Oracle Client 中间件和 Oracle 10 数据访问驱动程序。 此命令将输出写入到文本文
件中： c:\result.txt。
cscheck -l en connectivity -c "Oracle Client" -d "Oracle 10">c:\result.txt
如果没有正确安装中间件，结果将如下所示：
Starting to check the middleware component installation...
Begin AND operator...
ORACLE_HOME... The environment setting does not exist.
End AND operator: failure.
The middleware is not correctly installed.
Starting to check the access driver component installation...
Begin AND operator...
Config Directory... success.
%SharedRoot%\ConnectionServer\Network Layers\Oracle OCI... success.
Directory... success.
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
45
/<连接服务器安装目录>/connectionServer//oracle... success.
Library... success.
/<连接服务器安装目录>/connectionServer//libdbd_oci10.so... success.
/<连接服务器安装目录>/connectionServer//libdbd_oci11.so... success.
Data File Name... success.
/<连接服务器安装目录>/connectionServer//oracle/oracle.sbo... success.
End AND operator: success.
The access driver is installed.
相关信息
检查工具 － 函数概述 [第 39 页]
显示关于 cscheck 工具的帮助 [第 38 页]
检查工具 － find [第 41 页]
检查工具 － accessdriver [第 44 页]
检查工具 － middleware [第 43 页]
检查工具 － ping [第 46 页]
5.2.10 检查工具 － ping
语法
此函数尝试使用提供的详细信息访问给定的数据库。
cscheck ping|pg|-m { 连接服务器访问模式 } -c { 网络层 } -d { 数据库客户端 } -u { 用户名 } -p
{ 密码 } -s { 数据源 } -t { 数据库 } -r { 主机名 } -j { 进程 ID }
ping 语法
表 5： 函数输入参数
连接服务器访问模式 <(-m)>
客户端应用程序访问连接服务器时所用的模式：
●local： 连接服务器正在本地计算机上运行。
●corba： 连接服务器正在 CORBA 服务器上运
行。
●http： 连接服务器正在 HTTP 服务器上运行。
●java： 连接服务器使用本地计算机上的 Java 数
据访问驱动程序。
网络层 (-c)
要检查的连接的数据库中间件，由 find 函数返
回。
46
数据库客户端 (-d)
数据库类型，由 find 函数返回。
用户名 (-u)
数据库的有效用户名。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
密码 (-p)
用户名的密码。
数据源 (-s)
在其中运行数据库的服务器。
数据库 (-t)
数据库服务器。
主机名 (-r)
对于 CORBA 模式，是指承载连接服务器的计算
机。
进程 ID (-i)
对于 CORBA 模式，是指 ping 通过的连接服务器
的进程编号。
示例
Ping Oracle 数据库
以下命令将检查下列情况下的访问：
●连接服务器访问模式： local，即数据库在本地计算机上运行。
●网络层：Oracle 客户端
●数据库：Oracle 10g
●数据源：Harlaxton
●用户名：efashion
●密码：X2345
cscheck ping -m local -c "Oracle Client" -d "Oracle 10" -u "efashion" -p
"X2345" -s "Harlaxton"
示例
Ping 使用 CORBA 的 Sybase 数据库
以下命令将检查下列情况下的访问：
●连接服务器访问模式： CORBA，即连接服务器在 CORBA 服务器上运行。
●网络层：Sybase
●用户名：syadmin
●密码：password
●数据源：Sybase Adaptive Server 15
●数据库：SY1
●数据库主机：sybasehost
●进程 ID： 456
cscheck ping -m corba -c "Sybase Open Client" -d syb15 -u "syadmin" -p
"password" -s "Sybase Adaptive Server 15.5" -t "SY1" -r "sybasehost" -i 456
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
47
相关信息
检查工具 － 函数概述 [第 39 页]
检查工具 － find [第 41 页]
检查工具 － CMS 信息 [第 48 页]
5.2.11
检查工具 － CMS 信息
语法
以下参数允许用户指定可与 cscheck 工具的 find 或 ping 函数配合使用的 CMS 信息。
cscheck--ce_cluster{ CMS 服务器 } --ce_user { 用户名 } --ce_pass { 密码 } --ce_auth { 身份验
证 }find-mcorba
CMS 语法
表 6： 函数输入参数
CMS 服务器 (--ce_cluster)
用于访问 CMS 的主机和端口。
用户名 (--ce_user)
用于访问 CMS 的用户名。
密码 (--ce_pass)
用于访问 CMS 的密码。
身份验证 (--ce_auth)
在访问 CMS 时用于验证用户登录凭据的方法。
示例
以下命令将返回存储在 CMS 上并使用 CORBA 的可用连接的列表。
cscheck --ce_cluster localhost --ce_user Administrator --ce_pass Password1 -ce_auth SecEnterprise find -m corba
记忆
在命令行中，参数必须放在 find 或 ping 函数之前。 所有参数均为必需。
相关信息
检查工具 － find [第 41 页]
检查工具 － ping [第 46 页]
48
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
5.3
创建 JDBC 连接
安装 BI 平台时，会同时安装一组数据访问驱动程序。 可使用这些数据访问驱动程序创建与数据库的连接。 这
些驱动程序位于 <connectionserver-install-dir>\connectionServer\drivers\java 目录中。
注意
JDBC 连接可用于 SAP BusinessObjects Enterprise XI 3.0 和更高版本。 在 SAP BusinessObjects Business
Intelligence 平台 4.0 和更高版本中，Web Intelligence 胖客户端支持在 3 层模式中使用 JDBC 连接。
SAP BusinessObjects 软件还包括用于使用 JDBC 驱动程序访问数据库的配置文件。 要使用这些驱动程序，请
执行以下操作：
1.
从您的数据库提供商处获取 java 驱动程序软件。
2.
通过以下方式之一指定 JAR 文件路径：
○
使用完全限定的 JAR 文件路径设置数据访问驱动程序的 SBO 配置文件中的 ClassPath 元素。
○
将 JAR 文件存储到通过 SBO 文件的 Extensions 参数值创建的目录中。
可同时使用上述两种方式指定 JAR 文件路径。 但是，在 SBO 文件中指定的 JAR 文件优先于存储在自定义目录
中的 JAR 文件。
注意
SAP Visual Intelligence 允许用户直接从应用程序的连接创建框中选择 JAR 文件。 有关信息，请参阅《SAP
Visual Intelligence 用户指南》。
有关受支持的 JDBC 驱动程序的最新列表，请查看 SAP Service Marketplace（网址为 http://
service.sap.com/bosap-support
）或与 SAP 代表联系。
注意
数据访问层提供通用 JDBC 连接，以创建与 BI 平台明确不支持的数据源的连接。
相关信息
使用 SBO 文件创建 JDBC 连接 [第 50 页]
使用 Extensions 创建 JDBC 连接 [第 51 页]
创建通用 JDBC 连接 [第 52 页]
JDBC 驱动程序属性 [第 165 页]
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
49
5.3.1
●
使用 SBO 文件创建 JDBC 连接
获取数据库必需的 JDBC 驱动程序软件，并将这些文件复制到系统中。 这些文件由数据库供应商提供。 驱动
程序软件通常由一个或多个 .jar 文件组成。 记下这些文件的安装路径详细信息。
●
确保数据库访问详细信息（例如登录和密码详细信息）易于获取。
1.
导航至包含要使用的 SBO 文件的目录。
例如，在 Microsoft Windows 上，JDBC 配置文件位于 <连接服务器安装目录>\connectionServer\jdbc
目录中。
2.
使用 XML 编辑器打开 SBO 文件进行编辑。
3.
将所需的 .jar 文件详细信息添加到 ClassPath 区域。 指定这些文件时应包括全限定路径名称，例如：
<Path>C:\\JDBC Drivers\\MSSQLSERVER2008\\msutil.jar</Path>
注意
这些文件需要安装在运行应用程序的计算机上。 确保 JDBC 驱动程序路径正确。
4.
找到 Driver Capabilities 参数，并检查该参数是否设置为 Procedure、Queries 或两者。
注意
在后一种情况中，以逗号分隔两个设置。
警告
如果未设置为以上值之一，连接向导将无法使用 JDBC 驱动程序。
5.
保存并关闭 SBO 文件。
6.
运行连接向导。
已配置的 JDBC 驱动程序将显示在可用连接的列表中。
7.
选择 JDBC 驱动程序，然后使用向导配置连接。
完成此任务后，该连接将可用。
相关信息
连接要求 [第 37 页]
数据访问配置文件 [第 160 页]
50
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
5.3.2
JDBC SBO 示例文件结构
此处显示了用户需要修改的 sqlsrv.sbo 文件节的示例。此 SBO 文件适用于 Microsoft SQL Server 2008。
<DataBase Active="Yes" Name="MS SQL Server 2008">
...
<JDBCDriver>
<ClassPath>
<Path>C:\\JDBC Drivers\\MSSQLSERVER2008\\msbase.jar</Path>
<Path>C:\JDBC Drivers\MSSQLSERVER2008\\msutil.jar</Path>
<Path>C:\\JDBC Drivers\\MSSQLSERVER2008\\mssqlserver.jar</Path>
</ClassPath>
...
</JDBCDriver>
...
</DataBase>
5.3.3
●
使用 Extensions 创建 JDBC 连接
获取数据库必需的 JDBC 驱动程序软件，并将这些文件复制到系统中。 这些文件由数据库供应商提供。 通
常，驱动程序软件由一个或多个 JAR 文件组成。
●
确保数据库访问详细信息（例如登录和密码详细信息）易于获取。
1.
转到指南的下一节了解 Extensions 参数值。
2.
使用一个或多个 Extensions 参数值创建自定义驱动程序目录。
例如，在 sqlsrv.sbo 文件中，MS SQL Server 2008 中间件的 Extensions 参数值为 sqlsrv2008、
sqlsrv 和 jdbc。 可以创建以下目录之一：
○
<连接服务器安装目录>\connectionServer\jdbc\drivers\sqlsrv2008
○
<连接服务器安装目录>\connectionServer\jdbc\drivers\sqlsrv
○
<连接服务器安装目录>\connectionServer\jdbc\drivers\jdbc
3.
将 JAR 文件复制到所选择的目录。
4.
运行连接向导。
已配置的 JDBC 驱动程序将显示在可用连接的列表中。
5.
选择 JDBC 驱动程序，然后使用向导配置连接。
为加载 JDBC 驱动程序，连接服务器将按照从最具体到最模糊的顺序在每个目录中搜索 JAR 文件，直至找到。
此时即可使用该连接。
示例
例如，如果仅将 JAR 文件存储在 <连接服务器安装目录>\connectionServer\jdbc\drivers\sqlsrv
中，连接服务器将首先在 sqlsrv2008 目录中搜索驱动程序，发现该目录为空后，连接服务器随即会在
sqlsrv 目录中搜索，找到 JAR 文件并加载该驱动程序。
注意
由于所有 MS SQL Server 目标数据库的 Extensions 值均为 sqlsrv，将为所有 MS SQL Server 数据库
加载此目录中指定的 JAR 文件。
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
51
相关信息
使用 SBO 文件创建 JDBC 连接 [第 50 页]
数据访问配置文件 [第 160 页]
5.3.4
●
创建通用 JDBC 连接
获取此数据库必需的 JDBC 驱动程序软件。 .jar 文件需要安装在运行 SAP BusinessObjects 应用程序的计算
机上。
●
确保已准备好数据库访问详细信息（例如，登录和密码详细信息）。
1.
导航到包含 jdbc.sbo 和 jdbc.prm 文件的目录。
例如，在 Microsoft Windows 上，配置文件位于 <连接服务器安装目录>connectionServer\jdbc 目录
中。
2.
将所需 .jar 文件复制到 <连接服务器安装目录>\connectionServer\jdbc\drivers\jdbc 目录中。
如果该目录不存在，则必须创建该目录。
3.
运行连接向导。
JDBC 驱动程序将显示在“通用”下的可用连接列表中。
4.
选择 JDBC 驱动程序，然后使用向导和以下详细信息配置连接：
○
JDBC URL
○
JDBC 类
○
用户名
○
密码
完成此任务后，可以通过 JDBC 使用与数据源的连接。
注意
jdbc.prm 文件中仅包含有关 JDBC 数据库通用函数的信息。 可以添加或更新特定于该文件中某个自定义数
据库的任何信息。 对 jdbc.prm 文件的修改将应用于已创建或将创建的所有通用 JDBC 连接。
相关信息
数据访问配置文件 [第 160 页]
关于 PRM 文件 [第 200 页]
5.3.5
JAR 文件位置参考
语法：
52
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
下表介绍必须在其中保存中间件 JAR 文件才能启用 JDBC 连接的文件夹的名称。 第一列列出数据库供应商名
称，如连接向导中所示。 第二列列出支持 JDBC 连接的数据库的名称，如对应 SBO 文件的 DataBase 部分所示。
第三列列出可创建的文件夹名称，如 SBO 文件的 Extensions 参数值所述。
Extensions 参数是与 SBO 文件中的目标数据库中间件相对应的 DataBase 元素的子元素。 如果不在
DataBase 下，则表示参数值对于此 SBO 文件中配置的所有中间件均有效。 此时应在文件的 Defaults 节中进行
查找。 在 MS Windows 上，JDBC 配置文件位于 <connectionserver-install-dir>\connectionServer
\jdbc 目录中。
注意
Data Federator JDBC 驱动程序作为 BI 平台的一部分安装在 <connectionserver-install-dir>
\connectionServer\jdbc\drivers\datafederator 目录中。 SAP HANA 1.0 SPS 08 JDBC 驱动程序
安装在<连接服务器安装目录>\connectionServer\jdbc\drivers\newdb 目录中。 因此，用户不必执行
其他配置即可创建与 Data Federator XI 3.0 查询服务器或 SAP HANA 数据库的连接。
供应商
Apache
数据库
扩展参数值
Derby 10 Embedded
derby10、derby、jdbc
Apache Hadoop Hive 0.7
apache、hive、hive07、jdbc
Apache Hadoop Hive 0.8
apache、hive、hive08、jdbc
Apache Hadoop Hive 0.9
apache、hive、hive09、jdbc
Apache Hadoop Hive 0.10
apache、hive、hive010、jdbc
Apache Hadoop Hive 0.12
apache、hive、hive012、jdbc
Apache Hadoop Hive 0.12 Simba
JDBC4 HiveServer1
hive012simba4server1、apache、hive、
jdbc
Apache Hadoop Hive 0.13 Simba
JDBC4 HiveServer2
apache、jdbc
Cloudera Impala 1.0 Simba JDBC4
hive012simba4server1、simbahive2、
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
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
53
供应商
数据库
HP Vertica 6.1
vertica、jdbc
HSQLDB
HSQLDB 1.8 Embedded
hsqldb18、hsqldb、jdbc
IBM
DB2 v9
db2v9、db2udb、db2、jdbc
DB2 10 for z/OS
db2mvs10、db2mvs、db2、jdbc
DB2 v11 for z/OS
db2mvs11、db2mvs、db2、jdbc
DB2 10 for LUW
db2v10、db2udb、db2、jdbc
DB2 10.5 for LUW
db2v10_5、db2udb、db2、jdbc
Informix Dynamic Server 11
ids11、informix、jdbc
Ingres
Ingres Database 9
ingres9、ingres、jdbc
Microsoft
MS SQL Server 2008
sqlsrv2008、sqlsrv、jdbc
MS SQL Server 2012
sqlsrv2012、sqlsrv、jdbc
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
Netezza
Oracle
SAP
54
扩展参数值
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
供应商
数据库
Sybase
扩展参数值
Sybase Adaptive Server Enterprise
15.5
Sybase Adaptive Server Enterprise 16
Teradata
PostgreSQL
sybase15、sybase、jdbc
sybase15、sybase、jdbc
Sybase IQ 15
iq15、asiq、jdbc
Sybase IQ 16
iq16、asiq、jdbc
Sybase SQL Anywhere 11
ssa11、ssa、jdbc
Sybase SQL Anywhere 12
ssa12、ssa、jdbc
Sybase SQL Anywhere 16
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
PostgreSQL 9
postgresql8、postgresql、jdbc
postgresql9、postgresql、jdbc
相关信息
SAP HANA 连接 [第 126 页]
关于 Data Federator XI 3.0 查询服务器连接 [第 136 页]
5.3.6
查找 JDBC 驱动程序的版本
本节描述如何查找 JDBC 连接中的驱动程序的版本。
可以在驱动程序 JAR 文件所包含的 META-INF/MANIFEST.MF 文件中找到所使用的 JDBC 驱动程序的版本。
1.
执行以下操作之一：
选项
说明
1.
启动 WinRAR 应用程序。
WinRAR 提取文
2.
将 JAR 文件拖放到应用程序窗口中。
件
3.
展开 META-INF 文件夹。
使用
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
55
选项
说明
从命令提示
符提取文件
4.
从 WinRAR 中将 MANIFEST.MF 文件拖放到本地文件夹。
5.
打开该文件并找到 Bundle-Version 值。
1.
打开命令提示符。
2.
转到要将文件提取到的文件夹。
cd <driver_path>
3.
运行以下命令：
<JAR_path>\jar.exe -xf <driver_path>\<driver_name>.jar METAINF/MANIFEST.MF
4.
打开该文件并找到 Bundle-Version 值。
例如，运行以下命令可获取 SAP HANA JDBC 驱动程序的版本：
cd C:\Program Files (x86)\SAP BusinessObjects\SAP
BusinessObjects Enterprise XI 4.0\dataAccess\connectionServer
\jdbc\drivers\newdb
"C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects
Enterprise XI 4.0\win64_x64\jdk\bin\jar.exe" -xf ngdbc.jar METAINF/MANIFEST.MF
注意
如果 JAR 文件的路径包含空格，则将其放入双引号中。
5.4
创建 JavaBean 连接
安装 BI 平台时，会同时安装一个使用 JavaBean 的数据访问驱动程序。此驱动程序位于
<connectionserver-install-dir>\connectionServer\drivers\java 目录中。
开发人员还可创建 JavaBean 以提供对数据源的访问。用户可使用这些 JavaBean 创建连接。为了创建一个
JavaBean 连接，创建 JavaBean 的开发人员将提供以下信息：
●
所需的 JAR 文件
●
JavaBean 所需的任何其他文件
●
JavaBean 驱动程序所需的任何特定配置详细信息
对于 JDBC 连接，还可使用 Extensions 功能创建 JavaBean 连接。
注意
在 JavaBean 驱动程序内，数据检索过程被配置为存储过程。通过连接向导创建 JavaBean 连接时，必须在“数
据库中间件选择”屏幕上选中“过滤存储过程的网络层”。如果未选中，连接向导将不显示可用的 JavaBean 驱动程
序。
56
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
相关信息
创建 JDBC 连接 [第 49 页]
创建 JavaBean 连接 [第 57 页]
使用 Extensions 创建 JavaBean 连接 [第 58 页]
5.4.1
1.
创建 JavaBean 连接
使用 XML 编辑器打开 javabean.sbo 文件进行编辑。
例如，在 Microsoft Windows 上，配置文件位于 <connectionserver-install-dir>
\connectionServer\javabean 目录中。
2.
将所需的 .jar 文件详细信息添加到 ClassPath 区域。指定这些文件时应包括全限定的路径名称。
注意
这些文件需要安装在运行 SAP BusinessObjects 应用程序的计算机上。
有关详细信息，请参阅有关 javabean.sbo 示例文件结构的信息。
3.
保存并关闭文件。
4.
执行由 JavaBean 开发人员指定的任何其他配置任务。
5.
运行连接向导。
已配置的 JavaBean 数据源应该显示在可用连接的列表中。
6.
选择 JavaBean 数据源并使用向导来配置连接。
完成此任务后，该连接将可用于应用程序。
相关信息
数据访问配置文件 [第 160 页]
5.4.2
JavaBean SBO 示例文件结构
该部分包含了一个 JavaBean SBO 文件的示例。
<DataBase Active="Yes" Name="Excel Spreadsheet">
<JavaBean>
<ClassPath>
<Path>$ROOT$\\beans\\bean_excel.jar</Path>
</ClassPath>
<Parameter Name="JavaBean Class">com.businessobjects.beans.excel.Excel</
Parameter>
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
57
<Parameter Name="URL Format">$DATASOURCE$</Parameter>
</JavaBean>
<Parameter Name="Family">Java Beans</Parameter>
<Parameter Name="Description File">bean_excel</Parameter>
<Parameter Name="Authentication Mode">Bypass</Parameter>
<Parameter Name="Extensions">bean_excel,javabean</Parameter>
</DataBase>
</DataBases>
5.4.3
1.
使用 Extensions 创建 JavaBean 连接
导航至包含 javabean.sbo 文件的目录。
例如，在 Microsoft Windows 上，该文件位于 <connectionserver-install-dir>
\connectionServer\javabean 目录中。
2.
打开 SBO 文件进行查看。
3.
在 Defaults 节中，找到 <Parameter Name="Extensions"> 元素。
注意
如果使用 DDK 开发 JavaBean 驱动程序，请在 <DataBase Active="Yes" Name="Excel
Spreadsheet"> 元素中找到 Extensions 参数。
4.
使用一个或多个 Extensions 参数值创建自定义驱动程序目录。
例如，在文件的 Defaults 节中 Extensions 参数值为 javabean。 则可以创建 <connectionserverinstall-dir>\connectionServer\javabean\drivers\javabean 目录。
5.
将 JAR 文件复制到所选择的目录。
6.
关闭 SBO 文件。
7.
运行连接向导。
所配置的 JavaBean 驱动程序将显示在可用连接列表中。
8.
选择 JavaBean 驱动程序，然后使用向导配置连接。
为加载 JavaBean 驱动程序，连接服务器将按照从最具体到最模糊的顺序在每个目录中搜索 JAR 文件，直至找
到。 此时即可使用该连接。
相关信息
创建 JavaBean 连接 [第 57 页]
数据访问配置文件 [第 160 页]
58
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
5.5
创建 ODBC 连接
安装 BI 平台时，会同时安装一组数据访问驱动程序。可使用这些数据访问驱动程序创建与数据库的连接。这些
驱动程序位于 <connectionserver-install-dir>\connectionServer\drivers\lib32 或
<connectionserver-install-dir>\connectionServer\drivers\lib64 目录中。
SAP BusinessObjects 软件还包括用于使用 ODBC 驱动程序访问数据库的配置文件。要使用这些驱动程序，请
执行以下操作：
1.
从数据库提供商处获取 ODBC 驱动程序软件。
2.
修改提供的配置文件。
大多数 ODBC 驱动程序提供 Unicode 和非 Unicode 两种版本。
有关受支持的 ODBC 驱动程序的最新列表，请查看 SAP Service Marketplace（网址为 http://
service.sap.com/bosap-support
），或与 SAP 代表联系。
注意
数据访问层提供通用 ODBC 连接，以创建与 BI 平台明确不支持的数据源的连接。
关于 UNIX 上的通用 ODBC 连接
Microsoft Windows 操作系统附带标准的 ODBC 驱动程序管理器。与此不同的是，UNIX 未提供任何标准方式
来管理驱动程序。SAP BusinessObjects 软件允许为 UNIX 上的通用 ODBC 连接使用 DataDirect 或 unixODBC 驱
动程序管理器。
在 UNIX 上为特定数据库创建通用 ODBC 连接之前，必须确定以下各项：
●
ODBC 驱动程序版本
●
驱动程序是否能够与 DataDirect 驱动程序管理器或 unixODBC 配合使用
然后，修改提供的配置文件，并配置相关数据源以启用连接。
相关信息
创建通用 ODBC 连接 [第 59 页]
创建通用 ODBC3 连接 [第 61 页]
5.5.1
创建通用 ODBC 连接
以下过程说明在以下假设下如何配置与数据库建立的通用 ODBC 连接：
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
59
●
驱动程序是 ODBC2
●
驱动程序支持 unixODBC 驱动程序管理器
1.
导航到包含 odbc.sbo 和 odbc.prm 文件的目录。
配置文件位于 <connectionserver-install-dir>/connectionServer/odbc 目录中。
2.
使用 XML 编辑器打开 odbc.sbo 文件进行编辑。
3.
找到以下部分：
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC datasource">
<Libraries>
...
<Library Platform="Unix">dbd_wddodbc</Library>
<Library Platform="Unix">dbd_ddodbc</Library>
<!--Library Platform="Unix">dbd_wuxodbc</Library-->
<!--Library Platform="Unix">dbd_uxodbc</Library-->
</Libraries>
<Parameter Name="Charset Table" Platform="Unix">datadirect</Parameter>
...
</DataBases>
4.
为 DataDirect 注释前两行，并取消注释随后两行中的一行。确保将取消注释的行放在该部分的最前面，以便可
以先阅读该行。为 <Parameter Name="CharSet Table" Platform="Unix"> 元素进行注释。
注意
○
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 文件可能未包含关于数据库的特定函数的信息。
8.
保存并关闭 odbc.prm 文件。
9.
在 UNIX 计算机上安装相关的 ODBC 驱动程序。
10. 通过编辑 odbc.ini 文件来配置数据源。
11. 保存并关闭 odbc.ini 文件。
12. 运行连接向导。
已配置的 ODBC 驱动程序将显示在“通用”下的可用连接列表中。
13. 选择 ODBC 驱动程序，然后使用向导配置连接。
完成此任务后，可以在 unixODBC 驱动程序管理器中通过通用 ODBC 使用数据源的连接。
60
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
相关信息
数据访问配置文件 [第 160 页]
5.5.2
创建通用 ODBC3 连接
以下过程说明在以下假设下如何配置与数据库建立的通用 ODBC 连接：
●
驱动程序是 ODBC3
●
驱动程序支持 unixODBC 驱动程序管理器
1.
导航到包含 odbc.sbo 和 odbc.prm 文件的目录。
配置文件位于 <connectionserver-install-dir>/connectionServer/odbc 目录中。
2.
使用 XML 编辑器打开 odbc.sbo 文件进行编辑。
3.
找到以下部分：
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC3 datasource">
<Libraries>
...
<Library Platform="Unix">dbd_wddodbc3</Library>
<Library Platform="Unix">dbd_ddodbc3</Library>
<!--Library Platform="Unix">dbd_wuxodbc3</Library-->
<!--Library Platform="Unix">dbd_uxodbc3</Library-->
<!--Library Platform="Unix64">dbd_wux32odbc3</Library-->
<!--Library Platform="Unix64">dbd_ux32odbc3</Library-->
</Libraries>
<Parameter Name="Charset Table" Platform="Unix">datadirect</Parameter>
...
</DataBases>
4.
为 DataDirect 注释前两行，并取消注释随后四行中的一行。确保将取消注释的行放在该部分的最前面，以便可
以先阅读该行。为 <Parameter name="CharSet Table" Platform="Unix"> 元素进行注释。
注意
○
dbd_wddodbc3 指定基于 DataDirect 的 ODBC3 Unicode 驱动程序
○
dbd_ddodbc3 指定基于 DataDirect 的 ODBC3 的非 Unicode 驱动程序
○
dbd_wuxodbc3 指定基于 unixODBC 的 ODBC3 Unicode 驱动程序
○
dbd_uxodbc3 指定基于 unixODBC 的 ODBC3 的非 Unicode 驱动程序
○
dbd_wux32odbc3 指定具有 32 位 API（而不是 64 位 API，仅在 64 位平台上可用）的基于
unixODBC 的 ODBC3 Unicode 驱动程序
○
dbd_ux32odbc3 指定具有 32 位 API（而不是 64 位 API，仅在 64 位平台上可用）的基于 unixODBC
的 ODBC3 非 Unicode 驱动程序
5.
保存并关闭 odbc.sbo 文件。
6.
使用 XML 编辑器打开 odbc.prm 文件进行编辑。
7.
添加或更新特定于数据库的任何信息。
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
61
注意
odbc.prm 文件可能未包含关于数据库的特定函数的信息。
8.
保存并关闭 odbc.prm 文件。
9.
在 UNIX 计算机上安装相关的 ODBC 驱动程序。
10. 通过编辑 odbc.ini 文件来配置数据源。
11. 保存并关闭 odbc.ini 文件。
12. 运行连接向导。
已配置的 ODBC 驱动程序将显示在“通用”下的可用连接列表中。
13. 选择 ODBC 驱动程序，然后使用向导配置连接。
完成此任务后，可以在 unixODBC 驱动程序管理器中通过 ODBC3 使用数据源的连接。
相关信息
数据访问配置文件 [第 160 页]
5.6
在执行修补程序安装后添加新的驱动程序
如果希望添加新的驱动程序，需要手动修改 BI 平台安装。
已对 BI 平台服务器或客户端工具执行了此版本的修补程序安装。
针对 BI 平台服务器或客户端工具的修补程序不会在现有安装中安装任何新功能， 而是仅更新已安装的文件。
如果要使用新的驱动程序，需要从最新的完整安装中手动进行安装。
1.
在“控制面板”中，定位到最新的 BI 平台完整安装程序。
记忆
无法在平台程序更新上执行下一步。
2.
右键单击并选择“卸载/更改”。
3.
在“SAP BusinessObjects BI 平台安装”对话框的“应用程序维护”屏幕中，选择“修改”，然后单击“下一步”。
4.
在“选择功能”屏幕中，在“数据库访问和安全性”下面选择所需的驱动程序选项。
5.
单击“下一步”以完成安装。
此时已完成在平台上安装驱动程序。 现在可以创建连接到所需数据库的连接了。
62
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建连接
5.7
设置多数据源工作流中的区域设置
在设计和报表工具中，如果对启用多源并且使用本机连接的 Universe 的 BigDecimal 列进行查询，可能会返回
错误（java.lang.NumberFormatException）。要避免此问题，请向 BIP 平台服务器上数据库驱动程序的
SBO 文件中添加带有合适的语言和国家/地区值的 Locale 参数。
以下过程使用法语区域设置作为示例。
1.
停止自适应连接服务。
2.
打开 SBO 文件进行编辑。
该文件位于 <BIP 安装目录>\dataAccess\connectionServer\<connection_type> 目录中，其中
<connection_type> 为 db2、odbc、oracle 或 sybase 等值。
3.
在适当的 Database 部分的下方添加以下行之一：
○
<Parameter Name="Locale">fr</Parameter>
○
<Parameter Name="Locale">fr_FR</Parameter>
4.
保存文件。
5.
重新启动服务和应用程序。
完成此任务后，多源工作流中的本机连接即可正确运行。
数据访问指南
创建连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
63
6
数据访问驱动程序参考
6.1
数据访问驱动程序
本章详细介绍部分数据访问驱动程序，这些驱动程序允许连接到使用 OData 或 XML 文档的数据源及特定的数
据库（例如基于 ABAP 的 SAP ERP 系统）。本章主要描述数据访问层中使用的重要数据模型与关系模型之间的映
射规则。
本章只涉及与要在信息设计工具中创建的连接相关的内容。
相关信息
CSV OpenDriver [第 64 页]
OData 驱动程序 [第 69 页]
SAP ERP 驱动程序 [第 82 页]
XML 驱动程序 [第 88 页]
Web 服务驱动程序 [第 100 页]
6.2
CSV OpenDriver
数据访问层允许 BI 平台通过 BusinessObjects OpenConnectivity 网络层连接到逗号分隔值（CSV）文件。它
提供了一个叫做 CSV OpenDriver 的数据访问驱动程序用于访问这些 CSV 文件。
连接向导提供一个用来为连接到 CSV 文件输入必要信息的工作流。CSV 数据源显示在 Text Files DBMS 和
BusinessObjects OpenConnectivity 网络层下方。
向后兼容性
仅对使用 ODBC 连接创建的文档支持 SAP BusinessObjects Enterprise XI 3.x 版和 SAP BusinessObjects
Business Intelligence 平台 4.1 版之间的向后兼容性。
报表用户在 SAP BusinessObjects Web Intelligence 胖客户端中刷新基于 3 层模式 BusinessObjects
OpenConnectivity 连接并使用 XI 3.x 版创建的文档时，将发生以下异常：
Database error: (CS) "Specified network layer is invalid : BO OC". (IES 10901)
(WIS 10901)
XI 3.x 版不支持 3 层模式 JDBC 连接。因此，当用户尝试在 4.1 版中刷新文档时，BusinessObjects
OpenConnectivity 不能被识别为网络层。
64
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
6.2.1
CSV OpenDriver 功能
因为文本文件不提供任何数据库操作，所以数据访问驱动程序实施以下查询功能：
●
SELECT 语句的基本运算（WHERE、ORDER BY、GROUP BY 和 AS）
●
WHERE 子句内的基本运算符（=、<>、<、<=、>、>=、BETWEEN、NOT BETWEEN、LIKE、NOT LIKE、
IS NULL、IS NOT NULL、AND、OR）
●
在 WHERE 子句内使用通配符（“?”）
●
SELECT 语句内的 DISTINCT 子句
●
UNION 和 UNION ALL
数据访问驱动程序也支持在 SELECT 语句中使用 MIN、MAX、AVG、SUM 和 COUNT 分组函数。
驱动程序限制
CSV OpenDriver 不能实施用于更改 CSV 文件状态的任何功能，如 INSERT、UPDATE 和 ALTER。数据访问驱
动程序也不支持对 CSV 文件执行索引或 JOIN 操作。
相关信息
本地磁盘用作排序操作的缓存 [第 108 页]
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 文件都将映射到不同表。
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
65
将所有文件映射到同一个表
表名为模式的名称，例如 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 文件位置 [第 66 页]
CSV 模式检测 [第 67 页]
6.2.3
CSV 文件位置
CSV 用作数据源的文件可以是本地文件，或者也可以是远程文件。对于远程系统上的文件，支持 HTTP、FTP
和 SMB（也称 CIFS）协议。现有版本还支持基于一个证书的 HTTPS 和 FTPS 加密协议。CSV 文件可以位于 BI 平
台的中央管理服务器（CMS）。
66
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
注意
SMB 是 MS Windows 的标准文件共享协议。由于 jCIFS 库可用于访问该协议，因此用户必须将 jCIFS JAR 文件
安装在连接服务器目录中，即<连接服务器安装目录>\connectionServer\sharedLibraries\jcifs。需
要安装的版本为 1.3.15，可以到 http://jcifs.samba.org/
下载。
可以通过连接向导的“位置类型”参数设置数据源是本地的，还是远程的。如果是远程数据源，则必须通过向导的
“协议”参数设置使用的协议。“协议”值必须与“文件路径或模式”和“模式文件”参数值中支持的协议相匹配。
示例
CSV 文件路径
●
C:\csv\report.csv 或 csv/report.csv（对于本地文件）
●
http://服务器:8080/路径/report.csv（对于可通过 HTTP 访问的文件）
●
ftp://服务器/路径/ 表示可通过 FTP 访问的文件
●
smb://服务器:端口号/共享/目录 表示可通过 SMB 访问的文件
6.2.4
CSV 模式检测
数据访问层提供用于 CSV 文件的以下模式检测方法：
●
不检测
●
自动检测
●
使用数据定义语言（DDL）文件
●
使用 SQLDDL 文件
可以使用连接向导中的“模式检测”参数选择适用于文件的方法。可以使用模式文件（DDL 或 SQLDDL）提供模
式。这对大而复杂的文件很有用。
文件按字母顺序进行分析。
注意
CSV 文件开头的几行中可能包含注释，使用向导中的“开头的注释行数”参数可以跳过这些行。
不检测
数据访问驱动程序跳过注释行，分析第一行并确定列数，但不确定列类型。所有值都被视为字符串，并且列大
小被设置为 255 个字符，这一设定与 VARCHAR 数据类型的标准长度对应。大于 255 个字符的值会被截断。列中可
以包含空值。
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
67
自动检测
记忆
此方法不能应用到固定列长度的 CSV 文件。
数据访问驱动程序会分析格式正确的文件，并获取以下信息：
●
列名称
多数情况下，第一行包含了列的名称。否则，CSV OpenDriver 会以 column_0、column_1、……、
column_<n> 的格式生成列名称。
●
列类型
驱动程序使用数值、日期和时间数据类型的预定义模式和用户设置来查找列类型。如果一列中含有多种类型的
值，驱动程序会将此列的值视作字符串。
●
列大小
列的大小取决于其类型。对于数值，列大小等于同类型范围中最大值的长度。对于其他值，列大小等于检测过
程中找到的最长字符串值的长度。
警告
仅当“探测器行”设置为“全部”时，驱动程序才能找到最长的字符串。
●
列可为空
如果列中存在空值，那么列可为空即为真；如果所有值都不为空，那么列可为空即为假。
除非选择所有行，否则可以在连接向导中设置“探测器行数”参数来选择驱动程序必须分析的行数。
请参阅《信息设计工具用户指南》了解建议的设置。
使用 DDL 文件
数据访问驱动程序首先会分析用于将 SQL 数据类型转换为驱动程序数据类型的 DDL 文件。
DDL 文件的模式如下：
ColumnName[:ColumnType[(Length)]];
例如：
col1:VARCHAR(20);
col2:DATE;
col3:INTEGER;
col4:INTEGER;
DDL 文件只能定义一种表模式。驱动程序会将同样的模式分配到每一个用作数据源的 CSV 文件。
68
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
使用 SQLDDL 文件
数据访问驱动程序首先会分析用于将 SQL 数据类型转换为驱动程序数据类型的 SQLDDL 文件。
SQLDDL 文件的模式如下：
CREATE TABLE <Filename> (
(<ColumnName> <ColumnType> [NOT] NULL,)*
(<ColumnName> <ColumnType> [NOT] NULL)
);
例如：
CREATE TABLE Clients (
id INTEGER NOT NULL,
name CHAR(20) NULL,
date DATE NULL,
PRIMARY KEY (id) )
SQLDDL 文件可以定义多个表模式。驱动程序可以将一个模式分配到多个表。
数据访问驱动程序会分析 CREATE 语句。如果存在其他语句，那么这些语句会被忽略。
如果 DDL 或 SQLDDL 文件未定义列类型，那么驱动程序会将列中的值视作 255 个字符长的字符串。大于 255
个字符的值会被截断。如果 DDL 或 SQLDDL 文件定义了类型但未定义长度，那么驱动程序会使用标准的长度，例
如对于整数长度为 10。对于 DECIMAL 数据类型，必须定义精度和小数部分位数。
6.3
OData 驱动程序
数据访问层允许将 BI 平台连接到使用开放数据（OData）协议的数据源。 此协议提供称为 OData 驱动程序的
数据访问驱动程序，用于访问互联网或内部网上的联机数据源。 OData 驱动程序支持模式以概念模式定义语言
（CSDL）2.0 描述的 OData 2.0 协议。
OData 驱动程序允许将 BI 平台连接到 SAP Gateway 2.0 提供的 OData 服务。 SAP Gateway 2.0 允许应用程序
用户从 SAP Business Suite 系统（例如 ERP 和 CRM）通过 HTTP 访问数据。
连接向导提供一个用来为连接到 OData 数据源输入必要信息的工作流。 OData 数据源显示在 Generic OData
2.0 DBMS 和 OData Connector 网络层下方。
可在<连接服务器安装目录>\connectionServer\odata 目录中找到驱动程序配置文件。 odata.prm 文件
中列出了数据访问驱动程序在数据库操作和函数方面的功能。
6.3.1
OData 驱动程序功能
数据访问驱动程序支持以下查询功能：
●
基本数据库操作（SELECT、WHERE、ORDER BY、结构化联接）
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
69
●
WHERE 子句内的基本过滤运算符（=、!=、<、<=、>、>=、AND、OR、LIKE、NOT LIKE、BETWEEN、
NOT BETWEEN、IS NULL、IS NOT NULL）
●
FROM 子句内的嵌套查询
虽然 AS、DISTINCT 和 GROUP BY 操作不能以 OData 2.0 协议表达，但数据访问驱动程序仍支持这些操作。
驱动程序在内部执行这些操作。
限制
现有版本的 OData 驱动程序不支持以下功能：
●
UNION 和 UNION ALL 操作
●
HAVING 子句
●
聚合函数中的 DISTINCT
●
WHERE 子句中的子查询
数据库函数
虽然数据库函数 AVG、MIN、MAX 和 SUM 不能以 OData 2.0 协议表达，但数据访问驱动程序仍支持这些函数。
驱动程序在内部执行这些操作。OData 2.0 协议仅支持与 $count 运算符对应的 COUNT 函数。
相关信息
OData 驱动程序 － 映射键 [第 74 页]
OData 驱动程序 － 重要行为与限制 [第 80 页]
本地磁盘用作排序操作的缓存 [第 108 页]
CSV OpenDriver、OData、SAP ERP、XML 和 Web 服务驱动程序能够将本地磁盘用作已排序的行的缓存。
6.3.2
OData 服务位置
不能通过 HTTP 连接到 OData 服务。 现有版本还支持基于一个证书的 HTTPS 加密协议。
示例
下面的链接引用通过 HTTP 和 HTTPS 连接到 OData 服务的示例，并且引用 SAP Gateway 服务的示例。
相关信息
http://services.odata.org/Northwind/Northwind.svc/
70
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
https://api.datamarket.azure.com/Data.ashx/data.gov/Crimes/
http://gw.esworkplace.sap.com/sap/opu/odata/sap/SALESORDERS/
6.3.3
OData 服务示例
OData 数据源根据基于实体数据模型（EDM）的模式提供数据。该模式借助 CSDL 进行描述。CSDL 是一种
XML 格式，描述实体数据模型模式的结构和语义。
下面的示例阐明了基于 CSDL 的模式的结构。此模式定义提供 Northwind 服务的 OData 数据源的元数据。服务
URI 为 http://services.odata.org/Northwind/Northwind.svc/
息，请参阅 CSDL specification
。要了解有关控制实体数据模型的概念的更多信
。
记忆
现有版本的 OData 驱动程序不支持 FunctionImports、AnnotationElements、ReferentialConstraints 和动态
属性。
示例
Northwind 服务模式
可以从以下位置访问模式：http://services.odata.org/Northwind/Northwind.svc/$metadata
。
注意
出于文档制作目的，本文档中的示例添加了虚构的 CustomerClothing ComplexType 和
CustomerClothes Property。
<Schema Namespace ="NorthwindModel">
...
<EntityType Name="Customer">
<Key>
<PropertyRef Name="CustomerID"/>
</Key>
<Property Name="CustomerID" Type="Edm.String" Nullable="false" MaxLength="5"
Unicode="true" FixedLength="true"/>
<Property Name="CompanyName" Type="Edm.String" Nullable="false"
MaxLength="40" Unicode="true" FixedLength="false"/>
<Property Name="ContactName" Type="Edm.String" Nullable="true"
MaxLength="30" Unicode="true" FixedLength="false"/>
<Property Name="ContactTitle" Type="Edm.String" Nullable="true"
MaxLength="30" Unicode="true" FixedLength="false"/>
<Property Name="CustomerClothes" Type="NorthwindModel.CustomerClothing"
Nullable="false">
...
<NavigationProperty Name="Orders"
Relationship="NorthwindModel.FK_Orders_Customers" FromRole="Customers"
ToRole="Orders"/>
<NavigationProperty Name="CustomerDemographics"
Relationship="NorthwindModel.CustomerCustomerDemo" FromRole="Customers"
ToRole="CustomerDemographics"/>
</EntityType>
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
71
<ComplexType Name="CustomerClothing">
<Property Name="Suit" Type="Edm.String" Nullable="false">
<Property Name="Shoes" Type="Edm.String" Nullable="true">
...
</ComplexType>
<Association Name="FK_Orders_Customers">
<End Role="Customers" Type="NorthwindModel.Customer" Multiplicity="0..1"/>
<End Role="Orders" Type="NorthwindModel.Order" Multiplicity="*"/>
<ReferentialConstraint>
...
</ReferentialConstraint>
</Association>
...
</Schema>
<Schema Namespace="ODataWeb.Northwind.Model">
<EntityContainer Name="NorthwindEntities" p7:LazyLoadingEnabled="true"
m:IsDefaultEntityContainer="true">
...
<EntitySet Name="Customers" EntityType="NorthwindModel.Customer"/>
<EntitySet Name="Employees" EntityType="NorthwindModel.Employee"/>
<EntitySet Name="Order_Details" EntityType="NorthwindModel.Order_Detail"/>
<EntitySet Name="Orders" EntityType="NorthwindModel.Order"/>
<EntitySet Name="Products" EntityType="NorthwindModel.Product"/>
...
<AssociationSet Name="FK_Orders_Customers"
Association="NorthwindModel.FK_Orders_Customers">
<End Role="Customers" EntitySet="Customers"/>
<End Role="Orders" EntitySet="Orders"/>
</AssociationSet>
<AssociationSet Name="FK_Employees_Employees"
Association="NorthwindModel.FK_Employees_Employees">
<End Role="Employees" EntitySet="Employees"/>
<End Role="Employees1" EntitySet="Employees"/>
</AssociationSet>
...
</EntityContainer>
</Schema>
6.3.4
OData 驱动程序 － 映射命名空间、所有者和限定符
模式的 Namespace 属性映射到模型命名空间。
EntityContainer 映射到数据库限定符。 默认限定符为 EntityContainer，其属性
m:IsDefaultEntityContainer 设置为 true。
EntityContainer 元素是 Schema 元素的子元素。 由于不同的模式可能包含同一 EntityContainer，数据库限定
符值为 <模式名称空间>.<EntityContainer 名称>。
现有版本的驱动程序仅提供一个所有者，该所有者称为 entities。
示例
Northwind 服务的命名空间为 ODataWeb.Northwind.Model。
Northwind 服务的数据库限定符为 ODataWeb.Northwind.Model.NorthwindEntities。
72
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
Northwind 服务的数据库所有者为 entities。
6.3.5
OData 驱动程序 － 映射表
数据访问驱动程序会将 OData 订阅源作为表提供给信息设计工具。
EntitySet 映射到表。EntitySet 的 Name 属性映射到表名称。
在 OData 模式中，一个 AssociationSet 链接两个 EntitySet。如果两个 EntitySet 的多样性都为 *，则一个
AssociationSet 映射到一个表。AssociationSet 的 Name 属性映射到表名称。如果 EntityType 至少一个多样性为
1 或 0..1，则 AssociationSet 映射到外键。
示例
映射 EntitySet
Northwind 服务的以下 EntitySet 映射到表：
●
Customers
●
Orders
●
Products
示例
映射 AssociationSet
Northwind 服务的以下 AssociationSet 映射到表：
●
CustomerCustomerDemo
●
EmployeeTerritories
CustomerCustomerDemo AssociationSet 映射到表 CustomerCustomerDemo，因为
CustomerCustomerDemo Association 链接了具有 * 多样性的 CustomerDemographic 和 Customer 两个
EntityType。
<Association Name="CustomerCustomerDemo">
<End Role="CustomerDemographics" Type="NorthwindModel.CustomerDemographic"
Multiplicity="*"/>
<End Role="Customers" Type="NorthwindModel.Customer" Multiplicity="*"/>
</Association>
相关信息
OData 驱动程序 － 映射键 [第 74 页]
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
73
6.3.6
OData 驱动程序 － 映射列
EntitySet 由 EntityType 定义。EntityType 由一系列的 Property 组成。简单类型的 Property 映射到表示
EntitySet 的表的一个列。Property 的 Name 属性映射到列名称。
复杂类型的 Property 映射到一组表列。一个列对应一个子属性。列名称由复杂类型和简单类型的属性名称拼接
而成，并以斜杠（/）分隔。此映射也适用于复杂类型的嵌套属性。
示例
表 Orders 包含列 OrderID，因为 Order EntityType 包含 OrderID Property。
表 Customers 包含列 Address、CustomerClothes/Suit 和 CustomerClothes/Shoes，因为：
●
Customer EntityType 的 Address Property 为简单类型。
●
Customer EntityType 的 CustomerClothes Property 为复杂类型，由简单类型的 Suit 和 Shoes 两
个 Property 构成。
6.3.7
OData 驱动程序 － 映射键
映射主键
EntityType 的键映射到表（映射到对应的 EntitySet）的主键。 这可以是一个或多个列。
示例
表 Customers 的列 CustomerID 上有一个主键，因为 Customer EntityType 包含引用 CustomerID
Property 的键。
映射外键
OData 协议使用 NavigationProperty 来提供关系模型的联接路径。 NavigationProperty 使用 AssociationSet
中定义的 Role 根据 EntitySet 的多样性进行链接。
OData 驱动程序将双向联接表示为外键。 如果代表这些表的 EntitySet 的 EntityType 所包含的
NavigationProperty 使用同一个 AssociationSet 来链接 EntitySet，则可以在表之间创建双向联接。 这意味着
AssociationSet 两端的两个 EntityType 都必须包含 NavigationProperty。 不满足此条件的 Association 不会显示
为外键。
如果两个 EntitySet 的多样性都为 *，则 AssociationSet 映射到表。 如果 EntityType 至少一个多样性为 1 或
0..1，则 AssociationSet 映射到表（代表多样性为 * 的 EntitySet）的外键。 外键名称的模式为 -idref-<导航
属性>-<主键>。
74
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
记忆
由于不包含任何业务数据，因此外键在默认情况下是数据基础表中的隐藏列。 但是，可以通过编辑表和列属性
来显示外键。 请参阅《信息设计工具用户指南》。
警告
SAP 建议应用程序用户不要查询 -idref 列，因为这可能会降低驱动程序性能。
示例
EntitySet 的外键
表 Orders 包含外键 -idref-Customer-CustomerID、-idref-Employee-EmployeeID 和 -idrefShipper-ShipperID，因为：
●
Order EntityType 包含以下 NavigationProperty。
<EntityType Name="Order">
...
<NavigationProperty Name="Customer"
Relationship="NorthwindModel.FK_Orders_Customers" FromRole="Orders"
ToRole="Customers"/>
<NavigationProperty Name="Employee"
Relationship="NorthwindModel.FK_Orders_Employees" FromRole="Orders"
ToRole="Employees"/>
<NavigationProperty Name="Shipper"
Relationship="NorthwindModel.FK_Orders_Shippers" FromRole="Orders"
ToRole="Shippers"/>
</EntityType>
●
这些 NavigationProperty 引用 FK_Orders_ Association，这些 Association 将 Order EntityType 链接到
Customer、Employee 和 Shipper 三个 EntityType。 每个 Association 都具有一个 0..1 多样性。 这会
在代表 Orders EntitySet 的表中生成三个外键。
<Association Name="FK_Orders_Employees">
<End Role="Employees" Type="NorthwindModel.Employee" Multiplicity="0..1"/>
<End Role="Orders" Type="NorthwindModel.Order" Multiplicity="*"/>
</Association>
●
-idref-Customer-CustomerID 中的 CustomerID 来自表 Customers 的主键。
●
-idref-Employee-EmployeeID 中的 EmployeeID 来自表 Employees 的主键。
●
-idref-Shipper-ShipperID 中的 ShipperID 来自表 Shippers 的主键。
示例
AssociationSet 的外键
表 CustomerCustomerDemo 包含外键 -idref-CustomerDemographics-CustomerTypeID 和 idref-Customers-CustomerID，因为：
●
Customer EntityType 包含 CustomerDemographics NavigationProperty。
<EntityType Name="Customer">
...
<NavigationProperty Name="CustomerDemographics"
Relationship="NorthwindModel.CustomerCustomerDemo" FromRole="Customers"
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
75
ToRole="CustomerDemographics"/>
</EntityType>
●
CustomerDemographic EntityType 包含 Customers NavigationProperty。
<EntityType Name="CustomerDemographic">
...
<NavigationProperty Name="Customers"
Relationship="NorthwindModel.CustomerCustomerDemo"
FromRole="CustomerDemographics" ToRole="Customers"/>
</EntityType>
●
NavigationProperty 引用 CustomerCustomerDemo Association，该 Association 链接 Customer 和
CustomerDemographic 两个 EntityType。 这会在代表 CustomerCustomerDemo AssociationSet 的表
中生成两个外键。
<Association Name="CustomerCustomerDemo">
<End Role="CustomerDemographics" Type="NorthwindModel.CustomerDemographic"
Multiplicity="*"/>
<End Role="Customers" Type="NorthwindModel.Customer" Multiplicity="*"/>
</Association>
●
-idref-Customers-CustomerID 中的 CustomerID 来自表 Customers 的主键。
●
-idref-CustomerDemographics-CustomerTypeID 中的 CustomerTypeID 来自表
CustomerDemographics 的主键。
6.3.8
OData 驱动程序 － 映射 Documentation 元素
根据可用性，Documentation 的 Summary 或 LongDescription 子元素将映射到关系模型实体的说明。
EntitySet 和 AssociationSet 的 Documentation 子元素在信息设计工具中显示为表说明。Property 或
NavigationProperty 的 Documentation 子元素显示为列说明。 如果不存在任何 Summary 或 LongDescription，
Description 字段将留空。
说明未本地化。
6.3.9
OData 驱动程序 － 映射派生类型的实体
下面的示例阐明了类型 Employee 的 EntitySet。
<EntitySet Name="Employees" EntityType="Employee" />
下图显示了一个基本类型（Employee）与两个派生类型（ExternalEmployee 和 InternalEmployee）之
间的继承概念。 派生类型从基本类型的所有属性继承而来。 这些类型还定义称为直接属性的附加属性。
76
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
对于特定的 EntitySet，结果模式由合并到一个常规类型而得。 下图显示了以关系模型表示的 Employee 表。
关系模型的 Employee 表将同时包含来自两种实体的信息，即父类型和派生类型的列。 为防止命名冲突，派生
类型中声明的列以 EntityType 的名称作为前缀。 而且还可以包含空值。
6.3.10 监控 OData 驱动程序性能
可以考虑利用 OData 驱动程序的以下行为来提升执行查询时的连接性能。
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
77
在客户端或提供程序端执行操作
创建连接时，可以选择在驱动程序或提供程序级别执行部分 SQL 查询操作。下表显示了控制此行为的连接向导
的参数。
如果已选定一个参数，OData 服务提供程序会处理能够支持的相应操作。这是默认行为。如果未选定任何参
数，则 ODdata 驱动程序会处理该操作。
警告
SAP 建议不要使用数据访问驱动程序执行这些操作，因为可能会降低连接性能。由于需要将完整的数据集传输
到客户端，因此响应时间会延长。仅当 OData 提供程序不支持或部分支持该操作时才使用此方法。
参数
操作
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'。
78
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
示例
映射函数 startsWith 和 endsWith
以下 SQL 查询会返回居住在大马路的销售人员。
SELECT * FROM EMPLOYEES WHERE EMPLOYEES."Title" LIKE 'Sales %' AND
EMPLOYEES."Address" LIKE '% Blvd.'
该查询与以下 URI 对应：
http://services.odata.org/Northwind/Northwind.svc/Employees?
$filter=startswith(Title,'Sales')&endswith(Address,'Blvd.')
执行聚合函数
数据库函数 COUNT 是 OData 2.0 协议唯一支持的聚合函数。GROUP BY 子句触发的其他聚合函数和分组在客户
端上执行。但是，如果驱动程序执行会在计算计数之前修改结果的计算，则函数 COUNT 也必须在客户端上执行。
这会降低连接性能。
设置连接超时参数
可以在连接向导中选择“连接超时”参数的值，以便微调驱动程序性能。此参数指定连接在数据源未响应的情况下
保持活动状态的时间（以秒为单位）。
用户必须选择最佳参数值以实现最佳性能。例如，如果连接到响应时间较长的数据源，则可以为“连接超时”选择
一个较大的值，以便等待服务器响应而不会过早出现错误。如果数据源的响应速度通常较快，则可以选择一个较小
的值，以便在服务器无响应时无需等待太长时间后才出现错误。
使用 Cache Metamodel
默认在连接向导中选择参数 Cache MetaModel。此参数允许用户在连接期间只从连接池检索元数据模型一次，
而不必在每次执行查询时进行检索。这能够提升连接性能。
注意
如果元数据模型已缓存，用户必须启用连接共用。
相关信息
OData 驱动程序功能 [第 69 页]
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
79
6.3.11
OData 驱动程序 － 重要行为与限制
排序算法
排序算法可能因服务提供程序而异。 这会导致查询中使用 ORDER BY 时产生不同的结果。
由于 OData 驱动程序可能会使用自身的算法执行排序运算，因此使用组合操作（例如 ORDER BY、GROUP BY
和 DISTINCT）可能会导致出现不同的排序顺序。
映射 Max Rows 参数
仅当查询运算没有修改行数时，OData 函数 $top 才映射到查询面板的 Max Rows 参数。 如果应用过滤器，查
询结果可能不正确，因为过滤器会将部分行从预期的 $top 结果中删除。
示例
以下 OData 查询会从表 Orders 返回前 15 行：
http://services.odata.org/Northwind/Northwind.svc/Orders?$top=15
以下查询会返回前 15 行，其中出货城市为“Reims”（兰斯）。 这仅返回 5 行：
http://services.odata.org/Northwind/Northwind.svc/Orders?$top=15&
$filter=ShipCity eq 'Reims'
对 COUNT 函数的限制
在信息设计工具中对表执行的行计数从语义上来说是计算已定义的列包含非空值的行。 部分 Azure 服务仅返回
一个表的总行数。 这可能会导致预期查询结果与实际查询结果之间出现偏差。
对 SAP Gateway 服务的限制
如果 Gateway 服务提供程序不支持所有列上的过滤器，则创建连接时不可选择“受支持的过滤器条件”。 如果该
服务提供程序不支持所有列上的排序，则创建连接时不可选择“排序”。
模式可以借助元数据 sap:filterable 和 sap:sortable 来指明这些过滤和排序限制。 在现有版本中，
OData 驱动程序不会映射这些属性。
部分提供程序可能不会对所有表提供完整的表扫描功能。 这会导致发生运行时错误，例如，如果无法扫描某个
联接中涉及的其中一个表。
SAP 建议直接创建与 SAP ERP 系统的连接，以避免与 Ad Hoc 查询相关的问题。
80
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
6.3.12 OData 驱动程序 － 配置列最大大小
对于某些属性，MaxLength 参数可能带有值 Max。 例如：
<Property Name="Synopsis" Type="Edm.String" Nullable="true" MaxLength="Max"
Unicode="true" FixedLength="false"/>
由于 OData 驱动程序无法识别，因此必须配置此数值。 cs.cfg 配置文件提供以下参数：
●
Binary Max Length － 用于设置类型为二进制的表列的最大大小
●
String Max Length － 用于设置类型为字符串的表列的最大大小
相关信息
Binary Max Length [第 173 页]
String Max Length [第 183 页]
6.3.13 OData 源身份验证
对某些 OData 数据源的访问需要身份验证。 应用程序能够使用以下方法对 OData 数据源进行身份验证：
●
使用用户名和密码的 HTTP 基本身份验证。 凭据未加密。
●
GET 访问令牌，这是附加到服务 URI 的一个键值对。 令牌的键和值可因服务而异。 可以使用连接向导中的“自
定义身份验证参数”通过自定义参数设置令牌。 请使用以下模式： <<键>>=<<值>>。
注意
数据访问层不为自定义身份验证参数提供跟踪，因为这些参数包含安全信息。 这些参数在 OData 驱动程序跟踪
中被替换成 <CUSTOM_AUTH_PARAMS>。 但是，请考虑使用其他跟踪级别（例如 CMC 中的“启用作业跟踪”选
项）来显示参数。
示例
访问令牌
http://wine.cloudapp.net/Regions?apikey=<<API 键值>>。
Microsoft Azure 数据源身份验证
可以使用 HTTP 基本身份验证连接到 Microsoft Azure 数据集。 在连接向导中，将帐户密钥输入为密码。 可以
将用户名留空。
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
81
6.3.14 跟踪 OData 驱动程序活动
数据访问层以 PATH 和 DEBUG 严重性级别跟踪 OData 驱动程序。PATH 跟踪包含规划和执行查询时所使用的
每个方法的入口和出口。此跟踪级别可让用户了解 OData 驱动程序或 OData 提供程序是否已执行查询操作并查明
问题所在。
URI 所包含的信息（数据源凭据、代理服务器凭据和自定义身份验证参数）在驱动程序跟踪中显示为空白。
6.4
SAP ERP 驱动程序
数据访问层允许 BI 平台通过 SAP Java Connector (JCo) 3.x 网络层连接到 SAP ERP 系统。它提供了一个数据
访问驱动程序，用于访问以下 ERP 对象：
●
InfoSet
●
SAP 查询
●
ABAP 函数
有关支持的 SAP ERP 系统的更多信息，请参阅《Product Availability Matrix》（产品可用性矩阵）。
SAP ERP 连接在所有平台上均支持单一登录（SSO）。有关身份验证的更多信息，请参阅《SAP
BusinessObjects Business Intelligence 平台管理员指南》。
SAP ERP 连接还支持对所有身份验证模式使用首选查看区域设置（PVL）。创建连接时，可通过选中“保存语言”
来停用 PVL。
可在 <connectionserver-install-dir>\connectionServer\jco 目录中找到驱动程序配置文件。
jco.prm 文件中列出了数据访问驱动程序在数据库操作方面的功能。
连接向导提供一个用来为连接到 SAP ERP 系统输入必要信息的工作流。
相关信息
单一登录支持 [第 27 页]
6.4.1
SAP ERP 驱动程序功能
数据访问驱动程序支持以下查询功能：
●
基本运算（SELECT、WHERE、ORDER BY、GROUP BY 和 AS）
●
基本运算符（=、!=、<、<=、>、>=、BETWEEN、NOT BETWEEN、IN、NOT IN、AND、OR），其操
作数可以是列名称或常量值
●
82
SELECT 语句内的 DISTINCT 子句
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
●
SELECT 语句内的常量值
●
LIKE 和 NOT LIKE 接受转义符
●
FROM 子句内的嵌套查询
数据访问层在内部执行排序运算。
注意
数据访问驱动程序不允许按 SQL 语句中的索引对列排序。只有带列名称的 ORDER BY 才是有效子句。在
jco.prm 文件中，ORDER_BY_SUPPORTS_COLUMN_INDEX 参数设置为 NO。
相关信息
本地磁盘用作排序操作的缓存 [第 108 页]
CSV OpenDriver、OData、SAP ERP、XML 和 Web 服务驱动程序能够将本地磁盘用作已排序的行的缓存。
ORDER_BY_SUPPORTS_COLUMN_INDEX [第 212 页]
6.4.2
SAP ERP 驱动程序 － 访问 InfoSet 和 SAP 查询
关于 InfoSet 和 SAP 查询
在 SAP ERP 系统中，InfoSet 和 SAP 查询组织在本地工作区域或全局工作区域内。 本地工作区域内的对象只能
被所使用的 SAP ERP 客户端访问，而全局工作区域内的对象可以被所有客户端访问。 SAP 查询在用户组内创建，
并属于该用户组。
有关工作区域和用户组的更多信息，请参阅 SAP ERP 文档。
对象映射
数据访问驱动程序将 InfoSet 和 SAP 查询作为表提供给信息设计工具。 InfoSet 和 SAP 查询由一系列字段构
成，这些字段均映射到表列。 字段在 SELECT 语句中使用。
在驱动程序级别，工作区域映射到限定符。 默认限定符与本地工作区域对应。
用户组映射到所有者。 然后，将工作区域的用户组放在代表此工作区域的限定符下方。
工作区域的 InfoSet 放在代表此工作区域的限定符下方和称为 INFOSET 的虚构所有者下方。 工作区域的 SAP
查询放在代表此工作区域的限定符下方。 用户组的 SAP 查询放在代表此用户组的所有者下方。
工作区域内的 InfoSet 和 SAP 查询的组织结构如下图所述：
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
83
字段映射到表列。 InfoSet 或 SAP 查询中包含同时用于投影和选择的字段。 它还包含不用于投影的选择字段。
使用连接向导创建连接时，选择是否将这些选择字段表示为表列。 “将选择字段映射到表列”参数用于执行此项功
能。 如果已选定，该字段将映射为可选的输入列。 如果未选定，将忽略选择字段，并且不能在该字段上执行过
滤。
注意
没有针对必需选择字段的特定映射。 应用程序用户必须使用过滤器查询这些字段。
输入列
表的输入列是应用程序用户在查询表时必须为其提供等于条件（= 运算符）的列。 仅允许在输入列上使用等于
条件。 禁止使用 IN 条件。
84
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
在信息设计工具中，用户可以将输入列视为必需列或可选列。 必需输入列是必须设置值的列。 可选输入列是不
强求设置值的列。
如果用户不为查询中的可选输入列设置任何值，连接服务器返回以下任一结果：
●
不返回值（如果可选输入列没有默认值）
●
返回默认值（如果可选输入列有默认值）
Driver Capabilities
应用程序用户查询 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 函数的概念
ABAP 函数由一系列参数构成，这些参数可以是函数调用中使用的输入参数，也可以是调用响应中包含的输出
参数。 在 SAP 术语中，输入参数称为导入参数，而输出参数则称为导出参数。 某些参数可以同时充当输入参数和
输出参数。 这种参数称为可变参数。 除了导入参数、导出参数和可变参数之外，还有表参数。表参数可视为一种
可变参数。
下面是 ABAP 函数参数的类型：
●
简单 ABAP 类型字段
●
结构（由若干字段的序列构成）
●
表（可以由字段、结构，甚至表构成）
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
85
对象映射
数据访问驱动程序会将 ABAP 函数作为表提供给信息设计工具。 在驱动程序级别，ABAP 函数组映射到所有
者，而 ABAP 函数则映射到名称为 ABAPFunction 的限定符。 这就意味着，每个 ABAP 函数都放在特定所有者的
下方，而该所有者又对应 SAP ERP 系统内的函数组。
用作输入的导入参数、可变参数和表参数映射到输入列。 用作输出的导出参数、可变参数和表参数映射到表
中。 输入列可以是必需的，也可以是可选的。 数据访问层将这些参数视为不可为空的主键属性。
驱动程序以下面的方式映射 ABAP 函数参数：
●
必需参数映射到必需输入列。 用户必须为该列设置值。
●
有默认值的可选参数映射到可选输入列。 用户不必为该列设置值。 这种情况下，由数据源返回到连接服务
器的值为默认值。
●
无默认值的可选参数也映射到可选输入列。 根据输入列的 SQL 类型，连接服务器返回字符串数据类型的以
下值：
SQL 类型
值
SQL_Integer
0
SQL_Char、SQL_VarChar、SQL_Binary
空字符串
SQL_Double、SQL_Float、SQL_Numeric
0.0
SQL_Date
00010101
SQL_Time
000000
任何其他类型
空字符串
注意
驱动程序将为 ABAP 函数映射到的表追加一个<列名称>-ID 列；如果表中包含对另一个表的引用，将为表再追
加一个<列名称>-IDREF 列。
重命名列
列名称在驱动程序级别重命名。 下表给出了添加到列的前缀。
86
输入或输出
参数
前缀
输入
导入
-IMPORT_
输入
可变
-IMPORT_CH_
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
输入或输出
参数
前缀
输入
表
-IMPORT_CH_
输出
可变
-EXPORT_CH_
输出
表
-EXPORT_CH_
注意
如果输出表参数（A）由另一个表（B）构成，那么这两个表将分别重命名为 -EXPORT_CH_A 和 EXPORT_CH_A.B。
Driver Capabilities
所有数据库操作（SELECT、WHERE、ORDER BY、GROUP BY、AS 等）都由驱动程序在内部处理，而输入列
中的等于条件则传递到 SAP ERP 系统。
记忆
驱动程序仅接受只有一行的表作为输入参数。 这些表等价于输入结构。
●
在连接向导中创建连接时，用户会设置是否将表类型的可变参数或表参数同时视为输入和输出参数。 “将表参
数映射到输入列”参数用于实现此功能。 如果选中，此参数同时充当输入和输出。 在这种情况下，此参数只能
是结构才能充当输入。 如果未选中，此参数仅视为输出参数。
●
驱动程序将可选输入结构的字段视为可选输入列。 输入列整体视为可选，即如果一个列中有值，其他输入列中
也必须有值。 应用程序用户必须确保所有列中都有值。
●
某些 ABAP 函数参数可能具有 SAP ERP 系统报告等于零的值。 驱动程序使用 cs.cfg 文件的 String Max
Length 参数，将字符串最大长度设置为映射到这些参数的表列。
相关信息
String Max Length [第 183 页]
6.4.4
SAP ERP 驱动程序限制
●
不能查询基于 ABAP 程序（涉及 SAPGUI 处理）的 ERP 对象，因为无法使用远程函数调用访问它们。
●
JCo API 不支持数组提取。这意味着一次性返回所有结果数据。要限制生成的行数并避免内存不足的问题，应
用程序用户必须正确过滤数据。不管是否应用此限制，连接服务器都将应用数组提取。
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
87
注意
应用程序用户还可以在查询面板中将值设置为 Max Rows。但是，如果定义的 Universe 是多源的或如果查
询要求在提取数据后执行计算（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 可用于单源和多源 Universe。将 ERP Max Rows
设置为适当的值，以便避免内存不足的问题。
注意
对于多源 Universe，也可以在数据联合管理工具的“查询面板”中设置 Max Rows 参数的值。有关更多信息，
请参阅《数据联合管理工具指南》。
相关信息
Array Fetch Size [第 171 页]
ERP Max Rows [第 187 页]
6.5
XML 驱动程序
数据访问层允许 BI 平台连接到 XML 文档以将其用作数据源。
XML 文档基于 XML 模式。XML 模式是一个 XSD 文档，定义 XML 数据源的元数据。
连接向导提供一个用来为连接到 XML 数据源输入必要信息的工作流。XML 数据源显示在 XML Files DBMS
和 XML File Connector 网络层下方。
可在<连接服务器安装目录>\connectionServer\xml 目录中找到驱动程序配置文件。xml.prm 文件中列出
了数据访问驱动程序在数据库操作和函数方面的功能。
6.5.1
XML 驱动程序功能
数据访问驱动程序支持以下查询功能：
●
基本数据库运算（SELECT、WHERE、ORDER BY、GROUP BY、DISTINCT）
●
ORDER BY 子句（AS）内的列别名
●
FROM 子句内的嵌套查询
●
过滤运算符（=、!=、<、<=、>、>=、AND、OR、BETWEEN、NOT BETWEEN、IN、NOT IN、LIKE、NOT
LIKE、IS NULL、IS NOT NULL）
88
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
数据访问驱动程序不支持 JOIN 操作。
数据访问驱动程序支持在 SELECT 语句中使用 MIN、MAX、AVG、SUM 和 COUNT 分组函数。
相关信息
本地磁盘用作排序操作的缓存 [第 108 页]
CSV OpenDriver、OData、SAP ERP、XML 和 Web 服务驱动程序能够将本地磁盘用作已排序的行的缓存。
6.5.2
XML 文件位置
用作数据源的 XML 文档可以是本地文档，或者也可以是远程文档。对于远程系统上的文件，支持 HTTP、FTP
和 SMB 协议。现有版本还支持基于一个证书的 HTTPS 和 FTPS 加密协议。
注意
SMB 是 MS Windows 的标准文件共享协议。由于 jCIFS 库可用于访问该协议，因此用户必须将 jCIFS JAR 文件
安装在连接服务器目录中，即<连接服务器安装目录>\connectionServer\sharedLibraries\jcifs。需
要安装的版本为 1.3.15，可以到 http://jcifs.samba.org/
下载。
可以通过连接向导的“位置类型”参数设置数据源是本地的，还是远程的。如果是远程数据源，还可以通过向导的
“协议”参数设置所使用的协议。“协议”值必须与“文件路径或模式”参数值中指定的协议相匹配。
示例
XML 文件路径
●
C:\xml\report.xml 或 xml/report.xml（对于本地文件）
●
http://服务器:8080/路径/report.xml（对于可通过 HTTP 访问的文件）
●
ftp://服务器/路径/ 表示可通过 FTP 访问的文件
●
smb://服务器:端口号/共享/目录 表示可通过 SMB 访问的文件
相关信息
CSV 文件位置 [第 66 页]
6.5.3
XML 文档和模式示例
下面的示例阐明了名称为 clubdemo.xml 并基于模式 clubdemo.xsd 的 XML 文档的结构。
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
89
示例
clubdemo.xml 文档
<?xml version="1.0" encoding="UTF-8"?>
<ClubDemo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="clubdemo.xsd">
<Countries>
<Country name="France"/>
<Country name="US"/>
</Countries>
<Customers>
<Customer ID="204">
<Name type="first">Christine</Name>
<Name type="last">Martin</Name>
<Age>25</Age>
<Address>12, allee Victor Hugo</Address>
<ZIP>75016</ZIP>
<City>Paris</City>
<Country name="France"/>
<Invoice>1234</Invoice>
</Customer>
<Customer ID="103">
<Name type="first">Peter</Name>
<Name type="last">Travis</Name>
<Age>34</Age>
<Address>7835 Hartford Drive</Address>
<ZIP>06108</ZIP>
<City>Springfield</City>
<Country name="US"/>
<Invoice>23204</Invoice>
</Customer>
<Customer ID="106">
<Name type="first">William</Name>
<Name type="last">Baker</Name>
<Age>64</Age>
<Address>2890 Grant Avenue</Address>
<ZIP>20020</ZIP>
<City>Washington DC</City>
<Country name="US"/>
<Invoice>35306</Invoice>
<Invoice>44106</Invoice>
</Customer>
</Customers>
</ClubDemo>
示例
clubdemo.xsd 模式
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="ClubDemo">
<xs:complexType>
<xs:sequence>
<xs:element ref="Countries"/>
<xs:element ref="Customers"/>
</xs:sequence>
</xs:complexType>
<xs:key name="countkey">
<xs:selector xpath="Countries/Country"/>
<xs:field xpath="@name"/>
90
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
</xs:key>
<xs:key name="custkey">
<xs:selector xpath="Customers/Customer"/>
<xs:field xpath="@ID"/>
</xs:key>
<xs:keyref name="custkeyref" refer="countkey">
<xs:selector xpath="Customers/Customer"/>
<xs:field xpath="Country/@name"/>
</xs:keyref>
</xs:element>
<xs:element name="Countries">
<xs:complexType>
<xs:sequence>
<xs:element ref="Country" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Country">
<xs:complexType>
<xs:attribute name="name" type="xs:string"/>
</xs:complexType>
</xs:element>
<xs:element name="Customers">
<xs:complexType>
<xs:sequence>
<xs:element ref="Customer" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Customer">
<xs:complexType>
<xs:sequence>
<xs:element name="Name" maxOccurs="2">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="type" type="xs:string"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="Age" type="xs:integer"/>
<xs:element name="Address" type="xs:string"/>
<xs:element name="ZIP" type="xs:string"/>
<xs:element name="City" type="xs:string"/>
<xs:element name="Country">
<xs:complexType>
<xs:attribute name="name" type="xs:string"/>
</xs:complexType>
</xs:element>
<xs:element name="Invoice" type="xs:integer"
maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="ID" type="xs:integer"/>
</xs:complexType>
</xs:element>
</xs:schema>
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
91
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 文档根元素映射到表。
包含大于 1 的 maxOccurs 值的元素将映射到表。
映射到某个元素的表的名称由根元素到该元素之间所有元素的名称拼接而成，并以斜杠（/）分隔。
示例
文档 clubdemo.xml 映射到以下表：
●
ClubDemo
●
ClubDemo/Countries/Country
●
ClubDemo/Customers/Customer
●
ClubDemo/Customers/Customer/Invoice
●
ClubDemo/Customers/Customer/Name
相关信息
XML 文档和模式示例 [第 89 页]
92
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
6.5.6
XML 驱动程序 － 映射列
XML 元素下方的以下对象映射到代表此元素的表的列。
●
Attributes
●
类型为 simpleType 或 complexType 且包含元素 simpleContent 的元素
●
混合元素中的文本，即其类型定义 mixed=true
●
any 和 anyAttribute
如果列代表一个属性，则其名称由所有元素的名称拼接而成，元素的范围从包含大于 1 的 maxOccurs 的元素
（不包括）开始直到承载此属性的元素（包括）为止。属性名称以 @ 作为前缀，以避免与其他元素发生名称冲突。
如果列代表一个元素，则其名称由所有元素的名称拼接而成，元素的范围从包含大于 1 的 maxOccurs 的元素
（不包括）开始直到承载此属性的元素（包括）为止。
如果列所代表的元素与其表相同，则其名称与元素名称相同。
拼接中使用斜杠（/）作为分隔符。
如果元素代表用于构建外键的路径中使用的父元素，元素名称将以连字符（-）作为前缀。
以下映射示例引用 XML 文档和模式的示例的相关主题。
示例
表 ClubDemo 包含以下列：
●
-id
示例
表 ClubDemo/Countries/Country 包含以下列：
●
@name
●
-Countries/-ClubDemo/-id
示例
表 ClubDemo/Customers/Customer 包含以下列：
●
Age
●
Address
●
ZIP
●
City
●
Country/@name
●
@ID
●
-Customers/-ClubDemo/-id
示例
表 ClubDemo/Customers/Customer/Invoice 包含以下列：
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
93
●
-id
●
Invoice
●
-Customers/@ID
示例
表 ClubDemo/Customers/Customer/Name 包含以下列：
●
-id
●
Name
●
@type
●
-Customer/@ID
在 XML 模式中，name、type 和 ID 分别是元素 Country、Name 和 Customer 的属性名称。列 Invoice 和
Name 分别代表元素 Invoice 和 Name。要了解其他列名称的含义，请参阅映射主键和外键的相关主题。
相关信息
XML 文档和模式示例 [第 89 页]
XML 驱动程序 － 映射主键和外键 [第 94 页]
XML 驱动程序 － 映射 anyType 和 simpleType [第 98 页]
6.5.7
XML 驱动程序 － 映射主键和外键
主键
以下规则适用于映射主键：
●
驱动程序生成映射文档根元素的表的主键。 关联的列称为 -id，列值为文档名称。
●
类型“xs:ID”的属性或元素映射到表示主键的列。
如果 XML 模式定义带 <xs:key> 的键，则以下规则适用：
●
如果在根级别下定义该键，并且选择器包含的元素具有大于 1 的 maxOccurs 值，则该键映射到相应的表的主
键。
●
如果没有在根级别下定义该键，则表的主键由父元素的主键和该键的字段组合而成。
如果该模式没有为具有大于 1 的 maxOccurs 值的选择器元素定义一个主键，则名称为 -id 的列会作为主键添
加到表。
示例
文档根元素
元素 ClubDemo 是文档 clubdemo.xml 的根元素。 将会创建列 -id 并定义为表 ClubDemo 的主键。 列 id 的值为 clubdemo.xml。
94
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
示例
显式键
在根级别设置的以下键将列 @name 定义为表 ClubDemo/Countries/Country 的主键：
<xs:key name="countkey">
<xs:selector xpath="Countries/Country"/>
<xs:field xpath="@name"/>
</xs:key>
表 ClubDemo/Customers/Customer 将列 @ID 用作主键，因为模式定义了显式键 custkey：
<xs:key name="custkey">
<xs:selector xpath="Customers/Customer"/>
<xs:field xpath="@ID"/>
</xs:key>
示例
无显式键
表 ClubDemo/Customers/Customer/Invoice 将列 -id 用作主键，因为模式没有为此元素定义一个
键。
外键
如果 XML 模式定义了带 <xs:keyref> 的键引用，并且在与其引用的键相同的级别定义键引用，则该键引用会
映射到相应的表的外部键。
对于与非根元素对应的每个表，外键由父表的主键列以及元素到其父元素的反向路径构建而成。 这允许映射父
元素与子元素之间的关系。
限制
虽然数据基础提供外键，但 XML 驱动程序不支持 JOIN 操作。
示例
键引用
表 ClubDemo/Customers/Customer 包含以下外键：
●
Country/@name － 以下键引用的字段：
<xs:keyref name="custkeyref" refer="countkey">
<xs:selector xpath="Customers/Customer"/>
<xs:field xpath="Country/@name"/>
</xs:keyref>
请注意，countkey 是为非父元素的表定义的显式键。
●
-Customers/-ClubDemo/-id － 由指向其父表的反向路径以及父表的主键构建而成
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
95
示例
无键引用
表 ClubDemo/Customers/Customer/Invoice 包含定义为外键的列 -Customer/@ID，该列由父表的主
键列以及指向其父表的反向路径构建而成。
相关信息
XML 文档和模式示例 [第 89 页]
XML 驱动程序 － 映射列 [第 93 页]
6.5.8
XML 驱动程序 － 映射混合元素
混合元素的全部内容映射到表列。这包括其子元素以及这些子元素之间的所有数据。
无论元素的映射方式如何，混合元素的属性都会映射到列。
示例
在此示例中，元素 documentation 包含由三个子元素（name、datatype 和 location）组成的
complexType。
<documentation>
The <name>XML driver</name> allows you to retrieve <datatype>XML</datatype>
data
from documents located on a <location>remote server</location>.
</documentation>
数据访问层按照以下方式映射这些元素：
●
元素 documentation 映射到表列。
●
元素 documentation 的内容（包括其子元素以及子元素之间的所有数据）变为列数据。在上面的示例
中，列包含以下行：
The <name>XML driver</name> allows you to retrieve <datatype>XML</datatype>
data from documents located on a <location>remote server</location>.
6.5.9
XML 驱动程序 － 映射递归元素
以下模式定义递归元素：
<xs:element name="parent">
<xs:complexType>
<xs:sequence>
96
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
<xs:element ref="child" minOccurs="0" maxOccurs="5"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="child">
<xs:complexType>
<xs:sequence>
<xs:element ref="parent" minOccurs="0" maxOccurs="2"/>
</xs:sequence>
</xs:complexType>
</xs:element>
XML 驱动程序将第一个 parent 元素和 child 元素映射到表，并忽略 parent 的 child。
6.5.10 XML 驱动程序 － 映射 any 和 anyAttribute
示例
带 any 的 XSD 模式
<xs:element name="documentation">
<xs:complexType>
<xs:sequence>
<xs:element name="name" type="xs:string"/>
<xs:element name="datatype" type="xs:string"/>
<xs:any minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>
</xs:element>
●
name 和 datatype 映射到列
●
元素 any 映射到列 -any
示例
带 any 的 XML 文件
<documentation>
<name>Data Access Guide</name>
<datatype>XML</datatype>
<audience>
<type>External</type>
<name>Administrator</name>
</audience>
</documentation>
列数据 -any 是元素名称及其内容。 在上面的示例中，该列包含以下行：
<audience><type>External</type><name>Administrator</name></audience>
限制
如果 any 元素包含的 maxOccurs 大于 1，XML 驱动程序仅映射到分析 XML 文档时列 -any 遇到的第一个元
素名称。 其他元素名称会被忽略。
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
97
在下面的示例中，<format>PDF</format> 会被忽略。
<documentation>
<name>Data Access Guide</name>
<datatype>XML</datatype>
<audience>
<type>External</type>
<name>Administrator</name>
</audience>
<format>PDF</format>
</documentation>
示例
带 anyAttribute 的 XSD 模式
<xs:element name="documentation">
<xs:complexType>
<xs:sequence>
<xs:element name="name" type="xs:string"/>
<xs:element name="datatype" type="xs:string"/>
</xs:sequence>
<xs:anyAttribute/>
</xs:complexType>
</xs:element>
●
name 和 datatype 映射到多个列
●
元素 anyAttribute 映射到列 -@anyAttribute
示例
带 anyAttribute 的 XML 文件
<documentation myAttribute="ConnectionServer">
<name>Data Access Guide</name>
<datatype>XML</datatype>
</documentation>
<documentation myAttribute="DataFederator">
<name>Data Federator User Guide</name>
<datatype>any</datatype>
</documentation>
列数据 -@anyAttribute 是元素属性名称及其值。 在上面的示例中，列数据包含以下两行：
myAttribute="ConnectionServer"
myAttribute="DataFederator"
6.5.11
XML 驱动程序 － 映射 anyType 和 simpleType
以下各节阐明了 anyType 以及特定排列的 simpleType 在 XML 模式中的映射方式。
98
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
映射 anyType 类型
类型为 anyType 的元素的全部内容映射到一个表列。
示例
anyType
在 ClubDemo 示例中，以下 Address 元素映射到列 Address。
<xs:element name"Address" type="xs:anyType"/>
映射值列表
无论值的基本数据类型是哪种，值列表总是映射到 VARCHAR。
示例
数据类型列表
基本数据类型是整数。 整数列表的数据类型是 VARCHAR。
<intvalues>100 34 56 -23 1567</intvalues>
映射对某个类型的限制
可以将元素的值限制到特定范围。 这不会影响数据类型转换。
示例
限制
<xs:element name="age">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="100"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
映射类型联合
联合映射到的 XML 数据类型为字符串，即数据基础中的 CHAR 或 VARCHAR 数据类型。
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
99
示例
类型联合
<xs:element name="jeans_size">
<xs:simpleType>
<xs:union memberTypes="xs:string xs:int"/>
</xs:simpleType>
</xs:element>
6.5.12 XML 驱动程序 － 配置列最大大小
cs.cfg 配置文件提供以下参数：
●
Binary Max Length － 用于设置数据类型为二进制的表列的最大大小
●
Integer Max Length － 用于设置数据类型为 integer、nonPositiveInteger、negativeInteger、
noNegativeInteger 和 positiveInteger 的表列的最大大小
●
String Max Length － 用于设置数据类型为字符串或以下任意类型的表列的最大大小： anyURI、
QName、NOTATION、duration、gYearMonth、gYear、gMonthDay、gDay、gMonth、
TYPE_NORMALIZEDSTRING、token、language、Name、NCName、XSD_TYPE_ID、IDREF、IDREFS、
ENTITY、ENTITIES
相关信息
Binary Max Length [第 173 页]
Integer Max Length [第 178 页]
String Max Length [第 183 页]
6.6
Web 服务驱动程序
数据访问层允许通过 HTTP 或 FTP 将 BI 平台连接到互联网上可用的服务。它提供称为 Web 服务驱动程序的数
据访问驱动程序，用于与使用 SOAP 1.1 消息的 Web 服务通信。
Web 服务在以 Web 服务描述语言（WSDL）1.1 描述数据类型、消息和绑定的文档中定义。
Web 服务驱动程序支持 SOAP 1.1 绑定的 Web 服务，以及 style 为 document 或 rpc 且 body 使用 literal
的 Web 服务。例如：
<wsdl:operation ...>
<soap:operation ... style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
100
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
...
</wsdl:operation>
或
<wsdl:operation ...>
<soap:operation ... style="rpc"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
...
</wsdl:operation>
记忆
该驱动程序不支持其他 SOAP 协议版本，也不支持 style 非 document 和 rpc 的其他服务。
连接向导提供一个用来为连接到 Web 服务输入必要信息的工作流。Web 服务显示在 Web Services (WSDL
1.1) DBMS 和 Web Services Connector 网络层下方。
可在<连接服务器安装目录>\connectionServer\xml 目录中找到驱动程序配置文件。xml.prm 文件中列出
了数据访问驱动程序在数据库操作和函数方面的功能。
6.6.1
Web 服务驱动程序功能
XML 驱动程序与 Web 服务驱动程序具有相同的功能。
相关信息
XML 驱动程序功能 [第 88 页]
6.6.2
Web 服务位置
可以使用连接向导中的“Web 服务 URL”参数通过以下信息设置 Web 服务位置：
●
用户名和密码（如果身份验证要求提供）
●
代理服务器地址
●
代理用户名和密码（如果身份验证要求提供）
现有版本还支持基于一个证书的 HTTPS 和 FTPS 加密协议。
记忆
Web 服务驱动程序仅支持 Web 服务定义文档，以及由同一个 HTTP 服务器承载的相关服务。
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
101
示例
http://wsf.cdyne.com/WeatherWS/Weather.asmx?WSDL
6.6.3
Web 服务定义示例
下面的示例阐明了 ClubDemo.wsdl 文档，该文档定义 style 为 document 的 CustomerService Web 服务。
此 Web 服务的示例 URL 为 http://ws.myexample.com/ClubDemo/ClubDemo.wsdl。
示例
WSDL 文档定义以下详细信息：
●
CustomerService service
●
Customer port
●
GetCustomer binding
●
CustomerType portType
●
GetCustomerList operation
●
包含元素 Country 的 GetCustomerListByCountryRequest 输入消息
●
包含 Customer complexType 的元素 GetCustomerListReturn 的
GetCustomerListByCountryResponse 输出消息
<wsdl:definitions targetNamespace="http://ws.myexample.com/ClubDemo/"
xmlns:apachesoap="http://xml.apache.org/xml-soap"
xmlns:impl="http://ws.myexample.com/ClubDemo/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<schema targetNamespace="http://ws.myexample.com/ClubDemo/">
<complexType name="Customer">
<sequence>
<element name="Name" maxOccurs="2">
<complexType>
<simpleContent>
<extension base="xsd:string">
<attribute name="type" type="xsd:string"/>
</extension>
</simpleContent>
</complexType>
</element>
<element name="Age" type="xsd:integer"/>
<element name="Address" type="xsd:string"/>
<element name="ZIP" type="xsd:string"/>
<element name="City" type="xsd:string"/>
<element name="Country">
<complexType>
<attribute name="name" type="xsd:string"/>
</complexType>
</element>
<element name="Invoice" type="xsd:integer"
maxOccurs="unbounded"/>
102
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
</sequence>
<attribute name="ID" type="xsd:integer"/>
</complexType>
<element name="GetCustomerListByCountry">
<element name="Country">
<complexType>
<attribute name="name" type="xsd:string"/>
</complexType>
</element>
</element>
<element name="GetCustomerListResponse">
<complexType>
<sequence>
<element name="GetCustomerListReturn" type="impl:Customer"
maxOccurs="unbounded"/>
</sequence>
</complexType>
<key name="custkey">
<selector xpath="GetCustomerListReturn"/>
<field xpath="@ID"/>
</key>
</element>
</schema>
</wsdl:types>
<wsdl:message name="GetCustomerListByCountryRequest">
<wsdl:part name="request" element="impl:GetCustomerListByCountry"></
wsdl:part>
</wsdl:message>
<wsdl:message name="GetCustomerListByCountryResponse">
<wsdl:part name="response" element="impl:GetCustomerListResponse"></
wsdl:part>
</wsdl:message>
<wsdl:portType name="CustomerType">
<wsdl:operation name="GetCustomerList">
<wsdl:documentation>Gets Information on ClubDemo Customers</
wsdl:documentation>
<wsdl:input message="impl:GetCustomerListByCountryRequest"/>
<wsdl:output message="impl:GetCustomerListByCountryResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="GetCustomer" type="impl:CustomerType">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="GetCustomerList">
<soap:operation soapAction="http://ws.myexample.com/ClubDemo/"
style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CustomerService">
<wsdl:port name="Customer" binding="impl:GetCustomer">
<soap:address location="http://ws.myexample.com/ClubDemo/"/>
</wsdl:port>
</wsdl:service>
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
103
</wsdl:definitions>
6.6.4
Web 服务的映射规则
Web 服务驱动程序与 XML 驱动程序使用相同的表和列映射规则。驱动程序还支持以下特定于 Web 服务的规
则。
限定符
数据访问层一次只能连接到一个 Web 服务。服务映射到数据库限定符。在 ClubDemo 示例中，限定符名称为
CustomerService 服务名称。
所有者
port 属性映射到数据库所有者。在该示例中，所有者为 Customer。
表
在数据访问层中，每个操作表示为根元素。每个输出消息表示操作的子元素。Web 服务驱动程序将输出消息显
示为表。
表名称由操作名称、输出消息以及响应所包含的 XML 元素拼接而成，并以斜杠（/）分隔。
示例
在 ClubDemo 示例中，表为以下内容：
●
GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse
●
GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse/
GetCustomerListReturn
●
GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse/
GetCustomerListReturn/Name
●
GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse/
GetCustomerListReturn/Invoice
104
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
列和输入列
列的 XML 映射规则也适用于 Web 服务。
Web 服务驱动程序仅接受只有一行的表作为输入消息。该表的每个条目映射到结果表的输入列。即使在 WSDL
文档中将输入消息定义为可选，驱动程序也会映射所有输入消息。
限制
驱动程序不支持在输入列中使用 any 和 anyAttribute。
在下面的示例中，列 GetCustomerListByCountryRequest/GetCustomerListByCountry 为输入列。
其他列名称根据 XML 元素的映射规则生成。有关更多信息，请参阅“XML 驱动程序”一节。
示例
表 GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse 的列
为以下内容：
●
-id
●
GetCustomerListByCountryRequest/GetCustomerListByCountry
示例
表 GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse/
GetCustomerListReturn 的列为以下内容：
●
Age
●
Address
●
ZIP
●
City
●
Country/@name
●
@ID
●
-GetCustomerListResponse/-id
●
GetCustomerListByCountryRequest/GetCustomerListByCountry
示例
表 GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse/
GetCustomerListReturn/Name 的列为以下内容：
●
-id
●
Name
●
@type
●
-GetCustomerListReturn/@ID
●
GetCustomerListByCountryRequest/GetCustomerListByCountry
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
105
示例
表 GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse/
GetCustomerListReturn/Invoice 的列为以下内容：
●
-id
●
Invoice
●
-GetCustomerListReturn/@ID
●
GetCustomerListByCountryRequest/GetCustomerListByCountry
主键和外键
主键和外键的 XML 映射规则也适用于 Web 服务。此外，输入列始终是主键定义的一部分。
限制
虽然数据基础提供外键，但 Web 服务驱动程序不支持 JOIN 操作。
示例
主键
将会生成表 GetCustomerList/GetCustomerListByCountryResponse/
GetCustomerListResponse 的列 -id，因为模式未定义任何主键。
模式为表 GetCustomerList/GetCustomerListByCountryResponse/
GetCustomerListResponse/GetCustomerListReturn 的列 @ID 定义了一个显式主键。
输入列 GetCustomerListByCountryRequest/GetCustomerListByCountry 用作主键。
示例
外键
列 -GetCustomerListResponse/@ID 和 -GetCustomerListReturn/@ID 由指向父表的反向路径以及
父表的主键构建而成。
数组数据类型
Web 服务支持由一系列简单或复杂类型构成的数组格式数据类型。此类型的元素映射到只有一行的表，并且以
-arrayElement 映射为列名称或表名称的一部分。数组数据类型未定义元素名称，并且接受任何名称。
有关数组数据类型的更多信息，请访问下面的链接。
106
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
示例
数组数据类型
arrayType="xsd:int[2]" 数据类型由出现两次并且值为整数的元素构成。例如，以下复杂类型适用于元
素 CustomerIDs，并将其定义为接受整数值的元素 CustomerID 的父元素：
<complexType name="ArrayOfIntegers">
<complexContent>
<restriction base="soapenc:Array">
<attribute ref="soapenc:arrayType" wsdl:arrayType="xsd:int[2]"/>
</restriction>
</complexContent>
</complexType>
<element name="CustomerIDs" type="ArrayOfIntegers">
<CustomerID>103</CustomerID>
<CustomerID>204</CustomerID>
</element>
相关信息
Details on arrays in SOAP 1.1 note
XML 驱动程序 － 映射列 [第 93 页]
XML 驱动程序 － 映射主键和外键 [第 94 页]
6.6.5
Web 服务驱动程序 － 配置列最大大小
与 XML 驱动程序一样，Web 服务驱动程序也使用 cs.cfg 文件中的参数 Binary Max Length、Integer
Max Length 和 String Max Length 来处理这些数据类型的大型值。
相关信息
Binary Max Length [第 173 页]
Integer Max Length [第 178 页]
String Max Length [第 183 页]
数据访问指南
数据访问驱动程序参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
107
6.7
本地磁盘用作排序操作的缓存
CSV OpenDriver、OData、SAP ERP、XML 和 Web 服务驱动程序能够将本地磁盘用作已排序的行的缓存。
数据访问驱动程序按照以下方式执行排序操作（ORDER BY、GROUP BY 和 DISTINCT）：
●
在主内存中执行（如果需要排序的数据量较小）
●
通过向本地磁盘上的临时目录写入数据执行
在两种情况下已排序的行会写入磁盘：可用主内存太少，或者已达到通过 Bucket Split Size SBO 参数定
义的行数。
本地磁盘用作缓存，并且数据写到您的计算机的默认临时文件夹。当操作系统未指定临时文件夹时，可以使用
Temp Data Dir 参数在 cs.cfg 文件中配置目录路径。
相关信息
CSV OpenDriver [第 64 页]
OData 驱动程序 [第 69 页]
SAP ERP 驱动程序 [第 82 页]
XML 驱动程序 [第 88 页]
Web 服务驱动程序 [第 100 页]
Bucket Split Size [第 173 页]
Temp Data Dir [第 183 页]
108
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据访问驱动程序参考
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.10、0.12
和 0.13 数据库。
注意
●
HiveServer1 在 Apache Hadoop HIVE 0.7.1、0.8.0、0.9.0、0.10 和 0.12 上均受支持
●
HiveServer2 仅在 Apache Hadoop HIVE 0.13 上受支持
●
Apache Hadoop Hive 驱动程序不支持复杂数据类型
1.
要创建与 Apache Hive Server 的连接，请将下面的一组 JAR 文件放在 <connectionserver-installdir>\connectionServer\jdbc\drivers\<hadoop_version> 目录中，其中 <hadoop_version> 为
hive07、hive08、hive09 或 hive010 以及 hive012。
Apache Hadoop HIVE 数据库版 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
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
109
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
110
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
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.2.14.jar
ql.jar
slf4j-api-1.5.8.jar
slf4j-log4j12-1.5.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.2.14.jar
ql.jar
slf4j-api-1.5.8.jar
slf4j-log4j12-1.5.8.jar
TCLIServiceClient.jar
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
111
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.2.14.jar
ql.jar
slf4j-api-1.5.8.jar
slf4j-log4j12-1.5.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 文件夹。
●
您无需执行任何其他配置来创建到 Apache Hadoop Hive 0.12 Simba JDBC4 的连接，因为该驱动程
序已作为 BI 平台的一部分安装在<连接服务器安装目录>\connectionServer\jdbc\drivers
\hive012simba4server1 目录中。
相关信息
JAR 文件位置参考 [第 52 页]
7.1.2
创建与 Apache Hadoop HIVE 的 ODBC 连接
数据访问层允许 BI 平台通过 ODBC 连接到 Apache Hadoop HIVE 0.12 和 0.13 数据库，方法是使用所有支持平台
上的 SAP Hive ODBC 驱动程序。 安装 BOE 客户端或服务器后，用户需要更新主机和端口号详细信息。 有关更多
信息，请参考 Simba 指南。
112
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
注意
●
HiveServer2 仅在 Apache Hadoop HIVE 0.13 上受支持。 在 ODBC 数据源管理器中必须将“Hive Server
Type”（Hive Server 类型）选为“Hive Server2”
●
请参考 Simba 指南以查看身份认证模式获取更多详细信息
Windows 系统
注意
●
SAP Hive ODBC 驱动程序是创建 DSN 所必须使用的驱动程序
●
Sample SAP Hive DSN 是“ODBC 数据源管理器”中的示例 DSN，请参考以获取更多配置帮助
●
如果选择 Sample SAP Hive DSN 用于 ODBC 连接，则 <平台> 可能的值为 win32_x86（BOE 客户
端）或 win64_x64（BOE 服务器）
●
驱动程序特定库存在于以下路径： <BIP 安装目录>\<平台>\odbc\simbahive\1.0\lib
●
Hive Install Guide.pdf 中的 Simba ODBC 驱动程序位于以下路径： <BIP 安装目录>\<平台>
\odbc\simbahive\1.0\help，提供了更多配置步骤
UNIX 系统
安装完成后，用户会在以下路径找到 SAP Hive ODBC 驱动程序特定库： <安装目录>/sap_bobj/
enterprise_xi40/<平台>/odbc/simbahive/1.0/lib
UNIX 系统上的 Hive ODBC 配置
安装完成后，simba.hiveodbc.ini 中会出现 DSN 条目。 以下信息有助于用户在 UNIX 系统上进行配置：
●
要更改“主机”和“端口”号、ODBCInstLib 信息，用户需要配置 simba.hiveodbc.ini。 有关如何修改
simba.hiveodbc.ini 的更多信息，请参考 Simba ODBC Driver for Hive Install Guide.pdf
●
可在以下路径找到 simba.hiveodbc.ini： <安装目录>/sap_bobj/enterprise_xi40
●
可将环境变量 SIMBAINI、ODBCINI 设置为 simba.hiveodbc.ini 文件所在的路径（包括文件名）。
例如： 导出 SIMBAINI=<安装目录>/sap_bobj/enterprise_xi40/simba.hiveodbc.ini
●
驱动程序库路径： 必须将 <安装目录>/sap_bobj/enterprise_xi40/linux_x64/odbc/
simbahive/1.0/lib 设置为环境变量 LD_LIBRARY_PATH (LINUX)、LIBPATH (AIX)。
●
Hive Install Guide.pdf 中的 Simba ODBC 驱动程序可在以下位置找到： <安装目录>/sap_bobj/
enterprise_xi40/<平台>/odbc/simbahive/1.0/help
7.1.3
执行平台更新后使 HIVE 连接可用
作为一个先决条件，生产环境中运行的是 Microsoft Windows 或 UNIX 操作系统上的 SAP BusinessObjects BI
平台 4.0 版，并且版本不高于支持包 8。
将平台服务器或客户端工具更新到 4.1 版本后，Apache Hadoop HIVE 驱动程序被卸载。 必须修改平台的安
装，以使 Apache Hadoop HIVE 连接可用。
以下过程介绍在 Microsoft Windows 上执行的步骤。
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
113
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.
建立指向 Amazon 主节点的 SSH 隧道。
有关更多信息，请参阅 Amazon 文档。
2.
从 Amazon 网站下载所需的 JAR 文件并将它们放入<连接服务器安装目录>\connectionServer\jdbc
\drivers\<emrhive_version> 目录中，其中 <emrhive_version> 为 emrhive07 或 emrhive08。
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 页]
114
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
7.1.5
创建与 Amazon EMR HIVE 的 ODBC 连接
数据访问层允许 BI 平台通过 ODBC 连接到 Amazon EMR Hive 0.11 数据库，方法是使用所有支持平台上的 SAP
Hive ODBC 驱动程序。 安装 BOE 客户端或服务器后，用户需要更新主机和端口号详细信息。 有关更多信息，请参
考 Simba 指南。
注意
HiveServer1 是 Amazon EMR Hive 0.11 唯一支持的服务器。 在 ODBC 数据源管理器中必须将“Hive Server
Type”（Hive Server 类型）选为“Hive Server1”。
Windows 系统
Sample Amazon EMR Hive DSN 是“ODBC 数据源管理器”中的示例 DSN，请参考以获取更多配置帮助
UNIX 系统
有关 UNIX 系统上的 Hive ODBC 配置，请参考创建与 Apache Hadoop HIVE 的 ODBC 连接 [第 112 页]一节。
7.1.6
创建到 Cloudera Impala 的 JDBC 连接
Cloudera Impala 1.0 Simba JDBC4 驱动程序作为 BI 平台的一部分，安装在 <ConnectionServer 安装目录>
\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.2.14.jar
ql.jar
slf4j-api-1.5.8.jar
slf4j-log4j12-1.5.8.jar
TCLIServiceClient.jar
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
115
7.1.7
创建到 Cloudera Impala 的 ODBC 连接
在此版本中，我们支持 SAP Impala ODBC 驱动程序。 安装 BOE 客户端或服务器后，用户需要更改主机和端口号
详细信息，才能连接到相应的 Impala 服务器。 有关更多信息，请参考 Simba 指南。
注意
●
请参考 Simba 指南以查看身份认证模式并执行所需更改
●
The 在“ODBC 数据源管理器”中可找到 Sample SAP Impala DSN
●
用户可在以下路径中找到 ODBC 驱动程序库： <BIP 安装目录>\<平台>\odbc\simbaimpala\1.0，
<平台> 可能的值为 win32_x86（BOE 客户端）或 win64_x64（BOE 服务器）。
●
驱动程序特定库存在于以下路径： <BIP 安装目录>\<平台>\odbc\simbaimpala\1.0\lib
●
Simba ODBC Driver for Impala Install Guide.pdf 位于以下位置： <BIP 安装目录>\<平
台>\odbc\simbaimpala\1.0\help
UNIX 系统上的 ODBC 配置
●
要更改“主机”和“端口”号、ODBCInstLib 信息，用户需要配置 simba.impalaodbc.ini。 有关如何修改
simba.impalaodbc.ini 的更多信息，请参考 Simba ODBC Driver for Impala Install
Guide.pdf
●
用户可在以下路径中找到 ODBC 驱动程序的驱动程序特定库： <安装目录>/sap_bobj/
enterprise_xi40/<平台>/odbc/simbaimpala/1.0/lib
●
必须将驱动程序库设置为环境变量 LD_LIBRARY_PATH (LINUX) 或 LIBPATH(AIX)
● 可在以下路径找到 simba.impalaodbc.ini： <安装目录>/sap_bobj/enterprise_xi40/
simbaimpala/conf
●
将环境变量 SIMBAINI、ODBCINI 设置为 simba.impalaodbc.ini 文件所在的路径（包括文件名）。
例如： 导出 SIMBAINI= <安装目录>/sap_bobj/enterprise_xi40/simbaimpala/conf/simba.impalaodbc.ini
● Simba ODBC Driver for Impala Install Guide.pdf 位于以下路径： <安装目录>/sap_bobj/
enterprise_xi40/<Platform>/odbc/simbaimpala/1.0/help
7.2
IBM DB2 连接 － 引用键映射到 NULL
限制
由于数据库驱动程序限制，IBM DB2 10 for z/OS 数据库表的引用键名称将映射到 NULL。
116
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
7.3
IBM Informix 连接
以下各节描述发生 IBM Informix 连接问题时可执行的操作。
相关信息
为 IBM Informix 连接设置 JVM 时区 [第 117 页]
为 IBM Informix 连接设置事务模式 [第 117 页]
7.3.1
为 IBM Informix 连接设置 JVM 时区
在信息设计工具中，如果客户端工具与服务器位于不同的时区，使用 JDBC 提交到 IBM Informix Dynamic
Server 11 的查询可能会返回错误的数据类型值。 要避免此问题，必须将 JVM 的时区值设置为与数据库服务器级别
所设置的时区相同。
1.
退出信息设计工具。
2.
转到 <bip-install-dir>\win32_x86 目录。
3.
打开 InformationDesignTool.ini 文件进行编辑。
4.
将以下行添加到文件的结尾：
-Duser.timezone=<server_timezone_value>
其中 <server_timezone_value> 是在数据库服务器上设置的时区值。 例如： GMT。
5.
保存文件。
6.
重新启动此应用程序。
完成此任务后，即正确配置了使用 JDBC 与 IBM Informix 数据库的连接。
7.3.2
为 IBM Informix 连接设置事务模式
数据访问层默认允许 SQL 操作作为事务块运行。 如果 Informix Dynamic Server 不支持事务，可能会发生连接故
障。 要避免此问题，请在驱动程序配置文件中指定事务模式不可用。
1.
退出客户端工具。
2.
打开 informix.sbo 文件进行编辑。
该文件位于<连接服务器安装目录>\connectionServer\jdbc 目录中。
3.
在适当的 Database 部分的下方添加以下行：
<Parameter Name="Transactional Available">No</Parameter>
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
117
4.
保存文件。
5.
重新启动服务和应用程序。
完成此任务后，即正确配置了与 IBM Informix 的连接。
相关信息
Transactional Available [第 184 页]
7.4
MS Analysis Services 连接
警告
通过 XMLA 的 MS Analysis Services 连接不使用连接服务器。
本节只涉及与要在信息设计工具中创建的连接相关的内容。
在信息设计工具中，用户可以创建通过 XMLA 驱动程序经 HTTP 到 MS Analysis Services 的连接。
要配置这些连接，首先需要启用 HTTP 访问。有关更多信息，请参见 Microsoft TechNet 网站。
相关信息
http://technet.microsoft.com/en-us/library/cc917711.aspx
http://technet.microsoft.com/en-us/library/cc917712.aspx
7.5
MS SQL Server 连接
以下各节提供有关 MS SQL Server 连接的信息。
相关信息
到 MS SQL Server 的 OLE DB 连接的同义词支持 [第 119 页]
同义词列不会显示在报表工具中。
在 UNIX 上设置到 MS SQL Server 的连接的 JVM 选项 [第 119 页]
118
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
为 UNIX 上的 MS SQL Server 安装 JDBC 驱动程序并配置 jdbc.sbo 文件后，可以在 cs.cfg 文件中设置
JVM 信息。
7.5.1
到 MS SQL Server 的 OLE DB 连接的同义词支持
同义词列不会显示在报表工具中。
MS SQL Server 本地客户端中间件不支持同义词列的元数据。因此，如果 Universe 设计工具或信息设计工具使
用 OLE DB 连接 MS SQL Server 数据库，则不会显示数据库中的同义词列。
相关信息
SQL Server Native Client (OLE DB)
7.5.2
在 UNIX 上设置到 MS SQL Server 的连接的 JVM 选项
为 UNIX 上的 MS SQL Server 安装 JDBC 驱动程序并配置 jdbc.sbo 文件后，可以在 cs.cfg 文件中设置 JVM 信
息。
1.
打开 cs.cfg 文件进行编辑。
2.
将以下文件路径添加到 JavaVM 节，以便覆盖默认的 JVM 配置：
<LibraryName JNIVersion="JNI_VERSION_1_4">$BOBJEDIR/jdk/jre/lib/i386/server/
libjvm.so</LibraryName>
3.
将以下选项之一添加到 JavaVM 节：
选项
说明
Solaris 或 Linux
<Options>
<Option>-Xmx512m</Option>
</Options>
AIX
<Options>
<Option>-Xmx511m</Option>
</Options>
注意
在 Solaris 或 Linux 上，可以为 Java 虚拟机分配 512 MB 或更多的内存，但在 AIX 上不能分配超过 511 MB
的内存。
4.
保存文件。
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
119
相关信息
JVM 设置 [第 148 页]
7.6
Oracle 连接
以下各节提供 Oracle 连接的配置信息。
相关信息
到 Oracle 服务器群集的连接 [第 120 页]
设置 Oracle CURSOR_SHARING 参数值 [第 120 页]
7.6.1
到 Oracle 服务器群集的连接
支持通过 JDBC 连接到以故障转移模式工作的 Oracle 服务器群集。驱动程序选择其中一个服务器，如果所选服
务器不可用，则使用下一个服务器。如果所有服务器均不可用，将出现连接错误。
在连接向导的“服务器（主机:端口{,主机:端口}）”中输入服务器主机和端口并以分号隔开，以创建 JDBC 连接。
输入一个服务器的信息，或者如果要利用故障转移机制，则输入多个服务器的信息。
7.6.2
设置 Oracle CURSOR_SHARING 参数值
Oracle 10 及更高版本的数据库使用 CURSOR_SHARING 参数。 BI 平台和 SAP BusinessObjects 报表工具对
CURSOR_SHARING 仅支持 EXACT 值。
如果使用 FORCE 值，可能会对报表工具造成某些性能问题。
1.
执行以下操作之一：
选项
为 Universe 连接设置
CURSOR_SHARING 值
120
说明
1.
打开 Universe 连接进行编辑。
2.
单击“下一步”转到“自定义参数”屏幕。
3.
单击“添加参数”。
4.
输入 ConnectInit，然后单击“确定”。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
选项
说明
5.
输入“alter session set CURSOR_SHARING=EXACT”作为
ConnectInit 值。
为所有 Oracle 连接设置
CURSOR_SHARING 值
6.
单击“完成”。
1.
浏览到存储 oracle.prm 文件的目录： <连接服务器安装目录>
\connectionServer\Oracle。
2.
在 XML 编辑器中打开该文件。
3.
在 Configuration 部分下面，添加以下参数：
<Parameter Name="CURSOR_SHARING">EXACT</Parameter>
4.
保存文件。
5.
从 CMC 重新启动连接和报表服务。
注意
有关 CURSOR_SHARING 的定义，请参阅 Oracle 文档。
7.6.3
限
MySQL 连接 － 信息设计工具中某些工作流所需的数据库权
在信息设计工具中基于 MySQL JDBC 连接使用 Universe 时，如果数据基础包括基于 MySQL 数据库中视图的
表，则用户需要 SHOW VIEW 或数据库中对此视图所授予的同等权限。
如果未授予该权限，则在执行特定工作流（例如显示值或检测）时信息设计工具用户可能收到一个数据库异常
（SHOW VIEW 命令被拒绝）。
7.6.4 在挪威语（伯克梅尔）界面语言下在信息设计工具中使用
Oracle JDBC 连接
在使用挪威语（伯克梅尔）界面语言的情况下，如果要在信息设计工具中使用 Oracle JDBC 连接，则需要通过
在 InformationDesignTool.ini 文件中进行以下修改的方式来设置默认区域设置。
1.
退出信息设计工具。
2.
在 <BIP_INSTALL_DIR>\SAP BusinessObjects Enterprise XI 4.0\win32_x86\ 目录中，找到
InformationDesignTool.ini 文件并在编辑器中打开。
注意
请将 <BIP_INSTALL_DIR> 替换为 BI 平台安装位置的目录路径。
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
121
3.
向 InformationDesignTool.ini 文件中添加以下行，然后保存该文件。
-Duser.language=nb
-Duser.country=NO
4.
重新启动信息设计工具。
5.
在信息设计工具中执行以下步骤，将产品语言设置为“默认区域设置”：
a) 从信息设计工具主菜单选择
“窗口”
“首选项” 。
b) 在“首选项”对话框中，展开“信息设计工具”节点，然后选择“语言”。
c) 从“产品语言”列表中选择“默认区域设置”。
“默认区域设置”应为“（书面挪威语（挪威））”。 请确保不要选择“挪威语”产品语言。
d) 单击“确定”。
6.
退出并重新启动信息设计工具，让语言更改生效。
7.7
Oracle EBS 连接
数据访问层提供了一个新的驱动程序，用于通过 Oracle 调用接口（OCI）将 SAP BusinessObjects 应用程序连
接到 Oracle E-Business Suite (EBS)。这样应用程序就可以通过 EBS 视图和存储过程访问数据。只能使用 OCI 将
该驱动程序连接到 Oracle EBS。
在 Universe 设计工具或信息设计工具中创建连接时，首先应选择身份验证模式：如果应用程序用户在登录到 BI
平台时提供用户名和密码，则由用户提供身份验证模式；如果用户使用 Oracle EBS 凭据登录，则身份验证模式为
单一登录。然后选择 Oracle EBS 应用程序、职责和安全性组，这些内容定义 Universe 的数据源。
BI 平台借助身份验证插件为 Oracle EBS 提供 SSO。正确安装并配置此插件后，将启用 SSO。SSO 允许应用程
序用户使用 Oracle EBS 凭据登录到 BI 启动板。连接服务器使用相同凭据访问 Oracle EBS 数据源。有关身份验证
插件的更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理员指南》。
7.8
Oracle Essbase 连接
数据访问层允许 BI 平台访问 Oracle Essbase 数据源。
到 Oracle Essbase 的连接是 OLAP 连接。
可以在 32 位 MS Windows 或 64 位 UNIX 操作系统上通过 Essbase 客户端中间件基于 Oracle Essbase 9 或 11
创建 .unv Universe。这些连接可用于 32 位或 64 位连接服务器。在 64 位 MS Windows 上，可通过数据访问层
使用 32 位连接服务器。请参阅“64 位 Microsoft Windows 支持”节。
可在 32 位或 64 位环境中通过 ESSJAPI 或本机 API 创建基于 Oracle Essbase 11 的 .unx Universe。这些连接
可用于 OLAP 客户端。
122
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
警告
由于 ESSJAPI 中间件中存在 .unv Universe 限制，因此要部署特定的 BI 平台服务器才能支持基于 Oracle
Essbase 11 的 .unv 和 .unx Universe。要部署支持 .unv 和 .unx Essbase Universe 的服务器，需要在两台独
立的计算机上配置具有两个如下群集的系统：
●
在 64 位环境中，将以下软件安装在第一个群集（Cluster1）上：64 位 BI 平台、中央管理服务器、Web
Intelligence 服务器、64 位连接服务器和所有 64 位中间件驱动程序。
●
在 32 位环境中，将以下软件安装在第二个群集（Cluster2）上：32 位连接服务器和 32 位中间件驱动程序
（包括用于 .unv Universe 的 32 位 Essbase 驱动程序）。
在运行时，连接服务器对 .unv Universe 使用 Cluster2。为 .unx Universe 提供服务的 OLAP 客户端使用
Cluster1 中提供的 64 位中间件。
相关信息
64 位 Microsoft Windows 支持 [第 26 页]
7.9
Oracle RAC 连接
数据访问层允许通过 JDBC 将 BI 平台连接到 Oracle 真正应用群集（RAC）。
要使用连接向导从应用程序创建连接，用户需要提供具有以下格式的 Oracle RAC 数据源条目：
<host>:<port>,<host>:<port>,...,<host>:<port>
主机和端口对的数量取决于群集中所包含的计算机数量。
示例
pmrac1.us.oracle.com:1521,pmrac2.us.oracle.com:1521
7.10 salesforce.com 连接 － 配置环境
必须首先对环境进行设置，以使 salesforce.com 连接可在 Universe 设计工具或信息设计工具中工作。
1.
通过 CMC 和客户端应用程序停止连接服务。
2.
在 MS Windows 命令行中运行 regedit.exe 以打开注册表编辑器。
3.
通过
HKEY_LOCAL_MACHINE
SOFTWARE
ODBC
ODBC.INI
<SALESFORCE_DSN_NAME>
转
到 Salesforce ODBC 数据源，其中 <SALESFORCE_DSN_NAME> 是 salesforce.com 数据源名称。
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
123
4.
右键单击数据源名称并选择
5.
输入 CheckJVMChanged。
6.
双击属性并输入 0。
7.
关闭注册表编辑器
新建
字符串值 。
然后，必须按照以下步骤完成配置。
相关信息
使 salesforce.com 连接在信息设计工具中工作 [第 124 页]
使 salesforce.com 连接在 Universe 设计工具中工作 [第 124 页]
7.10.1
使 salesforce.com 连接在信息设计工具中工作
1.
退出信息设计工具。
2.
将 sforce.jar 驱动程序文件复制到 <bip-install-dir>\win32_x86\jdk\jre6\lib\ext 目录中。
3.
转到 <bip-install-dir>\win32_x86 目录。
4.
打开 InformationDesignTool.ini 文件进行编辑。
5.
将以下行添加到文件的结尾：
-Dosgi.parentClassloader=ext
6.
保存文件。
7.
重新启动此应用程序。
完成此任务后，即正确配置了 salesforce.com 连接。
7.10.2 使 salesforce.com 连接在 Universe 设计工具中工作
1.
退出 Universe 设计工具。
2.
打开 cs.cfg 文件进行编辑。
3.
在 JavaVM 部分，添加以下路径：
<ClassPath>
<Path>C:\Program Files (x86)\Progress\DataDirect\Connect_for_ODBC_61\java
\lib\sforce.jar</Path>
</ClassPath>
4.
保存文件。
5.
打开 openaccess.sbo 文件进行编辑。
它位于 <connectionserver-install-dir>\connectionServer\odbc 目录中。
124
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
6.
在 Database 部分的下方添加以下行：
<Parameter Name="Transactional Available">No</Parameter>
7.
保存文件。
8.
重新启动服务和应用程序。
完成此任务后，即正确配置了 salesforce.com 连接。
相关信息
Transactional Available [第 184 页]
7.11
SAP Business Warehouse 连接
数据访问层允许 BI 平台访问 SAP BW 数据源。
通过 BAPI 到 SAP BW 的连接是 OLAP 连接。
此现有版本允许用户在 32 位或 64 位 MS Windows 和 64 位 UNIX 系统上基于 SAP BW 创建 .unv Universe。
SAP BW 连接可在 32 位操作系统上与 32 位连接服务器或在 64 位操作系统上与 64 位连接服务器配合使用。
7.11.1
启用 SAP BW 64 位连接
可以配合 64 位连接服务器使用 SAP BW 连接来构建 .unv Universe。
可以在 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) 单击“下一步”并完成安装。
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
125
SAP BW 64 位驱动程序现已安装在平台上， 现在可以创建在 64 位 Microsoft Windows 上使用 64 位连接服务
器的 SAP BW 连接了。
7.12 SAP ERP 连接 － 驱动程序加载失败
以下错误消息可能会在 SAP BusinessObjects Web Intelligence 中出现：
Database error: (CS) "Java Exception : java.lang.NoClassDefFoundError:
com/sap/bip/jco/JCoManager : cannot initialize class because prior
initialization attempt failed"
此错误消息表明 SAP ERP 驱动程序加载失败，因为 Web Intelligence 处理服务器无法找到 sapjco3.dll 文
件。
要使 SAP ERP 连接能够工作，必须从 BI 平台服务器目录（<BIP 安装目录>\win64_x64）将该文件复制到
MS Windows 目录（C:\WINDOWS\system32）。 然后重新启动 Web Intelligence 处理服务器。
7.13 SAP HANA 连接
数据访问层允许在所有平台上通过 ODBC 和 JDBC 将 BI 平台连接到 SAP HANA 数据库 1.0 SPS 08。 现有版
本还支持在 MS Windows、Linux 和 AIX 上通过 OLAP 连接到 SAP HANA 数据库。
Array Fetch Size
SAP HANA 连接的“数组提取大小”默认值是 1000。
警告
由于在“数组提取大小”的值偏高时需要较多的内存，此配置可能会影响系统性能。
故障转移
支持通过 ODBC 和 JDBC 连接到以故障转移模式工作的 SAP HANA 服务器群集。 驱动程序选择其中一个服务
器，如果所选服务器不可用，则使用下一个服务器。 所有服务器均不可用时将发生连接错误。
126
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
首选查看区域设置
SAP HANA 连接支持通过 JDBC 和 ODBC 为所有身份验证模式使用首选查看区域设置（PVL）。 如果数据库以
其他语言存储数据，PVL 允许用户获取已本地化的数据。
到数据库的单一登录
在 MS Windows 和 Linux 平台上，BI 平台使用具有 Kerberos 的 Windows AD 或 SAML 协议提供到数据库的单
一登录（SSO）。 使用 Kerberos 的 SSO 可用于 JDBC 和 ODBC 连接。 使用 SAML 的 SSO 可用于 JDBC 连接，
但不可用于 ODBC 连接。
如果 Kerberos 和 SAML 实施在用户的环境中均可用，则平台会优先使用 SAML。 如果使用 SAML 时发生任何问
题，则平台会改为使用 Kerberos。 此逻辑对应用程序用户来说是显而易见的。 要停用 SAML，请将相应的
newdb.sbo 配置文件中的 Skip SAML SSO 参数设置为 True。
在 OLAP 连接中，BI 平台还使用具有 Kerberos 的 Windows AD 或 SAML 协议提供到数据库的 SSO。
用户从 SAP BusinessObjects 应用程序登录到 BI 平台后，不必提供数据库凭据即可执行需要数据库访问的操
作，如刷新 Web Intelligence 文档。
UNIX 支持
从 4.1 版本起，数据访问层允许在 64 位 UNIX 平台上通过 ODBC 将 BI 平台连接到 SAP HANA 数据库。
使用 SSL
到 SAP HANA 的关系连接和 OLAP 连接可以使用 SSL 协议。
相关信息
Skip SAML SSO [第 181 页]
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
127
7.13.1
创建 SAP HANA 连接
创建 JDBC 连接
SAP HANA 1.0 SPS 08 JDBC 驱动程序随 BI 平台一起安装在 <connectionserver-install-dir>
\connectionServer\jdbc\drivers\newdb 目录中。 因此，用户不必执行其他任何配置即可创建与 SAP
HANA 数据库的连接。
在连接向导中选择以下选项之一以创建 JDBC 连接：
●
单个服务器
在“主机名”字段和“实例号”字段中分别输入 HANA 主机名和实例号。
●
多个服务器（故障转移）
在“服务器（主机:端口{;主机:端口}）”中输入服务器主机和端口，以分号隔开。 输入一个服务器的信息，或者如
果要利用故障转移机制，则输入多个服务器的信息。
下面是端口号的约定：
3##15
其中，## 是 HANA 实例号。
示例
如果要连接到实例 0，则在向导中输入实例号 00 或端口号 30015。 如果要连接到实例 1，则输入实例号 01
或端口号 30115。
使用 SSL
在连接向导中选择“使用 SSL”以创建使用 SSL 协议连接到 SAP HANA 服务器的 OLAP 或 JDBC 连接。
注意
要在 MS Windows 上使用 ODBC 中的 SSL，请打开 ODBC 数据源管理器，然后在配置 DSN 时选择“SSL”。
相关信息
创建 JDBC 连接 [第 49 页]
128
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
7.13.2 编辑 SAP HANA 连接
打开用于编辑的 SAP HANA 连接会在连接向导中显示于“单个服务器”或“多个服务器（故障转移）”下方。要编辑
该连接，请执行以下操作之一：
●
如果该连接显示于“单个服务器”中，则修改数据源的主机名和实例号。
●
如果该连接显示于“多个服务器（故障转移）”中，则修改服务器主机和端口。
7.13.3 为 SAP HANA 连接配置单一登录之前
记忆
本节关于为 SAP HANA 连接配置通过具有 Kerberos 的 Windows AD 的单一登录。
设置必要的 Java VM 选项之前，用户必须创建 JAAS bscLogin.conf 和 Kerberos krb5.ini 配置文件来为
Windows AD 身份验证准备好应用程序。 有关更多信息，请参阅《SAP BusinessObjects Business Intelligence 平
台管理员指南》。
相关信息
为信息设计工具配置到 SAP HANA 的单一登录 [第 129 页]
为 Web Intelligence 配置到 SAP HANA 的单一登录 [第 130 页]
为 Web Intelligence 胖客户端配置到 SAP HANA 的单一登录 [第 131 页]
为 SAP HANA 连接配置单一登录之前 [第 129 页]
7.13.4 为信息设计工具配置到 SAP HANA 的单一登录
通过以下步骤，可从信息设计工具中启用通过 JDBC 访问的 SAP HANA 数据库的单一登录。
1.
执行以下操作之一：
选项
说明
通过 JDBC
1.
为本地连接
配置 SSO
2.
退出信息设计工具。
打开 InformationDesignTool.ini 文件进行编辑。
它位于 <BIP 安装目录>\win32_x86 目录。
3.
添加以下行：
-Djava.security.auth.login.config=C:\<location>\bscLogin.conf
-Djava.security.krb5.conf=C:\<location>\Krb5.ini
其中 <location> 是指运行连接服务器的计算机上的配置文件目录。
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
129
选项
说明
4.
保存文件。
5.
重新启动信息设计工具。
通过 JDBC
为 CMS 上
的连接配置
SSO
目的是配置自适应连接服务。
1.
打开 CMC。
2.
在“连接服务”下，停止由自适应处理服务器承载的自适应连接服务。
3.
转到“属性”页面。
4.
将以下选项添加到“命令行参数”属性：
-Djava.security.auth.login.config=C:\<location>\bscLogin.conf
-Djava.security.krb5.conf=C:\<location>\Krb5.ini
其中 <location> 是指运行连接服务器的计算机上的配置文件目录。
5.
单击“保存”。
6.
从 CMC 重新启动服务。
记忆
此外，还需要配置自适应连接服务以通过处于连接模式的 Web Intelligence 胖客户端启用 SSO。 这些步
骤也允许用户配置其他所有 Java 服务（例如 Data Federation 服务）的 SSO。 针对基于 SAP HANA 连
接构建的启用多源的 Universe 执行查询时，将使用 Data Federation 服务。
7.13.5 为 Web Intelligence 配置到 SAP HANA 的单一登录
通过以下步骤，可通过 JDBC 为 SAP BusinessObjects Web Intelligence 启用 SAP HANA 数据库的单一登录。
注意
此过程适用于应用程序用户从 BI 启动板启动的 SAP BusinessObjects Web Intelligence 的 Java 或 HTML 界
面。
记忆
此配置仅处理由 Web Intelligence 处理服务器承载的 Web Intelligence 报告服务。
1.
打开 CMC。
2.
在“Web Intelligence 服务”下，停止由 Web Intelligence 处理服务器承载的报告服务。
3.
打开 cs.cfg 文件进行编辑。
4.
在 JavaVM 部分，添加以下 Java VM 选项：
<Options>
<Option>-Djava.security.auth.login.config=C:\<location>\bscLogin.conf</
Option>
<Option>-Djava.security.krb5.conf=C:\<location>\Krb5.ini</Option>
</Options>
其中 <location> 是指运行连接服务器的计算机上的配置文件目录。
130
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
5.
保存文件。
6.
从 CMC 重新启动服务。
相关信息
JVM 设置 [第 148 页]
7.13.6 为 Web Intelligence 胖客户端配置到 SAP HANA 的单一
登录
通过以下步骤，可从 Web Intelligence 胖客户端应用程序中启用通过 JDBC 访问的 SAP HANA 数据库的单一登
录。
请执行以下任一过程：
○
如果从 WID 文档或 Windows“开始”菜单连接到 Web Intelligence 胖客户端：
1.
关闭文档并退出 Web Intelligence 胖客户端。
2.
创建以下环境变量：
○
java.security.auth.login.config=C:\<location>\bscLogin.conf
○
java.security.krb5.conf=C:\<location>\Krb5.ini
其中 <location> 是指运行连接服务器的计算机上的配置文件目录。
3.
○
重新启动 Web Intelligence 胖客户端。
如果从 BI 启动板以“已连接”模式（也称 HTTP 模式）使用 Web Intelligence 胖客户端，就必须配置自适应
连接服务。 按照所述步骤配置信息设计工具的单一登录。
相关信息
为信息设计工具配置到 SAP HANA 的单一登录 [第 129 页]
7.13.7
配置 Java 虚拟机使用 SAP HANA 连接进行检测
如果随 BI 平台一起安装了 CA Wily Introscope，则可监控 SAP HANA 驱动程序的活动。 此检测提供通过
ODBC 和 JDBCD 访问的 SAP HANA 连接的端到端跟踪支持。
在该平台中默认启用 SAP HANA 跟踪。 但是，用户也必须配置 Java 虚拟机来使用 JNI 桥。
1.
打开 cs.cfg 文件进行编辑。
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
131
2.
将以下 JAR 文件路径添加到 JavaVM 部分，以加载必需的类：
<ClassPath>
<Path>"<BIP 安装目录>\java\lib\TraceLog.jar;<BIP 安装目录>\java\lib\external
\com.sap.js.passport.api.jar"
</Path>
</ClassPath>
3.
将以下选项添加到 JavaVM 部分：
<Options>
<Option>-javaagent:<BIP 安装目录>\java\wily\Agent.jar</Option>
<Option>-Dcom.wily.introscope.agentProfile=<BIP 安装目录>\java\wily
\IntroscopeAgent_CSJNI.profile</Option>
<Option>-Dcom.wily.introscope.agent.agentName=CSJNIEngine</Option>
</Options>
4.
保存文件。
5.
打开 IntroscopeAgent_CSJNI.profile 进行编辑。
该文件位于 <BIP 安装目录>\java\wily 目录中。
6.
在以下行中，将 localhost 替换为 Introscope Agent 的主机名：
introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=localhost
7.
保存文件。
相关信息
JVM 设置 [第 148 页]
7.14 SAP MaxDB 连接
在 ODBC 上，务必使用 SAP MaxDB ODBC 驱动程序 V7.7.07（内部版本号为 07 或更高）。SAP MaxDB 同时
提供了适用于 MS Windows 和 UNIX 的 ASCII 和 Unicode 驱动程序。ODBC 驱动程序的 ASCII 版本始终使用
ASCII 连接到数据库内核。ODBC 驱动程序的 Unicode 版本使用 ASCII 连接到 ASCII 数据库内核，使用 UCS2 连
接到 Unicode 数据库内核。
SAP MaxDB 在 UNIX 上无需特定驱动程序管理器。但是，如果需要，可将其配置为使用以下驱动程序管理器：
●
unixODBC 2.0.9 或更高版本
●
iODBC 3.0.5 或更高版本
在 JDBC 上，务必使用最新版本的 sapdbc.jar 驱动程序。有关 SAP MaxDB JDBC 驱动程序的更多信息，请
参阅 maxdb.sbo 配置文件。
132
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
7.15 SAP BW 连接
与 SAP BW 的关系连接不使用连接服务器。 这些连接在 SAP BW 中经过专用连接器并使用特定外观（facade）。
有关如何配置和调整与 SAP BW 的连接的详细信息，请参考《Data Federator Administration Tool Guide》
（Data Federator 管理工具指南）。
7.15.1
将 Data Federator 连接到 SAP BW 的要求
要连接到 SAP BW，必须具有兼容版本的 SAP BW，以及相应的 SAP 说明：
●所需最低版本为 SAP BI 7.01 SP06。
注意
正式名称 SAP BW 因版本不同而有所变化。 在 7.3 版本之前，称为 SAP BI。
●所需 SAP 备注（SAP note）为： https://service.sap.com/sap/support/notes/1460273
。
有关受支持的 SAP BW 版本的详细信息，请参阅《Product Availability Matrix》（产品可用性矩阵）。
7.15.2 使 SAP BW 连接在信息设计工具中工作的要求
如果 SAP Gateway 允许，外部应用程序（例如信息设计工具）可以连接到 SAP BW。
要使连接在信息设计工具中工作，必须确保正确配置外部程序的 SAP Gateway 安全性设置。 有关更多信息，
请参阅 SAP Gateway 联机文档。
相关信息
安全参数 - 连接 - SAP 库
7.15.3 访问基于 SAP BW 的启用多源的 Universe 的要求
应用程序用户需要获得授权才能访问基于 SAP BW 数据库的多源 Universe。
有关查询和报表应用程序用户访问 SAP BW 中的多源 Universe 所需授权的信息，请参阅 SAP 说明
#1465871。
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
133
相关信息
SAP Note #1465871
7.16 SAS 连接
与 SAS 的连接不使用连接服务器。这些连接将使用适合 SAS/SHARE 数据集的 JDBC 连接器。
要配置这些连接，需要安装可兼容的 JDBC 驱动程序。
有关配置 SAS 连接器的更多信息，请参阅《数据联合管理工具指南》。
7.16.1
安装用于 SAS 连接的驱动程序
必须安装用于供数据联合查询引擎连接到 SAS/SHARE 服务器的驱动程序，才能使用 SAS 连接器。
SAS/SHARE 服务器可用于连接到 SAS 数据集。有关 SAS/SHARE 的更多信息，请参见 SAS 网站。
在安装 BI 平台的计算机上，应将 SAS JDBC 驱动程序 jar 文件复制到如下目录：<BOE 安装目录>/
java/pjs/services/DataFederatorService/resources/drivers/sas。
必须在 resources 目录下创建 drivers/sas 目录。
有关受支持的 SAS 版本的详细信息，请参阅《Product Availability Matrix》（产品可用性矩阵）。
相关信息
http://www.sas.com/products/share/index.html
7.17
Teradata 连接 － 将 Teradata 数据库映射到当前所有者
下节提供 Teradata 连接的配置信息。
Teradata 数据库支持表所有者，但不支持限定符。 连接服务器将当前用户返回为 Teradata 数据源的当前所有
者。 但是，可以通过配置数据源将一个用户映射到另一个用户的数据库。 在这种情况下，可以通过 Replace
Current Owner With Database 参数配置 Teradata 驱动程序将当前所有者映射到数据库。 只能配合 ODBC
连接使用此参数。
134
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
连接参考
相关信息
Replace Current Owner With Database [第 198 页]
数据访问指南
连接参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
135
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 查询服务器和连接服务器上执行哪些配置设置，才能创建连接。
只能通过使用 Universe 设计工具创建与 Data Federator XI 3.0 查询服务器的连接。 本章还指明用户必须对连
接向导执行哪些配置才能创建连接。
JDBC 连接
创建 JDBC 连接无需执行更多设置。 Data Federator JDBC 驱动程序随 SAP BusinessObjects Business
Intelligence 平台 4.0 提供，并被配置为与 Data Federator XI 3.0 查询服务器一起无缝运行。
ODBC 连接
如果使用 ODBC 连接，此配置取决于所使用的 SAP BusinessObjects 应用程序。 如果是创建使用 Web
Intelligence 胖客户端的连接，流程则不相同。
警告
SAP 建议使用 JDBC 连接将 SAP BusinessObjects 应用程序连接到 Data Federator XI 3.0 查询服务器。
JDBC 连接在所有平台上均可用（Microsoft Windows、各种版本的 UNIX 和 Linux）。
Data Federator ODBC 中间件只能用于 Microsoft Windows，因为使用 OpenAccess ODBC-JDBC 桥接会影
响性能。
相关信息
为 Data Federator JDBC 或 ODBC 连接配置连接向导 [第 137 页]
关于 Data Federator XI 3.0 查询服务器连接 [第 136 页]
使用 Data Federator ODBC 中间件配置 Web Intelligence 胖客户端连接 [第 139 页]
136
© 2014 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 查询服务器安装的身份验证详细信息。
在连接向导的“数据库中间件选择”屏幕中，使用 SAP BusinessObjects、Data Federator 服务器、JDBC 驱动程
序或 ODBC 驱动程序中间件创建连接。
要配置与 Data Federator XI 3.0 查询服务器的 ODBC 连接，还必须执行一些配置。 如果使用 Web Intelligence
胖客户端，所需执行的配置更改不同于其他 SAP BusinessObjects 应用程序所用的配置更改。
8.3
配置 Data Federator ODBC 连接
此节包含 Data Federator XI 3.0 查询服务器的附加设置和连接服务器的配置更改，它们针对的是与除 Web
Intelligence 胖客户端以外的其他所有 SAP BusinessObjects 应用程序的 ODBC 连接。
本节中的配置详细信息提到以下路径：
●<Data Federator 驱动程序安装目录>\OaJdbcBridge： Data Federator ODBC 中间件的安装根目录。
管理员在运行 Data Federator 驱动程序安装程序时会选择此目录。
●<Data Federator 驱动程序安装目录>\JdbcDriver： Data Federator JDBC 中间件的安装根目录。 管理
员在运行 Data Federator 安装程序时会选择此目录。
●
<bo-install-dir>： SAP BusinessObjects 应用程序的安装根目录。
注意
请在 XML 编辑器中编辑这些文件以确保这些文件的格式正确。 在按以下所示更改配置之后，请重新启动系
统以使更改生效。
相关信息
配置 Data Federator ODBC 中间件 [第 138 页]
为 Data Federator ODBC 连接配置连接服务器 [第 138 页]
数据访问指南
创建与 Data Federator XI 3.0 查询服务器的连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
137
8.3.1
配置 Data Federator ODBC 中间件
注意
本主题适用于除 Web Intelligence 胖客户端以外的其他所有使用连接服务器的 SAP BusinessObjects 应用程
序。
要配置 Data Federator ODBC 中间件，需要修改 openrda.ini 文件。 此文件安装在以下目录中：
●<Data Federator 驱动程序安装目录>\OaJdbcBridge\bin\iwinnt
请按以下所示设置 [JavaIp] 节中的参数：
●CLASSPATH=<Data Federator 驱动程序安装目录>\OaJdbcBridge\oajava\oasql.jar;<Data
Federator 驱动程序安装目录>\JdbcDriver\thindriver.jar;<BusinessObjects 安装目录>\SAP
BusinessObjects Enterprise XI 4.0\java\lib\ConnectionServer.jar
●JVM_DLL_NAME=<BusinessObjects 安装目录>\javasdk\jre\bin\client\jvm.dll
●JVM_OPTIONS=-DODBCMode=true Dbusinessobjects.connectivity.directory=<BusinessObjects 安装目录>\SAP
BusinessObjects Enterprise XI 4.0\dataAccess\connectionServer
注意
检查 openrda.ini 文件，以确保没有使用 Djava.endorsed.dirs 参数设置此路径。 如果发现使用了此
参数，则必须从 Djava.endorsed.dirs 参数中删除路径。
8.3.2
为 Data Federator ODBC 连接配置连接服务器
注意
本主题适用于除 Web Intelligence 胖客户端以外的其他所有使用连接服务器的 SAP BusinessObjects 应用程
序。
要配置连接服务器，需要更改以下配置文件： <connectionserver-install-dir>\connectionServer
\cs.cfg
要配置 cs.cfg 文件，请在 JavaVM 标记下设置参数，如下所示：
<ClassPath>
<Path>\\<Data Federator 驱动程序安装目录>\\OaJdbcBridge\\oajava\\oasql.jar</Path>
<Path>\\<Data Federator 驱动程序安装目录>\\JdbcDriver\\thindriver.jar</Path>
</ClassPath>
138
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建与 Data Federator XI 3.0 查询服务器的连接
8.4 使用 Data Federator ODBC 中间件配置 Web Intelligence
胖客户端连接
在创建使用 Data Federator ODBC 中间件的 Web Intelligence 胖客户端连接时，需要执行本节所述的配置更
改。 如果没有正确修正配置，连接会生成错误。 此类连接只在 Windows 环境中得到支持。
记忆
以下详细信息仅与 Web Intelligence 胖客户端有关。
要创建使用 Data Federator ODBC 中间件的连接，需要修改以下项的配置：
●ODBC 中间件
●连接服务器
●Windows 的“RichClient”注册表项
本节中的配置详细信息提到以下路径：
●<Data Federator 驱动程序安装目录>\OaJdbcBridge： Data Federator ODBC 中间件的安装根目录。
管理员在运行 Data Federator 驱动程序安装程序时会选择此目录。
●<Data Federator 驱动程序安装目录>\JdbcDriver： Data Federator JDBC 中间件的安装根目录。 管理
员在运行 Data Federator 安装程序时会选择此目录。
●
<bo-install-dir>： SAP BusinessObjects 应用程序的安装根目录。
注意
请在 XML 编辑器中编辑这些文件以确保这些文件的格式正确。
相关信息
使用 Data Federator ODBC 中间件配置 Web Intelligence 胖客户端连接 [第 139 页]
为 Data Federator 的 Web Intelligence 胖客户端连接配置连接服务器 [第 140 页]
设置 Windows RichClient 注册表项 [第 140 页]
为 Web Intelligence 胖客户端或 Universe 设计工具与 Data Federator 之间的连接配置连接服务器 [第 141 页]
8.4.1 为 Web Intelligence 胖客户端连接配置 Data Federator
ODBC 中间件
要配置 Data Federator ODBC 中间件，需要修改 openrda.ini 文件。 此文件安装在以下目录中：
●<Data Federator 驱动程序安装目录>\OaJdbcBridge\bin\iwinnt
要配置 openrda.ini 文件，请按以下所示设置 [JavaIp] 节中的参数：
数据访问指南
创建与 Data Federator XI 3.0 查询服务器的连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
139
●CLASSPATH=<Data Federator 驱动程序安装目录>\OaJdbcBridge\oajava\oasql.jar;<Data
Federator 驱动程序安装目录>\JdbcDriver\thindriver.jar;<BusinessObjects 安装目录>\SAP
BusinessObjects Enterprise XI 4.0\java\lib\ConnectionServer.jar
●JVM_DLL_NAME=<BusinessObjects 安装目录>\javasdk\jre6\bin\client\jvm.dll
注意
Web Intelligence 胖客户端需要 JDK 6。
●JVM_OPTIONS=-DODBCMode=true Dbusinessobjects.connectivity.directory=<BusinessObjects 安装目录>\SAP
BusinessObjects Enterprise XI 4.0\dataAccess\connectionServer
注意
检查 openrda.ini 文件，以确保没有使用 Djava.endorsed.dirs 参数设置此路径。 如果发现使用了此
参数，则必须从 Djava.endorsed.dirs 参数中删除路径。
8.4.2 为 Data Federator 的 Web Intelligence 胖客户端连接配
置连接服务器
要配置连接服务器以建立 Web Intelligence 胖客户端与 Data Federator 的连接，需要更改配置文件：
<connectionserver-install-dir>\connectionServer\cs.cfg
要配置 cs.cfg 文件，请在 JavaVM 标记下设置参数，如下所示：
<ClassPath>
<Path>\\<Data Federator 驱动程序安装目录>\\OaJdbcBridge\\oajava\\oasql.jar</Path>
<Path>\\<Data Federator 驱动程序安装目录>\\JdbcDriver\\thindriver.jar</Path>
</ClassPath>
8.4.3
设置 Windows RichClient 注册表项
要修改 Windows 的“RichClient”注册表项，请使用 regedit 等工具。
1.在注册表中，找到 HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Suite XI
4.0\default\WebIntelligence\RichClient 项。
2.在此项中，将以下值添加到 classpath 条目。 与所有注册表项值一样，必须用分号分隔这些值。
○
<Data Federator 驱动程序安装目录>\OaJdbcBridge\oajava\oasql.jar
○
<Data Federator 驱动程序安装目录>\JdbcDriver\thindriver.jar
3.在 RichClient\JVMOptions 项，将以下值添加到 6 条目（如果已经存在 ５ 个条目）：
○
140
ODBCMode=true
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
创建与 Data Federator XI 3.0 查询服务器的连接
8.4.4 为 Web Intelligence 胖客户端或 Universe 设计工具与
Data Federator 之间的连接配置连接服务器
在创建从 Universe 设计工具及 Web Intelligence 胖客户端到 Data Federator 的 ODBC 连接时，可以使用单一
配置。 除了前文所述的配置设置之外，还应执行以下操作之一：
●
执行以下操作：
1.运行 regedit 工具。
2.在注册表中，找到 HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Suite XI
4.0\default\ConnectionServer\Configuration 项。
3.在此项中，将以下值添加到“JVM Library”（JVM 库）条目： <bo-install-dir>\javasdk
\jre6\bin\client\jvm.dll。
●
执行以下操作：
1.
打开 cs.cfg 文件进行编辑。
2.
找到 JavaVM 标记。
3.
将 LibraryName 设置为在 openrda.ini 文件中指定的相同 JVM 目录路径：
...
<JavaVM>
<LibraryName JNIVersion="JNI_VERSION_1_4">\\<bo-install-dir>\\javasdk\
\jre6\\bin\\client\\jvm.dll</LibraryName>
</JavaVM>
警告
Universe 设计工具和 OpenEdge 桥接必须指定相同的 JVM 目录路径。
数据访问指南
创建与 Data Federator XI 3.0 查询服务器的连接
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
141
9
配置数据访问全局参数
9.1
关于全局参数
用户可以配置适用于所有连接的全局参数值。这样做可以提高性能，或解决因此引起的连接问题。
数据访问全局参数保留在 cs.cfg 文件中。这是一个 XML 文件，文件中包含连接服务器配置参数以及适用于所
有数据访问驱动程序的默认配置参数。
要覆盖这些全局设置，可编辑每个驱动程序的 SBO 配置文件中的设置。
相关信息
配置驱动程序参数 [第 160 页]
9.2
关于 cs.cfg 配置文件
在 Microsoft Windows 中，cs.cfg 文件存储在以下位置：
●<ConnectionServer 安装目录>\connectionServer
在 cs.cfg 文件中，只能在下列节中配置参数：
●
Capabilities
本节定义可用于指定本地或远程连接服务器用途的参数。
●
Settings
本节定义连接服务器全局配置参数，包括以库模式启动时要加载的驱动程序。
●
JavaVM
本节定义数据访问层使用的 Java 虚拟机（JVM）的默认库。
●
DriverDefaults
此节定义应用于所有数据访问驱动程序的参数。 这些参数可通过 <driver>.sbo 配置文件中的相应设置替换
为具体的驱动程序，其中 <driver> 是 SBO 文件所关联的数据访问驱动程序的名称。
●
Traces
此节中定义的参数允许用户在日志文件中记录通过连接服务器的连接活动。
剩下的 Locales 节为各种可用语言定义操作系统字符集。 切勿修改此节中的参数。
142
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问全局参数
9.3
1.
查看和编辑 cs.cfg 文件
浏览到存储 cs.cfg 文件的目录。 例如，在 Microsoft Windows 系统中：
<连接服务器安装目录>\connectionServer\cs.cfg 其中 <connectionserver-install-dir> 是
连接服务器的安装目录。
2.
在 XML 编辑器中打开 cs.cfg。
3.
根据需要展开各个节。
4.
通过添加新参数和值或者修改现有参数值来设置参数。
5.
针对 DTD 检查文档是否有效，然后保存并关闭该文件。
记忆
在编辑 cs.cfg 文件后，必须重新启动连接服务器。
9.4
配置全局设置参数
cs.cfg 的 Settings 一节用于定义适用于所有驱动程序的设置，用户不能针对个别数据访问驱动程序自定义
此节。
要查看或编辑参数，请在 XML 编辑器中打开 cs.cfg，然后转至“Settings”节。 在该文件中，每个参数都是
在以下标记中定义的：
<Parameter Name="<parameter>"><value> </Parameter>
其中，<parameter> 是参数的名称，并且 <value> 是设置的参数值。
显示的每个参数都带有以下信息：
●
该参数如何在 XML 文件中出现的示例
●
该参数的说明
●
可为该参数设置的可能值（适用时）
●
该参数的默认值
注意
某些设置只能通过中央管理控制台（CMC）修改。 与此有关的更多信息，请参阅《SAP BusinessObjects
Business Intelligence 平台管理员指南》。
9.4.1
Charset List Extension
<Parameter Name="CharSet List Extension">crs</Parameter>
数据访问指南
配置数据访问全局参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
143
说明
注意
不要更改此设置。
设置字符集文件的扩展名。
默认值
9.4.2
crs
Config File Extension
<Parameter Name="Config File Extension">sbo</Parameter>
说明
注意
不要更改此设置。
设置常规配置文件的扩展名。
默认值
9.4.3
sbo
Description Extension
<Parameter Name="Description Extension">cod</Parameter>
说明
注意
不要更改此设置。
设置连接说明文件的扩展名。
默认值
9.4.4
cod
Ignore Driver Load Failure
<Parameter Name="Ignore Driver Load Failure">Yes</Parameter>
144
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问全局参数
说明
确定在驱动程序加载失败时执行的操作。 通过此参数，用户可以选择在驱动程序加载失败
时是希望提供一个可用连接但可能并非所有驱动程序都运行，还是生成一个致命错误且无功能
可用。
注意
在服务器部署模式中将忽略此参数。
值
Yes： 在驱动程序加载失败时连接服务器生成一条警告消息。
No： 在驱动程序加载失败时连接服务器生成一个致命错误。
Yes
默认值
相关信息
Load Drivers On Startup [第 145 页]
9.4.5
Load Drivers On Startup
<Parameter Name="Load Drivers on Startup">No</Parameter>
警告
Load Drivers On Startup 仅适用于库模式。
说明
确定驱动程序库的加载方式。
值
Yes： 在初始化阶段加载所有已安装的驱动程序。
●
No： 按需要加载驱动程序。
No
默认值
9.4.6
●
Max Pool Time
<Parameter Name="Max Pool Time">-1</Parameter>
警告
Max Pool Time 仅可用于库模式。
数据访问指南
配置数据访问全局参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
145
仅可在 CMC 中该服务器的“属性”页内更改服务器模式的连接池超时。 请参阅《SAP BusinessObjects Business
Intelligence 平台管理员指南》。 值应用于连接服务器独立服务器安装。 有关在专用节点上部署连接服务器的信
息，请参阅《SAP BusinessObjects Business Intelligence 平台计划指南》。
说明
确定未使用的连接可在连接池中保持空闲的最长时长。 这代表了连接存在期的上限值。 连
接池是数据访问驱动程序用于重复使用数据库连接以充分利用系统资源的一种机制。
只能为库部署模式设置 Max Pool Time。 值应用于连接服务器随其他服务器产品一同安
装的节点。
值
-1：无超时，在整个会话期间都保持有效。
0：连接不由池管理。
>0：空闲时长（以分钟为单位）。
-1
默认值
相关信息
连接池 [第 31 页]
9.4.7
Setup File Extension
<Parameter Name="Setup File Extension">setup</Parameter>
说明
注意
不要更改此设置。
设置数据访问驱动程序安装文件的扩展名。
默认值
9.4.8
setup
SQL External Extension
<Parameter Name="SQL External Extension">rss</Parameter>
146
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问全局参数
说明
注意
不要更改此设置。
设置外部 SQL 文件的扩展名。
rss
默认值
9.4.9
SQL Parameter Extension
<Parameter Name="SQL Parameter Extension">prm</Parameter>
说明
注意
不要更改此设置。
设置 SQL 参数文件的扩展名。
默认值
prm
9.4.10 Strategies Extension
<Parameter Name="Strategies Extension">stg</Parameter>
说明
注意
不要更改此设置。
设置策略文件的扩展名。
默认值
stg
9.4.11 Validate Configuration Files
<Parameter Name="Validate Configuration Files">No</Parameter>
数据访问指南
配置数据访问全局参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
147
说明
触发根据 XML 模式对配置文件（SBO、COD 和 PRM）的验证。
注意
只能在使用基于 Java 的连接时验证配置文件。
默认值
No
9.4.12 Validate XML Streams
<Parameter Name="Validate XML Streams">No</Parameter>
说明
触发根据 XML 模式对连接服务器实施内解析的 XML 流（如 连接定义）的验证。
注意
只能在使用基于 Java 的连接时验证 XML 流。
默认值
No
9.4.13 JVM 设置
下表向您说明 JVM 选项参数以及相关示例：
表 8：
特性设置
默认值
示例
<JavaVM>
<Options>
<Option>-Xrs</Option>
特性说明
在此示例中未提及 Processor 特
性；默认情况下客户端工具和服务器
都使用此选项。
</Options>
</JavaVM>
Processor="32"
<JavaVM>
<Options>
<Option Processor="32">
-Xmx512m</Option>
在此示例中，将 Processor 特性
设置为“32”。 于是客户端工具便使用
此选项。
</Options>
</JavaVM>
148
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问全局参数
特性设置
Processor="64"
示例
特性说明
在此示例中，将 Processor 特性
<JavaVM>
<Options>
设置为“64”。 于是服务器便使用此
<Option Processor="64">
-Xmx2048m</Option>
选项。
</Options>
</JavaVM>
9.5
设置部署模式
Capabilities 节可帮助用户指定要在运行时使用的连接服务器的部署模式。
在 Capabilities 节下方，Local 名称表示连接服务是由本地提供，作为一个嵌入在客户端进程中的进程内
库。Remote 名称表示通过远程服务器提供连接服务器。
通过设置 Active 属性，可以单独启用这些部署模式。仅在 Local 功能中，EnableJNI 属性支持使用 Java 固
有接口（JNI）。
注意
嵌入在连接服务器中的双向 JNI 允许 API 处理以不同语言开发的连接服务器核心。这意味着用户可以使用
Java API 来处理固有核心，反之亦然。
示例
默认值
以下配置允许带 JNI 的库部署模式和服务器部署模式。
<Capabilities>
<Capability Name="Local" EnableJNI="Yes" Active="Yes"/>
<Capability Name="Remote" Active="Yes"/>
</Capabilities>
示例
服务器模式下的连接服务器
以下配置仅允许用户在服务器模式下使用连接服务器。
<Capabilities>
<Capability Name="Local" EnableJNI="Yes" Active="No"/>
<Capability Name="Remote" Active="Yes"/>
</Capabilities>
在此模式下，仅安装在 BI 平台后台系统上的驱动程序可用于创建连接。
如果某个服务器实例正在运行，用户可以基于安装在平台后台系统上的驱动程序创建本地连接。如果停止该
服务器实例，用户将无法创建任何连接，因为此设置不允许用户使用安装在客户端计算机上的驱动程序。
数据访问指南
配置数据访问全局参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
149
相关信息
连接服务 [第 22 页]
9.6
配置部署模式
在 cs.cfg 文件的 Settings 节中定义的参数控制部署模式。
库模式
Library 节中的参数控制库模式。
服务器模式
在 SAP BusinessObjects Enterprise 安装的 CMC 中管理此模式。在服务器“属性”页显示的参数控制 CORBA 访
问。有关更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理员指南》。
9.7
配置要加载的驱动程序
连接服务器的默认行为是加载所有可用驱动程序。但是，用户可以选择要由连接服务器提供的数据源。
库模式
在 cs.cfg 文件中取注释消 Library 下方 ActiveDataSources 部分，并且指定要加载的网络层和数据库。
例如：
<Library>
<ActiveDataSources>
<NetworkLayer Name="ODBC">
<DataBase Name="MS SQL Server.*$"/>
</NetworkLayer>
<NetworkLayer Name="Oracle OCI">
<DataBase Name="Oracle 10"/>
</NetworkLayer>
</ActiveDataSources>
</Library>
150
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问全局参数
注意
如果数据库名称格式为纯 ASCII，则可能是正则表达式。模式使用 GNU 正则表达式语法。使用 .* 模式可匹配
任何字符。有关常规表达式的更多信息，请参阅 PERL Web 站点：http://www.perl.com/doc/manual/
html/pod/perlre.html#Regular_Expressions
。
服务器模式
在 CMC 服务器属性的“活动数据源”部分中选择数据源。
警告
为避免连接失败，必须确保环境提供了所有必需的中间件，否则必须在“活动数据源”部分中设置所需的网络层和
数据库。
通过允许服务器专用，该设置也可以服务器模式处理涉及多个连接服务器的复杂部署方案。有关复杂部署方案
的更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理员指南》。
9.7.1
为每台计算机设置一个连接
在复杂部署方案中，用户可能希望为每种计算机类型设置一个连接，例如希望将来自 BI 平台的应用程序分别连
接到安装在 Microsoft Windows 上的 MS SQL Server 数据库以及安装在 UNIX 计算机上的 Oracle 数据库。
为避免连接失败，需要执行以下操作之一：
●
执行 BI 平台自定义安装时，为所需的每种数据库类型指定要部署的连接。选择要安装的功能时，请执行此操
作。
●
在 cs.cfg 文件中配置连接服务器时，按照 CMC 中服务器模式的设置方式为库模式（Library 父元素）设置
ActiveDataSources 节。由于应用程序会首先尝试通过本地安装的驱动程序建立连接，用户应采用相同方式
为这两种模式配置驱动程序过滤器。
9.8
配置 CORBA 访问协议
在 BI 平台安装的 CMC 中设置 CORBA 访问协议。 这些协议定义连接服务器处理来自 CORBA 客户端或 HTTP
客户端的请求时所使用的值。
有关 CMC 的更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理员指南》。
数据访问指南
配置数据访问全局参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
151
9.9
激活连接服务器和驱动程序的日志和跟踪。
SAP 会区分以下两种类型的消息：
●
跟踪消息是个特殊过程，从开发人员的角度对系统进行详细分析。
●
日志消息是系统事件和状态的永久记录。
日志消息面向系统管理员，跟踪消息则面向开发人员。 对于数据访问层支持的所有连接（例如，ODBC、
JDBC、JavaBean、OLE DB、OCI 和 JCo），均可启用日志和跟踪。
连接服务器记录和跟踪过程依赖于 SAP BusinessObjects TraceLog 日志记录和跟踪工具。 此工具有助于记录
并跟踪以下过程：
日志
Traces
9.9.1
●
连接服务器实例的启动与停止
●
单一登录初始化
●
驱动程序加载
●
连接服务器的初始化与配置
●
作业和字典的创建与执行
●
驱动程序的加载与活动
●
连接服务器实例的启动与停止
●
连接服务器实例的服务的初始化与活动
●
单一登录初始化
关于 _trace.ini 配置文件
可以在 _trace.ini 配置文件中设置记录和跟踪级别。 例如，可以在 BO_trace.ini 文件中设置以下信息：
sap_log_level = log_info;
sap_trace_level = trace_debug;
if
(process == "cms")
{
log_level = error; // but only log errors for the CMS
}
文件内容
在上图的示例中，定义的标记如下：
●
sap_log_level － 定义记录级别
●
sap_trace_level － 定义跟踪级别
●
一个代码 － 指定进程的记录或跟踪级别。 该代码基于 C 语言或 Java，并且可以包含表达式、简单语句和 ifelse 语句。
152
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问全局参数
下表描述标记 sap_log_level 和 sap_trace_level 接受的配置值。
表 9： SAP 日志级别
严重性
配置值
INFO
log_info 或 log_information
WARNING
log_warn 或 log_warning
ERROR
log_error
FATAL
log_fatal
NONE
log_none
已设置的严重性级别和更高级别的所有消息均会出现在日志文件中。 例如，如果将日志严重性设置为
WARNING，则会记录严重性 WARNING、ERROR 和 FATAL 的所有消息。默认日志严重性为 ERROR。
表 10： SAP 跟踪级别
严重性
配置值
DEBUG
trace_debug
PATH
trace_path
INFO
trace_info 或 trace_information
ERROR
trace_error
NONE
trace_none
已设置的严重性级别和更高级别的所有消息均会出现在日志文件中。 例如，如果将跟踪严重性设置为 INFO，则
会记录严重性 INFO 和 ERROR 的所有消息。默认跟踪严重性为 ERROR。
配置选项
还可以将以下选项添加到文件：
选项
值
always_close
true 或
false
append
true 或
false
说明
在每次写入后关闭日志文件。 默认值为 false。
将日志信息添加到现有日志文件。 更改命名模式以
排除 PID 和时间戳，并改为使用持续增大的日志文件编
号。 默认值为 false。
数据访问指南
配置数据访问全局参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
153
选项
值
keep_num
说明
整数
指定要保留的日志文件的个数。 默认值为 0。 负整
数表示保留所有日志文件。
log_dir
字符串
指定日志文件目录。 默认值为环境变量
BO_TRACE_LOGDIR 的值。 连字符（-）表示日志信息
定向到 stdout。
log_level
scope_only
none、low、
定义快捷方式以指定值 sap_log_level 和
medium 或 high
sap_trace_level。 请参见下表。
true 或
false
认值为 false。
指定日志文件中是否仅出现与范围关联的消息。 默
注意
范围标记代码块的入口和出口。
size
以 KB 为单位
日志文件的最大大小。 默认值为 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
trace_info
medium
log_warn
trace_path
high
log_info
trace_debug
分析错误
分析 _trace.ini 文件时可能发生的错误和警告写到与 INI 文件在同一目录下的 ERR 文件中。 错误文件以 INI
文件的文件名命名。
如果多个进程共享同一个 INI 文件，则用户将不知道错误由哪个进程产生。 要生成信息更丰富的错误文件文件
名，请在 _trace.ini 文件的顶部添加以下行：
error_file = config_file + "_" + process + ".err";
output_file = config_file + "_" + process + ".out";
154
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问全局参数
9.9.2
在 cs.cfg 文件中激活日志和跟踪
可以通过 SAP BusinessObjects 应用程序（例如 SAP BusinessObjects Web Intelligence）的日志和跟踪查找
连接服务器的日志和跟踪。 也可以通过配置 cs.cfg 文件单独记录并跟踪连接服务器。
该文件的 Traces 部分有助于激活连接服务器作业和驱动程序的跟踪。 将 Job 和 JobLevel 的 Active 属性设
置为 Yes 可激活作业跟踪。 将 Middleware 的 Active 属性设置为 Yes 可激活驱动程序跟踪。 将特定驱动程序的
Active 属性设置为 Yes 可激活该驱动程序的跟踪。
示例
默认值
<Traces Active="Yes">
<Logger Implementation="C" ClassID="csTRACELOG">
<Logger Implementation="Java"
ClassID="com.sap.connectivity.cs.logging.TraceLogLogger"/>
<Trace Name="JobLevel" Active="Yes">
<Trace Name="Job" Active="Yes"/>
</Trace>
<Trace Name="MiddleWare" Active="Yes">
<Trace Name="Oracle" Active="Yes"/>
<Trace Name="Sybase" Active="Yes"/>
<Trace Name="DB2" Active="Yes"/>
...
<Trace Name="JCO" Active="Yes"/>
<Trace Name="BO OC" Active="Yes"/>
</Trace>
</Traces>
此配置默认允许记录并跟踪连接服务器和驱动程序。
9.9.3
以库模式激活日志和跟踪
1.
停止连接服务器。
2.
创建值并将其设置为以下环境变量：
○
BO_TRACE_CONFIGDIR，用于设置日志配置文件的文件夹名称，例如：C:\BOTraces\config
○
BO_TRACE_CONFIGFILE，用于设置配置文件的名称，例如 BO_trace.ini
○
BO_TRACE_LOGDIR，用于设置日志的文件夹名称，例如：C:\BOTraces
注意
这些环境变量常用于配置对所有 BI 平台活动的跟踪。
3.
创建 BO_Trace.ini 配置文件，如下所示：
sap_log_level = log_info;
sap_trace_level = trace_debug;
数据访问指南
配置数据访问全局参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
155
注意
INI 文件名区分大小写。
4.
将 logging.jar 和 tracelog.jar 目录路径添加到 CLASSPATH 环境变量。
例如： C:\BOTraces\lib\logging.jar 和 C:\BOTraces\lib\tracelog.jar。
5.
重新启动连接服务器。
日志和跟踪写到默认名称为 TraceLog_<pid>_<timestamp>_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 或 Information）
156
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问全局参数
●
跟踪的 [Network Layer|Database|ID] 部分中显示的受跟踪的网络层和数据库
●
日志和错误消息
示例
跟踪
以下是在库模式下使用连接服务器时获取的严重性为 DEBUG 和 PATH 的跟踪的摘录：
|BE42CC9D40484416BADEF01039652F620|2012 04 12 11:41:27.422|+0200|Debug| |<<| |
|TraceLog| 5256|
1|main
| ||||||||||||||||||||CS||[unknown|
unknown|ID:0]CS Internal Configuration:
|BE42CC9D40484416BADEF01039652F621|2012 04 12 11:41:27.534|+0200|Debug| |<<| |
|TraceLog| 5256|
1|main
| ||||||||||||||||||||CS||[unknown|
unknown|ID:0]
...
|BE42CC9D40484416BADEF01039652F628|2012 04 12 11:41:27.920|+0200|Path| | | | |
TraceLog| 5256|
1|main
| ||||||||||||||||||||CS||ENTER [JDBC|
Oracle 11|ID:
0]com.sap.connectivity.cs.java.ConnectionManager{com.businessobjects.connection
server.ConnectionManager}.close
|BE42CC9D40484416BADEF01039652F629|2012 04 12 11:41:27.920|+0200|Path| | | | |
TraceLog| 5256|
1|main
| ||||||||||||||||||||CS||EXIT [JDBC|
Oracle 11|ID:
0]com.sap.connectivity.cs.java.ConnectionManager{com.businessobjects.connection
server.ConnectionManager}.close
示例
跟踪
以下是在服务器模式下使用连接服务器时获取的严重性为 INFO 的跟踪的摘录：
|6E606102224D49849A2C17D8691FAC785011|2012 04 26 19:02:43.075|+0200|
Information| |==| | |aps_MySIA.csjava| 7088| 53|service builder-4|
||||||||||||||||||||CS||[unknown|unknown|ID:0]Starting CORBA NetworkLayer
service...
示例
日志
以下是在服务器模式下使用连接服务器时获取的日志的摘录：
|6E606102224D49849A2C17D8691FAC7B5114|2012 04 26 19:02:43.805|+0200| |
Information| | | |aps_MySIA.csjava| 7088| 61|service builder-1|
||||||||||||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Loaded driver:
NetworkLayer=JDBC, Database=Generic JDBC datasource
|6E606102224D49849A2C17D8691FAC7B5116|2012 04 26 19:02:43.817|+0200| |
Information| | | |aps_MySIA.csjava| 7088| 61|service builder-1|
||||||||||||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Loaded driver:
NetworkLayer=JDBC, Database=MaxDB 7.7
...
|43eabdad-d3e4-ec14-89aa-0c9a9fba3101|2012 04 26 19:02:20:883|+0200| |
Information| | | |connectionserver_MySIA.ConnectionServer|1576|7816|| |0|94|0|
2|-|-|-|-|-|-||||||||||CS||THIS IS A LOG [unknown|unknown|ID:
0]ConnectionServer is now started
数据访问指南
配置数据访问全局参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
157
9.10 激活 OLAP 客户端的日志和跟踪
可以通过 SAP BusinessObjects 应用程序（例如 SAP BusinessObjects Web Intelligence）的日志和跟踪查找
OLAP 客户端的日志和跟踪。例如，可以通过 Web Intelligence 处理服务器的跟踪进行查找。也可以通过配置
OlapClient.cfg 文件单独记录并跟踪 OLAP 客户端。
将文件的 OlapClient 部分中的 UseLog 属性设置为 yes 可激活日志。可以在 LogFileName 属性中指定日志
文件路径。不可更改值 UseProcessName。
更改这些设置不需要停止 Web Intelligence 处理服务器。可以在 Web Intelligence 处理服务器正在运行时激活
日志和跟踪。
示例
[OlapClient]
UseLog =yes
UseProcessName=false
LogFileName =c:\OlapClient.log
; Factory Mode can be: Lib (inproc) or Proxy (Remoting)
FactoryMode=Lib
...
此配置允许记录并跟踪 OLAP 客户端。
相关信息
关于 OlapClient.cfg 配置文件 [第 22 页]
9.10.1 日志示例
以下示例是为 MSAS 连接获取的 OLAP 客户端日志文件的摘录。
...
[2012/11/05 - 12:04:54:025][0] XmlaConnectionWinhttp::XmlaConnectionWinhttp() ->
Using Windows HTTP Services version 6.1.7600.16385
[2012/11/05 - 12:04:54:025][0] HTTPClient::connect() -> Using direct access
[2012/11/05 - 12:04:54:040][0] HTTPClient::connect() -> Using Windows Proxy
Automatic Discovery (WPAD)
[2012/11/05 - 12:04:54:040][0] HTTPClient::connect() -> Using proxy settings:
WPAD url=http://proxy:8083, Proxy= ProxyBypass=
[2012/11/05 - 12:04:54:040][0] HTTPClient::connect() -> Connecting using
WinHttpConnect(): Hostname='olap-wxp' Port=80
[2012/11/05 - 12:04:54:040][0] XmlaConnectionWinhttp::Open() -> Connected.
[2012/11/05 - 12:04:54:040][0] XmlaClient::discover() Call
'DISCOVER_DATASOURCES'...
[2012/11/05 - 12:04:54:040][0] SoapEnvelope::updateProperties() BeginRange=-1
EndRange=-1
[2012/11/05 - 12:04:54:040][0] XmlaConnectionWinhttp::SendRequest()
Authentication Mode = Credentials.
[2012/11/05 - 12:04:54:040][0] XmlaConnectionWinhttp::SendRequest() Setting
158
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问全局参数
basic credential to HttpRequest.
[2012/11/05 - 12:04:54:040][0] XmlaConnection::getTimeout() No timeout was
specified in ConnectionSpecification, defaulting to 100(s).
[2012/11/05 - 12:04:54:056][0] XmlTextReader::XmlTextReader() Using libXML
version 2.06.32
[2012/11/05 - 12:04:54:056][0] XmlaClient::discover() Rowset contains 1 rows
[2012/11/05 - 12:04:54:056][0] XmlaClient::discover() Call
'DISCOVER_DATASOURCES' ElapseTime=15ms
[2012/11/05 - 12:04:54:056][0] XmlaClient::createOlapEntities() ->
Rowset=[DISCOVER_DATASOURCES], 1 entities retrieved Elapse=15ms
[2012/11/05 - 12:04:54:056][0] XmlaClient::discover() Call
'DISCOVER_SCHEMA_ROWSETS'...
[2012/11/05 - 12:04:54:072][0] SoapEnvelope::updateProperties() BeginRange=-1
EndRange=-1
[2012/11/05 - 12:04:54:072][0] XmlaConnectionWinhttp::SendRequest()
Authentication Mode = Credentials.
[2012/11/05 - 12:04:54:072][0] XmlaConnectionWinhttp::SendRequest() Setting
basic credential to HttpRequest.
[2012/11/05 - 12:04:54:072][0] XmlaConnection::getTimeout() No timeout was
specified in ConnectionSpecification, defaulting to 100(s).
[2012/11/05 - 12:04:54:072][0] XmlTextReader::XmlTextReader() Using libXML
version 2.06.32
[2012/11/05 - 12:04:54:072][0] XmlaClient::discover() Rowset contains 54 rows
...
数据访问指南
配置数据访问全局参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
159
10 配置数据访问驱动程序参数
10.1 配置驱动程序参数
要为某一特定数据访问驱动程序配置数据访问，可编辑驱动程序配置文件以调整参数设置，或在需要为环境中
的特定数据库建立连接的情况下，创建自定义数据库条目。
注意
对于每个使用连接服务器的 SAP BusinessObjects 应用程序，其关联的自述文件包含关于命令行实用程序的信
息，用户可以使用这些实用程序来检查 RDBMS 和数据访问驱动程序配置。这些实用程序可创建用于对交互式分
析服务器活动进行跟踪的日志文件。有关使用这些实用程序的说明，请参阅此版本的自述文件。
相关信息
关于全局参数 [第 142 页]
10.1.1
数据访问配置文件
以下配置文件可控制每个定义的连接的数据访问驱动程序配置：
●cs.cfg
此文件定义应用于所有连接的全局参数。 它位于 <connectionserver-install-dir>
\connectionServer 目录中。
●<driver>.sbo
此文件特定于各个数据访问驱动程序。 <driver> 占位符代表配置文件所应用于的数据源。 每个 SBO 文件都
位于 connectionServer 目录的子目录中，该子目录以数据库网络层或中间件命名，例如
Oracle 数据库中的 <connectionserver-install-dir>\connectionServer\oracle。
注意
在 cs.cfg 文件的 DriverDefaults 节中设置的参数将被 SBO 文件中的相应设置覆盖。
●
<driver>.setup
此文件定义 SBO 文件名称、目录以及与驱动程序相关的数据库网络层或中间件。 要使驱动程序可以使用，此
文件为必需。 没有安装文件的驱动程序无法使用。 所有文件都位于
<connectionserver-install-dir>\connectionServer\setup 目录中。
例如，以下 oracle_jdbc.setup 文件为用于创建 JDBC 连接的 Oracle 数据访问驱动程序定义 oracle.sbo
配置文件：
...
<Driver>
<NetworkLayer Name="JDBC"></NetworkLayer>
160
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问驱动程序参数
<Directory>jdbc</Directory>
<DataFileName>oracle</DataFileName>
</Driver>
...
相关信息
关于全局参数 [第 142 页]
已安装的 SBO 文件 [第 161 页]
10.1.2 已安装的 SBO 文件
以下 <驱动程序>.sbo 文件会默认安装在 Microsoft Windows 上。
有关受支持的驱动程序的最新列表，请查看 SAP Service Marketplace 网站（网址为 service.sap.com/bosapsupport
）或与 SAP 代表联系。
子目录
数据库技术
SBO 文件
db2
IBM DB2
db2.sbo
essbase
Oracle Essbase
essbase.sbo
javabean
Javabean
javabean.sbo
jco
SAP ERP
jco.sbo
jdbc
Data Federator 服务器
datafederator.sbo
IBM DB2
db2.sbo
Derby
derby.sbo
Greenplum
greenplum.sbo
PostgreSQL
数据访问指南
配置数据访问驱动程序参数
postgresql.sbo
HIVE
hive.sbo
Amazon EMR HIVE
hive.sbo
SAP Impala
hive.sbo
HSQLDB
hsqldb.sbo
IBM Informix
informix.sbo
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
161
子目录
数据库技术
SBO 文件
Ingres
ingres.sbo
通用 JDBC
jdbc.sbo
MaxDB
maxdb.sbo
MySQL
mysql.sbo
HP Neoview
neoview.sbo
Netezza
netezza.sbo
SAP HANA
newdb.sbo
Oracle
oracle.sbo
Microsoft SQL Server
sqlsrv.sbo
Sybase
sybase.sbo
Teradata
teradata.sbo
HP Vertica 6.1
vertica.sbo
odata
OData 2.0
odata.sbo
odbc
MS Access 2007
access.sbo
MS Access 2010 和 2013
access2010.sbo
Data Federator 服务器
datafederator.sbo
IBM DB2 iSeries
db2iseries.sbo
PostgreSQL 8
postgresql.sbo
Greenplum 4
greenplum4.sbo
PostgreSQL9
162
postgresql9.sbo
IBM Informix
informix.sbo
Ingres
ingres.sbo
MaxDB
maxdb.sbo
MS Excel 2007
msexcel.sbo
MySQL
mysql.sbo
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问驱动程序参数
子目录
数据库技术
SBO 文件
HP Neoview
neoview.sbo
Netezza
netezza.sbo
SAP HANA
newdb.sbo
通用 ODBC 和通用 ODBC3
odbc.sbo
用于 Salesforce 的 OpenAccess
openaccess.sbo
MS Excel 2010、2013 和文本文件
personalfiles.sbo
Microsoft SQL Server
sqlsrv.sbo
Sybase
sybase.sbo
Teradata
teradata.sbo
HP Vertica 6.1
vertica.sbo
SAP Hive
bigdata.sbo
SAP Impala
bigdata.sbo
Amazon EMR HIVE
bigdata.sbo
通用 OLE DB
oledb.sbo
Microsoft SQL Server
sqlsrv.sbo
oledb_olap
Microsoft Analysis Services
slqsrv_as.sbo
open
CSV 文件
open.sbo
oracle
Oracle
oracle.sbo
Oracle EBS
oracle_ebs.sbo
sap
SAP BW
sap.sbo
sybase
Sybase
sybase.sbo
xml
XML
xml.sbo
Web 服务
webservices.sbo
oledb
jdbc 子目录包含的配置文件用于管理通过 JDBC 网络层的数据库连接。 查看 SAP Service Marketplace 网
站，或查看 SBO 文件系列以了解 JDBC 连接所支持的数据库的详细信息。
数据访问指南
配置数据访问驱动程序参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
163
odbc 子目录包含的 mysql.sbo 配置文件用于管理通过 ODBC 网络层到 MySQL 数据库的连接。 MySQL 5 数
据库可用于所有平台，带 Unicode 支持。 确保使用 MySQL Connector/ODBC 5.1.4 或更高版本以连接到此数据
库。 如果在 UNIX 上使用较早版本的驱动程序，运行时将会出错。
odbc 子目录包含的 greenplum4.sbo 和 access2010.sbo 配置文件用于管理其中一方面到 Greenplum 4 和
PostgreSQL 9 的连接，以及另一方面通过 ODBC 网络层到 MS Access 2010 和 2013 的连接。 这些文件有别于
greenplum.sbo 和 access.sbo 文件，因为前者在 32 位和 64 位 MS Windows 上均可部署配置。 GreenPlum
4 和 PostgreSQL 9 数据库在 64 位 UNIX 系统上也可用。
odbc 子目录还包含 msexcel.sbo 配置文件，用于管理通过 ODBC 网络层与 MS Excel 2007 的连接。 此文件
仅在 32 位 MS Windows 上部署配置： personalfiles.sbo 配置文件在 32 位和 64 位 MS Windows 上为通过
ODBC 到 MS Excel 2010 和 2013 的连接部署配置。
open 子目录包含的 open.sbo 配置文件用于管理通过 CSV OpenDriver 到 CSV 文件的连接。 使用 Java 驱动
程序开发工具包基于 CSV 开放式驱动程序示例开发 CSV 驱动程序时，必须找到此目录中的所有配置文件。 有关此
驱动程序的更多信息，请参阅《Data Access Driver Java SDK Developer Guide》（数据访问驱动程序 Java SDK
开发人员指南）。
10.1.3 查看和编辑 SBO 文件
警告
在打开 SBO 文件之前，请先备份文件。 某些配置参数绝对不能编辑。 如果更改或删除这些参数，可能会影响
SAP BusinessObjects 应用程序的运行。
1.
浏览到存储目标数据访问驱动程序的 SBO 文件的目录。
2.
在 XML 编辑器中打开 SBO 文件。
3.
根据需要展开各个节。
4.
找到要更改其值的相应标记，然后更改此值。
参数按以下格式显示： <Parameter Name="<parameter>"><value></Parameter>，其中
<parameter> 是参数的名称，而 <value> 是归属于该参数的值。
5.
依据 DTD 检查该文件是否有效，然后保存并关闭文件。
10.1.4 自定义 SBO 文件
警告
安装新驱动程序时，可能需要以用户数据库条目和驱动程序对 SBO 文件进行自定义。 为避免编辑 SBO 文件时
出错，SAP BusinessObjects 建议创建一个单独的 SBO 文件，用来指定自定义所针对的数据库以及驱动程序使
用的库。 此外，还需事先为 SBO 文件定义创建一个安装文件。 不需要修改注册表。
1.
使用 XML 编辑器在 <connectionserver-install-dir>\connectionServer\setup 目录中创建安装
文件。
164
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问驱动程序参数
指定 SBO 文件名称、目录以及用于连接的数据库网络层。
2.
依据 DTD 检查该文件是否有效，然后保存并关闭文件。
3.
浏览到要保存 SBO 文件的子目录或创建安装文件中指定的自定义子目录。
4.
使用 XML 编辑器，创建包含目标数据库和驱动程序库的 SBO 文件。
5.
依据 DTD 检查该文件是否有效，然后保存并关闭文件。
除自定义 SBO 文件以外，用户还需为每个新安装的驱动程序创建 COD、PRM 和 RSS 文件。
10.1.5 动态检查连接
用户可自定义驱动程序以使其在运行时验证连接池的连接是否可以使用。验证过程为：从连接池检索连接时，
执行没有副作用的 SQL 查询。如果 SQL 查询的执行结果没有错误，则表示可以使用该连接。如果有错误，则丢弃
该连接。
记忆
此功能可用于通用 ODBC、通用 OLE DB 和通用 JDBC 连接。其他所有受支持的连接已完成此连接检查，因此
无需进行自定义设置。
1.
停止连接服务器。
2.
打开驱动程序的 SBO 文件。
3.
找到与连接相对应的 DataBase 一节。
例如，对于通用 ODBC 连接：
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC datasource">
<Libraries>
...
</Libraries>
<Parameter Name="CharSet Table" Platform="Unix">datadirect</Parameter>
</DataBase>
...
4.
在 DataBase 节中添加以下行：
<Parameter Name="Connection Check"><SQL query></Parameter>
其中 <SQL query> 是用于检查连接有效性的查询。
5.
保存 SBO 文件。
6.
重新启动连接服务器。
连接服务器将在执行数据请求之前验证连接是否可用。
10.1.6 JDBC 驱动程序属性
可通过执行以下操作之一添加 JDBC 驱动程序属性：
数据访问指南
配置数据访问驱动程序参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
165
●
在应用程序的连接向导中，在创建连接时设置“JDBC 驱动程序属性（键=值,键=值）：” 参数。 此为可选操作。
●
停止连接服务器后，在相应的 SBO 文件中设置驱动程序属性。
如果同时在 SBO 文件和向导中设置了属性，那么应用程序仅使用通过向导设置的值。
示例
此处示了 oracle.sbo 文件中修改了两个驱动程序属性的节。
<DataBase Active="Yes" Name="Oracle 10">
<Class JARFile="dbd_jdbc,dbd_oracle">
com.businessobjects.connectionserver.java.drivers.jdbc.oracle.OracleDriver</
Class>
<JDBCDriver>
<Parameter Name="JDBC Class">oracle.jdbc.OracleDriver</Parameter>
<Parameter Name="URL Format">jdbc:oracle:thin:@§DATASOURCE§:§DATABASE§</
Parameter>
<Properties>
<Property Name="oracle.jdbc.defaultNChar">true</Property>
<Property Name="defaultNChar">true</Property>
</Properties>
...
</JDBCDriver>
...
</DataBase>
相关信息
使用 SBO 文件创建 JDBC 连接 [第 50 页]
10.2 关于 DataDirect ODBC 驱动程序
数据访问层允许在所有 UNIX 平台上将 DataDirect ODBC 7.0 驱动程序用于 MS SQL Server 数据库。 这些驱动
程序可以是无品牌的或有品牌的驱动程序。
DataDirect 品牌的驱动程序作为 BI 平台的一部分提供，并且只能用于 SAP BusinessObjects 应用程序（如
SAP BusinessObjects Web Intelligence）。 可以在 <boe-install-dir>/enterprise_xi40/<platformname>/odbc/lib 目录中找到这些驱动程序，其中 <boe-install-dir> 表示 BI 平台安装目录，<platformname> 表示 UNIX 平台名称。
MS SQL Server 数据库不但可以与 DataDirect ODBC 7.0 驱动程序或 DataDirect ODBC 7.0 品牌的驱动程序配
合使用， 而且可以与 6.0 SP2 版本的驱动程序配合使用。 但是，现有的平台版本没有随附此版本。
连接服务器的默认设置可让无品牌的 ODBC 驱动程序与用户当前的配置设置无缝地配合工作。 如果已在环境中
部署驱动程序，则无需进行任何配置更改就能安装无品牌的驱动程序。
166
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问驱动程序参数
10.2.1 启用有品牌的 DataDirect 驱动程序
要使用有品牌的驱动程序，必须确保正确配置了数据访问。
1.
导航至包含 sqlsrv.sbo 文件的目录。
在 UNIX 上，此配置文件位于 <connectionserver-install-dir>/connectionServer/odbc 目录
中。
2.
使用 XML 编辑器打开 sqlsrv.sbo 文件进行编辑。
3.
找到 Defaults 节。
默认情况下，Use DataDirect OEM Driver 参数设置为 No。 这意味着数据访问默认配置为供无品牌的驱
动程序使用。
4.
将 Use DataDirect OEM Driver 参数设置为 Yes 并保存文件。
5.
将下面的路径添加到 LD_LIBRARY_PATH 环境变量中：
<boe-install-dir>/enterprise_xi40/<platform-name>/odbc/lib
6.
通过编辑 <boe-install-dir>/setup 目录中的 env.sh 文件来配置环境，并将其设置为源。
例如：
DEFAULT_ODBCFILE="${BOBJEDIR}enterprise_xi40/"odbc.ini
Export DEFAULT_ODBCFILE
ODBC_HOME="${BINDIR}odbc"
Export ODBC_HOME
ODBCINI="${BOBJEDIR}enterprise_xi40/"odbc.ini
export ODBCINI
注意
DEFAULT_ODBCFILE 可以指向其中包含这些品牌驱动程序的连接详细信息的任何文件。
7.
通过编辑 odbc.ini 文件来配置数据源。
例如：
[ODBC Data Sources]
sql2008=sql=DataDirect 7.0 SQL Server Native Wire Protocol
Driver=/.../enterprise_xi40/linux_x64/odbc/lib/CRsqls24.so
Description=DataDirect 7.0 SQLServer Wire Protocol Driver
Address=10.180.0.197,1433
Database=bodb01
8.
从 CMC 启动连接服务器。
连接服务器能够使用有品牌的 DataDirect ODBC 驱动程序创建与 MS SQL Server 数据库的连接。
示例
以下是从默认 sqlsrv.sbo 文件中摘取的一部分。
<Defaults>
<Parameter
<Parameter
<Parameter
<Parameter
<Parameter
...
<Parameter
Name="Family">Microsoft</Parameter>
Name="SQL External File">sqlsrv</Parameter>
Name="SQL Parameter File">sqlsrv</Parameter>
Name="Description File">sqlsrv</Parameter>
Name="Strategies File">sqlsrv</Parameter>
Name="Use DataDirect OEM Driver" Platform="Unix">No</Parameter>
数据访问指南
配置数据访问驱动程序参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
167
</Defaults>
...
168
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据访问驱动程序参数
11
SBO 参数参考
11.1
SBO 文件结构
每个受支持的数据访问驱动程序都有一个 <driver>.sbo 文件。 每个 <driver>.sbo 文件分为以下各节：
文件节
Defaults
说明
本节包含对使用数据访问驱动程序的所有数据库中间件均适用的默认配
置参数。 这些参数优先于在数据库中间件中设置的任何相应值。
Databases
本节包含数据访问驱动程序所支持的每个数据库中间件的 DataBase 子
元素。
每个 DataBase 元素可包含以下元素或属性：
●
Active： 此属性指定是否激活中间件支持。 属性值为 YES 或 NO。
●
Name： 此属性指定数据访问驱动程序支持的中间件的名称。 此处的中
间件名称值集出现在连接向导的“数据库中间件”页面中。
●
Alias： 此元素指定数据访问驱动程序已不再正式支持但仍在使用的旧
版本中间件。 用户可以为旧版本中间件添加一个别名元素，以便现有连
接改为使用当前的数据访问驱动程序。 可以将特定于旧中间件的配置参
数设置为新别名的参数； 可以使用别名创建新连接。
●
Parameter： 此元素具有 Name 属性和仅应用于中间件的值。 此处列
出的参数值集优先于 Defaults 节中相同参数的值集。
注意
布尔型参数接受 true/false 和 yes/no 值。 值不区分大小写。
11.2
SBO 参数说明
配置参数按以下顺序列出：
●
公共
此节描述各种数据库技术共用的 SBO 文件参数。其他类别分别描述特定于其代表的数据库技术或网络层的参
数。
●
JavaBean
●
JCO
●
JDBC
●
OData
●
ODBC
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
169
●
OLE DB
●
OLE DB for OLAP
●
Sybase ASE/CTL
●
Teradata
显示的每个参数都带有以下信息：
●
该参数如何在 XML 文件中出现的示例
●
该参数的说明
●
可为该参数设置的可能值
●
参数的默认值
相关信息
公共 SBO 参数 [第 170 页]
JavaBean SBO 参数 [第 186 页]
JCO SBO 参数 [第 187 页]
JDBC SBO 参数 [第 187 页]
OData SBO 参数 [第 192 页]
ODBC SBO 参数 [第 192 页]
OLE DB SBO 参数 [第 195 页]
OLE DB OLAP SBO 参数 [第 196 页]
Sybase SBO 参数 [第 196 页]
Teradata SBO 参数 [第 198 页]
11.3
公共 SBO 参数
这些 SBO 参数大多数为所有数据驱动程序所共用。它们通常在文件的 Defaults 节中定义。某些 SBO 参数也
在 cs.cfg 文件中定义。Defaults 节中设置的值会覆盖 cs.cfg 文件设置中的值。
11.3.1
Array Bind Available
<Parameter Name="Array Bind Available">No</Parameter>
说明
指定数据库是否支持数组绑定。
数组绑定可优化 SQL 更新查询的性能。
170
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
值
Yes： 数据库支持数组绑定。
No： 数据库不支持数组绑定。
默认值
11.3.2
cs.cfg 文件中设置的值。
Array Bind Size
限制
SAP BusinessObjects BI 平台客户端工具不使用此参数。
<Parameter Name="Array Bind Size">5</Parameter>
说明
指定每次使用 INSERT 查询时导出的行数。
值
每次使用 INSERT 查询时导出的行数（整数）。
默认值
cs.cfg 文件中设置的值。
11.3.3
Array Fetch Available
<Parameter Name="Array Fetch Available">No</Parameter>
说明
指定连接服务器是否启用数组获取功能。
数组获取功能通过以切片为单位检索 SQL 结果来优化性能。
值
Yes： 支持数组获取。
No： 不支持数组获取。
默认值
11.3.4
cs.cfg 文件中设置的值。
Array Fetch Size
<Parameter Name="Array Fetch Size">10</Parameter>
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
171
说明
指定每个切片检索的数据行数。 连接服务器在所有部署模式下都提供数组提
取功能。
记忆
如果数据库中间件支持数组提取，Array Fetch Size 值将传播到数据库中
间件。
最佳行数取决于系统性能：
●如果数目太低，系统会多次检索少量数据， 因而影响性能。
●如果行数较多，系统执行检索操作的次数会比较少，但每次检索需要占用更
多的内存。
警告
Array Fetch Size 值会影响系统性能，在远程访问（如在 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 驱动程序限制 [第 87 页]
11.3.5
BigDecimal Max Display Size
<Parameter Name="BigDecimal Max Display Size">128</Parameter>
说明
172
指定使用 BigDecimal 字符类型检索的数据的最大显示长度。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
值
显示长度（整数字节）
默认值
无默认值。
11.3.6
Binary Max Length
<Parameter Name="Binary Max Length">32768</Parameter>
说明
指定以下类型的表列的最大长度：
●
二进制，并且值 MaxLength 为 Max 或没有为 OData 数据源提供固定长度
●
XML 数据源的 base64Binary 和 hexBinary
如果大于指定值，返回的数据将被截断。
32768
默认值
相关信息
OData 驱动程序 [第 69 页]
XML 驱动程序 [第 88 页]
Web 服务驱动程序 [第 100 页]
11.3.7
Bucket Split Size
<Parameter Name="Bucket Split Size">25000</Parameter>
指定将记录写到本地磁盘前存储在内存中的记录数。 下列数据访问驱动程序在执行 ORDER
说明
BY、GROUP BY 或 DISTINCT 运算时会使用 Bucket Split Size：
●
CSV OpenDriver
●
OData 驱动程序
●
SAP ERP 驱动程序
●
XML 和 Web 服务提供程序
注意
当操作系统未指定临时文件夹时，可以使用 Temp Data Dir 参数在 cs.cfg 文件中配置目
录路径。 这种情况可能发生于 Linux 操作系统。
Bucket Split Size 会影响内存占用。 如果主内存大小太小，那么参数值会被忽略。
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
173
默认值
25000
相关信息
本地磁盘用作排序操作的缓存 [第 108 页]
CSV OpenDriver、OData、SAP ERP、XML 和 Web 服务驱动程序能够将本地磁盘用作已排序的行的缓存。
Temp Data Dir [第 183 页]
11.3.8
Catalog Separator
<Parameter Name="Catalog Separator">.</Parameter>
说明
指定用于数据库标识符元素(限定符、所有者、表以及列）之间的分隔符。 例如，
<database_name>.<table_name>.<column_name>。
值
要使用的分隔符。 通常为句点。
默认值
如果未指定，则连接服务器使用在数据库中间件中指定的分隔符。
11.3.9
CharSet Table
<Parameter Name="CharSet Table">sybase</Parameter>
说明
指定用于操作系统与中间件之间字符集映射的表的名称。
值
CRS 文件的名称。
默认值
无默认值。
11.3.10
Description File
<Parameter Name="Description File">oracle</Parameter>
174
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
说明
注意
不要编辑此参数。
指定用于保存连接向导输入字段标签的 COD 文件的名称。
11.3.11
Dictionary Transaction Mode
<Parameter Name="Dictionary Transaction Mode">Transactional</Parameter>
说明
指定数据访问驱动程序以事务模式查询元数据。
注意
数据访问驱动程序默认以自动提交模式查询元数据。 要将驱动程序的配置更改为事务模
式，请将此参数添加到 SBO 配置文件的适当部分（Defaults 部分或任何 Database 部
分）。
值
11.3.12
Transactional
Driver Capabilities
<Parameter Name="Driver Capabilities">Procedures , Query</Parameter>
说明
驱动程序的功能，即驱动程序是否能够访问数据库软件中可用的存储过程和查询。 此参数
通过连接向导设置。 可在此参数中包含两个值。
注意
对于 JavaBean 驱动程序，必须将此参数设置为 Procedures。 就 SAP
BusinessObjects 应用程序而言，JavaBean 驱动程序的功能是作为存储过程来定义的。
值
Procedures： 驱动程序可以使用数据库中存储的过程来检索数据。
Query： 驱动程序可以使用 SQL 等查询语言来检索数据。
默认值
11.3.13
Query
Driver Name
<Parameter Name="Driver Name">Adaptive Server IQ</Parameter>
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
175
说明
指定在 Microsoft Windows 的“ODBC 数据源管理器”的“驱动程序”选项卡中显示的驱动程序
名称。
此参数特定于 ODBC， 帮助用户过滤“ODBC 数据源名称（DSN）”列表中的驱动程序。
值
驱动程序的名称。
注意
可使用基于 PERL GNU regexp 语法的正则表达式。
默认值
11.3.14
无默认值。
Escape Character
<Parameter Name="Escape Character">/</Parameter>
说明
指定用于对特殊字符组成的字符串（例如模式）进行转义的字符。
值
要用作转义符的字符。
默认值
如果未指定，连接服务器会从中间件中获取值。
11.3.15
Extensions
<Parameter Name="Extensions">oracle10,oracle,jdbc</Parameter>
说明
注意
不要编辑此参数。
为数据访问驱动程序的 PRM 和 RSS 文件指定可能名称的列表。 此列表还指定用于存储
JAR 文件的目录的可能名称。
相关信息
使用 Extensions 创建 JDBC 连接 [第 51 页]
176
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
11.3.16
Family
<Parameter Name="Family">Sybase</Parameter>
说明
注意
不要编辑此参数。
指定将显示在连接向导的“数据库中间件选择”页中的数据库引擎系列。 此页将按树形视图显
示与用户的许可相对应的中间件集。
11.3.17
Force Execute
<Parameter Name="Force Execute">Never</Parameter>
说明
注意
不要编辑此参数。
指定是否在检索结果说明之前执行 SQL 查询。
值
Never： 在检索结果说明之前从不执行 SQL 查询。
Procedures： 在检索结果说明之前执行 SQL 查询，但仅针对存储过程。
Always： 在检索结果说明之前始终执行 SQL 查询。
默认值
11.3.18
Never
Identifier Case
<Parameter Name="Identifier Case">LowerCase</Parameter>
说明
指定数据库如何处理简单标识符的大小写行为。
值
CaseSensitive： 数据库将大小写混合的 SQL 标识符视为区分大小写。
LowerCase： 数据库将大小写混合的 SQL 标识符视为不区分大小写，并以小写形式存储这
些标识符。
MixedCase： 数据库将大小写混合的 SQL 标识符视为不区分大小写，并以大小写混合形式
存储这些标识符。
UpperCase： 数据库将大小写混合的 SQL 标识符视为不区分大小写，并以大写形式存储这
些标识符。
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
177
11.3.19
Identifier Quote String
<Parameter Name="Identifier Quote String">"</Parameter>
说明
指定用于将数据库标识符括起的字符。
值
用于将数据库标识符括起的字符。 通常为引号（"）。
默认值
如果未指定，连接服务器将从数据库中间件获取该信息。
11.3.20
Include Synonyms
<Parameter Name="Include Synonyms">False</Parameter>
说明
指定是否从 Oracle 数据库检索 Oracle Synonyms 的列。 这适用于通过 JDBC 或 Oracle
OCI 网络层访问的 Oracle 连接。
True： 将检索 Oracle Synonyms 的列，并将其显示为表列。
值
False： 不检索 Oracle Synonyms 列。
默认值
11.3.21
False
Integer Max Length
<Parameter Name="Integer Max Length">18</Parameter>
说明
指定 XML 内置类型为 integer、nonPositiveInteger、negativeInteger、
noNegativeInteger 和 positiveInteger 的表列的最大长度。
如果大于指定值，返回的数据将被截断。
Integer Max Length 适用于 XML 数据源和 Web 服务。
默认值
18
相关信息
XML 驱动程序 － 配置列最大大小 [第 100 页]
Web 服务驱动程序 － 配置列最大大小 [第 107 页]
178
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
11.3.22
Introscope Available
<Parameter Name="Introscope Available">True</Parameter>
说明
注意
不要编辑此参数。
指定是否为驱动程序激活通过 CA Wily Introscope 监控性能。
值
True： 激活驱动程序的监控。
False： 不激活驱动程序的监控。
默认值
对于 cs.cfg 文件中的所有驱动程序，此参数都设置为 False。 实际上仅为 newdb.sbo
文件中的 SAP HANA 连接激活监控。
11.3.23
Max Rows Available
<Parameter Name="Max Rows Available">No</Parameter>
说明
指定驱动程序是否能够限制可从数据源检索的最大行数。
值
Yes： 可以限制最大行数。
No： 不能限制最大行数。
默认值
11.3.24
No
Native Int64 Available
<Parameter Name="Native Int64 Available">False</Parameter>
说明
注意
不要编辑此参数。
表示 64 位的整数是否可由中间件直接处理。
值
True： 64 位的整数可由中间件处理。
False： 数据访问层模拟 Int64 方法。
默认值
数据访问指南
SBO 参数参考
False
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
179
11.3.25 Optimize Execute
<Parameter Name="Optimize Execute">False</Parameter>
说明
指定连接服务器是否优化 SQL 查询的执行。 此函数仅受 JDBC 和 ODBC 驱动程序支持。
值
True： 只要可能，即在执行时优化 SQL 查询。
False： 执行时不优化 SQL 查询。
默认值
11.3.26
False
Owners Available
<Parameter Name="Owners Available">No</Parameter>
说明
指定数据访问驱动程序是否处理数据库所有者。
注意
要在信息设计工具中手动设置表所有者，必须将此参数设置为 Yes。
值
Yes： 支持所有者。
No： 不支持所有者。
默认值
11.3.27
未指定。 连接服务器从数据库中间件获取此信息。
Qualifiers Available
<Parameter Name="Qualifiers Available">No</Parameter>
说明
指定数据访问驱动程序是否处理数据库限定符。
注意
要在信息设计工具中手动设置表限定符，必须将此参数设置为 Yes。
值
Yes： 支持限定符。
No： 不支持限定符。
默认值
180
未指定。 连接服务器从数据库中间件获取此信息。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
11.3.28
Query TimeOut Available
<Parameter Name="Query TimeOut Available">False</Parameter>
说明
指定数据库中间件是否支持查询超时，即是否可在时间段过期之后取消正在运行的查询。
值
True： 数据库中间件处理查询超时。
False： 数据库中间件不处理查询超时。
默认值
11.3.29
False
Quote Identifiers
<Parameter Name="Quote Identifiers">True</Parameter>
说明
指定存储过程的标识符是否支持引号。
值
True： 支持引号。
False： 不支持引号。
默认值
11.3.30
True
Skip SAML SSO
<Parameter Name="Skip SAML SSO">False</Parameter>
说明
指定连接到 SAP HANA 数据库时是否跳过单一登录（SSO）的 SAML 实施。
有关单一登录的更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理
员指南》。
值
True： 跳过 SAML。
False： 首先使用 SAML。
默认值
11.3.31
False
SQL External File
<Parameter Name="SQL External File"><filename></Parameter>
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
181
说明
注意
不要编辑此参数。
SQL 外部文件保存数据访问层使用的配置详细信息。
11.3.32
SQL Parameter File
<Parameter Name="SQL Parameter File">oracle</Parameter>
说明
用于存储数据库参数的文件名称。 此文件的扩展名为 .prm。
必须确保此文件与 SBO 配置文件位于相同的目录中。
值
请查看 SBO 文件中的值列表。
默认值
列出的值。
11.3.33
SSO Available
<Parameter Name="SSO Available">False</Parameter>
说明
指定是否支持单一登录（SSO）。
有关单一登录的更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理
员指南》。
值
True： 支持单一登录。
False： 不支持单一登录。
默认值
11.3.34
False
Strategies File
<Parameter Name="Strategies File">oracle</Parameter>
说明
指定策略文件 (.stg) 的名称，不带扩展名。
此文件包含 Universe 设计工具用于自动创建 Universe 的外部策略。 策略文件存储在与
SBO 文件相同的目录中。
182
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
db2 代表 IBM DB2 数据访问驱动程序
值
informix 代表 IBM Informix
oracle 代表 Oracle
sqlsrv 代表 MS SQL Server
sybase 代表 Sybase
teradata 代表 Teradata
默认值
11.3.35
列出的值。
String Max Length
<Parameter Name="String Max Length">32768</Parameter>
指定映射到 ABAP 函数参数（其值的长度等于零）的表列的字符串最大长度。
说明
同时还指定以下类型的表列的最大长度：
●
字符串，并且 OData 数据源的 MaxLength 值为 Max
●
字符串以及以下任意适用于 XML 数据源的类型： anyURI、QName、NOTATION、
duration、gYearMonth、gYear、gMonthDay、gDay、gMonth、
TYPE_NORMALIZEDSTRING、token、language、Name、NCName、XSD_TYPE_ID、
IDREF、IDREFS、ENTITY、ENTITIES
如果大于指定值，返回的数据将被截断。
默认值
32768
相关信息
OData 驱动程序 [第 69 页]
SAP ERP 驱动程序 － 访问 ABAP 函数 [第 85 页]
XML 驱动程序 [第 88 页]
Web 服务驱动程序 [第 100 页]
11.3.36
Temp Data Dir
<Parameter Name="Temp Data Dir">C:\temp\</Parameter>
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
183
说明
指定写到磁盘上的临时数据的目录路径。 如果操作系统未指定任何默认临时文件夹（例
如： C:\Users\<用户名>\AppData\Local\Temp），请使用此参数。
下列数据访问驱动程序可以使用 Temp Data Dir：
●
CSV OpenDriver
●
OData 驱动程序
●
SAP ERP 驱动程序
●
XML 和 Web 服务提供程序
当驱动程序执行 ORDER BY、GROUP BY 或 DISTINCT 操作时，如果要排序的记录数超出
Bucket Split Size 参数值，数据会写到此文件夹。
默认值
该参数已转为注释。 请移除注释语法以启用该参数。
相关信息
本地磁盘用作排序操作的缓存 [第 108 页]
CSV OpenDriver、OData、SAP ERP、XML 和 Web 服务驱动程序能够将本地磁盘用作已排序的行的缓存。
Bucket Split Size [第 173 页]
11.3.37
Transactional Available
<Parameter Name="Transactional Available">Yes</Parameter>
说明
指定针对数据库运行的 SQL 操作是以块事务的形式运行还是分别运行。
默认情况下，SBO 文件中未列出此参数。 如果数据访问驱动程序不支持事务模式，请将其
添加到 SBO 文件。
值
Yes： 提交后，针对数据库的操作将作为块运行。
No： 立即提交每个 SQL 语句，即不使用 Autocommit。
注意
不要使用设置了 Transactional Available=No 的驱动程序访问 SAP
BusinessObjects 资源库。
默认值
184
Yes。 此参数是在 cs.cfg 文件中设置的。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
相关信息
为 IBM Informix 连接设置事务模式 [第 117 页]
使 salesforce.com 连接在 Universe 设计工具中工作 [第 124 页]
11.3.38
Type
<Parameter Name="Type">Relational</Parameter>
说明
注意
不要编辑此参数。
指定数据源类型。
11.3.39
Unicode
\ {3}<Parameter Name="Unicode">UTF8</Parameter>\ {4}
说明
指定访问驱动程序是否能受益于客户端中间件的 Unicode 配置。
此参数显示为 cs.cfg 文件中的驱动程序默认值。 它的值适用于所有数据访问驱动程序。
默认情况下，SBO 文件中未列出此参数。 如果要覆盖默认值，必须将其添加到目标数据访问驱
动程序 SBO 文件的 Defaults 节。
值
UTF8： 8 位 UCS/Unicode 转换格式编码。
CharSet： 字符集编码。
UCS2： 2 字节通用字符集编码。
默认值
11.3.40
cs.cfg 文件中设置的值。
URL Format
<Parameter Name="URL Format "><string></Parameter>
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
185
说明
指定 URL 格式。
JDBC 规范未指定它所需的连接字符串的格式。 供应商使用不同种类的 URL 格式，例如：
●MySQL 供应商：
jdbc:mysql://$DATASOURCE$/$DATABASE$
●Oracle 供应商：
jdbc:oracle:thin:@$DATASOURCE$:$DATABASE$
注意
此函数仅受 JDBC 和 JavaBean 驱动程序文件支持。
值
URL 格式。
默认值
无默认值。
11.3.41
XML Max Size
<Parameter Name="XML Max Size">65536</Parameter>
说明
指定以 XML 格式检索的数据的最大长度。
值
允许的最大 XML 长度（单位为字节）。
默认值
此值因数据库而异。
11.4 JavaBean SBO 参数
这些参数适用于 JavaBean SBO 文件。这些参数用于定义 JavaBean 连接。
这些参数在 \\<connectionserver-install-dir>\connectionServer\javabean\javabean.sbo
文件中定义。
11.4.1
JavaBean Class
<Parameter Name="JavaBean Class"><string></Parameter>
186
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
定义 SAP BusinessObjects 应用程序使用的 JavaBean 的入口点。
说明
入口点是一个从 Bean 接口（通过 com.businessobjects 包指定）扩展的 Java 类的定
义。
值
完全限定的 JavaBean 类名。
默认值
无默认值。
11.5
JCO SBO 参数
这些参数适用于 SAP ERP 数据库技术。它们用于配置与 SAP ERP 系统的连接。
这些参数在 \\<connectionserver-install-dir>\connectionServer\jco\jco.sbo 文件中定义。
11.5.1
ERP Max Rows
<Parameter Name="ERP Max Rows">2147483647</Parameter>
说明
指定在不使用过滤器的情况下对 InfoSet 或 SAP 查询的查询可返回的最大行数。
值
等于或小于 2147483647 的整数。
默认值
2147483647
相关信息
SAP ERP 驱动程序 [第 82 页]
11.6 JDBC SBO 参数
这些参数适用于 JDBC SBO 文件。这些参数用于定义 JDBC 连接。
这些参数在 \\<connectionserver-install-dir>\connectionServer\jdbc 目录下的 SBO 文件中定
义。
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
187
11.6.1
Connection Shareable
<Parameter Name="Connection Shareable">False</Parameter>
说明
注意
不要编辑此参数。
指定连接池中的连接是否可在不同请求者之间共享。 与 Shared Connection 参数结合使
用。
值
True： 连接可以在多位用户之间共享。
False： 连接不能在多位用户之间共享。
默认值
False
相关信息
Shared Connection [第 190 页]
11.6.2
Escape Character Available
<Parameter Name="Escape Character Available">True</Parameter>
说明
指定 JDBC 网络层是否处理 SQL 查询的 like 表达式之后的 escape 子句。 此子句允许用
户指定一个字符，以对特定字符（如下划线 _）进行转义。
True： 支持 escape 子句。
值
False： 不支持 escape 子句。
默认值
11.6.3
True
ForeignKeys Available
<Parameter Name="ForeignKeys Available">True</Parameter>
说明
188
指定是否可检索数据库表的外键。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
值
True： 可以检索外键。
False： 不能检索外键。
默认值
11.6.4
True
Get Extended Column
<Parameter Name="Get Extended Column">No</Parameter>
说明
注意
不要编辑此参数。
指定数据访问层是否使用 Data Federator 查询服务器提供的 getExtendedColumns 存储
过程来检索输入列。
值
Yes： 使用 getExtendedColumns。
No： 不使用 getExtendedColumns。
默认值
11.6.5
No
JDBC Class
<Parameter Name="JDBC Class"><string></Parameter>
说明
JDBC 驱动程序的完全限定的 Java 类。
值
取决于供应商或数据源，例如：
●对用于 Oracle 的 OracleDriver 为 oracle.jdbc
●对于 DB2 为 com.ibm.db2.jcc.DB2Driver
默认值
11.6.6
无默认值。
PrimaryKey Available
<Parameter Name="PrimaryKey Available">True</Parameter>
说明
数据访问指南
SBO 参数参考
指定是否可检索数据库表的主键。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
189
值
True： 可以检索主键。
False： 不能检索主键。
默认值
11.6.7
True
PVL Available
<Parameter Name="PVL Available">True</Parameter>
说明
指定连接是否支持首选查看区域设置（PVL）功能。
此版本中，仅 SAP HANA 连接支持此功能。
True： 支持 PVL。
值
False： 不支持 PVL。
11.6.8
Shared Connection
<Parameter Name="Shared Connection">False</Parameter>
说明
注意
不要编辑此参数。
指定能否共享连接池中请求的连接。 与 Connection Shareable 参数结合使用。 如果
cs.cfg 的 Max Pool Time 参数设置为 0，则不予考虑。
值
True： 连接共享。
False： 连接不共享。
默认值
False
相关信息
Connection Shareable [第 188 页]
Max Pool Time [第 145 页]
190
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
11.6.9
JDBC ResultSet Type
<Parameter Name="JDBC ResultSet Type">1003</Parameter>
说明
注意
此参数必须与 JDBC ResultSet Concurrency 配合使用。 此参数为可选。
指定 createStatement Java 方法的 resultSetType 参数值。
此方法属于接口 java.sql.Connection。 添加此参数可创建默认的 Statement 对象并
微调连接性能。
可以设置标准 Java 值，或者也可以设置特定于数据库的值。 值必须为整数。
值
相关信息
createStatement 方法
ResultSet 界面
11.6.10
JDBC ResultSet Concurrency
<Parameter Name="JDBC ResultSet Concurrency">1007</Parameter>
说明
注意
此参数必须与 JDBC ResultSet Type 配合使用。 此参数为可选。
指定 createStatement Java 方法的 resultSetConcurrency 参数值。
此方法属于接口 java.sql.Connection。 添加此参数可创建默认的 Statement 对象并
微调连接性能。
值
可以设置标准 Java 值，或者也可以设置特定于数据库的值。 值必须为整数。
相关信息
createStatement 方法
ResultSet 界面
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
191
11.7
OData SBO 参数
这些参数用于配置与使用 OData 协议的数据源的连接。
这些参数在 \\<连接服务器安装目录>\connectionServer\odata\odata.sbo 文件中定义。
11.7.1
Enforce Max Protocol Version
<Parameter Name="Enforce Max Protocol Version">Yes</Parameter>
说明
指定驱动程序是否将支持的 OData 协议版本发送给 OData 提供程序。
如果是，OData 提供程序会决定是否以给定协议回答驱动程序。 当 BI 平台连接到使用
OData 3.0 协议时，此参数会非常有帮助。
Yes： 驱动程序发送支持的 OData 协议版本。
值
No： 驱动程序不发送支持的 OData 协议版本。
默认值
Yes
11.8 ODBC SBO 参数
这些参数适用于 ODBC 网络层，用于配置 ODBC 连接。
这些参数在 \\<connectionserver-install-dir>\connectionServer\odbc 子目录下的 SBO 文件中
定义。
11.8.1
CharSet
<Parameter Name="CharSet">ISO88591</Parameter>
说明
注意
不要编辑此参数。
指定通过数据库中间件返回数据的字符集。
值
192
ISO88591： 为 UNIX 上的 HP Neoview 指定的默认字符集值。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
默认值
11.8.2
如果未指定，连接服务器将使用数据库中间件中指定的字符集。
Connection Status Available
<Parameter Name="Connection Status Available">True</Parameter>
说明
指定中间件是否可以检测连接错误（ping 函数）
值
True： 中间件可以检测连接错误。
False： 中间件不能检测连接错误。
默认值
在中间件中设置的值。
11.8.3
Cost Estimate Available
<Parameter Name="Cost Estimate Available">False</Parameter>
说明
指定数据库中间件是否支持在执行 SQL 查询时进行成本估算。 此参数仅用于 Teradata 数
据库。
值
True： 中间件支持成本估算。
False： 中间件不支持成本估算。
默认值
11.8.4
False
Empty String
<Parameter Name="Empty String">EmptyString</Parameter>
说明
指定某些函数（例如 SQL 表）是否接收空字符串或 Null 指针来替换缺少的参数。
值
NullString： 使用 Null 字符串。
EmptyString： 使用空字符串。
默认值
数据访问指南
SBO 参数参考
EmptyString
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
193
11.8.5
ODBC Cursors
<Parameter Name="ODBC Cursors">No</Parameter>
说明
指定 ODBC 游标库是否由数据访问驱动程序使用。 这样有助于提高系统性能。
值
Yes： ODBC 游标库由数据访问驱动程序使用。
No： ODBC 游标库不由数据访问驱动程序使用。
默认值
cs.cfg 文件中设置的值。
11.8.6
SQLDescribeParam Available
<Parameter Name="SQLDescribeParam Available">True</Parameter>
说明
指定中间件是否处理 SQLDescribeParam ODBC 函数。 此函数用于描述存储过程的参
数。 此参数仅用于 IBM Informix 数据库。
值
True： SQLDescribeParam 函数可用。
False： SQLDescribeParam 函数不可用。
默认值
11.8.7
在数据库中间件中设置的值。
SQLMoreResults Available
<Parameter Name="SQLMoreResults Available">True</Parameter>
说明
指定中间件是否处理 SQLMoreResults ODBC 函数。
此函数用于从 SQL 查询检索更多的结果集（如果有）。 此函数仅受 ODBC 驱动程序支持。
值
True： 支持 SQLMoreResults 函数。
False： 不支持 SQLMoreResults 函数。
默认值
11.8.8
在中间件中设置的值。
Use DataDirect OEM Driver
<Parameter Name="Use DataDirect OEM Driver">No</Parameter>
194
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
说明
指定与 MS SQL Server 数据库的连接是否可使用有品牌的 DataDirect ODBC 驱动程序。
值
Yes： 连接可以使用有品牌的驱动程序。
No： 连接不能使用有品牌的驱动程序。
默认值
No
相关信息
关于 DataDirect ODBC 驱动程序 [第 166 页]
11.8.9
V5toV6DriverName
<Parameter Name="V5toV6DriverName">{Informix 3.34 32 BIT}</Parameter>
说明
指定从 Informix Connect 到 Informix ODBC 的转换规则。 此参数的值确定将哪一个
Informix 驱动程序用于定义不带连接字符串的 ODBC 数据源名称（DSN）。 此参数仅用于
IBM Informix 数据库。
值
安装在计算机上的 Informix 驱动程序的确切名称。
默认值
cs.cfg 文件中设置的值。
11.9 OLE DB SBO 参数
这些参数适用于 OLE DB 数据库技术，用于配置 OLE DB 连接。
这些参数在 \\<connectionserver-install-dir>\connectionServer\oledb\oledb.sbo 和
\sqlsrv.sbo 文件中定义。
11.9.1
Enumerator CLSID
<Parameter Name="Enumerator CLSID">MSDASQL Enumerator</Parameter>
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
195
说明
注意
不要编辑此参数。
指定 OLE DB 枚举器的类 ID。 此参数仅用于 OLE DB。
11.9.2
Provider CLSID
<Parameter Name="Provider CLSID">MSDASQL</Parameter>
说明
注意
不要编辑此参数。
指定 OLE DB 提供程序的类 ID。 此参数仅用于 OLE DB。
11.10 OLE DB OLAP SBO 参数
这些参数适用于 OLE DB OLAP 数据库技术，用于为 OLAP 配置 OLE DB 连接。
这些参数在 \\<connectionserver-install-dir>\connectionServer\oledb_olap
\slqsrv_as.sbo 文件中定义。
11.10.1
MSOlap CLSID
<Parameter Name="MSOlap CLSID">msolap.4</Parameter>
说明
注意
不要编辑此参数。
指定 OLE DB 提供程序的类 ID。 此参数仅用于 OLE DB for OLAP。
11.11 Sybase SBO 参数
这些参数适用于 Sybase ASE/CTLIB SBO 文件，用于配置 Sybase ASE/CTLIB 连接。
196
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
这些参数在 \\<connectionserver-install-dir>\connectionServer\sybase\sybase.sbo 文件中
定义。
11.11.1
Driver Behavior
<Parameter Name="Driver Behavior">Dynamic</Parameter>
说明
指定要使用的 Sybase 驱动程序。
值
Dynamic： 使用 ct_dynamic 驱动程序。
设置为其他任意值则表示使用 CTLib 驱动程序。
默认值
11.11.2
Dynamic。
Password Encryption
<Parameter Name="Password Encryption">True</Parameter>
说明
指定是否对“连接详细信息”对话框中输入的密码使用在中间件中指定的加密密码机制。
此参数仅用于 Sybase。 它位于 Defaults 一节中以便将来兼容。
值
True： 使用中间件的加密密码机制。
False： 不使用中间件的加密密码机制。
默认值
11.11.3
cs.cfg 文件中设置的值。
Quoted Identifier
<Parameter Name="Quoted Identifier">False</Parameter>
说明
指定是否支持括起的标识符。 此参数仅受 Sybase 中间件支持。
值
True： 支持引用的标识符。
False： 不支持引用的标识符。
默认值
数据访问指南
SBO 参数参考
False
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
197
11.11.4
Recover Errors
<Parameter Name="Recover Errors">True</Parameter>
说明
指定是否在 ct_dynamic 驱动程序失败后使用客户端库驱动程序。
值
True： 使用客户端库驱动程序。
False： 不使用客户端库驱动程序。
默认值
11.11.5
True
Text Size
<Parameter Name="Text Size">32768</Parameter>
说明
注意
此参数不是必需的。
指定受支持的大型变量长度二进制或字符数据的最大大小。
从 Sybase CTL 数据库检索到的大型变量长度二进制或字符数据只要超过 32 KB 就会被截
断。 将此参数添加到配置文件中相应的 Database 部分，以免数据被截断。
默认值
32768
11.12 Teradata SBO 参数
这些参数适用于 Teradata SBO 文件。这些参数用于配置通过 JDBC 或 ODBC 的 Teradata 连接。
这些参数在 \\<连接服务器安装目录>\connectionServer\jdbc\teradata.sbo 和 \\<连接服务器安装目
录>\connectionServer\odbc\teradata.sbo 两个文件中定义。
11.12.1
Replace Current Owner With Database
<Parameter Name="Replace Current Owner With Database">Yes</Parameter>
说明
指定查询当前所有者的数据源时驱动程序是否返回当前数据库名称。 仅限与 ODBC 连接配
合使用。
198
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
SBO 参数参考
值
Yes： 当前所有者映射到 Teradata 数据库名称。
No： 当前所有者映射到当前用户名。
默认值
No
相关信息
Teradata 连接 － 将 Teradata 数据库映射到当前所有者 [第 134 页]
下节提供 Teradata 连接的配置信息。
数据访问指南
SBO 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
199
12
配置数据库功能参数
12.1
关于数据库功能参数
数据库功能参数描述用作 Universe 内容的数据来源的数据库的功能。可将这些参数设置为在以下级别操作：
●
Universe 级别
在创建或修改 Universe 时设置这些参数。
● 数据库级别
在数据库的 PRM 文件中设置这些参数。这些参数会被 Universe 级别中的相应设置覆盖。
注意
要查看可用于数据访问驱动程序的运算符和函数，可使用 XML 编辑器打开 <驱动程序>.prm 文件。
12.2 关于 PRM 文件
PRM 文件中的参数描述用作 SAP BusinessObjects 应用程序数据源的数据库的功能。 此文件允许依赖于数据
库的因素根据连接和所连接的数据库来控制可用于 Universe 的 SQL。 每个数据库驱动程序都有一个对应的 PRM
文件。
用户也可以在 Universe 内部配置某些 SQL 功能参数。 这些参数将覆盖 PRM 文件设置。
PRM 文件位于以下文件夹中：
●
<ConnectionServer 安装目录>\connectionServer\<RDBMS> 目录，其中 <RDBMS> 是网络层或中间件
的名称。
●
<ConnectionServer 安装目录>\connectionServer\<RDBMS>\extensions\qt 目录。 这些 PRM 文
件称为扩展文件。 有关扩展文件的参数的更多信息，请参阅《信息设计工具用户指南》中的 SQL 和 MDX 参考
章节。
注意
相同目录中还提供了其他语言版本的帮助文本文件。
12.2.1
PRM 参数文件结构
每个受支持的数据库驱动程序都有一个 PRM 文件。 每个文件分为不同节，每个节中包含特定参数。 下表介绍
了每个 PRM 文件节的内容和含义。
200
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据库功能参数
文件节
说明
Configuration
用于描述作为 Universe 数据来源的数据库的功能，例如 EXT_JOIN、ORDER_BY
和 UNION。 这些参数不能直接用于任何 SAP BusinessObjects 产品。
可以编辑这些参数，以便优化依据 Universe（使用目标数据访问驱动程序）运行的
查询。
注意
下一章中对这些参数进行了说明。
DateOperations
Universe 设计工具和信息设计工具可使用的日期运算符，例如，YEAR、QUARTER
和 MONTH。
Universe 设计工具和信息设计工具可使用的运算符，例如，ADD、SUBSTRACT 和
运算符
MULTIPLY。
Universe 设计工 和信息设计工具可使用的函数，例如 Average、Sum 和
函数
Variance。 有关更多信息，请参阅《信息设计工具用户指南》。
当在 Universe 设计工具和信息设计工具中选择本节中的函数时，将出现帮助文本，
这些文本列在文件 <driver><language>.prm 中，例如，oracleen.prm。 可以
在与 <driver>.prm 文件相同的目录中找到该文件。 可以打开该文件以查看
<driver>.prm 文件中提供的所有函数的说明。
Functions 节包含以下子元素：
●
●
Group： 在查询中使用此函数是否会生成 Group By 子句。
○
True 值设定查询生成 Group By 子句。
○
False 值设定查询不生成 Group By 子句。
ID： 此名称出现在 Desktop Intelligence 内的“用户对象”函数列表中。 此版本中已
不再赞成使用。
●
InMacro： 如果此值为 True，则该函数将在 Desktop Intelligence 中的“用户对
象”函数列表内列出。 此版本中已不再赞成使用。
●
Type： 函数数据类型。
●
Arguments： 此函数接受的参数。 一个函数最多只能有四个参数，超出此限制的
参数将不作考虑。
●
SQL： 此函数的 SQL 语法。
相关信息
查看和编辑函数帮助文本文件 [第 203 页]
数据访问指南
配置数据库功能参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
201
12.3 查看和编辑 PRM 文件
1.
浏览到存储目标数据访问驱动程序的 PRM 文件的目录。
PRM 文件存储于 <连接服务器安装目录>\connectionServer\<RDBMS> 目录中。
2.
在 XML 编辑器中打开 <driver>.prm 文件。
3.
根据需要展开各个节。
4.
通过在相应的标记中输入值来设置各个值。
5.
保存并关闭文件。
12.4 验证 PRM 文件的分析函数支持以及添加分析函数支持
PRM 文件中可能不包含目标数据库中的所有可用分析函数。 在使用某个分析函数之前，应验证它是否存在于该文
件中，并在必要时将其添加到列表中。
仅当函数同时作为分析函数和聚合函数时（如 SUM），才需要更新 PRM 文件。
1.
浏览到存储目标数据访问驱动程序的扩展 PRM 文件的目录。
2.
在 XML 编辑器中打开<驱动程序>.prm 文件。
3.
在 Configuration 部分下面，验证是否存在以下参数：
<Parameter Name="OVER_CLAUSE">Y</Parameter>
有关此参数的定义，请参阅《信息设计工具用户指南》。
4.
浏览到存储目标数据访问驱动程序的 PRM 文件的目录。
5.
在 XML 编辑器中打开<驱动程序>.prm 文件。
6.
在 Configuration 部分下面，验证分析函数的 ID 是否在 ANALYTIC_FUNCTIONS 参数值中列出。
7.
如果参数值未列出，请在列表的结尾键入该函数的 ID。
8.
在 Functions 下面，添加 Function 部分，并指定分析函数的 ID、名称、参数类型和 SQL 定义。
<Function Group="False" ID="<函数 ID>" InMacro="False" Name="<函数名称>" Type
=“All">
<Arguments>
<Argument Type="<参数类型>"></Argument>
...
</Arguments>
<SQL><SQL 定义></SQL>
</Function>
记忆
请向同时为分析函数和聚合函数的函数提供不同的名称和 ID。 例如，SUM 作为聚合函数的名称为 SUM。
而 SUM 作为分析函数的名称为 SUM_OVER。
9.
202
保存任何修改并关闭文件。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
配置数据库功能参数
现在，已向信息设计工具添加了一个分析函数的支持。
需要重新启动信息设计工具，对 PRM 文件所做的所有更改才会生效。
相关信息
关于 PRM 文件 [第 200 页]
12.5 查看和编辑函数帮助文本文件
每个函数在 Universe 设计工具或信息设计工具中处于选定状态时出现在该函数下方的帮助文本保留在一个单独
的 XML 文件中。 通过编辑 <driver><language>.prm 文件，可以编辑和添加用于描述函数的文本。 所安装的
每个语言版本的 SAP BusinessObjects 产品都有一个帮助文本文件。
将函数添加到 PRM 文件时，需要将新函数的帮助文本添加到相应的 <driver><language>.prm 文件中，例
如，如果将某个函数添加到 oracle.prm 文件，还要将该函数的函数名称和帮助文本添加到 oracleen.prm 文件
（如果使用的是英文版的工具）。 具体请参见 ISO639-1 标准。
12.6 编辑 PRM 函数的帮助文本
1.
浏览到存储目标数据访问驱动程序的 PRM 语言文件的目录。
PRM 语言文件存储于 <连接服务器安装目录>\connectionServer\<RDBMS> 目录中。
2.
在 XML 编辑器中打开 <驱动程序><语言>.prm 文件。
3.
展开 Messages 节。
4.
要为新函数添加帮助，请执行以下操作：
○
为函数添加一个新节。 完成此操作的最简便的方法是将一个现有函数条目复制到 Function 节。 然后编
辑新函数的文本。
○
5.
6.
为函数输入帮助文本。
要查看或编辑现有函数的帮助文本，请执行以下操作：
○
展开 Function 节。
○
展开某个函数的 Message 节。
○
根据需要编辑帮助文本。
保存并关闭文件。
数据访问指南
配置数据库功能参数
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
203
13
PRM 参数参考
13.1
PRM 文件配置参考
数据库功能参数按字母顺序列出。 要查看函数、日期运算符和其他可用的运算符，请在 XML 编辑器中打开
<driver>.prm 文件，每个参数都定义在以下标记中：
<Parameter Name="<parameter>"><value> </Parameter>
其中，<parameter> 参数的名称，而 <value> 是归属于该参数的值。
显示的每个参数都带有以下信息：
●
该参数如何在 XML 文件中出现的示例
●
该参数的说明
●
可为该参数设置的可能值
●
该参数的默认值（如果有）
注意
某些配置参数绝对不能编辑。 这些参数具有在 SAP BusinessObjects 解决方案中内部使用的值集。 本节中描述
了这些参数，但包含了不要编辑值的警告。 绝对不要编辑这些参数。 在编辑任何其它 PRM 文件参数之前，应对
PRM 文件进行备份。
13.1.1
ANALYTIC_CLAUSE
<Parameter Name="ANALYTIC_CLAUSE">WHEN</Parameter>
说明
指定当 SQL 语句中使用 ANALYTIC_FUNCTIONS 参数中指定的函数时必须使用的 SQL 关
键字。
WHEN：表示使用 WHEN 子句。这是 IBM Red Brick 数据库的默认值。
值
QUALIFY：表示使用 QUALIFY 子句。这是 Teradata 数据库的默认值。
注意
请参阅数据库文档以了解其执行 SQL 子句的方式。
默认值
204
请参阅上面的值。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
PRM 参数参考
相关信息
ANALYTIC_FUNCTIONS [第 205 页]
13.1.2
ANALYTIC_FUNCTIONS
<Parameter Name="ANALYTIC_FUNCTIONS">RANK,SUM,AVG,COUNT,MIN,MAX</Parameter>
说明
列出数据库支持的分析函数。
值
请查看 PRM 文件中的值。
默认值
列出的值。
13.1.3
CALCULATION_FUNCTION
<Parameter Name="CALCULATION_FUNCTION">YES</Parameter>
说明
指定数据库是否支持计算函数。
值
YES：数据库支持计算函数。如果是，信息设计工具将能够创建计算列。
NO：数据库不支持计算函数。
13.1.4
CONSTANT_SAMPLING_SUPPORTED
<Parameter Name="CONSTANT_SAMPLING_SUPPORTED">YES</Parameter>
说明
指定数据库是否支持随机抽样。随机抽样是指从数据集中抽取随机的行。
值
YES：数据库支持随机抽样。
NO：数据库不支持随机抽样。
默认值
13.1.5
YES
DISTINCT
<Parameter Name="DISTINCT">YES</Parameter>
数据访问指南
PRM 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
205
说明
指定数据库是否支持在 SQL 语句中使用 DISTINCT 关键字。此参数用于 MS Access。
值
YES：数据库支持 DISTINCT 关键字。
NO：数据库不支持 DISTINCT 关键字。此行为将禁用以下功能：
●在 Universe 设计工具的“快速设计”向导中单击“查看值”按钮时出现的“不同的值”选项。
●在“查询面板”中使用 Calculation 操作数创建条件时出现的 Countdistinct 函数。
默认值
13.1.6
YES
EXT_JOIN
<Parameter Name="EXT_JOIN">YES</Parameter>
说明
指定数据库是否支持外部联接。 此参数用于所有数据访问驱动程序。
值
YES： 数据库支持外部联接。
NO： 数据库不支持外部联接。 Universe 设计工具的“编辑联接”对话框中的“外部联接”复选
框将不可用。
默认值
13.1.7
YES
FULL_EXT_JOIN
<Parameter Name="FULL_EXT_JOIN">YES</Parameter>
说明
指定数据库是否支持完全外部联接。
值
YES：数据库支持完全外部联接。
NO：数据库不支持完全外部联接。
默认值
13.1.8
YES
GROUP_BY
<Parameter Name="GROUP_BY">NO</Parameter>
说明
206
指定数据库是否支持在 SQL 语句中使用 GROUP BY 子句。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
PRM 参数参考
YES：数据库支持 GROUP BY 子句。
值
NO：数据库不支持 GROUP BY 子句。
13.1.9
GROUP_BY_SUPPORTS_COLUMN_INDEX
<Parameter Name="GROUP_BY_SUPPORTS_COLUMN_INDEX">NO</Parameter>
说明
指定数据库是否支持在 GROUP BY 子句中使用来自 SELECT 语句的列索引。
值
YES：数据库支持使用来自 SELECT 语句的列索引，而不支持列名称。
NO：数据库不支持使用来自 SELECT 语句的列索引，而支持列名称。
默认值
13.1.10
NO
GROUP_BY_SUPPORTS_COMPLEX
Parameter Name="GROUP_BY_SUPPORTS_COMPLEX">NO</Parameter>
说明
指定数据库是否支持在 GROUP BY 子句中使用复杂表达式。复杂表达式是指存在于
SELECT 语句中的列名称或索引以外的其他内容，例如 SELECT 语句中不存在的函数或列。此
参数用于 IBM DB2。
注意
如果运行包含度量对象和复杂对象（即使用函数和拼接的对象）的查询，则应用程序将显示
以下错误消息：“您的数据库不允许您与 <对象名称> 对象进行聚合”。
值
YES：数据库支持在 GROUP BY 子句中使用复杂表达式。
NO：数据库不支持在 GROUP BY 子句中使用复杂表达式。
默认值
13.1.11
NO
GROUP_BY_SUPPORTS_CONSTANT
<Parameter Name="GROUP_BY_SUPPORTS_CONSTANT">YES</Parameter>
说明
指定数据库是否支持在 GROUP BY 子句中使用常量对象。此参数用于 IBM DB2 和
Microsoft SQL Server 数据库。
数据访问指南
PRM 参数参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
207
YES：数据库支持在 GROUP BY 子句中使用常量对象。
值
NO：数据库不支持在 GROUP BY 子句中使用常量对象。
默认值
13.1.12
YES
HAVING
<Parameter Name="HAVING">NO</Parameter>
说明
指定数据库是否支持在 SQL 语句中使用 HAVING 子句。
值
YES：数据库支持 HAVING 子句。
NO：数据库不支持 HAVING 子句。
默认值
13.1.13
NO
INTERSECT
<Parameter Name="INTERSECT">INTERSECT</Parameter>
说明
指定数据库支持用于 INTERSECT 集合运算的关键字。
值
INTERSECT：数据库支持的关键字是 INTERSECT。
无值：数据库不支持在 INTERSECT 集合运算中使用任何关键字。在这种情况下，将生成两
个查询。
默认值
13.1.14
INTERSECT
INTERSECT_ALL
<Parameter Name="INTERSECT_ALL">YES</Parameter>
说明
指定数据库是否支持 INTERSECT ALL 集合运算。
值
YES：数据库支持 INTERSECT ALL 集合运算。
NO：数据库不支持 INTERSECT ALL 集合运算。
默认值
208
YES
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
PRM 参数参考
13.1.15
INTERSECT_IN_SUBQUERY
<Parameter Name="INTERSECT_IN_SUBQUERY">YES</Parameter>
说明
指定数据库是否支持在子查询中使用 INTERSECT 集合运算。
值
YES：数据库支持在子查询中使用 INTERSECT 集合运算。
NO：数据库不支持在子查询中使用 INTERSECT 集合运算。
13.1.16
JOIN
<Parameter Name="JOIN">YES</Parameter>
说明
指定数据库是否支持在两个表之间执行 JOIN 操作。
值
YES：数据库支持在两个表的任意列之间进行联接。
STRUCTURE_JOIN：数据库支持在通过引用约束关联的两个表之间进行联接。在本版本中
等于 NO。
NO：数据库不支持在两个表之间进行联接。
13.1.17
LEFT_EXT_JOIN
<Parameter Name="LEFT_EXT_JOIN">YES</Parameter>
说明
指定数据库是否支持左外部联接。
值
YES：数据库支持左外部联接。
NO：数据库不支持左外部联接。
13.1.18
LEFT_OUTER
<Parameter Name="LEFT_OUTER">$(+)</Parameter>
<Parameter Name="LEFT_OUTER">$*</Parameter>
说明
数据访问指南
PRM 参数参考
指定用于左外部联接表达式的语法。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
209
$(+)：此语法用于 Oracle。
值
$*：此语法用于 Sybase、MS SQL Server 和 IBM Red Brick。
注意
$ 代表联接表达式。
默认值
请参阅上面的值。
示例
在 Oracle 中，如果将 table1.col1 联接到 table2.col2，则生成的表达式为：
table1.col1(+) = table2.col2。
13.1.19
LIKE_SUPPORTS_ESCAPE_CLAUSE
<Parameter Name="LIKE_SUPPORTS_ESCAPE_CLAUSE">YES</Parameter>
说明
指定数据库是否支持在 SQL 语句的 LIKE 条件中使用 ESCAPE 子句。
值
YES：数据库支持在 LIKE 条件中使用 ESCAPE 子句。
NO：数据库不支持在 LIKE 条件中使用 ESCAPE 子句。
默认值
13.1.20
如果未指定此设置，连接服务器将从数据库中间件获取该信息。
MINUS
<Parameter Name="MINUS">MINUS</Parameter>
说明
指定数据库支持用于 MINUS 集合运算的关键字。
值
MINUS：数据库支持 MINUS 集合运算符。
EXCEPT：数据库支持 EXCEPT 集合运算符。
无值：数据库不支持在 MINUS 集合运算中使用任何关键字。在这种情况下，将生成两个查
询。
默认值
13.1.21
MINUS
MINUS_ALL
<Parameter Name="MINUS_ALL">Yes</Parameter>
210
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
PRM 参数参考
说明
指定数据库是否支持 MINUS ALL 集合运算。
值
YES：数据库支持 MINUS ALL 集合运算。
NO：数据库不支持 MINUS ALL 集合运算。
13.1.22
MINUS_IN_SUBQUERY
<Parameter Name="MINUS_IN_SUBQUERY ">YES</Parameter>
说明
指定数据库是否支持在子查询中使用 MINUS 集合运算。
值
YES：数据库支持在子查询中使用 MINUS 集合运算。
NO：数据库不支持在子查询中使用 MINUS 集合运算。
13.1.23
ORDER_BY
<Parameter Name="ORDER_BY">YES</Parameter>
说明
指定数据库是否支持 ORDER BY 子句。
值
YES：数据库支持 ORDER BY 子句。
NO：数据库不支持 ORDER BY 子句。
13.1.24
ORDER_BY_REQUIRES_SELECT
<Parameter Name="ORDER_BY_REQUIRES_SELECT">NO</Parameter>
说明
指定数据库是否需要在 SELECT 语句中引用 ORDER BY 子句中使用的列。
值
YES：不允许用户对 SELECT 语句中未包括的列进行排序。这种情况下，Universe 设计工
具的“查询”面板中的“管理排序”按钮将不可用。
NO：允许用户对列进行排序，即使这些列未包括在 SELECT 语句中。
默认值
数据访问指南
PRM 参数参考
NO
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
211
13.1.25
ORDER_BY_SUPPORTS_COLUMN_INDEX
<Parameter Name="ORDER_BY_SUPPORTS_COLUMN_INDEX">YES</Parameter>
说明
指定数据库是否支持在 ORDER BY 子句中使用来自 SELECT 语句的列索引。
值
YES：数据库支持使用来自 SELECT 语句的列索引，而不支持列名称。
NO：数据库不支持使用来自 SELECT 语句的列索引，而支持列名称。
13.1.26
PERCENT_RANK_SUPPORTED
<Parameter Name="PERCENT_RANK_SUPPORTED">YES</Parameter>
说明
指定数据库是否支持 Percent Rank 分析函数。请参阅数据库文档以了解其实现 Percent
Rank 的方法。
YES：数据库支持 Percent Rank。
值
NO：数据库不支持 Percent Rank。
默认值
13.1.27
YES
RANK_SUPPORTED
<Parameter Name="RANK_SUPPORTED">YES</Parameter>
说明
指定数据库是否支持在 SQL 语句中使用 Rank 分析函数。
值
YES：数据库支持 Rank。
NO：数据库不支持 Rank。
默认值
13.1.28
YES
RIGHT_EXT_JOIN
<Parameter Name="RIGHT_EXT_JOIN">YES</Parameter>
说明
212
指定数据库是否支持右外部联接。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
PRM 参数参考
值
YES：数据库支持右外部联接。
NO：数据库不支持右外部联接。
13.1.29
RIGHT_OUTER
<Parameter Name="RIGHT_OUTER">$(+)</Parameter>
<Parameter Name="RIGHT_OUTER">*$</Parameter>
说明
指定用于右外部联接表达式的语法。
值
$(+)：此语法用于 Oracle。
*$：此语法用于 Sybase、MS SQL Server 和 IBM Red Brick。
注意
$ 代表联接表达式。
默认值
13.1.30
请参阅上面的值。
SEED_SAMPLING_SUPPORTED
<Parameter Name="SEED_SAMPLING_SUPPORTED">YES</Parameter>
说明
值
指定数据库是否支持种子抽样。种子抽样是另一种形式的随机抽样，其随机种子由用户提
供。
YES：数据库支持种子抽样。
NO：数据库不支持种子抽样。
默认值
13.1.31
NO
SELECT_SUPPORTS_NULL
<Parameter Name="NULL_IN_SELECT_SUPPORTED">YES</Parameter>
说明
数据访问指南
PRM 参数参考
指定数据库是否支持将 NULL 作为 SELECT 语句中的一列。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
213
YES：数据库支持将 NULL 作为 SELECT 语句中的一列。
值
NO：数据库不支持将 NULL 作为 SELECT 语句中的一列。
默认值
YES
对于 Teradata、BM DB2、IBM Informix 和 IBM Red Brick 数据库，默认值为 NO，即不支
持将 NULL 值作为列。
13.1.32
SUBQUERY_IN_FROM
<Parameter Name="SUBQUERY_IN_FROM">YES</Parameter>
说明
指定数据库是否支持在 FROM 子句中使用子查询。
值
YES：数据库支持在 FROM 子句中使用子查询。
NO：数据库不支持在 FROM 子句中使用子查询。
13.1.33
SUBQUERY_IN_IN
<Parameter Name="SUBQUERY_IN_IN">YES</Parameter>
说明
指定数据库是否支持在 IN 子句中使用子查询。
值
YES：数据库支持在 IN 子句中使用子查询。
NO：数据库不支持在 IN 子句中使用子查询。
13.1.34
SUBQUERY_IN_WHERE
<Parameter Name="SUBQUERY_IN_WHERE">YES</Parameter>
说明
指定数据库是否支持在 WHERE 子句中使用子查询。
值
YES：数据库支持在 WHERE 子句中使用子查询。
NO：数据库不支持在 WHERE 子句中使用子查询。
214
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
PRM 参数参考
13.1.35
TECHNICAL_COLUMN_NAME_PATTERN
<Parameter Name="TECHNICAL_COLUMN_NAME_PATTERN">^(-idref)(.)*</Parameter>
指定以模式 -idref 开头的所有列不在基于 OData 数据源的 Universe 的连接、数据
说明
基础和业务层中显示。因此，信息设计人员无法用这些列构建查询。
注意
不要编辑此参数。
^(-idref)(.)*
值
13.1.36
UNION
<Parameter Name="UNION">UNION</Parameter>
说明
指定数据库支持用于 UNION 集合运算的关键字。
值
UNION：数据库支持的关键字是 UNION。
无值：数据库不支持在 UNION 集合运算中使用任何关键字。在这种情况下，将生成两个查
询。
默认值
13.1.37
UNION
UNION_ALL
<Parameter Name="UNION_ALL">YES</Parameter>
说明
指定数据库是否支持 UNION ALL 集合运算。
值
YES：数据库支持 UNION ALL 集合运算。
NO：数据库不支持 UNION ALL 集合运算。
13.1.38
UNION_IN_SUBQUERY
<Parameter Name="UNION_IN_SUBQUERY">YES</Parameter>
说明
数据访问指南
PRM 参数参考
指定数据库是否支持在子查询中使用 UNION 集合运算。
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
215
值
YES：数据库支持在子查询中使用 UNION 集合运算。
NO：数据库不支持在子查询中使用 UNION 集合运算。
216
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
PRM 参数参考
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 文件数据类型 [第 218 页]
JDBC 数据类型 [第 218 页]
ODBC 数据类型 [第 221 页]
OData 数据类型 [第 223 页]
数据访问指南
数据类型转换参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
217
OLE DB 数据类型 [第 224 页]
Oracle OCI 数据类型 [第 225 页]
SAP ERP 数据类型 [第 226 页]
SAP HANA 数据类型 [第 227 页]
Sybase CTL 数据类型 [第 228 页]
XML 数据类型 [第 229 页]
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 模式检测 [第 67 页]
14.1.2
JDBC 数据类型
语法：
下表列出了通过 JDBC 显示的数据类型及其在数据基础中的等同数据类型。
218
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据类型转换参考
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、
VARCHAR
NVARCHAR、ROWID、VARCHAR
SQLXML
XML
IBM Informix
下表列出了在用户通过 JDBC 查询 IBM Informix 数据库时可在结果中显示的数据类型及其在数据基础中的等同
数据类型。 这些数据类型将覆盖通用数据类型。
数据访问指南
数据类型转换参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
219
数据基础数据类型
Informix JDBC 数据类型
TIMESTAMP
此数据类型可以映射到下列类型：
●
DATE（如果 Informix 数据类型遵循 DATETIME\
\s+(HOUR|MINUTE|SECOND)\\s+TO\\s+
(HOUR|MINUTE|SECOND) 模式）
●
TIME（如果 Informix 数据类型遵循 DATETIME\\s
+(YEAR|MONTH|DAY)\\s+TO\\s+(YEAR|
MONTH|DAY) 模式）
●
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 类型名称。 这些数据类型将覆盖通用数据类型。
220
数据基础数据类型
Oracle JDBC 数据类型
SQL 类型名称
BFILE
任何值
LONGVARBINARY
任何值
BFILE
LONGVARBINARY
DATE
任何值
TIMESTAMP
任何值
TIMESTAMP
TIMESTAMP
BINARY_DOUBLE
任何值
DOUBLE
OTHER
FLOAT
DOUBLE
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据类型转换参考
数据基础数据类型
Oracle JDBC 数据类型
SQL 类型名称
BINARY_FLOAT
任何值
REAL
任何值
NCHAR
CHAR
NVARCHAR2、ROWID、
UROWID
任何值
14.1.3
VARCHAR
ODBC 数据类型
语法：
下表列出了通过 ODBC 显示的数据类型及其在数据基础中的等同数据类型。
ODBC 数据类型
数据基础数据类型
SQL_BINARY
BINARY
SQL_VARBINARY
VARBINARY
SQL_LONGVARBINARY
LONGVARBINARY
SQL_BIT
BIT
SQL_DATE、SQL_TYPE_DATE
DATE
SQL_DATETIME、SQL_TIME、
TIMESTAMP
SQL_TIMESTAMP、SQL_TYPE_TIME、
SQL_TYPE_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
数据访问指南
数据类型转换参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
221
ODBC 数据类型
数据基础数据类型
SQL_TINYINT
TINYINT
SQL_CHAR、SQL_GUID、SQL_WCHAR
CHAR
SQL_VARCHAR、SQL_WVARCHAR
VARCHAR
IBM DB2
下表列出了在用户通过 ODBC 查询 IBM DB2 数据库时可在结果中显示的数据类型及其数据基础中的等同数据类
型。 这些数据类型将覆盖通用数据类型。
DB2 ODBC 数据类型
SQL_BLOB
SQL_CLOB、SQL_DBCLOB、
SQL_LONGVARGRAPHIC
数据基础数据类型
LONGVARBINARY
LONGVARCHAR
SQL_DECFLOAT
DOUBLE
SQL_GRAPHIC
CHAR
SQL_VARGRAPHIC
VARCHAR
SQL_XML
XML
IBM Informix
下表列出了在用户通过 ODBC 查询 IBM Informix 数据库时可在结果中显示的数据类型及其在数据基础中的等同
数据类型。 这些数据类型将覆盖通用数据类型。
Informix ODBC 数据类型
222
数据基础数据类型
SQL_BIT
SMALLINT
SQL_INFX_UDT_BLOB
LONGVARBINARY
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据类型转换参考
Informix ODBC 数据类型
数据基础数据类型
SQL_TIMESTAMP、SQL_TYPE_TIMESTAMP
此数据类型可以映射到下列类型：
●
DATE（如果 Informix 数据类型遵循 DATETIME\
\s+(HOUR|MINUTE|SECOND)\\s+TO\\s+
(HOUR|MINUTE|SECOND) 模式）
●
TIME（如果 Informix 数据类型遵循 DATETIME\\s
+(YEAR|MONTH|DAY)\\s+TO\\s+(YEAR|
MONTH|DAY) 模式）
●
SQL_INFX_UDT_CLOB
TIMESTAMP（其他情况）
LONGVARCHAR
MS SQL Server
下表列出了在用户通过 ODBC 查询 MS SQL Server 数据库时可在结果中显示的数据类型及其在数据基础中的等
同数据类型。 这些数据类型将覆盖通用数据类型。
MS SQL Server ODBC 数据类型
数据基础数据类型
SQL_SS_TIME2、SQL_SS_TIMESTAMPOFFSET
TIMESTAMP
SQL_SS_XML
XML
14.1.4 OData 数据类型
语法：
下表列出了 OData 数据源内部使用的实体数据模型（EDM）数据类型，以及这些数据类型在数据基础中的等同
类型。
OData 数据类型
数据基础数据类型
Edm.Binary
BINARY
Edm.Boolean
BIT
Edm.DateTime、Edm.Time
TIMESTAMP
注意
不会映射毫微秒。
数据访问指南
数据类型转换参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
223
OData 数据类型
数据基础数据类型
Edm.Int64
BIGINT
Edm.Decimal
DECIMAL
Edm.Double
DOUBLE
Edm.Float、Edm.Single
FLOAT
Edm.Int32
INTEGER
Edm.Byte、Edm.Int16、Edm.SByte
SMALLINT
Edm.DateTimeOffset、Edm.Guid、Edm.String
VARCHAR
14.1.5
OLE DB 数据类型
语法：
下表列出了通过 OLE DB 显示的数据类型及其在数据基础中的等同数据类型。
注意
对于某些数据类型，映射取决于与每个类型关联的 DBCOLUMNFLAGS_ISLONG 和
DBCOLUMNFLAGS_ISFIXEDLENGTH 参数值。
OLE DB 数据类型
数据基础数据类型
DBTYPE_BYTES
VARBINARY
DBTYPE_BYTES（如果
LONGVARBINARY
DBCOLUMNFLAGS_ISLONG=true）
DBTYPE_BYTES（如果
BINARY
DBCOLUMNFLAGS_ISFIXEDLENGTH=true）
224
DBTYPE_BOOL
BIT
DBTYPE_DBDATE
DATE
DBTYPE_DBTIME
TIME
DBTYPE_DBTIMESTAMP
TIMESTAMP
DBTYPE_DECIMAL
DECIMAL
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据类型转换参考
OLE DB 数据类型
数据基础数据类型
DBTYPE_I1、DBTYPE_UI1
TINYINT
DBTYPE_I2、DBTYPE_UI2
SMALLINT
DBTYPE_I4、DBTYPE_UI4
INTEGER
DBTYPE_I8、DBTYPE_UI8
BIGINT
DBTYPE_R4
REAL
DBTYPE_R8
DOUBLE
DBTYPE_CY、DBTYPE_NUMERIC
NUMERIC
DBTYPE_STR、DBTYPE_WSTR
VARCHAR
DBTYPE_STR、DBTYPE_WSTR（如果
LONGVARCHAR
DBCOLUMNFLAGS_ISLONG=true）
CHAR
DBTYPE_STR、DBTYPE_WSTR（如果
DBCOLUMNFLAGS_ISFIXEDLENGTH=true）
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 显示的数据类型及其在数据基础中的等同数据类型。
数据访问指南
数据类型转换参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
225
Oracle OCI 数据类型
数据基础数据类型
SQLT_BIN
BINARY
SQLT_BFILE、SQLT_BLOB、SQLT_LBI
LONGVARBINARY
SQLT_DAT、SQLT_DATE、SQLT_TIME、
TIMESTAMP
SQLT_TIMESTAMP、SQLT_TIMESTAMP_LTZ、
SQLT_TIMESTAMP_TZ
SQLT_CLOB、SQLT_LNG
LONGVARCHAR
SQLT_FLT、SQLT_IBDOUBLE
DOUBLE
SQLT_IBFLOAT
REAL
SQLT_NUM
NUMERIC
SQLT_AFC
CHAR
SQLT_CHR、SQLT_RDD、SQLT_RID
VARCHAR
14.1.7
SAP ERP 数据类型
语法：
下表列出了 SAP ERP 系统使用的 ABAP 数据类型及其在数据基础中的等同数据类型。
226
ABAP 数据类型
数据基础数据类型
HEXADECIMAL
BINARY
DATE
DATE
TIME
TIME
FLOAT
FLOAT
INTEGER
INTEGER
NUMERIC TEXT、PACKED NUMBER
NUMERIC
TEXT
CHAR
VARIABLE LENGTH STRING
VARCHAR
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据类型转换参考
SQL 表达式中的日期格式
在 SQL 表达式编辑器中构建查询时，应用程序用户必须使用的日期格式是 DATE'yyyy-mm-dd'（例如：
DATE'2013-04-10'）。
格式通过 jco.prm 扩展 PRM 文件中的 USER_INPUT_DATE_FORMAT 参数进行指定。 请参阅《信息设计工具
用户指南》。
相关信息
关于 PRM 文件 [第 200 页]
14.1.8 SAP HANA 数据类型
语法：
下表列出了 SAP HANA 数据库中使用的数据类型及其在数据基础中的等同数据类型。 有关 SAP HANA 数据类
型的更多信息，请参阅《SAP HANA Data Type Reference》（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
数据访问指南
数据类型转换参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
227
SAP HANA 数据类型
数据基础数据类型
ALPHANUM、NVARCHAR、SHORTTEXT、
VARCHAR
VARCHAR
相关信息
SAP HANA 数据类型参考
14.1.9 Sybase CTL 数据类型
语法：
下表列出了通过 Sybase CTL 显示的数据类型及其在数据基础中的等同数据类型。
注意
Sybase CTL 数据类型是 CS_DATAFMT 结构的 datatype 字段值，实际上是由网络层提供。 该结构的
usertype 字段值也是为某一些数据类型提供的，而且供数据访问层执行映射时使用。
Sybase CTL 数据类型
Sybase CTL 用户类型
数据基础数据类型
CS_BINARY_TYPE
CS_BINARY_USERTYPE
BINARY
CS_BINARY_TYPE
CS_VARBINARY_USERTYPE 或
VARBINARY
无值
CS_LONGBINARY_TYPE
任何值
VARBINARY
CS_IMAGE_TYPE
任何值
LONGVARBINARY
CS_BIT_TYPE
任何值
BIT
CS_DATE_TYPE
任何值
DATE
CS_BIGDATETIME_TYPE、
任何值
TIMESTAMP
任何值
LONGVARCHAR
CS_BIGTIME_TYPE、
CS_DATETIME_TYPE、
CS_DATETIME4_TYPE、
CS_TIME_TYPE
CS_LONGCHAR_TYPE、
CS_TEXT_TYPE
228
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据类型转换参考
Sybase CTL 数据类型
Sybase CTL 用户类型
数据基础数据类型
任何值
BIGINT
任何值
DECIMAL
任何值
DOUBLE
任何值
INTEGER
CS_NUMERIC_TYPE
任何值
NUMERIC
CS_REAL_TYPE
任何值
REAL
CS_SMALLINT_TYPE、
CS_USMALLINT_TYPE
任何值
SMALLINT
CS_TINYINT_TYPE
任何值
TINYINT
CS_CHAR_TYPE
CS_CHAR_USERTYPE、
CHAR
CS_BIGINT_TYPE、
CS_UBIGINT_TYPE
CS_DECIMAL_TYPE、
CS_MONEY_TYPE、
CS_MONEY4_TYPE
CS_FLOAT_TYPE
CS_INT_TYPE、
CS_UINT_TYPE
CS_NCHAR_USERTYPE 或
CS_UNICHAR_USERTYPE
CS_CHAR_TYPE
CS_VARCHAR_USERTYPE、
VARCHAR
CS_NVARCHAR_USERTYPE、
CS_UNIVARCHAR_USERTYPE、
CS_SYSNAME_USERTYPE 或无值
CS_UNICHAR_TYPE
USER_UNICHAR_TYPE
CHAR
CS_UNICHAR_TYPE
USER_UNIVARCHAR_TYPE 或无
VARCHAR
值
14.1.10 XML 数据类型
语法：
下表列出了 XML 内置数据类型及其在数据基础中的等同数据类型。
XML 内置数据类型
数据基础数据类型
boolean
BIT
数据访问指南
数据类型转换参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
229
XML 内置数据类型
base64Binary、hexBinary
数据基础数据类型
●
BINARY（如果已定义长度）
●
VARBINARY
date
DATE
time
TIME
dateTime
TIMESTAMP
float
FLOAT
double、decimal
DOUBLE
integer、negativeInteger、nonPositiveInteger、
DECIMAL
noNegativeInteger、positiveInteger
long、unsignedLong
BIGINT
int、unsignedInt
INTEGER
short、unsignedShort
SMALLINT
byte、unsignedByte
TINYINT
string
●
CHAR（如果已定义长度）
●
VARCHAR
注意
从 string 派生的数据类型映射到 CHAR 或
VARCHAR。
anySimpleType、anyType、anyURI、duration、
VARCHAR
gDay、gMonth、gMonthDay、gYear、
gYearMonth、NOTATION、QName
映射列元数据
●
是否带符号由数据类型决定。
●
是否可为空由属性 nullable 和 minOccurs 决定。
●
列大小、小数位数和显示大小由数据类型决定。 如果类型未提供任何提示，则会返回用户可配置的最大长度。
230
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
数据类型转换参考
14.2 大型变量长度数据的限制
限制
以下限制仅与 Crystal Reports 应用程序相关。
对于以下数据源，由于数据访问层实现，大型变量长度二进制和字符数据列的最大大小限定为 16 MB：
●
通过 ODBC 访问的 IBM DB2
●
通过 ODBC 访问的 MS SQL Server
●
Sybase CTL
如果应用程序用户向报表中插入的大型变量长度数据超过 16 MB，就可能会影响到系统性能。
14.3 启用多源的 Universe 的数据类型映射
在启用多源的数据基础中，连接服务器数据类型将转换为通过数据联合服务提供的数据类型。
数据联合数据类型包括：
●
BIT
●
DATE
●
TIME
●
TIMESTAMP
●
DOUBLE
●
DECIMAL
●
INTEGER
●
VARCHAR
它们将映射到对应的数据基础数据类型。
警告
BINARY、VARBINARY 和 LONGVARBINARY 类型不受支持，这些类型的值将映射到 NULL。
数据访问指南
数据类型转换参考
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
231
法律角度的重要免责声明
本文档仅为提供信息之用。 其内容如有变更，恕不另行通知，并且 SAP 不保证其内容准确无误。 SAP 不做任何明示或默示的担保，也不做任何适销性、特定用途适应性的
担保。
编码示例
在本文档中包含的任何软件代码和/或代码行/字符串（简称“代码”）仅为示例，并非供在生产性系统环境中使用的。 代码的目的仅在于提供更好的解释和可视化特定编码的
语法和句法规则。 SAP 不担保本文档中所提供的代码的正确性和完整性，并且 SAP 对于由使用代码造成的错误或损害概不负责，除非损害是由 SAP 故意或重大过失造成
的。
辅助功能
SAP 文档中包含的信息代表 SAP 在文档发布之日对辅助功能标准的当前观点，完全不是针对如何确保软件产品的辅助功能方面的具有约束力的准则。 SAP 特别排除针对本
文档的任何责任，并且本文档不形成任何直接或间接的合同义务或承诺。
性别中立语言
SAP 文档尽可能做到性别中立。 依据上下文，或直接用“您”称呼读者，或使用性别中立的名词（诸如：销售人员或工作日）。 但是，如果需要提及两种性别的成员，而又无
法避免使用第三人称单数形式或不存在性别中立的名词，SAP 保留使用名词和代词的阳性形式的权利。 这是为确保文档易于理解。
互联网超链接
SAP 文档中可能包含指向互联网的超链接。 这些超链接意在用做查找相关信息的指引。 SAP 不保证此相关信息的可得性和正确性或此信息符合特定需求的能力。 对于使用
相关信息造成的损害，SAP 不应承担任何责任，除非损害是由于 SAP 的重大过失或有意过错行为造成的。 至于链接的分类，请参阅：http://help.sap.com/disclaimer。
http://help.sap.com/disclaimer.
232
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
数据访问指南
法律角度的重要免责声明
数据访问指南
法律角度的重要免责声明
© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。
233
www.sap.com/contactsap
© 2014 SAP
股份公司或其关联公司版权所有， 保留所有权利。
未经 SAP 股份公司或其关联公司明确许可，不得以任何形式或为任何
目的复制或传播本文的任何内容。 本文包含的信息如有更改，恕不另
行事先通知。
由 SAP 股份公司及其分销商营销的部分软件产品包含其他软件供应商
的专有软件组件。 各国的产品规格可能不同。
上述资料由 SAP 股份公司或其关联公司提供，仅供参考，不构成任何
形式的陈述或保证，其中如若存在任何错误或疏漏，SAP 或其关联公
司概不负责。 与 SAP 或 SAP 关联公司产品和服务相关的保证仅限于该
等产品和服务随附的保证声明（若有）中明确提出之保证。 本文中的
任何信息均不构成额外保证。
SAP 和本文提及的其它 SAP 产品和服务及其各自标识均为 SAP 股份公
司（或 SAP 关联公司）在德国和其他国家的商标或注册商标。 提及的
所有其它产品和服务名称均为其各自公司的商标。
如欲了解更多商标信息和声明，请访问：http://www.sap.com/
corporate-en/legal/copyright/index.epx。
">