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

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

Sage X3 Cloud のデータへの接続

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

Sage X3 Cloud では OAuth 2.0 の Client Credentials フローを使用し、API へのアクセスには X-API-Key も必要です。AuthScheme を OAuth に設定し、以下の接続プロパティを指定します。

• URL：Sage X3 Cloud インスタンスのベース URL。
• OAuthAccessTokenUrl：OAuth トークンエンドポイント（例：https://your-auth-domain/oauth/token）。
• OAuthClientId：OAuth アプリケーションのクライアント ID。
• OAuthClientSecret：OAuth アプリケーションのクライアントシークレット。
• Audience：トークンリクエストで使用する API の Audience 値。
• XAPIKey：Sage X3 Cloud の管理者から提供された X-API-Key。
• Folder：Sage X3 のフォルダ名（例：SEED）。このフォルダがデフォルトのスキーマとして使用されます。
• Folders（オプション）：Sage X3 フォルダのカンマ区切りリスト（例：SEED,PERF）。各フォルダが個別のスキーマとして公開されるため、Schema.Table 構文でフォルダをまたいだクエリを実行できます。

ドライバーは Client Credentials フローでアクセストークンを取得し、すべての API リクエストで X-API-Key とあわせて送信します。InitiateOAuth を GETANDREFRESH（デフォルト）に設定しておけば、トークンの取得と更新は自動で行われます。

SQL Gateway の設定

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

MySQL Workbench から Sage X3 Cloud をクエリ

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

SQL Gateway 経由で Sage X3 Cloud に接続

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

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

Sage X3 Cloud のデータをクエリ

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

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