RapidMiner からCarbone のデータに連携
この記事では、CData JDBC Driver for API をRapidMiner のプロセスと簡単に統合する方法を示します。この記事では、CData JDBC Driver for API を使用してCarbone をRapidMiner のプロセスに転送します。
RapidMiner のCarbone にJDBC Data Source として接続する
以下のステップに従ってCarbone へのJDBC 接続を確認できます。
- Carbone 用の新しいデータベースドライバーを追加します。［Connections］->［Manage Database Drivers］とクリックします。
- 表示されるウィザードで［Add］ボタンをクリックし、接続に名前を入力します。
- JDBC URL のプレフィックスを入力します。
jdbc:api: - インストールディレクトリのlib サブフォルダにあるcdata.jdbc.api.jar ファイルにパスを入力して下さい。
- ドライバークラスを入力します。
cdata.jdbc.api.APIDriver
- 新しいCarbone 接続を作成します。［Connections］->［Manage Database Connections］とクリックします。
- 接続の名前を入力します。
- データベースシステムの場合は、以前構成したCarbone ドライバーを選択します。
- Host ボックスで接続文字列を入力します。
まず、Profile 接続プロパティをディスク上の Carbone プロファイルの場所に設定します（例：C:\profiles\Carbone.apip）。次に、ProfileSettings 接続プロパティを Carbone の接続文字列に設定します（以下を参照）。
Carbone API プロファイル設定
Carbone では、Authorization ヘッダーの Bearer トークンによる API キー認証を使用します。API キーは以下の手順で取得できます。
- https://account.carbone.io で Carbone アカウントにログインします。
- アカウントのホームページに表示されている API キーをコピーします。
API キーを取得したら、以下の接続プロパティを設定します。
- AuthScheme：APIKey に設定します。
- APIKey：Carbone の API キー（Bearer トークン）に設定します。
- CarboneVersion：（オプション）carbone-version リクエストヘッダーで指定する、対象の Carbone API のメジャーバージョンです。デフォルトは 5 です。指定できる値は 5、4、3、staging です。
ビルトイン接続文字列デザイナ
JDBC URL の構成については、Carbone JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.api.jar接続プロパティを入力し、接続文字列をクリップボードにコピーします。
以下は一般的な接続文字列です。
Profile=C:\profiles\Carbone.apip;AuthScheme=APIKey;APIKey=your_api_key; - 必要であればユーザー名とパスワードを入力します。
プロセス内の様々なRapidMiner オペレーターとのCarbone 接続を使用できます。Carbone を取得するには、［Operators］ビューから［Retrieve］をドラッグします。
［Retrieve］オペレータを選択した状態で、［repository entry］の横にあるフォルダアイコンをクリックして［Parameters］ビューで取得するテーブルを定義できます。表示されるRepository ブラウザで接続ノードを展開し、目的のサンプルセットを選択できます。
最後に、［Retrieve］プロセスから結果に出力をワイヤリングし、プロセスを実行してCarbone を確認します。
