ADVISE_SPARSITYプロシージャ

ADVISE_SPARSITYプロシージャは、ADD_DIMENSION_SOURCEプロシージャで提供されるディメンションに関する情報を使用し、スパース性についてファクト表を分析します。SPARSITY_ADVICE_TABLEプロシージャで作成される表に、分析結果を移入します。

注意:

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

参照:

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

出力の説明

表B-9で、ADVISE_SPARSITYによって生成される情報を説明します。

表B-9 出力列の説明

列	データ型	NULL	説明
`CUBENAME`	`VARCHAR2(100)`	`NOT NULL`	`ADVISE_SPARSITY`へのコールに含まれるcubenameの値。通常は論理キューブの名前。
`FACT`	`VARCHAR2(4000)`	`NOT NULL`	`ADVISE_SPARSITY`へのコールに含まれるファクトの値。1つ以上のアナリティック・ワークスペース変数のソース・データを提供するファクト表の名前。
`DIMENSION`	`VARCHAR2(100)`	`NOT NULL`	キューブのディメンションの論理名。`ADVISE_DIMENSIONALITY`へのコールで記述されるディメンション。
`DIMCOLUMN`	`VARCHAR2(100)`		ディメンション表に関連するファクト（ソース・ファクト表）のディメンション列の名前。
`DIMSOURCE`	`VARCHAR2(4000)`		ディメンション表の名前。
`MEMBERCOUNT`	`NUMBER(12,0)`		全レベルのディメンション・メンバーの総数。
`LEAFCOUNT`	`NUMBER(12,0)`		リーフ（または最小集計）レベルのディメンション・メンバーの数。
`ADVICE`	`VARCHAR2(10)`	`NOT NULL`	ディメンションのスパース性の評価（`DENSE`、`SPARSE`または`COMPRESSED`）。
`POSITION`	`NUMBER(4,0)`	`NOT NULL`	ディメンションの推奨される順序。
`DENSITY`	`NUMBER(11,8)`		他のディメンションと比較したスパース性を示す数。この数が大きくなるほど、ディメンションはスパースになる。
`PARTNUM`	`NUMBER(6,0)`	`NOT NULL`	`PARTBY`列および`PARTTOPS`列で記述されるパーティションの数。パーティション化が推奨されない場合、パーティションの最大数は`1`。
`PARTBY`	`CLOB`		このパーティションに格納する必要のある全ディメンション・メンバーのリスト。このリストは、`LONG`設定のサイズを大幅に増やさないかぎり、SQL*Plusで切り捨てられる。
`PARTTOPS`	`CLOB`		このパーティションにおける最上位レベルのディメンション・メンバーのリスト。

構文

ADVISE_SPARSITY (
          fact       IN      VARCHAR2,
          cubename   IN      VARCHAR2,
          dimsources IN      dbms_aw$_dimension_sources_t,
          advmode    IN      BINARY_INTEGER DEFAULT ADVICE_DEFAULT,
          partby     IN      BINARY_INTEGER DEFAULT PARTBY_DEFAULT,
          advtable   IN      VARCHAR2 DEFAULT NULL);

パラメータ

表B-10 ADVISE_SPARSITYプロシージャのパラメータ

パラメータ	説明
`fact`	ソースのファクト表の名前。
`cubename`	アナリティック・ワークスペースの論理キューブの名前など、分析されるファクトの名前。
`dimsources`	`ADD_DIMENSION_SOURCE`プロシージャがキューブのディメンションに関する情報を格納するオブジェクト型の名前。
`advmode`	表示したいアドバイスのレベル。次の値のいずれかを選択する。 `DBMS_AW.ADVICE_DEFAULT` `DBMS_AW.ADVICE_FAST` `DBMS_AW.ADVICE_FULL`
`partby`	パーティション化を制御するキーワード。次の値のいずれかを使用する。 `DBMS_AW.PARTBY_DEFAULT`: スパース性アドバイザを使用して、パーティション化が適切であるかどうかを判断する。 `DBMS_AW.PARTBY_NONE`: パーティション化を許可しない。 `DBMS_AW.PARTBY_FORCE`: パーティション化を強制的に行う。
`advtable`	分析結果を格納するためにプロシージャで作成される表の名前。

例

次のPL/SQLプログラムの抜粋では、UNITS_HISTORY_FACT表のスパース性を分析しています。

DECLARE
     dimsources dbms_aw$_dimension_sources_t;
BEGIN
-- Calls to ADD_DIMENSION_SOURCE for each dimension in the cube
                .
                .
                .
     dbms_aw.advise_sparsity('units_history_fact', 'units_cube', dimsources,
          dbms_aw.advice_default);

END;
/

次のSELECTコマンドは、分析結果を表示します。ここでは、1つの稠密なディメンション（CHANNEL）と3つの比較的スパースなディメンション（PRODUCT、CUSTOMER、TIME）があることが示されています。

SELECT fact, dimension, dimcolumn, membercount nmem, leafcount nleaf, advice, density
     FROM aw_sparsity_advice
     WHERE cubename='units_cube';

FACT                 DIMENSION    DIMCOLUMN     NMEM  NLEAF ADVICE          DENSITY
-------------------- ------------ ------------ ----- ------ ------------ ----------
units_history_fact   channel      channel_id       3      3 DENSE         .86545382
units_history_fact   product      item_id         36     36 SPARSE        .98706809
units_history_fact   customer     ship_to_id      61     62 SPARSE        .99257713
units_history_fact   time         month_id        96     80 SPARSE        .99415964