SharePoint JDBC Driver を使用した OBIEE でのレポート作成

CData JDBC Driver for SharePoint は、標準的なデータベースドライバーとして、Java ベースのレポーティングサーバーにSharePoint のデータへのリアルタイムアクセスを統合できます。この記事では、Oracle Business Intelligence Enterprise Edition（OBIEE）にドライバーをデプロイし、変更がリアルタイムに反映されるSharePoint のデータのレポートを作成する方法を説明します。

はじめに

---

JDBC Driver のデプロイ

以下の手順で、JDBC Driver を WebLogic のクラスパスに追加します。

WebLogic 12.2.1 の場合、ドライバーの JAR ファイルと .lic ファイルを DOMAIN_HOME\lib に配置するだけで完了です（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\lib）。これらのファイルは起動時にサーバーのクラスパスに追加されます。

手動でクラスパスにドライバーを追加することもできます（以前のバージョンでは必須）。setDomainEnv.cmd（Windows）または setDomainEnv.sh（Unix）の PRE_CLASSPATH の先頭に以下を追加します。このスクリプトは、そのドメインのフォルダ内の bin サブフォルダにあります（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\bin）。

set PRE_CLASSPATH=your-installation-directory\lib\cdata.jdbc.sharepoint.jar;%PRE_CLASSPATH%

すべてのサーバーを再起動します（例：DOMAIN_HOME\bitools\bin の stop コマンドと start コマンドを実行）。

SharePoint 用 JDBC データソースの作成

JDBC Driver をデプロイしたら、BI Publisher から JDBC データソースを作成できます。

1. BI Publisher にログインします（URL は例えば http://localhost:9502/analytics）。Administration -> Manage BI Publisher をクリックします。
2. JDBC Connection -> Add Data Source をクリックします。
3. 以下の情報を入力します：
   • Data Source Name：ユーザーがレポートで接続を作成する際に使用する名前を入力します。
   • Driver Type：Other を選択します。
   • Database DriverClass：ドライバークラス cdata.jdbc.sharepoint.SharePointDriver を入力します。
   • Connection String：JDBC URL を入力します。

     Microsoft SharePoint への接続

     URL の設定：

     Microsoft SharePoint では、2つの範囲でデータを操作できます。グローバルなMicrosoft SharePoint サイト全体を対象にするか、個々のサイトのみを対象にするかを選択できます。

     グローバルなMicrosoft SharePoint サイトですべてのリストおよびドキュメントを操作したい場合は、URL 接続プロパティをサイトコレクションURL に設定しましょう。以下のような形式です。

     https://teams.contoso.com

     個々のサイトのリストおよびドキュメントのみを扱いたい場合は、URL 接続プロパティを個々のサイトURL に設定してください。以下のような形式です。

     https://teams.contoso.com/TeamA

     続いて、お使いの環境に適した認証プロパティを設定していきましょう。詳細な設定手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」をご参照ください。

     Microsoft SharePoint Online

     SharePointEdition を"SharePoint Online" に設定し、User およびPassword にはSharePoint へのログオンで使用するクレデンシャル（例：Microsoft Online Services アカウントのクレデンシャル）を設定します。

     Microsoft SharePoint Online は様々なクラウドベースアーキテクチャをサポートしており、それぞれ異なる認証スキームが利用できます。

     • Microsoft Entra ID（Azure AD）
     • ADFS、Okta、OneLogin、またはPingFederate SSO ID プロバイダーを介したシングルサインオン（SSO）
     • Azure MSI
     • Azure パスワード
     • OAuthJWT
     • SharePointOAuth

     Microsoft SharePoint オンプレミス

     Microsoft SharePoint オンプレミスでは、多くのオンプレミス環境に対応した認証方式をサポートしています。

     • Windows（NTLM）
     • Kerberos
     • ADFS
     • 匿名アクセス

     まずSharePointEdition を"SharePoint On-Premises" に設定しましょう。

     Windows（NTLM）認証

     これは最も一般的な認証方式です。そのため、CData 製品ではNTLM をデフォルトとして使用するよう事前設定されています。Windows のUser およびPassword を設定するだけで接続できます。

     組み込みの接続文字列デザイナー

     JDBC URL の構築には、SharePoint JDBC Driver に組み込まれた接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

     java -jar cdata.jdbc.sharepoint.jar
     

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     

     JDBC URL を構成する際、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時のパフォーマンス向上に特に役立ちます。

     一般的な JDBC URL は以下のとおりです：

     jdbc:sharepoint:User=myuseraccount;Password=mypassword;Auth Scheme=NTLM;URL=http://sharepointserver/mysite;SharePointEdition=SharePointOnPremise;

   • Username：ユーザー名を入力します。
   • Password：パスワードを入力します。
4. Security セクションで、許可するユーザーロールを選択します。

リアルタイム SharePoint レポートの作成

これで、リアルタイムSharePoint のデータに基づいたレポートや分析を作成できます。以下の手順で、標準のレポートウィザードを使用して、SharePoint のデータの変更がリアルタイムに反映されるインタラクティブなレポートを作成します。

1. グローバルヘッダーで、New -> Data Model をクリックします。
2. Diagram タブで、メニューから SQL query を選択します。
3. クエリの名前を入力し、Data Source メニューで作成した SharePoint JDBC データソースを選択します。
4. standard SQL を選択し、以下のようなクエリを入力します：

   SELECT Name, Revenue FROM MyCustomList

   
5. View Data をクリックして、レポート作成に使用するサンプルデータを生成します。
6. サンプルデータに含める行数を選択し、View をクリックしてから、Save As Sample Data をクリックします。
7. Create Report -> Use Data Model をクリックします。
8. Guide Me を選択し、Select Layout ページで含めるレポートオブジェクトを選択します。この例では Chart と Table を選択します。
9. Revenue のような数値カラムを Y 軸の Drop Value Here ボックスにドロップします。Name のようなディメンションカラムを X 軸の Drop Label Here ボックスにドロップします。
10. Refresh をクリックすると、SharePoint のデータの変更が反映されます。