测试版连接 HubSpot 和 Snowflake 数据同步（旧版）

将 HubSpot 与 Snowflake（旧版）连接，以将 Snowflake 账户中的表数据与 HubSpot 记录进行同步。本文应作为现有旧版 Snowflake 数据同步集成用户的参考指南。如果您是首次将 Snowflake 与 HubSpot 连接，请点击此处了解更多信息。

开始之前

• 负责连接该集成的 Snowflake 用户必须至少拥有一个 Snowflake 数据仓库的访问权限，并对您要同步的数据库/模式/表/视图具有READ 访问权限。

• 为防止同步错误，Snowflake 管理员应为集成所使用的 Snowflake 用户设置PREVENT_UNLOAD_TO_INLINE_URL = FALSE 权限。

• HubSpot 对您的 Snowflake 实例的访问权限级别取决于分配给它的权限。您可以选择一个 Snowflake 角色，该角色既允许 HubSpot 将选定的客户数据复制到 HubSpot 中，其作用域又在您可接受的范围内。
• 您可以创建多个对象同步任务，以同步来自不同 Snowflake 表的数据，但每个 Snowflake 表仅能设置一个同步任务。
• 如果您需要获取将 HubSpot 连接到您的 Snowflake 账户所需的 IP 地址范围，请联系 HubSpot 支持团队。

连接应用

1. 请确保您的 HubSpot 账户已加入此测试版： Snowflake 数据导入。
2. 访问此链接：https://app.hubspot.com/portal-recommend/l?slug=data-sync/app/2963325。
3. 点击“安装”。
4. 在对话框中，点击“下一步”。然后输入您的Snowflake 账户标识符、用户名，并按照以下步骤分配公钥。

5. 点击“连接到 Snowflake”。您可以继续设置同步，也可以稍后进行设置。

启动同步

1. 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击“Snowflake”。
3. 点击“设置同步”。
4. 在“选择要同步的数据 ”页面上 ：

• • 在Snowflake 卡片 上，选择要从中同步的数据库、模式和表。
  • 选择数据应同步的方向。
  • 选择数据应同步到的HubSpot 对象。

5. 在“配置”页面上：

• • 在“记录匹配”部分 ，选择您希望如何匹配 HubSpot 和 Snowflake 中的记录：
    • “选择自定义字段进行匹配”： 选择 用于在两个应用中匹配记录的Snowflake 字段和 HubSpot 属性。
    • 不进行匹配： 如果您希望将所有 Snowflake 记录迁移到 HubSpot，且目标对象中没有匹配的记录， 建议选择此选项。
    • 了解有关数据同步中记录匹配方式的更多信息。

• • 在“引用字段”部分 ：
    • 选择“数据仓库”字段。所选数据仓库的大小应与您要同步到 HubSpot 的行数相匹配。
    • 选择“记录 ID”字段。该字段是 Snowflake 表中的唯一记录 ID。

• • 在“订阅设置”部分 ，点击“同步频率”下拉菜单，并选择您希望同步数据的频率。
  • 在“映射字段”部分，针对您希望同步到 HubSpot 联系人属性的每一列，设置相应的字段映射 。

6. 在“限制”页面上，点击“编辑”以添加过滤器，从而限制从一个应用同步到另一个应用的记录。您可以使用“AND”或 “OR”条件添加多个过滤器。默认情况下，所有记录都会包含在同步中。
7. 在“审核”页面上，检查您的同步配置，然后点击“保存并同步”。

请注意：通过 Snowflake 数据导入进行的同步不支持关联关系。

从旧版 Snowflake 数据同步集成迁移

HubSpot 将于 2026 年 9 月 28 日停止支持旧版 Snowflake 数据同步集成。请在此日期之前迁移至新版 Snowflake 体验。

1. 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击“Snowflake”。
3. 在停用提示横幅中，点击“设置新同步”。

4. 系统将自动跳转至“数据集成”页面。
5. 在右侧面板中，您的现有 Snowflake 账户将自动填充。点击“选择”。
6. 选择您要同步的 Snowflake 表和数据仓库。
7. 在“您打算如何使用 Snowflake 数据？”对话框中，请选择以下选项之一：

• • 将此应用直接连接到您的 CRM：将选定的 Snowflake 数据直接同步到 HubSpot。如果您在同步前无需修改源数据，建议选择此选项。
    • 系统将提示您选择源列并将其映射到要同步到的 HubSpot 对象，同时设置同步频率。了解有关设置同步的更多信息。
    • 点击“同步到 HubSpot CRM”。
  • 将此应用连接到 Data Hub：在同步到 HubSpot 之前，先将源数据连接到 Data Studio。如果您现有的同步方案使用了筛选器，或者您希望在同步前对记录进行筛选、创建公式、添加条件逻辑或合并多个数据源，则建议选择此选项。
    • 系统将提示您选择源数据列和同步频率。
    • 点击 “设置 CRM 同步”。
    • 您将被重定向至“数据集构建器”，在那里您可以通过筛选器和公式编辑源数据。了解有关如何通过 Data Studio 设置同步的更多信息

设置同步后，请确认数据导入是否符合预期。

1. 在你的 HubSpot 帐户中，单击更多，然后导航到数据管理 > 数据集成。如果你的帐户中未显示更多，请直接导航到数据管理 > 数据集成。
2. 点击“应用同步”选项卡 。
3. 请确认同步操作是否正在正确导入数据。

在确认新同步功能运行正常后，请关闭或删除旧版 Snowflake 数据同步集成。