各製品の資料を入手。
詳細はこちら →
製品をチェック
HubSpot のデータをA5:SQL Mk-2 でCRUD クエリする方法
ODBC Driver を使ってAPI コーディングなしでHubSpot のデータを自在にCRUD。
最終更新日：2023-09-01
この記事で実現できるHubSpot 連携のシナリオ
こんにちは！ドライバー周りのヘルプドキュメントを担当している兵藤です。
SQL 開発ツールといえば「A5:SQL Mk-2」が有名です。Windows ODBC に強い！というイメージです。多くのエンジニアやIT 担当者に利用されています。 本記事では、HubSpot のデータをCData ODBC ドライバを使って、A5:SQL MK-2 からクエリする方法を説明します。
CData ODBC ドライバとは？
CData ODBC ドライバは、以下のような特徴を持った製品です。
- HubSpot をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
- A5:SQL Mk-2 をはじめとする多様なデータツール、帳票・BI アプリにHubSpot のデータを連携
- ノーコードでの手軽な接続設定
- 標準SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてHubSpot の接続を設定、2.A5:SQL Mk-2 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとHubSpot への接続設定
まずは、本記事右側のサイドバーからHubSpot ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
ODBC ドライバーのインストール完了時にODBC DSN 設定画面が立ち上がります。または、Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定できます。
HubSpot 接続プロパティの取得・設定方法
HubSpot はOAuth 認証 およびPrivateAppToken ベース認証をサポートします。
OAuth
HubSpot は埋め込みOAuth 認証情報を提供しており、デスクトップアプリケーションまたはヘッドレスマシンから簡単に接続できます。 Web アプリケーションから接続するには、カスタムOAuth アプリケーションを作成する必要があります。 OAuth 経由で接続するには、すべての認証フローでAuthScheme をOAuth に設定します。 ヘルプドキュメントでは、利用可能なOAuth フローでのHubSpot への認証について詳しく説明します。 カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、「カスタムOAuth アプリケーションの作成」セクション を参照してください。
また、PrivateAppToken ベース認証についてはヘルプドキュメントの「接続の確立」セクションを参照してください。
A5:SQL Mk-2 からのHubSpot ODBC データソースのクエリ利用方法
ODBC DSN の利用方法
「データベース」→「データベースの追加と削除」を開きます。
「64bit ODBCシステムデータソースを列挙する」にチェックを入れます。システムデータソースを利用するか、ユーザーデータソースを利用するかはどちらでもかまいません。
データベースとして、設定しているODBC DSN がツリービューで表示されます。CData ODBC ドライバで設定されたDSN もここに表示されます。
「CData HubSpot Sys」をダブルクリップします。データベースログイン画面が開くので、ODBC DSN 設定時に使ったHubSpot のユーザーとパスワードでログインします。
HubSpot のオブジェクトがテーブル・ビュー・ストアドプロシージャにモデル化されて表示されます。
テーブルを開いてみます。オブジェクトで利用できるデータがカラムとしてモデル化されています。それぞれのカラムにはデータ型の情報も付いています。
これでA5:SQL Mk2 でHubSpot のデータがクエリできます。
HubSpot のデータをSELECT する
対象のテーブル・ビューを右クリックして「SQL の作成」をクリックしてクエリ作成画面を開きます。
SELECT にチェックを入れます。とりあえず全カラムを指定して条件なしでクエリしてみます。
SQL クエリがA5M2 から生成されます。実行ボタンで実行するとHubSpot の選択したオブジェクトがクエリされ、データがテーブルとして返されます。
次にフィルタリング条件を付けてみます。SQL の作成画面で「絞り込み条件に利用するカラム」をドロップダウンから選択します。以下の絞り込み条件付きのSQL 文がA5M2から生成されるので、WHERE 句に条件を書いて実行します。
--*DataTitle "HubSpot"."（テーブル名）"
--*CaptionFromComment
SELECT
"Id" -- Id
, "LastName" -- LastName
, "FirstName" -- FirstName
, "Name" -- Name
, "Title" -- Title
, "Company" -- Company
, "Status" -- Status
, "Industry" -- Industry
FROM
"HubSpot"."Lead"
WHERE
"Company" = '（フィルタリング条件を入力）'
同じ要領でSQL 作成UI から、SELECT だけでなく、INSERT、UPDATE、DELETE のクエリが作成できます。JOIN や集計クエリもANSI-92 のSQL で作れます。
おわりに
このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをA5:SQL Mk-2 からコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。
日本のユーザー向けにCData ODBC ドライバは、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。
関連コンテンツ
