CSA Data Uploader にてHarvest のデータを、クラウドストレージにアップロード

古川えりか
古川えりか
コンテンツスペシャリスト
Harvest へのライブ接続を行うデータアップロードジョブを構築



CData ODBC ドライバは、ODBC 標準インターフェースを利用したHarvest へのリアルタイムデータアクセスを可能にし、使い慣れたSQL クエリで多種多様なBI、レポート、ETL ツールでHarvest を扱うことができます 。

この記事では、Amazon S3 やGoogle Cloud Storage などのクラウドストレージへのデータプレパレーション、ファイルアップロードを得意とするCSA Data Uploader でODBC 接続を使用してHarvest のデータの利用方法を示します。

CData ODBC ドライバとは?

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

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

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

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

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

  1. まずODBN DSN に必要な接続プロパティの値を入力します。組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。これは、ドライバーのインストール時の最後のステップでも可能です。Microsoft 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 を取得および更新する方法を管理できます。
  2. DSN 設定 (Salesforce の場合)
  3. CSA Data Uploader を開いて「設定 -> ODBC」に移動します。
  4. ODBC 設定
  5. 「追加」をクリックします。
  6. ODBC の追加
  7. 種別を「汎用ODBC」、「データソース名」で先ほど作成したODBC DSN を選択します。
  8. ODBC 接続の構成

入力後、接続テストが成功すれば設定は完了です。併せて任意のデータアップロード先の接続(Amazon S3・Google Cloud Storage など)も作成しておきましょう。

Harvest ジョブの構成

続いてCSA DataUploader の対象データ参照し、クラウドストレージへデータをアップロードするジョブを構成します。

  1. 「ジョブ」のページに移動して「ジョブを作成」をクリックします。
  2. ジョブを作成
  3. 任意の名称でジョブを作成します。ジョブ種別は「データアップロード」を選んでください。
  4. ジョブ名の設定
  5. ジョブは最初に入力対象となるデータを設定します。
  6. ジョブの入力設定の追加
  7. 入力種別では、ODBC 接続を選択し、データソース名で先ほど設定したODBC DSN を選択します。併せて、Harvest からデータを取得するためのSQL ベースのクエリを記述します。
  8. 入力設定の構成
  9. なお、SQL でクエリ可能なテーブルはODBC DSN の「テーブル」タブで確認できます。
  10. ODBC DSN のテーブルタブ
  11. 入力設定を保存したら、「データ表示」ボタンをクリックすることで実際にHarvest から取得したデータを確認できます。
  12. データの表示
  13. 以下のようにプレビューが表示されれば設定はOK です。
  14. プレビューの確認
  15. 併せて出力設定先となるクラウドストレージの情報を追加してください。
  16. 出力先設定の追加
  17. 事前に構成したコネクション情報で出力先を設定します。
  18. 出力先設定の追加
  19. これでジョブの作成は完了です。実行することで Harvest のデータをクラウドストレージにアップロードすることができます。
  20. ジョブの確認

おわりに

このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。

CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。

はじめる準備はできましたか?

API Driver で Harvest のライブデータに接続

Harvest に接続 お問い合わせ