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

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

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

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

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

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

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

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

SmartHR に接続するには、SmartHR API トークンとTenantId が必要です。API トークンはSmartHR のアプリケーション統合ページで生成できます。トークンを取得したら、ProfileSettings API Key 接続プロパティに指定してください。TenantId は自身のSmartHR ページのURL「https://1234567890.smarthr.jp/」で確認できます（ここでは「1234567890」）。もしSandbox 環境を使用する場合は、接続プロパティにUseSandbox=true を設定してください。

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

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

JDBC 接続文字列を作るには、SmartHR 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=C:\profiles\SmartHR.apip;UseSandbox=false;ProfileSettings='APIKey=your_api_token;TenantId=1234567890;''InitiateOAuth=REFRESH
5. 方言：SQL92
6. サインインをクリックします。
7. 接続エラーの場合には、Java がダウンロードされていない場合、Java が64bit マシン用ではなく32bit 用である、などの場合がありますので確認をお願いします。

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

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

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