Skip to content

一张报表使用多个数据源 ​

一张报表可以同时展示多个数据库的数据,包括同一种数据库类型下的不同数据库。先在「管理数据源」中分别配置连接,并使用只读账号。

设置组件的数据源 ​

选中图表、表格或指标卡,在右侧「数据 → 数据源」中选择数据库。未单独指定时使用报表默认数据源。多个组件共用查询时,单独切换一个组件会自动复制查询,不改变其他组件的数据源。切换数据库不会改写 SQL,请确认目标库存在相应表和字段。

也可以直接告诉设计助手各组件应该使用哪个已配置的数据源。助手按数据源分别查阅元数据和验证 SQL,不会把业务明细发送给模型。

筛选、穿透和导出 ​

  • 全局与局部筛选仍使用报表参数,各查询在自己的数据库中应用条件。不同库中的同一编号不一定含义相同,需要分别设置参数或统一编码。
  • 下拉、树形等动态选项,在参数属性的「选项数据源」中指定数据库。它决定选项从哪里读取,不改变其他组件的数据源。共用选项查询的筛选条件会一起变更。
  • 选中有穿透交互的组件,在「交互 → 穿透数据源」中设置每条穿透查询的数据源。省略时使用报表默认数据源,不会自动继承触发组件。
  • Excel、Word、页面打印 PDF 与发布后的查看页都保留这些绑定。动态导出会按各查询绑定的数据库重新取数;快照的数字按原有快照规则固化。

每个数据源独立执行权限过滤、SQL 守卫和查询限额。数据源停用、删除或不属于当前租户时会报错,不会转到其他数据库取数。被草稿或历史版本引用的数据源不能删除。

规格字段 ​

数据源绑定保存在命名查询上,主查询、筛选选项查询和 drills[*].queries 的结构一致:

json
{
  "queries": {
    "q_sales": { "datasource": "sales-db", "sql": "SELECT ..." },
    "q_inventory": { "datasource": "inventory-db", "sql": "SELECT ..." }
  }
}

datasource 是已配置的数据源标识。省略字段的旧报表仍使用报表默认数据源,不需要迁移。节点通过 query 引用这条查询。

一条查询只访问一个数据源。本功能不提供跨数据源 JOIN、跨库明细合并或统一事务快照;不同数据库的刷新时间可有差异。单个数据库内的关联查询仍遵循原有 SQL 守卫规则。

给 AI 用的纯文本索引在 /llms.txt,每篇原文在 /md/ 下。