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

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

ODBC Driver for UMSaaSCloud とSQL Gateway を使用することで、MySQL インターフェースを使ってUM SaaS Cloud にクエリを実行できます。この記事では、MySQL Workbench からUM SaaS Cloud データにSQL クエリを投げてデータを取得する方法をご紹介します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

1. UM SaaS Cloud をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
2. 多様なアプリケーション、ツールにUM SaaS Cloud データを連携
3. ノーコードでの手軽な接続設定
4. 標準 SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてUM SaaS Cloud の接続を設定、2.MySQL Workbench 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとUM SaaS Cloud への接続設定

まずは、本記事右側のサイドバーからUMSaaSCloud ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

未指定の場合は、データソース名（DSN）で必要な接続プロパティの値を指定します。ドライバーのインストールの最後にODBC アドミニストレーターが開きます。Microsoft ODBC データソースアドミニストレーターでDSN を作成及び設定する方法については、ヘルプドキュメントの［はじめに］チャプターを参照してください。

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

デフォルトでは、本製品は本番環境に接続します。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 を構成する

UM SaaS Cloud への接続を仮想MySQL データベースとして設定する方法については、SQL Gateway の解説記事 を参照してください。クライアントからのMySQL リクエストを受けるMySQL リモートサービスを構築します。このサービスは、SQL Gateway のUI で構成できます。

MySQL Workbench からUM SaaS Cloud をクエリ

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

SQL Gateway を介してUM SaaS Cloud に接続

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

UM SaaS Cloud データをクエリしてみる

1. 作成した接続（CData SQL Gateway for UMSaaSCloud）を開きます。
2. ［File］->［New Query Tab］と進みます。
3. SELECT * FROM `CData UMSaaSCloud Sys`.Account; のようなUM SaaS Cloud データを取得するSQL を書いて、実行します。
4. 無事、UM SaaS Cloud のデータが取得できました。

おわりに

MySQL Workbench からリアルタイムUM SaaS Cloud データにアクセスすることで、MySQL データベースと同じようにUM SaaS Cloud をクエリおよび更新できます。CData ODBC Driver for UMSaaSCloud とCData SQL Gateway の30日の無償評価版はこちらです。

CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。