LOCK_DIMENSION Procedure

This procedure locks the dimension metadata for update by acquiring a database lock on the row that identifies the dimension in the OLAP 2 Catalog.

Syntax

LOCK_DIMENSION (
           dimension_owner     IN   VARCHAR2,
           dimension_name      IN   VARCHAR2.
           wait_for_lock       IN   BOOLEAN DEFAULT FALSE);

Parameters

Table 17-7 LOCK_DIMENSION Procedure Parameters

Parameter	Description
dimension_owner	Owner of the dimension.
dimension_name	Name of the dimension.
wait_for_lock	(Optional) Whether or not to wait for the dimension to be available when it is already locked by another user. If you do not specify a value for this parameter, the procedure does not wait to acquire the lock.

Exceptions

Table 17-8 LOCK_DIMENSION Procedure Exceptions

Exception	Description
no_access_privileges	User does not have the necessary privileges. User must be the owner and have the OLAP_DBA role.
dimension_not_found	Cannot lock dimension. Dimension does not exist within the OLAP 2 Catalog.