测试版将 HubSpot 连接到 Microsoft Azure Synapse Analytics
上次更新时间: 2026年11月2日
请注意:如果您是超级管理员,请将您的账户加入Data Studio 测试版,以便使用此功能。
某些功能需要 HubSpot 点数 将 Data Studio 中单个数据仓库源的数据直接同步到 HubSpot CRM 不会消耗HubSpot 积分。 如果您在同步前先在 Data Studio 中对数据进行预处理(例如,创建计算字段或与其他数据源进行关联),这些操作将消耗 HubSpot 积分。
总结
将 HubSpot 连接到 Microsoft Azure Synapse Analytics,可将选定的 HubSpot CRM 数据导出到 Azure Synapse 专用 SQL 池中的原生表中。您可以为每个目标选择对象、关联、事件和同步计划。
开始之前
了解要求
您需要以下内容:
- 一个带有正在运行的专用 SQL 池的 Azure Synapse 工作区。
- 专用 SQL 池中用于存储 HubSpot 导出数据的数据库。
- 一个 Microsoft Entra ID 服务主体。
- 在所选 Synapse 数据库中,该服务主体对应的用户。
- 创建和管理 HubSpot 拥有的模式和表所需的权限。
该 Microsoft Entra ID 服务主体必须能够:
- 创建模式。
- 创建表。
- 插入行。
- 重命名或修改 HubSpot 拥有的表。
- 删除 HubSpot 拥有的表和模式。
HubSpot 会为每个目标创建并管理一个独立的模式。请勿直接修改该模式中的对象。
请注意:Azure Synapse Data Out 仅支持专用 SQL 池。不支持无服务器 SQL 池。
了解网络要求
HubSpot 必须能够通过 TCP 端口 1433 访问 Azure Synapse 专用 SQL 端点。HubSpot 使用 TLS,且会验证服务器证书。
如果您的 Synapse 工作区启用了防火墙或网络限制,请允许来自您账户所在区域的 HubSpot Synapse 出站地址的入站访问。
| 区域 | IP 范围 |
|---|---|
| NA1 | 54.174.62.128/26 |
| EU1 | 143.244.87.0/25 |
| AP1 | 216.157.42.32/27 |
| NA2 | 216.157.40.32/27 |
| NA3 | 216.157.41.32/27 |
安装 Microsoft Azure Synapse Analytics 应用
建议在浏览器的不同标签页中分别打开 HubSpot 和 Azure 控制台。
- 在HubSpot 应用市场中,搜索“Microsoft Azure Synapse Analytics”。
- 点击“安装”。
- 点击“下一步”。
- 输入所需的 Microsoft Entra ID 信息:
- 租户 ID。
- 客户端 ID。
- 客户端密钥。
- 点击“连接到 Microsoft Azure Synapse Analytics”。
将 HubSpot 连接到您的 Synapse 数据库
- 在“权限”部分,复制显示的 SQL 模板。
- 将占位符替换为您 Microsoft Entra ID 服务主体的名称。
- 在您选定的 Synapse 数据库中运行这些 SQL 语句。
- 在“目标”部分,输入以下信息:
- 专用 SQL 端点。
- 数据库名称。
请按以下格式使用专用 SQL 端点:
<workspace-name>.sql.azuresynapse.net
请勿使用无服务器 SQL 端点:
<workspace-name>-ondemand.sql.azuresynapse.net
- 请确保所选的专用 SQL 池正在运行。
- 单击“测试连接”。
- 如果连接测试成功,请单击“下一步”。
请注意:已暂停或不可用的专用 SQL 池可能会导致连接测试或同步失败。
配置同步
- 选择要导出的数据源。
- 选择要包含的对象、关联和事件。
- 选择同步频率和开始时间。
- 点击“开始同步”。
监控同步
要查看同步详细信息(包括同步状态、上次同步、错误、同步活动和同步历史记录):
- 在你的 HubSpot 帐户中,单击更多,然后导航到数据管理 > 数据集成。如果你的帐户中未显示更多,请直接导航到数据管理 > 数据集成。
- 点击“应用同步”。
- 搜索“Microsoft Azure Synapse Analytics”。
- 点击该同步任务。
在同步详细信息页面中,您可以:
- 暂停同步。
- 将同步归档。
- 手动启动同步。