MicroStrategy Desktop で CData ODBC Driver for Confluence を使用

MicroStrategy は、データドリブンなイノベーションを可能にする分析およびモビリティプラットフォームです。CData ODBC Driver for Confluence と組み合わせることで、MicroStrategy からリアルタイムのConfluence のデータにデータベースのようにアクセスでき、レポートや分析の機能を拡張できます。本記事では、MicroStrategy Desktop で Confluence をデータソースとして追加し、Confluence のデータ の簡単なビジュアライゼーションを作成する手順を説明します。

CData ODBC Driver は、ドライバーに組み込まれた最適化されたデータ処理により、MicroStrategy でリアルタイムのConfluence のデータを操作する際に比類のないパフォーマンスを発揮します。MicroStrategy から Confluence に複雑な SQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を Confluence に直接プッシュし、サポートされていない操作（多くの場合 SQL 関数や JOIN 操作）は組み込みの SQL エンジンを使用してクライアント側で処理します。動的なメタデータクエリ機能が組み込まれているため、ネイティブの MicroStrategy データ型を使用してConfluence のデータを可視化・分析できます。

ODBC データソースとして Confluence に接続

Confluence への接続に関する情報と、Windows および Linux 環境での DSN 設定手順を以下に説明します。

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 です。

DSN を設定する際に、Max Rows 接続プロパティも設定することをお勧めします。これにより返される行数を制限でき、レポートやビジュアライゼーションを設計する際のパフォーマンス向上に特に効果的です。

Windows

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定してください。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して ODBC DSN を作成・設定できます。

Linux

Linux 環境で CData ODBC Driver for Confluence をインストールする場合、ドライバーのインストール時にシステム DSN が事前定義されます。システムデータソースファイル（/etc/odbc.ini）を編集して、必要な接続プロパティを定義することで DSN を変更できます。

/etc/odbc.ini

[CData Confluence Sys]
Driver = CData ODBC Driver for Confluence
Description = My Description
User = admin
APIToken = myApiToken
Url = https://yoursitename.atlassian.net
Timezone = America/New_York

これらの設定ファイルの使用方法の詳細については、ヘルプドキュメント（インストール版およびオンライン版）を参照してください。

MicroStrategy Desktop を使用して Confluence のデータに接続して可視化

MicroStrategy エンタープライズ製品で Confluence に接続するだけでなく、MicroStrategy Desktop でも Confluence に接続できます。以下の手順に従って、Confluence のデータ をデータセットとして追加し、Confluence のデータ のビジュアライゼーションとレポートを作成してください。

1. MicroStrategy Desktop を開き、新しいドシエを作成します。
2. データセットパネルで「New Data」をクリックし、「Databases」を選択して、インポートオプションとして「Type a Query」を選択します。
3. 新しいデータソースを追加し、「DSN data sources」を選択します。
4. 以前に設定した DSN（通常は CData Confluence Sys）を選択し、Version メニューで「Generic DBMS」を選択します。
5. DSN の User と Password プロパティを設定し（またはプレースホルダー値を使用）、データソースに名前を付けます。
6. 新しいデータベースインスタンスを選択してテーブルを表示します。「Available Tables」セクションでテーブルを表示するには、検索アイコンを手動でクリックする必要がある場合があります。
7. Confluence のデータ 用の SQL クエリを作成し（以下を参照）、「Execute SQL」をクリックしてクエリをテストします。

   SELECT * FROM Pages
   

   注意：ライブ接続を作成するため、SELECT * クエリを実行し、MicroStrategy 製品にネイティブのフィルタリングや集計機能を利用できます。
8. 「Finish」をクリックし、ライブ接続を選択します。
9. ビジュアライゼーションを選択し、表示するフィールドを選択し（データ型は動的メタデータ検出により自動的に検出されます）、フィルタを適用してConfluence のデータの新しいビジュアライゼーションを作成します。可能な場合、フィルタや集計によって生成された複雑なクエリは Confluence にプッシュダウンされ、サポートされていない操作（SQL 関数や JOIN 操作を含む場合があります）はドライバーに組み込まれた CData SQL エンジンによってクライアント側で管理されます。
10. ドシエの設定が完了したら、「File -> Save」をクリックします。

MicroStrategy Desktop で CData ODBC Driver for Confluence を使用すると、Confluence のデータ の堅牢なビジュアライゼーションとレポートを簡単に作成できます。その他の例については、MicroStrategy で Confluence に接続や MicroStrategy Web で Confluence に接続に関する記事もご覧ください。