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

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

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

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

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

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

5. ［Database Reader］をダブルクリックし、次のプロパティを設定します。

   • Database Driver:メニューでドライバーの名前(cdata.jdbc.shipstation.ShipStationDriver)を選択します。

   • Database URL:接続プロパティを入力します。jdbc:shipstation: から始まり、その後にセミコロンで区切られた接続プロパティのリストが続くJDBC URL を入力します。

     Use the BASIC Authentication standard to connect.

     1. Login to your ShipStation account
     2. Click on the settings icon in the upper right corner. A column menu will show up on the left
     3. Click Account -> API Settings
     4. On the API Settings page, note the API Key and API Secret.

     Authenticating to ShipStation

     • APIKey: Set this to the API key from the API settings page.
     • APISecret: Set this to the Secret key from the API settings page.

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

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

     java -jar cdata.jdbc.shipstation.jar

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

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

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

     jdbc:shipstation:APIKey='YourAPIKey';APISecret='YourAPISecret'
   • User Name:認証に使用されるユーザー名
   • Password:認証に使用されるパスワード
   • SQL Statement:［SQL Statement］ボックスにSQL クエリを入力するか、テーブルをダブルクリックします。この記事では、チャートの作成に以下のクエリを用います。 SELECT Id, Color FROM Tags WHERE CustomerId = '1368175'

6. ［Fetch Metadata］をクリックして接続を確認します。

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

トラブルシューティング

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

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