ユースケース4: カスタム・ファクトの追加

集計可能なメトリックを含むカスタム・ファクトを追加し、キーが定義された事前作成済ディメンションに結合できます。

事前作成済のSCM - 注文書サブジェクト領域には、必要なファクト- 自分のカスタム・ファクト・メトリックが含まれていません。このユースケースでは、「ファクト- 自分のカスタム」フォルダを「SCM - 受注」事前作成サブジェクト領域に追加します。このフォルダには、「カスタム・メジャー」というラベルの集計メトリックの合計が含まれます。カスタム・ファクトは、カスタム・ファクトで定義された外部キーを使用して、3つの事前作成済ディメンション「ディメンション- 在庫組織」、「ディメンション- 在庫品目」および「ディメンション- 日付グレゴリオ暦」に結合されます。

このユース・ケースでは、Fusion SCM Analyticsサブスクリプションが必要です。ただし、このユース・ケースで説明する概念は、他のFusion Data Intelligenceサブスクリプションに適用できます。ユース・ケースでは、Autonomous AI Lakehouseの事前構築された表とシノニムを参照し、カスタム・データベースの表とビューをモックできます。指定したFusion Data Intelligenceサブスクリプションをアクティブ化した場合は、提供されているサンプルを使用できます。カスタム表、マテリアライズド・ビュー、ビュー、カスタム・シノニム、データ拡張データセット・シノニムなど、独自のカスタムAutonomous AI Lakehouseオブジェクトのサンプル・オブジェクトを置き換えることをお薦めします。

このタスクでは、次を実行します。

次のタスクを使用して、このタスクを完了します:

既存のディメンション:
- ディメンション- 在庫品目
- ディメンション- 在庫組織
- ディメンション- 日付グレゴリオ暦

「セマンティック・モデル拡張のユース・ケースのサンプルのアップロード」を参照し、次の前提条件を満たしていることを確認します。

MySandbox5Mar25というサンドボックスを作成します。「サンドボックスの作成」を参照してください。または、「セマンティック・モデル拡張」ページで既存のサンドボックスを編集します。たとえば、MySandbox5Mar25サンドボックスをクリックします。

次のSQLスクリプトを使用して、FDI_X_CUSTOM_FACT_F_Vというタイトルのサンプル・ディメンション・ビューを作成します。

CREATE OR REPLACE VIEW FDI_X_CUSTOM_FACT_F_V AS 
(
SELECT ORDERED_DATE, ORGANIZATION_ID, INVENTORY_ITEM_ID, COUNT(*) AS CUSTOM_MEASURE 
FROM DW_OM_FULFILLMENT_CF
GROUP BY ORDERED_DATE, ORGANIZATION_ID, INVENTORY_ITEM_ID
);

次のSQLスクリプトを使用して、OAX$OACスキーマのFDI_X_CUSTOM_FACT_F_Vビューへのセマンティク・モデル・アクセス権を付与します。
```
GRANT SELECT ON "OAX_USER"."FDI_X_CUSTOM_FACT_F_V" TO "OAX$OAC";
```
次のSQLスクリプトを使用して、想定どおりにサンプルからデータがロードされていることを確認します。
```
SELECT * FROM OAX_USER.FDI_X_CUSTOM_FACT_F_V;
```

セマンティック・モデルへのカスタム・ファクトの追加

論理スターを作成して、自律型データ・ウェアハウス・オブジェクト、ファクト・メジャー、表示ラベル、キー、集計ルールおよびコンテンツ・レベルを定義します。

このステップでは、自律型データ・ウェアハウス・オブジェクトFDI_X_CUSTOM_FACT_F_Vを参照するカスタム・ファクト「ファクト- カスタム」を定義する論理スターを作成します。

「セマンティック・モデル拡張」ページで、MySandbox5Mar25サンドボックスをクリックします。
「アクションの実行」で、「論理スターの管理」、「論理スターの作成」の順にクリックし、「次へ」をクリックします。
論理スター: ファクト・ページで、「ファクトの追加」をクリックします。
ファクトの追加ページのウィザードのステップ1で、「スキーマ」の「OAX_USER」を選択し、「オブジェクト」の「FDI_X_CUSTOM_FACT_F_V」を選択し、「ファクト名」の名前を「ファクト – カスタム」に変更し、キー(キーに対してファクトを選択しない可能性が高い)を選択し、次のように属性をファクトとして選択します。
- 「ソース列」の下のORGANIZATION_ID、ORDERED_DATE、INVENTORY_ITEM_IDの「キーに使用」チェック・ボックスを選択します。
- 「ソース列」の下のCUSTOM_MEASUREの「ファクトの選択」チェック・ボックスを選択します。
「次へ」をクリックします。
ウィザードのステップ2で、「ファクト列」の「集計ルール」を「合計」に設定します。
「コンテンツ・レベル」アイコンをクリックします。
コンテンツ・レベルで、「ディメンションの追加」をクリックしてこれらのディメンションを追加し、表で推奨されているレベルを設定し、「OK」をクリックしてから、「終了」をクリックします:

ディメンションレベル

在庫組織詳細

在庫品目詳細

グレゴリオ暦日

ディメンション	レベル
在庫組織	詳細
在庫品目	詳細
グレゴリオ暦	日

カスタム・ファクトと事前作成済ディメンションの結合

事前作成済ディメンションを追加し、カスタム・ファクトで定義された外部キーを使用してカスタム・ファクトに結合します。

このステップでは、3つの事前作成済ディメンション、ディメンション – 在庫組織、ディメンション – 在庫品目およびディメンション – 日付グレゴリオ暦を追加し、カスタム・ファクトで定義された外部キーORGANIZATION_ID、ORDER_DATE、INVENTORY_ITEM_IDを使用してカスタム・ファクトファクト – 自分のカスタムに結合します。

論理スター: ファクト・ページで、「ディメンションの管理」をクリックし、「既存のディメンションの追加」をクリックします。
「表の追加」で、次の3つの既存のディメンションを検索して追加し、「OK」をクリックします:
- ディメンション- 在庫品目
- ディメンション- 在庫組織
- ディメンション- 日付グレゴリオ暦
グラフィカル・モードで追加を確認します。
事前作成済の各ディメンション(「ディメンション- 在庫組織」、「ディメンション- 在庫品目」および「ディメンション- 日付グレゴリオ暦」)をカスタム・ファクト(「ファクト- カスタム・ファクト」)にドラッグして、ディメンション・サークルからファクト・サークルにドラッグし、「結合」ダイアログを開きます。「結合」で、「結合タイプ」を「内部」として指定し、「結合条件の追加」をクリックして、次のように結合条件を追加し、適用可能なすべての結合条件を追加した後、「完了」をクリックします。
- 「ファクト- カスタム・ファクト」で、「組織ID (DOUBLE)」を選択し、「ディメンション- 在庫組織」で「在庫組織キー(DOUBLE)」を選択します。
- 「ファクト- カスタム・ファクト」で、「組織ID (DOUBLE)」を選択し、「ディメンション- 在庫品目」で「組織ID (DOUBLE)」を選択します。「在庫品目ID (DOUBLE)」カスタム・ファクトの場合は、「品目ID (DOUBLE)」ディメンションを選択します。
- 「ファクト- カスタム・ファクト」で、「オーダー日(DATE)」を選択し、「ディメンション- 日付グレゴリオ暦」で「日付(DATE)」を選択します。
グラフィカル・モードで結合を確認します。
表モードで結合を確認します。

セマンティック・モデルでのカスタム・ファクトの表示

サブジェクト領域を変更して、新しいカスタム・ファクトとその集計可能なメトリックを表示します。カスタム・ファクトは、サブジェクト領域のメジャー列を含むフォルダとして表示されます。

このステップでは、「SCM - 注文書」サブジェクト領域を変更して、「カスタム・メジャー」メジャー列を含む新しいファクト・フォルダ「ファクト- 自分のカスタム」を表示します。

「セマンティック・モデル拡張」ページで、MySandbox5Mar25サンドボックスに移動し、「アクションの実行」をクリックして、「サブジェクト領域の管理」をクリックし、「サブジェクト領域の作成」を選択して、「次」をクリックします。

ノート

サブジェクト領域を作成するか、既存のサブジェクト領域を変更できます。このユース・ケースではサブジェクト領域が作成されます。
サブジェクト領域の作成ページのウィザードのステップ1で、「既存のサブジェクト領域に基づくサブジェクト領域の作成」を選択し、「SCM - 受注」を選択し、「新規サブジェクト領域名」に「自分のカスタム・サブジェクト領域」と入力して、「次」をクリックします。
ウィザードのステップ2で、「要素の管理」をクリックし、「新規カスタマイズの管理」をクリックします。
サブジェクト領域の追加で、「カスタム・メジャー」を「ファクト- カスタム」から選択し、「追加」をクリックします。
SCM - 注文書サブジェクト領域では、「使用可能なデータ要素」の下にあるすべてを選択解除します。
論理スターでカスタム・ファクトに結合した事前作成済ディメンションを選択し、「次へ」をクリックします。
ウィザードのステップ3で、モデルでの表示方法を確認し、「カスタム・メジャー」の名前を「マイ・カウント」に変更して、「次」をクリックします。
カスタム・サブジェクト領域をレビューし、「次へ」をクリックします。
ウィザードのステップ4で、「終了」をクリックします。

カスタマイズの適用および公開

変更を適用してサンドボックスをコンパイルし、サンドボックスがエラーがないことを確認します。

次に、「アクティビティ」タブを使用して、デバッグ、エラーの解決、および「変更の適用」処理が完了して成功したことを確認します。最後に、変更をメイン・サンドボックスにマージし、メイン・ユーザー拡張を公開して、新しい拡張機能をコンシューマと共有します。

このステップでは、変更を適用し、「アクティビティ」タブを使用してステータスをモニターし、MySandbox5Mar25サンドボックスをメイン・サンドボックスにマージしてから、メイン・ユーザー拡張を公開します。

「セマンティック・モデル拡張」ページで、MySandbox5Mar25サンドボックスにマウス・ポインタを重ねて「アクション」を表示し、「変更の適用」をクリックします。
「アクティビティ」タブをクリックして、「アクティビティ」ページの「変更の適用」タスクをモニターします。
変更が正常に適用されたら、「セマンティック・モデル拡張」ページで「モデルの公開」をクリックします。
「パブリッシュ・モデル」の「ユーザー拡張」でMySandbox5Mar25を選択し、「セキュリティ構成」で「すべて」を選択します。
「公開」をクリックします。
「セマンティック・モデル拡張」ページで、「アクティビティ」タブをクリックして「カスタマイズの公開」タスクをモニターします。
変更の適用およびモデルの公開を参照してください。

結果の検証

セマンティック・モデルにカスタマイズが表示されていることを確認します。

Fusion Data Intelligenceコンソールで、「ホーム・ページに移動」をクリックします。
Oracle Analyticsのホーム・ページで、「作成」をクリックし、「ワークブック」をクリックして、「データの追加」で「自分のカスタム・サブジェクト領域」を選択し、「ワークブックに追加」をクリックします。
事前作成済の各ディメンションとカスタム・ファクトのカスタム・メジャー(ファクト- 自分のカスタム)から1つの列を取得するレポートを作成します。各ディメンション列から列を追加するときに、重複が発生しないようにします。このレポートでは、選択した事前作成済ディメンションをカスタム・ファクト・メジャーに正常に結合できることを確認します。