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