A 解決語意模型擴充中的常見錯誤

您必須及時解決偵測到的語意模型錯誤，以避免修正升級失敗。

如果未解決錯誤，您的管線可能會被停用、已停止發行更新、已封鎖更新方案，以及可用性和支援可能會因此遺失。使用此解決方案清單來解決常見錯誤。如果您在遵循這些解決方案後仍持續遭遇困難，請提出全面協助的服務要求。

錯誤：擴增中遺漏資料欄，或沒有對應的擴增資料欄

描述：您的其中一個資料擴增已不再與其對應的語意模型擴充同步。這很可能是因為資料擴增的 SME 選項功能 (在「啟用功能」頁面上的一般可用功能頁籤下) 已啟用。為達到最佳效能和穩定性，Oracle 建議您以使用者擴充功能手動設定語意模型，而不要讓資料擴充自動產生系統語意模型擴充功能。此建議的原因是基本資料擴增的任何變更 (仍在語意模型中參照)，會導致您的語意模型擴充變成不同步且失敗。建議的作法是分隔「資料擴增」與「語意模型擴充」處理，此處理可提高複雜模型的彈性並防止錯誤。展望未來，建立資料擴增時，一律使用「資料集」類型並定義您自己的使用者語意模型擴充。請勿建立任何建立系統語意模型擴充程式的新資料擴增 (維度、事實或擴充實體類型)。如果可行，請將所有現有的資料擴增轉換成資料集和使用者語意模型擴充。

解決方式提示 (如果在非生產環境執行處理中看到此錯誤) ：
  1. 重設資料擴增快取。請參閱重設快取。
  2. 從 Oracle Fusion Data Intelligence 中的主控台，導覽至資料組態，然後導覽至資料擴增。尋找並編輯有問題的資料擴增。繼續進行後續步驟以複查選取的屬性。取消勾選來源中不再可用的任何屬性。使用下一步瀏覽整個組態，然後按一下完成以儲存並排定您的變更。
  3. 完成資料擴增處理後，請務必重新整理並更新參考資料擴增目標表格的語意模型擴充，以移除任何已停用的資料欄。
    若要移除所有未參考的物件，請清除主題區域與邏輯星星，如下所示：
    1. 建立封閉測試環境。
    2. 編輯主題區域以移除任何參考已刪除資料欄的元素。
    3. 編輯邏輯星號以刪除所有關聯的資料欄、衍生欄位及維度。如果邏輯星體缺少維度，請重新新增，然後將其刪除。
    4. 在封閉測試環境套用變更以確認變更。
    5. 將封閉測試環境合併至主要。
    6. 發布更新的模型。
    7. 重新驗證模型以確認沒有錯誤。

解決方式提示 (如果在生產例項中看到此錯誤) ：

當您發現實際執行執行處理中缺少某些擴增資料欄時，原因通常是下列兩種情況之一：
  1. 未部署擴增：在此案例中，您必須執行包含預期擴增的資料組態組合。
  2. 已故意移除擴增：如果已刪除擴增，您必須先更新較低環境中的語意模型，才能移除其參考。移除參照之後，請將語意模型組合重新部署至生產環境執行處理。

錯誤：自訂資料欄有前置或尾隨的空格字元

描述：屬性、衍生資料欄或實體資料欄的顯示名稱開頭或結尾為空格。

解析提示：當未選取之屬性的顯示名稱包含前置空格或尾端空格時，就會發生此錯誤。解決此情況的方法：
  1. 編輯邏輯星號，並為其顯示名稱開頭或結尾具有額外空格的所有資料欄選取新增屬性。
  2. 在顯示名稱中，從新選取的資料欄中移除任何前置或尾端空格。在欄位外按一下以儲存變更。
  3. 繼續進行後續步驟並儲存修改。
  4. 在您的封閉測試環境中套用變更。
  5. 將封閉測試環境合併至主要封閉測試環境。
  6. 發布更新的模型。
  7. 重新驗證模型以確認沒有錯誤。

備註：

除非您明確新增邏輯星號中的其他選取資料欄，否則不會自動顯示在使用者面向的主題區域中。

錯誤：主題區域屬性有前置或尾端的空格字元。請檢查主題區域名稱 / 描述 / 資料夾 / 資料欄，瞭解可能的空格

描述：主題區域名稱、描述、資料夾或資料欄名稱的顯示名稱開頭或結尾為空格。

解決方式提示：編輯主題區域，然後編輯有問題的自訂項目、尋找並移除主題區域名稱、描述、資料夾和資料欄名稱的所有前置空格和尾端空格。

錯誤：步驟處於錯誤狀態

描述：進行語意模型編譯時，此步驟發生錯誤。

解決方式提示：編輯失敗的步驟、調查、識別錯誤，以及解決這些錯誤。

自訂步驟可能處於錯誤狀態，因為無法再存取擴充程式的來源。當您編輯自訂時，物件下拉式列表會顯示「選取」而非正確的物件名稱。

找不到資料庫物件的原因如下：
  • 實例缺少參考的資料應用程式，包括資料擴增、描述彈性欄位 (DFF) 和可設定的帳戶分析。
  • 資料庫物件從未移轉至 Autonomous AI Lakehouse 。
  • 未套用或已移除必要的權限，例如 GRANT SELECT ON "OAX_USER"."TABLE_VIEW" TO "OAX$OAC"。
  • 物件名稱包含不支援的特殊字元，例如括號。

錯誤：分支的最後一個步驟發生一致性檢查錯誤。

描述：進行語意模型編譯時發生錯誤。

解決方式提示：錯誤表示最終步驟失敗，但根本原因可能位於較早的階段。編輯上一個失敗的步驟、調查、識別錯誤並加以解決。

錯誤：「超出列數上限」或「查詢執行失敗：超出列數上限」的工作簿內。

描述：在語意模型發布後，工作簿中就會顯示這些錯誤。

解決方式提示：此問題可能會與超過 256 個字元的延伸屬性資料欄大小相關。若要解決此問題，請修改資料欄定義，讓資料欄大小小於或等於 256 個字元。

例如，ALTER TABLE TABLE_NAME MODIFY (COLUMN_NAME VARCHAR2(256));