Openflow Connector for HubSpot について

注釈

コネクタには、 コネクタ利用規約 が適用されます。

このトピックでは、 Openflow Connector for HubSpot の基本概念、ワークフロー、および制限事項について説明します。

Openflow Connector for HubSpot は HubSpot データをSnowflakeに取り込みます。HubSpot API を使用してデータを取得し、Snowflake テーブルに格納します。データの取り込みは以下の2つのフェーズで行われます。

  1. 初期ロード。最初の API 呼び出しですべてのデータが取得されます。

  2. 増分ロード。更新と新しいデータを宛先テーブルにマージし、前回の呼び出しのタイムスタンプを使用して、前回のデータロード以降に更新された問題に結果を限定します。

HubSpot プライベートアプリの詳細については、 プライベートアプリ をご参照ください。

このコネクタは、以下を実行する場合に使用します。

  • レポート作成、分析、インサイトのため、 HubSpot CRM データをSnowflakeに取り込む

ワークフロー

  1. HubSpot 管理者は以下のタスクを実行します。

    1. 行うことを意図している API リクエストに必要なスコープを持つ HubSpot インスタンス内に API トークンを生成します。このトークンはコネクタが認証用に使用します。

    2. 例えば、 object type フィールドや updated after フィールドなど、オブジェクトを検索する基準を定義します。

  2. Snowflakeアカウント管理者は以下のタスクを実行します。

    1. コネクタ定義ファイルをダウンロードしてSnowflake Openflowキャンバスにインポートします。

    2. コネクタのパラメーターを構成します。

      • HubSpot プライベートアプリ API トークンを提供します。

      • フィルターを提供することで、取り込まれるオブジェクトの基準を定義します。

      • Snowflake内での希望するデータベース名とスキーマ名を設定します。

    3. コネクタフローを実行します。実行時、コネクタは以下を行います。

      1. 構成された HubSpot インスタンスからオブジェクトをフェッチするための API 呼び出しを作成します。

      2. 関連データを抽出します。

      3. API 呼び出しが少なくとも1つの結果を返した場合、構成された宛先テーブルをSnowflakeデータベースに作成します。

      4. 処理したデータを指定したSnowflakeテーブルにロードします。

制限事項

  • 1つのコネクタインスタンスは、1つの HubSpot オブジェクトにのみ関連付けることができます。

  • 現在、コネクタは HubSpot プライベートアプリと API トークンを使用した基本認証をサポートしています。つまり、コネクタは API トークンの所有者がアクセスできるデータのみを取り込むことができます。

  • プロセッサーは、シングルスレッドのみでプライマリノードで動作するように設計されています。

  • プライベートアプリが行える呼び出し回数は、アカウントのサブスクリプションに基づいています。HubSpot プライベートアプリの制限に関する詳細は、 プライベートアプリの制限 をご参照ください。

次のステップ

Openflow Connector for HubSpot を設定する