A 解决语义模型扩展中的常见错误

您必须及时解决检测到的语义模型错误,以避免补丁程序升级失败。

如果您未解决错误,您的管道可能会被禁用,发布更新已停止,更新产品被阻止,因此可用性和支持可能会丢失。使用此解决方案列表可以解决常见错误。如果您在遵循这些解决方案后继续遇到困难,请创建全面的帮助服务请求。

错误:扩充或映射的扩充列中缺少列不可用

说明:其中一个数据扩充不再与其对应的语义模型扩展同步。这主要是因为启用了 SME Options for Data Augmentation 功能(在“启用功能”页上的一般可用功能选项卡下)。为了获得最佳性能和稳定性,Oracle 建议您使用用户扩展手动配置语义模型,而不是让数据扩充自动生成系统语义模型扩展。此建议的原因是对基础数据扩充的任何更改,这些更改在语义模型中仍被引用,会导致语义模型扩展变得不同步并失败。建议的做法是将数据扩充和语义模型扩展过程分开,这为复杂的建模提供了更大的灵活性并防止错误。将来,在创建数据扩充时,始终使用数据集类型并定义您自己的用户语义模型扩展。不创建用于创建系统语义模型扩展的任何新数据扩充(类型为“Dimension”、“Fact”或“Extend Entity”)。如果可行,将所有现有数据扩充转换为数据集和用户语义模型扩展。

解决方法提示(如果在非生产实例中看到此错误)
  1. 重置数据扩充高速缓存。请参见 Reset the Cache
  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));