数脉:数据库与问数

查询资产、出域与证据

管理资产目录和常用查询,设置数据出域控制,留存查询证据。

资产目录与我的查询

资产目录把已确认的指标口径、确认样例、常用查询和业务主题放在一处检索。「我的查询」列出你保存的和他人共享的常用查询。Agent 问数前,会先拿问题去匹配这里的现成资产。

资产目录

打开「数仓(数脉) › 查询资产 › 资产目录」,用关键字、资产类型和资产状态检索,勾选「只看当前数仓」可以限定范围。资产类型有指标口径、确认样例、常用查询、业务主题;状态有已发布、个人可用、待复核、草稿、已停用。点开一项可以看说明、历史记录,点「查看影响」看修改它会牵动哪些资产。

数脉资产目录
「数仓(数脉) › 查询资产 › 资产目录」,显示演示订单库里已发布的指标口径。截图来自测试环境,数据为示例。

你只能看到自己有权读取全部相关表和字段的资产。确认样例只说明业务问题和 SQL 写法,不能直接运行。

新建模板查询

点「新建模板查询」,选指标、维度和日期范围,由服务端按指标的结构化口径编译并校验,保存为常用查询。日期范围成为运行时可以修改的参数。模板查询目前只支持 MySQL 系(含 TiDB、MariaDB、OceanBase MySQL 模式)和 PostgreSQL 系(含 openGauss、GaussDB、KingbaseES、Greenplum、Hologres)的数据源,并且只在 MySQL 和 PostgreSQL 上做过真实执行验证,其他产品不能建模板查询。

模板用途
分组统计指标按维度取值分组,不选维度时为总计。
时间趋势按日、周、月、季度或年分桶。
排名按指标排序的前 N 个维度取值。
受控明细列出符合条件的记录,最多 500 行。不需要指标。
日均、周均、月均先按日、周或月汇总,再在日期范围内平均。周均要求日期范围是完整的周(周一到周日),月均要求从月初到月末。

当前数仓没有可用于模板的指标时,页面会列出原因,并链接到指标口径。模板只沿多对一方向关联,快照类指标不跨日期相加。

我的查询

常用查询有两个来源:在 Nexus 助手里完成问数并确认结果后保存,或在资产目录里建模板查询。在「数仓(数脉) › 查询资产 › 我的查询」里:

  • 运行:先点「查看口径并确认」,数脉按你当前的权限重新校验,展示口径、参数以及和保存时的差异,再点「确认并查询」才只读执行。运行不调用模型。
  • 参数:有日期范围、枚举、数字三类,模板查询还可以有统计期间。
  • 重命名、共享、说明输出字段、删除:只有保存者能改和删。共享后其他成员能看到口径、参数和状态,看不到 SQL,运行时始终按他们自己的权限、字段和行范围执行。
  • 需复核:保存者的权限被收回,或结构、口径变化导致校验失败时出现。权限恢复且结构未变时,下次运行自动恢复;模板查询由所有者点「按当前口径重新确认」。
  • 申请发布、批准发布:保存者可以把已共享且有效的常用查询(含模板查询)申请发布,由对涉及的每个数据源都有确认权限的管理员批准或驳回,批准前会按批准人的权限重新校验。未共享的要先共享,「需复核」的不能申请。批准按钮在列表行上,驳回在「更多」菜单里。这是数脉自己的发布流程,不在 Nexus 审批页里办理。

结果区可以在「表格」和「图表」之间切换:有一个时间或分类维度和至少一个数值列时,默认建议折线图(时间维度)或柱状图;只有一个数值列、不超过 12 个分类、全部非负时,饼图可以作为可选项。最多绘制前 60 行。点「导出 CSV」或「导出 Excel」可以下载文件,下载时重新检查当前权限,不重新查询数据库。

数据出域控制

出域控制回答两个问题:发给模型的内容里有没有不该出去的,以及查询结果会不会进入外部模型的上下文。在「数仓管理」弹窗选中数据源,打开「出域控制」标签,有两个选项:

选项效果
只向企业内部部署的模型提供本来源的内容结构、业务说明、文档摘录和样例只发给「模型设置」里标为企业内部部署的模型。用途绑定的是外部模型时,问数在发送前失败,并说明原因。
敏感明细只返回给使用内部模型的 Agent个人信息和敏感字段的明细值,只返回给客户端模型声明为「企业内部部署」的 Agent。其他 Agent(外部或未声明)在对话里看不到这些值,聚合结果不受影响。需要明细时,Agent 可以把结果作为文件交给所属人员下载。
数脉出域控制标签
「数仓管理 › 出域控制」标签。截图来自测试环境,数据为示例。

改完点「保存出域设置」,下一次问数就按新设置执行。页面上还有「重新读取」和「打开模型设置」两个按钮。无论是否开启,发给外部模型的内容里都不含个人信息和敏感字段的样例值,也不含「仅聚合」字段的样例。模型连接的部署位置和 Agent 的客户端模型声明怎么设,见授权、审批与审计。

出域设置按数据源整体生效,不能细分到表或字段。部署位置和客户端模型都是管理员的声明,Nexus 无法验证模型实际运行在哪里。出域设置的修改目前只记录修改人和时间,还没有单独的审计事件。

查询证据留存与审计

结果留存

在「数仓管理」弹窗的「证据留存」标签里,「结果留存」可以设置:

  • 留存天数:0 表示不留存,上限 36500 天。财务类数据源建议 3650 天(约 10 年),页面上有一个按钮可以直接采用。
  • 同时留存结果行:默认只留结果的哈希。开启后留存交付给调用者的行(已脱敏、已受「仅聚合」限制),占用更多存储。

开启后,这个数据源上每一次成功执行(自由问数、常用查询和模板查询、跨源组合的中间查询、对数基准)都写一条只追加的留存记录:授权 SQL、实际执行的 SQL、授权快照、版本、期间状态、行数和结果哈希。样例读取不留存。配置只对之后的执行生效,不会补生成历史证据。

管理员在「数仓(数脉) › 管理与证据 › 结果留存」里按时间、数据源、调用主体、人员和执行编号查询,并可以「复现」一条记录:用留存的 SQL 和授权目录,以只读账号重新执行,只回答「一致」「不一致」或「不能复现」和行数,不返回结果行。「清理已到期记录」只删除保留期已过的记录,服务也会定期自动清理。

部署管理员可以给整个部署的留存设置存储上限。用到 80% 时,控制台「概览 › 系统状态」会提示。到上限时,新的问数因为不能留存,也就不会交付结果,报错里写明上限、已用量和办法:等到期记录被清理、缩短留存天数、关闭留存行数据,或请部署管理员调大上限。

敏感访问审计

读到个人信息或敏感字段的每次执行,数脉都写一条审计:执行编号、数据源、涉及的字段和读取方式(明细、聚合、仅用于条件)、结果行数、是否应用了行权限、哪些字段被脱敏或被扣下、调用者所属人员和单位,以及这个结果之后是否经文件交付。不记录结果值、SQL 文本和行权限条件。管理员在「数仓(数脉) › 管理与证据 › 敏感访问审计」按时间、数据源、调用主体、人员和执行编号查询,也可以校验审计链是否完整。

这两类证据只有管理员读得到,Agent 读不到。审计页里记录为空时,先检查对应的留存条件是否开启、字段是否已标为个人信息或敏感,以及记录生成的时间。核心审计员导出证据包时,会一并带上这两类记录,见授权、审批与审计。

进一步交流

带一件正在做的事来聊

告诉我们你想让智能体接哪一类系统。我们在演示环境里把这件事走一遍,再一起判断合不合适。