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

Jerod Johnson
Senior Technology Evangelist

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

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

TaxJar への接続を設定

TaxJar API への認証には、まず初めにTaxJar UI からAPI キーを取得する必要があります。

NOTE：API の利用は、Professional およびPremium TaxJar プランでのみ可能です。

すでにProfessional またはPremium プランをお持ちの方は、TaxJar UI にログインして、「アカウント」->「TaxJar API」に移動するとAPI キーを確認することができます。 API キーを取得したら、APIKey 接続プロパティに設定できます。

その他の注意事項

デフォルトでは、エンティティが日付範囲フィルタをサポートしている場合、CData コネクタは過去3か月のデータを取得します。StartDate を設定して、取得するデータの最小作成日を指定することができます。
API キーがサンドボックスAPI アカウント用に作成されている場合は、UseSandbox をtrue に設定してください。ただし、すべてのエンドポイントが期待どおりに機能するとは限りません。詳しくは、TaxJar 開発者用ドキュメントを参照してください。

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

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

java -jar cdata.jdbc.taxjar.jar

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

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

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

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

jdbc:taxjar:APIKey=3bb04218ef8t80efdf1739abf7257144;

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

Pentaho DI から TaxJar に接続

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

「General」をクリックします。
Connection name を設定します（例：TaxJar Connection）。
Connection type を「Generic database」に設定します。
Access を「Native (JDBC)」に設定します。
Custom connection URL に TaxJar の接続文字列を設定します（例：
```
jdbc:taxjar:APIKey=3bb04218ef8t80efdf1739abf7257144;
```
）。
Custom driver class name を「cdata.jdbc.taxjar.TaxJarDriver」に設定します。
接続をテストし、「OK」をクリックして保存します。