Oracle Cloud Infrastructureドキュメント

ユースケース3: 事前作成済ファクトへのカスタム・ディメンションの追加

記述属性を含むカスタム・ディメンション・フォルダを追加し、カスタム・ディメンションを定義済キーで事前作成済のファクト表に結合できます。

事前作成済のSCM - 注文書サブジェクト領域には、必要なカスタム品目部門ディメンション属性が含まれていません。このユース・ケースでは、「カスタム・アイテム部門」フォルダを「SCM - 注文書」事前作成サブジェクト領域に追加します。このフォルダには、「部門」属性が含まれます。カスタム・ディメンションは、「組織ID」および「在庫品目ID」の複合キーを使用して、事前作成済の「ファクト- OM受注」ファクトに結合されます。

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

このタスクでは、次の操作を行います。
  1. セマンティック・モデルへのカスタム・ディメンションの追加
  2. 事前作成済ファクトへの物理列の追加
  3. カスタム・ディメンションの事前作成済ファクトへの結合
  4. セマンティック・モデルでのカスタム・ディメンションの表示
  5. カスタマイズの適用および公開
  6. 結果の検証
次のタスクを使用して、このタスクを完了します:
  • 属性- 部門
  • サブジェクトエリア- SCM - 注文書
  • ファクト・フォルダ- ディメンション- OM受注
「セマンティック・モデル拡張のユース・ケースのサンプルのアップロード」を参照し、次の前提条件を満たしていることを確認します。
  1. MySandbox5Mar25という名前のサンドボックスを作成します。サンドボックスの作成を参照してください。または、「セマンティック・モデル拡張」ページで既存のサンドボックスを編集します(たとえば、MySandbox5Mar25サンドボックスをクリック)。
  2. 次のSQLスクリプトを使用して、サンプル・ディメンション・ビューFDI_X_ITEM_CUSTOM_DEPARTMENT_D_Vを生成します。
    CREATE OR REPLACE FORCE EDITIONABLE VIEW "OAX_USER"."FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V" ("ORG_ITEM_KEY", "ORGANIZATION_ID", "INVENTORY_ITEM_ID", "DEPARTMENT") DEFAULT COLLATION "USING_NLS_COMP"  AS 
  (
SELECT ORGANIZATION_ID || INVENTORY_ITEM_ID AS ORG_ITEM_KEY,
ORGANIZATION_ID, INVENTORY_ITEM_ID,
CASE SUBSTR(INVENTORY_ITEM_ID,-1,1)
WHEN '1' THEN 'Clothing'
WHEN '2' THEN 'Shoes'
WHEN '3' THEN 'Cosmetics'
WHEN '4' THEN 'Furniture'
WHEN '5' THEN 'Gardening'
WHEN '6' THEN 'Hardware'
WHEN '7' THEN 'Home Appliances'
WHEN '8' THEN 'Houseware'
WHEN '9' THEN 'Paint'
WHEN '0' THEN 'Sporting Goods'
ELSE 'Other'
END DEPARTMENT
FROM OAX$OAC.DW_INVENTORY_ITEM_D
);
  3. 次のSQLスクリプトを使用して、OAX$OACスキーマのFDI_X_ITEM_CUSTOM_DEPARTMENT_D_Vビューへのセマンティック・モデル・アクセス権を付与します。
    GRANT SELECT ON "OAX_USER"."FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V" TO "OAX$OAC";
  4. 次のSQLスクリプトを使用して、想定どおりにサンプルからデータがロードされていることを確認します。
    SELECT * FROM OAX_USER.FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V;

セマンティック・モデルへのカスタム・ディメンションの追加

論理スターを編集して、自律型データ・ウェアハウス・オブジェクト、属性、表示ラベル、キーおよび階層を定義します。

このステップでは、「ファクト-OM販売オーダー」論理スターを編集して、自律型データ・ウェアハウス・オブジェクトFDI_X_ITEM_CUSTOM_DEPARTMENT_D_Vを参照するカスタム・ディメンション「カスタム品目部門」を追加します。
  1. 「セマンティック・モデル拡張」ページで、MySandbox5Mar25サンドボックスをクリックします。
  2. In Perform Action, click Manage Logical Star, then Edit Logical Star, then Out of the box, then select SCM - Sales Orders as the subject area, select Fact - OM Sales Orders as the corresponding fact, and then click Next.
  3. 論理スター: ファクト・ページで、「ディメンションの管理」をクリックし、「ディメンションの追加」をクリックします。

    「ディメンションの管理」値リストが表示された「論理スター: ファクト」ページ

  4. In step 1 of the Add a Dimension wizard, select OAX_USER in Schema, select FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V in Object, and enter Custom Item Department in Dimension Name.「DEPARTMENT」および「ORG_ITEM_KEY」の「属性の追加」チェック・ボックスを選択します。INVENTORY_ITEM_ID、ORGANIZATION_IDおよびORG_ITEM_KEYの「キーに使用」チェック・ボックスを選択します。「次へ」をクリックします。

    ウィザードのステップ1が表示された「ディメンションの追加」ページ

  5. ウィザードのステップ2で、「サブジェクト領域への階層の追加」チェック・ボックスの選択を解除したままにして、階層を省略します。ただし、階層に名前を付け、主キーと表示属性を論理スターにマップする必要があります。ただし、階層はサブジェクト領域に表示されません。このステップを次のように実行します。
    • 「カスタム・アイテム部門階層」を「階層名」に入力します。
    • 「プロパティ」で、次のように主キーおよび表示属性を定義します。
      • 「主キー」の鉛筆アイコンをクリックし、「組織品目キー」を選択します。
      • 「属性の表示」の鉛筆アイコンをクリックし、「組織品目キー」を選択します。
    • 「選択したデータ要素」で、「使用可能なデータ要素」から、「部門」および「組織項目キー」を「詳細」レベルにドラッグして追加します。
      ノート

      ディメンション表示属性は、レベルまたは詳細レベルのいずれかに追加できます。

    ウィザードのステップ2が表示された「ディメンションの追加」ページ

  6. 「終了」をクリックします。ウィザードを終了せずに次のタスクに進みます。事前作成済ファクトへの物理列の追加。

事前作成済ファクトへの物理列の追加

事前作成ファクトを拡張して、キーとして使用する物理列を公開し、論理スターの新しいカスタム・ディメンションを結合します。

このステップでは、「ファクト- OM受注」を拡張して、物理列ORGANIZATION_IDおよびINVENTORY_ITEM_IDを公開し、新しいカスタム・ディメンション「カスタム品目部門」に結合するキーとして使用します。論理列には一意の名前を指定する必要があります。たとえば、ORGANIZATION_IDには一意の名前UC組織IDが指定され、INVENTORY_ITEM_IDには一意の名前UC在庫品目IDが指定されます。
  1. 「論理スター: ファクト」ページで、「ファクト- OM受注」を右クリックし、「拡張の管理」をクリックします。

    「論理スター: ファクト」ページに「ファクト- OM受注」が表示され、右クリックします。

  2. サンドボックス: MySandbox5Mar25ページで、「拡張の管理」をクリックし、「列の追加」をクリックします。

    「拡張の管理」でオプションが表示された「サンドボックス: MySandbox5Mar25」ページ

  3. 列の追加ページで、「物理列の追加」をクリックします。

    「列の追加」ページ

  4. 「物理列の選択」で、ORGANIZATION_IDおよびINVENTORY_ITEM_IDのチェック・ボックスを選択し、「OK」をクリックします。

    物理列の選択ページ

    ノート

    これらの列は、Fact_DW_OM_FULFILLMENT_CF表から取得されます。
  5. 「列の追加」ページの「論理列」で、UC組織IDやUC在庫品目IDなどの一意の論理列名を入力し、「終了」をクリックします。
    ノート

    論理列名は一意であり、事前作成列名と競合しないことが非常に重要です。

    一意の論理列名を入力する必要がある論理列が表示された「列の追加」ページ

  6. ウィザードを終了せずに次のタスクに進みます。カスタム・ディメンションと事前作成済ファクトの結合。

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

結合タイプ、結合条件およびコンテキスト・レベルを定義して、カスタム・ディメンションを事前作成済ファクトに結合します。複合結合を定義できます。ただし、可能な場合は標準結合を使用することをお薦めします。

このステップでは、各表からUC組織IDおよびUC在庫品目IDで構成されるコンポジット・キーを使用して、事前作成済の「ファクト- OM受注」ファクトのカスタム・ディメンション「ディメンション- カスタム品目部門」に対する標準の左外部結合を定義します。コンテンツ・レベルは「詳細」に設定されます。
  1. 「論理スター: ファクト」ページで、カスタム・ディメンションの「ディメンション- カスタム品目部門」円をクリックして、事前作成済のファクトの「ファクト- OM受注」円をグラフィカル形式でドラッグし、「結合」ダイアログを開きます。

    カスタム・ディメンション「Dim–Custom Item Department」と事前作成済のファクト「Fact–OM Sales Orders」が表示されている「Logical Star: Fact」ページ

  2. 「結合」ダイアログで、「結合タイプ」を「左外部」に設定し、「コンテンツ・レベル」を「詳細」に設定し、「結合条件」を次のように設定して、「完了」をクリックします。
    • 「ファクト- OM受注」で、「UC組織ID (DOUBLE)」を選択し、「ディメンション- カスタム品目部門」で「組織ID (DOUBLE)」を選択します。
    • 「ファクト- OM受注」で、「UC在庫品目ID (DOUBLE)」を選択し、「ディメンション- カスタム品目部門」で「在庫品目ID (DOUBLE)」を選択します。

    「結合」ダイアログ

  3. カスタム結合を表形式で確認します。

    表形式のカスタム結合

  4. カスタム結合をグラフィカル形式で確認します。

    グラフィカル形式のカスタム結合

セマンティック・モデルでのカスタム・ディメンションの表示

サブジェクト領域を変更して、新しいカスタム・ディメンションとその属性を表示します。ディメンションは、サブジェクト領域の列を含むフォルダとして表されます。

このステップでは、SCM– 受注サブジェクト領域を変更して、「部門」属性列を含む新しいカスタム・ディメンション・フォルダ「カスタム品目部門」を表示します。
  1. MySandbox5Mar25サンドボックスに戻り、「アクションの実行」、「サブジェクト領域の管理」の順にクリックし、「サブジェクト領域の変更」をクリックします。「SCM– 注文書」を選択し、「次へ」をクリックします。
  2. サブジェクト領域の変更- SCM - 注文書ページで、ウィザードのステップ1でサブジェクト領域の詳細を確認し、「次へ」をクリックします。
  3. ウィザードのステップ2で、「要素の管理」をクリックし、「新規カスタマイズの管理」をクリックします。

    「要素の管理」値リストが表示された「サブジェクト領域の変更- SCM - 受注」ページのウィザードのステップ2

  4. サブジェクト領域の追加の「カスタム」で、「部門」属性列を選択し、「追加」をクリックします。

    これにより、「ディメンション- カスタム・アイテム部門」フォルダがセマンティック・モデルに追加され、「部門」列がフォルダ内に配置されます。


    選択可能な属性が表示された「サブジェクト領域の追加」ダイアログ

  5. 選択したデータ要素を確認し、「終了」をクリックします。

    選択したデータ要素が表示された「サブジェクト領域の変更- SCM - 受注」ページ

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

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

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

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

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

結果の検証

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

  1. Fusion Data Intelligenceコンソールで、「ホーム・ページに移動」をクリックします。
  2. Oracle Analyticsホーム・ページで、「作成」をクリックし、「ワークブック」をクリックして、「データの追加」で「SCM– 受注」を選択し、このユースケースで拡張されるサブジェクト領域を選択して、「ワークブックに追加」をクリックします。
  3. 「カスタム品目部門」フォルダを展開し、「部門」属性列がデフォルトでサブジェクト領域の下部に表示されていることを確認します。「部門」列をワークブックにドラッグします。

    追加したカスタム・ディメンション「カスタム品目部門」

  4. 「明細数」などのメジャーを「ファクト- 受注」フォルダからドラッグして、ファクトがカスタム・ディメンションに結合できることを確認します。

    「ファクト- 受注」フォルダからのメジャー

  5. 結果を検証します。

    事前作成ファクトをカスタム・ディメンションに結合できる結果が表示されます。