MySQL Workbench で Harvest のデータをクエリする方法

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
MySQL Workbench から Harvest のデータ にMySQL クエリを実行。

Harvest 用のODBC Driver のSQL Gateway を使用すると、MySQL インターフェースを通じて Harvest のデータ にクエリできます。以下の手順に従って、SQL Gateway のMySQL リモーティングサービスを起動し、MySQL Workbench でリアルタイムの Harvest のデータ を操作してみましょう。

Harvest のデータへの接続

まだ接続設定を行っていない場合は、データソース名（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 を取得および更新する方法を管理できます。

SQL Gateway の設定

SQL Gateway の概要を参照して、Harvest のデータ への接続を仮想MySQL データベースとしてセットアップしてください。クライアントからのMySQL リクエストをリッスンするMySQL リモーティングサービスを設定します。このサービスはSQL Gateway UI で設定できます。

SQL Gateway でMySQL リモーティングサービスを作成（Salesforce の例）

MySQL Workbench から Harvest をクエリ

以下の手順では、SQL Gateway で作成した仮想 Harvest データベースにMySQL Workbench から接続し、基本的なクエリを発行してリアルタイムの Harvest のデータ を操作する方法を説明します。

SQL Gateway 経由で Harvest に接続

  1. MySQL Workbench で、新しいMySQL 接続を追加するためにクリックします。
  2. 接続に名前を付けます（CData SQL Gateway for Harvest）。
  3. SQL Gateway に接続するためのHostname、Port、Username パラメータを設定します。
  4. Store in Vault をクリックしてパスワードを設定・保存します。
  5. Test Connection をクリックして接続が正しく設定されていることを確認し、OK をクリックします。

NOTE: Username および Password は、SQL Gateway 用に作成したユーザーの資格情報を指します。

Harvest のデータをクエリ

  1. 作成した接続（CData SQL Gateway for Harvest）を開きます。
  2. File -> New Query Tab をクリックします。
  3. SELECT * FROM `CData API Sys`.Invoices; のようなSQL クエリを記述して Harvest のデータ を取得します。

MySQL Workbench からリアルタイムの Harvest のデータ にアクセスできるようになりました。MySQL データベースと同じ感覚で Harvest を簡単に操作できます。CData API Driver for ODBC とCData SQL Gateway の30日間の無償トライアルをぜひお試しください。

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

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

Harvest に接続 お問い合わせ

この記事の内容

関連記事