Dundas BI でBitbucket のデータを使ってダッシュボードを構築

CData のBitbucket 用 ODBC ドライバーは、ODBC 標準経由でBitbucket のリアルタイムデータにアクセスし、使い慣れた SQL クエリで各種 BI、レポート、ETL ツールからBitbucket のデータを利用可能にします。この記事では、汎用 ODBC データプロバイダーとしてBitbucket に接続し、Dundas BI でBitbucket のデータを基にしたチャート、レポート、ダッシュボードを作成する方法を解説します。

Bitbucket のデータへの接続設定

1. まだ設定していない場合は、データソース名（DSN）で必要な接続プロパティを指定します。DSN の設定は組み込みの Microsoft ODBC データソースアドミニストレーターを使用して行えます。これはドライバーインストールの最終ステップでもあります。Microsoft ODBC データソースアドミニストレーターを使用して DSN を作成・設定する方法については、ヘルプドキュメントの「はじめに」の章をご参照ください。
   
   

   ほとんどのクエリでは、ワークスペースを設定する必要があります。唯一の例外は、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を設定します。

   DSN を設定する際には、Max Rows 接続プロパティも設定することをお勧めします。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時にパフォーマンスを向上させるのに役立ちます。

2. Dundas BI インターフェースを開き、メニューから New Data Connector をクリックします。
3. Dundas BI の Data Connector を設定します：
   • Data Connector の名前を入力します。
   • Data Provider として「ODBC generic」を選択します。
   • 「Use System DSN」チェックボックスをオンにします。
   • 適切なシステム DSN を選択します。
   

Bitbucket のデータをダッシュボードに追加

これでBitbucket のデータを使ってダッシュボードを作成する準備が整いました。

1. ホームページに移動します。
2. Explore Data をクリックします。

3. 適切な Data Connector を展開します。
4. Connector から関連するデータをパネルにドラッグします。
   • 「テーブル」全体を選択して追加することもできますが、適切なビジュアライゼーションを作成するには Metric Set からメジャーや行を削除する必要があるかもしれません。あるいは、ビジュアライゼーションに含めたいフィールドのみを選択することもできます。
   • フィールドを選択した状態で、メジャーと行にフィルタや条件を追加し、ビジュアライゼーションをさらにカスタマイズできます。

5. メニューバーから Re-visualize をクリックし、データに適したビジュアライゼーションを選択します。

6. Add To New Dashboard をクリックして、ビジュアライゼーションを新しいダッシュボードに追加します。

7. Bitbucket のデータを使ったダイナミックなビジュアライゼーションを作成してダッシュボードを設定します。