DbVisualizer で Reckon Accounts Hosted データに連携しクエリを作成

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

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

Reckon Accounts Hosted データの新しいJDBC データソースを作成

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

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

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:reckonaccountshosted: 次に、セミコロン区切りでname-value ペアの接続プロパティを入力します。

     本製品 はOAuth 経由でReckon Accounts Hosted にリクエストを作成します。次の接続プロパティを指定します。

     • User： 必須。企業ファイルのユーザー名。
     • Password： 必須。企業ファイルのパスワード。
     • CompanyFile: 必須。企業ファイルへのパス。
     • InitiateOAuth：アクセストークンの処理をドライバーに任せる場合はGETANDREFRESH に設定。
     • CountryVersion：デフォルトは、2021.R2.AU です。

     カスタムOAuth アプリケーションを作成し、以下の追加の接続プロパティを指定することもできます。

     • SubscriptionKey：Azure Platform 上のReckon Portal から取得したAPI キー。
     • OAuthClientId：アプリケーション設定のクライアントID に設定。
     • OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
     • CallbackURL：カスタムOAuth アプリのリダイレクトURI。

     CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。ほかのOAuth 認証方法（Web、ヘッドレスなど）、カスタムOAuth アプリケーションの作成、その理由などについては、ヘルプドキュメントを参照してください。

     一般的な接続文字列は次のとおりです。

     jdbc:reckonaccountshosted:SubscriptionKey=my_subscription_key;CountryVersion=2021.R2.AU;CompanyFile=Q:/CompanyName.QBW;User=my_user;Password=my_password;CallbackURL=http://localhost:33333;OAuthClientId=my_oauth_client_id;OAuthClientSecret=my_oauth_client_secret;

   • Database UserId：Reckon Accounts Hosted を認証するユーザーネーム。
   • Database Password：Reckon Accounts Hosted を認証するパスワード。

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

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

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

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