Oracle Discoverer Administration Edition Administration Guide
Release 4.1 for Windows

A86730-01

Library

Contents

Index

Prev Next

15
Summaries

This chapter consists of the following sections:

15.1 Introduction

This chapter explains summaries and how you specify and maintain them yourself. For details about how Discoverer recommends and creates the best summaries for you, see Chapter 16, "Automated Summary Management".

15.1.1 What is a summary?

A summary improves query performance in Discoverer Plus or Discoverer Viewer by using pre-aggregated data created through Discoverer Administration Edition.

The term summary used throughout this guide refers either to summary tables (with pre-8.1.6 databases) or Materialized Views (MVs) ( 8.1.6+ databases). For further details about summary tables and MVs see Section 15.1.1.1, "Summary tables or Materialized Views?".

A query run in Discoverer Plus can be redirected/rewritten to use an appropriate summary rather than having to query the detail tables. A summary is used only when it satisfies the conditions of the query.

Discoverer Plus uses summaries to reduce the time taken to return query results and provides a significant improvement in performance.

15.1.1.1 Summary tables or Materialized Views?

Discoverer uses either summary tables or Materialized Views (MVs) depending on which of the following scenarios is true:

15.1.1.2 What is a Summary Folder?

A Summary Folder is how Discoverer represents the underlying structure of a summary table or MV. Each Summary Folder has one or more Items (i.e.columns from a summary table or MV).

You can view Summary Folders from the Summaries tab in Discoverer Administration Edition (see Figure 15-1, "A Summary Folder as displayed in Discoverer").

Figure 15-1 A Summary Folder as displayed in Discoverer


15.1.1.2.1 What makes up a Summary Folder?

The following elements define a Summary Folder:

You set up Summary Folders using the Summary Wizard. To understand how the process works, read the following pages before you launch the Summary Wizard.

The rest of this section describes these concepts in more detail.

15.1.2 Summary Combinations

A Summary Combination is a single set of axis and measure items in a summary table or MV. Each Combination is a different way of combining two or more of the Items in the Summary Folder. It is very much like a query, in that it defines a specific row and column set.

If a user executes a query with the same Items as those specified in a Combination, the query is run against either a summary table or MV instead of the detail data.

You can define as many Combinations as you require for each Summary Folder.

It is also faster to refresh Summary Folders with multiple Combinations, because the higher level summaries are built from the lower level ones, which is considerably faster than building separate Summary Folders all from the detail data.

For information on how to choose the most appropriate Summary Combinations, see Section 15.2, "Good Summary Folder Design."

15.1.2.1 Summary Combinations

You can combine items in a summary folder into Summary Combinations. From a Summary Combination, Discoverer creates one of the following depending on the version of the database:

15.1.3 Summary tables/Materialized Views (MVs)

This section contains the following information about summary tables/Materialized Views:

15.1.3.1 Discoverer summary tables versus server Materialized Views (8.1.6+)

The following table compares Discoverer summary tables and server MVs.

Table 15-1 Comparison between Discoverer summary tables and server Materialized Views
Discoverer summary tables  Server Materialized Views 

RDBMS version 7.3 - 8.1.5 

RDBMS version 8.1.6+ only 

Stored as tables 

Stored as Materialized View 

Full refresh only 

Full or Incremental refresh 

Refresh On Demand only 

Refresh On Demand/Commit 

Refresh only by Discoverer 

Refresh outside Discoverer 

Rewrite only by Discoverer 

Rewrite by server 

Defined in terms of Items and Folders 

Defined in terms of tables and columns 

RDBMS version 8.1.6+ only - When Discoverer Administration Edition is operating against Oracle 8.1.6 (and summaries are needed) it will automatically create server MVs. It will no longer generate and maintain Discoverer summary tables.

Stored as Materialized View - The precomputed summary results are stored as a MV. Additional functionality of the MV can be utilized.

Full or Incremental Refresh:
Full - Refreshes by completely recalculating the result set.
Incremental - Refreshes by incrementally adding the new data that has been inserted into the tables.

Refresh On Demand/Commit:
On Commit - Refresh occurs automatically on the next transaction commit performed against the detail table.
On Demand - Refresh occurs when a user manually executes a refresh.

Refresh Outside Discoverer - Since MVs are stored in the server, those MVs generated within Discoverer are available for refresh by other client applications. For example, a MV created within Discoverer can be refreshed through SQL*Plus using the supplied DBMS_MVIEW package.

Rewrite by Server - The server recognizes when an existing MV can be used to satisfy a given query request and will then transparently rewrite the request to use the MV instead of the detail data.

Defined in terms of Tables and Columns - The Materialized View query is defined in terms of database columns and tables. Whereas, Discoverer Summaries are created from EUL elements - items and folders.

15.1.3.2 Managed versus external summary tables/MVs

From a Discoverer Administration Edition viewpoint, there are two types of summary folder:

The main differences between these types of summary table are described in Table 15-2.

Table 15-2 Differences Between Managed summary tables/MVs and External summary tables
Managed summary tables or MVs  External summary tables 

Are populated and maintained automatically by Discoverer or Oracle 8.1.6+ server respectively. 

Are populated and maintained by another application (for example SQL*Plus). 

Are created either through Discoverer Administration Edition or an external application. 

Are created by an external application. 

Can be automatically refreshed at regular intervals (defined in Discoverer Administration Edition) 

Must be refreshed using another application. 

In both cases, Discoverer knows where summary tables are located and the Items represented in them and so it can use summary redirection to reduce the time taken to perform a query. With Oracle 8.1.6+ the server carries out a summary rewrite to an appropriate MV.

External summary tables are useful:

15.1.3.3 Registering external summaries against tables and views in Oracle 8.1.6+

External summaries can be registered against tables and views (not the detail tables) but in Oracle 8.1.6+ MVs cannot be created against a view, instead summary redirection is used (see Table 15-3).

Table 15-3 Registering External Summaries Against A Table Or View in Oracle 8.1.6+
Registering against a table  Registering against a view 

Where an external summary is registered against a table, a MV definition is created.
The MV definition is used for the server's SQL rewrite. 

Where an external summary is registered against a view a MV is not created. Summaries behave in the same manner as pre-8.1.6 Discoverer summary management, that is Discoverer redirection is used (see Section 15.1.4, "Summary Redirection"). 

15.1.3.4 Refreshing summary data

The data in summary tables and MVs must be maintained to keep all of the summary tables and MVs consistent. If the database changes often, summary tables and MVs need to be refreshed accordingly to keep their data current with the underlying database. With a properly maintained set of summary tables or MVs, query results are accurate, regardless of the table or MV being used.

15.1.4 Summary Redirection

15.1.4.1 Summary redirection or query rewrite in Discoverer Plus?

When you run a query in Discoverer Plus the results will be returned either from the detail tables or from a summary table/MV.

The following conditions regarding database versions also apply:

Both summary redirection and query rewrite are transparent to the user. Both provide exactly the same results as queries that run against the detail tables but return the results in far less time. This depends on whether or not you have set the option of whether to use summaries or not in Discoverer Plus or Discoverer 4i Viewer (this setting can be defined in Discoverer Plus and Discoverer 4i Viewer).

15.1.4.2 Overview

Summary Redirection describes the process of redirecting a query to use a summary table or MV rather than the detail data. Discoverer Plus performs this process automatically against pre-8.1.6 databases. The server performs this process against 8.1.6+ databases (by rewriting the query to a MV).

A query redirected to a summary table or MV can return results in a few seconds. The same query directed against the detail data tables may require a three-or four-table join and an aggregation over thousands or millions of rows, and thus would take considerably longer. Both queries, however, would produce the same results.

The net result is accurate results and quick response times.

For further information about the rules regarding 8.1.6 MV server rewrite scenarios refer to the Oracle8i Data Warehousing Guide Release 2 (8.1.6) Part Number A76994-01.

Discoverer Plus can only use Summary Redirection if all of the following prerequisites are met.

The following prerequisites apply to pre-8.1.6 databases only unless otherwise specified:

  1. All the Items specified in a query must either:

    • exist in a single Summary Combination, or

    • be able to be joined to a summary table via foreign keys that exist in a Summary Combination.

    In the case of Derived Items (see Chapter 12.1.1.1, "Derived Items" for information about Derived Items), it is not sufficient to include the elements used to create the Derived Items in a Summary Combination; you must include the Derived Items themselves.

    In the case of Items in Complex Folders (see Chapter 6.2.2.1, "What is a Complex Folder?" for information about Complex Folder), it is not sufficient to include the Items from the source Folders in a Summary Combination; you must include the Items from the Complex Folders themselves.

  2. All the Join paths specified in the query (see Chapter 11, "Joins" for further details) must match those specified in the same Summary Combination that satisfies the previous prerequisite.

    This ensures that the result set of data in the summary is the same as that in the detail. The exception in this case is that queries can be defined that use fewer Joins than those specified when the summary table was created, provided that you clear Detail foreign keys can have NULL values on the Join Options dialog box (displayed by clicking Options... on the New Join or Edit Join dialog boxes).

  3. The Summary Folder has the Available for Queries property set to Yes (applies to pre-8.1.6 and 8.1.6+ databases).

    See Section 15.4, "Editing Summary Folder Properties" for more information.

  4. The conditions specified on the Query Governor page of the Options dialog box in Discoverer Plus (Tools | Options) are met.

  5. The user running the query has database SELECT access to the summary table.

To determine how your database system can benefit from Summary Redirection, use the Summary Wizard (specifying the summaries yourself) to recommend summaries based on previous queries. For a more detailed look at the query statistics option, see the business area named Query Statistics that you received with Discoverer. It includes a workbook for analyzing query usage, the Items most frequently used in queries, the Folders containing the Items, and query execution times (applies to pre-8.1.6 and 8.1.6+ databases).

15.1.4.3 Viewing Summary Redirection in Discoverer Plus

To view the effect of summary redirection, use the SQL Inspector dialog (choose View | SQL Inspector) in Discoverer Plus.

The SQL Inspector dialog has two tabs, the SQL tab and the Execution Plan tab.

15.1.4.3.1 SQL tab

The SQL tab displays the SQL that Discoverer sends to the server.

15.1.4.3.2 Execution Plan tab

The Execution Plan tab displays the execution plan chosen by the server for the query request. The execution plan defines the sequence of operations the server performs to execute the statement.

15.1.4.3.3 Viewing the SQL and Execution Plan with an 8.1.6+ database

When running Discoverer against an 8.1.6+ database the server controls redirection by rewriting the SQL to use a MV. If a server rewrite occurs, the server execution plan indicates the MV name.

The SQL that Discoverer sends to the server can be viewed from the SQL tab in the SQL Inspector dialog in Discoverer Plus. The SQL rewritten by the server can be viewed on the Execution Plan tab in the SQL Inspector dialog in Discoverer Plus.

Figure 15-2 SQL tab displaying the SQL statement


In the above figure the SQL remains unchanged.

Figure 15-3 Execution Plan tab displaying the execution plan (using a MV)


The MV is used by the RDBMS and is identified in the Execution Plan by the table name EUL4_MV{Identifier}

15.1.4.3.4 Viewing the SQL with a pre-8.1.6 database

(not using a MV)

When running against a pre-8.1.6 database Discoverer controls redirection to a summary table. The SQL can be viewed at the SQL tab and the server Execution Plan can be viewed on the Execution Plan tab in the SQL Inspector dialog in Discoverer Plus.

Figure 15-4 shows a crosstab worksheet of items from the Video Analysis folder (created as part of the tutorial (see Chapter 4, "Tutorial") and the resulting SQL statement in the SQL Inspector dialog. The SQL statement shows that the summary table EUL4_SUM100750 is referenced. The table at the bottom of Figure 15-4 is taken from the Combinations | Properties | Mappings page of the Edit Summary dialog box in Discoverer Administration Edition and shows the database column mapping in the EUL4_SUM100750 summary table.

Figure 15-4 Summary Redirection in Progress

Discoverer Plus automatically chooses the most appropriate summary table to process the query efficiently. This action is completely transparent to the user.

Figure 15-5 shows the same worksheet as before after the user has drilled down from Year to Month. Notice Discoverer Plus has redirected the second part of the query to EUL4_SUM100774 instead of EUL4_SUM100750.

Figure 15-5 Summary Redirection in Progress

Figure 15-6 shows the same worksheet again, this time the user has drilled down from Region to City. Again, Discoverer Plus automatically chooses the most efficient summary tables for each part of the query.

Figure 15-6 Summary Redirection in Progress

15.1.5 An Example

This example consists of five tables, one of which has almost 70,000 records (see Figure 15-7). The schema and data are taken from the tutorial.

Figure 15-7 Example schema and data

Consider a query requiring the following items:

This would require a five-table join and an aggregation of all matching rows in SALES_FACT (the table with almost 70,000 rows). Producing results to the query could take several minutes depending on the capability of the server.

On the other hand, if the query could be redirected to a single table that already contains the data for Region, Department, Year, and SUM (Dollar_Profit) (see Figure 15-8), then the query would produce an almost instantaneous response.

Figure 15-8 Sample summary table

The sample summary table shown in Figure 15-8 stores the information needed by the query at the month level, and only has to be aggregated to the year level. Discoverer Plus knows it is faster to aggregate from the single table than from the six-table join and full table scan option.

15.2 Good Summary Folder Design

This section applies specifically to Discoverer summary management with a pre-8.1.6 database. For information about operating against an 8.1.6+ database you may find it useful to refer to the Oracle8i Data Warehousing Guide Release 2 (8.1.6) Part Number A76994-01.

15.2.1 Creating appropriate Summary Combinations

Designing useful Summary Folders involves a trade off between the database space used to store the resulting summary tables and the required performance of queries. The key to good Summary Folder design is creating the most appropriate Summary Combinations for the pattern of system usage.

Consider Summary Combinations in two basic ways:

For example, the columns of the two summary tables shown in Figure 15-9 are mapped to the appropriate Items in the Sales Fact Folder. Although TIME_KEY, PRODUCT_KEY and STORE_KEY are EUL Items hidden from the end user, you can still map the corresponding summary table columns to those Items.

Figure 15-9 Sample summary tables

Discoverer will join one of these tables to one or more of the dimension tables (STORE, PRODUCT, or FISCAL DATE) to obtain a quick answer. The requirement is that the target dimension table must be joined to the FACT table by Items defined in the EUL, and that the Summary Folder contains the foreign key items in the FACT folder.

If the user requests Product Category, Month, SUM(Dollar Profit), Discoverer will join EUL4_SUM200801 to PRODUCT and FISCAL DATE to obtain results. Discoverer knows about the foreign and primary keys between SALES_FACT and the two tables, and can apply them to EUL4_SUM200801.

15.2.2 Hints for setting up Summary Folders

Building Summary Combinations in "layers" is usually an efficient way to work:

15.2.3 Notes on when an expression will use a summary

15.3 How to create Summary Folders

This section consists of the following topics:

15.3.1 Prerequisites

To be able to create summary folders, the following requirements must be met:

15.3.2 Creating Summary Folders Based on Items in the EUL

This section describes how to create managed Summary Folders based on Items in the EUL.

  1. Start the Summary Wizard.

    There are three ways to do this:

    • Toolbar Icon
      Click the New Summary toolbar icon ()

    • Menu
      Choose Insert | Summary.

    • Popup Menu
      Right-click an existing Summary Folder on the Summaries page and choose New Summary... on the popup menu.

Figure 15-10 Summary Wizard Step 1 - Specify summaries yourself


  1. Select the I want to specify the summaries myself option

  2. Click Next.

Figure 15-11 Summary Wizard Step 2 - From items in the EUL


  1. Select the From items in the End User Layer option.

    This option creates a Managed summary table. It is only available if the Summary Management feature is enabled. See Section 2.2, "Summary Management," for more information.

  2. Click Next to display Summary Wizard: Step 3 (see Figure 15-12).

Figure 15-12 Selecting Summary and Axis Items


  1. Move the Items and Measures that you want to be included in the new Summary Folder from the Available items list to the Selected items list.

    There are three ways of moving Items and Measures from one list to the other:

    • Drag and Drop
      Drag one or more Items from one list to the other.

    • Include / Exclude buttons
      Select one or more Items in a list and then click either the Include (right arrow) or Exclude (left arrow) button.

    • Double-click
      Double-click an Item to move it from one list to the other.

    To select more than one Item or Measure at once, hold down Ctrl while you click on the Items.

    Remember to include:

    You can select any Axis Items and math functions, but if the Items are from different Folders, a Join must exist between the Folders.

  2. Click Next to display Summary Wizard: Step 4 which enables you to define all the Summary Combinations you require for your new Summary Folder (see Figure 15-13).

Figure 15-13 Defining Summary Combinations


By default, the first Summary Combination (column 0) is a "catch all" Summary Combination which includes all the Items selected in Summary Wizard: Step 3.

  1. Add more Summary Combinations by clicking Add Combination.

    Each Summary Combination is listed in its own numbered column.

  2. Define the Items included in each Summary Combination by ticking or clearing the relevant check boxes.

    For more information, see:

  3. Click Estimate Space.

    This helps you decide whether the performance gains offered by using the specified Summary Combinations are outweighed by the amount of tablespace they occupy.

  4. Click OK.


Note: You can view and edit database storage properties for the selected Summary Combination by clicking Storage Properties.... For more information, see Section 15.9, "Editing Database Storage Properties." 


  1. Remove any unwanted Summary Combinations by selecting the relevant column number and clicking Remove Combination.

  2. Click Next to display the Summary wizard step 5 where you can schedule the refresh of this summary and specify the interval between subsequent automatic refreshes. (see Figure 15-14)

Figure 15-14 Refresh a Summary Folder


  1. Select the Automatically refresh this Summary Folder, starting on check box.
    This enables you to specify the date, time and frequency of automatic refresh for this summary. Clear this check box if the data is static and will not change, or if you want to refresh the Summary Folder manually. To refresh manually, select the Summary Folder in the Summaries tab

  2. Set the Date and Time you want the first refresh to run.

  3. Set the Repeat every fields for the refresh interval you want.
    The refresh period you specify here is the period of time that will elapse before Discoverer refreshes and updates the data. This refreshment pattern will persist until you change the specification.

  4. Click Next to display the last page of the wizard, Summary Wizard: Step 6 (see Figure 15-15).

Figure 15-15 Specifying general Summary Folder information


  1. Specify a name and description for the Summary Folder.

  2. Specify when you want to build this Summary Folder.

    • Click the Build immediately radio button when you have smaller summary tables, or when you need to build the Summary Folder right away, without relying on the scheduling capabilities of the database server.

    • Click the Build at radio button when you have larger summary tables which are best built at off-peak hours, then enter the time and date you want the Summary Folder build to run on the server.

  3. Click Finish.

This creates the Summary Folder in the Business Area and the resulting summary tables or MVs (8.1.6+) in the database. The summary data is generated and the Summary Table/MV marked as Ready to use. For a Summary Folder with multiple Summary Combinations, the Summary Tables/MVs are generated in order with the summary tables/MVs with the largest number of Items generated first.

When the process is complete the new Summary Folder appears on the Summaries page of the work area.

15.3.3 Creating Summary Folders Based on Query Statistics

This section describes how to create a new Summary Folder based on query statistics. This saves time and work as you don't have to choose the Items yourself.

  1. Start the Summary Wizard.

    There are three ways to do this:

    • Toolbar Icon
      Click the New Summary toolbar icon ()

    • Menu
      Choose Insert | Summary.

    • Popup Menu
      Right-click an existing Summary Folder on the Summaries page and choose New Summary... on the popup menu.

Figure 15-16 Summary Wizard Step 1 - Specify summaries yourself


  1. Click I want to specify the summaries myself

  2. Click Next

Figure 15-17 Summary Wizard Step 2 - Using query performance statistics


  1. Click Using query performance statistics.

    This option creates a managed summary table/MV. It is only available if the Summary Management feature is enabled. See Section 2.2, "Summary Management," for more information.

  2. Click Next to display Summary Wizard: Step 3 (see Figure 15-18).

Figure 15-18 Selecting a Query to be Summarized Based on Query Performance


This screen (Figure 15-18) is divided into three sections:

  1. Specify the values in Section 1 that you want to use to search for previously run queries.

  2. Click Search.

    If the search time is significant, a progress bar is displayed.

    All the queries that match the threshold values in section 1 are displayed in section 2. You may need to narrow or expand this list further by re-specifying the threshold values.

    If a query in the list uses items and measures that are already summarized, a cube icon appears against the query in the left-most column.

    To sort the list in section 2 on a column, click the relevant column heading.

  3. Select the row that represents the query you want to summarize from the list in section 2.

    This displays the query's Folders, Joins, and Items in section 3.

  4. Click Next.

    This displays Summary Wizard: Step 4 (see Figure 15-19, "Selecting the items to include in the Summary Folder") which enables you to select the Items to include in the Summary Folder. By default, the Selected Items list contains the Items and Measures from the query you selected on the previous page.

Figure 15-19 Selecting the items to include in the Summary Folder


  1. Move the Items and Measures, that you want to include in the new Summary Folder from the Available items list to the Selected items list.

    There are three ways of moving Items and Measures from one list to the other:

    • Drag and Drop
      Drag one or more Item or Measure from one list to the other.

    • Include / Exclude buttons
      Select one or more Item or Measure in a list and then click either the Include (right arrow) or Exclude (left arrow) button.

    • Double-click
      Double-click an Item or Measure to move it from one list to the other.

    To select more than one Item or Measure at once, hold down Ctrl while you click on the Items.

    Remember to include:

    You can select any Axis Items and math functions, but if the Items are from different Folders, a Join must exist between the Folders.

  2. Click Next.

    This displays Summary Wizard: Step 5 which enables you to define all the Summary Combinations you require for your new Summary Folder (see Figure 15-20).

Figure 15-20 Defining Summary Combinations


  1. Add more Summary Combinations by clicking Add Combination.

    Each Summary Combination is listed in its own numbered column.

  2. Define the Items included in each Summary Combination by selecting or clearing the relevant check boxes.

    For more information, see:

  3. Click Estimate Space.

    This helps you decide whether the performance gains offered by using the specified Summary Combinations are outweighed by the amount of tablespace they occupy.

  4. Click OK.


Note: You can view and edit database storage properties for the selected Summary Combination by clicking Storage Properties.... For more information, see Section 15.9, "Editing Database Storage Properties." 


  1. Remove any unwanted Summary Combinations by selecting the relevant column number and clicking Remove Combination.

  2. Click Next to display the Summary wizard step 6 where you can schedule the first refresh of this summary and specify the interval between subsequent automatic refreshes. (see Figure 15-21).

Figure 15-21 Manage the refresh of a Summary Folder


  1. Select the Automatically refresh this Summary Folder, starting on check box.
    This enables you to specify the date, time and frequency of automatic refresh for this summary.
    Clear this check box if the data is static and will not change, or if you want to refresh the Summary Folder manually. To refresh manually, select the Summary Folder in the Summaries tab

  2. Set the Date and Time when you want the first refresh to begin.

  3. Set the Repeat every fields for the refresh interval you want.
    The refresh period you specify here is the period of time that will elapse before Discoverer refreshes and updates the data. This refreshment pattern will persist until you change the specification.

  4. Click Next to display the last page of the wizard, Summary Wizard: Step 7 (see Figure 15-22).

Figure 15-22 Specifying general Summary Folder information


  1. Specify a name and description for the Summary Folder.

  2. Specify when you want to build this Summary Folder.

    • Click the Build immediately radio button when you have smaller summary tables, or when you need to build the Summary Folder right away without relying on the scheduling capabilities of the database server.

    • Click the Build at: radio button when you have larger summary tables which are best built at off-peak hours. Then enter the time and date you want the Summary Folder build to run on the server.

  3. Click Finish.

This creates the Summary Folder in the Business Area and the resulting summary tables in the database. The summary data is generated and the summary table marked as Ready to use. For a Summary Folder with multiple Summary Combinations, the summary tables are generated in order with the summary tables with the largest number of Items generated first.

When the process is complete the new Summary Folder appears on the Summaries page of the work area.

15.3.4 Creating Summary Folders Based on External summary tables

This section describes how to create a new Summary Folder based on external summary tables or Views.

For the privileges required to create summary folders see Section 15.3.1, "Prerequisites".

  1. Start the Summary Wizard.

    There are three ways to do this:

    • Toolbar Icon
      Click the New Summary toolbar icon ()

    • Menu
      Choose Insert | Summary.

    • Popup Menu
      Right-click an existing Summary Folder on the Summaries page and choose New Summary... on the popup menu.

Figure 15-23 Summary Wizard Step 1 - Specify summaries yourself


  1. Click I want to specify the summaries myself

  2. Click Next

Figure 15-24 Summary Wizard Step 2 - Registering an external summary


  1. Click Registering an external summary table.

    This registers an existing summary table created by another application. When running against an 8.1.6+ database this also creates a Materializeed View

    For more information about external summary tables, see Section 15.1.3.2, "Managed versus external summary tables/MVs."

  2. Click Next to display the Summary Wizard: Step 3 (see Figure 15-25).

Figure 15-25 Selecting an External summary table and Mapping Items


  1. Click Select to display the Choose table or view dialog box.

Figure 15-26 Selecting the database and external summary table


  1. Select the database (from the drop-down list) that contains the external summary table that you want to register.


Note: When connected to Oracle 8.1.6 or above Oracle prevents a user from registering an external summary over a database link. This is because the database does not allow a Materialized View (MV) to be created over a database link.

However, this may be achieved by creating a view in the database that the EUL is in and referencing the external summary in the view. This view may then be registered within Discoverer as an external summary. 


  1. Select the external summary table that you want to register with Discoverer Administration Edition.

  2. Click OK.

    This displays all the database columns found in the external summary table in the Mapped items list.

Figure 15-27 Mapping database columns with items in the EUL


  1. Map each database column to the corresponding Item in the EUL.

    There are three ways to do this:

    • Drag and Drop
      Drag an Item from the Available Items list onto the corresponding database column in the Mapped Items list.


      TIP: If a Folder in the EUL contains more than one Item that corresponds to a database column in the external summary table, you drag and drop the Folder from the Available items list on to one of the corresponding rows in the Mapped items list. Discoverer Administration Edition will attempt to map the correct Items to the database columns by examining the names of the Items in the Folder. 


    • Include button
      Select a database column in the Mapped items list and the corresponding Item in the Available items list and click the Include (right arrow) button.

    • Double-click
      Select a database column in the Mapped items list and double-click the corresponding Item in the Available Items list.


Note: To remove the mapping between a database column in the external summary table and an Item in the EUL, select the relevant row in the Mapped items list and click the Exclude button (left arrow). 


Figure 15-28 Setting external summary refresh information


  1. Select the Manage the refresh of this summary check box if you want Discoverer to manage the refresh of this external summary table.

  2. Select the Automatically refresh this Summary Folder, starting on: check box to schedule the refresh of this summary and specify the interval between subsequent automatic refreshes of this external summary.

  3. Click Next to display the last page of the wizard, Summary Wizard: Step 5 (see Figure 15-29).

Figure 15-29 Specifying General Summary Folder Information


  1. Specify a name and description for the Summary Folder.

  2. Click Finish.

This creates the Summary Folder in the Business Area and finishes registering the external summary table.

When the process is complete the new Summary Folder appears on the Summaries page of the work area.

15.4 Editing Summary Folder Properties

Summary Folder properties are accessible through Summary Properties dialog boxes. This section shows you how to enhance the user's view of the data by editing Summary Folder properties. Figure 15-30 shows an example Summary Properties dialog box.

Figure 15-30 Summary Properties Dialog Box with the General Page Selected

15.4.1 Editing the Properties of a Single Summary Folder

This section describes how to edit a Summary Folder's properties.

  1. Open the Summary Folder's Properties dialog box.

    There are four ways to do this:

    • Double-click
      Double-click the Summary Folder on the Summaries page.

    • Popup Menu
      Right-click the Summary Folder on the Summaries page and choose Properties on the popup menu.

    • Toolbar Icon
      Click the Summary Folder on the Summaries page and click the Properties toolbar icon ()

    • Menu
      Click the Summary Folder on the Summaries page and choose Edit | Properties.

  2. Make your changes as required.

    For more information on the fields on this dialog box, click Help.

  3. Click OK.

15.4.2 Editing the Properties of Multiple Summary Folders

The following steps show you how to set common properties for more than one Summary Folder at a time:

  1. On the Summaries page, select all of the Summary Folders whose properties you want to edit.
    (To select more than one Summary Folder, hold down the Ctrl button while you click each Summary Folder that you want to select.)

  2. Display the Summary Properties dialog box.

    There are three ways to do this:

    • Popup Menu
      Right-click one of the selected Summary Folders and choose Properties on the popup menu.

    • Toolbar Icon
      Click the Properties toolbar icon ()

    • Menu
      Choose Edit | Properties.

    All properties that are common to each of the selected Summary Folders are displayed. If the data for a field is not common to each of the selected Summary Folders, the field is blank.

  3. Make your changes as required.
    Any changes you make here will be applied to all of the selected Summary Folders.

    For more information on the fields on this dialog box, click Help.

  4. Click OK.

15.5 Editing Summary Folders

15.5.1 Editing a Summary Folder

This section describes how to edit an existing Summary Folder.

Summary Folders can be edited whether they are valid or broken. A Summary Folder is considered broken when the summary table, MV or detail tables cannot be used. To find out more about why a Summary Folder is broken, use the View | Validate Folders option. You might want to edit a broken summary to investigate the composition of its Summary Folders and remove any broken folders.

Valid managed summaries are represented by a cube with a clock face ( ) valid managed summaries are represented by a cube ( ). Broken summaries are represented by a warning triangle ( ).

  1. Select the Summaries tab.

  2. Select the plus symbol ( ) next to a Business Area to display its available Summaries ( ).

  3. Display the Edit Summary dialog box (see Figure 15-31).

    There are two ways to do this:

    • Popup Menu
      Right-click the Summary Folder on the Summaries page and choose Edit Summary... on the popup menu.

    • Menu
      Click the Summary Folder on the Summaries page and choose Edit | Edit...

  4. (Optional) Select the Tools | Options | Validate folders option to provide diagnostics at the folder level if required.

Figure 15-31 The Edit Summary Dialog Box with the General Page Selected


  1. Edit the Summary Folder as required.

    The Edit Summary dialog box is divided into four pages. Each page corresponds to a page of the Summary Wizard:

    • Choose Items
      Use this page to add or delete the Summary and Axis Items.

    • Combinations
      Use this page to edit, add, or delete Summary Combinations. You can also use this page to alter the names and physical storage properties of summary tables.

    • Refresh
      Use this page to set the refresh and refresh interval of the summary folder.

    • General
      Use this page to edit the name, description and view the build time of the Summary Folder.

    For more information on the fields on this dialog box, click Help.

  2. Click OK.
    If a summary remains broken ( ) following an edit, any modifications made in Discoverer are not written to the summary table or MV. Where a summary is valid ( or ) following an edit, any modifications made in Discoverer are also written to the summary table/MV.

15.6 Refreshing Summary Folders

This section describes what happens when a Summary Folder is refreshed, how to manually refresh one or more Summary Folders and why you need to refresh after you import/export across database versions (i.e. from pre-8.1.6 to 8.1.6+).

15.6.1 What Happens When a Summary Folder is Refreshed?

With an 8.1.6+ database the server's own refresh mechanism is used (this can be an incremental refresh) depending on your refresh settings.

Whenever a Summary Folder is refreshed, the following actions are performed by Discoverer:

15.6.1.1 Manually Refreshing a Summary Folder

  1. On the Summaries page, select the Summary Folder(s) that you want to refresh.

    To select more than one Summary Folder, hold down the Ctrl button while you click each Summary Folder that you want to select.)

  2. Refresh the Summary Folder(s).

    There are two ways to do this:

    • Popup Menu
      Right-click one of the selected Summary Folders and choose Refresh Summary on the popup menu.

    • Menu
      Choose Tools | Refresh Summaries.

    This opens the Refresh Summaries dialog box (see Figure 15-32).

Figure 15-32 Refresh summaries


  1. Choose how you want to refresh the selected Summary Folder(s)

    • Select the Refresh the summary immediately radio button
      This option is useful when you have smaller summary tables, or when you need to refresh the Summary Folder right away, without relying on the scheduling capabilities of the database server. Discoverer Administration Edition displays a progress bar enabling you to monitor the refresh.

    • Select the Schedule the refresh at a later time radio button
      This option submits a job to the queue using DBMS_JOB and immediately returns you to Discoverer Administration Edition (rather than waiting for the refresh to be complete) enabling you to continue working. This option is useful when you have larger summary tables (which are best built at off-peak hours).

    Perform incremental refresh (Oracle 8.1.6+ only)

    During a summary refresh with pre-Oracle 8.1.6 databases, a full table scan is carried out whereas with Oracle 8.1.6+ the option exists to carry out an incremental refresh (which is faster).

    • Select the Perform incremental refresh check box refresh the summary incrementally if allowed.

    • Clear the Perform incremental refresh check box to refresh the summary using a full table scan.

    For further information on the conditions required for incremental refresh please refer to Oracle8i Data Warehousing Guide Release 2 (8.1.6) Part Number A76994-01.


Note: Sometimes it is useful to refresh a summary after some external event has completed, such as the loading of data into a warehouse. You can use the Command Line option to refresh a summary from a batch command file to do this. See Appendix D.1 for more information. 


15.6.1.2 Refresh following Import/Export across pre-8.1.6 and 8.1.6+ database versions

15.6.1.2.1 From a pre-8.1.6 to an 8.1.6+ database

When you export a Business Area with Summary Folders from a pre-8.1.6 database and then import it into an 8.1.6 database, MVs need to be created for these Summary Folders. For the server to create the MVs, you must refresh the Summary Folders in Discoverer.

15.6.1.2.2 From an 8.1.6+ to a pre-8.1.6 database

When you export a Business Area with Summary Folders from a 8.1.6+ database and then import it into a pre-8.1.6 database, Discoverer needs to be able to convert these Summary Folders to summary tables instead of to MVs. For Discoverer to do this, you must refresh the Summary Folders.

15.7 Viewing the Status of Managed summary tables

This section describes how to display the status of managed summary tables.

  1. Select the Summary Folder (on the Summaries page of the work area) that contains the summary table you are interested in.

  2. Display the Edit Summary dialog box (see Figure 15-31).

    There are two ways to do this:

    • Popup Menu
      Right-click the Summary Folder on the Summaries page and choose Edit Summary... on the popup menu.

    • Menu
      Choose Edit | Edit...

  3. Click the Combinations tab.

  4. Select the numbered column heading for the Summary Combination that corresponds to the summary table you are interested in.

The summary table's status is shown in the Status Bar at the bottom of the dialog box.

Additional diagnostic information can be achieved when in the Summaries tab by using the View | Validate Folders option. This will display errors where applicable (see Chapter 6.9, "Validating Folders").

For more information on the possible status messages, click Help.

15.8 Deleting Summary Folders

This section describes how to delete Summary Folders.

  1. On the Summaries page, select the Summary Folder(s) that you want to delete.

    To select more than one Summary Folder at once, hold down Ctrl while you click on the Summary Folders.

  2. Delete the Summary Folder(s):

    There are three ways to do this:

    • Popup Menu
      Right-click one of the selected Summary Folder(s) and choose Delete Summary... on the popup menu.

    • Menu
      Choose Edit | Delete.

    • Keyboard
      Press Delete.

    This opens the Confirm Delete dialog box.

  3. Click Impact.
    This displays the Impact dialog box that shows any other objects that may be affected by the deletion (Figure 15-33). The Impact dialog box helps you to make the right choice.

Figure 15-33 The Impact Dialog Box


  1. When you have finished reviewing the impact this action will have, click OK.

  2. If you still want to delete the selected Summary Folder(s), click Yes.

15.9 Editing Database Storage Properties

This section describes how to edit the various database storage properties associated with Managed summary tables. Editing database storage properties is an advanced topic that gives you control of how Summary Combinations are stored in the database.

  1. Select the Summary Combination whose database storage properties you want to edit.

    There are two places where you can do this:

    • On the Combinations page of the Summary Wizard when you are creating a new Summary Folder (specifying the summaries yourself).

    • On the Combinations page of the Edit Summary dialog box when you want to edit an existing Summary Combination.

  2. Click Properties

    This displays the Database Storage Properties dialog box (see Figure 15-34).

    The Database Storage Properties dialog is divided into a number of tabs:

Figure 15-34 Database Storage Properties - Properties tab


Figure 15-35 Database storage properties dialog - Mappings tab


Figure 15-36 Database storage properties dialog - Tablespaces tab


Figure 15-37 Database storage properties dialog - 8i Properties tab


15.9.0.3 Refresh Options (Oracle 8.1.6+ only)

Oracle 8.1.6+ databases support incremental refresh, when available, enabling you to work with large data warehouses/databases. Parallelism is also supported for the refresh operation.

For further information on the conditions required for incremental refresh please refer to Oracle8i Data Warehousing Guide Release 2 (8.1.6) Part Number A76994-01.

For further details click Help


Prev Next
Oracle
Copyright © 2000 Oracle Corporation.

All Rights Reserved.

Library

Contents

Index