準備您的外部應用程式

驗證與更新您的外部應用程式。

備註：

在 2026 年 6 月 1 日之前，請複查並更新您的外部語意模型以符合這些最新標準，並確保您的外部應用程式在不中斷的情況下繼續運作。

驗證您的外部語意模型

您需要檢查並更新哪些項目 執行這些作業…
以多個邏輯表格為基礎的階層 (邏輯維度)
  • 確定階層 (邏輯維度) 僅以一個邏輯表格 (維度表格) 為基礎。語意模型產生器會強制階層 (邏輯維度) 源自一個邏輯表格。
  • 移轉模型之前，請先移至「模型管理工具」、合併邏輯表格，然後刪除合併資料的來源邏輯表格。

    例如，如果您的 Snowflake 模型具有源自維度表格和維度擴充表格的階層 (邏輯維度)，請移至「模型管理工具」，然後將維度擴充表格資料新增至維度表格。在您合併邏輯表格之後，請刪除維度擴充表格。

邏輯外來鍵結合
  • 確定語意模型未包含邏輯外來索引鍵結合。語意模型產生器中沒有邏輯外來索引鍵結合，因此不會包含在移轉中。
  • 在移轉模型之前，請以邏輯結合取代邏輯外來索引鍵結合。
主鍵
  • 確定語意模型的邏輯層次包含主索引鍵。
應用程式角色
  • 確定語意模型使用應用程式角色作為物件權限和資料安全性。

    由於在管理工具中開發的語意模型已不再使用使用者層級安全性，因此語意模型產生器不會移轉任何使用者層級安全性。在「管理工具」中，您可以使用 Identity Manager 來檢查模型是否使用應用程式角色，而不使用使用者。
顯示資料夾
  • 搜尋語意模型以尋找並刪除「實體」圖層和「商業模型與對應」圖層中的所有顯示資料夾。

    顯示資料夾包含物件的捷徑。當您刪除顯示資料夾時，它只會刪除物件的捷徑，不會刪除物件本身。
一致性
  • 確保語意模型在移轉前通過一致性檢查。
  • 在「模型管理工具」中，對模型執行一致性檢查，並在移轉前修正任何錯誤。

驗證您的外部語意模型是否符合標準

為確保外部應用程式的服務不中斷，請複查並更新您的外部語意模型以符合這些標準。若未能符合這些需求，Oracle 可能會忽略變更、系統錯誤或刪除不合規的物件。

一般：

  • 外部語意模型的大小必須小於 25 MB。
  • 型錄資料夾與物件名稱必須是唯一的，且不得與預建項目衝突。

連線：

  • 外部語意模型只能連線至與 Oracle Fusion Data Intelligence 相關的 Oracle Autonomous AI Lakehouse。
  • 請勿將任何其他連線新增至外部語意模型。
  • 上傳之前，請將預建的連線重設為其原始設定值。將資料來源名稱設為 "DSN"，並將使用者名稱和密碼欄位留白。

結合與查尋：

  • 外部語意模型不支援邏輯查尋。
  • 外部語意模型不支援邏輯外來鍵結合。

實際資料

  • 邏輯事實至少必須包含一個聚總計量。
  • 描述性屬性必須模型化為退化維度而非直接事實屬性。

尺寸

  • 每個建立的邏輯維度都必須與相關聯的邏輯階層配對。
  • 維度最小單位必須符合資料。否則，查詢結果將會不正確。
  • 維度階層之最低層次或明細層次的主鍵，必須符合階層所依據之邏輯維度表格的主鍵。

階層

  • 階層 (邏輯維度) 必須從一個且只能從一個邏輯表格 (維度表格) 衍生。
  • 外部語意模型中定義的上下階階層無法用於「分支」或「封閉測試環境」架構中的後續模型製作。改用以層次為基礎的階層。
  • 以層次為基礎的階層需要已定義的總計層次與明細層次。將每個階層的元素數目設為一或多個。
  • 將不再使用邏輯外來索引鍵結合。刪除邏輯外來索引鍵結合，並以邏輯結合取代它們。
  • 所有邏輯層次都必須定義主索引鍵。
  • 透過將可用屬性限制為基本欄位來最佳化階層績效。

欄

  • 符合資料欄的資料類型必須相符。
  • 將衍生的資料欄表示式限制為 1499 個字元，以確保它們保持有效。

安全性

  • 使用者層級安全性將被棄用。將外部語意模型更新為針對所有物件和資料安全性權限僅使用應用程式角色。
  • 您必須為外部語意模型內建立的所有自訂角色提供顯示名稱與描述。
  • 如果外部語意模型參照應用程式角色和群組，則您必須手動建立它們。合併功能只會匯入對應，不會匯入角色與群組定義。在您的身分識別提供者中建立適用的群組。使用 Oracle Fusion Data Intelligence 中的「安全性」頁面建立應用程式角色。
  • 使用應用程式角色來保護物件存取，而不管理資料安全性。

資料擴增

  • 除非您已經建立資料擴增類型，例如「建立維度」、「建立事實」和「延伸實體」，否則請勿在「啟用功能」頁面的「一般可用功能」頁籤下啟用「資料擴增的 SME 選項」。不再建議使用這些擴增類型，可能會在未來的發行版本中移除。「資料擴增」的 SME 選項會直接更新語意模型，這可能會因為同步化失敗而觸發錯誤。如果您遇到這些錯誤，請以資料集類型擴增來取代 SME 擴增，並改為設定使用者定義的語意模型擴充。

系統變量

  • 請勿參考外部應用程式擴充程式中的系統變數。「封閉測試環境」架構中允許系統變數。

搭售品部署

  • 您必須確定目標環境中啟用的功能區域，以及從其中擷取範本語意模型的開發環境相同，以避免外部應用程式合併失敗。