CLEARDATA
The CLEARDATA calculation command clears data values from slices of the Essbase cube, setting the cleared values to #MISSING. This command is useful when you need to clear existing data values before loading new values into a block storage cube.
Syntax
CLEARDATA mbrName;
Parameters
Notes
-
CLEARDATA can only clear a section of the cube. It cannot clear the entire cube. To clear the entire cube, use the alter database MaxL statement with the reset keyword.
-
CLEARDATA does not work if placed in an IF statement.
-
Generally, use CLEARBLOCK instead of CLEARDATA if you wish to remove blocks from the cube, which can improve performance.
-
To use this command with parallel calculation, use FIXPARALLEL...ENDFIXPARALLEL instead of SET CALCPARALLEL.
-
Using CLEARDATA in a FIX statement on a sparse dimension clears the data and removes the blocks, to improve performance. Blocks are cleared only if the entire CLEARDATA block is selected by the FIX (no dense dimensions in the FIX), and the block is update-able (it is not a replicated-partition target region). If you wish to retain empty blocks, then in the FIX statement, set the blocks to #MISSING, instead of using CLEARDATA.
For example, the following command block clears New York data and removes the block (because Market is sparse):
FIX("East") CLEARDATA "New York"; ENDFIX
The following command block sets New York data values to #MISSING without removing the blocks:
FIX("East") "New York" = #Missing; ENDFIX
Example
CLEARDATA Budget;
Clears all Budget data.
CLEARDATA Budget->Colas;
Clears only Budget data for the Colas product family.