MySQL Workbench で Gumroad のデータをクエリする方法
Gumroad 用のODBC Driver のSQL Gateway を使用すると、MySQL インターフェースを通じて Gumroad のデータ にクエリできます。以下の手順に従って、SQL Gateway のMySQL リモーティングサービスを起動し、MySQL Workbench でリアルタイムの Gumroad のデータ を操作してみましょう。
Gumroad のデータへの接続
まだ接続設定を行っていない場合は、データソース名（DSN）で必要な接続プロパティの値を入力してください。組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を設定できます。これはドライバーインストールの最後のステップでもあります。Microsoft ODBC データソースアドミニストレーターを使用してDSN を作成・設定する方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。
OAuth 認証の設定
Gumroad への認証では、OAuth 2.0 標準を使って自分自身のデータに接続する場合はもちろん、他のユーザーが各自のデータに接続できるようにする場合にも利用できます。これが推奨される認証方式です。
まず、Gumroad に OAuth アプリケーションを登録する必要があります。https://app.gumroad.com/settings/advanced の Gumroad アカウント設定にアクセスし、Applications セクションに移動して OAuth アプリケーションを作成できます。
以下の接続プロパティを設定して接続を確立してください：
- AuthScheme：OAuth に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。CData API Profile for Gumroad が OAuth プロセスを自動的に進め、アクセストークンを取得します。
- OAuthClientID：アプリ設定で指定された client_id に設定します。
- OAuthClientSecret：アプリ設定で指定された client_secret に設定します。
- CallbackURL：アプリ設定で指定したリダイレクト URI に設定します。
接続文字列の例
Profile=C:\profiles\Gumroad.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
SQL Gateway の設定
SQL Gateway の概要を参照して、Gumroad のデータ への接続を仮想MySQL データベースとしてセットアップしてください。クライアントからのMySQL リクエストをリッスンするMySQL リモーティングサービスを設定します。このサービスはSQL Gateway UI で設定できます。
MySQL Workbench から Gumroad をクエリ
以下の手順では、SQL Gateway で作成した仮想 Gumroad データベースにMySQL Workbench から接続し、基本的なクエリを発行してリアルタイムの Gumroad のデータ を操作する方法を説明します。
SQL Gateway 経由で Gumroad に接続
- MySQL Workbench で、新しいMySQL 接続を追加するためにクリックします。
- 接続に名前を付けます（CData SQL Gateway for Gumroad）。
- SQL Gateway に接続するためのHostname、Port、Username パラメータを設定します。
- Store in Vault をクリックしてパスワードを設定・保存します。
- Test Connection をクリックして接続が正しく設定されていることを確認し、OK をクリックします。
NOTE: Username および Password は、SQL Gateway 用に作成したユーザーの資格情報を指します。
Gumroad のデータをクエリ
- 作成した接続（CData SQL Gateway for Gumroad）を開きます。
- File -> New Query Tab をクリックします。
- SELECT * FROM `CData API Sys`.CustomFields; のようなSQL クエリを記述して Gumroad のデータ を取得します。
MySQL Workbench からリアルタイムの Gumroad のデータ にアクセスできるようになりました。MySQL データベースと同じ感覚で Gumroad を簡単に操作できます。CData API Driver for ODBC とCData SQL Gateway の30日間の無償トライアルをぜひお試しください。