RapidMiner からTalkdesk のデータに連携

この記事では、CData JDBC Driver for Talkdesk をRapidMiner のプロセスと簡単に統合する方法を示します。この記事では、CData JDBC Driver for Talkdesk を使用してTalkdesk をRapidMiner のプロセスに転送します。

RapidMiner のTalkdesk にJDBC Data Source として接続する

以下のステップに従ってTalkdesk へのJDBC 接続を確認できます。

1. Talkdesk 用の新しいデータベースドライバーを追加します。［Connections］->［Manage Database Drivers］とクリックします。
2. 表示されるウィザードで［Add］ボタンをクリックし、接続に名前を入力します。
3. JDBC URL のプレフィックスを入力します。

   
   jdbc:talkdesk:
   

4. インストールディレクトリのlib サブフォルダにあるcdata.jdbc.talkdesk.jar ファイルにパスを入力して下さい。
5. ドライバークラスを入力します。

   
   cdata.jdbc.talkdesk.TalkdeskDriver
   

   
6. 新しいTalkdesk 接続を作成します。［Connections］->［Manage Database Connections］とクリックします。
7. 接続の名前を入力します。
8. データベースシステムの場合は、以前構成したTalkdesk ドライバーを選択します。
9. Host ボックスで接続文字列を入力します。

   Talkdesk では OAuth 2.0 の Client Credentials グラントを使用します。ブラウザでの認可ステップやコールバック URL は必要ありません。

   以下の接続プロパティを設定します。

   • AccountName：Talkdesk アカウントの名前。
   • Region：Talkdesk インスタンスがデプロイされているリージョン。指定できる値は US（デフォルト）、EU、CA、AU、UK、FedRamp です。
   • OAuthClientId：カスタム OAuth アプリケーションの登録時に割り当てられた Client Id。
   • OAuthClientSecret：カスタム OAuth アプリケーションに割り当てられた Client Secret。

   カスタム OAuth アプリケーションの作成

   1. Talkdesk アカウントにログインし、ナビゲーションメニューから OAuth Clients を選択します。
   2. Create OAuth Client をクリックし、クライアントにわかりやすい名前を付けます。
   3. Grant Type を Client Credentials に設定します。
   4. Add scopes をクリックし、アクセスしたいデータに応じたスコープを選択します。
   5. Create をクリックし、Client Id と Client Secret をコピーします。

   接続時、ドライバーは Talkdesk にアクセストークンを自動でリクエストしてキャッシュし、有効期限が切れると更新します。アプリケーションで選択したスコープが、クエリ予定のビューに対応していることを確認してください。対応していない場合、トークンのリクエストが失敗することがあります。

   ビルトイン接続文字列デザイナ

   JDBC URL の構成については、Talkdesk JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

   
   java -jar cdata.jdbc.talkdesk.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   以下は一般的な接続文字列です。

   
   AccountName=myAccount;Region=US;OAuthClientId=myClientId;OAuthClientSecret=myClientSecret;
   

10. 必要であればユーザー名とパスワードを入力します。

プロセス内の様々なRapidMiner オペレーターとのTalkdesk 接続を使用できます。Talkdesk を取得するには、［Operators］ビューから［Retrieve］をドラッグします。 ［Retrieve］オペレータを選択した状態で、［repository entry］の横にあるフォルダアイコンをクリックして［Parameters］ビューで取得するテーブルを定義できます。表示されるRepository ブラウザで接続ノードを展開し、目的のサンプルセットを選択できます。

最後に、［Retrieve］プロセスから結果に出力をワイヤリングし、プロセスを実行してTalkdesk を確認します。