Teradata Aggregate Designer. User Guide

Transcription

1 Teradata Aggregate Designer User Guide Release B A June 2012

2 The product or products described in this book are licensed products of Teradata Corporation or its affiliates. Teradata, Active Enterprise Intelligence, Applications-Within, Aprimo, Aprimo Marketing Studio, Aster, BYNET, Claraview, DecisionCast, Gridscale, Managing the Business of Marketing, MyCommerce, Raising Intelligence, Smarter. Faster. Wins., SQL-MapReduce, Teradata Decision Experts, Teradata Labs Logo, Teradata Raising Intelligence Logo, Teradata Source Experts, WebAnalyst, and Xkoto are trademarks or registered trademarks of Teradata Corporation or its affiliates in the United States and other countries. Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc. AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc. Data Domain, EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation. GoldenGate is a trademark of Oracle. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Intel, Pentium, and XEON are registered trademarks of Intel Corporation. IBM, CICS, RACF, Tivoli, and z/os are registered trademarks of International Business Machines Corporation. Linux is a registered trademark of Linus Torvalds. LSI is a registered trademark of LSI Corporation. Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries. NetVault is a trademark or registered trademark of Quest Software, Inc. in the United States and/or other countries. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates. QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademark of SPARC International, Inc. Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States and other countries. Unicode is a registered trademark of Unicode, Inc. in the United States and other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product and company names mentioned herein may be the trademarks of their respective owners. THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN AS-IS BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The information contained in this document may contain references or cross-references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services available in your country. Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without notice. To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please teradata-books@lists.teradata.com. Any comments or materials (collectively referred to as Feedback ) sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback. Copyright by Teradata Corporation. All Rights Reserved.

3 Preface Purpose Teradata Aggregate Designer provides a simplified method to recommend and design Aggregate Join Indexes (AJIs) to support Teradata Relational Online Analysis Process (ROLAP), providing optimal integration between business intelligence (BI) tools and Teradata Database. This user guide provides information about Teradata Aggregate Designer, a Teradata Tools and Utilities product. Teradata Tools and Utilities are a group of products designed to work with Teradata Database. Teradata Aggregate Designer is an asynchronous product release. It is not directly tied to, sold with, or bundled with Teradata Database or Teradata Tools and Utilities releases. Audience This book is intended for use by: Teradata Database administrators Business Intelligence (BI) administrators Other technical personnel who use Teradata Schema Workbench, and Teradata OLAP Connector Supported Releases This book supports the following releases: Teradata Database versions 12.0, 13.0, 13.10, and 14.0 Teradata Aggregate Designer Specifically, Teradata Aggregate Designer supports the following Teradata Database versions: or later or later or later or later If the version of JRE 6 on your Teradata Database system is update 20 or 21, upgrade to the latest version. Teradata Aggregate Designer User Guide 3

4 Preface Prerequisites Prerequisites The following prerequisite knowledge is required for this product: Basic concepts of Teradata Database Connectivity software, such as JDBC Multidimensional modeling concepts Relational database management systems ROLAP and Teradata optimization concepts Teradata AJI, PI (primary index), and PPI (partitioned primary index) functionality Teradata SQL Changes to This Book The following changes were made to this book in support of the current release. Changes are marked with change bars. Portions of this document are based upon materials under license from Pentaho Corporation. Pentaho Corporation is not endorsing Teradata or its products. Date and Release March Description Removed all instances of Teradata Business Intelligence Optimizer Updated release information and Chapter 1: Overview Updated information and screenshots to account for changes in Chapter 2: Teradata Aggregate Designer Window. Updated information about the Preview dialog box. For information, see Export Aggregates on page 39. Documented new AJI Explorer feature in Chapter 3. Additional Information Additional information that supports this product and Teradata Tools and Utilities is available at the web sites listed in the table that follows. 4 Teradata Aggregate Designer User Guide

5 Preface Additional Information Type of Information Description Access to Information Release overview Late information Additional product information CD-ROM images Ordering information for manuals Use the Release Definition for the following information: Overview of all of the products in the release Information received too late to be included in the manuals Operating systems and Teradata Database versions that are certified to work with each product Version numbers of each product and the documentation for each product Information about available training and the support center Use the Teradata Information Products web site to view or download specific manuals that supply related or additional information to this manual. Access a link to a downloadable CD-ROM image of all customer documentation for this release. Customers are authorized to create CD-ROMs for their use from this image. Use the Teradata Information Products web site to order printed versions of manuals. 1 Go to 2 Under Online Publications, click General Search. 3 Type 4104 in the Publication Product ID box. 4 Click Search. 5 Select the appropriate Release Definition from the search results. 1 Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Do one of the following: For a list of Teradata Tools and Utilities documents, click Teradata Tools and Utilities, and then select an item under Releases or Products. Select a link to any of the data warehousing publications categories listed. Specific books related to Teradata Aggregate Designer are as follows: Teradata JDBC Driver User Guide B Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Click CD-ROM Images. 4 Follow the ordering instructions. 1 Go to 2 Under Print & CD Publications, click How to Order. 3 Follow the ordering instructions. Teradata Aggregate Designer User Guide 5

6 Preface Additional Information Type of Information Description Access to Information General information about Teradata The Teradata home page provides links to numerous sources of information about Teradata. Links include: Executive reports, case studies of customer experiences with Teradata, and thought leadership Technical information, solutions, and expert advice Press releases, mentions, and media resources 1 Go to Teradata.com. 2 Select a link. 6 Teradata Aggregate Designer User Guide

7 Table of Contents Preface Purpose Audience Supported Releases Prerequisites Changes to This Book Additional Information Chapter 1: Overview What is Teradata Aggregate Designer? Minimum and Recommended System Requirements Teradata JDBC Driver Java Operating Systems System Hardware Chapter 2: Teradata Aggregate Designer Window Overview Main Menu and Toolbar Server Connection Status Bar Aggregate Join Index Pane Space Cost Chart Edit Aggregate Definition Pane Teradata Aggregate Designer User Guide 7

8 Table of Contents Chapter 3: AJI Explorer Window Overview AJI Filter Options AJI s DDL View DBQL Filter Options Assisted SQL View Unassisted SQL View Query Logging Chapter 4: Using Teradata Aggregate Designer Start Teradata Aggregate Designer Define the Data Source Extra Parameters Define the Cube Define and Refine the AJI Aggregate Join Index Advisor Expert Mode Customize a recommendation Export Aggregates Save Design Work Glossary Index Teradata Aggregate Designer User Guide

9 List of Figures Figure 1: Teradata Aggregate Designer Window Figure 2: Server Connection Status Bar Figure 3: Aggregate Join Index Pane Figure 4: Space Cost Chart Figure 5: Edit Aggregate Definition Pane Aggregation Levels Tab Figure 6: Edit Aggregate Definition Pane Measures Tab Figure 7: Edit Aggregate Definition Pane AJI Options Tab Figure 8: AJI Explorer Window Figure 9: AJI Explorer: AJI Filter Options Region Figure 10: AJI Explorer: DBQL Filter Options Figure 11: Assisted SQL View Figure 12: Unassisted SQL View Teradata Aggregate Designer User Guide 9

10 List of Figures 10 Teradata Aggregate Designer User Guide

11 List of Tables Table 1: System Hardware Requirements Table 2: File Menu Table 3: Tools Menu Table 4: Help Menu Table 5: Window Toolbar Buttons Table 6: Aggregate Join Index Pane Toolbar Buttons Table 7: AJI Explorer: AJI Display Columns Table 8: AJI Explorer: DBQL Filter Options Teradata Aggregate Designer User Guide 11

12 List of Tables 12 Teradata Aggregate Designer User Guide

13 CHAPTER 1 Overview Teradata Aggregate Designer provides a user-friendly GUI for designing, recommending, and publishing AJIs on Teradata Database in support of ROLAP implementations. An AJI is an aggregate result set saved as an object in the database. Transparent to end-users and BI administrators, AJIs allow the Teradata Database system to get requested data from an index instead of accessing and joining underlying base tables. An AJI defined to fully satisfy a query eliminates the need to access multiple base tables, perform joins and aggregates, or redistribute the rows of very large tables each time the query is run. Browse through these topics to learn more: What is Teradata Aggregate Designer? Minimum and Recommended System Requirements What is Teradata Aggregate Designer? Teradata Aggregate Designer performs the following activities: 1 Consumes the multidimensional data definition from a BI OLAP engine and connects to Teradata Database. 2 Validates the cube schema definitions supported by Teradata Aggregate Designer. 3 Validate correlated physical model in Teradata Database for creation of AJIs. If the physical model is not suitable for AJI creation, the tool will provide specific recommendations and instructions on how to correct the problem. 4 Design AJIs using one or both of the following methods: Access the Teradata Aggregate Designer Advisor, which recommends aggregate structure designs. Create and populate custom aggregate structures. Teradata Aggregate Designer also edits, saves, and executes AJI definitions and allows users to specify additional optimization techniques such as the use of PIs and PPIs. Use the Calculate Cost button to graph one or more AJIs in the Space Cost Chart. 5 Construct DDL (Create AJI) to implement the AJIs. 6 Validates the DDL statement and executes it against Teradata Database to create the AJI. 7 Provides AJI Explorer, which enables the following: Browsing, viewing, and deleting AJIs in the target Teradata Database system Teradata Aggregate Designer User Guide 13

14 Chapter 1: Overview Minimum and Recommended System Requirements Beginning, ending, clearing and displaying Teradata Database Query Logging with SQL and OBJECTS Defining a SQL workload to consider based on DBQL filter options Calculating SQL query usage (references) of AJI columns Calculating and displaying SQL Queries assisted or unassisted by deployed AJIs Gathering statistics on captured query logs Gathering statistics and calculating Average CPU Time, Elapsed Time, IO Count for a set of queries Minimum and Recommended System Requirements Teradata JDBC Driver Before installing Teradata Aggregate Designer, ensure that the system has the following minimum hardware and software configuration. Teradata Aggregate Designer includes Teradata JDBC Driver Release with the installation package. For instructions, see the Teradata Aggregate Designer Release Definition. Java Teradata Aggregate Designer requires Java Standard Edition (SE) Java Runtime Environment (JRE) version 5 or later. Operating Systems System Hardware Teradata Aggregate Designer can be installed on the Microsoft Windows operating system. Windows 7 Windows Vista SP1 Windows Server 2008 Standard Windows Server 2008 R2 Windows Server 2003 Standard SP2 Windows XP SP3 Table 1 shows the minimum and recommended values for CPU speed, disk storage, and system memory for Teradata Aggregate Designer. 14 Teradata Aggregate Designer User Guide

15 Chapter 1: Overview Minimum and Recommended System Requirements Table 1: System Hardware Requirements Category Minimum Value Recommended Value Disk Space 1 GB 10 GB CPU 1 GHz (single core) 1.5 GHz (multi-core) RAM 1 GB 2 GB Teradata Aggregate Designer User Guide 15

16 Chapter 1: Overview Minimum and Recommended System Requirements 16 Teradata Aggregate Designer User Guide

17 CHAPTER 2 Teradata Aggregate Designer Window The Teradata Aggregate Designer interface includes a menu bar, toolbars, and panes. This chapter is divided into the following topics: Overview Main Menu and Toolbar Server Connection Status Bar Aggregate Join Index Pane Space Cost Chart Edit Aggregate Definition Pane Overview Figure 1 shows the Teradata Aggregate Designer window with data and all controls active. The information in the window and the controls that are available depend on the tasks being performed. A data source is connected, and a schema and cube are loaded. This status is viewable on the server connection status bar. The selected AJIs (the check box controls are checked) are graphed in the Space Cost Chart. Verify the number of selected aggregates with the Selected Aggregates total that appears to the right of the chart. The information appearing in the Edit Aggregate Definition pane is for the highlighted row in the Aggregate Join Index pane. Teradata Aggregate Designer User Guide 17

18 Chapter 2: Teradata Aggregate Designer Window Main Menu and Toolbar Figure 1: Teradata Aggregate Designer Window Main Menu and Toolbar The main menu bar and toolbar are located at the top of the Teradata Aggregate Designer window. Table 2 describes the File menu options. Table 2: File Menu Command New Open Save Save As Export and Publish Show Log File Exit Description Opens the Connect to Data Source dialog box. Opens a previously saved file. Saves the design in a file. Saves the design with a new filename. Previews and exports the AJI DDL. The DDL can also be previewed by using the Export and Publish button s Preview tab. Displays the internal debug log. Exits Teradata Aggregate Designer. Table 3 describes the Tools menu. 18 Teradata Aggregate Designer User Guide

19 Chapter 2: Teradata Aggregate Designer Window Main Menu and Toolbar Table 3: Tools Menu Command Validate Schema Check PK/FK Hard Data Explore AJIs Description Validates correlated relational database tables, columns, and relationships. Checks populated underlying data based on the relationships defined in the Cube Schema. Opens the AJI Explorer. The main menu bar and tool bar are located at the top of the Teradata Aggregate Designer window. Table 4 describes the Help menu. Table 4: Help Menu Command Show User Guide About Description Displays this user guide. Displays Teradata Aggregate Designer version information. The main menu bar and tool bar are located at the top of the Teradata Aggregate Designer window. Table 5 describes the toolbar buttons not associated with the File or Help menus. Table 5: Window Toolbar Buttons Button Description Opens the Connect to Data Source dialog box. Opens a previously saved file. Saves the design in a file. Saves the design with a new filename. Opens the Connect to Data Source dialog box. Starts the Teradata Aggregate Designer Advisor. Opens the Export and Publish dialog box. Opens the Preview dialog box with the Create Join Index tab displaying the AJI DDL. Teradata Aggregate Designer User Guide 19

20 Chapter 2: Teradata Aggregate Designer Window Server Connection Status Bar Table 5: Window Toolbar Buttons (continued) Button Description Validates correlated relational database tables, columns, and relationships. Checks on populated underlying data based on the relationships defined in the Cube Schema. Opens the AJI Explorer. Server Connection Status Bar The server connection status bar is located in the lower portion of the Teradata Aggregate Designer window and displays information about the database connection, schema, and cube. Figure 2 shows a representative example of the server connection status bar when connected. Figure 2: Server Connection Status Bar Two icons are used to depict connection status: Teradata Aggregate Designer is connected to a database. Teradata Aggregate Designer is disconnected to a database. Aggregate Join Index Pane The Aggregate Join Index pane is located in the right pane of the window. Defined aggregates display in a tabular format. Figure 3 shows a populated Aggregate Join Index pane. Figure 3: Aggregate Join Index Pane Use the toolbar buttons to choose and arrange aggregates to display in the Space Cost Chart. Table 6 describes the Aggregate Join Index pane toolbar buttons. 20 Teradata Aggregate Designer User Guide

21 Chapter 2: Teradata Aggregate Designer Window Space Cost Chart Table 6: Aggregate Join Index Pane Toolbar Buttons Button Description Clicking the cleared check box button clears all AJI rows below. Clicking the checked check box button selects all AJI rows below. Selecting an AJI row includes the associate AJI in the Space Cost Chart calculations, designates it as a candidate for export and publish, and enables viewing DDL. Moves the highlighted AJI row up in the table list. Moves the highlighted AJI row down in the table list. Adds a new AJI row to the table list. Settings for the new AJI are defined and edited in the Edit Aggregate Definition Pane. Deletes the highlighted AJI row from the table list. Calculates the cost of a selected AJI in terms of fact table rows and disk space. After a calculation completes, results display in the Space Cost Chart. When an AJI row in the Aggregate Join Index pane is highlighted its information can be edited in the Edit Aggregate Definition Pane. Only one row can be highlighted at a time. A highlighted row can also be deleted using the Remove button. Space Cost Chart The Space Cost chart is located in the upper right of the window. When rows in the Aggregate Join Index Pane are selected, the Space Cost Chart appears. The Space Cost Chart provides a high level comparison of the estimated space utilization of all currently selected aggregates relative to the space utilization of the fact table. The space cost scale is an indicator of the impact in terms of disk space needed to create the selected aggregate recommendations. Figure 4 shows an example of the Space Cost Chart. Figure 4: Space Cost Chart Teradata Aggregate Designer User Guide 21

22 Chapter 2: Teradata Aggregate Designer Window Edit Aggregate Definition Pane Edit Aggregate Definition Pane The Edit Aggregate Definition pane is located in the lower left portion of the window. When a row in the Aggregate Join Index pane is highlighted, the Aggregation Levels and other information can be viewed and changed in the Edit Aggregate Definition pane. Refer to the following figures for a brief description of each tab on the Edit Aggregate Definition pane: Figure 5 shows the Aggregation Levels tab. Figure 6 shows the Measures tab. Figure 7 shows the AJI Options tab. Figure 5: Edit Aggregate Definition Pane Aggregation Levels Tab When a row is highlighted in the Aggregate Join Index Pane, use the drop down arrows in the Aggregation Levels tab to change the hierarchy levels for the row. The Apply and Reset buttons are not active until a change is made. Figure 6: Edit Aggregate Definition Pane Measures Tab 22 Teradata Aggregate Designer User Guide

23 Chapter 2: Teradata Aggregate Designer Window Edit Aggregate Definition Pane To add or remove a measure from the AJI, check or uncheck the appropriate check box beside the measure name. Use the check boxes to select or deselect measures listed in Measure Name. Click Apply to save the changes to the selected AJI. Figure 7: Edit Aggregate Definition Pane AJI Options Tab To add Index Key Columns, click Add and select the appropriate Key Column check boxes. Use the Partitioned Primary Index Expressions SQL text area to specify the partitioning expression. Click Apply to save the changes to the selected AJI. To validate the selected AJI, click the Validate button. The Syntax Validation Result message box appears. If the AJI is valid, the message box contains the Syntax Checked with No Errors line. If the AJI is not valid, an error displays in the first line. Teradata Aggregate Designer User Guide 23

24 Chapter 2: Teradata Aggregate Designer Window Edit Aggregate Definition Pane 24 Teradata Aggregate Designer User Guide

25 CHAPTER 3 AJI Explorer Window Access the AJI Explorer window from the Aggregate Designer window.this chapter includes the following main sections: Overview AJI Filter Options DBQL Filter Options Assisted SQL View Query Logging Overview Use AJI Explorer to analyze query behavior and AJI effectiveness. Use AJI Filter Options to select AJIs from a list based on specified criteria. Use DBQL Filter Options to select a SQL workload for gathering AJI column usage statistics, and statistics on individual SQL query statements which are assisted or unassisted by deployed AJIs. To open the AJI Explorer window From the Teradata Aggregate Designer window, click Explore AJIs. Teradata Aggregate Designer User Guide 25

26 Chapter 3: AJI Explorer Window AJI Filter Options Figure 8: AJI Explorer Window File menu AJI filter options Filtered AJI list DBQL filter options Filtered DBQL statistics Status bar Filtered DBQL list Query logging status 4103A00 AJI Filter Options Use the AJI filter options to get specific AJIs based on selected criteria. Select all or individual AJIs to view the AJI s DDL and determine its effectiveness. For more information, see AJI s DDL View on page 27. Once the AJIs have been selected, you can specify DBQL Filter Options to get performance statistics. Figure 9: AJI Explorer: AJI Filter Options Region Table 7: AJI Explorer: AJI Display Columns Command Description AJI filter options Database (list) Username AJI name Select a listed Teradata Database to filter AJI by database. Select a listed username to filter by user assigned to the selected database. Type a specific AJI name in the text field. 26 Teradata Aggregate Designer User Guide

27 Chapter 3: AJI Explorer Window AJI Filter Options Table 7: AJI Explorer: AJI Display Columns (continued) Command Creation Date Start Date End Date Refresh Get AJIs Description Select this check box to enable creation date filtering. Filter by AJIs created on or after this start date in the format YYYY-DD-MM 00:00:00. Filter by AJIs created between on or preceding this end date in the format YYYY-DD-MM 00:00:00. Refreshes the list of databases/users since the previous AJI filter run or refresh. Lists AJIs based on selected AJI filter options. If no AJIs are associated with the filter options specified, a message appears. Aggregate Join Index results Specify listed AJIs for view, delete, and determine AJI effectiveness. Clicking the cleared check box button clears all check boxes, which enables selecting specific AJIs to modify and monitor. Clicking the checked box button selects all AJI associated with the AJI Filter Options selected. View Delete Aggregate Join Index Name Database Timestamp Created By Size(GB) TAD Version Launches the AJI s DDL window. For more information, see AJI s DDL View on page 27. Delete the selected AJI(s). Lists the name of each AJI based on the selected AJI filtering criteria. Indicates the database in which the AJI is present. Indicates the AJI creation timestamp. Lists the username of the user who created the AJI. Lists the size of the AJI in gigabytes. Lists the version of Teradata Aggregate Designer used to create this AJI. AJI s DDL View The AJI s DDL view displays the data dictionary language (DDL) of the selected AJI in the list of filtered results. To Launch the AJI s DDL View 1 Set AJI Filter Options, and click Get AJIs. 2 Select one or more AJIs. 3 Click View. Teradata Aggregate Designer User Guide 27

28 Chapter 3: AJI Explorer Window DBQL Filter Options The AJI s DDL view displays the DDL of each specified AJI. You can perform the following tasks from this view: Click Copy to clip board to copy the DDL for pasting into another application. Note: If pasting results into MS Excel, the cells truncate values larger than 32 kb. This is a known MS Excel limitation. Click Save to save the DDL as a file. Click Cancel to close the AJI s DDL view. DBQL Filter Options Once you have selected AJIs based on the AJI filter options, you can define a SQL workload to consider by filtering the Database Query Log (DBQL) contents. This workload can be used to analyze the specified SQL for AJI Usage frequency. Figure 10: AJI Explorer: DBQL Filter Options Table 8: AJI Explorer: DBQL Filter Options Command Period filter Start date End date Queryband Username Application ID ClientID Client IP Address Description Select this check box to enable period date filtering. Filter by number of SQL hits on or after this date in the format YYYY-DD-MM 00:00:00. Filter by number of SQL hits on or preceding this date in the format YYYY-DD-MM 00:00:00. Enables filtering by query band. Enables filtering by user name. Enables filtering by application ID. Enables filtering by client ID. Enables filtering by Client IP Address. 28 Teradata Aggregate Designer User Guide

29 Chapter 3: AJI Explorer Window DBQL Filter Options Table 8: AJI Explorer: DBQL Filter Options (continued) Command Get statistics Assisted SQL Unassisted SQL Description Display results of filtered DBQL criteria in the list. AJI results display in four columns: Aggregate Join Index Name - AJI name. Database - Lists the database associated with the AJI. References - Total number of AJI references. SQL Hits - Total number of assisted SQL hits on the AJI. Displays details for each SQL query assisted by the set of AJIs being considered. For more information, see Assisted SQL View on page 29. Displays details for each SQL query unassisted by the set of AJIs being considered. For more information, see Unassisted SQL View on page 30. Assisted SQL View The Assisted SQL view displays AJI-assisted SQL queries, including AJI name, Query id, query text, elapsed time, total IO count, CPU processing time, name of the user who ran the query, application, client, and IP address. You can click the header row of each column to sort by that value. To view a smaller number of results, select Randomly sample, type a number, and click Submit. The specified number of random results display in the view. Select an AJI and click the Export All button to save the assisted SQL to a text file. Figure 11: Assisted SQL View Teradata Aggregate Designer User Guide 29

30 Chapter 3: AJI Explorer Window Query Logging Unassisted SQL View The Unassisted SQL view displays SQL queries not assisted by an AJI, including the query id, query text, elapsed time, total IO count, CPU processing time, name of the user who ran the query, application, client, and IP address. You can click the header row of each column to sort by that value. To view a smaller number of results, select Randomly sample, type a number, and click Submit. The specified number of random results display in the view. Figure 12: Unassisted SQL View Query Logging Use the Query Logging window to enable/disable DBQL logging of SQL queries. See DBQL Filter Options on page 28 for information on how to filter DBQL logging. You can specify logging all users, choose a specific user on which to log a query, and log queries by application. To start query logging 1 From the File menu, select Query logging. The Query logging view appears. 30 Teradata Aggregate Designer User Guide

31 Chapter 3: AJI Explorer Window Query Logging 2 Choose one of the following: To log queries for all users, select All users. To log queries for one or more users, select one or more usernames from the list. Note: Account(s) list can enter any associated Accounts for the selected user to apply logging on the user based on the selected Accounts. To log queries by application, check Select application, and type an application name, such as EXCEL, in the text field. 3 Click Begin. Query logging begins as selected. The lower right corner displays the following text: Query logging is on. 4 Click Display to view query logging details, such as text size limit and what is being logged. Note: To clear a query log, click Clear. Teradata Aggregate Designer User Guide 31

32 Chapter 3: AJI Explorer Window Query Logging 32 Teradata Aggregate Designer User Guide

33 CHAPTER 4 Using Teradata Aggregate Designer This chapter defines tasks accomplished using Teradata Aggregate Designer. Browse through these topics to learn more: Start Teradata Aggregate Designer Define the Data Source Define the Cube Define and Refine the AJI Export Aggregates Save Design Work Start Teradata Aggregate Designer Teradata Aggregate Designer is a Java application. Batch files are provided for Windows. To start Teradata Aggregate Designer From the Windows Start menu, select Programs or All Programs, and then click Teradata Client > Teradata Aggregate Designer > Teradata Aggregate Designer. Define the Data Source To design an AJI, first establish a connection with Teradata Database. The following procedure assumes a typical JDBC connection to Teradata Database. If working with an atypical configuration, refer to Extra Parameters on page 35 to define additional parameter-related values for the JDBC driver. Teradata Aggregate Designer User Guide 33

34 Chapter 4: Using Teradata Aggregate Designer Define the Data Source To define a data source connection 1 Click Connection. The Connect to Data Source dialog box appears. 2 Under Database Connection, click Configure. The Database Connection dialog box appears. 34 Teradata Aggregate Designer User Guide

35 Chapter 4: Using Teradata Aggregate Designer Define the Data Source Extra Parameters 3 Enter a name for the connection in the Connection Name box. 4 Enter a host name or IP address in the Host Name box. 5 Enter the database name to where the target cube is mapped in the Database Name box. 6 Enter a port number in the Port Number box. The default Teradata port is Enter a user name (the user account name of the target database) in the User Name box. 8 Enter the user password in the Password box. 9 Click Test. A dialog box appears with the configuration validation status. 10 Click OK. To define additional (optional) parameter-related values for the JDBC driver for an atypical configuration, define the connection parameters in the Extra Parameters group box of the Database Connection dialog box. For a list of parameters definable in the Extra Parameters group box, see the Teradata JDBC Driver User Guide. See Additional Information on page 4. Teradata Aggregate Designer User Guide 35

36 Chapter 4: Using Teradata Aggregate Designer Define the Cube Define the Cube After defining the data source, select the schema to define and build AJIs using: A previously defined Teradata schema file A URL for an Analysis Services Project schema generator (SSAS server) A previously-defined Analysis Services Project schema generator file A previously-defined Cognos Project model.xml file containing Star Schema Groupings. To use an Analysis Services Project, the SQL Server Analysis Services server must be configured to enable XMLA, or export the project in XMLA format using SQL Server Management Studio. To find any data conflict in the columns specified as Primary Key and Foreign Keys in the schema, perform a Pk/Fk Hard Data Check. This section contains the following procedures: To define cubes from a schema file To define cubes from an Analysis Services Project URL To validate a schema To detect primary key and/or foreign key data conflicts To define cubes from a schema file 1 In the Connect to Data Source dialog, under OLAP Model, select one of the following files: Teradata BIO Schema File Analysis Services Project (URL) Analysis Services Project (File) Cognos FM Schema 2 Click... to navigate to the selected file, then click OK. 3 In the Connect to Data Source dialog, click Apply to populate the cube list with the cubes defined in the Teradata schema file. If a Cognos schema has been selected, a Datasources dialog displays. This is for mapping the Datasource specified in the model.xml file to the physical database Schema name. Note: A Schema Errors dialog might appear, displaying skipped schema elements (dimensions, hierarchies, levels). This occurs when Teradata Aggregate Designer encounters unsupported schema constructs. Examine the missing elements to determine if any remodeling is necessary. For a list of modeling limitations, see the following document (default location): C:\Program Files\Teradata\Client\14.00\Teradata Aggregate Designer\doc\Release.txt. Contact Customer Support for additional information. To learn more about Teradata Customer Services, go to 36 Teradata Aggregate Designer User Guide

37 Chapter 4: Using Teradata Aggregate Designer Define the Cube 4 Select a cube from the drop down menu. 5 Click Connect to connect to the Data Source. Note: When Teradata establishes a connection, it runs validation tests provided in Teradata Plugins to ensure that the database structure is ready to support AJIs. If cube schema elements are unsupported or fail to load, the Schema Errors dialog box appears with a list of elements that require correction. If the Schema Errors dialog box appears, correct the OLAP cube Schema model or the physical data model to form a Teradata standard star or snowflake model, then reload the schema to continue the AJI design. To define cubes from an Analysis Services Project URL 1 In the Connect to Data Source dialog select Analysis Services Project URL. 2 Enter the URL in the text box. 3 To populate the databases, click beside the text box. 4 Select the appropriate database from the Databases drop down menu. 5 In the Connect to Data Source dialog, click Apply to populate the cube list with the cubes defined in the schema file. 6 Select a cube from the drop down menu. 7 Click Connect to connect to the Data Source. Note: When Teradata establishes a connection, it runs validation tests provided in Teradata Plugins to ensure that the database structure is ready to support AJIs. If cube schema elements are unsupported or fail to load, the Schema Errors dialog box appears with a list of elements that require correction. If the Schema Errors dialog box appears, correct the OLAP cube Schema model or the physical data model to form a Teradata standard star or snowflake model, then reload the schema to continue the AJI design. To validate a schema 1 From the Tools menu, click Validate Schema. The schema validation begins. 2 When the schema validation is complete, the Validation Results window displays. To detect primary key and/or foreign key data conflicts From the Tools menu, click Pk/Fk Hard Data Check. This checks for data conflict in the columns specified as Primary Key and Foreign Keys in the schema. Teradata Aggregate Designer User Guide 37

38 Chapter 4: Using Teradata Aggregate Designer Define and Refine the AJI Define and Refine the AJI From the Teradata Aggregate Designer window manually create recommendations to optimize the cube or use the Teradata Aggregate Designer Advisor to create a list of recommendations to optimize the cube. Aggregate Join Index Advisor Use the Teradata Aggregate Designer Advisor to create a list of recommendations to optimize cubes. Teradata Aggregate Designer uses the schema and the data in the database to create AJI definitions. The Teradata Aggregate Designer Advisor recommends two AJIs, the Base AJI and the Broad AJI. The Base AJI contains all foreign keys that exist in the fact table. This is regardless of whether it is a star or snowflake schema because the Base AJI does not join any tables. It is a single table AJI on the transaction or fact table. The Broad AJI is created for the next to last OLAP level (one level above the lowest level). In the snowflake model, the foreign key from the dimension list is selected in the AJI for the current level. Expert Mode To display recommended aggregate From the Teradata toolbar, click Advisor. The Advisor runs for a few seconds before it displays an initial list of recommended Base and Broad AJIs in the Aggregate Join Index Pane of the Teradata Aggregate Designer window. Note: Recommendations created by the Teradata Aggregate Designer Advisor appear in the Aggregate Join Index pane as an Advisor type. To create recommendations manually 1 In the Aggregate Join Index Pane of the Teradata Aggregate Designer window, click Add to add a row to the pane. Note: By default, the added row is highlighted and selected. If more than one row is added, the last row added is highlighted. 2 In the Aggregation Levels tab of the Edit Aggregate Definition Pane, use the arrows to change the hierarchy levels for the row. Click Apply to apply the change. The information for the row in the Aggregate Join Index pane reflects the changes. 38 Teradata Aggregate Designer User Guide

39 Chapter 4: Using Teradata Aggregate Designer Export Aggregates Note: Recommendations created manually appear in the Aggregate Join Index pane as a Custom type. Customize a recommendation To customize a recommendation 1 In the Aggregate Join Index Pane of the Teradata Aggregate Designer window, highlight the row to customize. 2 In the Aggregation Levels tab of the Edit Aggregate Definition Pane, use the arrows to change the hierarchy levels for the row. 3 Click Reset to restore the previous settings. 4 Click Apply to apply the changes. The information for the row in the Aggregate Join Index pane reflects the change. Note: Customized recommendations display as Custom types in the Aggregate Join Index pane. Export Aggregates Use the Export and Publish option of Teradata Aggregate Designer to: Preview the AJI outputs for the selected recommendations Export the AJI output to a local file Publish (build) the AJIs To preview AJI output for recommendations 1 In the Aggregate Join Index pane of the Teradata Aggregate Designer window select the row or rows to preview. 2 Click Export from the window toolbar. The Export and Publish dialog box appears. 3 Click Preview. The Preview dialog box appears. You can edit statements in the Preview dialog box. For example, unmask COLLECT STATISTICS and COMMENT ON statements, or edit the CREATE statement to enable saving, copying or executing directly against the connected Teradata Database system. Do one of the following: Click Save to save the output to a file. Click Copy to Clipboard to copy the file to the clipboard. Click Execute to execute all SQL statements in the dialog box. Teradata Aggregate Designer User Guide 39

40 Chapter 4: Using Teradata Aggregate Designer Save Design Work Note: If no primary index has been defined for the selected AJI, a warning dialog box displays. If a primary index is not specified, the Teradata Database selects the first column by default. 4 Click Close to exit the Preview dialog box. 5 Click Close to exit the Export and Publish dialog box. To export AJI output to a local file 1 In the Aggregate Join Index pane of the Teradata Aggregate Designer window select the row or rows to preview. 2 Click Export from the window toolbar. The Export and Publish dialog box appears. 3 Click Export and save the file. 4 Click Close to exit the Export and Publish dialog box. To publish (build) the AJI 1 In the Aggregate Join Index pane of the Teradata Aggregate Designer window select the row or rows to preview. 2 Click Export from the window toolbar. The Export and Publish dialog box appears. 3 Click Execute. Save Design Work Teradata Aggregate Designer allows all aggregate-related data (custom- or advisor-created) in the workspace to be saved at any time. Saving ensures that all of the data in the workspace is retained. Saving the design creates an XML file that can later be opened to continue refining the cube. To save Do one of the following: Click File>Save Click File>Save As 40 Teradata Aggregate Designer User Guide

41 Glossary A ad hoc query A query of which the system has no prior knowledge. An ad hoc query differs from a standard report, which looks for specific information in a specific format on a scheduled basis. aggregate cube. Summary data that provides definitions for aggregate tables that help optimize a aggregation The process of merging multiple data values into one value. For example, sales data collected daily can then be aggregated to the week level, the week data could be aggregated to the month level, and so on. The data can then be referred to as aggregate data. Aggregation and summarization are synonyms, as are aggregate data and summary data. AJI Aggregate Join Index. Combines one or more commonly-used columns of the base tables with the results from one or more aggregation expressions pre-computed from one or more columns of the tables. This is used to improve query performance of summarized data. alias A name or label used as an alternative means of referring to someone or something. attribute A characteristic of a dimension member in a logical data model, representing a set of dimension members. It is associated with a database column. For example, the Time dimension might have a Year attribute which represents the set of years in a database column. B base table A base table can be any table that acts as an origin of detailed data. In OLAP, the fact table is often considered to be the base table in a star schema. C calculated member other members. A member of a dimension whose value is calculated from the values of children Members of a dimension that are subordinate to a parent member. Typically, children would be used in a calculation that created a consolidated total for the parent. Children can also have children, or levels that are subordinate to themselves. Children can have more than one parent. client An OLAP client usually handles most of the presentation work, and only some of the processing. The OLAP server handles the rest of the processing. cube A named collection of measures and dimensions. Measures and dimensions are derived from a fact table, which identifies the columns from which the measures are calculated and contain references to the tables which hold the dimensions. Teradata Aggregate Designer User Guide 41

42 Glossary D data model An abstract model that describes how data is represented or structured, and how data elements relate to each other. A multidimensional data model in OLAP consists of cubes, measures, dimensions, hierarchies, levels, and attributes. data repository A logical division of data where multiple databases reside; the databases apply to specific applications (such as accounting programs). A data repository can also represent a physical division of data. data source The source of computer data or a site where data is stored and accessed. data type A definition of a set of data that gives the range of values, such as date, number, string, and floating point. Database Query Log (DBQL) Provides detailed information about queries running on a Teradata system. DBQL data enables identifying and troubleshooting problem queries. dimension A logical grouping of attributes. A dimension acts as an efficient and intuitive way of organizing data for retrieval and analysis. dimension table A database table that contains attribute-associated data and is created as a companion table to a fact table. drill down/up To view data in different levels of detail. Specifically, a user can drill up to get more generalized data or down for more detailed data. The level to which a user can drill depends on the granularity of the data. E elements The actual data values that appear in a dimension table associated with an attribute. January and September would be elements of the Month attribute in the Time dimension. Also referred to as an attribute element. F facts Variables or measures, normally stored as numeric fields, which are the focus of the decision support investigation. Facts would be inventory levels, sales amounts, commissions, and so on. fact table A fact table acts as the base table for a star schema and, when normalized, is surrounded by dimension tables containing attribute data. The fact table contains measure or fact data. See also base table. formula A formula calculates or sets guidelines for manipulating data within a multidimensional database, and defines enterprise relationships. Users can use a formula to personalize data for their specific needs. 42 Teradata Aggregate Designer User Guide