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

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

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

TaxJar JDBC Driver

TaxJar データを組み込んだパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。



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

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

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

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

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

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

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

      TaxJar API への認証には、まず初めにTaxJar UI からAPI キーを取得する必要があります。

      NOTE:API の利用は、Professional およびPremium TaxJar プランでのみ可能です。

      すでにProfessional またはPremium プランをお持ちの方は、TaxJar UI にログインして、[アカウント]->[TaxJar API]に移動するとAPI キーを確認することができます。 API キーを取得したら、APIKey 接続プロパティに設定できます。

      その他の注意事項

      • デフォルトでは、エンティティが日付範囲フィルタをサポートしている場合、CData コネクタは過去3か月のデータを取得します。StartDate を設定して、取得するデータの最小作成日を指定することができます。
      • API キーがサンドボックスAPI アカウント用に作成されている場合は、UseSandbox をtrue に設定してください。ただし、すべてのエンドポイントが期待どおりに機能するとは限りません。詳しくは、TaxJar 開発者用ドキュメントを参照してください。

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

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

      java -jar cdata.jdbc.taxjar.jar

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

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

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

      jdbc:taxjar:APIKey=3bb04218ef8t80efdf1739abf7257144;
    • User Name:認証に使用されるユーザー名
    • Password:認証に使用されるパスワード
    • SQL Statement:[SQL Statement]ボックスにSQL クエリを入力するか、テーブルをダブルクリックします。この記事では、チャートの作成に以下のクエリを用います。 SELECT TransactionID, UserID FROM Orders WHERE TransactionID = '123'
  6. [Fetch Metadata]をクリックして接続を確認します。

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

トラブルシューティング

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

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