Power BI Report Server でリアルタイム Bitbucket のデータ のレポートを表示

CData ODBC ドライバは、Microsoft Windows のODBC ネイティブサポートにより、Microsoft Power BI などのセルフサービス分析ツールとシームレスに連携できます。CData ODBC Driver for Bitbucket を使えば、Power BI レポートをBitbucket のデータにリンクし、ダッシュボードでBitbucket のデータをモニタリングできます。スケジュール更新やオンデマンド更新を設定することで、分析結果に常にリアルタイムのBitbucket のデータを反映させることも可能です。この記事では、ODBC ドライバを使用して Microsoft Power BI Desktop でBitbucket のデータのリアルタイムビジュアライゼーションを作成し、Power BI Report Server に公開する方法をご紹介します。

CData ODBC ドライバは、ドライバーに組み込まれた最適化されたデータ処理により、Power BI でリアルタイムBitbucket のデータを操作するための優れたパフォーマンスを実現します。Power BI から Bitbucket に複雑な SQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を Bitbucket に直接プッシュし、組み込み SQL エンジンを利用してサポートされていない操作（主に SQL 関数や JOIN 操作）をクライアント側で処理します。組み込みの動的メタデータクエリ機能により、Power BI ネイティブのデータ型を使用してBitbucket のデータを可視化・分析できます。

Bitbucket にODBC データソースとして接続

まだ設定していない場合は、ODBC データソース名（DSN）で接続プロパティを指定します。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して、ODBC DSN を作成・設定できます。Power BI Desktop から Power BI Report Server に Power BI レポートを公開するには、クライアント（デスクトップ）とサーバーの両方のマシンに 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 接続プロパティも設定することをお勧めします。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時のパフォーマンス向上に役立ちます。

DSN を作成したら、以下の手順で Power BI Desktop から Bitbucket DSN に接続します。

1. Power BI Desktop を開き、［データを取得］ -> ［ODBC］をクリックします。PowerBI.com から Power BI Desktop を起動するには、ダウンロードボタンをクリックし、次に［Power BI Desktop］をクリックします。
2. メニューでシステム DSN を選択します（Power BI Report Server に公開するために必要）。データをインポートするための SQL クエリがわかっている場合は、［詳細オプション］ ノードを展開し、［SQL ステートメント］ボックスにクエリを入力できます。
3. ［ナビゲーター］ ダイアログでテーブルを選択します。

4. ［編集］ をクリックしてクエリを編集します。インポートしたテーブルがクエリエディターに表示されます。クエリエディターでは、Bitbucket のデータ のローカルコピーを他のデータソースで充実させたり、Bitbucket のカラムをピボットしたりできます。Power BI は、ドライバーが取得した Bitbucket メタデータから各カラムのデータ型を検出します。

   Power BI は、クエリへの変更を ［適用したステップ］ セクションに記録し、リモートBitbucket のデータに対して実行される基になるデータ取得クエリを調整します。 ［閉じて適用］ をクリックすると、Power BI がデータ取得クエリを実行します。

   または、［読み込み］ をクリックしてデータを Power BI に取り込みます。

データのビジュアライゼーションを作成

データを Power BI に取り込んだら、［フィールド］ ペインからキャンバスにフィールドをドラッグして、［レポート］ ビューでデータビジュアライゼーションを作成できます。以下の手順で円グラフを作成してみましょう。

1. ［ビジュアライゼーション］ ペインで円グラフアイコンを選択します。
2. ［フィールド］ ペインでディメンションを選択します。例: Title
3. ［フィールド］ ペインでメジャーを選択します。例: ContentRaw。以下の方法でビジュアライゼーションと使用するデータを変更できます。
   • チャートの省略記号（...）ボタンをクリックして並べ替えオプションを変更します。並べ替えカラムの選択や並べ替え順序の変更オプションが表示されます。
   • ハイライトとフィルタリングの両方を使用してデータにフォーカスできます。フィルタリングはフォーカス外のデータをビジュアライゼーションから削除し、ハイライトはフォーカス外のデータを薄暗く表示します。フィールドをクリックしてハイライトします。
   • ［フィルター］ ペインにフィールドをドラッグすることで、ページレベル、レポートレベル、または単一のビジュアライゼーションにフィルターを適用できます。フィールドの値でフィルタリングするには、［フィルター］ ペインに表示される値のいずれかを選択します。
   
4. ［更新］ をクリックしてデータの変更をレポートに同期し、Power BI レポートをクライアントマシンに保存します。

Bitbucket のデータ レポートを Power BI Report Server にアップロード

ODBC データソースに基づくレポートを、Power BI Report Server を使用して組織内の他の Power BI ユーザーと共有できます。

1. Bitbucket 用の ODBC ドライバをレポートサーバーにインストール・設定します（上記の手順を参照）。
2. レポートサーバー（通常は http://MYSERVER/reports）にログインし、新しいレポートのアップロードをクリックして、先ほど保存したレポートを選択します。
3. レポートサーバーにアクセスできる任意のマシンから Bitbucket レポートを表示します。