> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 数据来源、文件与刷新

> 选择可用来源，理解脚本处理、筛选和数据更新的行为。

## 当前来源

| 来源 | 使用方式 | 注意事项 |
| - | - | - |
| PostgreSQL | 查询已配置数据库 | 需要来源访问权和只读查询能力 |
| MySQL、Doris | 查询已配置数据库和表 | 当前 Doris 已验收内置 Catalog；不代表其他兼容数据库均已支持 |
| data-xpert 本体 | 使用已发布资源和允许的只读操作 | 需要正确的身份连接、资源绑定和访问者策略 |
| Workspace Python/JavaScript | 处理授权文件，或组合已声明来源的查询结果 | 当前为私人脚本定义，暂不支持团队分享 |

看板只列出当前有权访问且有适配能力的来源。分享看板不会自动授予数据库、本体资源或文件的访问权。

data-xpert 可通过其已发布的本体适配器提供不同资源，具体字段和操作由资源定义决定。不能据此假设看板可以直接访问任意 REST 地址或所有语义模型。

## 使用文件和脚本

将输入文件及指标说明放到授权工作区，告诉助理准确文件名和处理规则。助理可以编写 Python 或 JavaScript，对数据进行清洗、分组和计算，再由看板读取结果。

刷新会重新执行脚本，并读取本次有权访问的输入。保存定义时可以固定脚本代码，或配置每次读取当前代码；这与刷新输入数据是不同的选择。代码固定不会让文件中的业务数据也固定。

当前脚本使用标准库和 UTF-8 文件，不自动安装 pandas 或 npm 包。复杂处理或较大输入可能超过执行限制，需要缩小范围或调整来源查询。

## 筛选与刷新

* 筛选项来自看板定义及查询结果；选择后会重新查询。
* 手动刷新保留当前筛选；关闭并重开恢复定义中的默认筛选。
* 自定义页面可以按要求实现定时刷新，但不是所有看板都自动具备定时器。
* 取数时间更新说明发生了新的查询，不证明上游业务数据已经变化。
* 部分结果、截断提示和空结果需要结合业务范围判断，不应直接解读为全量总额或零业务量。

数据来源、页面和用户权限都可能影响刷新结果。历史版本或固定分享链接仍按当前权限查询，不能绕过已撤销的访问权。

## 管理员配置提示

管理员需要部署 Live Dashboard 和对应来源插件，配置数据库驱动或本体连接，并给助理启用看板工具及相应技能。HTML 保存检查需要浏览器运行环境；脚本另需受限 Python/JavaScript 运行环境。只启用工作台视图不足以让助理获得工具。

当前平台单次查询最多 30 秒、1,000 行和 2 MB 结果。脚本还有文件与调用限制。建议先让来源完成必要聚合，再展示图表；不要通过重复查询拼接被截断的数据并声称完整。

无法完成查询时，参见[常见问题](./troubleshooting)。

## 相关文档

* [数据分析中的数据源管理](/zh-Hans/data/analytics/data-sources)：了解连接、目录和工作区绑定；这里的可配置类型不等同于看板已支持的来源类型。
* [本体工作台与资源对话](/zh-Hans/data/features/agent-execution/workbench-and-chatkit)：了解 data-xpert 资源上下文和访问身份。
* [团队分享与独立页](./sharing)：了解访问者权限，以及 Workspace 脚本来源的分享限制。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.