Tableau からfreee にJDBC Driver で連携してビジュアライズ

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData Driver for API を使って、BI・ビジュアライズツールのTableau からfreee のデータをノーコードで連携して利用できます。この記事では、CData JDBC Driver for API を使います。JDBC は、Windows 版のTabelau でもMac 版のTableau でも同じように利用できます。

Tabelau からfreee のデータへの接続を確立

Tableau での操作の前に.jar ファイルを以下のパスに格納します：

• Windows: C:\Program Files\Tableau\Drivers
• MacOS: ~/Library/Tableau/Drivers

.jar ファイルを配置したら、freee への接続を設定します。

1. Tableau を開きます。
2. ［データ］->［新しいデータソース］を開きます。
3. ［その他のデータベース（JDBC）］をクリックします。
4. URL にJDBC 接続文字列を入力します。

まずはOAuth アプリを作成します。https://app.secure.freee.co.jp/developers/applications にアクセスして、「新しいアプリケーションの作成」ボタンをクリックします。アプリケーション名を指定し、リダイレクトURL を設定して登録をクリックします。そうすると、クライアントシークレットとクライアントID が発行されます。

次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。

その後、Companies ビューからCompanyId を取得します。以下の接続プロパティを設定したら、接続する準備ができます。

• AuthScheme：OAuth に設定します。
• OAuthClientID：アプリ設定で指定されたOAuth クライアントID に設定します。
• OAuthClientSecret：アプリ設定で指定されたOAuth クライアントシークレットに設定します。
• CallbackURL：アプリ設定で指定したリダイレクトURI に設定します。
• InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。

JDBC Driver の接続文字列デザイナーを使う

JDBC 接続文字列を作るには、freee JDBC Driver のビルトイン接続文字列デザイナーを使う方法があります。ドライバーの.jar ファイルをダブルクリックするか、コマンドラインから.jar ファイルを実行します。

Windows:

java -jar 'C:\Program Files\CData\CData JDBC Driver for API 2019\lib\cdata.jdbc.api.jar'

MacOS:

java -jar cdata.jdbc.api.jar

接続プロパティに値を入力して、生成される接続文字列をクリップボードにコピーします。

JDBC URLを設定する際には、Max Rows プロパティを設定することをお勧めします。これにより取得される行数が制限され、パフォーマンスを向上させます。

デザイナーで生成されるJDBC URL のサンプル：

jdbc:api:Profile=freee.apip;ProfileSettings='CompanyId=1234567;';Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;InitiateOAuth=REFRESH
5. 方言：SQL92
6. サインインをクリックします。
7. 接続エラーの場合には、Java がダウンロードされていない場合、Java が64bit マシン用ではなく32bit 用である、などの場合がありますので確認をお願いします。

スキーマ検出とデータのクエリ

1. ［データベース］のドロップダウンで、CData を選択します。
2. ［スキーマ］で、［CData］を選択します。
3. テーブルをJOIN エリアにドラッグします。複数のテーブルを選択することも可能です。
4. ［今すぐ更新］か［自動更新］を選択します。［今すぐ更新］では、はじめの1000行のデータをプレビューで取得します（もしくは表示行を指定するボックスに取得する行数を指定可能 ）。［自動更新］では、自動的にデータを取得してプレビューに表示します。
5. ［接続］メニューでは、［ライブ］もしくは［抽出］を選択します。常にリアルタイムデータを扱いたい場合には、［ライブ］を選択します。
6. ワークシートのタブを開きます。CData Driver は、カラム情報やデータ型情報を自動的に検出するので、取得したfreee のデータのカラムはディメンションとメジャーに分けてリスト表示されます。
7. デイメンションやメジャーを列・行のフィールドにドロップして、ビジュアライズを作成します。

CData JDBC Driver for API をTabelau で使うことで、ノーコードでfreee のデータをビジュアライズできました。ぜひ、30日の無償評価版 をお試しください。