DBeaver からZoho Books データに接続する方法

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

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

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

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

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

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

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

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

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

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

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

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

   java -jar cdata.jdbc.zohobooks.jar

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

   一般的な接続文字列：

   jdbc:zohobooks:OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;CallbackURL=https://localhost:33333;OrganizationId=MyOrganizationId;InitiateOAuth=GETANDREFRESH

Zoho Books データにクエリを実行

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