RapidMiner からGumroad のデータに連携
この記事では、CData JDBC Driver for API をRapidMiner のプロセスと簡単に統合する方法を示します。この記事では、CData JDBC Driver for API を使用してGumroad をRapidMiner のプロセスに転送します。
RapidMiner のGumroad にJDBC Data Source として接続する
以下のステップに従ってGumroad へのJDBC 接続を確認できます。
- Gumroad 用の新しいデータベースドライバーを追加します。［Connections］->［Manage Database Drivers］とクリックします。
- 表示されるウィザードで［Add］ボタンをクリックし、接続に名前を入力します。
- JDBC URL のプレフィックスを入力します。
jdbc:api: - インストールディレクトリのlib サブフォルダにあるcdata.jdbc.api.jar ファイルにパスを入力して下さい。
- ドライバークラスを入力します。
cdata.jdbc.api.APIDriver
- 新しいGumroad 接続を作成します。［Connections］->［Manage Database Connections］とクリックします。
- 接続の名前を入力します。
- データベースシステムの場合は、以前構成したGumroad ドライバーを選択します。
- Host ボックスで接続文字列を入力します。
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;
ビルトイン接続文字列デザイナ
JDBC URL の構成については、Gumroad JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.api.jar接続プロパティを入力し、接続文字列をクリップボードにコピーします。
以下は一般的な接続文字列です。
Profile=C:\profiles\Gumroad.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url; - 必要であればユーザー名とパスワードを入力します。
プロセス内の様々なRapidMiner オペレーターとのGumroad 接続を使用できます。Gumroad を取得するには、［Operators］ビューから［Retrieve］をドラッグします。
［Retrieve］オペレータを選択した状態で、［repository entry］の横にあるフォルダアイコンをクリックして［Parameters］ビューで取得するテーブルを定義できます。表示されるRepository ブラウザで接続ノードを展開し、目的のサンプルセットを選択できます。
最後に、［Retrieve］プロセスから結果に出力をワイヤリングし、プロセスを実行してGumroad を確認します。
