マルチソース・セッション変数の使用

Oracle Business Intelligenceは、複数のデータ・ソースから移入されるセッション変数をサポートします。

このようなマルチソース・セッション変数は論理問合せまたはリポジトリのデータ・フィルタ内で使用でき、様々なデータ・ソースからの値の結合を含めることができます。

マルチソース・セッション変数が保持できる値の数に制限はありません。マルチソース・セッション変数を作成するには、まず、ソースごとに行単位の初期化ブロックを作成します。

次に、ソースごとにセッション変数を明示的に定義します。セッション変数名のフォーマットは、次のようにする必要があります。

• <ms_variable_name>____<source>

ここで、セパレータは4つのアンダースコア文字である必要があります。

これによって、次の名前のマルチソース・セッション変数1つが自動的に作成されます。

• <ms_variable_name>

コンポーネント・セッション変数名(<ms_variable_name>____<source>)は、管理ツールの「変数マネージャ」には個別に表示されますが、「式ビルダー」では1つのマルチソース・セッション変数名(<ms_variable_name>)のみが表示されます。

注意:

この項では主としてマルチソース・セッション変数の定義と使用法について説明していますが、論理問合せとデータ・フィルタでコンポーネント・セッションの値を選択することもできます。

行単位の初期化ブロックのいずれかがNULL結果を返した場合、それはOracle BIサーバーのログ、nqserver.logに記録されます。正常に値を返した他のコンポーネント初期化ブロックのマルチソース・セッション変数にも値を追加できます。マルチソース・セッション変数は、すべてのコンポーネント初期化ブロックがNULL値を返した場合のみ失敗します。

マルチソース・セッション変数についても、通常のセッション変数と同様に、実行優先度と遅延実行を設定できます。

マルチソース・セッション変数の作成と使用方法の説明例

次の例を使用して、マルチソース・セッション変数の作成方法を説明します。

次の例では、マルチソース・セッション変数の作成と使用方法を示しています。

1. 管理ツールの「変数マネージャ」で、「アクション」→「新規」→「セッション」→「初期化ブロック」を選択します。

2. デフォルトの初期化文字列に対して次のSQLを指定して、mvcountry_sebl_initという行単位の初期化ブロックを作成します。

   select distinct 'MVCOUNTRY____SEBL', country from siebel_table
   

3. デフォルトの初期化文字列に対して次のSQLを指定して、mvcountry_orcl_initという行単位の初期化ブロックを作成します。

   select distinct 'MVCOUNTRY____ORCL', country from oracle_table
   

4. まだ「変数マネージャ」で、「アクション」→「新規」→「セッション」→「変数」を選択します。

5. MVCOUNTRY____SEBLというセッション変数を、変数名とソース名の間に4つのアンダースコアが含まれていることを確認して、作成します。「初期化ブロック」に対してmvcountry_sebl_initを選択します。

6. MVCOUNTRY____ORCLという2つ目のセッション変数を、変数名とソース名の間に4つのアンダースコアが含まれていることを確認して、作成します。「初期化ブロック」に対してmvcountry_orcl_initを選択します。

コンポーネント・セッション変数は「変数マネージャ」に表示されるのに対し、作成されたMVCOUNTRYマルチソース・セッション変数は「式ビルダー」に表示されます。

論理問合せでのマルチソース・セッション変数の使用方法

これで、MVCOUNTRYマルチソース・セッション変数を論理問合せで使用できるようになりました。

次に例を示します。

select lastName, firstName, country from employee 
where country=VALUEOF(NQ_SESSION.MVCOUNTRY)

データ・フィルタでのマルチソース・セッション変数の使用方法

MVCOUNTRYマルチソース・セッション変数をデータ・フィルタで使用するには、次の手順を実行します。

1. 管理ツールで、「管理」を選択し、「アイデンティティ」を選択します。
2. 「Identity Manager」ダイアログのツリー・ペインで、「BIリポジトリ」を選択します。
3. 右のペインで「アプリケーション・ロール」タブを選択し、データ・フィルタを設定するアプリケーション・ロールをダブルクリックします。
4. 「アプリケーション・ロール」ダイアログで「権限」をクリックします。
5. 「ユーザー/アプリケーション・ロール権限」ダイアログで、「データ・フィルタ」タブをクリックします。
6. 「データ・フィルタ」タブで、次のデータ・フィルタ式を作成します。

   • Country=VALUEOF(NQ_SESSION.MVCOUNTRY)

   
   GUID-D720A430-0AB9-47E8-B7DE-01D039CD1DD0-default.gifの説明

次のイメージに示すように、「式ビルダー」には、MVCOUNTRYマルチソース・セッション変数のみが表示され、このマルチソース・セッション変数の作成に使用した通常のセッション変数は表示されません。

GUID-4E708A69-242A-4555-8F5C-D33CC0F2FC78-default.gifの説明