---

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