查看类别

如何将 DuckDB 连接到 Google Sheets - 流式传输实时分析数据库数据

阅读时间:5分钟

连接器指南

鸭子数据库 谷歌工作表

鸭子数据库 鸭子数据库
查询流 查询流
谷歌工作表 谷歌工作表
快速分析
实时数据
便携式

Query Streams 使您能够将 DuckDB 直接连接到 Google Sheets,无需 Apps Script、ODBC 驱动程序或文件上传即可流式传输实时分析数据。 在 QueryStreams.com 免费注册 几分钟内即可将 DuckDB 的实时分析数据导入到您的电子表格中。

本指南将向您展示如何在 DuckDB 数据库文件和 Google Sheets 之间建立安全、实时的连接。Query Streams 非常适合数据分析师、开发人员以及使用高性能分析数据库的团队——它可以让您随时随地访问 DuckDB 的极速查询,同时确保数据库文件的安全。

基于文件的分析

嵌入式数据库保留在本地,从不上传。

OLAP性能

对大型数据集进行闪电般快速的分析查询

分享见解

共享查询,无需共享数据库文件

查询 Parquet 和 CSV 文件

使用 DuckDB 直接查询数据湖文件

您将取得的成就

本指南结束时,您将能够

  • 将 Google Sheets 连接到 DuckDB 快速分析数据库查询
  • 查询 Parquet、CSV 和 JSON 文件 直接通过 DuckDB
  • 执行高性能 OLAP 查询 来自 Google Sheets
  • 分享分析见解 无需暴露数据库文件

先决条件

1

查询流账户

创建免费帐户即可开始使用 DuckDB 集成。

创建免费帐户 →
2

已安装查询流代理

将代理安装到 DuckDB 文件或数据湖文件所在的目录。

安装查询流代理→
3

DuckDB 数据库文件

可从代理机器访问的 .duckdb 或 .db 文件。

DuckDB 文档 →
DuckDB 的优势: DuckDB 可以直接查询 Parquet、CSV 和 JSON 文件,无需导入。非常适合使用查询流进行数据湖分析。

步骤 1:访问查询流代理界面

1
2
3
4
5
6
7

安装好代理后,配置 DuckDB 连接。

  1. 打开网络浏览器 并导航至 https://localhost:1823
  2. 导航至数据连接: 点击 数据来源 > 连接
  3. 添加新连接: 点击 添加连接

步骤 2:选择 DuckDB 作为连接类型

2
3
4
5
6
7
  1. 选择 DuckDB: 点击 鸭子数据库 瓦片(选中时有绿色边框)
  2. 替代方案 - 使用搜索: 输入“DuckDB”即可快速找到它
  3. 点击下一步 继续

步骤 3:配置您的 DuckDB 连接详细信息

3
4
5
6
7

所需的 DuckDB 连接详细信息:

  1. 连接名称 – 友好名称(例如,“DuckDB 分析”)
  2. 数据库文件路径 – .duckdb 文件的完整路径(例如, C:\Analytics\data.duckdb点击文件夹图标进行浏览。
  3. 默认架构 (可选)——留空以访问所有模式
  4. 线程数 (可选)– 如果为空,则使用 CPU 计数
  5. 临时目录 (可选)– 自定义临时文件位置

完成后,点击 下一页.

性能提示: DuckDB 可以直接查询 CSV/Parquet 文件。可以使用类似这样的查询: SELECT * FROM 'data.parquet' LIMIT 100 用于数据湖分析。

步骤 4:选择数据域

4
5
6
7

选择您的 数据领域 - 您的查询处理能力。.

  1. 查看可用领域: 根据您的订阅
  2. 选择领域: 选择 “默认数据域”
  3. 点击下一步 测试连接

步骤 5:测试您的 DuckDB 连接

5
6
7

查询流将验证您的 DuckDB 文件是否可访问。

  1. 自动测试: 代理尝试打开 DuckDB 文件
  2. 审查结果: 成功显示 DuckDB 版本、表和模式
  3. 点击下一步 如果成功
故障排除 如果连接失败,请验证文件路径是否正确、文件是否存在,以及代理是否具有对 DuckDB 文件的读取权限。

步骤 6:完成设置

6
7
  1. 审查配置: 请确认文件路径是否正确
  2. 点击完成 保存您的 DuckDB 连接

您的 DuckDB 连接已准备就绪!接下来,安装 Google Sheets 插件。

第 7 步:安装插件并运行首次查询

7

从 Google Workspace Marketplace 安装查询流插件:

安装后,打开 扩展 > 查询流 创建你的第一个 DuckDB 查询:

  1. 点击 “查询流”
  2. 选择您的 DuckDB 连接
  3. 编写您的SQL查询:
DuckDB 查询示例 查询语言
SELECT customer_id, first_name, last_name, total_spent, country FROM customers WHERE total_spent > 1000 ORDER BY total_spent DESC LIMIT 100;
  1. 配置目的地: 选择 “创建新标签页”
  2. 点击播放 执行

成功!

您已将 DuckDB 连接到 Google Sheets!您的分析数据将以极快的 OLAP 性能即时流入新的工作表。

下一步:保存和共享查询

使用 查询流门户网站 构建、保存和管理您的 DuckDB 查询:

  • 保存查询: 存储分析型 SQL 以便重用
  • 添加参数: 为数据探索创建动态筛选器
  • 分享见解: 允许利益相关者在无需文件访问权限的情况下运行查询
  • 从附加组件访问: 保存的查询显示在 “保存的查询 ”菜单中

常见问题

Query Streams 是否使用 Google Apps 脚本? +

不。Query Streams 直接使用 Google Sheets API,性能更佳。与执行时间限制为 6 分钟的 Apps Script 不同,Query Streams 可以高效地处理 DuckDB 的快速分析查询。

🔒 我的DuckDB数据库文件安全吗? +

是的。您的 DuckDB 文件会保存在您的本地计算机或网络上。查询流代理仅读取查询结果——数据库文件本身绝不会上传或暴露。

💾 DuckDB 可以直接查询 Parquet 文件吗? +

是的!DuckDB 无需导入即可查询 Parquet、CSV 和 JSON 文件。 SELECT * FROM 'file.parquet' 数据湖分析查询中的语法。

👥 我能否在不共享数据库文件的情况下共享查询? +

没错!与任何人共享已保存的查询。他们可以运行这些查询并获取实时数据,而无需查看您的SQL代码、数据库文件路径,也无需直接访问文件。

为什么 DuckDB 在数据分析方面速度如此之快? +

DuckDB 针对 OLAP(分析型)工作负载进行了优化,采用列式存储、向量化查询执行和并行处理。它非常适合对大型数据集进行聚合、连接和复杂的分析查询。

更新 2026 年 6 月 3 日

Powered by BetterDocs