Mode で Confluence のデータに基づくデータビジュアライゼーションを作成

Dibyendu Datta
Lead Technology Evangelist

CData Connect AI を使用して Mode から Confluence のデータに接続し、リアルタイムのConfluence のデータを使用してビジュアライゼーションを構築できます。

Mode は、SQL、R、Python、そしてビジュアルアナリティクスを一つのプラットフォームに統合した協調型データプラットフォームです。CData Connect AI と組み合わせることで、クラウド間で即座にConfluence のデータにアクセスしてデータビジュアライゼーションに活用できます。この記事では、Connect AI で Confluence に接続し、Mode でConfluence のデータに接続してシンプルなビジュアライゼーションを作成する方法を説明します。

CData Connect AI は Confluence 専用のクラウド間インターフェースを提供し、ネイティブでサポートされているデータベースにデータをレプリケートすることなく、Mode でリアルタイムのConfluence のデータからデータビジュアライゼーションを構築できます。ビジュアライゼーションを作成するために、ユーザーはSQL クエリを記述してデータを収集します。最適化されたデータ処理を標準で使用し、CData Connect AI はサポートされているすべてのSQL 操作（フィルター、JOIN など）を Confluence に直接プッシュし、サーバーサイド処理を活用して必要なConfluence のデータを迅速に返します。

Mode 用に Confluence への接続を設定

Mode から Confluence への接続は、CData Connect AI によって実現されます。Mode から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 の生成が完了したら、Mode からConfluence のデータに接続する準備が整いました。

Mode で Confluence に接続

以下の手順では、Mode からCData Connect AI に接続して新しい Confluence データソースを作成する方法を説明します。

Mode にログインします
画面の左上隅で、名前の横にある下向き矢印をクリックし、「Connect a Database...」を選択します
次の画面で「Microsoft SQL Server」を選択します。
Microsoft SQL Server の資格情報を入力します：
- Display Name: 接続の名前
- Host/Port: Host フィールドに tds.cdata.com と入力し、Port フィールドに 14333 と入力します。
- Database name: 接続したいCData Connect AI データソースの接続名を入力します（例：Confluence1）。
- Username: CData Connect AI のユーザー名を入力します。これはCData Connect AI インターフェースの右上隅に表示されています。例：[email protected]
- Password: Settings ページで生成したPAT を入力します
変更が必要な場合を除き、残りの接続設定はデフォルト値のままにしておきます。
ページ下部で「Connect」をクリックして、CData Connect AI に接続できることを確認します。
成功すると、以下の画面が表示されます。

これで、Mode で接続を使用できるようになりました。CData Connect AI アカウントから追加のデータソースに接続するには、上記のセットアップ手順を繰り返し、各データソースに対してDatabase の値を変更します。

Mode ビジュアライゼーションの作成

Mode でビジュアライゼーションを作成するには、以下の手順に従います：

現在の画面で「New Report」をクリックします。SQL クエリのテキストエディターが表示されます。以下のクエリを入力します：
```
			SELECT * FROM [Confluence].[Pages];
		
```
「Run」をクリックします。アプリにクエリ結果が表示されます：
クエリを実行すると「New Chart」タブがアクティブになります。このタブをクリックし、「Pie Chart」を選択します。
次に、Color セクションにディメンションをドロップし、Angle セクションにメジャーをドロップします。
CData Connect AI を使用して、Mode でConfluence のデータのビジュアライゼーションを作成できました！