ADVISE_PARTITIONING_LEVELファンクション

ADVISE_PARTITIONING_LEVELファンクションは、ディメンションのパーティション化を行う際にスパース性アドバイザで使用されたレベルを返します。スパース性アドバイザによってキューブがディメンション化されていない場合はNULLを返し、ディメンション階層がレベルベースでない場合は例外が発生します。

注意:

OLAPワークシート内からはこのファンクションを実行できません。SQL*PlusなどのSQLツール内で実行してください。

関連項目:

「スパース性アドバイザの使用」

構文

ADVISE_PARTITIONING_LEVEL (
          cubename   IN  VARCHAR2,
          sources    IN  dbms_aw$_dimension_sources_t,
          advtable   IN  VARCHAR2 DEFAULT NULL)
     RETURN VARCHAR2;

パラメータ

表B-7 ADVISE_PARTITIONING_LEVELファンクションのパラメータ

パラメータ	説明
`cubename`	`ADVISE_SPARSITY`へのコールで提供されるものと同一のcubename値。
`sources`	`ADVISE_SPARSITY`での使用のために`ADD_DIMENSION_SOURCE`によって移入された、`DBMS_AW$_DIMENSION_SOURCES_T`のデータ型で定義されるオブジェクト(PL/SQL変数など)の名前。
`advtable`	分析結果を格納するために`SPARSITY_ADVICE_TABLE`プロシージャで作成される表の名前。

例

次のプログラムの抜粋は、スパース性アドバイザの使用後に結果を問い合せる際に使用するADVISE_PARTITIONING_LEVELファンクションを示しています。

DECLARE
     dimsources dbms_aw$_dimension_sources_t;
BEGIN
-- Calls to ADD_DIMENSION_SOURCE and ADVISE_SPARSITY omitted here
     .
     .
     .
dbms_output.put_line('Partitioning Level: ' || 
     dbms_aw.advise_partitioning_level('units_cube', dimsources,
    'aw_sparsity_advice'));
END;
/

このプログラムでは、DBMS_OUTPUTを使用して、パーティション化レベル(この場合はYEAR)を表示します。

Partitioning Level: year