SnapLogic を使用して HubSpot を外部サービスと連携

SnapLogic は、ノーコードでデータ連携フローを作成できる iPaaS（Integration Platform as a Service）です。CData JDBC Driver と組み合わせることで、HubSpot を含む250を超える SaaS、ビッグデータ、NoSQL ソースのリアルタイムデータに SnapLogic ワークフローからアクセスできます。

CData JDBC Driver は、最適化されたデータ処理機能を内蔵しており、リアルタイム HubSpot のデータ とのやり取りにおいて比類ないパフォーマンスを発揮します。外部ツールから複雑な SQL クエリが発行されると、ドライバーはフィルタや集計などのサポートされている SQL 操作を HubSpot に直接プッシュし、サポートされていない操作（多くの場合、SQL 関数や JOIN 操作）は内蔵の SQL エンジンを使用してクライアント側で処理します。動的なメタデータクエリ機能により、ネイティブデータ型を使用して HubSpot のデータ を操作できます。

はじめに

---

SnapLogic から HubSpot に接続

SnapLogic から HubSpot のデータ に接続するには、CData HubSpot JDBC Driver をダウンロードしてインストールします。インストールウィザードに従って進めてください。インストールが完了すると、JAR ファイルはインストールディレクトリ（デフォルトでは C:/Program Files/CData/CData JDBC Driver for HubSpot/lib）に配置されます。

HubSpot JDBC Driver のアップロード

インストール後、Manager タブから SnapLogic 内の場所（例：projects/Jerod Johnson）に JDBC JAR ファイルをアップロードします。

接続の設定

JDBC Driver をアップロードしたら、HubSpot への接続を作成します。

1. Designer タブに移動します
2. Snaps から「JDBC」を展開し、「Generic JDBC - Select」snap をデザイナーにドラッグします
3. Add Account をクリック（または既存のアカウントを選択）し、「Continue」をクリックします
4. 次のフォームで、JDBC 接続プロパティを設定します：
   • JDBC JARs に、先ほどアップロードした JAR ファイルを追加します
   • JDBC Driver Class を cdata.jdbc.hubspot.HubSpotDriver に設定します

   • JDBC URL を HubSpot JDBC Driver の JDBC 接続文字列に設定します。例：

     jdbc:hubspot:RTK=XXXXXX;

     注意：RTK はトライアルキーまたは製品キーです。詳細についてはサポートチームまでお問い合わせください。

     組み込みの接続文字列デザイナー

     JDBC URL の構築には、HubSpot JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

     java -jar cdata.jdbc.hubspot.jar

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     HubSpot 接続プロパティの取得・設定方法

     HubSpot はOAuth 認証 およびPrivateAppToken ベース認証をサポートします。

     OAuth

     HubSpot は埋め込みOAuth 認証情報を提供しており、デスクトップアプリケーションまたはヘッドレスマシンから簡単に接続できます。 Web アプリケーションから接続するには、カスタムOAuth アプリケーションを作成する必要があります。 OAuth 経由で接続するには、すべての認証フローでAuthScheme をOAuth に設定します。 ヘルプドキュメントでは、利用可能なOAuth フローでのHubSpot への認証について詳しく説明します。 カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、「カスタムOAuth アプリケーションの作成」セクション を参照してください。

     また、PrivateAppToken ベース認証についてはヘルプドキュメントの「接続の確立」セクションを参照してください。

     
5. 接続プロパティを入力したら、「Validate」をクリックし、「Apply」をクリックします

HubSpot のデータ の読み取り

接続の検証と適用後に開くフォームで、クエリを設定します。

• Schema name を「HubSpot」に設定します
• Table name を HubSpot のテーブルに設定します。スキーマ名を使用して、例：「HubSpot」.「Prospects」（ドロップダウンで利用可能なテーブルの一覧を確認できます）
• テーブルから使用する各項目の Output fields を追加します

Generic JDBC - Select snap を保存します。

接続とクエリを設定したら、snap の末尾をクリックしてデータをプレビューします（下図でハイライト表示）。

結果が期待通りであることを確認したら、追加の snap を使用して HubSpot のデータ を別のエンドポイントに送信できます。

HubSpot のデータ を外部サービスにパイプ

この記事では、データを Google スプレッドシートに読み込みます。サポートされている任意の snap を使用するか、別の CData JDBC Driver と Generic JDBC snap を使用して、外部サービスにデータを移動できます。

1. 「Worksheet Writer」snap を「Generic JDBC - Select」snap の末尾にドロップします。
2. Google Sheets に接続するためのアカウントを追加します
3. Worksheet Writer snap を設定して、HubSpot のデータ を Google スプレッドシートに書き込みます

これで、完全に設定されたパイプラインを実行して、HubSpot からデータを抽出し、Google スプレッドシートにプッシュできます。

外部データを HubSpot にパイプ

上記の通り、SnapLogic で HubSpot 用の JDBC Driver を使用して HubSpot にデータを書き込むこともできます。まず、Generic JDBC - Insert または Generic JDBC - Update snap をダッシュボードに追加します。

1. 既存の「Account」（接続）を選択するか、新しいものを作成します
2. クエリを設定します：
   • Schema name を「HubSpot」に設定します
   • Table name を HubSpot のテーブルに設定します。スキーマ名を使用して、例：「HubSpot」.「Prospects」（ドロップダウンで利用可能なテーブルの一覧を確認できます）
   
3. Generic JDBC - Insert/Update snap を保存します

これで、HubSpot にデータを書き込み、新しいレコードを挿入したり既存のレコードを更新したりする snap が設定されました。

詳細情報と無料トライアル

CData JDBC Driver for HubSpot を使用することで、SnapLogic で HubSpot のデータ を外部サービスと連携するパイプラインを作成できます。HubSpot への接続の詳細については、CData JDBC Driver for HubSpot ページをご覧ください。CData JDBC Driver for HubSpot の30日間無料トライアルをダウンロードして、今すぐお試しください。