Pentaho Data Integration でCleverPush のデータを連携
CData API Driver for JDBC を使用すると、データパイプラインからリアルタイムデータにアクセスできます。Pentaho Data Integration は、ETL（Extraction, Transformation, and Loading）エンジンであり、データをクレンジングし、アクセス可能な統一フォーマットでデータを格納します。この記事では、CleverPush のデータ に JDBC データソースとして接続し、Pentaho Data Integration で CleverPush のデータ をベースにしたジョブやトランスフォーメーションを構築する方法を説明します。
CleverPush への接続を設定
まず、Profile 接続プロパティをディスク上の Cleverpush プロファイルの場所に設定します（例：C:\profiles\Cleverpush.apip）。次に、ProfileSettings 接続プロパティを Cleverpush の接続文字列に設定します（以下を参照）。
Cleverpush API プロファイル設定
CleverPush では、プライベート API キーでリクエストを認証します。API キーは、すべての API 呼び出しで Authorization リクエストヘッダーの値として渡されます。
プライベート API キーは、CleverPush ダッシュボードの「Settings」>「API」で確認できます。サーバーサイドからアクセスする場合は、パブリックキーではなくプライベートキーを使用してください。
以下の接続プロパティを設定すると、接続できるようになります。
- AuthScheme：APIKey に設定します。
- APIKey：CleverPush のプライベート API キーに設定します。
オプションの接続プロパティ
- ChannelId：デフォルトで使用する CleverPush のチャネル識別子に設定します。ほとんどのテーブルではチャネルによるフィルタが必要です。このプロパティを設定しておくと、WHERE 句で毎回 ChannelId を指定しなくてもクエリを実行できます。
組み込みの接続文字列デザイナー
JDBC URL の構築を支援するには、CleverPush JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.api.jar
接続プロパティを設定し、接続文字列をクリップボードにコピーします。
JDBC URL を設定する際には、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時にパフォーマンスを向上させることができます。
一般的な JDBC URL は次のようになります：
jdbc:api:Profile=C:\profiles\Cleverpush.apip;ProfileSettings='APIKey=my_api_key';接続文字列を保存して、Pentaho Data Integration で使用します。
Pentaho DI から CleverPush に接続
Pentaho Data Integration を開き、「Database Connection」を選択して CData API Driver for JDBC への接続を設定します。
- 「General」をクリックします。
- Connection name を設定します（例：CleverPush Connection）。
- Connection type を「Generic database」に設定します。
- Access を「Native (JDBC)」に設定します。
- Custom connection URL に CleverPush の接続文字列を設定します（例：
）。jdbc:api:Profile=C:\profiles\Cleverpush.apip;ProfileSettings='APIKey=my_api_key'; - Custom driver class name を「cdata.jdbc.api.APIDriver」に設定します。
- 接続をテストし、「OK」をクリックして保存します。
CleverPush のデータパイプラインを作成
CData JDBC Driver を使用して CleverPush への接続が設定されたら、新しいトランスフォーメーションまたはジョブを作成する準備が整いました。
- 「File」>>「New」>>「Transformation/job」をクリックします。
- 「Table input」オブジェクトをワークフローパネルにドラッグし、CleverPush 接続を選択します。
- 「Get SQL select statement」をクリックし、Database Explorer を使用して利用可能なテーブルとビューを表示します。
- テーブルを選択し、必要に応じてデータをプレビューして確認します。
ここから、適切な同期先を選択し、レプリケーション中にデータを変更、フィルタリング、その他の処理を行うトランスフォーメーションを追加することで、トランスフォーメーションまたはジョブを続行できます。
無料トライアルと詳細情報
CData API Driver for JDBC の 30日間無料トライアルをダウンロードして、Pentaho Data Integration で CleverPush のデータ のリアルタイムデータを今すぐ活用しましょう。