KNIME でSmaregi のJDBC ドライバーを有効にする

詳細情報をご希望ですか?

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

Smaregi JDBC Driver

商品、在庫、発送状況などのスマレジアカウントデータを組み込んだ強力なJava アプリケーションを迅速に作成して配布できます。



KNIME の標準データアクセスコンポーネントを使用してSmaregi でチャートとレポートを作成します。

CData JDBC Driver for Smaregi の強みの一つは、クロスプラットフォームのサポートであり、主要なBI ツールとの統合を可能にします。以下のステップに従って、KNIME のSmaregi にアクセスし、レポートデザイナを使用してSmaregi からチャートを作成します。

CData JDBC Driver for Smaregi を使用することで、JDBC データソースとしてSmaregi にアクセスでき、IDE の迅速な開発ツールとの統合が可能になります。この記事では、データソース構成ウィザードを使用してIntelliJ のSmaregi に接続する方法を示します。

※製品について詳しい情報をご希望の方は以下からお進みください。

Smaregi データへの新しいJDBC 接続を定義します。

  1. Report Designer 機能をインストールします。[File]->[Install KNIME Extensions]とクリックし、[Report]でフィルタリングします。
  2. 新しいワークフローで[File]->[Preferences]をクリックし、[KNIME]->[Databases]でノードを展開し cdata.jdbc.smaregi.jar を追加します。
  3. ドライバーJAR は、インストールディレクトリのlib サブフォルダにあります。
  4. [Node Repository]ビューで[Database]->[Read/Write]とノードを展開し、[Database Reader]をワークフローエディターにドラッグします。
  5. [Database Reader]をダブルクリックし、次のプロパティを設定します。

    • Database Driver:メニューでドライバーの名前(cdata.jdbc.smaregi.SmaregiDriver)を選択します。
    • Database URL:接続プロパティを入力します。jdbc:smaregi: から始まり、その後にセミコロンで区切られた接続プロパティのリストが続くJDBC URL を入力します。

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

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

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

      ビルトイン接続文字列デザイナ

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

      java -jar cdata.jdbc.smaregi.jar

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

      JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

      以下は一般的なJDBC URL です。

      jdbc:smaregi:ContractId=mycontractid;AccessToken=myaccesstoken;
    • User Name:認証に使用されるユーザー名
    • Password:認証に使用されるパスワード
    • SQL Statement:[SQL Statement]ボックスにSQL クエリを入力するか、テーブルをダブルクリックします。この記事では、チャートの作成に以下のクエリを用います。 SELECT ProductName, Description FROM Products
  6. [Fetch Metadata]をクリックして接続を確認します。

  7. [Database Reader]を[Data to Report]ノードに接続し、データセットを様々なデータ可視化コントロールに提供します。[Execute]をクリックし、ワークフローの上部にある[Edit Report]をクリックしてレポートデザイナパースペクティブを開きます。
  8. ライブデータに基づいてレポートを作成できます。チャートを作成するには、チャートコントロールをパレットからレポートデザイナにドラッグします。表示されるウィザードでは、KNIME で使用可能なフィルタリングおよび集約コントロールを使用できます。

トラブルシューティング

次のリストは一般的なエラーを解決する方法を示しています。

  • [Row1]という重複するIdが見つかりました。:このエラーを解決するには、KNIME インストールディレクトリにあるknime.ini ファイルに-Dknime.database.fetchsize=0を追加します。