DbVisualizer で TaxJar データに連携しクエリを作成

CData JDBC Driver for TaxJar は、JDBC 標準に準拠し、BI ツールからIDE まで幅広いアプリケーションでTaxJar への接続を提供します。この記事では、DbVisualizer からTaxJar に接続する方法、およびtable エディタを使ってTaxJar を 編集、および保存 する方法を説明します。

TaxJar データの新しいJDBC データソースを作成

下記の手順に従って、Driver Manager を使ってDbVisualizer ツールからTaxJar に接続します。

1. DbVisualizer で［Tools］>［Driver Manager］>［Create a New Driver］をクリックします。
2. データソースに名前を入力します。
3. ［URL Format］ボックスに以下を入力します： jdbc:taxjar:
   DbVisualizer Driver Manager
4. ［User Specified］タブで［User Specified］ボタンをクリックし、インストールディレクトリの［lib］サブフォルダ内のcdata.jdbc.taxjar.jar ファイルを選択します。
5. ［Driver Class］メニューでTaxJarDriver クラス、cdata.jdbc.taxjar.TaxJarDriver を選択します。

JDBC データソースへの接続を定義

下記の手順に従って、JDBC URL に接続プロパティを入力します。

1. ［Database］ タブで［Database Connection］ノードを右クリックし、［Create a Database Connection］をクリックします。

2. ［Connection］セクションで以下のオプションを設定します：

   • Database Type：ウィザードオプションを選択した場合は、データベースの種類は自動検出される。ウィザードを使用しないオプションを選択した場合は、［Database Type］メニューから［Generic］または［Auto Detect］オプションを選択。
   • Driver：先ほど作成したドライバーを選択。

   • Database URL：フルJDBC URL を入力。JDBC URL シンタックスは以下のとおりです。 jdbc:taxjar: 次に、セミコロン区切りでname-value ペアの接続プロパティを入力します。

     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:taxjar:APIKey=3bb04218ef8t80efdf1739abf7257144;
   • Database UserId：TaxJar を認証するユーザーネーム。
   • Database Password：TaxJar を認証するパスワード。

3. ［Connection］タブで［Connect］をクリックします。

QuickBooks JDBC Driver が表示するテーブルをブラウズするには、テーブルを右クリックし［Open In New Tab］をクリックします。

SQL クエリの実行には、SQL Commander ツールを使います：［SQL Commander］>［New SQL Commander］をクリックします。利用可能なメニューから［Database Connection］、［Database］、［Schema］を選択します。

サポートされるSQL についての詳細は、ヘルプドキュメントの「サポートされるSQL」をご覧ください。テーブルに関する情報は「データモデル」をご覧ください。