MySQL Workbench で UM SaaS Cloud のデータをクエリする方法

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

UM SaaS Cloud のデータへの接続

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

UM SaaS Cloud 接続プロパティの取得・設定方法

デフォルトでは、CData 製品は本番環境に接続します。UMSaaSCloud sandbox アカウントを使用するには、UseSandbox をtrue に設定します。ユーザー / パスワード認証を使用している場合は、User にsandbox のユーザー名を設定してください。

UM SaaS Cloud への認証

UM SaaS Cloud は、Basic、OAuth、OAuthJWT（コンシューマーキー）など、複数の認証方式をサポートしています。ここではBasic 認証について説明します。認証情報の詳しい取得方法や他の認証方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。

Basic 認証

Basic 認証は、セキュリティトークンとユーザー資格情報の使用に基づきます。Basic 認証を使用するには、AuthScheme をBasic に、User とPassword をログイン資格情報に設定し、SecurityToken を設定します。

デフォルトではSecurityToken が必要ですが、UM SaaS Cloud で信頼できるIP アドレスの範囲を設定することで、オプションにすることができます。

SQL Gateway の設定

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

MySQL Workbench から UM SaaS Cloud をクエリ

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

SQL Gateway 経由で UM SaaS Cloud に接続

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

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

UM SaaS Cloud のデータをクエリ

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

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