SAP BusinessObjects Business Intelligence platform Document Version: 4.2 – 2015-11-12 Data Access Guide Content 1 Document History.............................................................12 2 Introduction to the Data Access Guide............................................. 16 2.1 About This Guide...............................................................16 2.2 Audience.....................................................................16 2.3 Key Tasks....................................................................16 2.4 Conventions in This Guide.........................................................17 3 Introduction to Data Access..................................................... 18 3.1 About Connection Server.........................................................18 3.2 Components of a Connection......................................................18 System Architecture..........................................................19 Data Access Drivers.......................................................... 19 3.3 Data Access Configuration Files....................................................20 About the cs.cfg Global Configuration File...........................................20 About the Driver Configuration Files...............................................21 About the OlapClient.cfg Configuration File..........................................22 3.4 Deployment Mode..............................................................22 3.5 Connectivity Services........................................................... 23 3.6 OLAP Connections............................................................. 24 4 Learning Data Access Specifics...................................................25 4.1 64-bit Operating System Support...................................................25 64-bit UNIX Support..........................................................25 64-bit Microsoft Windows Support................................................26 Installation of ODBC Drivers.................................................... 26 4.2 Single Sign-On Support..........................................................27 4.3 Stored Procedures............................................................. 29 Supported Database Capabilities.................................................29 Oracle Stored Procedures......................................................29 To Create a Cursor Inside a Package.............................................. 30 To Create an Oracle Stored Procedure.............................................30 SAP HANA Stored Procedures...................................................31 Teradata Macros.............................................................31 4.4 Connection Pools.............................................................. 32 About Connections of the Pool...................................................32 Connection Pool Mode........................................................33 Checking Middleware Connection Pooling...........................................33 Data Access Guide 2 © 2015 SAP SE or an SAP affiliate company. All rights reserved. Content 4.5 Load Balancing................................................................34 Finding the Best Server........................................................34 Load Balancing Logic.........................................................35 Backward Compatibility....................................................... 35 4.6 Memory Allocation............................................................. 36 To Enable HOARD............................................................36 To Disable HOARD...........................................................36 4.7 Activity in CA Wily Introscope Workstation.............................................36 5 Creating a Connection..........................................................38 5.1 Connection Requirements........................................................38 5.2 Checking Connection Configuration................................................. 38 Displaying Help on the cscheck Tool...............................................39 To Run the cscheck Tool.......................................................40 Check Tool—Function Overview..................................................40 Check Tool— list.............................................................41 Check Tool— driverssearch.....................................................42 Check Tool— find............................................................43 Check Tool— middleware......................................................44 Check Tool— accessdriver..................................................... 45 Check Tool— connectivity......................................................46 Check Tool— ping............................................................47 Check Tool—CMS Information...................................................49 5.3 Creating JDBC Connections.......................................................50 To Create a JDBC Connection with the SBO File.......................................51 JDBC SBO Example File Structure................................................52 To Create a JDBC Connection with Extensions....................................... 52 To Create a Generic JDBC Connection.............................................53 JAR File Location Reference.................................................... 54 To Find the Version of a JDBC Driver.............................................. 57 5.4 Creating JavaBean Connections....................................................57 To Create a JavaBean Connection................................................58 JavaBean SBO Example File Structure.............................................59 To Create a JavaBean Connection with Extensions.................................... 59 5.5 Creating ODBC Connections...................................................... 60 To Create a Generic ODBC Connection.............................................61 To Create a Generic ODBC3 Connection............................................62 5.6 To Add a New Driver After a Patch Installation..........................................64 5.7 To Set the Locale in a Multiple Data Sources Workflow....................................64 6 X509 Certificate Based Authentication.............................................66 6.1 For OData and Web Services with one-way Authentication................................. 66 Data Access Guide Content © 2015 SAP SE or an SAP affiliate company. All rights reserved. 3 7 Data Access Driver Reference....................................................67 7.1 Data Access Drivers.............................................................67 7.2 CSV OpenDriver............................................................... 67 CSV OpenDriver Capabilities....................................................68 CSV OpenDriver - Table Mapping.................................................68 CSV File Location............................................................70 CSV Schema Detection........................................................70 7.3 OData Driver..................................................................72 OData Driver Capabilities...................................................... 73 OData Service Location........................................................74 OData Service Example........................................................74 OData Driver - Mapping Namespace, Owner and Qualifier................................75 OData Driver - Mapping Tables...................................................76 OData Driver - Mapping Columns.................................................77 OData Driver - Mapping Keys....................................................77 OData Driver - Mapping Documentation Elements.....................................79 OData Driver - Mapping Entities of Derived Types..................................... 79 Monitoring the OData Driver Performance..........................................80 OData Driver - Nontrivial Behaviors and Restrictions...................................83 OData Driver - Configuring Column Maximum Size.................................... 84 Authenticating OData Sources...................................................84 Tracing the OData Driver Activity.................................................85 7.4 SAP ERP Driver................................................................85 SAP ERP Driver Capabilities.................................................... 86 SAP ERP Driver - Access to InfoSets and SAP Queries..................................86 SAP ERP Driver - Access to ABAP Functions.........................................88 SAP ERP Driver Restrictions.................................................... 91 7.5 XML Driver................................................................... 91 XML Driver Capabilities........................................................92 XML File Location............................................................92 XML Document and Schema Example............................................. 93 XML Driver - Mapping Multiple Files...............................................95 XML Driver - Mapping Tables....................................................95 XML Driver - Mapping Columns..................................................96 XML Driver - Mapping Primary and Foreign Keys......................................97 XML Driver - Mapping Mixed Elements.............................................99