Clear Analytics でBitbucket のデータを使ってチャートを作成

CData ODBC ドライバー for Bitbucket は、ODBC 標準を介してBitbucket のライブデータへのアクセスを可能にし、さまざまな BI、レポート、ETL ツールでBitbucket のデータ を直接扱うことができます。この記事では、Microsoft Excel のアドインである Clear Analytics を使って、Bitbucket に ODBC データソースとして接続し、Bitbucket のデータ を基にしたクエリ、テーブル、チャート（PivotTable を含む）を作成する方法を説明します。

Bitbucket のデータに接続

ODBC データソース名の設定

まだ設定していない場合は、データソース名（DSN）で必要な接続プロパティを指定します。Microsoft ODBC データソースアドミニストレーターを使って DSN を作成・設定できます。これはドライバーインストールの最終ステップでも可能です。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 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションを作成する際のパフォーマンス向上に役立ちます。

Clear Analytics でデータソースを設定

1. Excel を開き、CLEAR ANALYTICS リボンに移動します。Data Manager を開きます。
2. データソースとして Database を選択します。
3. Set Connection セクションで、新しいデータベースを作成するオプションをクリックします。
4. データソースとして Microsoft ODBC Data Source を選択し、OK をクリックします。
5. ドロップダウンメニューから、先ほど設定した DSN を選択します。
6. Set Connection セクションに戻り、SQL Builder Provider として Standard (ANSI ODBC) Query Builder を選択して Next をクリックします。
7. Schema/Owner を選択し、Clear Analytics で使用するドメイン（テーブル）を選択します。
8. 必要に応じて、テーブルやカラムの表示名と説明をカスタマイズしてデータオブジェクトを準備します。
9. CData ODBC ドライバーの大半では、ドメインにキー日付を設定する必要はありません。
10. Domain Relations セクションで、テーブル間のリレーション情報を追加します。
11. Domain Tree セクションで、データのグループを作成し、利用可能な項目をグループに追加します。
12. データのサマリーを確認し、Finish をクリックします。

Bitbucket のデータでチャートを作成

これでBitbucket のデータ を使ったチャートを作成する準備ができました。

新規クエリの作成

1. CLEAR ANALYTICS リボンの Repository をクリックします。
2. 新しいクエリを作成します。
3. 取得するカラムを選択します。
4. データの集計タイプを設定します（データを集計しない場合は空白のエントリを使用します）。
5. カラムを下のウィンドウにドラッグして、フィルタと数式を設定します。
6. クエリに名前を付けて Save をクリックします。

クエリレポートに基づいてチャートを作成

1. CLEAR ANALYTICS リボンの Report Explorer をクリックします。
2. Report Explorer ペインで、ツールバーの「New Report」アイコンをクリックします。
3. 先ほど作成したクエリを選択します。
4. レポートに名前を付けて「Save and Execute」をクリックします。
5. Report Explorer 内の Results タブをクリックします。
6. レポートを展開し、チャートを Excel スプレッドシートにドラッグします。
7. 表示される PivotChart ウィンドウで、フィールド（カラム）を Filters、Legends、Axis (Categories)、Values ウィンドウにドラッグします。

Clear Analytics で新しいデータソースを確立し、チャートを作成したら、Bitbucket のデータ の分析を始める準備ができました。ODBC Driver for Bitbucket と Clear Analytics を使用すると、Bitbucket からのライブデータを使って Excel でセルフサービス分析を実行できます。