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

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

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

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

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

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

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

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

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

     Zoho Books はOAuth 認証標準を使用します。OAuth を使用して認証するには、アプリを作成して OAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを設定してください。 認証方法については、ヘルプドキュメントの「OAuth」セクションを参照してください。

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

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

     java -jar cdata.jdbc.zohobooks.jar

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

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

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

     jdbc:zohobooks:OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;CallbackURL=https://localhost:33333;OrganizationId=MyOrganizationId;InitiateOAuth=GETANDREFRESH
   • User Name:認証に使用されるユーザー名
   • Password:認証に使用されるパスワード
   • SQL Statement:［SQL Statement］ボックスにSQL クエリを入力するか、テーブルをダブルクリックします。この記事では、チャートの作成に以下のクエリを用います。 SELECT InvoiceId, InvoiceNumber FROM INVOICES WHERE CustomerName = 'NewTech Industries'

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

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

トラブルシューティング

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

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