GeckoboardでBitbucket のデータをダッシュボードに可視化

Geckoboard は、主要業績評価指標（KPI）のビジュアライゼーションを簡素化するビジネスインテリジェンスツールで、ライブダッシュボードを作成できます。Salesforce、Snowflake、Google Analytics、スプレッドシートなど、さまざまなソースからデータを統合し、視覚的に魅力的で理解しやすい形式で表示できます。シンプルさと明瞭さを重視して設計された Geckoboard は、企業がパフォーマンスをモニタリングし、目標を追跡し、データドリブンな意思決定を行うのに役立ちます。

CData Connect AI と組み合わせると、Geckoboard からダッシュボード、モニタリング、ビジュアライゼーションなどのためにBitbucket のデータへ即座にクラウド間でアクセスできます。この記事では、Bitbucket に接続し、Geckoboard でBitbucket のデータを使用してビジュアライゼーションを作成する方法を説明します。

CData Connect AI は、Bitbucket 向けのシームレスな SQL Server クラウド間インターフェースを提供し、Geckoboard でリアルタイムのBitbucket のデータを使用したダッシュボードとビジュアライゼーションを簡単に作成できます。ビジュアライゼーションを構築する際、Geckoboard は必要なデータを取得するために SQL クエリを必要とします。最適化されたデータ処理を標準で備えており、サポートされているすべての SQL 操作（フィルターや JOIN など）を Bitbucket に直接プッシュし、サーバーサイド処理を活用してBitbucket のデータを高速かつ効率的に取得します。

Geckoboard 用の Bitbucket 接続を設定

Geckoboard から Bitbucket への接続は、CData Connect AI によって実現されます。Geckoboard からBitbucket のデータを扱うには、まず Bitbucket 接続を作成・設定します。

1. Connect AI にログインし、Sources をクリック、次に Add Connection をクリック

2. Add Connection パネルから「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. Save & Test をクリック
5. Add Bitbucket Connection ページで Permissions タブに移動し、ユーザーベースの権限を更新します。

Personal Access Token を追加

REST API、OData API、または仮想 SQL Server 経由で Connect AI に接続する場合、Personal Access Token（PAT）が Connect AI への接続認証に使用されます。アクセスの粒度を維持するため、サービスごとに個別の PAT を作成することをお勧めします。

1. Connect AI アプリの右上にある歯車アイコン（）をクリックして Settings ページを開きます。
2. Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック。
3. PAT に名前を付けて Create をクリック。
4. Personal Access Token は作成時にのみ表示されるので、必ずコピーして安全な場所に保存してください。

接続の設定と PAT の生成が完了したら、Geckoboard からBitbucket のデータに接続する準備が整いました。

Geckoboard でリアルタイムの Bitbucket データに接続

以下の手順に従って、Geckoboard から CData Connect AI 仮想 SQL Server API への接続を確立します。

1. Geckoboard にログイン
2. カスタムダッシュボード名を追加し、Add widget をクリック
3. Connect your data 検索バーで「Databases」を検索
4. Database type として SQL Server を選択
5. 接続情報を入力：
   • Connection name：CData Connect AI への接続名を入力
   • Host：仮想 SQL Server エンドポイントを入力：tds.cdata.com
   • Port：14333 を入力
   • Database name：接続したい CData Connect AI データソースの Connection Name を入力（例：Bitbucket1）
   • Username：CData Connect AI のユーザー名を入力。CData Connect AI インターフェースの右上に表示されています（例：[email protected]）
   • Password：Settings ページで生成した PAT を入力
   
6. Connect をクリック

接続の設定が完了したら、Bitbucket のデータ をクエリ・ビジュアライズできます。

Geckoboard でリアルタイムのBitbucket のデータをビジュアライズ

Geckoboard でリアルタイムのBitbucket のデータをビジュアライズするには、以下の手順に従ってください：

1. Paste your SQL query コンパイラ画面で、ビジュアライゼーションに必要な特定のBitbucket のデータを選択する SQL クエリを記述

ユースケースに応じて、CData Connect AI の Playground または Query Builder 機能を使用して、必要な SQL クエリを生成することもできます


2. ビジネス要件に最適なビジュアライゼーションタイプ（折れ線グラフ、棒グラフ、または縦棒グラフ）を選択
3. 選択したチャートが Geckoboard に表示されます
4. グラフの右上にあるメニュー（3 つのドット）をクリックし、Edit を選択して SQL クエリを変更したり、チャートの更新間隔を設定したりできます

クラウドアプリケーションから Bitbucket データへのリアルタイムアクセス

これで、Geckoboard からリアルタイムのBitbucket のデータへの直接のクラウド間接続が確立されました。ダッシュボードを作成して、データをシームレスにモニタリング・ビジュアライズできます。

Geckoboard などのクラウドアプリケーションから 100 以上の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスの詳細については、Connect AI ページをご覧ください。