Usage Note 44765: When to use the short form of PROC OLAP code versus the long form of PROC OLAP code
When building or updating a SAS® OLAP cube from the full input data, there are two variations of the PROC OLAP code that you can specify. Both versions are explained next.
Long form of the PROC OLAP code
To build a new cube for the first time, or to update a cube by deleting the original cube's physical data and metadata, you can submit the long form of the PROC OLAP code. Below is a template of what that syntax looks like:
proc olap cube="CubeName" delete;
METASVR host="host" port=8561 protocol=bridge userid="sasdemo" pw="password"
repository="Foundation" olap_schema="SASApp - OLAP Schema";
run;
PROC OLAP data=input_table DrillThrough_Table=libref.drillthrough_table_name cube=Cubename
path='path_to_cube' Description="Cube description" ;
METASVR host="host" port=8561 protocol=bridge userid="sasdemo" pw="password"
repository="Foundation" olap_schema="SASApp - OLAP Schema";
DIMENSION ... ;
MEASURE ...;
AGGREGATION ... / NAME='Default' ;
DEFINE ...;
RUN;
This code can be obtained by exporting the long form of the PROC OLAP code for the cube from within SAS® OLAP Cube Studio. You will need to add in the USERID and PW options to the METASVR statement.
Short form of the PROC OLAP code
After you have defined the structure for your SAS OLAP cube and you no longer need to update the dimension, hierarchy, levels, or measures, you can do regular data updates to the OLAP cube by using the short form of the PROC OLAP code. The short form of the code reads the cube metadata in order to obtain information about the cube such as the structure and path. In addition, the short form preserves cube-level permissions and member-level security information, as well as associations with other metadata objects such as information maps and reports.
The first PROC OLAP step below deletes only the physical cube data, preserving the cube's metadata. The second PROC OLAP step rebuilds the physical cube data from metadata.
proc olap cube="CubeName" delete_physical;
METASVR host="host" port=8561 protocol=bridge userid="sasdemo" pw="password"
repository="Foundation" olap_schema="SASApp - OLAP Schema";
run;
proc olap cube="CubeName";
METASVR host="host" port=8561 protocol=bridge userid="sasdemo" pw="password"
repository="Foundation" olap_schema="SASApp - OLAP Schema";
run;
Starting with SAS 9.2, the short form of the PROC OLAP code can also be exported from within SAS OLAP Cube Studio.
Using the short form of the PROC OLAP code when updating your SAS OLAP cube results in the following benefits:
- Maintains existing cube metadata.
- Retains any cube-level or member-level security defined to the cube.
- Allows the PROC OLAP code used in your regular cube update jobs to remain constant, even if the cube structure is updated. This is possible because there are no references to dimensions, hierarchies, levels, or aggregations in the short form version of the PROC OLAP code.
Operating System and Release Information
SAS System | SAS OLAP Server | z/OS | 9.1 TS1M2 | |
Microsoft® Windows® for 64-Bit Itanium-based Systems | 9.1 TS1M2 | |
Microsoft Windows Server 2003 Datacenter 64-bit Edition | 9.1 TS1M2 | |
Microsoft Windows Server 2003 Enterprise 64-bit Edition | 9.1 TS1M2 | |
Microsoft Windows 2000 Advanced Server | 9.1 TS1M2 | |
Microsoft Windows 2000 Datacenter Server | 9.1 TS1M2 | |
Microsoft Windows 2000 Server | 9.1 TS1M2 | |
Microsoft Windows 2000 Professional | 9.1 TS1M2 | |
Microsoft Windows NT Workstation | 9.1 TS1M2 | |
Microsoft Windows Server 2003 Datacenter Edition | 9.1 TS1M2 | |
Microsoft Windows Server 2003 Enterprise Edition | 9.1 TS1M2 | |
Microsoft Windows Server 2003 Standard Edition | 9.1 TS1M2 | |
Microsoft Windows XP Professional | 9.1 TS1M2 | |
64-bit Enabled AIX | 9.1 TS1M2 | |
64-bit Enabled HP-UX | 9.1 TS1M2 | |
64-bit Enabled Solaris | 9.1 TS1M2 | |
HP-UX IPF | 9.1 TS1M2 | |
Linux | 9.1 TS1M2 | |
OpenVMS Alpha | 9.1 TS1M2 | |
Tru64 UNIX | 9.1 TS1M2 | |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.
Type: | Usage Note |
Priority: | |
Topic: | Query and Reporting ==> OLAP (Online Analytical Processing)
|
Date Modified: | 2011-12-08 11:50:51 |
Date Created: | 2011-10-31 13:19:14 |