PowerPivot でHarvest のデータを連携して取得し分析

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

この記事では、PowerPivot からCData ODBC Driver を使う方法を説明します。「Table Import Wizard」を使ってHarvest のデータをロードします。インポートに使うクエリをビジュアルに作成、あるいはドライバーがサポートするSQL を使って作成できます。

ODBC プロトコルは多くのBI および帳票ツールで多様なデータベースのデータにアクセスするために使われています。CData ODBC Drive を使って、簡単にHarvest をデータ連携できます。この記事では、CData Driver for API を使ってPowerPivot にデータをインポートします。

CData ODBC ドライバとは？

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

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

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

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

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

接続プロパティが未設定の場合には、DSN（データソース名）の設定を行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。

未指定の場合は、初めに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 を取得および更新する方法を管理できます。
Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」を参照してください。
Excel で［PowerPivot］タブの［管理］アイコンをクリックしてPowerPivot を開きます。
［外部データソースの取り込み］から［その他のソース］ボタンをクリックします。
OLEDB/ODBC ソースオプションを選択して、［次へ］をクリックします。
［ビルド］をクリックして［データリンクプロパティ］ダイアログを開きます。このダイアログでは、DSN に基づいて自動的に接続文字列がビルドされます。
［プロバイダー］タブで［Microsoft OLEDB Provider for ODBC Drivers］オプションを選択します。
［接続］タブで［データソース名を使用する］オプションを選択して、メニューからHarvest DSN を選択します。CData Harvest Source DSN はインストール時に作成されます。

Harvest のデータをインポート

下記の手順に従って、ウィザードを使ってHarvest のテーブルからデータをロードします。Harvest のカラムをウィザードを使って選択、フィルタ、およびソートすると、PowerPivot は実行されるクエリを生成します。

［テーブルのインポートウィザード］でDSN を選択してから、［テーブルとビューの一覧から選択し、インポートするデータを選択する］オプションを選択すると、Harvest で利用できるテーブルとビューのリストを見ることができます。
［プレビューとフィルター］をクリックして特定のカラムを選択、データをソート、およびフィルタをカラム値に基づいて視覚的にビルドします。

カスタムクエリインポート

インポートするテーブルを選ぶ以外に、特定のカラムをインポートするクエリの指定やフィルタの定義もできます。ドライバーは元になるHarvest API に相当する、シンプルで直観的なSQL ダイアレクトをサポートします。

［テーブルのインポートウィザード］でDSN を選択してから、［インポートするデータを指定するクエリを記述する］オプションを選択してクエリを書きます。
［SQL ステートメント］ボックスにクエリを入れます。［検証］をクリックしてクエリステートメントが有効かどうかを確認します。［デザイン］をクリックして結果をプレビューし、インポートする前にクエリを直します。

WHERE 句を使ってフィルタライテリアクを指定できます。利用可能なSQL 機能の例については、ヘルプドキュメントの「サポートされるSQL」を参照してください。
ウィザードを終了して選んだクエリでデータをインポートします。