数据目录

同步数据表和视图

接入数据源后，用户可以在“数据目录”模块中查看和管理已同步的表。

• 仅展示在数据源中已勾选的表；
• 支持查看每张表的表名、业务描述、字段名及字段描述；
• 显示该表与其他表之间的关联关系，包括关联表、关联字段及关系类型（如主外键）；
• 支持一键触发“智能数据知识补充”，系统基于 AI 和 Schema 自动为表与字段生成业务别名和描述；
• 支持“数据表同步”功能，可重新加载更新后的表结构。

数据目录同步注意事项

• 未同步的表或视图不可被使用

  • 仅在数据目录中完成同步的表和视图，才能在 SERVICEME 的 Data 模块中被引用或用于构建业务域。
  • 若数据库中存在新增数据，但未在数据目录中同步，则系统将无法识别与使用。

• 数据库结构更新需重新同步

  • 当外部数据库中的表结构或字段信息发生变更（例如新增字段、字段类型调整、表重命名等），
  • 用户需在数据目录中执行“同步”操作，以保证数据结构与源系统保持一致。
  • 否则，SERVICEME 内的数据仍将基于旧版本结构运行，可能导致后续数据映射错误或字段缺失。

• 同步失败的常见原因与排查

  • 数据源连接失效：可能由于数据源密码变更、数据库服务中断或网络问题导致，请在“数据源管理”中重新测试连接。
  • 表权限不足：部分数据库账号仅有只读权限或缺少元数据访问权限，需联系数据库管理员开通相应权限。
  • 字段名或表名存在特殊字符：个别数据库中字段或表名包含空格、符号或保留字，建议在数据库中重命名或在同步前排除。
  • Schema 不匹配：当数据库结构变动频繁或使用多 Schema 时，建议在同步前确认 Schema 配置正确。

提示

• 建议Data管理员定期检查数据目录同步状态，尤其是在数据库更新频繁或业务表结构变化较多的场景中。
• 通过保持数据目录的最新状态，可确保 AI Agent、BI 报表及智能分析模块持续获得准确、可用的数据支持。