KNIME の標準データアクセスコンポーネントを使用してSurveyMonkey でチャートとレポートを作成します。
CData JDBC Driver for SurveyMonkey の強みの一つは、クロスプラットフォームのサポートであり、主要なBI ツールとの統合を可能にします。以下のステップに従って、KNIME のSurveyMonkey にアクセスし、レポートデザイナを使用してSurveyMonkey からチャートを作成します。
CData JDBC Driver for SurveyMonkey を使用することで、JDBC データソースとしてSurveyMonkey にアクセスでき、IDE の迅速な開発ツールとの統合が可能になります。この記事では、データソース構成ウィザードを使用してIntelliJ のSurveyMonkey に接続する方法を示します。
※製品について詳しい情報をご希望の方は以下からお進みください。
- SurveyMonkey にほかのBI、ETL、開発ツールから接続したい:SurveyMonkey データ連携ガイドおよびチュートリアルのリストへ
- SurveyMonkey Drivers について詳細を知りたい:ドライバー詳細情報ページへ
- ほかのデータソースに連携したい:CData Drivers 一覧へ
- ドライバーの30日の無償トライアル版を使いたい:トライアル版ダウンロードページへ
- 製品の利用やライセンスについて相談したい:sales@cdata.co.jp までメールにてご相談ください。
SurveyMonkey データへの新しいJDBC 接続を定義します。
- Report Designer 機能をインストールします。[File]->[Install KNIME Extensions]とクリックし、[Report]でフィルタリングします。
- 新しいワークフローで[File]->[Preferences]をクリックし、[KNIME]->[Databases]でノードを展開し cdata.jdbc.surveymonkey.jar を追加します。
- ドライバーJAR は、インストールディレクトリのlib サブフォルダにあります。
-
[Node Repository]ビューで[Database]->[Read/Write]とノードを展開し、[Database Reader]をワークフローエディターにドラッグします。
-
[Database Reader]をダブルクリックし、次のプロパティを設定します。
- Database Driver:メニューでドライバーの名前(cdata.jdbc.surveymonkey.SurveyMonkeyDriver)を選択します。
Database URL:接続プロパティを入力します。jdbc:surveymonkey: から始まり、その後にセミコロンで区切られた接続プロパティのリストが続くJDBC URL を入力します。
SurveyMonkey はOAuth 2 認証標準を利用しています。SurveyMonkey がアンケートの回答を読むためにこれを必要とすることを考えると、アンケートを読むアカウントには有料プランのサブスクリプションが必要です。
SurveyMonkey への接続に使用できる認証方法は2つあります。
- プライベートoauth アプリケーションを登録するときに、個人用アクセストークンを使用します。
- パブリックoauth アプリケーションを登録するときに、OAuth を使用します。
個人用アクセストークンの使用
個人用トークンを使用して、自分のデータをテストし、アクセスします。個人用トークンを取得するには、Creating a Custom OAuth App の手順に従って、次の接続プロパティを設定します。
- OAuthAccessToken:アプリケーション設定で生成されたAccessToken に設定。
- InitiateOAuth:OFF に設定。
OAuth の使用
本製品はすでにSurveyMonkey にOAuth アプリケーションとして登録されています。そのため、デフォルトでは、自動的にEmbedded Credentials を使用して接続します。
独自のカスタムOAuth アプリを使用したい場合は、Custom Credentials を参照してください。
ビルトイン接続文字列デザイナ
JDBC URL の構成については、SurveyMonkey JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.surveymonkey.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。
以下は一般的なJDBC URL です。
jdbc:surveymonkey:OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:portNumber;InitiateOAuth=GETANDREFRESH
- User Name:認証に使用されるユーザー名
- Password:認証に使用されるパスワード
- SQL Statement:[SQL Statement]ボックスにSQL クエリを入力するか、テーブルをダブルクリックします。この記事では、チャートの作成に以下のクエリを用います。
SELECT RespondentId, ChoiceId FROM MySurvey_Responses
-
[Fetch Metadata]をクリックして接続を確認します。
-
[Database Reader]を[Data to Report]ノードに接続し、データセットを様々なデータ可視化コントロールに提供します。[Execute]をクリックし、ワークフローの上部にある[Edit Report]をクリックしてレポートデザイナパースペクティブを開きます。
-
ライブデータに基づいてレポートを作成できます。チャートを作成するには、チャートコントロールをパレットからレポートデザイナにドラッグします。表示されるウィザードでは、KNIME で使用可能なフィルタリングおよび集約コントロールを使用できます。
トラブルシューティング
次のリストは一般的なエラーを解決する方法を示しています。
- [Row1]という重複するIdが見つかりました。:このエラーを解決するには、KNIME インストールディレクトリにあるknime.ini ファイルに
-Dknime.database.fetchsize=0
を追加します。