HULFT Integrate で Typeform のデータに接続

Jerod Johnson
Director, Technology Evangelism

HULFT Integrate で Typeform に JDBC データソースとして接続

HULFT Integrate は、ドラッグ＆ドロップのユーザーインターフェースでコーポレーションフロー、データ変換、処理を簡単に作成できる最新のデータ連携プラットフォームです。CData API Driver for JDBC と組み合わせることで、HULFT Integrate からリアルタイムの Typeform のデータを扱うことができます。この記事では、Typeform への接続方法と、データを CSV ファイルに出力する手順をご紹介します。

CData JDBC ドライバーは、最適化されたデータ処理機能を備えており、リアルタイムの Typeform のデータとの連携において比類のないパフォーマンスを発揮します。Typeform に対して複雑な SQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を直接 Typeform にプッシュし、サポートされていない操作（主に SQL 関数や JOIN 操作）は内蔵の SQL エンジンでクライアント側で処理します。また、動的なメタデータクエリ機能により、ネイティブなデータ型を使用して Typeform のデータを操作・分析できます。

Typeform へのアクセスを有効化

HULFT Integrate プロジェクトから Typeform のデータへのアクセスを有効にするには、以下の手順で設定します：

CData JDBC Driver の JAR ファイル（およびライセンスファイルがある場合はそれも）、cdata.jdbc.api.jar（および cdata.jdbc.api.lic）を、Integrate Server の jdbc_adapter サブフォルダにコピーします
HULFT Integrate Server を再起動し、HULFT Integrate Studio を起動します

Typeform のデータにアクセスするプロジェクトの作成

JAR ファイルをコピーしたら、Typeform のデータにアクセスするプロジェクトを作成できます。まず、Integrate Studio を開いて新しいプロジェクトを作成しましょう。

プロジェクト名を入力します
「スクリプトを作成」チェックボックスがオンになっていることを確認します
「次へ」をクリックします
スクリプト名を入力します（例：APItoCSV）

プロジェクトを作成したら、Typeform のデータを CSV ファイルにコピーするためのコンポーネントをスクリプトに追加します。

Execute Select SQL コンポーネントの設定

ツールパレット（Database -> JDBC）から「Execute Select SQL」コンポーネントをスクリプトワークスペースにドラッグします。

「必須設定」タブの接続先で、「追加」をクリックして Typeform 用の新しい接続を作成します。以下のプロパティを設定します：
- 名前：Typeform Connection Settings
- ドライバークラス名：cdata.jdbc.api.APIDriver
- URL：jdbc:api:Profile=C:\profiles\TypeForm.apip;Authscheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の構築には、Typeform JDBC Driver に組み込まれている接続文字列デザイナーをご利用ください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
		java -jar cdata.jdbc.api.jar
		
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  まず、Profile 接続プロパティにTypeForm プロファイルのディスク上の場所を設定します（例：C:\profiles\TypeForm.apip）。次に、ProfileSettings 接続プロパティにTypeForm の接続文字列を設定します（以下を参照）。
  
  TypeForm API プロファイル設定
  
  TypeForm への認証にはOAuth 標準を使用します。
  
  TypeForm に認証するには、まずTypeForm でOAuth アプリケーションを登録および設定する必要があります：https://admin.typeform.com/account#/section/tokens。アプリにはclient ID とclient secret が割り当てられ、接続文字列で設定できます。OAuth アプリケーションの設定の詳細については、https://developer.typeform.com/get-started/ をご参照ください。
  使用シナリオによって異なるリダイレクトURI が必要です：
  - CData デスクトップアプリケーション：CData デスクトップアプリケーション（Sync、API Server、ArcESB）は/src/oauthCallback.rst でOAuth トークンを受け入れます。ホストとポートはアプリケーションが使用するデフォルトポートと同じです。例えば、http://localhost:8019/ でCData Sync にアクセスする場合、リダイレクトURI はhttp://localhost:8019/src/oauthCallback.rst になります。
  - CData クラウドアプリケーション：CData クラウドアプリケーションはデスクトップ版と同様です。https://1.2.3.4/ でConnect AI にアクセスする場合、リダイレクトはhttps://1.2.3.4/src/oauthCallback.rst を使用します。
  - デスクトップアプリケーション：デスクトップアプリケーションを使用する場合、URI はhttps://localhost:33333 を推奨します。
  - Web アプリケーション：ドライバーを使用してWeb アプリケーションを開発する場合、https://my-website.com/oauth のような独自のURI を使用します。
  以下の接続プロパティを設定すると、接続の準備が整います：
  - AuthScheme：OAuth に設定します。
  - InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
  - OAuthClientId：アプリ設定で指定されているClient Id を設定します。
  - OAuthClientSecret：アプリ設定で指定されているClient Secret を設定します。
  - CallbackURL：アプリ設定で指定したRedirect URI を設定します。
SQL ステートメントを記述します。例：
```
SELECT Id, Title FROM Tags
```
「抽出テスト」をクリックして、接続とクエリが正しく設定されていることを確認します
「SQL を実行して出力スキーマを設定」をクリックします
「完了」をクリックします

Write CSV File コンポーネントの設定

ツールパレット（File -> CSV）から「Write CSV File」コンポーネントをワークスペースにドラッグします。

クエリ結果を書き込むファイルを設定します（例：Tags.csv）
「入力データ」を「Select SQL」コンポーネントに設定します
SQL クエリで選択した各フィールドのカラムを追加します
「書き込み設定」タブで、「最初の行にカラム名を挿入する」チェックボックスをオンにします
「完了」をクリックします

Typeform フィールドを CSV カラムにマッピング

「Select」コンポーネントの各カラムを、「CSV」コンポーネントの対応するカラムにマッピングします。

スクリプトの完成

「Start」コンポーネントを「Select」コンポーネントに、「CSV」コンポーネントを「End」コンポーネントにドラッグして接続します。スクリプトをビルドして実行すると、Typeform のデータが CSV ファイルに出力されます。

CData API Driver for JDBCの30日間の無償トライアルをダウンロードして、HULFT Integrate でリアルタイムの Typeform のデータを活用してみてください。ご不明な点があれば、サポートチームまでお気軽にお問い合わせください。

はじめる準備はできましたか？

API Driver で Typeform のライブデータに接続

Typeform に接続お問い合わせ

HULFT Integrate で Typeform のデータに接続

Typeform へのアクセスを有効化