排查与边界
日志和调试页面在哪,常见问题怎么处理,以及目前做不到的事。
日志与排查
日志
「数仓(数脉) › 管理与证据 › 日志」按当前数据源列出采集、问数和维护的操作记录,列有时间、操作、结果和调用来源。可以按操作(读取结构、采集结构、测试连接、生成方案、确认执行、提交查询、数据预览、导出结果等)和结果(成功、失败、已受理、已取消)筛选,因权限被拒绝的失败会显示为「拒绝」。点行末的「详情」看详情:发起者、对象、请求链(追踪 ID、任务 ID、HTTP 状态)、结果和耗时。
- 日志只保存时间、操作、结果、错误码、耗时和追踪、任务标识,不保存 Key、请求头、问题、SQL、结果行和行权限条件。
- 一次问数会产生多条生命周期记录,不能按条数当作查询执行次数。排队任务的最终成败要看对应的任务记录。
- 日志保留的条数有限,旧的先淘汰。它不回填启用日志之前的操作,也不替代授权审计。
- 只有管理员能读,Agent 的 Key 读不到。日志存储故障时,读取会报「依赖不可用」,不会当作空日志。
- 分页位置失效时,点「刷新」从最新记录重新读取。
查询类操作的执行证据在「数仓(数脉) › 管理与证据」的「结果留存」和「敏感访问审计」里,按执行编号(任务 ID)查看。
调试
「数仓(数脉) › 问数与验证」(页面标题是「调试」,没有子页签)用来验证问数的解析和只读执行。页面右上有「问数运行自检」和「查看日志」两个按钮。输入「测试用例」,选表范围(可在左侧表目录里选),然后:
- 点「解析结构」:只解析命中的表、字段和关联,不执行 SQL。
- 点「只读执行验证」:调用已配置的模型生成 SQL,并只读执行,返回行数受限。
- 点「从查询口径填入」:打开查询口径列表,在某条查询上点「填入调试」,它的业务问题会填进测试用例,不会自动执行。
输出里先展开 SQL 和运行信息,并保留表、字段、关联、证据、结果行、是否截断和失败诊断。校验失败时,诊断会写明是哪一环,例如「函数白名单与方言能力」「窗口函数位置与参数」「子查询、CTE 与 UNION ALL」。问题提到的表不在调试范围内时,解析和执行不会用到它们,把它们加入范围后再试。调试用的是当前控制台管理员的身份,不等于某个 Agent 的权限验收,Agent 的权限要用它自己的 Key 验证。「问数运行自检」只用于开发和验收环境的固定测试(使用受控数据、不调用模型),生产部署里不可用,点击会提示失败。验证问数请用「问数与验证」页,或用真实 Key 在 Nexus 助手里提问。
异常时,按模型、结构、规则、权限、数据库执行的顺序查日志。
常见问题
| 现象 | 处理 |
|---|---|
| 结构地图是空的,或「理解助手」提示需要已采集的结构 | 先点面板顶部的「采集建图」。 |
| 「AI 推断关系」按钮是灰的 | 检查「模型设置」里有没有为「结构理解」配置模型,以及库是否超过 80 张表或 1000 个字段。 |
| 保存提示版本冲突,或「已被修改」 | 其他管理员刚改过。点「重新读取」,核对最新内容再保存。 |
| 问数返回「需要补充」 | 把助手的追问回答清楚,形成新计划后再确认。不会自动重试。 |
| Agent 提示没有数据权限 | 检查「授权管理」里这把 Key 在对应表上的动作和字段。提示不会透露未授权的资源是否存在。 |
| 问数在发送前失败,写明模型是外部的 | 数据源开启了「只向企业内部部署的模型提供本来源的内容」,而对应用途绑定的是外部模型。改绑模型,或关闭这个选项。 |
| 结果被截断,或行数比预期少 | 实际返回的行数取授权的行数上限、数据源的「最多返回行数」和 500 行中最小的。缩小范围,或先在数据库一侧聚合。 |
| 结果里金额放大或计数重复 | 检查关联路径上的数据粒度和关系基数。 |
| 保存的查询变成「需复核」 | 结构、口径或权限变化所致。恢复条件,或所有者重新确认。 |
| 留存、审计页没有记录 | 检查数据源的留存天数是否大于 0,字段是否已标为个人信息或敏感,以及记录的生成时间。 |
| 问数因留存已满而失败 | 按报错里的办法处理,见「结果留存」。 |
目前的边界
- 只读,且是 SELECT 的受限子集:只执行单条只读查询,支持 WHERE、GROUP BY、HAVING、ORDER BY、常见算术、CASE、常用聚合、日期和字符串函数、窗口函数、非递归 CTE(最多 8 个)、带别名的派生表、不相关的 IN 和标量子查询,以及 UNION ALL。不支持递归 CTE、相关子查询、EXISTS、INTERSECT、EXCEPT、通配符 *(COUNT(*) 除外)、视图、函数白名单之外的函数、变量、注释、优化器提示、INTO、文件读取、加锁和任何写操作。超出子集的需求会要求澄清。
- 不做跨库 SQL:一次多库问数最多选 5 个数据源,各库分别查询,只在明确的键上做结果关联,或在应用内按声明的规则组合,组合最终最多输出 500 行、64 列。跨库结果不是同一个事务快照,不同来源的同名指标不会自动相加。
- 大库的限制:一个数据源最多采集 1000 张表、12000 个字段,每张表最多 500 个字段,整库最多 2000 条目录关联。整库的 AI 关系推断限于 80 张表、1000 个字段。每次问数选的表不超过 80 张。理解助手一次最多 50 张表。
- 结果的大小:默认最多返回 100 行、64 KiB,每个单元格 8 KiB;服务端的绝对上限是 500 行、256 KiB、每格 16 KiB。单次查询的执行时间不超过 10 秒。导出的文件最大 2 MiB。
- 适配的验收程度不同:24 种适配里,有的在真实服务或本机夹具上验证过,有的只通过模拟测试。请以交付说明为准,上线前在目标环境做连接测试和一次只读问数。模板查询只支持 MySQL 系和 PostgreSQL 系数据源,并且只在 MySQL 和 PostgreSQL 上做过真实执行验证,其他产品不能建模板查询。
- 行权限因产品而异:所有可执行的产品都支持字段取值和固定条件,关联表过滤只有上面列出的七个产品支持。
- 个人信息和敏感字段:脱敏只作用于展示的值。仅聚合不能防住差分推断,例如先查部门总额,再查「除某人以外」的总额后相减,这类情况要靠敏感访问审计事后发现。
- 出域和审计:出域设置按数据源整体生效,部署位置和客户端模型都是声明,无法验证。
- 常用查询的参数:有日期范围、枚举、数字三类,模板查询还可以有统计期间。引用了本对话已执行结果的组合不能保存为常用查询。
- 检索:资产检索按名称、别名和说明匹配;
asset.match在配置了「选表与问数规划」模型时会额外做语义召回,否则只做确定性匹配。 - 对话的有效期:多轮问数的对话默认保留 24 小时(部署管理员可调,1 到 720 小时),每个身份最多 200 个未过期的对话,只能由创建者读取。