数据源接进来之后,日常要动的是几件事:改名称和描述、换要同步的表、维护上传的文件、补训练数据。这些入口都集中在数据源详情页和它的「设置」页。

开始前

操作步骤

1

先认识详情页的三块区域

打开数据源后,页面分三块:
  • 顶栏:面包屑(「全部数据源」→ 数据源名 →「设置」)、状态指示器、主操作按钮。
  • 左侧栏:「基本信息」「训练集」两个固定项;数据源可用时下方还有搜索框和库/表树,搜索框可以按表名过滤。
  • 右侧:当前选中的内容。
顶栏主操作按钮按类型变化:数据库类是「重新选表」,Excel 是「文件管理」;最右是「设置」。状态指示器显示为正常可用、同步中、初始化中或不可用,点开能看到上次同步时间和错误详情;出错时底部出现「重新初始化」或「重新同步」按钮。
2

改名称和描述

点左侧「基本信息」。数据源名称直接在输入框里改,失焦即保存;描述是两行文本框,同样失焦保存。描述上限 255 字,超出时右下角计数变红,改动不会保存。同一页还能看到只读的类型、ID(带复制按钮)、库表统计和创建时间。
3

改连接配置(数据库类)

点顶栏「设置」,在「连接配置」分区里能看到主机地址、用户名和数据库。点「编辑」打开连接信息弹窗改,「测试连接」随时验证当前配置。密码留空表示不修改。
4

换要同步的表(数据库类)

点顶栏「重新选表」,弹窗里重新勾选后点「确认选择 (N)」。已在元数据里的表默认勾上;同步进行中该按钮不可点。单个表结构变了不用整源重来:进这张表的「字段结构」页,点表名下方的「重新同步」。它只重跑这张表的结构与统计,不覆盖人工标注,触发后提示已开始刷新。
5

管理上传的文件(Excel)

点顶栏「文件管理」,弹窗标题是「文件管理」,列出「文件列表(N)」。点「选择文件」加新文件,新加的行带新文件徽标;已入库的行可以预览、下载、删除。删过的行会在下方标注保存后将被永久移除。改完点「保存更改」。
6

维护训练集

点左侧「训练集」。表格列是用户问题、正确 SQL、来源、创建时间、是否启用、操作,来源列显示手动添加或点赞反馈。右上角「添加训练数据」新建;行内开关控制单条是否生效,鼠标移到行上出现编辑和删除按钮。搜索框可以按用户问题或 SQL 过滤。
7

导出或导入元数据

点顶栏「设置」,在「元数据」分区:
  • 点「导出」弹出「确认导出元数据」,写明会导出字段描述、字段可见性设置和训练数据,确认后下载 JSON。
  • 点「导入」选 JSON 文件。导入会覆盖字段描述与可见性,训练数据是追加,不会删除已有数据。
同一分区还有「dbt 语义层」,点「导出 YAML」把当前数据源的实体和维度导出为 dbt YAML。
8

删除数据源

点顶栏「设置」,最下方「危险区」里是「删除数据源」;数据源列表卡片右上角的「···」菜单里另有「快速对话」和「删除数据」。删除前会二次确认,确认后不可撤销。删除只移除 AskTable 侧这份数据源和它的配置,数据库或文件本身不受影响。

关键约束

以上数值都是默认值,可在管理后台调整(训练数据校验类的除外)。

出问题怎么判断

下一步