Pentaho Data Integration でClio のデータを連携

Jerod Johnson
Director, Technology Evangelism

Pentaho Data Integration で Clio のデータをベースにした ETL パイプラインを構築します。

CData API Driver for JDBC を使用すると、データパイプラインからリアルタイムデータにアクセスできます。Pentaho Data Integration は、ETL（Extraction, Transformation, and Loading）エンジンであり、データをクレンジングし、アクセス可能な統一フォーマットでデータを格納します。この記事では、Clio のデータに JDBC データソースとして接続し、Pentaho Data Integration で Clio のデータをベースにしたジョブやトランスフォーメーションを構築する方法を説明します。

Clio への接続を設定

まず、Profile 接続プロパティをディスク上のClio プロファイルの場所に設定します（例：C:\profiles\Clio.apip）。次に、ProfileSettings 接続プロパティをClio の接続文字列に設定します（以下を参照）。

Clio API プロファイル設定

Clio はOAuth ベースの認証を使用します。

まず、Clio でOAuth アプリケーションを登録します。Developer アカウントにログインし、Add ボタンをクリックして登録できます。ここでアプリケーションの詳細とスコープを入力します。これらの詳細は、Clio ユーザーがアプリケーションの認可を求められたときに表示されます。OAuth アプリケーションにはclient id（キー）とclient secret（シークレット）が割り当てられます。また、ProfileSettings 接続プロパティでRegion を設定します。

以下の接続プロパティを設定すると、接続できるようになります。

AuthScheme：OAuth に設定します。
InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、OAuthAccessToken を取得するプロセスを管理できます。
OAuthClientId：アプリ設定で指定されたclient_id に設定します。
OAuthClientSecret：アプリ設定で指定されたclient_secret に設定します。
CallbackURL：アプリ設定で指定されたRedirect URI に設定します。
Region：ProfileSettings でClio の地理的リージョンに設定します。デフォルトはapp.clio.com です。

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

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

java -jar cdata.jdbc.api.jar

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

組み込みの接続文字列デザイナーを使用して JDBC URL を生成（Salesforce の例）

JDBC URL を設定する際には、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時にパフォーマンスを向上させることができます。

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

jdbc:api:Profile=C:\profiles\Clio.apip;ProfileSettings='Region=your_region';Authscheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;

接続文字列を保存して、Pentaho Data Integration で使用します。

Pentaho DI から Clio に接続

Pentaho Data Integration を開き、「Database Connection」を選択して CData API Driver for JDBC への接続を設定します。

「General」をクリックします。
Connection name を設定します（例：Clio Connection）。
Connection type を「Generic database」に設定します。
Access を「Native (JDBC)」に設定します。

Custom connection URL に Clio の接続文字列を設定します（例：

jdbc:api:Profile=C:\profiles\Clio.apip;ProfileSettings='Region=your_region';Authscheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;

）。