SAS JMP でのCData ODBC Driver for Harvest の使用

古川えりか
コンテンツスペシャリスト

CData ODBC ドライバを使用して、Harvest をSAS JMP で使用可能な統計分析ツールに統合できます。この記事では、Graph Builder とQuery Builder でHarvest を表示する方法について説明します。

また、CData ODBC Driver for API を使用して、リアルタイムデータをSAS JMP の統計分析に統合できます。ドライバーは、クエリを直接Harvest API にプロキシし、分析がデータへの変更を反映していることを確認します。CData ODBC Driver は、レポートをデザインする際バックグラウンドでJMP によって使用される、標準SQL をサポートします。

この記事では、Harvest をレポートにアクセスし、データのビジュアライゼーションを作成する方法を説明します。また、SQL を使用してJMP Query Builder からHarvest のデータをクエリする方法も説明します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

Harvest をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
多様なアプリケーション、ツールにHarvest のデータを連携
ノーコードでの手軽な接続設定
標準 SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてHarvest の接続を設定、2.SAP JMP 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとHarvest への接続設定

まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

未指定の場合は、初めにODBC DSN（data source name）で接続プロパティを指定します。ドライバーのインストールの最後にアドミニストレーターが開きます。Microsoft ODBC Data Source Administrator を使用して、ODBC DSN を作成および構成できます。

まず、Profile 接続プロパティをディスク上のHarvest プロファイルの場所に設定します（例：C:\profiles\Harvest.apip）。次に、ProfileSettings 接続プロパティをHarvest の接続文字列に設定します（以下を参照）。

Harvest API プロファイル設定

Harvest に認証するには、トークン認証またはOAuth 標準のいずれかを使用できます。自分のデータに接続するにはBasic 認証を使用します。他のユーザーが自分のデータに接続できるようにするにはOAuth を使用します。

トークン認証の使用

トークン認証を使用するには、ProfileSettings 接続プロパティでAPIKey にHarvest パーソナルアクセストークンを設定します。APIKey に加えて、ProfileSettings でAccountId を設定して接続します。

OAuth 認証の使用

まず、Harvest でOAuth2 アプリケーションを登録します。アプリケーションはHarvest ID の「Developers」セクションから作成できます。

以下の接続プロパティを設定すると、接続できるようになります。

ProfileSettings：ProfileSettings でAccountId を設定します。
AuthScheme：OAuth に設定します。
OAuthClientId：アプリ設定で指定したclient ID に設定します。
OAuthClientSecret：アプリ設定で指定したclient secret に設定します。
CallbackURL：アプリ設定で指定したRedirect URI に設定します。
InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、ドライバーがOAuthAccessToken を取得および更新する方法を管理できます。

DSN を構成する際に、Max Rows プロパティを定めることも可能です。これによって返される行数を制限するため、ビジュアライゼーション・レポートのデザイン時のパフォーマンスを向上させるのに役立ちます。

Query Builder でHarvest のデータをインポート

Harvest DSN を作成したら、SQL を使用してHarvest API の機能を呼び出すことができます。以下のステップに従ってQuery Builder でサポートされているクエリを実行します。

SAS JMP で［File］->［Database］->［Query Builder］とクリックします。［Select Database Connection］ダイアログが表示されます。
［New Connection］をクリックします。
［Machine Data Source］タブで［DSN］を選択します。次のステップでは、［Select Tables for Query］ダイアログが表示されます。
［Available Tables］セクションでテーブルを選択し、［Primary］をクリックします。
［Available Columns］を［Included Columns］タブにドラッグすると、基になるSQL クエリが更新されます。
データを表示するには［Run Query］をクリックします。
結果を現在のデータで更新するには、［Update from Database］を右クリックし、［Run Script］をクリックします。