Pentaho Data Integration でAvalara AvaTax のデータを連携

Jerod Johnson
Director, Technology Evangelism

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

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

Avalara AvaTax への接続を設定

Basic 認証を実行する通常の方法は、次のログイン資格情報を提供することです。

User：ユーザー名に設定します。
Password：パスワードに設定します。

サンドボックス環境を使用している場合には、オプションで次を設定してください。

UseSandbox：サンドボックスアカウントで認証する場合にはこれをtrue に設定します。

アカウント番号とライセンスキーを使用して認証する

または、アカウント番号とライセンスキーを使用して認証することもできます。次を使用してデータに接続します。

AccountId：これをアカウントId に設定します。アカウントId は管理コンソールの右上端にリストされています。
LicenseKey：これをAvalara Avatax のライセンスキーに設定します。ライセンスキーの生成は、Avalara Avatax アカウント管理者としてログインして Settings -> Reset License Key に移動して実行できます。

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

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

java -jar cdata.jdbc.avalaraavatax.jar

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

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

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

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

jdbc:avalaraavatax:User=MyUser;Password=MyPassword;

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

Pentaho DI から Avalara AvaTax に接続

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

「General」をクリックします。
Connection name を設定します（例：Avalara AvaTax Connection）。
Connection type を「Generic database」に設定します。
Access を「Native (JDBC)」に設定します。
Custom connection URL に Avalara AvaTax の接続文字列を設定します（例：
```
jdbc:avalaraavatax:User=MyUser;Password=MyPassword;
```
）。
Custom driver class name を「cdata.jdbc.avalaraavatax.AvalaraAvataxDriver」に設定します。
接続をテストし、「OK」をクリックして保存します。