设置 Openflow Connector for HubSpot¶

先决条件¶

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

2. 确保您已安装 设置 Openflow - BYOC 或 设置 Openflow - Snowflake 部署。

3. 若使用 Openflow - Snowflake Deployments，请确保您已审阅 配置所需域名 的要求，并已授予对 Hubspot 连接器所需域名的访问权限。

获取凭据¶

作为 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. 在 Snowflake 中为连接器创建数据库和架构，以存储引入的数据。向第一步中创建的角色授予以下 数据库权限 权限。

   CopyExpand

   CREATE DATABASE hubspot_destination_db;
   CREATE SCHEMA hubspot_destination_db.hubspot_destination_schema;
   GRANT USAGE ON DATABASE hubspot_destination_db TO ROLE <hubspot_connector_role>;
   GRANT USAGE ON SCHEMA hubspot_destination_db.hubspot_destination_schema TO ROLE <hubspot_connector_role>;
   GRANT CREATE TABLE, CREATE VIEW ON SCHEMA hubspot_destination_db.hubspot_destination_schema TO ROLE <hubspot_connector_role>;
   

   Show lessSee more

   Scroll to top

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

9. 确保具有连接器所用角色的用户具备使用仓库所需的权限。否则请向该角色授予所需权限。

   CopyExpand

   CREATE WAREHOUSE hubspot_connector_warehouse WITH WAREHOUSE_SIZE = 'X-Small';
   GRANT USAGE ON WAREHOUSE hubspot_connector_warehouse TO ROLE <hubspot_connector_role>;
   

   Show lessSee more

   Scroll to top

设置连接器¶

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

运行流¶

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

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

数据结构和视图¶

连接器在您的 Snowflake 数据库中以以下两种格式存储数据：