DuckDB
接入 DuckDB 数据库文件进行联邦分析。文件中的表和视图被挂载进查询引擎，可与其他连接器的数据集联接。
适用场景
- 打包为单个
.duckdb文件的分析数据集。 - 从其他 DuckDB 流程导出、希望以对话方式分析的结果。
文件的提供方式
与 SQLite 相同，DuckDB 是单文件数据库，Datyo 需要访问该文件：
- 对象存储（托管版）： 文件位于 S3 兼容存储桶中，使用你提供的存储凭据读取。datyo.ai 上采用此模式。
- 本地文件路径（桌面版 / 自托管）： 连接器直接从文件系统路径读取文件。托管版不支持——参见 托管版与自托管。
连接配置
对象存储模式
提供对象存储访问凭据，并填写：
| 字段 | 必填 | 说明 |
|---|---|---|
| Bucket | 是 | 存放数据库文件的存储桶。 |
| 对象路径 | 是 | 文件在桶内的键，如 warehouse/analytics.duckdb。 |
本地文件路径（桌面版 / 自托管）
| 字段 | 必填 | 说明 |
|---|---|---|
| 文件路径 | 是 | Datyo 运行环境中 .duckdb 文件的绝对路径。 |
能力与限制
- 执行模型： 联邦。DuckDB 表可与其他连接器的数据集联接。
- 访问： 只读，挂载数据库时不作修改。
- 表与视图： 均可导入。
- 环境： 对象存储模式在所有环境可用；本地文件路径仅限桌面版 / 自托管。
常见排错
- 文件不存在或为空——核对桶与对象路径（或本地文件路径），以及对该对象的读权限。
- 缺少某个视图——重新同步；挂载文件后表和视图都会被枚举。