CloverDX（旧CloverETL）で SurveyMonkey のデータ に接続

CData JDBC Driver for SurveyMonkey を使用すると、CloverDX（旧CloverETL）のデータ変換コンポーネントで SurveyMonkey をソースとして扱えます。この記事では、JDBC Driver for SurveyMonkey を使用して、フラットファイルへのシンプルな転送を設定する方法を説明します。

JDBC データソースとして SurveyMonkey に接続

1. SurveyMonkey のデータ への接続を作成します。新規のCloverDX グラフで、Outline ペインの「Connections」ノードを右クリックし、「Connections」->「Create Connection」をクリックします。Database Connection ウィザードが表示されます。
2. プラスアイコンをクリックし、JAR からドライバーをロードします。インストールディレクトリのlib サブフォルダを参照し、cdata.jdbc.surveymonkey.jar ファイルを選択します。
3. JDBC URL を入力します。

   SurveyMonkey はOAuth 2 認証標準を利用しています。SurveyMonkey がアンケートの回答を読むためにこれを必要とすることを考えると、アンケートを読むアカウントには有料プランのサブスクリプションが必要です。

   SurveyMonkey への接続に使用できる認証方法は2つあります。

   • プライベートoauth アプリケーションを登録するときに、パーソナルアクセストークンを使用します。
   • パブリックoauth アプリケーションを登録するときに、OAuth を使用します。

   パーソナルアクセストークンの使用

   個人用トークンを使用して、自分のデータをテストし、アクセスします。個人用トークンを取得するには、ヘルプの「Creating a Custom OAuth App」の手順に従って、次の接続プロパティを設定します。

   • OAuthAccessToken：アプリケーション設定で生成されたAccessToken に設定。
   • InitiateOAuth：OFF に設定。

   OAuth の使用

   CData 製品はすでにSurveyMonkey にOAuth アプリケーションとして登録されています。そのため、デフォルトでは、自動的に埋め込みクレデンシャルを使用して接続します。

   独自のカスタムOAuth アプリを使用したい場合は、ヘルプのCustom Credentials を参照してください。

   組み込みの接続文字列デザイナー

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

   java -jar cdata.jdbc.surveymonkey.jar
   

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

   

   一般的なJDBC URL は次のようになります：

   jdbc:surveymonkey:OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:portNumber;

DBInputTable コンポーネントで SurveyMonkey のデータ をクエリ

1. Palette の「Readers」から「DBInputTable」をジョブフローにドラッグし、ダブルクリックして設定エディターを開きます。
2. 「DB connection」プロパティで、ドロップダウンメニューから SurveyMonkey JDBC データソースを選択します。
3. SQL クエリを入力します。例：

   SELECT RespondentId, ChoiceId FROM MySurvey_Responses

クエリの出力をUniversalDataWriter に書き込む

1. 「Writers」から「UniversalDataWriter」をジョブフローにドラッグします。
2. UniversalDataWriter をダブルクリックして設定エディターを開き、ファイルURL を追加します。
3. DBInputTable を右クリックし、「Extract Metadata」をクリックします。
4. DBInputTable の出力ポートをUniversalDataWriter に接続します。
5. UniversalDataWriter の「Select Metadata」メニューで、MySurvey_Responses テーブルを選択します。（このメニューはUniversalDataWriter の入力ポートを右クリックしても開けます。）
6. 「Run」をクリックして、ファイルに書き込みます。