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

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

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

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

このタスクを完了するには、次を使用します。
  • 属性- 部門
  • サブジェクト領域- 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;

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

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

このステップでは、Fact–OM Sales Orders論理スターを編集して、自律データ・ウェアハウス・オブジェクトFDI_X_ITEM_CUSTOM_DEPARTMENT_D_Vを参照するカスタム・ディメンションCustom Item Departmentを追加します。
  1. 「セマンティック・モデル拡張」ページで、「MySandbox5Mar25」サンドボックスをクリックします。
  2. 「処理の実行」で、「論理スターの管理」「論理スターの編集」「即時利用可能」の順にクリックし、サブジェクト領域として「SCM - 受注」を選択し、対応するファクトとして「ファクト- OM受注」を選択し、「次」をクリックします。
  3. 「論理スター: ファクト」ページで、「ディメンションの管理」「ディメンションの追加」の順にクリックします。

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

  4. ディメンションの追加ウィザードのステップ1で、「スキーマ」OAX_USERを選択し、「オブジェクト」FDI_X_ITEM_CUSTOM_DEPARTMENT_D_Vを選択し、「ディメンション名」「カスタム品目部門」と入力します。DEPARTMENTおよび ORG_ITEM_KEY[属性の追加]チェック ボックスをオンにします。INVENTORY_ITEM_IDORGANIZATION_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受注」を右クリックし、「拡張の管理」をクリックします。

    右クリックした「Fact–OM Sales Orders」が表示されている「Logical Star: Fact」ページ

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

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

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

    列追加ページ

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

    物理列の選択ページ

    ノート:

    これらの列は、Fact_DW_OM_FULFILLMENT_CF表から取得されます。
  5. 「列の追加」ページの「論理列」で、UC組織IDUC在庫品目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. 「サブジェクト領域の追加」の「カスタム」で、「部門」属性列を選択し、「追加」をクリックします。

    これにより、セマンティック・モデルに「Dim - Custom Item Department」フォルダが追加され、「Department」列がフォルダ内に配置されます。


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

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

    選択したデータ要素が表示された「Modify a Subject Area– SCM - Sales Orders」ページ

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

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

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

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

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

結果の検証

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

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

    追加したカスタム・ディメンション「カスタム・アイテム部門」

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

    「ファクト- 販売オーダー」フォルダのメジャー

  5. 結果を確認します。

    事前作成済ファクトをカスタム・ディメンションに結合できることを示す結果