DataGrip で HubSpot のデータ をクエリ

DataGrip は、SQL 開発者がデータベースへのクエリ、作成、管理を行えるデータベース IDE です。CData JDBC Driver for HubSpot と組み合わせることで、DataGrip からリアルタイムHubSpot のデータを操作できます。この記事では、DataGrip で HubSpot のデータ への接続を確立し、テーブルエディタを使用して HubSpot のデータ を読み込む方法を説明します。

はじめに

---

HubSpot 用の新しいドライバー定義を作成

以下のステップでは、DataGrip で HubSpot 用の新しいデータソースを作成する方法を説明します。

1. DataGrip で、File -> New -> Project をクリックしてプロジェクト名を入力します。
2. Database Explorer で、プラスアイコン（）をクリックして Driver を選択します。
3. Driver タブで以下を設定します。
   • Name をわかりやすい名前に設定します（例："CData HubSpot Driver"）。
   • Driver Files を適切な JAR ファイルに設定します。ファイルを追加するには、プラス（）をクリックし、「Add Files」を選択して、ドライバーのインストールディレクトリ内の「lib」フォルダに移動し、JAR ファイル（例：cdata.jdbc.hubspot.jar）を選択します。
   • Class を cdata.jdbc.hubspot.HubSpot.jar に設定します。
   また、詳細タブでは、ドライバーのプロパティや、VM Options、VM environment、VM home path、DBMS などの設定を変更できます。
   • ほとんどの場合、Expert options で DBMS type を「Unknown」に変更して、ネイティブの SQL Server クエリ（Transact-SQL）を回避してください。これを行わないと、無効な関数エラーが発生する可能性があります。
4. 「Apply」をクリックし、「OK」をクリックして接続を保存します。

HubSpot への接続を設定

1. 接続を保存したら、プラス（）をクリックし、「Data Source」→「CData HubSpot Driver」を選択して、新しい HubSpot データソースを作成します。
2. 新しいウィンドウで、JDBC URL を使用して HubSpot への接続を設定します。

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

   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 ベース認証についてはヘルプドキュメントの「接続の確立」セクションを参照してください。

   
3. URL を接続文字列に設定します。例：

   jdbc:hubspot:

4. 「Apply」と「OK」をクリックして接続文字列を保存します。

これで、Data Explorer にデータソースが表示されます。

HubSpot に対して SQL クエリを実行

JDBC Driver を介してアクセス可能な HubSpot のエンティティ（テーブルとして利用可能）を参照するには、データソースを展開します。

クエリを実行するには、任意のテーブルを右クリックして「New」→「Query Console」を選択します。

Console で、実行したい SQL クエリを記述します。例：

SELECT Slug, PageViews FROM Prospects

CData JDBC Driver for HubSpot の30日間の無料トライアルをダウンロードして、DataGrip でリアルタイムHubSpot のデータを操作してみてください。ご不明な点があれば、サポートチームにお問い合わせください。