Openflow Connector for HubSpot について¶
注釈
コネクタには、 コネクタ利用規約 が適用されます。
このトピックでは、 Openflow Connector for HubSpot の基本概念、ワークフロー、および制限事項について説明します。
Openflow Connector for HubSpot は HubSpot データをSnowflakeに取り込みます。HubSpot API を使用してデータを取得し、Snowflake テーブルに格納します。データの取り込みは以下の2つのフェーズで行われます。
初期ロード。最初の API 呼び出しですべてのデータが取得されます。
増分ロード。更新と新しいデータを宛先テーブルにマージし、前回の呼び出しのタイムスタンプを使用して、前回のデータロード以降に更新された問題に結果を限定します。
HubSpot プライベートアプリの詳細については、 プライベートアプリ をご参照ください。
このコネクタは、以下を実行する場合に使用します。
レポート作成、分析、インサイトのため、 HubSpot CRM データをSnowflakeに取り込む
ワークフロー¶
HubSpot 管理者は以下のタスクを実行します。
行うことを意図している API リクエストに必要なスコープを持つ HubSpot インスタンス内に API トークンを生成します。このトークンはコネクタが認証用に使用します。
例えば、
object type
フィールドやupdated after
フィールドなど、オブジェクトを検索する基準を定義します。
Snowflakeアカウント管理者は以下のタスクを実行します。
コネクタ定義ファイルをダウンロードしてSnowflake Openflowキャンバスにインポートします。
コネクタのパラメーターを構成します。
HubSpot プライベートアプリ API トークンを提供します。
フィルターを提供することで、取り込まれるオブジェクトの基準を定義します。
Snowflake内での希望するデータベース名とスキーマ名を設定します。
コネクタフローを実行します。実行時、コネクタは以下を行います。
構成された HubSpot インスタンスからオブジェクトをフェッチするための API 呼び出しを作成します。
関連データを抽出します。
API 呼び出しが少なくとも1つの結果を返した場合、構成された宛先テーブルをSnowflakeデータベースに作成します。
処理したデータを指定したSnowflakeテーブルにロードします。
制限事項¶
1つのコネクタインスタンスは、1つの HubSpot オブジェクトにのみ関連付けることができます。
現在、コネクタは HubSpot プライベートアプリと API トークンを使用した基本認証をサポートしています。つまり、コネクタは API トークンの所有者がアクセスできるデータのみを取り込むことができます。
プロセッサーは、シングルスレッドのみでプライマリノードで動作するように設計されています。
プライベートアプリが行える呼び出し回数は、アカウントのサブスクリプションに基づいています。HubSpot プライベートアプリの制限に関する詳細は、 プライベートアプリの制限 をご参照ください。