RapidMiner からShort.io のデータに連携
この記事では、CData JDBC Driver for API をRapidMiner のプロセスと簡単に統合する方法を示します。この記事では、CData JDBC Driver for API を使用してShort.io をRapidMiner のプロセスに転送します。
RapidMiner のShort.io にJDBC Data Source として接続する
以下のステップに従ってShort.io へのJDBC 接続を確認できます。
- Short.io 用の新しいデータベースドライバーを追加します。［Connections］->［Manage Database Drivers］とクリックします。
- 表示されるウィザードで［Add］ボタンをクリックし、接続に名前を入力します。
- JDBC URL のプレフィックスを入力します。
jdbc:api:
- インストールディレクトリのlib サブフォルダにあるcdata.jdbc.api.jar ファイルにパスを入力して下さい。
- ドライバークラスを入力します。
cdata.jdbc.api.APIDriver
- 新しいShort.io 接続を作成します。［Connections］->［Manage Database Connections］とクリックします。
- 接続の名前を入力します。
- データベースシステムの場合は、以前構成したShort.io ドライバーを選択します。
- Host ボックスで接続文字列を入力します。
API キー認証の設定
Short.io は API キー認証を使用します。API キーを取得するには、以下のステップで進めます：
- Short.io アカウントにログインします
- Settings > Integrations & API > API に移動します
- Create API Key をクリックして API キーをコピーします
API キーを取得したら、接続を確立できます：
- AuthScheme：APIKey に設定します。
- APIKey：Settings > Integrations & API > API から取得した Short.io の API キーに設定します。
接続文字列の例：
Profile=C:\profiles\ShortIo.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key';
利用可能なテーブル
Short.io プロファイルでは、以下のテーブルにアクセスできます：
- Domains - 認証済みアカウントに関連付けられた Short.io ドメイン
- Links - ドメインの短縮リンク
- LinkExpand - ドメインとパスから短縮リンクを展開
- LinksByOriginalUrl - 指定した元の宛先 URL に一致する複数の短縮リンクを取得
- Folders - 特定のドメイン内のリンクフォルダー
- LinkPermissions - ドメイン内の特定のリンクの権限レコード
- CountryTargeting - 特定の短縮リンクの国別リダイレクトターゲティングルール
- RegionTargeting - 特定の短縮リンクの地域別リダイレクトターゲティングルール
- Regions - 指定した国コードに対する利用可能な地域／州の一覧
- DomainStatistics - Short.io ドメインのクリック数とトラフィックの集計統計
- LinkStatistics - 特定の Short.io リンクのクリック数とトラフィックの集計統計
ビルトイン接続文字列デザイナ
JDBC URL の構成については、Short.io JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.api.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
以下は一般的な接続文字列です。
Profile=C:\profiles\ShortIo.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key';
- 必要であればユーザー名とパスワードを入力します。
プロセス内の様々なRapidMiner オペレーターとのShort.io 接続を使用できます。Short.io を取得するには、［Operators］ビューから［Retrieve］をドラッグします。
［Retrieve］オペレータを選択した状態で、［repository entry］の横にあるフォルダアイコンをクリックして［Parameters］ビューで取得するテーブルを定義できます。表示されるRepository ブラウザで接続ノードを展開し、目的のサンプルセットを選択できます。
最後に、［Retrieve］プロセスから結果に出力をワイヤリングし、プロセスを実行してShort.io を確認します。
