外部アプリケーションの準備

外部アプリケーションを確認および更新します。

ノート:

2026年6月1日より前に、外部セマンティック・モデルを確認および更新して、これらの最新の標準を満たし、外部アプリケーションが中断することなく機能し続けるようにしてください。

外部セマンティック・モデルの検証

確認と更新に必要なもの	これらのタスクを実行...
複数の論理表に基づく階層(論理ディメンション)	階層(論理ディメンション)が1つの論理表(ディメンション表)のみに基づいていることを確認してください。セマンティック・モデラーは、階層(論理ディメンション)を1つの論理表からソーシングすることを強制します。モデルを移行する前に、モデル管理ツールに移動し、論理表を結合してから、データをマージした論理表を削除します。たとえば、ディメンション表とディメンション拡張表をソースとする階層(論理ディメンション)を持つスノーフレーク・モデルがある場合、モデル管理ツールに移動し、ディメンション拡張表データをディメンション表に追加します。論理表を結合した後、ディメンション拡張表を削除します。
論理外部キー結合	セマンティック・モデルに論理外部キー結合が含まれていないことを確認します。論理外部キー結合はセマンティック・モデラーに存在せず、移行には含まれません。モデルを移行する前に、論理外部キー結合を論理結合に置き換えます。
主要キー	セマンティック・モデルの論理レベルに主キーが含まれていることを確認します。
アプリケーション・ロール	セマンティック・モデルで、オブジェクト権限およびデータ・セキュリティにアプリケーション・ロールが使用されていることを確認します。管理ツールで開発されたセマンティック・モデルではユーザー・レベルのセキュリティが非推奨となったため、セマンティック・モデラーはユーザー・レベルのセキュリティを移行しません。管理ツールでは、Identity Managerを使用して、モデルがユーザーではなくアプリケーション・ロールを使用していることを確認できます。
フォルダの表示	セマンティック・モデルを検索して、物理レイヤーおよびビジネス・モデルとマッピング・レイヤー内のすべての表示フォルダを検索して削除します。表示フォルダには、オブジェクトへのショートカットが含まれています。表示フォルダを削除すると、オブジェクトへのショートカットのみが削除され、オブジェクト自体は削除されません。
一貫性	セマンティック・モデルが移行前に整合性チェックに合格していることを確認します。移行前にモデル管理ツールで、モデルに対して整合性チェックを実行し、エラーを修正します。

外部セマンティック・モデルが標準に準拠しているかどうかを確認します

外部アプリケーションの中断のないサービスを保証するには、これらの標準に準拠するように外部セマンティック・モデルをレビューおよび更新します。これらの要件を満たさないと、Oracleが変更やシステム・エラーを無視したり、非準拠オブジェクトを削除したりする可能性があります。

一般:

外部セマンティック・モデルのサイズは25MB未満にする必要があります。
カタログ・フォルダおよびオブジェクト名は一意である必要があり、事前作成済エントリと競合しないようにする必要があります。

接続:

外部セマンティック・モデルは、Oracle Fusion Data Intelligenceに関連付けられたOracle Autonomous AI Lakehouseにのみ接続する必要があります。
外部セマンティック・モデルに追加の接続を追加しないでください。
アップロードする前に、事前に作成された接続を元の設定にリセットします。データ・ソース名をDSNに設定し、ユーザー名およびパスワード・フィールドを空白のままにします。

結合およびルックアップ:

論理参照は、外部セマンティック・モデルではサポートされていません。
論理外部キー結合は、外部セマンティック・モデルではサポートされていません。

ファクト

論理ファクトには、少なくとも1つの集計メジャーが含まれている必要があります。
付加属性は、直接ファクト属性ではなく、デジェネレート・ディメンションとしてモデル化する必要があります。

ディメンション

作成されるすべての論理ディメンションは、関連する論理階層と組み合せる必要があります。
ディメンション粒度はデータと一致する必要があります。それ以外の場合、問合せ結果は不正確になります。
ディメンション階層の最下位レベルまたは詳細レベルのプライマリ・キーは、階層の基になる論理ディメンション表のプライマリ・キーと一致する必要があります。

階層

階層(論理ディメンション)は、1つの論理表(ディメンション表)からのみ導出する必要があります。
外部セマンティック・モデルで定義された親子階層は、ブランチまたはサンドボックス・フレームワーク内の後続のモデリングには使用できません。かわりにレベルベースの階層を使用します。
レベルベースの階層には、定義済の総計レベルと詳細レベルが必要です。各レベルの要素数を1つ以上に設定します。
論理外部キー結合は非推奨になります。論理外部キー結合を削除し、論理結合に置き換えます。
すべての論理レベルに主キーが定義されている必要があります。
使用可能な属性を必須フィールドに制限することで、階層のパフォーマンスを最適化します。

カラム

適合する列のデータ型は一致する必要があります。
導出列の式を1499文字に制限して、有効なままにします。

セキュリティ

ユーザー・レベルのセキュリティは非推奨になります。外部セマンティック・モデルを更新して、すべてのオブジェクトおよびデータ・セキュリティ権限にアプリケーション・ロールを排他的に使用します。
外部セマンティック・モデル内に作成されたすべてのカスタム・ロールの表示名と説明を指定する必要があります。
外部セマンティック・モデルがアプリケーション・ロールおよびグループを参照する場合は、手動で作成する必要があります。マージ機能では、マッピングのみがインポートされ、ロールおよびグループ定義はインポートされません。アイデンティティ・プロバイダに適用可能なグループを作成します。Oracle Fusion Data Intelligenceの「セキュリティ」ページを使用してアプリケーション・ロールを作成します。
データ・セキュリティを管理するのではなく、オブジェクト・アクセスを保護するためにアプリケーション・ロールを使用します。

データ拡張

ディメンションの作成、ファクトの作成、エンティティの拡張などのデータ拡張タイプをすでに作成していないかぎり、「機能の有効化」ページの「一般に使用可能な機能」タブでデータ拡張のSMEオプションを有効にしないでください。これらの拡張タイプは推奨されなくなり、将来のリリースで削除される可能性があります。データ拡張のSMEオプションは、セマンティック・モデルを直接更新します。これにより、同期の失敗が原因でエラーが発生する可能性があります。これらのエラーが発生した場合は、SME拡張をデータセット・タイプの拡張に置き換え、かわりにユーザー定義セマンティック・モデル拡張を構成します。

システム変数

外部アプリケーション拡張でシステム変数を参照しないでください。システム変数はサンドボックス・フレームワークで許可されます。

バンドルのデプロイメント

外部アプリケーション・マージの失敗を回避するために、ターゲット環境で有効になっている機能領域と、テンプレート・セマンティック・モデルの抽出元の開発環境が同じであることを確認する必要があります。