HULFT Integrate でスマレジのデータに接続

Jerod Johnson
Senior Technology Evangelist

HULFT Integrate でスマレジに JDBC データソースとして接続

HULFT Integrate は、ドラッグ＆ドロップのユーザーインターフェースでコーポレーションフロー、データ変換、処理を簡単に作成できる最新のデータ連携プラットフォームです。CData JDBC Driver for Smaregi と組み合わせることで、HULFT Integrate からリアルタイムのスマレジのデータを扱うことができます。この記事では、スマレジへの接続方法と、データを CSV ファイルに出力する手順をご紹介します。

CData JDBC ドライバーは、最適化されたデータ処理機能を備えており、リアルタイムのスマレジのデータとの連携において比類のないパフォーマンスを発揮します。スマレジに対して複雑な SQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を直接スマレジにプッシュし、サポートされていない操作（主に SQL 関数や JOIN 操作）は内蔵の SQL エンジンでクライアント側で処理します。また、動的なメタデータクエリ機能により、ネイティブなデータ型を使用してスマレジのデータを操作・分析できます。

スマレジへのアクセスを有効化

HULFT Integrate プロジェクトからスマレジのデータへのアクセスを有効にするには、以下の手順で設定します：

CData JDBC Driver の JAR ファイル（およびライセンスファイルがある場合はそれも）、cdata.jdbc.smaregi.jar（および cdata.jdbc.smaregi.lic）を、Integrate Server の jdbc_adapter サブフォルダにコピーします
HULFT Integrate Server を再起動し、HULFT Integrate Studio を起動します

スマレジのデータにアクセスするプロジェクトの作成

JAR ファイルをコピーしたら、スマレジのデータにアクセスするプロジェクトを作成できます。まず、Integrate Studio を開いて新しいプロジェクトを作成しましょう。

プロジェクト名を入力します
「スクリプトを作成」チェックボックスがオンになっていることを確認します
「次へ」をクリックします
スクリプト名を入力します（例：SmaregitoCSV）

プロジェクトを作成したら、スマレジのデータを CSV ファイルにコピーするためのコンポーネントをスクリプトに追加します。

Execute Select SQL コンポーネントの設定

ツールパレット（Database -> JDBC）から「Execute Select SQL」コンポーネントをスクリプトワークスペースにドラッグします。

「必須設定」タブの接続先で、「追加」をクリックしてスマレジ用の新しい接続を作成します。以下のプロパティを設定します：
- 名前：スマレジ Connection Settings
- ドライバークラス名：cdata.jdbc.smaregi.SmaregiDriver
- URL：jdbc:smaregi:ContractId=mycontractid;AccessToken=myaccesstoken;
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の構築には、スマレジ JDBC Driver に組み込まれている接続文字列デザイナーをご利用ください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
		java -jar cdata.jdbc.smaregi.jar
		
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  スマレジドライバーには、ContractId およびAccessToken パラメータが必要です。
  - スマレジにログイン後、「設定」->「システム連携」->「スマレジAPI 設定」に移動します。
  - 「API受信設定」セクションにある「受信機能を利用する」を「利用する」に変更し、「アクセストークンの生成」をクリックし、AccessToken を取得します。
  - 次に必要なAPI アクセスを有効にするため、「機能設定」セクションで必要な機能を「利用する」に変更します。
  ContractId： アカウントの契約ID。これは受信設定セクションでも確認できます。
  AccessToken： 受信設定セクションのアクセストークン。
SQL ステートメントを記述します。例：
```
SELECT ProductName, Description FROM Products
```
「抽出テスト」をクリックして、接続とクエリが正しく設定されていることを確認します
「SQL を実行して出力スキーマを設定」をクリックします
「完了」をクリックします