Informatica Cloud で Harvest のデータを連携

Jerod Johnson
Director, Technology Evangelism

CData JDBC ドライバーと Informatica Cloud Secure Agent を使用して、Informatica Cloud から Harvest のデータにリアルタイム接続。

Informatica Cloud は、クラウド上で抽出、変換、ロード（ETL）タスクを実行できるツールです。Cloud Secure Agent と CData API Driver for JDBC を組み合わせることで、Informatica Cloud から直接 Harvest のデータにリアルタイムでアクセスできます。本記事では、Cloud Secure Agent のダウンロードと登録、JDBC ドライバーを介した Harvest への接続、そして Informatica Cloud のプロセスで使用可能なマッピングの作成方法をご紹介します。

Informatica Cloud Secure Agent

JDBC ドライバー経由で Harvest のデータに接続するには、Cloud Secure Agent をインストールします。

Informatica Cloud の Administrator ページに移動します
Runtime Environments タブを選択します
「Download Secure Agent」をクリックします
Install Token をメモしておきます
クライアントマシンでインストーラを実行し、ユーザー名と Install Token を使って Cloud Secure Agent を登録します

NOTE: Cloud Secure Agent のすべてのサービスが起動するまでに、しばらく時間がかかる場合があります。

Harvest JDBC Driver への接続

Cloud Secure Agent のインストールと起動が完了したら、JDBC ドライバーを介して Harvest に接続する準備が整いました。

Secure Agent マシンへの JDBC ドライバーの追加

Secure Agent マシンの以下のディレクトリに移動します：
```
%Secure Agent installation directory%/ext/connectors/thirdparty/
```
設定するマッピングの種類に応じて、フォルダを作成しドライバーの JAR ファイル（cdata.jdbc.api.jar）を追加します。
マッピングの場合は、以下のフォルダを作成してドライバーの JAR ファイルを追加します：
```
informatica.jdbc_v2/common
```
アドバンスドモードのマッピングの場合は、以下のフォルダも作成してドライバーの JAR ファイルを追加します：
```
informatica.jdbc_v2/spark
```
Secure Agent を再起動します。

Informatica Cloud での Harvest への接続

ドライバーの JAR ファイルをインストールしたら、Informatica Cloud で Harvest への接続を設定します。Connections タブをクリックし、New Connection をクリックして、以下のプロパティを入力します：

Connection Name: 接続に名前を付けます（例：CData Harvest Connection）
Type:「JDBC_V2」を選択します
Runtime Environment: Secure Agent をインストールしたランタイム環境を選択します
JDBC Driver Class Name: JDBC ドライバークラス名を入力します：cdata.jdbc.api.APIDriver
JDBC Connection URL: Harvest の JDBC URL を設定します。URL は以下のようになります：
```
jdbc:api:Profile=C:\profiles\Harvest.apip;ProfileSettings='APIKey=my_personal_key;AccountId=_your_account_id';
```
まず、Profile 接続プロパティをディスク上のHarvest プロファイルの場所に設定します（例：C:\profiles\Harvest.apip）。次に、ProfileSettings 接続プロパティをHarvest の接続文字列に設定します（以下を参照）。

Harvest API プロファイル設定

Harvest に認証するには、トークン認証またはOAuth 標準のいずれかを使用できます。自分のデータに接続するにはBasic 認証を使用します。他のユーザーが自分のデータに接続できるようにするにはOAuth を使用します。

トークン認証の使用

トークン認証を使用するには、ProfileSettings 接続プロパティでAPIKey にHarvest パーソナルアクセストークンを設定します。APIKey に加えて、ProfileSettings でAccountId を設定して接続します。

OAuth 認証の使用

まず、Harvest でOAuth2 アプリケーションを登録します。アプリケーションはHarvest ID の「Developers」セクションから作成できます。

以下の接続プロパティを設定すると、接続できるようになります。
- ProfileSettings：ProfileSettings でAccountId を設定します。
- AuthScheme：OAuth に設定します。
- OAuthClientId：アプリ設定で指定したclient ID に設定します。
- OAuthClientSecret：アプリ設定で指定したclient secret に設定します。
- CallbackURL：アプリ設定で指定したRedirect URI に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、ドライバーがOAuthAccessToken を取得および更新する方法を管理できます。
組み込みの接続文字列デザイナー

JDBC URL の作成には、Harvest JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。.jar ファイルをダブルクリックするか、コマンドラインから実行してください。
```
    java -jar cdata.jdbc.api.jar
    
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Username: プレースホルダー値を設定します（Harvest はユーザー名を必要としないため）
Password: プレースホルダー値を設定します（Harvest はパスワードを必要としないため）

Harvest のデータのマッピングを作成

Harvest への接続を設定したら、Informatica の任意のプロセスで Harvest のデータにアクセスできます。以下の手順では、Harvest から別のデータターゲットへのマッピングを作成する方法を説明します。

Data Integration ページに移動します
New.. をクリックし、Mappings タブから Mapping を選択します
Source Object をクリックし、Source タブで Connection を選択し、Source Type を設定します
「Select」をクリックして、マッピングするテーブルを選択します
Fields タブで、マッピングする Harvest テーブルのフィールドを選択します
Target オブジェクトをクリックし、Target ソース、テーブル、フィールドを設定します。Field Mapping タブで、ソースフィールドをターゲットフィールドにマッピングします。

マッピングの設定が完了すると、Informatica Cloud でサポートされている任意の接続先と Harvest のデータのリアルタイム連携を開始できます。CData API Driver for JDBC の30日間無償トライアルをダウンロードして、Informatica Cloud で Harvest のデータの活用を今すぐ始めましょう。

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

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

Harvest に接続お問い合わせ

Informatica Cloud で Harvest のデータを連携

Informatica Cloud Secure Agent