设置 Openflow Connector for HubSpot

备注

使用该连接器需遵守 连接器条款。

本主题介绍设置 Openflow Connector for HubSpot 的步骤。

先决条件

  1. 确保您已查看 关于 Openflow Connector for HubSpot。

  2. 确保您已 设置 Openflow。

获取凭据

作为 HubSpot 管理员，生成 HubSpot 私有应用程序令牌或在您的 HubSpot 账户中创建一个。这使您能够对发送到 HubSpot API 的请求进行身份验证。

  1. 登录您的 HubSpot 账户。

  2. 选择顶部导航栏中的齿轮图标，导航至 Settings。

  3. 在左侧导航栏中，前往 Integrations » Private Apps。

  4. 选择 Create a private app。

    1. 输入应用程序的名称。

    2. 导航到 Scopes 选项卡。

    3. 选择您要发出的 API 请求所需的范围。要查找 API 请求所需的范围，请参阅 范围 (https://developers.hubspot.com/docs/guides/apps/authentication/scopes)。

    4. 选择 Create app。

    5. 为每个端点设置您要发出 API 请求所需的范围。

  5. 选择 View access token 查看访问令牌。将令牌粘贴到连接器参数中，或将其安全保存。

设置 Snowflake 账户

作为 Snowflake 账户管理员，请执行以下任务：

  1. 创建新角色或使用现有角色并授予 数据库权限。

  2. 创建类型为 SERVICE 的新 Snowflake 服务用户。

  3. 向该 Snowflake 服务用户授予您在前面步骤中创建的角色。

  4. 为第 2 步中创建的 Snowflake SERVICE 用户配置 密钥对身份验证。

  5. Snowflake 强烈建议执行此步骤。配置 Openflow 支持的密钥管理器（例如 AWS、Azure 和 Hashicorp），并将公钥和私钥存储在密钥存储库中。

    备注

    如果您出于任何原因不希望使用密钥管理器，则您有责任根据组织的安全策略保护用于密钥对身份验证的公钥和私钥文件。

    1. 配置密钥管理器后，确定如何对其进行身份验证。在 AWS 中，建议您使用与 Openflow 关联的 EC2 实例角色，因为这样就无需保留其他密钥。

    2. 在 Openflow 中，从右上角的汉堡菜单中配置与此密钥管理器关联的参数提供商。导航到 Controller Settings » Parameter Provider，然后提取您的参数值。

    3. 此时，可以使用关联的参数路径引用所有凭据，无需在 Openflow 中保留敏感值。

  6. 如果任何其他 Snowflake 用户需要访问连接器引入的原始文档和表（例如，在 Snowflake 中进行自定义处理），则授予这些用户在步骤 1 中创建的角色。

  7. 指定一个仓库供连接器使用。从最小的仓库规模开始，然后根据要复制的表数量和传输的数据量来测试规模。相较于扩大仓库规模，采用 多集群仓库 通常能更有效地应对海量表数量的扩展需求。

设置连接器

作为数据工程师，执行以下任务以安装和配置连接器：

安装连接器

  1. 导航到 Openflow“Overview”页面。在 Featured connectors 部分中，选择 View more connectors。

  2. 在 Openflow 连接器页面上，找到连接器并选择 Add to runtime。

  3. 在 Select runtime 对话框中，从 Available runtimes 下拉列表中选择您的运行时。

  4. 选择 Add。

    备注

    在安装连接器之前，请确保在 Snowflake 中为连接器创建了数据库和架构，用于存储引入的数据。

  5. 使用您的 Snowflake 账户凭据对部署进行身份验证，并在系统提示时选择 Allow，以允许运行时应用程序访问您的 Snowflake 账户。连接器安装过程需要几分钟才能完成。

  6. 使用您的 Snowflake 账户凭据进行运行时身份验证。

此时将显示 Openflow 画布，其中添加了连接器进程组。

配置连接器

  1. 右键点击导入的进程组并选择 Parameters。

  2. 按照 流参数 中所述填充所需的参数值。

流参数

本节介绍您可以根据以下参数上下文配置的流参数：

HubSpot 源参数

参数

描述

HubSpot 访问令牌

HubSpot 私有应用程序访问令牌。

HubSpot 目标参数

参数

描述

目标数据库

用于永久保存数据的数据库。它必须已经存在于 Snowflake 中

目标架构

用于永久保存数据的架构。它必须已经存在于 Snowflake 中

Snowflake 账户标识符

Snowflake 账户名称格式为 [organization-name]-[account-name]，数据永久保存在其中

Snowflake 身份验证策略

对 Snowflake 进行身份验证的策略。可能的值：SNOWFLAKE_SESSION_TOKEN – 当我们在 SPCS 上运行流时；KEY_PAIR – 当我们想使用私钥设置访问权限时

Snowflake 私钥

用于身份验证的 RSA 私钥。RSA 密钥必须按照 PKCS8 标准进行格式化，并具有标准的 PEM 头尾标记。请注意，必须定义 Snowflake 私钥文件或 Snowflake 私钥

Snowflake 私钥文件

该文件包含用于对 Snowflake 进行身份验证的 RSA 私钥，该私钥根据 PKCS8 标准进行格式化，并具有标准的 PEM 头尾标记。头标记行以 -----BEGIN PRIVATE 开头。选中 Reference asset 复选框，上传私钥文件。

Snowflake 私钥密码

与 Snowflake 私钥文件关联的密码

Snowflake 角色

查询执行期间使用的 Snowflake 角色

Snowflake 用户名

用于连接到 Snowflake 实例的用户名

Snowflake 仓库

用于运行查询的 Snowflake 仓库

HubSpot 引入参数

参数

描述

对象类型

要引入的 HubSpot 对象的类型。

可能的值：

  • Products

  • Contacts

  • Companies

  • Feedback Submissions

  • Leads

  • Deals

  • Tickets

  • Goals

  • Line Items

之后更新

筛选在指定日期或时间之后更新的对象

存档数据同步时间表

距离下一次计划之间的时间。持续时间应当有效，例如 30 分钟或 1 小时。

最新数据同步时间表

距离下一次计划之间的时间。持续时间应当有效，例如 30 分钟或 1 小时。

运行流

  1. 右键点击“飞机”图标并选择 Enable all Controller Services。

  2. 右键点击导入的进程组并选择 Start。连接器开始数据引入。

重新配置连接器

连接器开始引入数据后，您可以修改连接器参数。如果问题查询标准发生变化，请执行以下步骤以确保目标表中的数据一致。

  1. 停止连接器：确保所有 Openflow 处理器都已停止。

  2. 访问配置设置：在 Snowflake Openflow 界面中导航到连接器的配置设置。

  3. 修改参数：根据需要调整参数。

  4. 清除处理器状态：如果您要更改引入标准，Snowflake 强烈建议您从头开始引入，以保持目标表中的数据一致。清除 IngestJiraIssues 处理器中的状态后，连接器将从头开始提取所有问题。可能需要手动截断目标表，以防止行重复。

语言: 中文