CONVERT Procedure

The CONVERT procedure converts an analytic workspace in 9i storage format to to 10g storage format. Note that you cannot execute this procedure from within the OLAP Worksheet; you must execute if in a SQL tool such as SQL*Plus.

Note:

Issuing the dbms_aw.convert procedure is only one small step in upgrading Oracle 9i analytic workspaces to Oracle 10g workspaces. For the complete procedure for upgrading Oracle 9i analytic workspaces, see Oracle OLAP Application Developer's Guide, 10g Release 2 (10.2).

See:

For information on converting an analytic workspace to Oracle 11g storage format, see Oracle OLAP User's Guide.

Syntax

CONVERT (
          original_aw      IN VARCHAR2);

CONVERT ( 
          original_aw      IN VARCHAR2,
          converted_aw     IN VARCHAR2,
          tablespace       IN NUMBER DEFAULT);

Parameters

Table B-19 CONVERT Procedure Parameters

Parameter	Description
`original_aw`	The analytic workspace you want to convert.
`converted_aw`	The converted analytic workspace.
`tablespace`	The name of a tablespace in which the converted workspace is stored. If this parameter is omitted, then the analytic workspace is created in the user's default tablespace.

Example

This example performs the conversion in a single step, using the analytic workspace as both the source and the target of the conversion.

EXECUTE dbms_aw.convert('global');

The next example performs the conversion in several steps. The converted workspace must have the same name as the original workspace, because the fully qualified names of objects in the workspace include the workspace name.

EXECUTE dbms_aw.rename('global', 'global_temp');
EXECUTE dbms_aw.convert('global_temp', 'global');
EXECUTE dbms_aw.delete('global_temp');