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

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

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

ApprovalMax のデータへの接続

まだ接続設定を行っていない場合は、データソース名（DSN）で必要な接続プロパティの値を入力してください。組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を設定できます。これはドライバーインストールの最後のステップでもあります。Microsoft ODBC データソースアドミニストレーターを使用してDSN を作成・設定する方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。

まず、Profile 接続プロパティをディスク上の ApprovalMax プロファイルの場所に設定します（例：C:\profiles\ApprovalMax.apip）。次に、ProfileSettings 接続プロパティを ApprovalMax の接続文字列に設定します（以下を参照）。

ApprovalMax API プロファイル設定

ApprovalMax Public API では、OAuth 2.0 の認可コードフローで認証を行います。自分のデータに接続するだけでなく、他のユーザーが各自のデータに接続できるようにすることも可能です。

まず、ApprovalMax に OAuth アプリケーションを登録する必要があります。ApprovalMax Developer Portal（https://developer.approvalmax.com/applications）にサインインし、新しいアプリケーションを作成します。OAuth アプリケーションには Client ID と Client Secret が割り当てられます。また、Redirect URI（Callback URL）を少なくとも1つ登録しておく必要があります。

Public API を利用するには、ApprovalMax の Premium サブスクリプション（または有効なトライアル）が必要です。

以下の接続プロパティを設定すると、接続できるようになります。

  • AuthScheme：OAuth に設定します。
  • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使うと、OAuthAccessToken を取得するプロセスを管理できます。
  • OAuthClientId：ApprovalMax Developer Portal のアプリケーション設定に表示される Client ID に設定します。
  • OAuthClientSecret：ApprovalMax Developer Portal のアプリケーション設定に表示される Client Secret に設定します。
  • CallbackURL：アプリケーション設定で登録した Redirect URI に設定します。
  • Scope：（オプション）デフォルトの OAuth スコープを上書きします。デフォルト値の openid offline_access https://www.approvalmax.com/scopes/public_api/read は、このプロファイルのすべてのテーブルへの読み取り専用アクセスを許可し、リフレッシュトークンを有効にします。スコープを絞り込む際は、最小権限の原則に従ってください。

OAuth の Authorization URL は https://identity.approvalmax.com/connect/authorize、Token URL は https://identity.approvalmax.com/connect/token です。グラントタイプは authorization_code と refresh_token の両方に対応しています。

SQL Gateway の設定

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

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

MySQL Workbench から ApprovalMax をクエリ

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

SQL Gateway 経由で ApprovalMax に接続

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

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

ApprovalMax のデータをクエリ

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

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

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

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

ApprovalMax に接続

この記事の内容

関連記事