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