Skip Headers
Oracle® OLAP Reference
10
g
Release 2 (10.2)
Part Number B14350-01
Home
Book List
Index
Master Index
Feedback
Next
View PDF
Contents
List of Examples
List of Figures
List of Tables
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
1
Creating Analytic Workspaces with DBMS_AWM
Overview
Creating OLAP Catalog Metadata for the Source Cube
Creating Dimensions in the Analytic Workspace
Creating Cubes in the Analytic Workspace
Aggregating the Cube's Data in the Analytic Workspace
Enabling Access to the Analytic Workspace
Viewing Metadata Created by DBMS_AWM
Active Catalog Views
Analytic Workspace Maintenance Views
Understanding the DBMS_AWM Procedures
Methods on Dimensions
Methods on Cubes
Methods on Dimension Load Specifications
Methods on Cube Load Specifications
Methods on Aggregation Specifications
Methods on Composite Specifications
Creating and Refreshing a Workspace Dimension
Creating and Refreshing a Workspace Cube
Managing Sparse Data and Optimizing the Workspace Cube
Aggregating the Data in an Analytic Workspace
Enabling Access by the OLAP API
Enabling Relational Access
Procedure: Generate and Run the Enablement Scripts
Procedure: Run the Enablement Scripts Automatically
The OLAP API Enabler Procedures
Disabling Relational Access
Specifying Names for Dimension Views
Specifying Names for Fact Views
Column Structure of Dimension Views
Sample Dimension View
Grouping ID Column
Column Structure of Fact Views
Example: Enable a Workspace Cube for Relational Access
2
Creating OLAP Catalog Metadata with CWM2
Understanding OLAP Catalog Metadata
OLAP Catalog Metadata Entities
Creating a Dimension
Procedure: Create an OLAP Dimension
Example: Create a Product Dimension
Procedure: Create a Time Dimension
Example: Create a Time Dimension
Creating a Cube
Procedure: Create a Cube
Example: Create a Costs Cube
Mapping OLAP Catalog Metadata
Mapping to Columns
Mapping Dimensions
Mapping Measures
Joining Fact Tables with Dimension Tables
Validating and Committing OLAP Catalog Metadata
Validating OLAP Catalog Metadata
Viewing Validity Status
Refreshing Metadata Tables for the OLAP API
Invoking the Procedures
Security Checks and Error Conditions
Size Requirements for Parameters
Case Requirements for Parameters
Directing Output
Viewing OLAP Catalog Metadata
3
Active Catalog Views
Understanding the Active Catalog
Standard Form Classes
Active Catalog and Standard Form Classes
Active Catalog Metadata Cache
Example: Query an Analytic Workspace Cube
Summary of Active Catalog Views
ALL_OLAP2_AWS
ALL_OLAP2_AW_ATTRIBUTES
ALL_OLAP2_AW_CUBES
ALL_OLAP2_AW_CUBE_AGG_LVL
ALL_OLAP2_AW_CUBE_AGG_MEAS
ALL_OLAP2_AW_CUBE_AGG_OP
ALL_OLAP2_AW_CUBE_AGG_SPECS
ALL_OLAP2_AW_CUBE_DIM_USES
ALL_OLAP2_AW_CUBE_MEASURES
ALL_OLAP2_AW_DIMENSIONS
ALL_OLAP2_AW_DIM_HIER_LVL_ORD
ALL_OLAP2_AW_DIM_LEVELS
ALL_OLAP2_AW_PHYS_OBJ
ALL_OLAP2_AW_PHYS_OBJ_PROP
4
Analytic Workspace Maintenance Views
Building and Maintaining Analytic Workspaces
Example: Query Load and Enablement Parameters for Workspace Dimensions
Summary of Analytic Workspace Maintenance Views
ALL_AW_CUBE_AGG_LEVELS
ALL_AW_CUBE_AGG_MEASURES
ALL_AW_CUBE_AGG_PLANS
ALL_AW_CUBE_ENABLED_HIERCOMBO
ALL_AW_CUBE_ENABLED_VIEWS
ALL_AW_DIM_ENABLED_VIEWS
ALL_AW_LOAD_CUBES
ALL_AW_LOAD_CUBE_DIMS
ALL_AW_LOAD_CUBE_FILTERS
ALL_AW_LOAD_CUBE_MEASURES
ALL_AW_LOAD_CUBE_PARMS
ALL_AW_LOAD_DIMENSIONS
ALL_AW_LOAD_DIM_FILTERS
ALL_AW_LOAD_DIM_PARMS
ALL_AW_OBJ
ALL_AW_PROP
5
OLAP Catalog Metadata Views
Access to OLAP Catalog Views
OLAP Catalog Metadata Cache
Views of the Dimensional Model
Views of Mapping Information
ALL_OLAP2_AGGREGATION_USES
ALL_OLAP2_CATALOGS
ALL_OLAP2_CATALOG_ENTITY_USES
ALL_OLAP2_CUBES
ALL_OLAP2_CUBE_DIM_USES
ALL_OLAP2_CUBE_MEASURES
ALL_OLAP2_CUBE_MEASURE_MAPS
ALL_OLAP2_CUBE_MEAS_DIM_USES
ALL_OLAP2_DIMENSIONS
ALL_OLAP2_DIM_ATTRIBUTES
ALL_OLAP2_DIM_ATTR_USES
ALL_OLAP2_DIM_HIERARCHIES
ALL_OLAP2_DIM_HIER_LEVEL_USES
ALL_OLAP2_DIM_LEVELS
ALL_OLAP2_DIM_LEVEL_ATTRIBUTES
ALL_OLAP2_DIM_LEVEL_ATTR_MAPS
ALL_OLAP2_ENTITY_DESC_USES
ALL_OLAP2_ENTITY_EXT_PARMS
ALL_OLAP2_ENTITY_PARAMETERS
ALL_OLAP2_FACT_LEVEL_USES
ALL_OLAP2_FACT_TABLE_GID
ALL_OLAP2_HIER_CUSTOM_SORT
ALL_OLAP2_JOIN_KEY_COLUMN_USES
ALL_OLAP2_LEVEL_KEY_COL_USES
6
OLAP Dynamic Performance Views
V$ Tables for OLAP
Summary of OLAP Dynamic Performance Views
V$AW_AGGREGATE_OP
V$AW_ALLOCATE_OP
V$AW_CALC
V$AW_LONGOPS
V$AW_OLAP
V$AW_SESSION_INFO
7
CWM2_OLAP_CATALOG
Understanding Measure Folders
Example: Creating a Measure Folder
Summary of CWM2_OLAP_CATALOG Subprograms
ADD_CATALOG_ENTITY Procedure
CREATE_CATALOG Procedure
DROP_CATALOG Procedure
LOCK_CATALOG Procedure
REMOVE_CATALOG_ENTITY Procedure
SET_CATALOG_NAME Procedure
SET_DESCRIPTION Procedure
SET_PARENT_CATALOG Procedure
8
CWM2_OLAP_CLASSIFY
OLAP Catalog Metadata Descriptors
Example: Creating Descriptors
Summary of CWM2_OLAP_CLASSIFY Subprograms
ADD_ENTITY_CARDINALITY_USE
ADD_ENTITY_DEFAULTMEMBER_USE
ADD_ENTITY_DENSEINDICATOR_USE
ADD_ENTITY_DESCRIPTOR_USE
ADD_ENTITY_FACTJOIN_USE
REMOVE_ENTITY_DESCRIPTOR_USE
9
CWM2_OLAP_CUBE
Understanding Cubes
Example: Creating a Cube
Summary of CWM2_OLAP_CUBE Subprograms
ADD_DIMENSION_TO_CUBE Procedure
CREATE_CUBE Procedure
DROP_CUBE Procedure
LOCK_CUBE Procedure
REMOVE_DIMENSION_FROM_CUBE Procedure
SET_AGGREGATION_OPERATOR Procedure
SET_CUBE_NAME Procedure
SET_DEFAULT_CUBE_DIM_CALC_HIER Procedure
SET_DESCRIPTION Procedure
SET_DISPLAY_NAME Procedure
SET_MV_SUMMARY_CODE Procedure
SET_SHORT_DESCRIPTION Procedure
10
CWM2_OLAP_DELETE
Deleting OLAP Catalog Metadata
Rebuilding OLAP Catalog Metadata
Using Wildcards to Identify Metadata Entities
Using a Command Report
Summary of CWM2_OLAP_DELETE Subprograms
DELETE_CUBE Procedure
DELETE_DIMENSION Procedure
DELETE_MEASURE_CATALOG Procedure
DELETE_OLAP_CATALOG Procedure
11
CWM2_OLAP_DIMENSION
Understanding Dimensions
Example: Creating a CWM2 Dimension
Summary of CWM2_OLAP_DIMENSION Subprograms
CREATE_DIMENSION Procedure
DROP_DIMENSION Procedure
LOCK_DIMENSION Procedure
SET_DEFAULT_DISPLAY_HIERARCHY Procedure
SET_DESCRIPTION Procedure
SET_DIMENSION_NAME Procedure
SET_DISPLAY_NAME Procedure
SET_PLURAL_NAME Procedure
SET_SHORT_DESCRIPTION Procedure
12
CWM2_OLAP_DIMENSION_ATTRIBUTE
Understanding Dimension Attributes
Example: Creating a Dimension Attribute
Summary of CWM2_OLAP_DIMENSION_ATTRIBUTE Subprograms
CREATE_DIMENSION_ATTRIBUTE Procedure
DROP_DIMENSION_ATTRIBUTE Procedure
LOCK_DIMENSION_ATTRIBUTE Procedure
SET_DESCRIPTION Procedure
SET_DIMENSION_ATTRIBUTE_NAME Procedure
SET_DISPLAY_NAME Procedure
SET_SHORT_DESCRIPTION Procedure
13
CWM2_OLAP_EXPORT
Exporting and Importing OLAP Catalog Metadata
Rebuilding OLAP Catalog Metadata
Using the Oracle Export and Import Utilities
Using Wildcards to Identify Metadata Entities
Creating a Metadata Command Script
Creating an Export Parameter File
Summary of CWM2_OLAP_Export Subprograms
EXPORT_CUBE Procedure
EXPORT_DIMENSION Procedure
EXPORT_OLAP_CATALOG Procedure
14
CWM2_OLAP_HIERARCHY
Understanding Hierarchies
Example: Creating a Hierarchy
Summary of CWM2_OLAP_HIERARCHY Subprograms
CREATE_HIERARCHY Procedure
DROP_HIERARCHY Procedure
LOCK_HIERARCHY Procedure
SET_DESCRIPTION Procedure
SET_DISPLAY_NAME Procedure
SET_HIERARCHY_NAME Procedure
SET_SHORT_DESCRIPTION Procedure
SET_SOLVED_CODE Procedure
15
CWM2_OLAP_LEVEL
Understanding Levels
Example: Creating a Level
Summary of CWM2_OLAP_LEVEL Subprograms
ADD_LEVEL_TO_HIERARCHY Procedure
CREATE_LEVEL Procedure
DROP_LEVEL Procedure
LOCK_LEVEL Procedure
REMOVE_LEVEL_FROM_HIERARCHY Procedure
SET_DESCRIPTION Procedure
SET_DISPLAY_NAME Procedure
SET_LEVEL_NAME Procedure
SET_PLURAL_NAME Procedure
SET_SHORT_DESCRIPTION Procedure
16
CWM2_OLAP_LEVEL_ATTRIBUTE
Understanding Level Attributes
Example: Creating Level Attributes
Summary of CWM2_OLAP_LEVEL_ATTRIBUTE Subprograms
CREATE_LEVEL_ATTRIBUTE Procedure
DROP_LEVEL_ATTRIBUTE Procedure
LOCK_LEVEL_ATTRIBUTE Procedure
SET_DESCRIPTION Procedure
SET_DISPLAY_NAME Procedure
SET_LEVEL_ATTRIBUTE_NAME Procedure
SET_SHORT_DESCRIPTION Procedure
17
CWM2_OLAP_MANAGER
Managing Output in a SQL*Plus Session
Example: Using a Log File
Summary of CWM2_OLAP_MANAGER Subprograms
BEGIN_LOG Procedure
END_LOG Procedure
LOG_NOTE Procedure
SET_ECHO_OFF Procedure
SET_ECHO_ON Procedure
18
CWM2_OLAP_MEASURE
Understanding Measures
Example: Creating a Measure
Summary of CWM2_OLAP_MEASURE Subprograms
CREATE_MEASURE Procedure
DROP_MEASURE Procedure
LOCK_MEASURE Procedure
SET_DESCRIPTION Procedure
SET_DISPLAY_NAME Procedure
SET_MEASURE_NAME Procedure
SET_SHORT_DESCRIPTION Procedure
19
CWM2_OLAP_METADATA_REFRESH
Views of Cached OLAP Catalog Metadata
Views of Cached Active Catalog Metadata
Summary of CWM2_OLAP_METADATA_REFRESH Subprograms
MR_REFRESH Procedure
MR_AC_REFRESH Procedure
20
CWM2_OLAP_PC_TRANSFORM
Prerequisites
Parent-Child Dimensions
Solved, Level-Based Dimensions
Example: Creating a Solved, Level-Based Dimension Table
Grouping ID Column
Embedded Total Key Column
Summary of CWM2_OLAP_PC_TRANSFORM Subprograms
CREATE_SCRIPT Procedure
21
CWM2_OLAP_TABLE_MAP
Understanding OLAP Catalog Metadata Mapping
Example: Mapping a Dimension
Example: Mapping a Cube
Summary of CWM2_OLAP_TABLE_MAP Subprograms
MAP_DIMTBL_HIERLEVELATTR Procedure
MAP_DIMTBL_HIERLEVEL Procedure
MAP_DIMTBL_HIERSORTKEY Procedure
MAP_DIMTBL_LEVELATTR Procedure
MAP_DIMTBL_LEVEL Procedure
MAP_FACTTBL_LEVELKEY Procedure
MAP_FACTTBL_MEASURE Procedure
REMOVEMAP_DIMTBL_HIERLEVELATTR Procedure
REMOVEMAP_DIMTBL_HIERLEVEL Procedure
REMOVEMAP_DIMTBL_HIERSORTKEY Procedure
REMOVEMAP_DIMTBL_LEVELATTR Procedure
REMOVEMAP_DIMTBL_LEVEL Procedure
REMOVEMAP_FACTTBL_LEVELKEY Procedure
REMOVEMAP_FACTTBL_MEASURE Procedure
22
CWM2_OLAP_VALIDATE
About OLAP Catalog Metadata Validation
Structural Validation
Cubes
Dimensions
Mapping Validation
Cubes
Dimensions
Validation Type
Using Wildcards to Identify Metadata Entities
Summary of CWM2_OLAP_VALIDATE Subprograms
VALIDATE_ALL_CUBES Procedure
VALIDATE_ALL_DIMENSIONS Procedure
VALIDATE_CUBE Procedure
VALIDATE_DIMENSION Procedure
VALIDATE_OLAP_CATALOG Procedure
23
CWM2_OLAP_VERIFY_ACCESS
Validating the Accessibility of an OLAP Cube
Summary of CWM2_OLAP_VERIFY_ACCESS Subprograms
VERIFY_CUBE_ACCESS Procedure
24
DBMS_AW
Managing Analytic Workspaces
Converting an Analytic Workspace to Oracle 10
g
Storage Format
Procedure: Convert an Analytic Workspace from 9
i
to10
g
Storage Format
Procedure: Import a workspace from a 9
i
Database into a 10
g
Database
Embedding OLAP DML in SQL Statements
Methods for Executing OLAP DML Commands
Guidelines for Using Quotation Marks in OLAP DML Commands
Using the Sparsity Advisor
Data Storage Options in Analytic Workspaces
Selecting the Best Data Storage Method
Using the Sparsity Advisor
Example: Evaluating Sparsity in the GLOBAL Schema
Advice from Sample Program
Information Stored in GLOBAL_SPARSITY_ADVICE Table
Using the Aggregate Advisor
Aggregation Facilities within the Workspace
Example: Using the ADVISE_REL Procedure
Summary of DBMS_AW Subprograms
ADD_DIMENSION_SOURCE Procedure
ADVISE_CUBE Procedure
ADVISE_DIMENSIONALITY Function
ADVISE_DIMENSIONALITY Procedure
ADVISE_REL Procedure
ADVISE_SPARSITY Procedure
AW_ATTACH Procedure
AW_COPY Procedure
AW_CREATE Procedure
AW_DELETE
AW_DETACH Procedure
AW_RENAME Procedure
AW_TABLESPACE Function
AW_UPDATE Procedure
CONVERT Procedure
EVAL_NUMBER Function
EVAL_TEXT Function
EXECUTE Procedure
GETLOG Function
INFILE Procedure
INTERP Function
INTERPCLOB Function
INTERP_SILENT Procedure
OLAP_ON Function
OLAP_RUNNING Function
PRINTLOG Procedure
RUN Procedure
SHUTDOWN Procedure
SPARSITY_ADVICE_TABLE Procedure
STARTUP Procedure
25
DBMS_AW_XML
Analytic Workspace Java API Overview
Oracle OLAP XML Schema
Summary of DBMS_AW_XML Subprograms
EXECUTE Function
EXECUTEFILE Function
26
DBMS_AWM
Parameters of DBMS_AWM Subprograms
Summary of DBMS_AWM Subprograms
ADD_AWCOMP_SPEC_COMP_MEMBER Procedure
ADD_AWCOMP_SPEC_MEMBER Procedure
ADD_AWCUBEAGG_SPEC_LEVEL Procedure
ADD_AWCUBEAGG_SPEC_MEASURE Procedure
ADD_AWCUBELOAD_SPEC_COMP Procedure
ADD_AWCUBELOAD_SPEC_FILTER Procedure
ADD_AWCUBELOAD_SPEC_MEASURE Procedure
ADD_AWDIMLOAD_SPEC_FILTER Procedure
AGGREGATE_AWCUBE Procedure
CREATE_AWCOMP_SPEC Procedure
CREATE_AWCUBE Procedure
CREATE_AWCUBE_ACCESS Procedure
CREATE_AWCUBE_ACCESS_FULL Procedure
CREATE_AWCUBEAGG_SPEC Procedure
CREATE_AWCUBELOAD_SPEC Procedure
CREATE_AWDIMENSION Procedure
CREATE_AWDIMENSION_ACCESS Procedure
CREATE_AWDIMENSION_ACCESS_FULL Procedure
CREATE_AWDIMLOAD_SPEC Procedure
CREATE_DYNAMIC_AW_ACCESS Procedure
DELETE_AWCOMP_SPEC Procedure
DELETE_AWCOMP_SPEC_MEMBER Procedure
DELETE_AWCUBE_ACCESS Procedure
DELETE_AWCUBE_ACCESS_ALL Procedure
DELETE_AWCUBEAGG_SPEC Procedure
DELETE_AWCUBEAGG_SPEC_LEVEL Procedure
DELETE_AWCUBEAGG_SPEC_MEASURE Procedure
DELETE_AWCUBELOAD_SPEC Procedure
DELETE_AWCUBELOAD_SPEC_COMP Procedure
DELETE_AWCUBELOAD_SPEC_FILTER Procedure
DELETE_AWCUBELOAD_SPEC_MEASURE Procedure
DELETE_AWDIMENSION_ACCESS Procedure
DELETE_AWDIMENSION_ACCESS_ALL Procedure
DELETE_AWDIMLOAD_SPEC Procedure
DELETE_AWDIMLOAD_SPEC_FILTER Procedure
REFRESH_AWCUBE Procedure
REFRESH_AWCUBE_VIEW_NAME Procedure
REFRESH_AWDIMENSION Procedure
REFRESH_AWDIMENSION_VIEW_NAME Procedure
SET_AWCOMP_SPEC_CUBE Procedure
SET_AWCOMP_SPEC_MEMBER_NAME Procedure
SET_AWCOMP_SPEC_MEMBER_POS Procedure
SET_AWCOMP_SPEC_MEMBER_SEG Procedure
SET_AWCOMP_SPEC_NAME Procedure
SET_AWCUBE_VIEW_NAME Procedure
SET_AWCUBEAGG_SPEC_AGGOP Procedure
SET_AWCUBELOAD_SPEC_CUBE Procedure
SET_AWCUBELOAD_SPEC_LOADTYPE Procedure
SET_AWCUBELOAD_SPEC_NAME Procedure
SET_AWCUBELOAD_SPEC_PARAMETER Procedure
SET_AWDIMENSION_VIEW_NAME Procedure
SET_AWDIMLOAD_SPEC_DIMENSION Procedure
SET_AWDIMLOAD_SPEC_LOADTYPE Procedure
SET_AWDIMLOAD_SPEC_NAME Procedure
SET_AWDIMLOAD_SPEC_PARAMETER Procedure
UPGRADE_AW_TO_10_2 Procedure
27
DBMS_ODM
Materialized Views for the OLAP API
Materialized Views Created by DBMS_OMDM
Generating the Grouping Sets
Automatically Calculate the Grouping Sets
Manually Calculate the Grouping Sets
Aggregation Operators
Example: Automatically Generate the Minimum Grouping Sets for a Cube
Example: Manually Choose the Grouping Sets for a Cube
Summary of DBMS_ODM Subprograms
CREATECUBELEVELTUPLE Procedure
CREATEDIMLEVTUPLE Procedure
CREATEDIMMV_GS Procedure
CREATEFACTMV_GS Procedure
CREATESTDFACTMV Procedure
28
OLAP_API_SESSION_INIT
Initialization Parameters for the OLAP API
Viewing the Configuration Table
ALL_OLAP_ALTER_SESSION View
Summary of OLAP_API_SESSION_INIT Subprograms
ADD_ALTER_SESSION Procedure
CLEAN_ALTER_SESSION Procedure
DELETE_ALTER_SESSION Procedure
29
OLAP_CONDITION
OLAP_CONDITION Overview
Entry Points in the Limit Map
Dynamically Modifying a Workspace during a Query
OLAP_CONDITION Examples
OLAP_CONDITION Syntax
30
OLAP_EXPRESSION
OLAP_EXPRESSION Overview
Single-Row Functions
OLAP_EXPRESSION and OLAP_TABLE
OLAP_EXPRESSION Examples
OLAP_EXPRESSION Syntax
31
OLAP_EXPRESSION_BOOL
OLAP_EXPRESSION_BOOL Overview
Single-Row Functions
OLAP_EXPRESSION_BOOL and OLAP_TABLE
OLAP_EXPRESSION_BOOL Example
OLAP_EXPRESSION_BOOL Syntax
32
OLAP_EXPRESSION_DATE
OLAP_EXPRESSION_DATE Overview
Single-Row Functions
OLAP_EXPRESSION_DATE and OLAP_TABLE
OLAP_EXPRESSION_DATE Syntax
33
OLAP_EXPRESSION_TEXT
OLAP_EXPRESSION_TEXT Overview
Single-Row Functions
OLAP_EXPRESSION_TEXT and OLAP_TABLE
OLAP_EXPRESSION_TEXT Syntax
34
OLAP_TABLE
OLAP_TABLE Overview
Limit Maps
Logical Tables
Using OLAP_TABLE With Predefined ADTs
Using OLAP_TABLE With Automatic ADTs
Using a MODEL Clause
OLAP_TABLE Examples
Example: Creating Views of Embedded Total Dimensions
Example: Creating Views of Embedded Total Measures
Example: Creating Views in Rollup Form
Using OLAP_TABLE with the FETCH Command
OLAP_TABLE Syntax
Analytic Workspace Parameter
Table Object Parameter
OLAP Command Parameter
Limit Map Parameter
Order of Processing in OLAP_TABLE
Index