国産セルフサービスBI ツールData Knowledge でBitbucket のデータを分析・可視化する方法

こんにちは！リードエンジニアの杉本です。

今回は、クロスユーアイエス社の国産セルフサービスBI ツールData Knowledge とCData ODBC ドライバを組み合わせて、Bitbucket データの分析・可視化を行う方法を紹介します。

Data Knowledge とは？

Data Knowledge は株式会社クロスユーアイエスが提供する国産セルフサービスBI ツールです。わかりやすいインターフェースとシンプルな手順でデータの可視化を行うことができ、BI ツールを使用した経験がない人でも簡単に使うことができます。

連携シナリオ

さて、今回の記事ではData Knowledge からBitbucket に接続していきますが、このときに必要となるのがCData ODBC ドライバです。

Data Knowledge にはODBC を経由してExcel やAccess、SQL Server などに接続する機能が標準提供されています。この機能とCData が提供しているODBC Drivers ラインナップを組み合わせることで、各種クラウドサービスのAPI やデータベースにシームレスにアクセスすることができるようになります。

とは言っても、説明だけではイメージできない部分もあると思うので、実際に連携を試してみましょう。今回はData Knowledge とBitbucket のデータを組み合わせて以下のようなクロス集計の表を作ってみたいと思います。

手順

Bitbucket ODBC Driver のインストール・セットアップ

まずは、CData Bitbucket ODBC Driver を対象のマシンにインストール・セットアップします。インストーラーを立ち上げると、以下のような画面になるので、ダイアログに従ってセットアップを完了してください。

セットアップ完了後、接続設定画面が立ち上がりますので、Bitbucket への接続情報を設定してください。

ほとんどのクエリでは、ワークスペースを設定する必要があります。唯一の例外は、Workspacesテーブルです。このテーブルはこのプロパティの設定を必要とせず、クエリを実行すると、Workspaceの設定に使用できるワークスペーススラッグのリストが提供されます。このテーブルにクエリを実行するには、スキーマを'Information'に設定し、SELECT * FROM Workspacesクエリを実行する必要があります。

Schemaを'Information'に設定すると、一般的な情報が表示されます。Bitbucketに接続するには、以下のパラメータを設定してください。

• Schema: ワークスペースのユーザー、リポジトリ、プロジェクトなどの一般的な情報を表示するには、これを'Information'に設定します。それ以外の場合は、クエリを実行するリポジトリまたはプロジェクトのスキーマに設定します。利用可能なスキーマの完全なセットを取得するには、sys_schemasテーブルにクエリを実行してください。
• Workspace: Workspacesテーブルにクエリを実行する場合を除き、必須です。Workspacesテーブルへのクエリにはこのプロパティは必要ありません。そのクエリはWorkspaceの設定に使用できるワークスペーススラッグのリストのみを返すためです。

Bitbucketでの認証

BitbucketはOAuth認証のみをサポートしています。すべてのOAuthフローからこの認証を有効にするには、カスタムOAuthアプリケーションを作成し、AuthSchemeをOAuthに設定する必要があります。

特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを必ず確認してください。

カスタムOAuthアプリケーションの作成

Bitbucketアカウントから、以下のステップを実行します。

1. 設定（歯車アイコン）に移動し、ワークスペース設定を選択します。
2. アプリと機能セクションで、OAuthコンシューマーを選択します。
3. コンシューマーを追加をクリックします。
4. カスタムアプリケーションの名前と説明を入力します。
5. コールバックURLを設定します。
   • デスクトップアプリケーションとヘッドレスマシンの場合、http://localhost:33333または任意のポート番号を使用します。ここで設定するURIがCallbackURLプロパティになります。
   • Webアプリケーションの場合、信頼できるリダイレクトURLにコールバックURLを設定します。このURLは、ユーザーがアプリケーションにアクセスが許可されたことを確認するトークンを持って戻るWebの場所です。
6. クライアント認証情報を使用して認証する予定の場合、これはプライベートコンシューマーですを選択する必要があります。ドライバーでは、AuthSchemeをclientに設定する必要があります。
7. OAuthアプリケーションに与える権限を選択します。これにより、読み取りおよび書き込みできるデータが決まります。
8. 新しいカスタムアプリケーションを保存するには、保存をクリックします。
9. アプリケーションが保存された後、それを選択して設定を表示できます。アプリケーションのKeyとSecretが表示されます。これらを将来の使用のために記録してください。Keyを使用してOAuthClientIdを設定し、Secretを使用してOAuthClientSecretを設定します。

あとは「接続のテスト」ボタンをクリックし、接続が成功したら、「接続ウィザード」の「OK」ボタンをクリックして保存します。

Data Knowledge へのログイン

続いてData Knowledge へログインし作業を進めていきます。

ログイン後以下のような画面に移動するので「メインへ移動する」をクリック。続いて「管理」をクリックして、以下のような管理画面に移動します。ここから接続設定の構成を進めていきます。

資源サーバーの登録

Data Knowledge では最初に資源サーバーという形で接続先のRDB の情報などを管理します。ここに先程作成したCData ODBC ドライバの接続情報を指定します。

「資源サーバー」タブに移動し、「新規」をクリックします。

資源サーバー登録画面が表示されるので、任意の「資源サーバーID」と「資源サーバー名」を入力します。

続いて接続設定で「個別で指定」のラジオボタンを指定し、サーバータイプを「ODBC」「ドライバ：データソースを使用する」と選択します。

認証はODBC DSN で事前に指定しているため、「指定しない」でOKです。

最後にホスト（アドレス）/データソースに先程構成したODBC DSNのシステムDSNである「CData Bitbucket Sys」を入力して登録します。

ホストファイルの登録

続いてData Knowledge で利用するデータモデルをホストファイルという形で登録します。

「ホストファイル」タブに移動し、「新規」をクリックします。

任意のホストファイルID とホストファイル名を指定し、テーブル構成の「更新」をクリックしましょう。

左メニューの資源サーバーに先程追加したBitbucket のデータモデルが表示されますので、ここでData Knowledge で分析したいテーブルをドラッグアンドドロップで取り込みます。

以下のように取り込めればOKです。登録ボタンをクリックして保存します。

また、必要に応じてサンプルも登録しておきましょう。

資源ロールの権限へ対象のホストファイルの追加

ホストファイルは追加しただけだとユーザーが利用できませんので、資源ロールに権限を追加します。「資源ロール」タブに移動し、利用する資源ロールを選択します。

ホストファイルの欄から「＋追加」ボタンをクリックし

先程作成したホストファイルを追加します。

追加後、「登録」ボタンをクリックすればロールの構成は完了です。

デザインの作成

それでは登録したホストファイルをもとに実際のデータの分析・デザインの作成を行っていきましょう。まず、利用メニューに戻ります。

デザインの管理画面から「新規」をクリックして、新しくデザインを作成していきます。

デザインの作成では最初に事前に登録したホストファイルを選択します。

ホストファイルを選択すると、次にどの項目を取り込んでデザインを選択するか？の画面に移るので、任意の項目を選択しましょう。

デザインの編集画面では集計項目や並び順が調整できます。

加工の画面ではデータの抽出条件を設定できます。

出力画面では抽出したデータの結果をどのようなデザインで表現するか、を設定できます。今回はクロス表を表示するような構成にしてみました。

以下のようにクロス集計の縦軸・横軸・集計項目を指定しています。

あとは任意の名前を入力して「実行」します。

正常に実行が完了すると、結果の表示後集計表が作成されます。

おわりに

このようにCData ODBC ドライバを利用することで、各種クラウドサービスを Data Knowledge に取り込んでデザインを作成することができます。

CData ではBitbucket 以外にもODBC Driver を多数提供しています。270種類以上のデータソースをサポートしているので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。