查询资产、出域与证据
管理资产目录和常用查询,设置数据出域控制,留存查询证据。
资产目录与我的查询
资产目录把已确认的指标口径、确认样例、常用查询和业务主题放在一处检索。「我的查询」列出你保存的和他人共享的常用查询。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 的客户端模型声明怎么设,见授权、审批与审计。
查询证据留存与审计
结果留存
在「数仓管理」弹窗的「证据留存」标签里,「结果留存」可以设置:
- 留存天数:0 表示不留存,上限 36500 天。财务类数据源建议 3650 天(约 10 年),页面上有一个按钮可以直接采用。
- 同时留存结果行:默认只留结果的哈希。开启后留存交付给调用者的行(已脱敏、已受「仅聚合」限制),占用更多存储。
开启后,这个数据源上每一次成功执行(自由问数、常用查询和模板查询、跨源组合的中间查询、对数基准)都写一条只追加的留存记录:授权 SQL、实际执行的 SQL、授权快照、版本、期间状态、行数和结果哈希。样例读取不留存。配置只对之后的执行生效,不会补生成历史证据。
管理员在「数仓(数脉) › 管理与证据 › 结果留存」里按时间、数据源、调用主体、人员和执行编号查询,并可以「复现」一条记录:用留存的 SQL 和授权目录,以只读账号重新执行,只回答「一致」「不一致」或「不能复现」和行数,不返回结果行。「清理已到期记录」只删除保留期已过的记录,服务也会定期自动清理。
部署管理员可以给整个部署的留存设置存储上限。用到 80% 时,控制台「概览 › 系统状态」会提示。到上限时,新的问数因为不能留存,也就不会交付结果,报错里写明上限、已用量和办法:等到期记录被清理、缩短留存天数、关闭留存行数据,或请部署管理员调大上限。
敏感访问审计
读到个人信息或敏感字段的每次执行,数脉都写一条审计:执行编号、数据源、涉及的字段和读取方式(明细、聚合、仅用于条件)、结果行数、是否应用了行权限、哪些字段被脱敏或被扣下、调用者所属人员和单位,以及这个结果之后是否经文件交付。不记录结果值、SQL 文本和行权限条件。管理员在「数仓(数脉) › 管理与证据 › 敏感访问审计」按时间、数据源、调用主体、人员和执行编号查询,也可以校验审计链是否完整。
这两类证据只有管理员读得到,Agent 读不到。审计页里记录为空时,先检查对应的留存条件是否开启、字段是否已标为个人信息或敏感,以及记录生成的时间。核心审计员导出证据包时,会一并带上这两类记录,见授权、审批与审计。