MySQL Workbench で Clio のデータをクエリする方法
Clio 用のODBC Driver のSQL Gateway を使用すると、MySQL インターフェースを通じて Clio のデータ にクエリできます。以下の手順に従って、SQL Gateway のMySQL リモーティングサービスを起動し、MySQL Workbench でリアルタイムの Clio のデータ を操作してみましょう。
Clio のデータへの接続
まだ接続設定を行っていない場合は、データソース名（DSN）で必要な接続プロパティの値を入力してください。組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を設定できます。これはドライバーインストールの最後のステップでもあります。Microsoft ODBC データソースアドミニストレーターを使用してDSN を作成・設定する方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。
まず、Profile 接続プロパティをディスク上のClio プロファイルの場所に設定します（例：C:\profiles\Clio.apip）。次に、ProfileSettings 接続プロパティをClio の接続文字列に設定します（以下を参照）。
Clio API プロファイル設定
Clio はOAuth ベースの認証を使用します。
まず、Clio でOAuth アプリケーションを登録します。Developer アカウントにログインし、Add ボタンをクリックして登録できます。ここでアプリケーションの詳細とスコープを入力します。これらの詳細は、Clio ユーザーがアプリケーションの認可を求められたときに表示されます。OAuth アプリケーションにはclient id（キー）とclient secret（シークレット）が割り当てられます。また、ProfileSettings 接続プロパティでRegion を設定します。
以下の接続プロパティを設定すると、接続できるようになります。
- AuthScheme：OAuth に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、OAuthAccessToken を取得するプロセスを管理できます。
- OAuthClientId：アプリ設定で指定されたclient_id に設定します。
- OAuthClientSecret：アプリ設定で指定されたclient_secret に設定します。
- CallbackURL：アプリ設定で指定されたRedirect URI に設定します。
- Region：ProfileSettings でClio の地理的リージョンに設定します。デフォルトはapp.clio.com です。
SQL Gateway の設定
SQL Gateway の概要を参照して、Clio のデータ への接続を仮想MySQL データベースとしてセットアップしてください。クライアントからのMySQL リクエストをリッスンするMySQL リモーティングサービスを設定します。このサービスはSQL Gateway UI で設定できます。
MySQL Workbench から Clio をクエリ
以下の手順では、SQL Gateway で作成した仮想 Clio データベースにMySQL Workbench から接続し、基本的なクエリを発行してリアルタイムの Clio のデータ を操作する方法を説明します。
SQL Gateway 経由で Clio に接続
- MySQL Workbench で、新しいMySQL 接続を追加するためにクリックします。
- 接続に名前を付けます（CData SQL Gateway for Clio）。
- SQL Gateway に接続するためのHostname、Port、Username パラメータを設定します。
- Store in Vault をクリックしてパスワードを設定・保存します。
- Test Connection をクリックして接続が正しく設定されていることを確認し、OK をクリックします。
NOTE: Username および Password は、SQL Gateway 用に作成したユーザーの資格情報を指します。
Clio のデータをクエリ
- 作成した接続（CData SQL Gateway for Clio）を開きます。
- File -> New Query Tab をクリックします。
- SELECT * FROM `CData API Sys`.Bills; のようなSQL クエリを記述して Clio のデータ を取得します。
MySQL Workbench からリアルタイムの Clio のデータ にアクセスできるようになりました。MySQL データベースと同じ感覚で Clio を簡単に操作できます。CData API Driver for ODBC とCData SQL Gateway の30日間の無償トライアルをぜひお試しください。