DBeaver からFreshBooks データに連携

CData JDBC Driver for FreshBooks は、IDE のウィザードからBI ツールまで、サードパーティーツールからFreshBooks データの読み書きを可能にするJDBC 標準を実装しています。本記事では、DBeaver のウィザードを使ってFreshBooks データに接続し、DBeaver のGUI でデータを参照する方法を紹介します。

FreshBooks データのJDBC データソースを作成する

以下の手順で、DBeaver にドライバーのJAR ファイルをロードします。

1. DBeaver アプリケーションを開き、「データベース」メニューの「ドライバーマネジャー」オプションを選択します。「新規」をクリックして「新しいドライバを作成する」フォームを開きます。
2. 「ドライバ名」ボックスに、ドライバーの分かりやすい名称を入力します。
3. .jar ファイルを追加するために、「ファイルを追加」をクリックします。
4. 表示されるダイアログで、インストールディレクトリのlib フォルダにあるcdata.jdbc.freshbooks.jar ファイルを選択します。
5. 「クラスを見つける」ボタンをクリックし、検索結果から「FreshBooks ドライバクラス」を選択します。これにより、フォーム上部にある「クラス名」フィールドが自動的に入力されます。ドライバーのクラス名はcdata.jdbc.freshbooks.FreshBooksDriver です。
6. 「URL テンプレート」フィールドにjdbc:freshbooks: を追加します。

FreshBooks データへの接続を作成する

以下の手順で、認証情報およびその他の必要な接続プロパティを追加します。

1. 「データベース」メニューから、「新しい接続」をクリックします。
2. 表示される「新しい接続を作成する」ウィザードで、ドライバーを選択します。
3. ウィザードで「次へ」をクリックし、表示されたページで「ドライバのプロパティ」タブをクリックします。

4. FreshBooks に接続するために必要な認証情報およびその他のプロパティの値を入力します。

   FreshBooks はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得しなければなりません。

   詳細はヘルプドキュメントの「はじめに」を参照してください。

   組み込みの接続文字列デザイナー

   JDBC URL の作成の補助として、FreshBooks JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

   java -jar cdata.jdbc.freshbooks.jar

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

   一般的な接続文字列：

   jdbc:freshbooks:CompanyName=CData;Token=token;

FreshBooks データにクエリを実行

これで、公開済みテーブルのデータにクエリを実行できるようになりました。「テーブル」を右クリックし、「テーブルの編集」をクリックします。「データ」タブでデータを確認できます。