Metabase で Confluence のデータを連携利用する方法
Metabase は、インタラクティブなダッシュボードを作成できるオープンソースのデータ可視化ツールです。CData Connect AI と組み合わせることで、リアルタイムのConfluence のデータにリンクされたビジュアライゼーションやダッシュボードを簡単に作成できます。この記事では、Confluence に接続し、Confluence のデータ を使用してシンプルなビジュアライゼーションを構築する方法を説明します。
CData Connect は Confluence 専用のクラウド間インターフェースを提供し、データをレプリケートすることなく、Metabase でリアルタイムのConfluence のデータを簡単に連携できます。Connect はMetabase からSQL Server データベースと同じように見え、最適化されたデータ処理を標準で使用して、サポートされているすべてのSQL 操作(フィルター、JOIN など)を Confluence に直接プッシュし、サーバーサイド処理を活用してConfluence のデータを迅速に返します。
Metabase 用に Confluence への接続を設定
Metabase から Confluence への接続は、CData Connect AI によって実現されます。Metabase からConfluence のデータを操作するには、まず Confluence 接続を作成し設定します。
- Connect AI にログインして「Sources」をクリックし、 Add Connection をクリックします
- Add Connection パネルから「Confluence」を選択します
-
Confluence への接続に必要な認証プロパティを入力します。
Confluence 接続プロパティの取得・設定方法
任意のConfluence Cloud またはConfluence Server インスタンスへの接続を確立できます。接続するにはURL 接続プロパティを設定します。例えば、https://yoursitename.atlassian.net です。
Confluence への認証
Confluence は、次の認証メソッドをサポートしています:API トークン、Basic 認証、OAuth 2.0、SSO。
API トークン - Confluence Cloud アカウント
トークンの取得
アカウント認証にはAPI トークンが必要です。API トークンを生成するには、Atlassian アカウントにログインしてAPI トークン -> API トークンの作成を選択します。生成されたトークンが表示されます。
トークンを使用する認証
Cloud アカウントへの認証を行うには、以下を入力します。
- AuthScheme:APIToken に設定。
- User:Confluence サーバーに認証する際に使用されるユーザー。
- APIToken:現在認証されているユーザーに紐づくAPI トークン。
- Url:Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。
Basic 認証 - Confluence Server インスタンス
Server インスタンスへの認証を行うには、以下のように指定します。
- AuthScheme:Basic に設定。
- User:Confluence インスタンスに認証する際に使用されるユーザー。
- Password:Confluence サーバーに認証する際に使われるパスワード。
- Url:Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。
- Save & Test をクリックします
-
Add Confluence Connection ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。
Personal Access Token の追加
REST API、OData API、またはVirtual SQL Server 経由でConnect AI に接続する場合、Personal Access Token(PAT)を使用してConnect AI への接続を認証します。アクセス管理の粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして設定ページを開きます。
- Settings ページで「Access Tokens」セクションに移動し、 Create PAT をクリックします。
-
PAT に名前を付けて「Create」をクリックします。
- Personal Access Token は作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。
接続の設定とPAT の生成が完了したら、Metabase からConfluence のデータに接続する準備が整いました。
Metabase からCData Connect AI に接続
Connect AI で接続を作成したら、Metabase インスタンスに移動します。SQL Server インターフェースを使用してConnect AI に接続します。
- 管理画面(Settings -> Admin)に移動し、「Databases」タブから「Add Database」をクリックします
- Connect AI への接続を設定し、「Save」をクリックします
- Database type: 「SQL Server」を選択します
- Name: 接続に名前を付けます(例:「Confluence (Connect AI)」)
- Host: tds.cdata.com
- Port: 14333
- Database name: 先ほど作成した接続の名前(例:Confluence1)
- Username: Connect AI のユーザー名(例:user@mydomain.com)
- Password: 先ほど作成したPAT
- Use a secure connection (SSL) にチェックを入れます
Metabase で Confluence のデータを実行
Connect AI への接続を設定したら、Confluence にクエリを実行してビジュアライゼーションを構築できます。
- 「Write SQL」ツールを使用してConfluence のデータを取得します
- CData Connect AI の Confluence 接続に基づいてSQL クエリを記述します。例:
SELECT Key, Name FROM Pages WHERE Id = '10000'
- 「Visualization」画面に移動し、ビジュアライゼーションを選択して設定します
詳細情報と無償トライアル
これで、Metabase でConfluence のデータからシンプルなビジュアライゼーションを構築できました。Metabase では、SQL Server データベースと同じようにリアルタイムのConfluence のデータを引き続き操作できます。Confluence(およびその他100以上のデータソース)へのリアルタイム接続の詳細については、Connect AI ページをご覧ください。無償トライアルに登録して、今すぐMetabase でリアルタイムのConfluence のデータを活用してみてください。