查看类别

如何将 DuckDB 连接到 Excel – 流式传输实时分析数据库数据

连接 · DuckDB 到 Excel

从某个来源获取数据 鸭子数据库 文件插入 在 Excel

在 Excel 中打开 DuckDB 数据库,随时刷新即可。无需 ODBC 驱动程序,无需导出为 CSV 文件,也无需使用宏。首次操作大约需要十分钟,免费套餐即可满足所有需求。

大约10分钟 无需编程 文件位置不变 随时随地,甚至在网页上,都能轻松使用 Excel
遇到任何问题?尽管问我们。 打开 支持 请在“查询流”(右上角菜单 → 支持)中给我们发送消息。我们会安排专人阅读您的消息,“我不知道这个屏幕需要什么”就是一个很好的问题。

你最终会得到什么

DuckDB 标志一个工作表,实时显示针对 DuckDB 文件执行 SQL 查询的结果,并带有一个按钮,可在数据更改时自动获取最新行。例如:

DuckDB 数据库是单个文件,通常以 .duckdb 结尾。 .duckdbExcel 本身无法打开这些文件,通常的解决方法是安装 ODBC 驱动程序并处理连接字符串。而 Query Streams 则避免了这些麻烦:一个小型辅助程序会读取文件所在的位置,然后 Excel 加载项会向其请求所需的行。这两个程序无需位于同一台计算机上。文件可以位于办公室的计算机上,而您可以身处任何地方:家里的笔记本电脑、远在异地的同事的电脑,或者网页版的 Excel。

文件存放位置办公室电脑、服务器或家里的电脑你的 DuckDB 文件sales.duckdb · 保留在此处查询流代理它可以在哪里打开文件查询流加密链接通过互联网 · 仅显示结果无论你身在何处你的笔记本电脑、另一间办公室、酒店、你的手机在 ExcelWindows、Mac 或网页版 Excel
代理程序会在能够打开文件的地方运行。Excel 则无需如此。无论你从哪里打开工作表,数据行都会自动显示。

你需要准备什么

查询流帐户

免费版足以满足本指南的需求。请注册: my.querystreams.com.

计算机上的代理程序可以打开文件

这是一个在后台运行的小程序,会在 Excel 需要时读取文件。下面的步骤 2 展示了如何获取该程序。

你的 DuckDB 文件

例如,要知道它在哪里。 C:\Data\sales.duckdb 或 \\server\share\sales.duckdb如果文件存储在 OneDrive、Dropbox 或 Google Drive 中,请确保已将其同步到代理的计算机。

哪个计算机获得代理? 文件所在的浏览器,或者可以从网络共享打开该文件的浏览器(参见 访问网络共享上的文件 下面)。那台电脑需要保持开机状态。 Excel 可以位于任何地方无论是在家里的笔记本电脑上,还是在全国其他地区的同事的电脑上,亦或是网页版的 Excel,都无需安装任何其他软件。

分五步连接

  1. 创建您的帐户

    前往 my.querystreams.com 并注册。选择 免费 计划。这是一个正式的计划,不是试用版,它涵盖了连接你的 DuckDB 文件以及如何从 Excel 运行查询。

  2. 在可以打开文件的计算机上安装代理程序

    登录,打开 下载然后在文件所在的计算机上,或者在可以从网络共享打开该文件的计算机上,安装适用于您系统的代理程序。安装过程只需一分钟,安装完成后会自动启动。

    为什么使用小型程序而不是驱动程序? 该代理程序只需在 Windows、Mac 或 Linux 系统上安装一次(Windows 系统下约 85 MB,Mac 和 Linux 系统下略超过 100 MB),即可在后台静默运行。它会像浏览器一样,与查询流建立一条加密的出站连接,因此您无需打开防火墙端口或设置 VPN。文件保留在原地,数据行会传输到您所在的任何位置,必要时甚至会通过互联网传输。您这边只需要安装该插件即可。

    下载页面显示 您的访问密钥当代理提示时,将其粘贴到代理中,然后等待徽章读取。 已连接到查询流这是你在代理程序本身上唯一需要做的事情。

    完整攻略(如果您需要): Windows, 苹果, Linux.

  3. 将其指向您的 DuckDB 文件

    返回浏览器,打开 数据代理 (在下面 数据 (在顶部菜单中)。您的经纪人信息就在那里。点击 添加连接器, 选择 鸭子数据库并填写:

    连接名称
    任何你以后会记住的名称,例如销售数据库。
    数据库文件路径
    DuckDB 文件(.duckdb 或 .db)的位置:可以是代理计算机上的路径,也可以是网络路径,例如 \\server\share\folder\sales.duckdb,但绝不能是映射的驱动器号,例如 S:。请使用“浏览”功能选择它。

    点击 测试连接当它读到 已连接, 点击 节省连接会在几秒钟内到达您的代理。

    测试失败? 通常情况下,路径存在拼写错误,或者使用了映射的驱动器号,例如: S:代理程序无法访问该文件。打开文件夹,从地址栏复制路径,然后再次粘贴。对于另一台计算机上的文件,请参阅 访问网络共享上的文件 以下。

  4. 在查询生成器中查看您的数据 选修的

    您可以先查看 DuckDB 文件,无需使用 Excel。打开 查询生成器 在门户网站中选择您刚刚建立的连接。 模式 “表”选项卡会列出您的表和列,单击其中一个会将其名称显示在编辑器中,这样您就可以编写查询而无需记住确切的名称。单击 运行 这些行显示在下方 成果查询构建器包含在所有套餐中,免费版也包含在内。

    在商业版套餐中,您还可以直接用英语向 Nova 提出要求(例如“显示美国的客户”),它会自动为您生成 SQL 查询语句。查询语句确认无误后,请保存:从个人核心版到更高版本,该查询语句会显示在插件的“已保存查询”列表中;在任何套餐中,您都可以将该 SQL 语句复制到下一步操作中。

  5. 将查询流添加到 Excel

    在 Excel 中,转到 插入 → 获取加载项搜索 查询流然后点击 添加或者直接从……打开 在 Microsoft AppSource 上查询流功能区上会出现“查询流”按钮。请使用同一帐户登录。

    适用于 Windows 和 Mac 上的 Microsoft 365 Excel 以及网页版 Excel。

  6. 把你的第一张桌子拉过来

    点击“查询流”按钮,选择 流式查询然后选择你刚刚建立的连接。

    输入要运行的查询语句。以下查询语句会从数据库中提取几列数据。 命令 桌子:

    示例 · SQL
    SELECT order_id, customer_name, order_total FROM main.orders ORDER BY order_total DESC LIMIT 100;

    在下面 目的地表 选择 创建新工作表然后按下播放按钮(▶ 箭头)。数据行会在一两秒钟内显示在 Excel 表格中。如果数据发生更改,请再次按下该按钮,表格将自动更新。

    不懂SQL? 内置 查询生成器 首先将其粘贴到这里,或者如果您已保存查询,则从“已保存的查询”中选择它。

访问网络共享上的文件

代理程序以后台服务的形式打开文件,而不是以用户身份打开,因此打开另一台计算机上的文件需要额外的步骤。具体步骤取决于代理程序运行所在的计算机。

Windows

输入网络路径,例如 \\服务器\共享\文件夹绝不会是映射的驱动器盘符,例如 S:代理人无法查看。如果共享仅允许指定人员访问,请点击 服务标识 (位于路径下方的芯片)并存储该服务器的登录信息:公司域帐户,或在服务器本身上创建的帐户。 领域 留空。代理程序随后登录到该服务器并读取文件,并且该代理程序上所有读取同一服务器的连接器都必须使用相同的登录名。如果没有登录名,它将以自己的服务帐户进行读取,公司域会将其视为计算机本身。 Windows 系统上的逐步操作指南

Linux

存储在门户中的共享登录信息在 Linux 系统上无法使用:管理员首先需要在代理计算机上的某个文件夹中挂载该共享。 /mnt 或 /媒体因为代理的服务看不到 /家 或 /run/用户在连接器中,保持 \\server\share 代理程序会将路径映射到挂载点上,或者您可以直接输入挂载点路径,例如: /mnt/fileserver-shared/帐户. 如何在 Linux 上挂载共享文件夹

苹果

在 Mac 上,Portal 中存储的共享登录信息无法使用:请先从终端挂载共享。 sudo在以下文件夹中 卷这样,代理的后台服务就能看到它。在连接器中,保留 \\server\share 代理程序会将路径映射到挂载点上,或者您可以直接输入挂载点路径,例如: /卷/文件服务器共享/帐户. 如何在 Mac 上挂载共享文件夹

如果测试无法获取份额,请在测试结果中查找以下词语: 无法连接 这意味着代理的计算机没有收到服务器的响应。在 Linux 或 Mac 系统上, 未安装 这意味着还需要挂载共享文件夹,并且该消息包含了适用于您服务器的确切挂载命令。

DuckDB 文件放在共享文件夹里? DuckDB 一次只允许一个写入程序,因此代理程序无法打开其他程序正在写入的文件; \\server\share 测试结果显示它 可供其他程序编写要么就此关闭,要么将连接器指向一个无人写入的文件。每次查询都会通过网络读取文件,因此大文件的响应速度比从本地磁盘读取要慢。

共享测试失败?

Windows 代理程序会登录到文件服务器本身,因此其测试结果还可以显示:

留言原因使固定
代理服务帐户访问被拒绝 在路径下方,或 拒绝访问 在测试结果中该共享文件夹仅允许指定人员访问,而代理程序自身的 Windows 帐户不在其中。或者,存储在该服务器上的登录帐户可能没有读取此共享文件夹的权限。点击 服务标识 在路径下存储一个可以读取共享的登录名。如果已经存储了登录名,请服务器管理员授予该帐户读取权限。
身份验证失败服务器拒绝了已保存的登录信息:可能是拼写错误、域名错误,或者密码在保存后发生了更改。点击路径下方的帐户名称,然后再次输入登录名;如果是服务器本身创建的帐户,请留空。 领域 空白的。 刚才被拒绝了 这意味着代理程序会等待一分钟后再尝试相同的登录,因此帐户不会被锁定;保存更正后的密码后会立即再次尝试登录。
此代理上的另一个连接器已登录。,或 Windows 已经保留了登录功能这台 Windows 计算机已经通过另一个连接器或其他程序,以另一个帐户登录到该服务器。Windows 允许每个服务器只有一个帐户。存储其他连接器使用的登录信息,或者在每个读取该服务器的连接器上更改它。之后 Windows 已经具备登录功能消息的其余部分说明了是哪个帐户以及应该怎么做。
此代理版本无法登录该代理程序版本较旧,无法使用已保存的共享登录信息。更新代理,然后再次测试。

就是这样。 您的数据已保存在表格中,只需单击一下即可保持最新状态。除了您请求的行之外,没有任何数据会离开您的网络。

下一步行动不错。

  • 保存查询 在门户网站上,您可以一键再次运行它,也可以从 Excel 或 Google Sheets 运行。
  • 添加筛选器 例如日期范围,这样同一个查询就可以回答“本月”而无需编辑。
  • 分享结果 与同事一起操作。他们看到的是行,而不是你的文件和文件路径。

人们提出的问题

Excel 必须和 DuckDB 文件在同一台电脑上吗?

不,只有代理程序需要能够打开您的 DuckDB 文件。Excel 可以安装在任何联网的计算机上,包括网页版 Excel 和 Mac 版 Excel。使用您的帐户登录加载项,您的连接就在那里了。

我的数据库文件会被上传到哪里吗?

不。代理程序会读取文件所在位置的数据,并仅发送查询所需的行。文件本身不会移动。

文件可以存储在 OneDrive、Dropbox 或 Google Drive 中吗?

是的,只要它与运行代理的计算机同步,代理就能将其视为普通的本地文件。将连接指向同步的副本即可。

免费套餐真的包含这些吗?

是的。“免费”是一个永久有效的方案,而不是会过期的试用期。请查看具体包含内容。 定价页面.

它能与Mac版Excel兼容吗?

是的。包括Mac和Windows上的Microsoft 365版Excel,以及网页版Excel。

还是不行? 打开 支持 请在“查询流”中告诉我们您当前处于第几步以及您看到的内容。我们会帮您连接。

每份指南 DuckDB

这不是你想要的配置?

  • 如果您的文件夹里是 Parquet 文件而不是 DuckDB 数据库文件,Parquet 文件夹会将它们全部读取为一个表 → Parquet Folder
  • 想查询 Excel 工作簿本身吗?Excel 文件夹会将工作簿文件夹读取为表格 → Excel Folder

设置有问题吗?

  • 代理提示文件或文件夹不存在,或访问被拒绝?映射驱动器、网络共享、OneDrive 和 Linux 用户主文件夹都需要修复 → 代理程序可以从哪里读取文件
  • 代理显示离线,或者“测试连接”和“浏览”按钮呈灰色?请检查代理是否在线 → 经纪人在线吗?
更新 2026 年 10 月 17 日

Powered by BetterDocs