MySQL Workbench で Factorial のデータをクエリする方法
Factorial 用のODBC Driver のSQL Gateway を使用すると、MySQL インターフェースを通じて Factorial のデータ にクエリできます。以下の手順に従って、SQL Gateway のMySQL リモーティングサービスを起動し、MySQL Workbench でリアルタイムの Factorial のデータ を操作してみましょう。
Factorial のデータへの接続
まだ接続設定を行っていない場合は、データソース名（DSN）で必要な接続プロパティの値を入力してください。組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を設定できます。これはドライバーインストールの最後のステップでもあります。Microsoft ODBC データソースアドミニストレーターを使用してDSN を作成・設定する方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。
認証
Factorial は認証に OAuth 2.0 を使用し、自分の HR データに接続する場合も、他のユーザーが各自のデータに接続できるようにする場合も、OAuth 2.0 認証を利用できます。
OAuth 認証の設定
OAuth を使って接続するには、以下のステップで進めます：
- Factorial の管理パネルに移動して、新しい OAuth アプリケーションを作成します。
- アプリケーション設定から Client ID と Client Secret をコピーします。
- 以下の接続プロパティを設定します。
- AuthScheme：OAuth に設定します。
- OAuthClientId：OAuth Client ID に設定します。
- OAuthClientSecret：OAuth Client Secret に設定します。
- Scope：データへのアクセス権限を指定します（デフォルト："read write"）。
SQL Gateway の設定
SQL Gateway の概要を参照して、Factorial のデータ への接続を仮想MySQL データベースとしてセットアップしてください。クライアントからのMySQL リクエストをリッスンするMySQL リモーティングサービスを設定します。このサービスはSQL Gateway UI で設定できます。
MySQL Workbench から Factorial をクエリ
以下の手順では、SQL Gateway で作成した仮想 Factorial データベースにMySQL Workbench から接続し、基本的なクエリを発行してリアルタイムの Factorial のデータ を操作する方法を説明します。
SQL Gateway 経由で Factorial に接続
- MySQL Workbench で、新しいMySQL 接続を追加するためにクリックします。
- 接続に名前を付けます（CData SQL Gateway for Factorial）。
- SQL Gateway に接続するためのHostname、Port、Username パラメータを設定します。
- Store in Vault をクリックしてパスワードを設定・保存します。
- Test Connection をクリックして接続が正しく設定されていることを確認し、OK をクリックします。
NOTE: Username および Password は、SQL Gateway 用に作成したユーザーの資格情報を指します。
Factorial のデータをクエリ
- 作成した接続（CData SQL Gateway for Factorial）を開きます。
- File -> New Query Tab をクリックします。
- SELECT * FROM `CData API Sys`.Agreements; のようなSQL クエリを記述して Factorial のデータ を取得します。
MySQL Workbench からリアルタイムの Factorial のデータ にアクセスできるようになりました。MySQL データベースと同じ感覚で Factorial を簡単に操作できます。CData API Driver for ODBC とCData SQL Gateway の30日間の無償トライアルをぜひお試しください。