#模型连接数据库操作说明

Schema 建模完成后，需要为其配置数据连接，才能让问答系统真正从数据库中取出数据。Data Agent 提供新版和旧版两种连接方式，推荐使用新版。

#入口

进入 系统搭建 → 语义建模 → Schema 列表，点击目标 Schema，即可看到数据源接入方式的配置区域。

• 新版：本文档重点介绍的"连接数据-新版"。
• 旧版：参考修改底表，通过在 Schema 高级配置中修改 FROM 从句来绑定物理表。

#新版操作流程

进入 连接数据-新版 标签页，点击 添加 按钮，即可按向导完成连接配置。

#第一步：配置基本信息

在此处编辑配置名称，并选择是否启用该配置。

#第二步：选择物理来源

选中目标数据源后，在 来源类型 处选择数据获取方式。此处产生两个分支：

• 从数据库获取：直接对接数据库中已有的物理表。
• 从演示数据获取：由大模型生成模拟数据，用于快速测试。

#分支一：从数据库获取

选择此方式后，需要指定与当前 Schema 对应的数据库物理表。

1. 在下拉列表中选中目标物理表。
2. （可选）在下方 SQL 区域执行查询，验证物理表是否正确，确认无误后可跳过此步骤。
3. 依次点击 预览字段 → AI 对齐：
   • 预览字段：读取数据库表中的所有字段。
   • AI 对齐：由 AI 将 Schema 中的字段与数据库物理字段进行匹配映射。

如果表结构与 Schema 定义都比较明确，通常一次即可对齐成功。但由于这一步由 AI 自动完成，请务必人工验证映射结果。若发现匹配错误或不准确，可手动对存在问题的字段进行调整。

#分支二：从演示数据获取

此方式由大模型生成模拟数据，适合尚未准备好真实数据时的快速验证。

#使用技巧

建议先生成实体表的模拟数据，再生成事件表数据。这样在生成事件表时，系统会自动引用已有实体的 ID 实现关联。

#操作步骤

1. 在提示词输入框中描述数据要求（如数据量级、字段值范围等），对生成内容施加约束。
2. 生成的模拟数据将以 SQL 形式展示在下方的 SQL 编辑框中。
3. 点击 运行 预览生成结果。
4. 确认数据满足预期后，点击 保存，即可基于模拟数据开始问答验证。

#常见问题

#日期类型字段不匹配

事件表中的系统时间戳字段要求为 YYYY-MM-DD HH:mm:ss 格式的时间戳类型，大模型在生成模拟数据时偶尔会偏离此格式。

处理方式：

• 模拟数据场景：调整提示词，明确要求时间字段使用 YYYY-MM-DD HH:mm:ss 格式；或手动修改生成的 SQL。
• 真实数据库场景：若读取数据库时出现日期类型不匹配警告，可在 Schema 属性列表中找到对应字段，点击 编辑 → 高级，为该字段添加额外转换逻辑，例如：

toTimestamp(field)  --此处为clickhouse语法，根据连接的数据源使用正确的语法