SAP Analytics Cloud でBitbucket のデータを分析

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

SAP Analytics Cloud は、クラウドベースのビジネスインテリジェンスプラットフォームです。CData Connect Server は、Bitbucket の仮想データベースを作成し、Bitbucket のOData API（Analytics Cloud でネイティブに使用可能）を生成するために使用できます。SAP Analytics Cloud をCData Connect Server とペアリングすることで、すべてのSaaS およびBig Data とNoSQL ソースへの、データを移行したり統合したりする必要のない接続が可能になります。ほかのOData サービスと同様に、Connect Server に接続するだけで、すべてのデータに瞬時にライブアクセスできます。

この記事では、Connect Server でのBitbucket への接続と、Analytics Cloud からのConnect Server への接続について説明し、モデルと簡単なダッシュボードを作成します。

Connect Server を構成してBitbucket に接続する

SAP Analytics Cloud からBitbucket に接続するには、Connect Server インスタンスからBitbucket アクセスを設定する必要があります。これは、ユーザーの作成、Bitbucket への接続、OData エンドポイントの追加、（オプションとして）CORS の構成を意味します。

Connect Server ユーザーの追加

Analytics Cloud からConnect Server を介してBitbucket に接続するユーザーを作成します。

1. ［Users］->［ Add］とクリックします。
2. ユーザーを構成します。
3. ［Save Changes］をクリックして新しいユーザーの認証トークンをメモします。

Connect Server からBitbucket に接続

CData Connect Server は、簡単なポイントアンドクリックインターフェースを使用してAPI を生成します。

1. Connect Server を開き、「CONNECTIONS」をクリックします。
2. 「Available Data Sources」から「Bitbucket」を選択します。
3. 必要な認証プロパティを入力し、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を設定します。
   
4. 「 Test Database」をクリックします。
5. ［Permission］->［ Add］とクリックし、適切な権限を持つ新しいユーザー（または既存のユーザー）を追加します。（Reveal に必要なのはSELECT のみです。）

Connect Server にBitbucket OData エンドポイントを追加する

Bitbucket に接続したら、目的のテーブルのOData エンドポイントを作成します。

1. ［OData］->［Tables］->［Add Tables］とクリックします。
2. Bitbucket のデータベースを選択します。
3. 使用するテーブルを選択し、［Next］をクリックします。
4. （オプション）リソースを編集して特定のフィールドなどを選択します。
5. 設定を保存します。

（オプション）Cross-Origin Resource Sharing (CORS) を構成する

Ajax などのアプリケーションから複数の異なるドメインにアクセスして接続すると、クロスサイトスクリプティングの制限に違反する恐れがあります。その場合には、［OData］->［Settings］でCORS 設定を構成します。

• Enable cross-origin resource sharing (CORS):ON
• Allow all domains without '*':ON
• Access-Control-Allow-Methods:GET, PUT, POST, OPTIONS
• Access-Control-Allow-Headers:Authorization

設定への変更を保存します。

SAP Analytics Cloud でBitbucket のデータのモデルを作成する

Bitbucket への接続が設定されてOData エンドポイントが作成されると、SAP Analytics Cloud でBitbucket のデータのモデルを作成できるようになります。

1. Analytics Cloud インスタンスにログインし、メニューから「Create」->「Model」と進みます。
2. 「Get data from a datasource」から「OData Services」を選択します。
3. Connect Server OData への既存の接続を選択、または新しい接続を作成します。
   • 「Connection Name」を設定します。
   • 「Data Service URL」をOData API のBase URL に設定します。（通常はCONNECT_SERVER_URL/api.rsc）
   • 「Authentication Type」をBasic Authentication に設定します。
   • 「User Name」を構成済みのConnect Server ユーザーに設定します。
   • 「Password」を上記のユーザーの認証トークンに設定します。
   
4. 「Create a new query」を選択して「Next」をクリックします。
5. クエリに名前を付け、OData エンドポイント（bitbucketdb_Issues など）を選択して「Next」をクリックします。
6. 使用したいカラムを「Selected Data」ワークスペースにドラッグし、「Create」をクリックします。
7. この時点でドラフトデータソースが作成されるため、ドラフトをクリックしてモデルを完成させます。
8. 計算ディメンション、場所ディメンションの作成、データソースの結合などの変換を実行し、「Create Model」をクリックします。
9. モデルに名前を付け、「OK」をクリックします。

SAP Analytics Cloud でダッシュボードを構築する

モデルが作成されたら、Bitbucket のデータを使用してSAP Analytics Cloud でダッシュボードを作成できるようになります。

1. メニューから「Create」->「Story」とクリックします。
2. SAP Analytics Template をクリックします。（この記事では、「Dashboard」テンプレートを使用します。）
3. レイアウトを選択して「Apply」をクリックします。
4. 「More」メニューから挿入するビジュアライゼーション（チャート）を選択します。
5. ビジュアライズするモデルを選択します。
6. 構造と必要なメジャー、ディメンションを選択します。
7. ストーリーを保存します。

詳細と無料トライアル

これで、リアルタイムBitbucket のデータから簡単で強力なダッシュボードが作成されました。Bitbucket（および250 以外のデータソース）のOData フィードを作成する方法の詳細については、Connect Server ページにアクセスしてください。無料トライアルにサインアップして、SAP Analytics Cloud でリアルタイムBitbucket のデータの操作を開始してください。