OAC-Essbase Data Load & Dimension
Build Using CLI
Introduction
I am working with one of the
Oracle EPM Cloud implementation projects which is focused on migrating
on-premise Essbase applications to Oracle Analytics Cloud (OAC) Essbase cloud
applications. The OAC Essbase provides Command Line Interface utilities which
can be used for data load and dimension build in OAC Essbase applications. This
document explains about how to use the utility for data load and dimension
build in OAC.
Utilities
Command Line Utility - We can download the Command Line Tool from OAC Essbase instance to our local machine to perform the Essbase data load and dimension build tasks
Setting up CLI environment
- Open the command prompt and change the directory to CLI home directory.
- To use Command line interface, Java JDK 8 should be installed and the JAVA_HOME path should be set
- Set the CLI Home and Java Home:
SET CLI_HOME=D:\CommandLineUtility
SET JAVA_HOME=C:\Program Files\Java\jdk1.8.0_161
Logging into OAC Essbase through CLI
Before performing Dimension build and data load activities, we need to be logged into OAC Essbase.
Logging into OAC using admin id:
D:\CommandLineUtility> esscs login -user TestAdmin -password ****** -url https://test.OAC.com/essbase
user " TestAdmin " logged in with "service_administrator" role
Oracle Analytics Cloud - Essbase version = 12.2.1.1.112, build = 211
Create Data Base local Connection
- The DB local connection can be created using CLI command createlocalconnection. It takes all the required JDBC connection details as arguments.
Command Syntax:
D:\CommandLineUtility>esscs createLocalConnection -name oraConn -connectionString jdbc:oracle:thin:@DevDW:1XXX/DevID -user DB_USER
Connection already exists, it will be overwritten
Enter Password:
User
credentials stored successfully
Essbase Dimension Build
- Run the dim build command with stream option
- Database query is required either in the rules file or must be provided as argument for dimbuild. If not given in command, it is taken from the rules file.
- The streaming API is used to push the result from database to cube.
Command Syntax:
D:\CommandLineUtility>esscs dimbuild -application TEST -db TEST -rule Acct.rul -stream -restructureOption ALL_DATA -connection oraConn
Streaming to Essbase...
Streamed 9 rows to cube
Essbase Data Load
- Run the Data load command with stream option
- Database query is required either in the rules file or must be provided as argument for data load. If not given in command, it is taken from the rules file
Command Syntax:
D:\CommandLineUtility>esscs dataload [-v] -application TEST -db TEST -rule DataLoad.rul -stream -connection oraConn
Streaming to Essbase...
Streamed 10 rows to cube
Reference(s):
1.https://docs.oracle.com/en/cloud/paas/analytics-cloud/essug/command-line-interface-cli.html.
2.https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=442454943227210&parent=EXTERNAL_SEARCH&sourceId=HOWTO&id=2259032.1&_afrWindowMode=0&_adf.ctrl-state=aphtjq7kl_132.