Essbase SQL Interface Guide, 9.3.1 Copyright © 1998, 2007, Oracle And/Or Its Affiliates
Total Page:16
File Type:pdf, Size:1020Kb
HYPERION® ESSBASE® – SYSTEM 9 RELEASE 9.3.1 SQL INTERFACE GUIDE Essbase SQL Interface Guide, 9.3.1 Copyright © 1998, 2007, Oracle and/or its affiliates. All rights reserved. Authors: Rosemary Peters The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose. If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party. Contents Chapter 1. Introducing Essbase SQL Interface ............................................... 5 Understanding Essbase SQL Interface ........................................ 5 Preparing for Using SQL or Relational Data Sources ............................. 6 Chapter 2. Configuring a Data Source ..................................................... 7 Configuring a Data Source on Windows ...................................... 7 Configuring a Data Source on UNIX ........................................ 7 Editing the odbc.ini File for Changes ..................................... 8 Example: Editing odbc.ini for DB2 ....................................... 8 Chapter 3. Preparing Multiple-Table Data Sources ............................................ 9 Understanding Multiple-Table Preparation ................................... 9 Understanding Two Methods for Multiple-Table Data Preparation ............... 9 Choosing a Preparation Method ....................................... 11 Understanding Security Requirements ................................... 11 Preparing Data from Multiple Tables ....................................... 11 Chapter 4. Loading SQL Data .......................................................... 13 Understanding Data Loading ............................................. 13 Using Substitution Variables ............................................. 13 Understanding the Rules for Substitution Variables .......................... 14 Creating and Using Substitution Variables ................................ 14 Loading Relational Data Using Essbase SQL Interface ........................... 14 Summary of Steps .................................................. 14 Creating the Data Load Rules File ...................................... 15 Selecting the SQL Data Source ......................................... 15 Creating SQL Queries (optional) ....................................... 15 Loading the Data ..................................................... 16 Chapter 5. Using Non-DataDirect ODBC Drivers ............................................. 17 Configuring a Non-DataDirect Driver ...................................... 17 Creating a Configuration File for Non-DataDirect Drivers ........................ 18 Including the Minimum Required Contents ............................... 18 Contents iii Finding a Driver Name on Windows .................................... 20 Finding a Driver Name on UNIX ....................................... 20 Configuring Non-DataDirect Data Sources ................................... 21 Support for Non-DataDirect Drivers ....................................... 21 Appendix A. Enabling Faster Data Loads from Teradata Data Sources .............................. 23 Installing Required Teradata Software ...................................... 23 Setting Up the Environment for Using Export Operator ......................... 23 Loading Teradata Data Using Teradata Parallel Transporter ...................... 24 Index .............................................................. 25 iv Contents Introducing Essbase SQL 1 Interface In This Chapter Understanding Essbase SQL Interface............................................................................................5 Preparing for Using SQL or Relational Data Sources ............................................................................6 Use this chapter to learn about Essbase SQL Interface and prepare for loading data with it. Understanding Essbase SQL Interface To enable building outline dimensions and loading values from SQL and relational database sources, Oracle's Hyperion® Essbase® – System 9 provides the Essbase SQL Interface feature. You can execute SQL statements on data before loading. For example, using SQL statements to specify the data to retrieve enables you to load summary data instead of the entire contents of the source database. Note: You do not need Essbase SQL Interface for spreadsheet or text file data sources which you can load using Oracle's Essbase® Administration Services, MaxL, or ESSCMD. See the Hyperion Essbase - System 9 Database Administrator's Guide and the Essbase Technical Reference. Essbase SQL Interface works with Administration Services to retrieve data, as follows: 1. Using Administration Services you write a SELECT statement in SQL . 2. Essbase SQL Interface passes it to the SQL or relational database server. For non-SQL data sources, Essbase SQL Interface converts SQL statements to requests for data that the source understands. 3. Essbase SQL Interface interprets the records received from the SQL, or relational database server using the rules defined in the data load rules file. (For more information on data load rules files, see Chapter 4, “Loading SQL Data.”) 4. Essbase SQL Interface loads the interpreted, summary-level data into the database. Understanding Essbase SQL Interface 5 Preparing for Using SQL or Relational Data Sources Essbase SQL Interface is installed during the Essbase Server installation. See the Hyperion Essbase - System 9 Installation Guide for information about initial configuration tasks. ➤ To prepare for using SQL or relational data sources: 1 Configure the ODBC driver and point it to its data source. See Chapter 2, “Configuring a Data Source.” 2 If data is in multiple tables, prepare the data by doing either of these actions: ● Create one table or view in the SQL database before using Essbase SQL Interface. ● Join the tables during the data load by entering a SELECT statement in Administration Services. See “Understanding Multiple-Table Preparation” on page 9 for instructions. 3 Check the data source connection by using Data Prep Editor in Administration Services Console to open the SQL source file. See Chapter 4, “Loading SQL Data.” 4 Create a rules file to tell Essbase SQL Interface how to interpret the SQL data to be used with the Essbase database. See Chapter 4, “Loading SQL Data.” After these steps are complete, you can load data or build dimensions. See Chapter 4, “Loading SQL Data” for instructions. 6 Introducing Essbase SQL Interface 2 Configuring a Data Source In This Chapter Configuring a Data Source on Windows ..........................................................................................7