一个连接,每个表面
HubSpot 数据可以去哪里
- 1 出站连接
- 0 入境口岸
- 只读 · 凭据保留
运行
- 为您的团队、供应商和合作伙伴
-
在 Excel 插件 · 按需刷新
-
谷歌工作表 附加组件 · 按需刷新
-
新星人工智能 用简单的英语提问 · 文本转 SQL
-
数据查看器 分享实时结果 · 团队、供应商、合作伙伴 · 任何设备
- 对于应用程序和系统
-
REST API JSON 端点 · OpenAPI 3.1
-
Power BI Power Query M
-
计划同步 Google Sheets · Airtable · Baserow · SeaTable · Smartsheet · Anvil
- 人工智能工具
-
人工智能助手 Claude · Cursor · MCP 服务器
- 已送达
-
警报和报告 Slack · Discord · 电子邮件 · Webhook
Query Streams 将 HubSpot 门户转换为 31 个 SQL 表——包括联系人、公司、交易、工单、互动、报价、发票、列表以及它们背后的销售流程定义——这些表可通过 Microsoft Excel、Google Sheets、Power BI、基于 MCP 的 AI 助手以及 REST 端点读取。关联关系以独立表的形式呈现,因此联系人到公司以及交易到订单项的链接只需使用普通的 JOIN 操作即可,无需手动重新组装导出数据。
- 为您的团队、供应商和合作伙伴
-
HubSpot 到 Excel 微软 Excel · Excel 加载项
将 HubSpot 的实时结果直接导入工作表,并可按需刷新——支持桌面版 Excel、Excel Online 和 Microsoft 365。
HubSpot 指南 -
HubSpot 到 Google 表格 表格插件
从侧边栏运行已保存的 HubSpot 查询,并将结果行拖放到工作表中。共享协作者可以自行刷新工作表。
HubSpot 指南 -
向 Nova 询问有关 HubSpot 的问题 Nova AI · 文本转 SQL
用简单的英语提问。Nova 已经了解您的 HubSpot 表,会自动编写并运行 SQL 语句,解释答案并绘制图表——无需编写查询语句,也无需提供任何凭据。
Nova 的工作原理 -
HubSpot 到数据查看器 结果共享 · 团队、供应商、合作伙伴 · 手机、平板电脑、台式机
您可以与任何人(同事、供应商、合作伙伴)共享 HubSpot 的实时结果,将其以可收藏的网格形式呈现,无论在手机、平板电脑还是台式机上打开,都会自动刷新显示。他们看到的是结果,而不是 SQL 语句或凭据。
数据查看器的工作原理 - 对于应用程序和系统
-
HubSpot REST API HTTP 端点
将 HubSpot 查询发布为任何应用程序都可以调用的已认证 JSON 端点,符合 OpenAPI 3.1 规范,并预置了 Postman、Insomnia 和 Hoppscotch 集合。无需打开数据库端口。
REST API 的工作原理 -
HubSpot 到 Power BI Power Query M
将生成的 Power Query M 粘贴到 Power BI 高级编辑器中,报表即可通过 HTTPS 读取 HubSpot 的实时结果——无需 ODBC 驱动程序,也无需打开数据库端口。
Power BI 的工作原理 -
HubSpot 到 Airtable 自动化平台
按计划将 HubSpot 行同步到 Airtable,或者在 Airtable 自动化脚本中获取它们。
HubSpot 指南 -
HubSpot 到 Baserow 自动化平台
通过 REST 端点从 HubSpot 向 Baserow 表提供数据——无论是自托管还是 Baserow 云。
HubSpot 指南 -
HubSpot 到 SeaTable 自动化平台
无需导出文件或公开数据库,即可使 SeaTable 数据库与 HubSpot 数据保持同步。
HubSpot 指南 -
HubSpot 到 Smartsheet 自动化平台
将 HubSpot 结果推送到 Smartsheet 表格中,以便计划和报告能够读取源系统,而不是上周的导出数据。
HubSpot 指南 -
HubSpot 到 Anvil Anvil Works · 应用平台
通过 REST 端点将 Anvil Python 应用程序与 HubSpot 集成,而不是将数据库凭据嵌入到应用程序中。
HubSpot 指南 - 人工智能工具
-
HubSpot MCP 服务器 Claude、Cursor 和 MCP 客户端
赋予 AI 助手对 HubSpot 的只读访问权限,并提供它编写正确 SQL 所需的架构——聊天中无需提供凭据。
HubSpot 指南 - 已送达
-
HubSpot 警报和报告 Slack · Discord · 电子邮件 · Webhook
将 HubSpot 查询添加到计划中,并将查询结果发送到 Slack、Discord、电子邮件或已签名的 webhook,或者等到行数、阈值或百分比变化超过您设定的界限时才发送消息。
警报和报告的工作原理
工作原理
5 个步骤,无需更改入站防火墙规则
在 HubSpot 门户中创建一个私有应用,并赋予它对您关心的对象读取权限。
安装网络代理并粘贴访问令牌。令牌将保存在网络代理中;HubSpot 只会接收来自您自己网络的信息。
选择要同步的 31 个表格中的哪些表格以及同步频率。联系人、公司、交易、所有者、销售渠道、销售渠道阶段和属性默认启用。
针对 hubspot.deals、hubspot.companies 等数据库编写普通 SQL 语句——或者让 Nova 来编写。
从 Excel、Sheets、Power BI、MCP 或 REST 中读取数据,并在同一语句中将其连接到您自己的数据库。
专题深度解析
HubSpot 能为你提供什么
关联关系是一张表格,而不是一个谜题。
HubSpot导出数据最麻烦的地方在于,真正有价值的信息都存在于对象之间的链接中,而联系人的CSV文件却不包含这些信息。在CSV文件中,这些信息单独列为一个表格,每一行都包含了链接和正反两方的信息。
- hubspot.associations 包含 from 对象、to 对象、关联类型和标签,因此交易的联系人或工单的公司就是一个简单的 JOIN。
- 涵盖了联系公司、联系交易、公司与交易、交易与项目、工单与联系人以及工单与公司等各种情况。
- 管道和管道阶段也是单独的表,因此交易的阶段会解析为名称和订单,而不是不透明的 ID。
这31张桌子
- CRM对象 — 联系人、公司、交易、票务、所有者、管道、管道阶段、产品、订单项。
- 订婚 — 电话、电子邮件、会议、笔记、任务、沟通。
- 商业 —报价、发票、订阅、付款、税款、折扣、费用。
- 市场营销 — marketing_events、forms、form_submissions、feedback_submissions。
- 列表和自动化 — 列表、工作流程。
- 定义 — 属性、模式、关联。
您的自定义属性实际位于何处
这一点需要特别说明,因为这是人们容易误解的地方。每个对象表都包含一组固定的命名列——即标准字段——而 HubSpot 返回的所有其他数据,包括自定义属性,都保存在同一行的 raw_data JSON 列中。
- 不会丢弃任何数据。自定义属性可以查询,但需要通过 JSON 列进行查询,而不是作为单独的列。
- hubspot.properties 列出了十五种对象类型的所有属性定义 — 名称、标签、类型、字段类型 — 这样你就可以查找存在的内容及其名称。
- hubspot.schemas 包含自定义对象定义。自定义对象记录不会作为独立的表进行同步。
- 如果您希望自定义属性在电子表格中作为一列显示,请在保存的查询中将其提取出来。这样只需编写一次表达式,之后所有使用该查询的用户都能看到正确的列。
每个 API 连接器共享
每个 API 连接器的工作原理
- 您的帐户将变成表格 — 端点映射到具有主键和索引的类型化 SQL 表,因此您可以编写 SELECT、JOIN 和 GROUP BY,而不是翻阅 JSON。
- 您可以选择同步哪些内容以及同步频率。 每个表都有自己的时间间隔,或者根本没有时间间隔。如果供应商的 API 支持,则只会获取自上次运行以来发生更改的记录。
- 副本归你所有 它以 AES-256-GCM 加密的形式存储在您本地的 DuckDB 文件中,与代理程序位于同一位置。它不在我们的云端。
- 供应商只会收到你的消息。 — 代理直接从您自己的网络调用 API,因此 Query Streams 不需要您的令牌来回答查询。
知道这个很有用
- 这是一个同步副本,而不是实时代理。 — 查询读取的是已经获取过的数据,因此返回速度与 SQL 查询相同,不会超出 API 速率限制。此外,所选表还可以在读取数据时刷新过期的行。
- 您的速率限制将得到遵守。 — 每个连接器都会在供应商公布的限制范围内自行控制速度,因此报告不会导致您的帐户对使用它的其他所有帐户进行限速。
- 没有东西会被扔掉 — 表中未命名的字段保存在 raw_data JSON 列中,您仍然可以对其进行查询。
- 将其连接到您的数据库 — 在同一条语句中同时使用 API 表和 SQL Server 表在这里只是普通的查询,而不是集成项目。
跨源 SQL
将 HubSpot 与您的其他数据连接起来
CRM系统知道账户信息;支付处理系统知道账户支付了什么。两者都不知道账户信息,而季度末需要的数据却必须显示在同一行。每个数据源只运行其能够处理的部分,并将结果流式传输回系统,然后集中进行数据合并——各个数据源之间互不通信,也不会复制任何数据。
3 个连接 · 3 个代理
一份声明
——来自 HubSpot 的帐户、您自己的客户记录、Stripe 的发票
选择 h.industry, COUNT(DISTINCT h.id) AS accounts, SUM(i.amount_due) / 100 AS invoiced
从 客户关系管理.hubspot.companies1 h
连接 pg_crm.public.customers2 c ON c.domain = h.domain
连接 计费.stripe.invoices3 i ON i.customer = c.stripe_id
GROUP BY h.行业
ORDER BY 发票上的描述;
这三个部分分别是连接、模式和表——连接名称就是您自己命名的。示例列;您的表就是您自己的表。连接操作在公司域上运行,因为 HubSpot 交易本身不包含客户参考信息——对象之间的链接是关联表中的一行,如果您需要的是交易而不是帐户,也可以查询该行。Stripe 以最小货币单位报告金额,因此需要进行划分。所有部分都采用只读模式:仅支持 SELECT、WITH 和 EXPLAIN 语句,并且对单个数据源单次查询可传输的数据量设置了上限。 联合查询的工作原理
连接详情
HubSpot需要什么
- 验证
- 代理服务器上保存着一个私有的应用访问令牌。这不是一个需要你维护的 OAuth 往返令牌。
- 伸手够到
- 从您的网络到 HubSpot 的 HTTPS 连接。没有入站流量。
- 模式
- HubSpot——包括 hubspot.deals、hubspot.contacts 和 hubspot.associations。
- 表格
- 31 项,其中 7 项默认启用:联系人、公司、交易、所有者、管道、管道阶段和属性
- 自定义属性
- 数据保存在对象行的 raw_data JSON 列中,其定义列于 hubspot.properties 文件中。这些数据不会作为列添加。
- 增量
- 通过 HubSpot 的 CRM 系统,按最后修改日期进行搜索,即可获取对现有记录的编辑内容。
- 实时刷新
- 适用于 20 个 CRM 对象表——以一条记录为键的查询会先将其与 HubSpot 进行比对,然后再给出结果。
- 速率限制
- 速度已达到 HubSpot 公布的限制上限,因此该报告不会限制其他所有人的门户访问速度。
- 本地副本
- 代理程序旁边,您的计算机上有一个使用 AES-256-GCM 加密的 DuckDB 文件。
只读属性是结构性的。该连接器不执行任何 HubSpot 写入调用——它发出的每个请求都是读取操作,无论是搜索还是批量读取——因此,无论令牌的作用域如何,查询都无法更改交易阶段或触及联系人。尽管如此,将私有应用程序的作用域设置为“仍然读取”仍然是值得的。
同步关联表会遍历每种类型的每个对象,然后分批读取链接,因此它是这里开销最大的表。除非您确实需要精确到分钟的链接,否则请为其设置比对象表更长的同步间隔。
供应商文档: www.hubspot.com
常问问题
关于 HubSpot 的问题
哪些工具可以通过查询流读取 HubSpot 数据?
只需一次连接,即可访问所有平台:Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、定时提醒和报表。只需连接一次帐户,所有平台即可读取同一个只读连接——无需为每个工具单独设置,也无需创建数据副本。
我是否需要为我的 HubSpot 帐户打开防火墙端口?
不。Query Streams 网络代理运行在您的网络内部,并打开一个单独的出站加密连接。它不会监听入站流量,无需 VPN,并且帐户会保留其现有的防火墙规则。
查询流可以更改 HubSpot 中的数据吗?
不。代理在执行时强制执行只读模式——一次只执行一条语句,仅限 SELECT 及其相关语句。凭据保留在代理上,绝不会发送到查询流。
Query Streams 需要通过什么连接到 HubSpot?
一个可访问的主机、一个角色及其密码——代理程序携带驱动程序,因此无需在帐户上安装任何软件。身份验证:代理程序上保存的私有应用程序访问令牌。无需您维护的 OAuth 往返身份验证。访问方式:通过 HTTPS 从您的网络访问 HubSpot。没有入站流量。架构:hubspot——包括 hubspot.deals、hubspot.contacts 和 hubspot.associations。表:31 个,其中 7 个默认启用:contacts、companies、deals、owners、pipelines、pipeline_stages 和 properties。
我可以在同一个查询中将 HubSpot 连接到另一个数据库吗?
是的——这就是联合查询。一条语句可以同时引用 HubSpot 和其他连接,格式为 connection.schema.table。每个数据源只运行它能够处理的部分,并将结果流式传输回来;连接操作在中心进行,因此数据源之间不会相互连接,也不会进行任何复制或调度。所有部分(SELECT、WITH 和 EXPLAIN)都采用只读模式,并且单个数据源在单次查询中可以传输的数据量有限制。联合查询是一项套餐功能;联合查询页面会显示当前的数据源和大小限制。

