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

Jerod Johnson
Senior Technology Evangelist

CSV JDBC Driver を OBIEE にデプロイして、エンタープライズ全体でリアルタイムレポートを実現します。

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

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.csv.jar;%PRE_CLASSPATH%

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

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

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

BI Publisher にログインします（URL は例えば http://localhost:9502/analytics）。Administration -> Manage BI Publisher をクリックします。
JDBC Connection -> Add Data Source をクリックします。
以下の情報を入力します：
- Data Source Name：ユーザーがレポートで接続を作成する際に使用する名前を入力します。
- Driver Type：Other を選択します。
- Database DriverClass：ドライバークラス cdata.jdbc.csv.CSVDriver を入力します。
- Connection String：JDBC URL を入力します。
  CSV 接続プロパティの取得・設定方法
  
  DataSource プロパティにローカルフォルダ名を設定します。
  
  .csv、.tab、.txt ではない拡張子のファイルを扱う場合には、IncludeFiles 使用する拡張子をカンマ区切りで設定します。Microsoft Jet OLE DB 4.0 driver 準拠の場合にはExtended Properties を設定することができます。別の方法として、Schema.ini ファイルにファイル形式を記述することも可能です。
  
  CSV ファイルの削除や更新を行う場合には、UseRowNumbers をTRUE に設定します。RowNumber はテーブルKey として扱われます。
  
  Amazon S3 内のCSV への接続
  
  URI をバケットおよびフォルダに設定します。さらに、次のプロパティを設定して認証します。
  - AWSAccessKey：AWS アクセスキー（username）に設定。
  - AWSSecretKey：AWS シークレットキーに設定。
  Box 内のCSV への接続
  
  URI をCSV ファイルを含むフォルダへのパスに設定します。Box へ認証するには、OAuth 認証標準を使います。認証方法については、Box への接続を参照してください。
  
  Dropbox 内のCSV への接続
  
  URI をCSV ファイルを含むフォルダへのパスに設定します。Dropbox へ認証するには、OAuth 認証標準を使います。認証方法については、Dropbox への接続を参照してください。ユーザーアカウントまたはサービスアカウントで認証できます。ユーザーアカウントフローでは、以下の接続文字列で示すように、ユーザー資格情報の接続プロパティを設定する必要はありません。
  
  SharePoint Online SOAP 内のCSV への接続
  
  URI をCSV ファイルを含むドキュメントライブラリに設定します。認証するには、User、Password、およびStorageBaseURL を設定します。
  
  SharePoint Online REST 内のCSV への接続
  
  URI をCSV ファイルを含むドキュメントライブラリに設定します。StorageBaseURL は任意です。指定しない場合、ドライバーはルートドライブで動作します。認証するには、OAuth 認証標準を使用します。
  
  FTP 内のCSV への接続
  
  URI をルートフォルダとして使用されるフォルダへのパスが付いたサーバーのアドレスに設定します。認証するには、User およびPassword を設定します。
  
  Google Drive 内のCSV への接続
  
  デスクトップアプリケーションからのGoogle への認証には、InitiateOAuth をGETANDREFRESH に設定して、接続してください。詳細はドキュメントの「Google Drive への接続」を参照してください。
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の構築には、CSV JDBC Driver に組み込まれた接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
java -jar cdata.jdbc.csv.jar
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  JDBC URL を構成する際、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時のパフォーマンス向上に特に役立ちます。
  
  一般的な JDBC URL は以下のとおりです：
```
jdbc:csv:DataSource=MyCSVFilesFolder;
```
- Username：ユーザー名を入力します。
- Password：パスワードを入力します。
Security セクションで、許可するユーザーロールを選択します。

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

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

グローバルヘッダーで、New -> Data Model をクリックします。
Diagram タブで、メニューから SQL query を選択します。
クエリの名前を入力し、Data Source メニューで作成した CSV JDBC データソースを選択します。
standard SQL を選択し、以下のようなクエリを入力します：
```
SELECT City, SUM(TotalDue) FROM Customer GROUP BY City
```
View Data をクリックして、レポート作成に使用するサンプルデータを生成します。
サンプルデータに含める行数を選択し、View をクリックしてから、Save As Sample Data をクリックします。
Create Report -> Use Data Model をクリックします。
Guide Me を選択し、Select Layout ページで含めるレポートオブジェクトを選択します。この例では Chart と Table を選択します。
TotalDue のような数値カラムを Y 軸の Drop Value Here ボックスにドロップします。City のようなディメンションカラムを X 軸の Drop Label Here ボックスにドロップします。
Refresh をクリックすると、CSV のデータの変更が反映されます。