Pentaho Data Integration でスマレジのデータを連携

Jerod Johnson
Senior Technology Evangelist

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

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

スマレジへの接続を設定

スマレジドライバーには、ContractId およびAccessToken パラメータが必要です。

スマレジにログイン後、「設定」->「システム連携」->「スマレジAPI 設定」に移動します。
「API受信設定」セクションにある「受信機能を利用する」を「利用する」に変更し、「アクセストークンの生成」をクリックし、AccessToken を取得します。
次に必要なAPI アクセスを有効にするため、「機能設定」セクションで必要な機能を「利用する」に変更します。

ContractId： アカウントの契約ID。これは受信設定セクションでも確認できます。
AccessToken： 受信設定セクションのアクセストークン。

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

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

java -jar cdata.jdbc.smaregi.jar

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

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

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

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

jdbc:smaregi:ContractId=mycontractid;AccessToken=myaccesstoken;

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

Pentaho DI からスマレジに接続

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

「General」をクリックします。
Connection name を設定します（例：スマレジ Connection）。
Connection type を「Generic database」に設定します。
Access を「Native (JDBC)」に設定します。
Custom connection URL にスマレジの接続文字列を設定します（例：
```
jdbc:smaregi:ContractId=mycontractid;AccessToken=myaccesstoken;
```
）。
Custom driver class name を「cdata.jdbc.smaregi.SmaregiDriver」に設定します。
接続をテストし、「OK」をクリックして保存します。