常见问题速查
更新时间: 2026-03-17 15:04:32
阅读 49
问题一:建表/修改表时,找不到或无法选择想要的“主题归属”/“表分层”
• 可能原因A:缺乏对应主题域或分层的选择权限
排查路径:
- 确认可见选项:在创建工单选择“主题归属”或“表分层”时,下拉列表中完全找不到预期的选项。
- 联系项目管理员:此权限由项目组管理员在【主题设计】或【分层设计】中通过“选择控制”功能配置。
解决方案:
由项目管理员进行以下操作:
- 进入【模型规范】->【主题设计】(或【分层设计】)。
- 找到对应的主题域或分层,点击“编辑”。
- 在“选择控制”中,将您所在的角色或您本人添加到允许选择的名单中。

· 可能原因B:未选择到最末级主题
排查路径: 选择“主题归属”时,选择了某一级主题后,系统仍提示需要选择,且该主题名称旁有“>”图标表明存在子主题。
解决方案: 点击主题名称旁的“>”图标,逐级展开,直到选择一个后面没有子主题的最末级主题。
问题二:建表工单提交失败,或提示“SQL语法错误”、“执行失败”
· 可能原因A:表名或字段名不符合目标数据库的命名规范
排查路径:
- 点击【SQL预览】:在提交工单前,务必点击此按钮检查生成的SQL。

- 检查关键字和特殊字符:预览的SQL中,表名或字段名是否包含了数据库的保留关键字(如 key, value, order等)或非法特殊字符。
解决方案:
- 修改名称:返回工单编辑页面,修改表名或字段名,避免使用关键字。建议使用下划线 _分隔单词。
- 沟通确认:确认团队对表名、字段名的命名是否有特殊要求。
• 可能原因B:字段类型、长度等定义与底层数据库不兼容
排查路径:
- 核对数据类型:例如,在Greenplum中定义了不支持的字段类型。
- 点击【SQL预览】:生成的DDL语句中可能存在明显的类型定义错误。
解决方案:
- 查阅数据库文档:确认所选“数据源类型”支持哪些字段类型及其精度、长度限制。
- 修改字段定义:返回字段设计页面,将字段类型修改为目标数据库支持的、功能等效的类型。
问题三:想修改已上线表的结构,但无法直接编辑
• 可能原因:对已存在的表进行结构变更,必须走“修改表”工单流程,而非直接编辑
排查路径:
- 区分操作场景:在【数据表】页面找到表后,操作栏中没有“编辑”按钮,只有“修改表”按钮。
- 理解流程差异:维度建模中,所有对已建表的结构修改(增删改字段、修改分区等)都必须通过发起新的“修改表工单”来完成审批和执行。
解决方案:
- 发起修改工单:点击表右侧的 【修改表】 按钮。
- 填写变更内容:在工单中,像新建表一样配置需要变更的内容(如新增字段)。
- 提交审批:填写完毕后提交,该工单将像建表工单一样进入审批流程,通过后系统会自动执行ALTER TABLE等操作。
详情操作步骤可参考:工单管理
问题四:在数据地图、指标系统等子产品中看不到或无法引用新建的表/字段
• 可能原因A:表的“资产目录”未正确配置或同步延迟
排查路径:
- 在维度建模中确认:进入表的详情页,查看“所属资产目录”信息是否为空或填写有误。
- 等待元数据同步:维度建模的表元数据同步到数据地图等产品通常有短暂延迟(几分钟到半小时)。
解决方案:
- 配置资产目录(建表/修改表时):在创建或修改表工单的“表基本属性配置”阶段,填写或选择正确的“归属系统名称”和“表所属资产目录”。
- 耐心等待同步:若确认配置无误,请等待一段时间再刷新子产品页面查看。
• 可能原因B:字段未正确关联“数据元”或“指标”
排查路径:
- 在指标系统中排查:无法在指标系统中找到期望的字段作为原子指标。
- 查看字段设计:在维度建模中打开表结构,检查目标字段是否关联了对应的“数据元”或“指标”。
解决方案:
- 关联标准:通过“修改表”工单,为字段关联正确的“数据元”。指标系统通常会依赖此关联关系来识别可用的基础数据。
- 关联指标:如果该字段本身就是一个指标(如“销售额”),确保在DWS/ADS层表的字段设计中,将其与指标系统中已定义的指标关联。
详情可参考:数据表
文档反馈
以上内容对您是否有帮助?