Oracle® Fusion Middleware

Oracle Business Intelligence Enterprise Editionシステム管理者ガイド

12c (12.2.1.2.0)

E85890-01(原本部品番号:E77714-02)

2016年12月

デプロイメントの起動と停止、構成および拡張をはじめとする、Oracle Business Intelligence Enterprise Editionのプロセスおよびコンポーネントを管理する方法について説明します。

Oracle Business Intelligence Enterpriseシステムのカスタマイズ、監視、トラブルシューティングおよび移行の方法についても説明します。

Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド, 12c (12.2.1.2.0)

E85890-01

Copyright © 2015, 2016, Oracle and/or its affiliates All rights reserved.

原本著者: Kate Price

原本協力著者: Marla Azriel、Christine Jacobs、Dona Hobin、Cammy Moore、Nick Fry、Stefanie Rhone、Lea Shaw。

原本協力者: Oracle Business Intelligence development, product management, and quality assurance teams

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、このソフトウェアまたはハードウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle およびその関連企業の登録商標です。その他の名称は、他社の商標の可能性があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメントとその他のリソース

- 表記規則

Oracle Business Intelligenceシステム管理者向けの新機能

- Oracle BI EE 12 c (12.2.1.2.0)の新機能および変更点

- Oracle BI EE 12c (12.2.1.1.0)の新機能および変更点

- Oracle BI EE 12c (12.2.1.0)の新機能および変更点

第I部 Oracle Business Intelligenceの管理

1 Oracle Business Intelligenceのシステム管理の概要

- Oracle Business Intelligenceのシステム管理タスク

- Oracle Business Intelligenceの管理について

- システムの論理アーキテクチャとは

- Oracle Business Intelligenceのシステム・アーキテクチャ

- Oracle Business Intelligenceコンポーネント

- 管理サーバー、管理対象サーバーおよびシステム・コンポーネントについて

- Oracle Business Intelligenceの主なディレクトリ

- Oracle Business Intelligenceを管理するシステム管理ツール

- Fusion Middleware Control

- Oracle WebLogic Server管理コンソール

- プロセス制御コマンド

- Oracle WebLogic Scripting Tool (WLST)

- Oracle BI管理ツール

- カタログ・マネージャ

- ジョブ・マネージャ

- サンプル・アプリケーションでの作業

- Oracle BI Publisherの統合

- その他のガイド内の関連トピック

- システム要件と動作保証

第II部 プロセスおよびコンポーネントの管理

2 Oracle Business Intelligenceプロセスの管理

- Oracle Business Intelligenceプロセスの管理について

- Oracle Business Intelligenceシステムを起動する条件

- コマンドを使用した起動、停止およびOracle BI EEプロセスのステータスの表示

- ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動

- ドメインのOracle Business Intelligenceコンポーネント・プロセスの停止

- ドメインのOracle Business Intelligenceコンポーネントのステータスの表示

- Fusion Middleware Controlを使用したBIシステム・コンポーネント・プロセスの起動および停止

- Fusion Middleware Controlを使用したJavaコンポーネントの起動および停止

- Javaコンポーネントを起動および停止するためのOracle WebLogic Server管理コンソールの使用

第III部 高可用性とパフォーマンスのためのスケーリングおよびデプロイ

3 デプロイメントのスケーリング

- Oracle Business Intelligenceのスケーリングについて

- 共有ファイルとディレクトリの設定

- シングルトン・データ・ディレクトリ(SDD)の変更

- グローバル・キャッシュの設定

- Oracle Business Intelligenceの容量の管理(垂直方向のスケーリング)

- システム・コンポーネントの追加

- システム・コンポーネントの削除

- Oracle Business Intelligenceの可用性の管理(水平方向のスケーリング)

- 新しいコンピュータの追加

- 既存のコンピュータの削除

- システムに対する適切なスケーリングの検証

- システム・コンポーネントの可用性を表示するためのFusion Middleware Controlの使用

- 管理対象サーバーの可用性を表示するための管理コンソールの使用

4 高可用を実現するOracle Business Intelligenceのデプロイ

- クラスタ環境におけるOracle Business Intelligenceコンポーネントについて

- 可用性に関する推奨事項

- 単一点障害を特定するためのFusion Middleware Controlの使用

- アクティブ/パッシブ・モデルを使用した高可用性の実現

- 高可用性に対するOracle Business Intelligenceコンポーネントの構成

- Oracle Business Intelligenceの高可用性に対するオプション構成

- オプションのクラスタ・コントローラ・パラメータの設定

- オプションのPresentation Servicesパラメータの設定

- オプションのOracle BIプレゼンテーション・サービス・プラグイン・パラメータの設定

- クラスタ・マネージャの使用

- クラスタ情報の表示および管理

- ステータス情報

- キャッシュ情報

- セッション情報

- サーバー情報

- Fusion Middleware Controlのクラスタ化された環境のトラブルシューティング

- Oracle BIサーバーがLinuxまたはUNIX上で実行されている場合のNetwork Applianceデバイスでのエラーの回避

5 パフォーマンス・チューニングと問合せキャッシングの管理

- サービス・レベルの監視

- すべてのOracle Business Intelligenceメトリックを表示するためのFusion Middleware Controlの使用

- Javaコンポーネントのメトリックを表示するための管理コンソールの使用

- 問合せのパフォーマンス・チューニングについて

- Fusion Middleware Controlでのパフォーマンス・パラメータの設定

- RPD更新を禁止するためのFusion Middleware Controlの使用

- ユーザー・セッションのログオフ期間を設定するためのFusion Middleware Controlの使用

- 表およびピボット・テーブルのデータに対する構成オプションを設定するためのFusion Middleware Controlの使用

- 表をレンダリングするために処理する最大行数を設定するためのFusion Middleware Controlの使用

- Oracle BIサーバーの問合せキャッシュについて

- 問合せキャッシュのアーキテクチャ

- キャッシングの利点

- キャッシングに伴う代償

- ディスク領域

- 管理タスク

- 最新の状態のキャッシュの維持

- CPU使用率とディスクI/O

- ユーザー間でのキャッシュの共有

- XMLデータソースのリフレッシュ間隔について

- グローバル・キャッシュについて

- 問合せキャッシングの構成

- 問合せキャッシングを有効または無効にするためのFusion Middleware Controlの使用

- 問合せキャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

- 追加の問合せキャッシュ・パラメータの手動での編集

- グローバル・キャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

- 追加のグローバル・キャッシュ・パラメータの手動での編集

- キャッシュの監視と管理

- キャッシュ管理方針の選択

- システムのキャッシングの無効化

- 指定された物理表のキャッシングとキャッシュ永続時間

- Oracle BIサーバーのイベント・ポーリング表の構成

- ODBCプロシージャを使用するキャッシュのパージと保守

- ODBCプロシージャ構文について

- プレゼンテーション・サービス問合せキャッシュの共有について

- 結果レコードについて

- SAP/BWデータソースのキャッシュの保存とパージ

- リポジトリの変更が問合せキャッシュに及ぼす影響

- キャッシュの使用方針

- キャッシュ・ヒットについて

- 行レベルのデータベース・セキュリティを使用している場合の適切なキャッシュ結果の確認

- キャッシュを移入するための一連の問合せの実行

- Oracle BIサーバー・キャッシュをシードするためのエージェントの使用

- キャッシュ・マネージャの使用

- キャッシュ・マネージャ内でのグローバル・キャッシュ情報の表示

- 管理ツールでのキャッシュのパージ

- イベント・ポーリング表によるキャッシュ・イベントの処理

- 物理データベース上でのイベント・ポーリング表の設定

- イベント・ポーリング表のアクティブ化

- Oracle BIサーバー・イベント・ポーリング表の移入

- イベント・ポーリング表に関する問題のトラブルシューティング

- Oracle BI Presentation Servicesキャッシュ設定の管理

- Oracle BI Webクライアントのパフォーマンスの向上

- Apache HTTP Serverの静的ファイル・キャッシングの構成

- Oracle HTTP Serverの静的ファイル・キャッシングの構成

- Oracle Business IntelligenceのJVMヒープ・サイズの設定

- ダイナミック・モニタリング・サービスを使用したメトリックの取得

- ダイナミック・モニタリング・サービスを使用したメトリックの取得

- WLSTコマンドを使用したメトリックの取得

第IV部 問題の解決

6 Oracle Business Intelligenceの問題の診断および解決

- 使用可能な診断ツール

- 診断バンドルの収集

- 診断ログ・ファイルの表示と構成

- ログ情報、エラー・メッセージおよびアラートを表示するためのFusion Middleware Controlの使用

- ログ・ファイルのローテーション・ポリシーの構成とログ・レベルの指定

- ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

- 追加のログ・ファイル設定の手動での変更

- ログ・ビューアを使用した問題の診断

- 診断ログ・ファイルとログ構成ファイルについて

- 診断ログ・ファイルの概要とその位置

- 診断ログ構成ファイルの概要とその位置

- ログ・ファイル・メッセージのカテゴリとレベルの概要

- ログ・ファイル・ローテーション

- システム・ログ内のメッセージ

- 問合せログの管理

- 問合せロギングの構成

- 問合せロギング・レベルの設定

- ユーザーの問合せロギング・レベルの設定

- ログ・ビューアの使用

- ログ・ビューア・ユーティリティの実行

- ログ・レコードの解析

- Oracle BIサーバーでのロギング

- Oracle BIプレゼンテーション・サービスのロギング機能の使用

- Oracle BIプレゼンテーション・サービスのロギング・レベルの設定

- Oracle BIプレゼンテーション・サービス構成ファイルの構造

- ログ・メッセージの形式例

- Oracle BIプレゼンテーション・サービス・メッセージの構造

- Oracle BIプレゼンテーション・サービスsログ・フィルタ

- エージェントに関する問題の診断

- Fusion Middleware Controlを使用したエージェントのデバッグ

- instanceconfig.xmlを使用したエージェントの手動デバッグ

- ODBC/JDBCプロシージャを使用したOracle BIサーバーの診断の取得

- Oracle BIサーバーのODBC/JDBCプロシージャについて

- 使用可能な診断カテゴリのリストの取得

- 特定の診断の実行

- ODBC/JDBCプロシージャのパラメータについて

- システム起動のトラブルシューティング

- データベースが実行されていない場合の管理サーバーの起動エラー

- 管理対象サーバーの停止

- Oracle BIサーバーの起動エラー

- ログイン不能

7 使用状況トラッキングの管理

- 使用状況トラッキングについて

- 使用状況トラッキングの情報を収集するための直接挿入の設定

- 使用状況トラッキングの統計データベースの設定

- 直接挿入パラメータの設定

- オプションの直接挿入パラメータの設定

- 使用状況トラッキング・データの説明

第V部 Oracle Business Intelligenceの構成

8 Oracle Business Intelligenceを管理および構成するためのツールの使用

- Fusion Middleware ControlおよびWebLogic Server管理コンソールを使用する理由

- Fusion Middleware Controlを使用したOracle Business Intelligenceシステム・コンポーネントの管理

- Fusion Middleware Controlへのログイン

- Fusion Middleware ControlのOracle Business Intelligenceページの表示

- Fusion Middleware Controlのナビゲーション・ツリーの使用

- Fusion Middleware ControlをOracle Business Intelligenceとともに使用するためのヒント

- Oracle Business Intelligenceシステム設定の構成

- Fusion Middleware Controlの使用

- テキスト・エディタの使用

- WLST (WebLogic Scripting Tool)の使用

- オフラインの構成変更の実行

- オンラインの構成変更の実行

- Java Development Kit (JDK)の更新

- 「Oracle WebLogic Server管理コンソールによるOracle Business IntelligenceJavaコンポーネントの管理」

9 メタデータの管理およびサービス・インスタンスの操作

- Oracle Business Intelligenceアプリケーション・アーカイブ(BAR)・ファイルについて

- Oracle Business Intelligenceのアプリケーション・アーカイブ(BAR)・ファイルの概要

- 使用可能な定義済のBARファイル

- BARファイルのインポートについて

- サービス・インスタンスの管理

- listBIServiceInstances

- getBIServiceInstance

- scaleOutBIServiceInstance

- exportServiceInstance

- importServiceInstance

- refreshServiceInstance

- refreshDomainServiceInstances

- resetServiceInstance

10 外部システムへの接続の構成

- 電子メールおよびエージェントの構成

- エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

- アクション・フレームワークを使用したアクションの構成

- マーケティング・コンテンツ・サーバーへの接続の構成

- データ・ソースへの接続の構成

11 プレゼンテーション設定のデフォルトの構成

- Fusion Middleware Controlを使用したプレゼンテーション設定のデフォルトの変更

12 マッピングおよび空間情報の構成

- マップ・ビューのシステム要件

- ハードウェアのサイズ設定およびマップのデプロイメント戦略

- マップ・ビューで使用するためのサンプル空間データセット

- マップの管理

- マップおよびレイヤーの使用

- レイヤーと列の関連付け

- マップ上のレイヤーの順序付け

- 再起動を必要とする空間メタデータの変更

- 管理ページの機能

- 管理ページを使用したマップの管理

- マップ内のレイヤーの翻訳処理

13 タイムゾーンの構成

- タイムゾーンが使用される理由および場所

- タイムゾーンの設定

- タイムゾーンの優先順位

- ユーザー優先タイムゾーン

- タイムゾーン指定の格納場所

- タイムゾーン設定の説明

- 例: タイムゾーンを指定する構成ファイルの設定

14 Oracle Business Intelligenceのローカライズ

- ローカライズとは

- 翻訳対象コンポーネント

- Oracle Business Intelligenceコンポーネントをローカライズするためのタスク

- Oracle BIプレゼンテーション・サービスのローカライズ

- Oracle BIプレゼンテーション・サービスのユーザー・インタフェースのローカライズ

- プレゼンテーション・サービスをローカライズするためのディレクトリ構造の理解

- ユーザーの優先通貨のメッセージのローカライズ

- サインイン・ページのデフォルト言語の指定

- サインイン・ページの言語およびロケールの構成

- パフォーマンス・タイルの数字のスケーリングの指定

- URLでの言語の指定

- Oracle BI Presentation Catalogのキャプションのローカライズ

- ステップ1: エクスポート・プロセスについて

- ステップ2: カタログ内のテキスト文字列のエクスポート

- ステップ3: XMLファイル内のエクスポートされた文字列の編集

- ステップ4: 重複するエクスポートされたテキスト文字列の処理

- ステップ5: カタログでのテキスト文字列の公開

- Mozilla Firefoxブラウザでのアラビア語およびヘブライ語に関するヒント

- Catalog Managerでの現在のロケールの設定

- Oracle BI Serverでの現在のロケールの設定

- Oracle BIサーバーでのロケール・パラメータの設定

- UNIXシステムでのロケールの設定

- エラー・メッセージの言語が決定される方法

- Oracle BIサーバーのコンポーネントの言語の設定

- 管理ツールのユーザー・インタフェースの言語の変更

- Oracle BIサーバーでの現在のロケールに関するトラブルシューティング

- NLSロケール非サポート・エラー・メッセージの処理

- AIXシステムでの日本語ロケールの設定

- Oracle BIサーバー・ユーティリティのテキストが正しい言語で表示されることの確認

- 基礎となるOracle DatabaseのNLS_CHARACTERSETがUnicodeでない場合のメタデータ・リポジトリの変更

- リポジトリでのメタデータ名のローカライズ

- 多言語データのサポート

- 多言語データのサポートとは

- 参照とは

- 二重列サポートとは

- 多言語スキーマでの翻訳参照表の設計

- 各ベース表に対応する参照表

- 各翻訳済フィールドに対応する参照表

- 論理参照表および論理参照列の作成

- 論理参照表の作成

- 論理表の参照表としての指定

- LOOKUP関数の構文について

- 論理参照列の作成

- 派生論理列を使用するためのヒント

- 非ISOタイプの言語コードの処理

- 物理参照表および物理参照列の作成

- 別名表を使用したEssbaseでの多言語データのサポート

- 辞書編集上の差異によるソートの有効化

15 通貨オプションの構成

- 分析用デフォルト通貨の変更

- ユーザーの優先通貨オプションの定義

- 静的マッピングを使用したユーザーの優先通貨オプションの定義

- 例: ユーザーの優先通貨オプションを定義する静的マッピング

- 動的マッピングを使用したユーザーの優先通貨オプションの定義

- 例: ユーザーの優先通貨オプションを定義する動的マッピング

16 Oracle BIプレゼンテーション・カタログの構成と管理

- Oracle BIプレゼンテーション・カタログについて

- カタログ内のオブジェクト

- カタログのファイル・システムのガイドライン

- Oracle BI Presentation Catalogのメンテナンス

- カタログの構成設定の手動による変更

- 本番環境へのカタログとオブジェクトのデプロイ

- 本番環境へのカタログのデプロイ

- 本番環境へのオブジェクトのデプロイ

- カタログ・オブジェクトの更新

- カタログの検証

- プロセス: カタログの検証

- 検証プロセスのタスク

- カタログ検証の重要なガイドライン

- 基本的なカタログ検証の実行

- カタログを検証するための要素の指定

- カタログ・マネージャについて

- カタログ・マネージャの起動とカタログのオープン

- カタログ・マネージャの実行要件

- カタログ・マネージャのユーザー・インタフェースの起動

- Linuxシステムでの起動に関する問題の解決

- 2つのカタログ・モードの理解

- オンライン・モードおよびオフライン・モードで使用可能な操作

- Oracle BI Presentation Catalogのオープン

- カタログ・マネージャの作業領域の使用方法

- カタログ・マネージャの作業領域で行える操作

- カタログ・マネージャの作業領域の外観

- カタログ・マネージャの作業領域の表示の管理

- カタログ・マネージャでのオブジェクトの使用

- カタログ・マネージャを使用したカタログ・オブジェクトの検索

- オブジェクトのコピーおよび貼付け

- コピーおよび貼付けのヒント

- メニューを使用したカタログ間でのオブジェクトのコピーおよび貼付け

- オブジェクトの貼付けの拡張オプション

- 貼付けによる上書き

- カタログ・オブジェクトの名前の変更

- カタログ・オブジェクトのプロパティの使用

- カタログ・オブジェクトの権限の設定

- カタログ・マネージャからのオブジェクトのプレビュー

- XMLでのカタログ・オブジェクトの表示と編集

- カタログ・マネージャを使用したカタログ・テキストの検索と置換

- 単純なカタログ・テキスト文字列の検索と置換

- 複数のカタログ・テキスト文字列の検索と置換について

- テキスト文字列の検索と置換のためのXMLファイル形式

- テキスト文字列の検索と置換のためのXMLファイルの例

- 複数のカタログ・テキスト文字列の検索と置換

- カタログ・マネージャを使用したカタログ・データを表示するためのレポートの作成

- レポートの使用方法の例

- カタログ・マネージャを使用したアーカイブとアンアーカイブ

- カタログ・マネージャを使用したフォルダのアーカイブ

- カタログ・マネージャを使用したフォルダのアンアーカイブ

第VI部 詳細な構成設定

17 分析とダッシュボードの構成および管理

- ダッシュボードの管理

- 分析の一般的な構成タスクの実行

- Excelへのエクスポートに役立つヒープ・サイズの増加

- エクスポートの手動による構成

- ネストされたフォルダ、ナビゲーションおよびドリルダウンのサポート

- ビュー内のデータの表示と処理の構成

- ビュー内のデータの手動による変更

- ピボット表とグラフのキューブ設定の手動による構成

- ビュー内のデータ設定の手動による構成

- 表ビュー、ピボット表ビューおよびトレリス・ビューのデータをフェッチするための設定の手動による構成

- グラフとゲージの手動による構成

- グラフのフォントの構成

- グラフおよびゲージのレンダリングの構成

- 交互する行の色の手動による変更

- ビュー内の相互作用の手動による構成

- プロンプトの構成

- 第18.4項「プレゼンテーション設定の手動による変更」

- プレゼンテーション設定のデフォルトの手動変更

- プレゼンテーション・サービスでのカスタム・リンクの提供

- customlinks.xmlファイルの更新

- CustomLinks要素の追加

- カスタム・リンク権限の設定

- ダッシュボード・ページへのリンクの作成機能の有効化

- Oracle BI Publisherの代替ツールバーの構成

- ダッシュボード・ページをOracle BI Publisherにエクスポートする機能の有効化

- ブリーフィング・ブックのPDFバージョンの目次の変更

- Smart Viewインストーラ用のカスタム・ダウンロード・リンクの構成

- アンサーでの分析のブロック

- JavaScriptファイルの保存

- 基準に基づく分析のブロック

- 式に基づく分析のブロック

- 検証ヘルパー関数

- 分析およびダッシュボードのデフォルト表示の指定

- デフォルト表示用のXMLメッセージ・ファイル

- 分析およびダッシュボードのデフォルト表示のカスタマイズ例

- 新しい分析へのデフォルトのヘッダーまたはフッターの追加

- 結果の自動プレビューの抑止

- 複合レイアウトの分析のデフォルトの設定

- ダッシュボード・セクションのデフォルトの変更

- ヘッダーおよびフッターを含むダッシュボード・ページのデフォルトの指定

- 分析およびダッシュボードでのライトバックの構成

- ライトバックの仕組み

- ライトバックの構成手順

- 例: ライトバックの構成手順

- ライトバックの制限

- ライトバック・テンプレート・ファイルの作成

- LightWriteback要素の設定

- Oracle BI Webユーザー・インタフェースのカスタマイズ

- スキンおよびスタイルとは

- Webユーザー・インタフェースのカスタマイズに関する一般的なヒント

- スタイルのカスタマイズについて

- プレゼンテーション・サービス用のユーザー・インタフェースのスタイルの変更

- 方法1: "bicustom.ear"ファイルの初回デプロイ

- 方法1: "bicustom.ear"ファイルの再デプロイ

- 方法2: 共有フォルダを使用したデプロイ

- 方法2: 共有フォルダに対する変更の表示

- スタイルのカスタマイズ

- Skyrosマスター・ブランディング・クラスの変更の例

- ダッシュボードでの外部コンテンツの埋込み

18 エージェントの構成および管理

- エージェントの使用方法

- ウイルス対策ソフトウェアおよび権限がエージェントに及ぼす影響

- エージェントに影響する設定の構成

- エージェントに影響するプレゼンテーション・サービス設定の手動による構成

- エージェントに影響するスケジューラの追加設定の手動による変更

- エージェントに影響するスケジューラの追加構成設定の内容

- エージェントに影響するスケジューラの一般構成設定

- エージェントに影響する、スケジューラの電子メール関連の構成設定

- エージェントのスケジューラ構成設定

- エージェントの配信オプションの制御

- エージェントのデバイス・タイプの管理

- アクティブなエージェント・セッションの監視

19 マッピングおよび空間情報の高度なオプションの構成

- MapViewerでのマップ・ビューのサポートの構成

- マップ・ビューの手動による構成

- マップ上へのテキストの挿入

- マップを外部で使用するための構成

20 リソースの可用性とURL生成の構成

第VII部「ライフサイクルの管理」

21 Oracle Business Intelligenceシステムへのパッチの適用

- Oracle Business Intelligenceシステムへのパッチの適用について

- Oracle Business Intelligenceプラットフォームに適用されるパッチの内容

- プラットフォームに適用したパッチのロールバック

- 現在のパッチ・レベルの判定

22 環境間のOracle Business Intelligenceの移動

- 環境間の移動

- 新しい環境への移動

- 11gから12cへのアップグレード

- サーバー全体の移行

23 Oracle Business Intelligenceシステムのバックアップとリカバリ

第VIII部 Oracle Business IntelligenceでのOracle Essbaseの使用

24 Oracle Business IntelligenceでのOracle Essbaseの使用の概要

- 概要

- Oracle Business IntelligenceでインストールされたEssbaseを使用するための上位レベルのロードマップ

- Oracle BI EEでインストールされたEssbaseのタスクの実行と、EPMでの同じタスクの実行との比較および、参照先ガイドについての情報

- Oracle Business IntelligenceでのEssbaseのインストール

- Essbaseのインストール

- インストール時のEssbaseスイート・オプションの選択

- EssbaseがOracle Business Intelligenceでインストールされた場合のクライアント・ツールの使用制限

- EssbaseがOracle Business Intelligenceでインストールされた場合にサポートされないEssbaseの機能

- Oracle Business IntelligenceでのEssbaseのセキュリティの構成

- Essbaseと関連ツールでのユーザーによる特定の操作の実行の有効化

- Oracle BI EE 12.2.1.xでのドリルスルー・レポートの有効化

- Essbaseフィルタを使用したデータレベル・セキュリティの構成

- Essbaseフィルタとは

- Essbaseフィルタのリソース権限定義の構成

- Essbaseフィルタでのデータ・アクセスの保護

- フィルタ・アクセス権限の付与の変更が使用済になる時点

- Oracle Business IntelligenceとEPMでのフィルタ権限の付与の相違点

- Essbase計算へのアクセスの構成

- Essbase計算とは

- Essbase計算のリソース権限定義の構成

- Essbase計算へのユーザーのアクセスの有効化

- Oracle Business IntelligenceでのEssbaseのポートの変更

- Essbaseのリソース権限リファレンス

- Essbaseに適用されるリソース・タイプ

- Essbaseに適用されるリソース名

- Essbaseに適用されるアクション

- Oracle Business IntelligenceでのEssbaseシステム管理

- Essbaseコンポーネントの起動と停止

- Oracle Business IntelligenceでのEssbaseコンポーネントの高可用性の維持

- Essbaseコンポーネントのロギングの構成

- ドメイン間でのEssbaseの構成の移行

- Essbaseメトリックの監視

- Essbaseのデータのバックアップとリカバリ

- Oracle Business IntelligenceでのEssbaseデータの使用

- Essbaseデータソースでのシングル・サインオンの有効化

- Essbaseがデータソースの場合の分析とレポートの作成、スケジューリングおよび実行

- Oracle BI EEによるSSLを介したEssbaseへの接続の有効化

- Essbaseの詳細情報

第IX部 参照情報

A 構成ファイル設定

- 構成ファイル

- NQSConfig.INIファイルの構成設定

- NQSConfig.INIファイルのパラメータについて

- NQSConfig.INIのパラメータの更新方法

- Repositoryセクションのパラメータ

- Multitenancyセクションのパラメータ

- MT_ROOT_DIRECTORY

- MT_ENTRIES

- Query Result Cacheセクションのパラメータ

- ENABLE

- DATA_STORAGE_PATHS

- MAX_ROWS_PER_CACHE_ENTRY

- MAX_CACHE_ENTRY_SIZE

- MAX_CACHE_ENTRIES

- POPULATE_AGGREGATE_ROLLUP_HITS

- USE_ADVANCED_HIT_DETECTION

- 問合せがキャッシュに追加されない理由

- MAX_SUBEXPR_SEARCH_DEPTH

- DISABLE_SUBREQUEST_CACHING

- CACHE_FILE_BUFFER_SIZE

- GLOBAL_CACHE_STORAGE_PATH

- MAX_GLOBAL_CACHE_ENTRIES

- CACHE_POLL_SECONDS

- CLUSTER_AWARE_CACHE_LOGGING

- Generalセクションのパラメータ

- LOCALE

- SORT_ORDER_LOCALE

- UNIXオペレーティング・システムでのSORT_ORDER_LOCALE

- SORT_TYPE

- CASE_SENSITIVE_CHARACTER_COMPARISON

- NULL_VALUES_SORT_FIRST

- DATE_TIME_DISPLAY_FORMAT

- 日時表示書式の使用方法

- DATE_DISPLAY_FORMAT

- TIME_DISPLAY_FORMAT

- WORK_DIRECTORY_PATHS

- WORK_FILE_COMPRESSION_LEVEL

- ENABLE_COLUMNAR_STORAGE_FOR_WORK_FILE

- WORK_DIRECTORY_SIZE_GLOBAL_LIMIT

- MAX_WORK_FILE_SIZE_PERCENT

- VIRTUAL_TABLE_PAGE_SIZE

- USE_LONG_MONTH_NAMES

- MEMORY_COMPACT_PERIOD_IN_SECONDS

- USE_LONG_DAY_NAMES

- USE_UPPERCASE_MONTH_NAMES

- USE_UPPERCASE_DAY_NAMES

- UPPERCASE_USERNAME_FOR_INITBLOCK

- Securityセクションのパラメータ

- DEFAULT_PRIVILEGES

- PROJECT_INACCESSIBLE_COLUMN_AS_NULL

- IGNORE_LDAP_PWD_EXPIRY_WARNING

- MAX_AUTHENTICATION_TIME

- INIT_BLOCK_LOG_TIME_THRESHOLD

- NUM_INIT_BLOCK_THREADS_PER_USER

- SSL

- SSL_CERTIFICATE_FILE

- SSL_PRIVATE_KEY_FILE

- SSL_PK_PASSPHRASE_FILE

- SSL_PK_PASSPHRASE_PROGRAM

- SSL_VERIFY_PEER

- SSL_VERIFY_SERVERS

- SSL_VERIFY_CLIENTS

- SSL_CA_CERTIFICATE_DIR

- SSL_CA_CERTIFICATE_FILE

- SSL_TRUSTED_PEER_DNS

- SSL_INTERNAL_CA_CERTIFICATE_FILE

- SSL_INTERNAL_TRUSTED_PEER_DNS

- SSL_WEBSERVER_CA_CERTIFICATE_FILE

- SSL_WEBSERVER_TRUSTED_PEER_DNS

- SSL_CERT_VERIFICATION_DEPTH

- SSL_CIPHER_LIST

- Serverセクションのパラメータ

- READ_ONLY_MODE

- MAX_SESSION_LIMIT

- MAX_SESSION_LIMITおよびSERVER_THREAD_RANGEパラメータについて

- MAX_REQUEST_PER_SESSION_LIMIT

- SERVER_THREAD_RANGE

- SERVER_THREAD_STACK_SIZE

- DB_GATEWAY_THREAD_RANGE

- DB_GATEWAY_THREAD_STACK_SIZE

- HTTP_CLIENT_THREAD_RANGE

- HTTP_CLIENT_THREAD_STACK_SIZE

- MAX_EXPANDED_SUBQUERY_PREDICATES

- MAX_QUERY_PLAN_CACHE_ENTRIES

- MAX_QUERY_PLAN_CACHE_ENTRY_SIZE

- MAX_DRILLDOWN_INFO_CACHE_ENTRIES

- MAX_DRILLDOWN_QUERY_CACHE_ENTRIES

- INIT_BLOCK_CACHE_ENTRIES

- CLIENT_MGMT_THREADS_MAX

- DEFAULT_JOBQUEUE_SIZE_PER_THREAD

- MAX_COLUMNS_IN_SELECT

- MAX_LOGICAL_DIMENSION_TABLES

- MAX_LOGICAL_FACT_TABLES

- MAX_LOGICAL_MEASURES

- MAX_SET_OPERATION_BLOCKS

- QUERY_LIMIT_WARNING_INSTEAD_OF_ERROR

- RPC_SERVICE_OR_PORT

- LISTEN_ADDRESS

- LISTEN_PORT

- ENABLE_DB_HINTS

- PREVENT_DIVIDE_BY_ZERO

- CLUSTER_PARTICIPANT

- REPOSITORY_PUBLISHING_DIRECTORY

- REQUIRE_PUBLISHING_DIRECTORY

- DISCONNECTED

- AUTOMATIC_RESTART

- VARIABLE_VALUE_LIMIT

- EVALUATE_SUPPORT_LEVEL

- FMW_SECURITY_SERVICE_URL

- FMW_SECURITY_SERVICE_MAX_NUMBER_OF_CONNECTIONS

- FMW_SECURITY_SERVICE_MAX_NUMBER_OF_RETRIES

- ENABLE_NUMERIC_DATA_TYPE

- ENDECA_SERVLET_URL

- 高可用性パラメータ

- HA_DB_PING_PERIOD_MILLISECS

- Dynamic Libraryセクションのパラメータ

- Usage Trackingセクションのパラメータ

- ENABLE

- DIRECT_INSERT

- STORAGE_DIRECTORY

- CHECKPOINT_INTERVAL_MINUTES

- FILE_ROLLOVER_INTERVAL_MINUTES

- CODE_PAGE

- PHYSICAL_TABLE_NAME

- CONNECTION_POOL

- INIT_BLOCK_TABLE_NAME

- INIT_BLOCK_CONNECTION_POOL

- BUFFER_SIZE

- BUFFER_TIME_LIMIT_SECONDS

- NUM_INSERT_THREADS

- MAX_INSERTS_PER_TRANSACTION

- JOBQUEUE_SIZE_PER_INSERT_THREADPOOL_THREAD

- THROW_INSERT_WHEN_JOBQUEUE_FULL

- SUMMARY_STATISTICS_LOGGING

- SUMMARY_ADVISOR_TABLE_NAME

- Query Optimization Flagsセクションのパラメータ

- STRONG_DATETIME_TYPE_CHECKING

- MDX Member Name Cacheセクションのパラメータ

- ENABLE

- DATA_STORAGE_PATH

- MAX_SIZE_PER_USER

- MAX_MEMBER_PER_LEVEL

- MAX_CACHE_SIZE

- Aggregate Persistenceセクションのパラメータ

- AGGREGATE_PREFIX

- AGGREGATE_THREAD_POOL_SIZE

- AGGREGATE_AW_NAME

- PREAGGREGATE_AW_CUBE

- SUPPORT_ANALYTICAL_WORKSPACE_TARGETS

- JavaHostセクションのパラメータ

- JAVAHOST_HOSTNAME_OR_IP_ADDRESSES

- JAVAHOST_HOSTNAME_OR_IP_ADDRESSES_OVERRIDE

- Datamart Automationセクションのパラメータ

- ESSBASE_SERVER

- DMA_DATABASE

B 拡張構成リファレンス

- プレゼンテーション・サービスに対する拡張構成の変更

- Oracle BI EEのページの攻撃からの保護

- Oracle BIプレゼンテーション・サービスに対するJavaHostサービスの使用

C ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピング

D BI固有のWLSTコマンド・リファレンス

はじめに

Oracle Business Intelligence Foundation Suiteは、総合的でオープンな統合型ソリューションで、報告、非定型の問合せ、OLAP、ダッシュボード、スコアカード、What-If分析など、エンタープライズ・ビジネス・インテリジェンスのニーズすべてに対応しています。Oracle Business Intelligence Foundation Suiteには、Oracle BI Suiteが含まれます。

Oracle BI Suite (Oracle BI EE)は包括的な一連のエンタープライズ・ビジネス・インテリジェンス・ツールおよびインフラストラクチャであり、拡張性のある効率的な問合せおよび分析サーバー、非定型の問合せおよび分析ツール、インタラクティブ・ダッシュボード、プロアクティブ・インテリジェンスとアラート、エンタープライズ・レポート・エンジンなどが含まれます。

Oracle BI EEのコンポーネントは、共通のサービス指向アーキテクチャ、データ・アクセス・サービス、分析および計算インフラストラクチャ、メタデータ管理サービス、意味的ビジネス・モデル、セキュリティ・モデルやユーザー・プリファレンスおよび管理ツールを共有します。Oracle BI EEは、各データ・ソース向けに最適化されたリクエスト生成、最適化されたデータ・アクセス、高度な計算、インテリジェント・キャッシュ・サービス、クラスタリングにより、スケーラビリティとパフォーマンスを提供します。

このガイドには、システム管理者のタスクに関する情報が記載されており、プロセスの起動と停止、ロギング管理と使用状況トラッキング、問合せキャッシングとパフォーマンスの管理、スケーラビリティと高可用性の管理および構成オプションの設定に関するトピックが含まれています。

対象読者

このドキュメントは、Oracle Business Intelligenceのプロセス、ロギング、キャッシング、監視、高可用性および構成の管理を担当するシステム管理者を対象としています。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

サポートを購入したオラクル社のお客様は、My Oracle Supportを介して電子的なサポートにアクセスできます。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

関連ドキュメントとその他のリソース

システムとそれに関連するタスク、ソフトウェアおよび情報についてさらに学習します。

関連するOracle Business Intelligenceのドキュメントのリストは、Oracle Business Intelligenceのドキュメント・ライブラリを参照してください。

さらに、次もあります。

- Oracle Business Intelligenceに関連するオンライン・トレーニングのリソースについては、Oracle Learning Libraryを参照してください。

- 製品情報センターに関するサポート・ノート(記事ID: 1267009.1)をMy Oracle Support(https://support.oracle.com)でアクセスしてください。

表記規則

このマニュアルでは次の表記規則を使用します。

表記規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

斜体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

Oracle Business Intelligenceシステム管理者向けの新機能

この項では、Oracle Business Intelligence Enterprise Edition 12c (12.2.1)のシステム管理機能の変更について説明します。

この項では、次の項目について説明します。

- Oracle BI EE 12 c (12.2.1.2.0)の新機能および変更点

- Oracle BI EE 12c (12.2.1.1.0)の新機能および変更点

- Oracle BI EE 12c (12.2.1.0)の新機能および変更点

Oracle BI EE 12 c (12.2.1.2.0)の新機能および変更点

Oracle BI EE 12c (12.2.1.2).におけるシステム管理の新機能および変更点は、次のとおりです。

このリリースには新機能はありません。

Oracle BI EE 12c (12.2.1.1.0)の新機能および変更点

Oracle BI EE 12c (12.2.1.1)におけるシステム管理の新機能および変更点は、次のとおりです。

このリリースには新機能はありません。

Oracle BI EE 12c (12.2.1.0)の新機能および変更点

Oracle BI EE 12c (12.2.1.0)におけるシステム管理の新機能および変更点は、次のとおりです。

Oracle BI EE 11g (11.1.1.9)からOracle BI EE 12c (12.2.1.0)にアップグレードする場合、機能、ツール、手順などに大きな違いがあるため、次の情報をよく読んでください。Oracle BI EE 12cへのアップグレードの詳細は、Oracle Business Intelligence移行ガイドを参照してください。

これらの機能および変更は、次のとおりです。

- 単一の場所からのWLSTの呼出し

- Oracleホームの場所が再定義され、ミドルウェア・ホームはありません

- OPMNはFusion Middlewareでは使用されなくなりました

- Oracle Web CacheはFusion Middlewareの一部ではなくなりました

- テストから本番への移動が異なる方法で実行されます

- プロセス制御の新しいコマンド

- Business Intelligenceアーカイブ・ファイルのメタデータの管理

- 単一のエンタープライズ・インストール

- スケール・アウトの変更

- 構成の簡略化

- コマンドを使用したシステム・コンポーネント・インスタンスの管理

- 診断バンドルの収集

単一の場所からのWLSTの呼出し

以前のリリースでは、Oracle WebLogic Server、システム・コンポーネントまたはJavaコンポーネント(Oracle SOA Suiteなど)のどれに対してコマンドを使用しているかに応じて異なる場所からWLSTを呼び出していました。このリリースでは、次の場所からWLSTを起動します。

(UNIX) ORACLE_HOME/oracle_common/common/bin/wlst.sh
(Windows) ORACLE_HOME\oracle_common\common\bin\wlst.cmd

「WLST (WebLogic Scripting Tool)の使用」を参照してください。

Oracleホームの場所が再定義され、ミドルウェア・ホームはありません

Oracleホームが再定義され、ミドルウェア・ホームがなくなりました。『Oracle Fusion Middlewareの理解』の12 cの新規用語および非推奨用語に関する項を参照してください。

OPMNはFusion Middlewareでは使用されなくなりました

OPMNは、Oracle Fusion Middlewareでは使用されなくなりました。かわりに、システム・コンポーネントはWLST、ノード・マネージャおよび圧縮と圧縮解除などのWebLogic管理フレームワークにより管理されます。『Oracle Fusion Middlewareの理解』のWebLogic Management Frameworkに関する項を参照してください。

Oracle Web CacheはFusion Middlewareの一部ではなくなりました

Oracle Web CacheはOracle Fusion Middlewareの一部ではなくなりました。

テストから本番への移動が異なる方法で実行されます

テストから本番への操作が引き続き可能ですが、メタデータ(コンテンツ、データ・モデルおよび認可)にのみ適用されるため、プロセスがOracle Business Intelligenceリリース1 (11.1.1)と異なります。「環境間のOracle Business Intelligenceの移動」を参照してください。

プロセス制御の新しいコマンド

新しいプロセス制御コマンドは、古い起動/停止コマンドを置き換えます。「プロセス制御コマンド」を参照してください。

Business Intelligenceアーカイブ・ファイルのメタデータの管理

リポジトリを含むすべてのOracle Business Intelligenceメタデータ、プレゼンテーション・サービス・カタログおよびユーザー認証は、BARアーカイブ・ファイルに格納されます。BARファイルは、環境間の自己完結セットのOracle BIメタデータを管理または移動するメカニズムです。「メタデータの管理およびサービス・インスタンスの操作」を参照してください。

単一のエンタープライズ・インストール

このリリースでは、Oracle Universal Installerは、管理サーバーおよび管理対象サーバーを提供するEnterpriseの単一インストール・タイプを提供します。「システムの論理アーキテクチャとは」および『Oracle Business Intelligenceのインストールと構成』を参照してください。

スケール・アウトの変更

このリリースでは、Oracle Business Intelligenceのスケール・アウト手順が変更されました。「デプロイメントのスケーリング」を参照してください。

構成の簡略化

構成ファイルが重複しなくなりました。Oracle BIプレゼンテーション・サービスおよびBIサーバーなどに個別の構成ファイルが引き続き存在しますが、クラスタの場合に重複しません。「Oracle Business Intelligenceシステム設定の構成」を参照してください。

コマンドを使用したシステム・コンポーネント・インスタンスの管理

OBIS(BIサーバー)システム・コンポーネント・インスタンスは、サービス・インスタンス・コマンドを使用してBI 12.2.1で個別に管理されます。「サービス・インスタンスの管理」を参照してください。

診断バンドルの収集

新しいスクリプトにより、問題を解決するためにOracleサポートまたは開発が必要とする診断バンドルを収集できます。「診断バンドルの収集」を参照してください。

中間層データベース接続詳細の同期コマンド

新しいコマンドにより、変更された場合に中間層データベース接続詳細を同期できます。「BI固有のWLSTコマンド・リファレンス」を参照してください。

第I部 Oracle Business Intelligenceの管理

この部は、Oracle Business Intelligenceシステムの管理について説明します。

- Oracle Business Intelligenceのシステム管理の概要

1 Oracle Business Intelligenceのシステム管理の概要

ここでは、Oracle Business Intelligenceのシステム管理について、システム管理者の作業内容、一般的なシステム管理タスクの手順、およびOracle Business Intelligenceのアーキテクチャについて説明するとともに、システム管理タスクの完了に役立つツールのリスト、およびシステム要件と認証情報に関するリンクを示します。

この章の内容は次のとおりです。

- Oracle Business Intelligenceのシステム管理タスク

- Oracle Business Intelligenceの管理について

- システムの論理アーキテクチャとは

- Oracle Business Intelligenceの主なディレクトリ

- Oracle Business Intelligenceを管理するシステム管理ツール

- サンプル・アプリケーションでの作業

- Oracle BI Publisherの統合

- その他のガイド内の関連トピック

- システム要件と動作保証

Oracle Business Intelligenceのシステム管理タスク

システム管理者は、Oracle Business Intelligenceを適切に構成するためにいくつかの手順を行う必要があります。

Oracle Business Intelligenceシステムを管理するためのタスクは、次のとおりです。

- インストール後のデプロイメントに対するシステムの構成
メタデータとコンテンツ、一般的な作業環境、およびデフォルトのシステム設定を構成します。

- 必要に応じたシステムの起動と停止
システムのメンテナンス・タスクの実行時にシステムを起動および停止します。

- セキュリティの構成
Oracle Business Intelligenceシステム、メタデータ、およびデータへの安全なアクセスを確保し、Secure Sockets Layer (SSL)およびSingle Sign-On (SSO)を構成して、ID管理システムとの統合を設定します。

- 高可用性を実現するためのスケールアウトと構成
一直線のスケールアウトのためにOracle Business Intelligenceシステムを構成し(マシンにコンポーネントを増やしてキャパシティを増加)、単一点障害を識別および(マシンを追加することで)除去します。

- パフォーマンスおよび可用性の管理
サービス・レベルを監視してパフォーマンスをチューニングします。

- 問題の管理および解決
エラーを診断して解決策を確立します。

- システムのテスト環境から本番環境への移行
テスト環境から本番環境への移行の手順を管理します。

- データのバックアップとリカバリ
予期しないイベントに対する準備を行い、そこから回復させます。

「Oracle Business Intelligenceの管理について」を参照してください。

Oracle Business Intelligenceの管理について

この項の情報を参照して完了すべきタスクを特定し、該当するリンクをクリックして、目的の内容を表示してください。

次の表は、Oracle Business Intelligenceで実行する一般的なシステム管理タスクと、その関連情報の記載先を示しています。

システム管理タスク

詳細の参照先

Oracle Business Intelligenceのシステム管理の概要

この項の内容を参照してください。

システム・アーキテクチャ、コンポーネント、ツール、他の関連トピックへのリンク、および動作保証に関する情報が記載されています。

Oracle Business Intelligenceのステータスの表示

Fusion Middleware ControlのOracle Business Intelligenceページの表示

Fusion Middleware ControlおよびWebLogic Server管理コンソールの使用方法も記載されています。

Oracle Business Intelligenceの構成

Oracle Business Intelligenceシステム設定の構成

構成設定の更新に使用できる方法と、構成ファイルの格納場所に関する情報が記載されています。

Oracle Business Intelligenceの起動と停止

Oracle Business Intelligenceプロセスの管理

コンポーネントの起動と停止、およびトラブルシューティング情報に関する様々なトピックが記載されています。

可用性および容量の管理

高可用性とパフォーマンスのためのスケーリングおよびデプロイ

環境のスケーリング、高可用性を実現するためのデプロイ、パフォーマンス・チューニング、および問合せキャッシュに関する章が含まれています。

問題の診断および解決

問題の解決

問題の診断と解決、および使用状況の追跡に関する章が含まれています。

Oracle Business Intelligenceの構成

Oracle Business Intelligenceの構成

リポジトリや外部システムへの接続の構成など、必要な構成に関する章が含まれています。

構成の拡張設定の変更

詳細な構成設定

分析、ダッシュボード、マップなどの機能の構成について、その拡張設定とオプション設定に関する章が含まれています。

Oracle BIスケジューラの構成

Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイド

ライフサイクルの管理

ライフサイクルの管理

パッチの適用、環境間の移動、バックアップおよびリカバリなど、ライフサイクル管理タスクに関する章が含まれています。

Oracle Business IntelligenceでのEssbaseの使用

Oracle Business IntelligenceでのOracle Essbaseの使用

Oracle Business Intelligenceとともにインストールされた場合のEssbaseの使用についての章が含まれています。

システムの保護

- 管理ロールのメンバーシップの定義
Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド

- 中間層での通信の保護
このガイドでは、Secure Sockets Layer(SSL)およびSingle Sign-On(SSO)については記載していません。詳細は、『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』を参照してください。

システムの論理アーキテクチャとは

Oracle Business Intelligenceシステムの論理アーキテクチャは、Oracle BIドメインと呼ばれる複数の管理可能なコンポーネントを統合した単一のセットで構成されています。この一連のOracle BIドメインは、単一のホスト上にインストールして連携して機能するように構成することも、パフォーマンスや可用性を考慮して複数のホストにクラスタ化することも可能です。

注意:
Oracle HTTP ServerやApache HTTP ServerなどのWebサーバーをOracle Business Intelligenceとともに使用することで、本番システムのパフォーマンスを強化できます。WebサーバーはデフォルトでOracle Business Intelligenceインストーラに含まれておらず、Oracle Business Intelligenceシステムの論理アーキテクチャの一部でもありません。Webサーバーは個別にインストールして構成する必要があります。

この項では、次の項目について説明します。

- Oracle Business Intelligenceのシステム・アーキテクチャ

- Oracle Business Intelligenceコンポーネント

- 管理サーバー、管理対象サーバーおよびシステム・コンポーネントについて

Oracle Business Intelligenceのシステム・アーキテクチャ

単一ホスト上にOracle Business Intelligenceをインストールしますが、追加のコンピュータに後でスケール・アウトできます。

「デプロイメントのスケーリング」を参照してください。

次の図は、単一ホスト上にインストールされたOracle Business Intelligenceのシステム・アーキテクチャを示しています。詳細は、「Oracle Business Intelligenceコンポーネント」を参照してください。

Oracle Business Intelligenceは単一ホスト上にインストールされますが、複数のホストにスケール・アウトできます。Javaコンポーネント(WebLogic Serverドメイン)とシステム・コンポーネントが、単一のBIドメインの一部として各ホストにクラスタ化されています。どちらのホストにも管理サーバーが存在しますが、1つのホストのみでアクティブになります。

Oracle Business Intelligenceコンポーネント

Oracle Business Intelligenceをインストールする場合、ホストのOracle BIドメインにいくつかのコンポーネントをインストールできます。

BIドメインは、単一のWebLogic Serverドメイン内の1つ以上のJava EE(JEE)コンテナにデプロイされるJavaコンポーネント、(非JEE)システム・コンポーネントとプロセス、および必要な構成ファイル、メタデータ・リポジトリおよびインフラストラクチャで構成されます。

- 管理サーバー - システムを管理するためのJavaコンポーネントが含まれる、専用のJava仮想マシンで実行されるJEEコンテナとしてデプロイされます。これらのコンポーネントには、Oracle WebLogic Server管理コンソール、Oracle Fusion Middleware ControlおよびJMX MBeanがあります。

- 管理対象サーバー - システム内でJavaベースのサービスおよびアプリケーションに実行時環境を提供する、専用のJava仮想マシンで実行されるJEEコンテナとしてデプロイされます。これらのサービスおよびアプリケーションには、Oracle BI Publisher、Visual Analyzer、プレゼンテーション・サービスおよびコンポーザが含まれます。
Oracle BIドメインには、1つ以上のホスト・コンピュータにわたって配信される1つ以上の管理対象サーバーが含まれます。

- ノード・マネージャ - 管理サーバー、管理対象サーバーのプロセスおよびシステム・コンポーネントに対するプロセス管理サービスを提供します。
『Oracle WebLogic Serverノード・マネージャの管理』のノード・マネージャの概要に関する項を参照してください。

- システム・コンポーネント - サーバー・プロセスとしてデプロイされ、Oracle Business Intelligenceを有効にするコア・サービスを提供します。
詳細は、「管理サーバー、管理対象サーバーおよびシステム・コンポーネントについて」を参照してください。システム・プロセスの制御の詳細は、プロセス制御コマンドを参照してください。

- その他のドメイン・コンテンツ - 必要なすべてのソフトウェア、構成ファイル、メタデータ、WLSTコマンド、セキュリティおよびOracle Business Intelligenceシステムを実行するために必要な接続およびデータベース構成情報が含まれます。
詳細は、次を参照してください。

- セキュリティの構成 - Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドを参照してください。

- メタデータ - メタデータの管理およびサービス・インスタンスの操作およびOracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

管理サーバー、管理対象サーバーおよびシステム・コンポーネントについて

Oracle Business Intelligenceには、管理サーバー、管理対象サーバーおよびこの項に示されているシステム・コンポーネントが含まれます。

『Oracle Fusion Middlewareの管理』の「Oracle Fusion Middlewareの管理のスタート・ガイド」を参照してください。

Oracle Business Intelligenceとともにインストールされた場合のEssbaseに関する詳細は、「Oracle Business Intelligenceを管理するシステム管理ツール」を参照してください。

管理サーバーおよび管理対象サーバーについて

管理サーバーおよび管理対象サーバーは、1つ以上のJava EEアプリケーションとしてデプロイされた、次のリストに示すJavaコンポーネントです。

- 管理サーバー — 次を使用して、単一ノードまたは複数ノード(分散型)のBIドメインのOracle Business Intelligenceの構成およびランタイム設定を管理します。

- Fusion Middleware Control - BIドメインの管理に使用する管理ユーザー・インタフェースです。

- WebLogic Server管理コンソール - WebLogic、JEEコンポーネントおよびセキュリティをより詳細に管理するための管理ユーザー・インタフェースです。

詳細は、「Oracle Business Intelligenceを管理するシステム管理ツール」を参照してください。

- 管理対象サーバー — 次のコンポーネントを管理します。

- アクション・サービス - Action Frameworkに必要な専用のWebサービスを提供します。これにより、管理者は、ユーザーがアクションを作成する際に参照するWebサービス・ディレクトリを手動で構成できるようになります。

- Visual Analyzer — 使いやすい視覚的な分析インタフェースを提供します。

- BI Publisher - 従業員、顧客および仕入先に向けてあらゆるタイプの高度にフォーマットされたドキュメントを作成、管理および配布するエンタープライズ・レポート・ソリューションを提供します。

- Security - Oracle BIサーバーとOracle Fusion Middlewareセキュリティ・プラットフォームの統合を実現する専用のWebサービスを提供します。

- SOA Webサービス - 分析、エージェントおよび条件を起動するための、Oracle BIプレゼンテーション・カタログのオブジェクト専用のWebサービスを提供します。これらのサービスにより、Oracle Business Intelligenceの機能をBusiness Process Execution Language (BPEL)プロセスから簡単に起動できるようになります。

- プレゼンテーション・サービス - HTTPリクエストおよびSOAPリクエストをOracle BIプレゼンテーション・サービスにルーティングするJEEアプリケーションです。

システム・コンポーネントについて

システム・コンポーネントは、C++やJ2SEで記述されたプロセスおよびサービスなどの非JEEコンポーネントとしてデプロイされます。詳細は次のとおりです。

- BIサーバー (OBIS) - Oracle Business Intelligenceの中核となる問合せ機能およびデータ・アクセス機能を提供するとともに、エンタープライズ・セマンティック・モデル(.RPDファイルに格納される)にアクセスして管理するサービスを提供します。

- BIスケジューラ(OBISCH) - 指定された時間に分析をユーザーへ配信するための拡張可能なスケジューリング機能を提供します(Oracle BI Publisherには独自のスケジューラが搭載されています)。

- BI JavaHost (OBIJH) - Oracle BIスケジューラ、Oracle BI Publisherおよびグラフ生成におけるJavaタスクなど、様々なコンポーネントのOracle BIプレゼンテーション・サービスでのサポートを可能にするコンポーネント・サービスを提供します。Oracle BIサーバー問合せにより、Hyperion Financial ManagementデータソースおよびHyperion Planningデータソースにアクセスできます。

- BIプレゼンテーション・サーバー(OBIPS) - ビジネス・インテリジェンス・データのWebクライアントへのプレゼンテーション用のフレームワークとインタフェースを提供します。このプレゼンテーション・フレームワークのカスタマイズ用に、ファイル・システム上にOracle BIプレゼンテーション・カタログ・サービスが保持されています。

- クラスタ・コントローラ(OBICCS) - リクエストがBIドメイン内のBIサーバー・プロセス・インスタンス全体で均等に分散されていることを確認しながら、リクエストをBIサーバーに配信します。

Oracle Business Intelligenceの主なディレクトリ

Oracle Business Intelligence 12cでは、次の3つの主な最上位レベルのディレクトリがあります。

- ORACLE_HOME - バイナリ用。
各ホストに1つのORACLE_HOMEが存在するか、共有記憶域からマウントされます。

- DOMAIN_HOME - 構成用およびログ。
ホストごとに1つのDOMAIN_HOMEがあります(BI_DOMAINまたはbidomainとも呼ばれます)。

- SDD(シングルトン・データ・ディレクトリ) - メタデータおよび他のクラスタ間ファイル用。
ドメインごとに1つのSDDがあります。

SDDパス(デフォルトはDOMAIN_HOME/bidata)は、次のbi-environment.xmlファイルで定義されます。

DOMAIN_HOME/config/fmwconfig/bienv/core/bi-environment.xml

注意:

1つのホストにドメインを作成した場合、SDDはDOMAIN_HOME/bidataに設定されます。

スケールアウトした場合、マウントされた共有記憶域を使用するためにSDDが変更されます。この場合、SDDはDOMAIN_HOME/bidataではありません。

「シングルトン・データ・ディレクトリ(SDD)の変更」を参照してください。

Oracle Business Intelligenceを管理するシステム管理ツール

Oracle Business Intelligenceの管理に使用できるいくつかのツールがあります。

この項では、Oracle Business Intelligenceの管理に使用できるシステム管理ツールについて説明しています。次の表はツールとその用途の概要です。

ツール

用途

詳細の参照先

Fusion Middleware Control

Oracle Business Intelligenceのシステム・コンポーネントの監視、管理および構成。

Fusion Middleware Control

Oracle WebLogic Server管理コンソール

Oracle Business IntelligenceのJEE Javaコンポーネントの監視および管理。

Oracle WebLogic Server管理コンソール

プロセス制御コマンドライン・ツール

Oracle Business Intelligenceのシステム・コンポーネントの管理(上級ユーザー向け)。

プロセス制御コマンド

Oracle WebLogic Scripting Tool (WLST)

Oracle Business Intelligenceのプログラム的な管理機能。

Oracle WebLogic Scripting Tool(WLST)

Oracle BI管理ツール

Oracle Business Intelligenceのメタデータ・リポジトリの管理。

Oracle BI管理ツール

カタログ・マネージャ

Oracle BIプレゼンテーション・カタログをオンラインおよびオフラインで管理します。

カタログ・マネージャ

ジョブ・マネージャ

Oracle BIスケジューラの管理。

ジョブ・マネージャ

Fusion Middleware Control

Fusion Middleware Controlはブラウザベースのツールであり、Oracle Business Intelligenceコンポーネントの監視、管理および構成に使用することをお薦めします。

Fusion Middleware Controlは、主にBIドメインのシステム・コンポーネントの管理に使用され、次の機能を備えています。

- システム・コンポーネントの起動、停止および再起動。

- プリファレンスとデフォルトの構成

- スケールアウトしたコンポーネントのステータスの表示。

- パフォーマンスの管理とシステム・メトリックの監視

- 診断とロギングの実行

Fusion Middleware Controlでは、Oracle WebLogic Server管理コンソールにアクセスして、Oracle Business IntelligenceのJavaコンポーネントを監視および管理することもできます。

Fusion Middleware Controlは、「Oracle Business Intelligenceシステムを起動する条件」で説明しているように、管理サーバーが稼働している場合にのみ使用できます。

「Oracle Business Intelligenceを管理および構成するためのツールの使用」を参照してください。

Oracle WebLogic Server管理コンソール

Oracle WebLogic Serverは、堅牢性、安全性、高可用性およびスケーラビリティに優れた環境へのOracle Business Intelligence JavaコンポーネントのデプロイをサポートするJava EEアプリケーション・サーバーです。

「Oracle Business Intelligenceを管理および構成するためのツールの使用」を参照してください。

Oracle WebLogic Server管理コンソールを使用して、WebLogic Serverドメインを監視および管理できます。その機能は次のとおりです。

- JEEサーバーの稼動状況とパフォーマンスの監視

- WebLogic Serverドメインの構成

- JEEサーバーの停止と起動

- JEEサーバーのログの表示

- Oracle WebLogic ServerのLDAPサーバーにおけるユーザー移入の管理

Oracle Technology Network (http://www.oracle.com/technetwork/index.html)を参照してください。

プロセス制御コマンド

プロセス制御コマンドにより、Oracle Business Intelligenceシステム・コンポーネントを管理し、ローカルと分散の両方のプロセス管理およびプロセスの状態(稼働、停止、起動中、停止中)の伝達をサポートできます。

注意:

また、Fusion Middleware Controlユーザー・インタフェースを使用して、起動、停止およびシステム・コンポーネントのステータスを表示します。

プロセス制御コマンドは、次の機能を提供してOracle Business Intelligenceシステム・コンポーネントを管理します。

- Oracle Fusion Middlewareコンポーネントを制御するための上級ユーザー向けのコマンドライン・インタフェース。
詳細は、「コマンドを使用した起動、停止およびOracle BI EEプロセスのステータスの表示」を参照してください。

- Oracle Business Intelligenceコンポーネント・プロセスを管理する統合された方法。

Oracle WebLogic Scripting Tool (WLST)

Oracle WebLogic Scripting Tool (WLST)は、Oracle Business Intelligenceのプログラム的な管理を可能にする上級管理者向けのコマンドライン・スクリプト環境です。

WLSTスクリプト環境は、Javaのスクリプト・インタプリタであるJythonに基づいています。このツールは、ファイルで提供されるバッチ・スクリプト(ユーザーの入力なしでスクリプトが一連のWLSTコマンドを呼び出すスクリプト・モード)において、コマンドラインで対話的に実行できます。また、Javaコードに組み込むことも可能です。Jython言語構文に従って、WebLogicスクリプト言語を拡張できます。詳細は、WebLogic Scripting Tool (WLST)の使用およびWebLogic Server WLSTコマンド・リファレンスを参照してください。

Oracle BI管理ツール

Oracle BI管理ツールにより、メタデータ・リポジトリを管理できます。

詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

カタログ・マネージャ

カタログ・マネージャは、Oracle BIプレゼンテーション・カタログのインタフェースであるWindowsツールです。

カタログ・マネージャを介して、Oracle BIプレゼンテーション・カタログのオンラインおよびオフラインの管理を実行できます。詳細は、「Oracle BIプレゼンテーション・カタログの構成および管理」を参照してください。

ジョブ・マネージャ

ジョブ・マネージャは、Oracle BIスケジューラのインタフェースとして機能するWindowsのツールです。

ジョブ・マネージャを使用して、Oracle BIスケジューラへの接続、Oracle BIスケジューラの起動と停止、ジョブの追加と管理、およびジョブ・インスタンスの管理を実行できます。詳細は、Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイドを参照してください。

サンプル・アプリケーションでの作業

サンプル・アプリケーションを使用すると、ライブ・シナリオに昇格させる前に、構成および手順をテストできます。

簡易化されたサンプル・アプリケーションでOracle Business Intelligenceを構成できます。このアプリケーションは、通常、SampleApp Liteと呼ばれています。

サンプル・アプリケーションをダウンロードして、さらに強固に構成することもできます。この構成に関する手順は、次の場所で入手できます。

http://www.oracle.com/technetwork/middleware/bi-foundation/obiee-samples-167534.html

Oracle Business Intelligenceで提供されるサンプル・リポジトリの詳細は、『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のSampleAppデモ・リポジトリに関する項を参照してください。

Oracle BI Publisherの統合

このガイドでは、Oracle BI EEおよびBI Publisherがインストールされ、組織に完全に統合されたコンポーネントとして実行されるよう構成されていることが前提となっています。そうではない場合は、このガイドのBI Publisherに関する記述が該当しない可能性があります。

BI Publisherの実行の詳細は、Oracle Business Intelligence Publisherユーザーズ・ガイドを参照してください。

他のガイド内の関連トピック

システム管理者に関連するトピックが、他のガイドでもいくつか取り上げられています。

次の表にこれらのトピックをリストし、詳細の参照先を示します。

トピック

詳細の参照先

サード・パーティ・ツールとリレーショナル・データソース・アダプタ

システム要件と動作保証

Oracle BIスケジューラの構成タスク

Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイド

データソースの構成

Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド

SSOやSSLの構成を含むセキュリティの設定

Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド

インストールとアップグレード

Oracle Business Intelligenceのインストールと構成

Oracle Business Intelligenceアップグレード・ガイド

Oracle Scorecardと戦略管理におけるコメントとステータスのオーバーライドの構成

Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド

Oracle Business Intelligence専用メタデータのXMLファイルへの変換とメタデータのOracleデータベースへのインポート。

Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド

UIヒント(ラベルとツールチップ)をADFデータソースからOracle BI Answersに表示するための伝播

Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド

システム要件と動作要件

システム要件および動作要件については、それらのドキュメントで説明されています。

ハードウェアとソフトウェアの要件、プラットフォーム、データベースおよびその他の情報の詳細は、システム要件と動作要件のドキュメントを参照してください。いずれのドキュメントもOracle Technology Network (OTN)から入手できます。

システム要件のドキュメントには、ハードウェアとソフトウェアの要件、ディスク領域とメモリーの最小要件、必要なシステム・ライブラリ、パッケージまたはパッチなどの情報が記載されています。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-requirements-100147.html

動作要件のドキュメントには、サポートされているインストール・タイプ、プラットフォーム、オペレーティング・システム、データベース、JDKおよびサードパーティ製品が記載されています。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

第II部 プロセスおよびコンポーネントの管理

ここでは、Oracle Business Intelligenceでのプロセスおよびコンポーネントの管理方法について説明します。内容は次のとおりです。

- Oracle Business Intelligenceプロセスの管理

2 Oracle Business Intelligenceプロセスの管理

この章では、Oracle Business Intelligenceプロセスの管理について説明し、次の項が含まれます。

- Oracle Business Intelligenceプロセスの管理について

- Oracle Business Intelligenceシステムを起動する条件

- コマンドを使用した起動、停止およびOracle BI EEプロセスのステータスの表示

- Fusion Middleware Controlを使用したBIシステム・コンポーネント・プロセスの起動および停止

- Fusion Middleware Controlを使用したJavaコンポーネントの起動および停止

- Javaコンポーネントを起動および停止するためのOracle WebLogic Server管理コンソールの使用

Oracle Business Intelligenceプロセスの管理について

システム管理者は、Oracle Business Intelligenceシステムとコンポーネント・プロセスを起動および停止して、プロセスの停止を必要とする様々なメンテナンス操作を実行します。

可用性やパフォーマンスの問題を診断して解決する際、およびライフサイクル操作と管理操作を実行する際には、Oracle Business Intelligenceシステムの各コンポーネントの状態(稼動、停止、起動中、停止中)を把握することが重要です。詳細は、「Oracle Business Intelligenceの問題の診断および解決」を参照してください。

Oracle Business IntelligenceはOracle WebLogic Server内で稼動するため、Oracle Business Intelligenceコンポーネントを起動して管理する前に、Oracle WebLogic Serverが起動している必要があります。

サーバーの構成設定、Business Intelligenceカタログ、リポジトリ(.rpdファイルはオフライン)、およびその他の設定を変更して有効にするには、該当するOracle Business Intelligenceコンポーネントを再起動する必要があります。

管理者がOracle Business Intelligenceを停止すると、エンド・ユーザーはログアウトされ、準備が整った時点で再びログインを促されます。その際、セッションの状態の一貫性は維持されています。

注意:

Oracle Business Intelligenceインストール済コンポーネントの詳細は、「Oracle Business Intelligenceコンポーネント」を参照してください。

Oracle Business Intelligenceシステムを起動する条件

Oracle Business Intelligenceシステムの起動は、管理サーバー、管理対象サーバーおよびシステム・コンポーネントの順に開始します。

管理サーバーをホストするコンピュータが稼動していなかったり、再起動された場合は、対象コンピュータが稼動していることを確認した上でOracle Business Intelligenceシステムを起動する必要があります。

Oracle Business Intelligenceシステムを起動するには、次の条件が満たされている必要があります。

- インストール時に指定されたリポジトリ・データベース(Schedulerのスキーマを格納する) が実行中であり、そのネットワーク接続を使用できる必要があります。それ以外の場合には、エラー・メッセージが表示されます。

次の各項で説明するように、起動手順はプラットフォームに応じて多少異なります。

コマンドを使用した起動、停止およびOracle BI EEプロセスのステータスの表示

スクリプト・コマンドを使用すると、ソフトウェアのいくつかのコンポーネントを制御できます。

スクリプト・コマンドを使用して、起動、停止およびOracle Business Intelligenceコンポーネントのステータスの表示を行います。

- ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動

- ドメインのOracle Business Intelligenceコンポーネント・プロセスの停止

- ドメインのOracle Business Intelligenceコンポーネントのステータスの表示

ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動

ドメイン内のすべてのコンポーネント・プロセスを起動する方法について学習します。

前提条件

- 起動コマンドは、まだ実行されていない場合に、ノード・マネージャをローカルおよびリモート(クラスタ化されたサーバー上)で起動します。

- 起動コマンドは、マスター・ホストからのみ実行されます。

- 起動コマンドは、コンポーネント・プロセスが起動されるか、またはrestartMaxValueパラメータ(-m)に指定した回数の起動に連続して失敗するまで完了しません。

- コンポーネント・プロセスは順番に起動します。

- コマンドは最初に資格証明を要求し、boot.propertiesファイルを自動的に作成するため、後続の実行では資格証明が必要ありません。

前提条件

- ファイル・システム権限を持ち、ブート・アイデンティティ資格証明を把握する必要があります。

1. 次の適切なコマンドを入力して、起動スクリプトを実行します。

DOMAIN_HOME/bitools/bin

UNIX | Windowsの場合:

./start.sh | start.cmd {-noprompt} {-i <list of instances>} {-r <restartIntervalSeconds>} {-m <restartMaxValue>} {-r <restartIntervalSeconds>} {-c}

For example, ./start.sh -i obis1,obips1 -r 10,000 -m 30 -c

引数

説明

-h<Domain home>

(オプション)ドメイン・ホーム(domainNameディレクトリを含む)を指定できます。設定した場合、デフォルトはDOMAIN_HOMEです。

-i <startServersList>

(オプション)カンマ区切りリストで起動するインスタンスを指定できます。インスタンスには、管理サーバー、管理対象サーバーまたはシステム・コンポーネント・インスタンス名を指定できます。

-r<restartIntervalSeconds>

(オプション)システム・コンポーネントを再起動できる秒数を指定します。デフォルトは3600で、最大は214748647、最小は300です。

-m<restartMaxValue>

(オプション)ノード・マネージャが「再起動間隔」で指定した間隔(秒単位)内でシステム・コンポーネントを再起動できる回数を指定します。デフォルトは2で、最大は2147483647、最小は0です。注意: 0に設定した場合、システム・コンポーネントの自動再起動は無効になります。

-c<Clear cached credentials>

(オプション)キャッシュされたWebLogic管理者資格証明をクリアして再設定します。その際、ユーザー名とパスワードを求めるプロンプトが表示されます。デフォルトのWebLogic Server管理者のパスワードをキャッシュした後は、このパラメータを使用します。ユーザーとの対話なしに、起動/停止時に使用するため、パスワードは暗号化されてからキャッシュされます(従来どおり)。デフォルトはfalseです。

注意: ノード・マネージャの資格情報は変更されません。

インスタンスがコマンドの引数として指定されていない場合、管理サーバー、管理対象サーバーおよびすべてのシステム・コンポーネントはデフォルトで起動します。

2. 起動する非アクティブ・コンポーネントのリストが表示されます。

3. コンポーネントが起動します。

-iを指定しない場合、すべての非アクティブ・プロセスが起動します。すでに実行されている場合でも失敗しません。

管理サーバー、管理対象サーバー、ローカル/リモート・ノード・マネージャおよびシステム・コンポーネントが起動します。

起動したコンポーネントの数が表示されます。

すべてのコンポーネントのステータスが表示されます。

ドメインのOracle Business Intelligenceコンポーネント・プロセスの停止

この項では、ドメイン内の実行中のコンポーネント・プロセスを停止する方法について説明します。

前提条件

- stopコマンドにより、ローカルおよびリモート(クラスタ化されたサーバー上)のノード・マネージャが停止します。

- 停止コマンドは、マスター・ホストからのみ実行されます。

- すべての指定されたコンポーネント・プロセスが停止するまで、停止コマンドが続行します。

- 停止コマンドは最初に資格証明を要求し、ブート・アイデンティティ・ファイルを自動的に作成するため、後続の実行では資格証明が必要ありません。

- 特定のプロセスの停止によってフェイルオーバーが発生する可能性があるため、「デプロイメントのスケーリング」を理解しておいてください。

前提条件

- ノード・マネージャが動作している必要があります。

- nodemanager.propertiesファイルにはQuitEnabled=trueを含める必要があります。

- ファイル・システム権限を持ち、WebLogic Serverを起動するシステム管理者アイデンティティ資格証明を把握する必要があります。

1. 次の適切なコマンドを入力して、停止スクリプトを実行します。

DOMAIN_HOME/bitools/bin

UNIX | Windowsの場合:

./stop.sh | stop.cmd {-i <list of instances>} {-c}
For example, ./stop.sh -i obis1,obips1

引数

説明

-h<Domain home>

(オプション)ドメイン・ホーム(domainNameディレクトリを含む)を指定できます。設定した場合、デフォルトはDOMAIN_HOMEです。

-i <list of instances>

(オプション)カンマ区切りリストで停止するインスタンスを指定できます。インスタンスには、管理サーバー、管理対象サーバーまたはシステム・コンポーネント・インスタンス名を指定できます。

-c<Clear cached credentials>

(オプション)キャッシュされたWebLogic管理者資格証明をクリアして再設定します。その際、ユーザー名とパスワードを求めるプロンプトが表示されます。デフォルトのWebLogic Server管理者のパスワードをキャッシュした後は、このパラメータを使用します。ユーザーとの対話なしに、起動/停止時に使用するため、パスワードは暗号化されてからキャッシュされます(従来どおり)。デフォルトはfalseです。

注意: ノード・マネージャの資格情報は変更されません。

インスタンスがコマンドの引数として指定されていない場合、管理サーバー、管理対象サーバーおよびすべてのシステム・コンポーネントはデフォルトで停止します。

2. コンポーネントが停止します。

ドメインのOracle Business Intelligenceコンポーネントのステータスの表示

ステータス・コマンドは、ドメイン内のコンポーネントのステータス・レポートを表示します。

前提条件

- ステータス・コマンドは、ノード・マネージャ・ステータスをレポートします。

- ステータス・コマンドは、マスター・ホストからのみ実行されます。

- ステータス・コマンドでは、ローカル・ノード・マネージャ・プロセスが実行されている必要があります。

- 最初の実行で資格証明を要求し、ブート・アイデンティティ・ファイルを自動的に作成するため、後続の実行では資格証明が必要ありません。

前提条件

- ファイル・システム権限を持ち、ブート・アイデンティティ資格証明を把握する必要があります。

1. 次の適切なコマンドを入力して、ステータス・スクリプトを実行します。

DOMAIN_HOME/bitools/bin

UNIX | Windowsの場合:

./status.sh | status.cmd {-v}

where {-v} is verbose

2. コマンドはコンポーネント名、タイプ、ステータスおよびマシン名を表示します。

Fusion Middleware Controlを使用したBIシステム・コンポーネント・プロセスの起動および停止

Oracle Business Intelligenceシステムが起動していれば、Fusion Middleware Controlを使用してOracle Business Intelligenceシステム・コンポーネント・プロセスを起動、停止および再起動できます。

Fusion Middleware Controlを使用できない場合、「コマンドを使用した起動、停止およびOracle BI EEプロセスのステータスの表示」を参照してください。

1. 「Fusion Middleware ControlのOracle Business Intelligenceページの表示」の説明に従って、「概要」ページに移動します。

2. 「可用性」ページの「プロセス」タブを表示し、次の図に示すように、すべてのプロセスの「すべて起動」、「すべて停止」または「すべて再起動」ボタンをクリックするか、プロセス行を選択して適切なボタンを使用して必要な個々のプロセスを起動、停止または再起動します。

このページを使用して、システム・コンポーネントのステータスを表示することもできます。

Oracle Business Intelligenceプロセスの起動および停止には、別の方法を使用することもできます。

- コマンドを使用した起動、停止およびOracle BI EEプロセスのステータスの表示

- Javaコンポーネントを起動および停止するためのOracle WebLogic Server管理コンソールの使用

Fusion Middleware Controlを使用したJavaコンポーネントの起動および停止

このトピックを使用し、Fusion Middleware Controlを使用してステータスを監視し、Oracle Business Intelligence Javaコンポーネント(管理サーバーおよび管理対象サーバー)を起動および停止します。

また、WebLogic Server管理コンソールを表示し、「WebLogicドメイン」メニューのメニュー・オプションを選択してJavaコンポーネントを管理できます。

1. Fusion Middleware Controlにログインします。

「Fusion Middleware Controlへのログイン」を参照してください。

2. 「WebLogicドメイン」フォルダを展開して、bidomainノードを選択します。

次の図に示すように、Fusion Middleware Controlに「WebLogicドメイン・ホーム」ページが表示されます。

「Weblogicドメイン・ホーム」ページからサーバー、クラスタ、デプロイメントおよびパーティションのステータスを監視し、Fusion Middleware Controlを使用してOracle Business Intelligence Javaコンポーネントを起動および停止できます。メニュー・オプションをクリックしてWebLogic Server管理コンソールを表示し、Oracle Business Intelligence Javaコンポーネントを管理および構成することもできます。詳細は、Oracle WebLogic Server管理コンソールによるOracle Business IntelligenceJavaコンポーネントの管理を参照してください。

3. 「Weblogicドメイン・ホーム」ページを使用して実行できるOracle Business Intelligenceの管理タスクは次のとおりです。

- 管理サーバー(AdminServer)および管理対象サーバー(たとえば、bi_server1)のステータスの表示。

- 選択されたJavaコンポーネント(たとえば、AdminServerまたはbi_server1)の起動と停止(「WebLogicドメイン」メニューの「制御」オプションを使用)。
「Fusion Middleware Controlを使用したJavaコンポーネントの起動および停止」を参照してください。

- WebLogic Server管理コンソールを使用したWebLogic Serverドメインの管理または構成(「WebLogicドメイン」メニューのリンクをクリック)。
「Oracle WebLogic Server管理コンソールによるOracle Business IntelligenceJavaコンポーネントの管理」を参照してください。

Javaコンポーネントを起動および停止するためのOracle WebLogic Server管理コンソールの使用

Javaコンポーネントを起動および停止するための標準の方法を使用できない場合は、Oracle WebLogic Server管理コンソールを使用できます。

Oracle WebLogic Server管理コンソールを使用してJavaコンポーネントを起動および停止することは推奨されていません。また、Fusion Middleware Controlを使用してJavaコンポーネントを起動および停止できます(「Fusion Middleware Controlを使用したBIシステム・コンポーネント・プロセスの起動および停止」を参照)。

1. Oracle WebLogic Server管理コンソールを起動します。

2. 「ドメイン構造」領域で「デプロイメント」をクリックします。

3. Oracle WebLogic Server管理コンソールに「デプロイメントの概要」ページが表示されます。

4. 「制御」タブを表示します。

5. 各コンポーネントを起動または停止するためのチェック・ボックスを選択します。

6. 必要に応じて「起動」または「停止」をクリックし、選択したコンポーネントを起動または停止します(次の図を参照)。

第III部 高可用性とパフォーマンスのためのスケーリングおよびデプロイ

Oracle Business Intelligenceのデプロイ、可用性および容量の管理方法について学習します。

詳細は次のトピックを参照してください。

- デプロイメントのスケーリング

- 高可用を実現するOracle Business Intelligenceのデプロイ

- パフォーマンス・チューニングと問合せキャッシングの管理

3 デプロイメントのスケーリング

この章では、Oracle Business Intelligenceのデプロイメントの容量および可用性を管理する方法について説明します。デフォルトで、スケーラブルなOracle Business Intelligenceシステム・コンポーネントがクラスタ構成でインストールされます。ユーザーのWebリクエストは、多数あるOracle Oracle BIプレゼンテーション・サービス・コンポーネントのいずれか1つに送信されます。リクエストを受けた各プレゼンテーション・サービス・コンポーネントは、複数のOracle BIサーバーの可用性を利用してリクエストを処理します。

システム容量を拡大または縮小するには、クラスタで使用できるプロセスの数を調整します。リソースの効率的な使用によるシステム容量の拡大または縮小はスケーラビリティと呼ばれています。スケーラブルなシステムは、レスポンス時間とスループットを低下させることなく、リクエストの増加に対処できます。

この章の内容は次のとおりです。

- Oracle Business Intelligenceのスケーリングについて

- 共有ファイルとディレクトリの設定

- Oracle Business Intelligenceの容量の管理(垂直方向のスケーリング)

- Oracle Business Intelligenceの可用性の管理(水平方向のスケーリング)

- システムに対する適切なスケーリングの検証

Oracle Business Intelligenceのスケーリングについて

スケーリングとは、Oracle Business Intelligenceクライアントのリクエストを処理できるプロセス数を変更することによって、システムの容量を増大したり縮小したりするプロセスのことを指します。

容量は、システムをスケールアウトすると増大され、スケールインすると縮小されます。スケーリングは、高可用性を目的としたデプロイメントの構成にも重要な部分となります。システム容量を拡大または縮小するには、クラスタで使用できるプロセスの数を調整します。クラスタは、同時に動作し、連携して高度なスケーラビリティと信頼性を実現する複数のサーバー・インスタンスで構成されます。

Oracle Business Intelligence環境のスケーリングは、主に、リソース集中型のシステム・プロセスおよびJavaコンポーネントに適用されます。さらに多くのプロセスをデプロイすることにより、Oracle Business Intelligenceではレスポンスを低下させることなく、より多くのリクエストを処理できるようになります。

垂直方向のスケーリングでは、同じコンピュータ上にOracle Business Intelligenceコンポーネントを追加して、そのコンピュータでのハードウェア・リソースの使用を増大します。たとえば、特定のコンピュータ上でリクエストを処理するシステム・コンポーネントの数を増やすことによって、Oracle Business Intelligenceが垂直方向にスケーリングされ、その結果、コンピュータでのハードウェア・リソースの使用が増大します。

水平方向のスケーリングでは、使用している環境にコンピュータを追加します。たとえば、複数のコンピュータにリクエストの処理を分散することで、Oracle Business Intelligenceが水平方向にスケーリングされます。

Oracle Business Intelligence Javaコンポーネントおよびシステム・コンポーネントの両方をスケーリングできます。「管理サーバー、管理対象サーバーおよびシステム・コンポーネントについて」を参照してください。

水平方向および垂直方向の両方のスケールアウトをサポートしているのは、Oracle BIプレゼンテーション・サービス、Oracle BIサーバー、およびJavaHostの3つのシステム・コンポーネントです。

Oracle BIスケジューラは、プレゼンテーション・サービスおよびOracle BIサーバーのプロセスを利用してコンピュータを集中的に使用する作業を実行します。一方、クラスタ・コントローラは他のコンポーネントを管理するのみで、コンピュータを集中的に使用することはありません。そのため、Oracle BIスケジューラまたはクラスタ・コントローラをスケールアウトする必要はありません。これら2つのプロセスは高可用性デプロイメントの必要に応じて配信できますが、容量をスケーリングする必要はありません。

プロセスをスケールアウトするタイミング

システム・コンポーネントおよび管理対象サーバーは実際の負荷に基づいてスケールアウトします。Fusion Middleware Controlで提供されるパフォーマンス・メトリックを使用してプロセスの状態を監視し、パフォーマンス向上のために容量を増大するタイミングを判断できます。たとえば、CPU使用率が50%を超えたとき、またはメモリー使用量がシステムの上限に近いときは、デプロイメントへのコンピュータの追加が必要になります。システム・メトリックの表示の詳細は、「サービス・レベルの監視」を参照してください。

可用性の高いOracle Business Intelligence環境を構成するには、プロセスをスケールアウトして冗長性を実現する必要もあります。「高可用を実現するOracle Business Intelligenceのデプロイ」を参照してください。

スケーリング対象プロセス

Oracle Business Intelligenceでは、Oracle Business Intelligenceインストーラ(水平方向のスケールアウト)およびWebLogic Scripting Tool (WLST)(垂直方向および水平方向のシステム・コンポーネントのスケーリング)の組合せによるスケールアウトをサポートしています。

管理対象サーバーおよびシステム・コンポーネントをスケーリングする場合は、次のガイドラインに従ってください。

- デプロイメント内の各コンピュータに対して管理対象サーバーが少なくとも1つ実行されていることを確認します。インストール中にOracle Business Intelligence構成アシスタントが1つの管理対象サーバーをプロビジョニングします。これは無効にしたり削除したりしないでください。

- 多くのJavaコンポーネントはシステムの重要な処理を実行しているため、それを個別に削除することはしないでください。各管理対象サーバーでJavaコンポーネントの完全なセットを保持してください。使用されないコンポーネントがパフォーマンスに重要な影響を与える可能性は低いです。

- 各コンピュータで実行するシステム・コンポーネントは実際の負荷に基づいて決定できます。デプロイメント内の特定のコンピュータには、0個以上の各コンポーネント・タイプを配置できます。たとえば、Oracle BIサーバー・コンポーネントを3つ、JavaHostコンポーネントを2つ、プレゼンテーション・サービス・コンポーネントを4つ配置できます。デフォルトでコンポーネントの対称セットがスケールアウトしたコンピュータで作成されます。

- 管理対象サーバーまたはシステム・コンポーネントとともに構成済HTTPサーバーをスケーリングする必要はありません。HTTPサーバーの構成は、実行するプロセス数とは無関係です。

共有ファイルとディレクトリの設定

特定のOracle Business Intelligenceコンポーネントのインスタンスが複数ある場合、グローバル・キャッシュおよび共有Oracle BIスケジューラ・スクリプトを含むファイルとディレクトリが共有ストレージ・デバイス(NASまたはSANなど)にあります。

共有されたファイルおよびディレクトリを使用すると、システムの管理(Oracle Business Intelligenceコンポーネントのスケールアウトを含む)が単純化されます(次の図を参照)。

この項では、次の項目について説明します。

- シングルトン・データ・ディレクトリ(SDD)の変更

- グローバル・キャッシュの設定

シングルトン・データ・ディレクトリ(SDD)の変更

Oracle Business Intelligenceメタデータは、シングルトン・データ・ディレクトリ(SDD)に格納されています。

デフォルトの場所は次の場所に設定されます。

DOMAIN_HOME/bidata

SDDパスが次のbi-environment.xmlファイルで定義されます。

DOMAIN_HOME/config/fmwconfig/bienv/core/bi-environment.xml

「Oracle Business Intelligenceの主なディレクトリ」を参照してください。

1. 共有ディレクトリを作成し、すべてのホストで使用できることを確認します。

たとえば、Windowsの場合は次のようにします。

dir \\example.com\dir

UNIXの場合の例:

ls /oraclehome/user_projects/domains/bi/bidata

2. 次のコマンドを実行して、すべてのOracle Business Intelligenceプロセスを停止します。

DOMAIN_HOME/bitools/bin

たとえば、UNIX上では、次のように入力します。

./stop.sh

3. bi-environment.xmlファイルをバックアップし、必要に応じて既存のSDDをバックアップします。

4. 編集するためにbi-environment.xmlファイルを開き、シングルトン・パスを指定します。

例:

<bi:singleton-data-directory>/oraclehome/user_projects/domains/bi/bidata/</bi:singleton-data-directory>

5. ファイルを保存します。

6. bidataディレクトリのコンテンツを以前に作成した共有ディレクトリにコピーします。

7. 次のコマンドを実行して、すべてのOracle Business Intelligenceプロセスを起動します。

DOMAIN_HOME/bitools/bin/

たとえば、UNIX上では、次のように入力します。

./start.sh

SDDがすべてのホスト・コンピュータに構成されます。

グローバル・キャッシュの設定

グローバル・キャッシュとは、クラスタに参加しているすべてのOracle BIサーバーが共有する問合せキャッシュです。

「グローバル・キャッシュについて」を参照してください。

クラスタに参加しているすべてのOracle BIサーバーでキャッシュのシーディング・イベントおよびパージ・イベントを共有するようにグローバル・キャッシュを構成することをお薦めします。

1. Fusion Middleware ControlのOracle Business Intelligenceのインスタンス構成ページの「パフォーマンス」タブを使用して、「グローバル・キャッシュ・パス」および「グローバル・キャッシュ・サイズ」オプションを設定します。

「グローバル・キャッシュ・パラメータを設定するためのFusion Middleware Controlの使用」を参照してください。

Oracle Business Intelligenceの容量の管理(垂直方向のスケーリング)

Oracle Business Intelligenceシステム・コンポーネントおよび管理対象サーバーの数を変更して、容量要件を満たすことができます。

使用するクラスタ化されたコンポーネントの共有ファイルおよびディレクトリを最初に構成する必要があります(「共有ファイルとディレクトリの設定」を参照)。

BIシステム・コンポーネントの数を変更して容量要件を満たすことができます。

この項で説明するコマンドは、上級のユーザーのみ使用する必要があります。

- システム・コンポーネントの追加

- システム・コンポーネントの削除

システム・コンポーネントの追加

システムが停止している場合(オフライン)、BIシステム・コンポーネントをコンピュータに追加できます。

注意:
SSLが構成されている場合は、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドのOracle Business IntelligenceでのSSLの構成に関する項を参照してください。

前提条件:

- 適切なファイル・システム権限を持つ必要があります。

- 特に指定されていないかぎり、ポートはOracle Business Intelligenceポート範囲から割り当てられます。

- サポートされているシステム・コンポーネント・タイプは、OBIPS (BIプレゼンテーション・サーバー)、OBICCS (クラスタ・コントローラ)、OBIJH (BI JavaHost)およびOBISCH (BIスケジューラ)です。
OBISインスタンスがサービス・インスタンスの一部として管理されるため、OBISはスケール・アウトされません。

「システム・コンポーネントについて」を参照してください。

- コンポーネント・タイプOBICCS、OBISCHごとに2つのインスタンスのみ作成できます(1つがアクティブ、1つがパッシブ)。このため、別のホストに別のインスタンスを追加する必要がある場合、既存のインスタンスを最初に削除する必要があります。

1. Weblogic Scripting Tool(WLST)を起動します。

ORACLE_HOME/oracle_common/common/bin/wlst.sh

2. readDomain(DOMAIN_HOME)コマンドを使用してドメインを選択します。

UNIXの場合の例:

readDomain('/oraclehome/user_projects/domains/bi')

たとえば、Windows上では次のようにします。

readDomain('D:\\Oracle\\Middleware\\ORACLE_HOME\\user_projects\\domains\\bi')

3. 適切なWLSTコマンドを使用して、新しいプレゼンテーション・サービス・システム・コンポーネントを作成します。

すべてのコマンドは、DOMAIN_HOMEにマシン名とオプションのポート指定を使用します

createOBIPSComponent(domainHome, machine, port=<portnumber>)

マシンはWebLogic論理コンピュータ名です(たとえば、'm1'など)。WLSTまたはWebLogic管理コンソール(実行中の場合)を使用して、論理マシン名を検出します。

UNIXの場合の例:

createOBIPSComponent('/u01/../../domains/bi','m1')

たとえば、Windows上では次のようにします。

createOBIPSComponent('D:\\Oracle\\Middleware\\ORACLE_HOME\\user_projects\\domains\\bi,'m1')

コマンド

説明

createOBICCSComponent(domainHome, machine, port=None, portMonitor=None)

このコマンドは、新しいクラスタ・コンポーネントを作成します。

createOBISCHComponent(domainHome, machine, port=None, portMonitor=None,portScript=None)

このコマンドは、新しいスケジューラ・コンポーネントを作成します。

createOBIPSComponent(domainHome, machine, port=None)

このコマンドは、新しいBI Presentation Serverコンポーネントを作成します。

createOBIJHComponent(domainHome, machine, port=None)

このコマンドは、新しいJavaHostコンポーネントを作成します

listBISystemComponents(domainHome)

このコマンドは、ドメインのすべてのシステム・コンポーネントのリストを示すオブジェクトを返します。

getBISystemComponents(domainHome, instanceId)

このコマンドは、指定されたinstanceIDを使用してシステム・コンポーネントの詳細を表示します。

4. コマンドが正常に完了したら、updateDomain('DOMAIN_HOME')コマンドを使用して変更をコミットする必要があります。

WLSTコマンドはすべての環境で同じです。

例:

updateDomain()

5. closeDomain('DOMAIN_HOME')コマンドを使用してドメインを閉じます。

WLSTコマンドはすべての環境で同じです。

例:

closeDomain()

6. 次の新しいコンポーネントを起動します。

DOMAIN_HOME/bitools/bin/

たとえば、次のように入力します。

./start.sh

「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください。

注意:
間違えたか変更を破棄する場合、updateDomain()コマンドを使用せずにcloseDomain()コマンドを使用する必要があります。

事後状態

- 新しいコンポーネントが作成されます。

- 新しいポートが割り当てられます。

- 新しいコンポーネントが起動します。

「WLST (WebLogic Scripting Tool)の使用」を参照してください。

システム・コンポーネントの削除

コンピュータから不要または非アクティブのプレゼンテーション・サービスシステム・コンポーネント・インスタンスを削除できます。

前提条件:

- 適切なファイル・システム(オフライン)権限があるかぎり、システムが停止している場合(オフライン)にコマンドを実行します。

- サポートされているシステム・コンポーネント・タイプは、OBIPS (BIプレゼンテーション・サーバー)、OBICCS (BIクラスタ・コントローラ)、OBIJH (BI JavaHost)およびOBISCH (BIスケジューラ)です。「システム・コンポーネントについて」を参照してください。

1. 次の停止スクリプトを使用して、システムを停止します。

DOMAIN_HOME/bitools/bin/

たとえば、UNIX上では、次のように入力します。

./stop.sh

「ドメインのOracle Business Intelligenceコンポーネント・プロセスの停止」を参照してください。

2. ORACLE_HOME/oracle_common/common/bin/wlst.shからdeleteBISystemComponent WLSTコマンドを実行して、システム・コンポーネントを削除します。

deleteBISystemComponent(domainHome, instanceId)

domainHomeはドメインのDOMAIN_HOMEで、instanceIDはBIコンポーネントID(たとえば、obips1、obis4)です

例:

deleteBISystemComponent("/oraclehome/user_projects/domains/bi", "obips1")

これにより、システム・コンポーネントが削除され、ポートの割当てが解除されます。

「WLST (WebLogic Scripting Tool)の使用」を参照してください。

削除されたシステム・コンポーネント名が表示されます。

3. 次のコマンドを実行して、システムを起動します。

DOMAIN_HOME/bitools/bin/

たとえば、UNIX上では、次のように入力します。

./start.sh

「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください。

Oracle Business Intelligenceの可用性の管理(水平方向のスケーリング)

デプロイメント内に特定のOracle Business Intelligenceコンポーネントのインスタンスが複数ある場合は、まず、クラスタ化された各コンポーネントで使用する共有ファイルとディレクトリを構成する必要があります。

「共有ファイルとディレクトリの設定」を参照してください。

水平方向にスケール・アウトした後、通常は、複数の管理対象サーバー全体にリクエストを配信するためにHTTPサーバーおよびロード・バランサを構成します。『Oracle WebLogic Serverクラスタの管理』のクラスタでのロード・バランシングに関する項を参照してください。フロント・エンドのロード・バランサが設定されている場合、BIクラスタ(bi_cluster)のWebLogic Serverフロントエンド・ホストおよびポートを設定する必要があります。

この項で説明するコマンドは、上級のユーザーのみ使用する必要があります。追加のホストを構成する場合に可用性コマンドがプロセスの対称セットを自動的に作成することに注意してください。

「WLST (WebLogic Scripting Tool)の使用」を参照してください。

注意:

SSLが構成されている場合に新しいノードをクラスタに追加するには、新しいクラスタにスケール・アウトする必要があります(「新しいコンピュータの追加」を参照)。次に、SSLが正しく設定されていることを確認します(『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』のOracle Business IntelligenceのSSLの構成に関する項を参照)。

- 新しいコンピュータの追加

- 既存のコンピュータの削除

新しいコンピュータの追加

新しいコンピュータを追加し、複数のコンピュータにまたがってBIクラスタを拡張することで、可用性および容量を向上できます。

前提条件

- 新しいコンピュータは、同じインストールの前提条件(たとえば、オペレーティング・システム、メモリー)を満たす必要があります。

- SDDを設定している必要があります。

- ORACLE_HOMEは、両方のコンピュータで同じ絶対パスを指定する必要があります。

- DOMAIN_HOMEが両方のホストで同じであることは必須ではありませんが、お薦めします。

- アクティブ/アクティブ・コンポーネントの対称セットが新しいコンピュータに作成されます。

- BIシステムを停止する必要があります(オフライン)。

- 適切なファイル・システム(オフライン)またはWeblogic管理者(オンライン)権限を持つ必要があります。

- 同じポートが元のホストに割り当てられます。

- 管理対象サーバーは既存のOracle Business Intelligenceクラスタに追加されます。

- クラスタ・コントローラ、スケジューラおよびBIサーバー・マスターが変更されていません。

- オプションのベース・コンピュータおよびサーバー・パラメータが提供され、m1/bi_server1が削除されている場合をサポートすることに注意してください。

- 指定されていないかぎり、コンピュータ(WebLogicマシン)名のデフォルトはリスニング・アドレスで、32文字未満である必要があります。

新しいコンピュータを追加すると、新しいコンピュータに追加の管理対象サーバー、ノード・マネージャ、システム・コンポーネントおよびサービスが作成されます。

1. クローン・スクリプトを実行する前にマスター・コンピュータ(ノード1)ですべてのサービスをシャットダウンします。
ORACLE_HOME/user_projects/domains/bi/bitools/bin/stop.sh

2. ノード1で、クローン・スクリプトを実行します。

このスクリプトでは、ドメイン・ディレクトリを含むJarファイルを作成し、ノード1のconfig.xmlファイルを新しいホスト名、管理対象サーバーおよびBIシステム・コンポーネントで更新します。

DOMAIN_HOME/bitools/bin/clone_bi_machine.sh|cmd [-m <new machine name>] <listen address> <Jar file>

<new machine name>はオプションで、デフォルトはリスニング・アドレスです。

SSL証明書の手順がスクリプトで実行されます。

例:

ORACLE_HOME/user_projects/domains/bi/bitools/bin/clone_bi_machine.sh example.com /oracle/nfs_shared/clone/demobi2.jar

3. 新しいコンピュータ(ノード2)で、WebLogic ServerおよびOracle Business Intelligenceをインストールします。

『Oracle Business Intelligenceのインストールと構成』を参照してください。

4. 2つのホスト間の接続をテストします。

5. マスター・コンピュータ(管理サーバーを含むノード1)のJarファイルを新しいコンピュータ(ノード2)にコピーします。

6. 新しいコンピュータで、unpackコマンドを実行してJarファイルを適用します。

ORACLE_HOME/oracle_common/common/bin

./unpack.sh -template=[location of copied jar file from master node] –domain=DOMAIN_HOME -nodemanager_type=PerDomainNodeManager

注意:
ヘルプを表示するための構文は次のとおりです: ./unpack.sh|cmd -help。

例:

/../../Oracle_Home/oracle_common/common/bin/unpack.sh -template=/refresh/home/oracle/nfs_shared/clone/demobi2.jar -domain=/../../Oracle_Home/user_projects/domains/bi -nodemanager_type=PerDomainNodeManager

7. 次のコンポーネントを起動します。

ノード1: ノード・マネージャ、管理サーバー、ノード1の管理対象サーバーおよびノード1のBIシステム・コンポーネント。

ノード2: ノード・マネージャと管理対象サーバー(この場合config.xmlが作成可能)。

ノード2のBIシステム・コンポーネントは現在ダウン状態になっています。

注意:ノード2のノード・マネージャが起動すると、ノード1から同じスクリプトを使用して他のすべてのコンポーネントを起動できます。コンポーネントは次の順序で起動できます。

- ノード2:
ノード2のノード・マネージャ

- ノード1:
ノード1のノード・マネージャ。

管理サーバー。

ノード1の管理対象サーバー

ノード1のBIシステム・コンポーネント

例:

ノード2:

/../../Oracle_Home/user_projects/domains/bi/bin/startNodeManager.sh

ノード1:

/../../Oracle_Home/user_projects/domains/bi/bitools/bin/start.sh -i AdminServer,bi_server1,obis1,obips1,obiccs1,obijh1,obisch1,bi_server2

8. 新しいマシン(ノード2)のデータ・ソースを再同期します。

ノード2で、次のスクリプトを実行します。

DOMAIN_HOME/bitools/bin/sync_midtier_db.sh

「BI固有のWLSTコマンド・リファレンス」を参照してください。

9. マスター・ホスト・コンピュータ(ノード1)で、ノード2の新しいBIシステム・コンポーネントを起動します。

DOMAIN_HOME/bitools/bin/

次のように入力します。

./start.sh -i obis2,obips2,obiccs2,obijh2,obisch2

スケール・アウト・プロセスが完了し、すべてのコンポーネントが実行されます。

「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください。

事後状態

- コンピュータ、管理対象サーバー、ノード・マネージャおよびシステム・コンポーネントが作成されます。

- 2番目のコンピュータにサービス・インスタンスが登録されます。

- ポートが割り当てられます。

既存のコンピュータの削除

BIクラスタから障害が発生したコンピュータまたは冗長なコンピュータを削除します。

前提条件

- バイナリ、構成または状態は削除されたコンピュータから削除されません。

- クラスタ・コントローラ、スケジューラおよびBIサーバー・マスターが変更されていません。

- マスター・コンピュータを削除できません。

- サービス・インスタンス登録を追加または削除できます。

- BIシステムが実行中(オンライン)または停止している(オフライン)可能性があります。

- 適切なファイル・システム(オフライン)またはWeblogic管理者(オンライン)権限を持つ必要があります。

- コマンドの結果がサービスの損失になりません。

- ユーザーが強制した場合のみコマンドの結果が可用性の損失になる可能性があります。

前提条件

可能な場合、status.shおよびstop.shスクリプトを使用して削除する前にターゲット・コンピュータのアクティブなコンポーネントを停止する必要があります。「コマンドを使用した起動、停止およびOracle BI EEプロセスのステータスの表示」を参照してください。

1. 次のdeleteBIMachine WLSTコマンドを使用して、cloneBIMachineまたはclone_bi_machine.shで作成されたコンポーネントを削除します。

ORACLE_HOME/oracle_common/common/bin/wlst.sh

例:

deleteBIMachine(DOMAIN_HOME, <machine>)

または、次のdelete_bi_machine.shスクリプトを実行します。

DOMAIN_HOME/bitools/bin/delete_bi_machine.sh|cmd machineName

2. コマンドは削除されたコンピュータ名を表示します。

事後状態

- コンピュータ、管理対象サーバー、ノード・マネージャおよびシステム・コンポーネントがそのコンピュータから削除されます。

- サービス・インスタンスがそのコンピュータから登録解除されます。

- ポートの割当てが解除されます。

システムに対する適切なスケーリングの検証

使用しているシステムのサイズおよびスコープに合わせて適切に構成されていることを確認するには、コンポーネントを検証する必要があります。

Fusion Middleware Control、Oracle WebLogic Server管理コンソールおよびコマンドラインを使用して、スケールアウトしたコンポーネントのステータスを検証できます。

この項では、次の項目について説明します。

- システム・コンポーネントの可用性を表示するためのFusion Middleware Controlの使用

- 管理対象サーバーの可用性を表示するための管理コンソールの使用

コマンドを使用したステータスの表示の詳細は、「ドメインのOracle Business Intelligenceコンポーネントのステータスの表示」を参照してください。

システム・コンポーネントの可用性を表示するためのFusion Middleware Controlの使用

Fusion Middleware Controlを使用して、デプロイメント内のすべてのシステム・コンポーネントのステータスを表示できます。

1. Fusion Middleware ControlのOracle Business Intelligenceページの表示の説明に従って、Business Intelligenceの「概要」ページに移動します。

2. 「可用性」ページの「プロセス」タブを表示します。

このページでは、次の操作が可能です。

- すべての構成済システム・コンポーネントのステータスの表示

- ホストおよび実行中の各システム・コンポーネントのポートを表示します

- すべてのプロセスの起動、停止または再起動

- 選択されたシステム・コンポーネントを起動、停止または再起動します

「このページのヘルプ」ヘルプ・メニュー・オプションをクリックして、ページレベル・ヘルプにアクセスします。

次の図は、「可用性」ページの「プロセス」タブを示しています。

管理対象サーバーの可用性を表示するための管理コンソールの使用

管理コンソールを使用して、デプロイメント内のすべての管理対象サーバーのステータスを表示できます。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「環境」、「サーバー」の順に選択し、「サーバーのサマリー」ページに移動します。このページでは、デプロイメント内の新しいホストに追加された任意の管理対象サーバーを確認できます。

次の図は、「サーバーのサマリー」ページを示しています。

4 高可用を実現するOracle Business Intelligenceのデプロイ

ここでは、高可用性を実現するためにOracle Business Intelligenceコンポーネントを構成する方法について説明します。また、システムの可用性の管理にFusion Middleware Controlで利用できる機能や、管理ツールでのクラスタ・マネージャの使用についても説明します。

ここでは、データベース層、Web層、管理サーバーおよびID管理の可用性など、スタック内の他のコンポーネントについて高可用性をさらに構成するための情報は提供していません。これらのトピックおよびOracle Business Intelligenceのデプロイとの関連性の詳細は、次のドキュメントを参照してください。

- 高可用性ガイドの他のコンポーネントへの高可用性のデプロイに関する項では、スタック全体に高可用性を実装する方法や、フォルト・トレラントなHTTPロード・バランサの構成方法、およびOracle Business Intelligenceスキーマに対する可用性の高いデータベースの構成方法について説明しています。

- Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイドでは、セキュリティおよび高可用性に対して推奨されるベスト・プラクティスに沿った構成上の詳細な計画に基づくOracle Business Intelligenceのデプロイ方法を、Web層、データベース層、管理サーバーおよびID管理の可用性とともに説明しています。

この章の内容は次のとおりです。

- クラスタ環境におけるOracle Business Intelligenceコンポーネントについて

- 高可用性に対するOracle Business Intelligenceコンポーネントの構成

- Oracle Business Intelligenceの高可用性に対するオプション構成

- クラスタ・マネージャの使用

- Fusion Middleware Controlのクラスタ化された環境のトラブルシューティング

クラスタ環境におけるOracle Business Intelligenceコンポーネントについて

次の図は、可用性の高いOracle Business Intelligenceのデプロイメントにおけるシステム・コンポーネントとJavaコンポーネントを示しています。

システム・コンポーネントおよびJavaコンポーネントの詳細は、「管理サーバー、管理対象サーバーおよびシステム・コンポーネントについて」を参照してください。

前述の図では、Oracle Business Intelligence Javaコンポーネントが、APPHOST1およびAPPHOST2上の管理対象サーバーであるBI_SERVER1およびBI_SERVER2にデプロイされています。これらの管理対象サーバーは、Oracle WebLogicクラスタ内に構成されています。

Oracle BIプレゼンテーション・サービス、JavaHost、Oracle BIクラスタ・コントローラ、Oracle BIスケジューラおよびOracle BIサーバーは、APPHOST1およびAPPHOST2にインストールされてクラスタとして構成されたシステム・コンポーネントです。APPHOST2上のクラスタ・コントローラおよびOracle BIスケジューラはパッシブであり(起動されますがリクエストは処理しません)、APPHOST1のコンポーネントで障害が発生した場合にのみアクティブ化されます。

カスタマ・メタデータは共有SDDに格納されます(インポートまたはエクスポート用のBARファイルとして)。

可用性に関する推奨事項

本番システムでは、各コンポーネントの複数のインスタンスを複数のコンピュータにデプロイすることをお薦めします。これにより、フォルト・トレランスを目的として、各コンポーネント・タイプのインスタンスが1つ以上のコンピュータで実行されるようになります。

この構成では、管理対象サーバーとシステム・コンポーネントに対して、高可用性およびフェイルオーバーの必須要件である冗長性が提供されます。システムの単一点障害の発生については、Fusion Middleware Controlの「可用性」ページの「フェイルオーバー」タブで確認できます。「単一点障害を特定するためのFusion Middleware Controlの使用」を参照してください。

高可用性は、データベース層(Oracle RAC推奨)やWeb層で、および管理サーバーに対して冗長性を構成することによっても確保できます。『高可用性ガイド』のOracle Business IntelligenceおよびEPMの高可用性の構成に関する項を参照してください。

次の要件にも注意してください。

- クラスタに属しているすべてのOracle BIサーバーは、同一のドメイン内、および同一のLANサブネット上に存在している必要があります。地理的に離れているコンピュータはサポートされません。

- クラスタに属している各サーバーのクロックで同期を保持する必要があります。同期していないクロックによってレポートの正確性が失われる可能性があります。

単一点障害を特定するためのFusion Middleware Controlの使用

処理に単一点障害がある場合は、Fusion Middleware Controlを使用してそれを見つけることができます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. Fusion Middleware ControlのOracle Business Intelligenceページの表示の説明に従って、Business Intelligenceの「概要」ページに移動します。

2. 「可用性」ページの「フェイルオーバー」タブを表示します。
このページでは、スケールアウトしたシステム・コンポーネントおよびプライマリ/セカンダリ・システム・コンポーネントを構成するかを確認できます。

「このページのヘルプ」 ヘルプ・メニュー・オプションをクリックして、要素のページレベル・ヘルプにアクセスします。

アクティブ/パッシブ・モデルを使用した高可用性の実現

前述の項で説明したアクティブ/アクティブ構成の設定にかわる方法として、Oracle Fusion Middleware Cold Failover Cluster (コールド・フェイルオーバー・クラスタ)を使用して、アクティブ/パッシブ構成でOracle Business Intelligenceを設定できます。

コールド・フェイルオーバー・クラスタ構成では、複数のアプリケーション・サーバー・インスタンスが同じアプリケーション・ワークロードを処理するように構成されますが、常にアクティブであるインスタンスは1つのみです。

2ノードのコールド・フェイルオーバー・クラスタを使用することで、Oracle Business Intelligenceのアクティブ/パッシブな可用性を実現できます。コールド・フェイルオーバー・クラスタでは、1つのノードがアクティブになり、別のノードはスタンバイ・ノードとしてパッシブになります。アクティブ・ノードに障害が発生すると、待機中のノードがアクティブ化され、Oracle Business Intelligenceはそのノードでクライアントの処理を続行します。すべてのOracle Business Intelligenceコンポーネントが新しいアクティブなノードにフェイルオーバーされます。フェイルオーバー後、障害が発生したノードで実行されるOracle Business Intelligenceコンポーネントはありません。

詳細は、高可用性ガイドのアクティブ・パッシブ可用性ソリューションに関する項を参照してください。

高可用性に対するOracle Business Intelligenceコンポーネントの構成

高可用性を実現するためにOracle Business Intelligenceを構成するには、システムに単一点障害がないようにする必要があります。それには、Oracle BIサーバー、プレゼンテーション・サービスおよびJavaHostをスケールアウトして、少なくとも2つのコンピュータに、各コンポーネント・タイプを少なくとも2つ配布するようにします。

次の表は、Oracle Business Intelligenceの高可用性を構成するために実行する必要のあるタスクを示しています。

タスク

詳細の参照先

Oracle Business Intelligenceデプロイメントの水平方向スケールアウト。これにより、Javaコンポーネントおよびシステム・コンポーネントの完全なセットを持つ2つのコンピュータが各ホストに含まれるようになります。このタスクには、Oracle Business Intelligenceインストーラと構成アシスタントの実行およびシステム・コンポーネントのスケールアウトが含まれます。

Oracle Business Intelligenceの可用性の管理(水平方向のスケーリング)

新しいコンポーネントの可用性の確認。

システム・コンポーネントの可用性を表示するためのFusion Middleware Controlの使用

Oracle Business Intelligenceの高可用性に対するオプション構成

この項の手順は、Oracle Business Intelligenceの高可用性に対するオプション構成を実行する方法について説明しています。

この項では、次の項目について説明します。

- オプションのクラスタ・コントローラ・パラメータの設定

- オプションのPresentation Servicesパラメータの設定

- オプションのOracle BIプレゼンテーション・サービス・プラグイン・パラメータの設定

オプションのクラスタ・コントローラ・パラメータの設定

クラスタ・コントローラのハートビート頻度に関するオプション・パラメータを、bi_cluster_config.xmlファイルに設定できます。

1. 次のbi_cluster_config.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBICCS

2. 次の表は、ClusterProperties要素下のクラスタ通信パラメータのデフォルト値を示しています。必要に応じて、このパラメータの値を変更することもできます。

パラメータ

説明

デフォルト値

ServerPollSeconds

クラスタ内のクラスタ・コントローラ、Oracle BIサーバーおよびOracle BIスケジューラの各ノード間のハートビート・メッセージの頻度(秒)。

5

ControllerPollSeconds

クラスタ・コントローラ間のハートビート・メッセージの頻度(秒)。

5

3. ファイルを保存して閉じます。

4. Oracle Business Intelligenceを再起動します。

このコードに、bi_cluster_config.xmlファイルのパラメータの例を示します。このサンプルに示されていない追加の要素は、すべて集中的に管理されており、手動では設定できないことに注意してください。

<bi:ClusterProperties>
<bi:ClusterEnabled>true</bi:ClusterEnabled>
<bi:ServerPollSeconds>5</bi:ServerPollSeconds>
<bi:ControllerPollSeconds>5</bi:ControllerPollSeconds>
</bi:ClusterProperties>

オプションのプレゼンテーション・サービス・パラメータの設定

オプションで、プレゼンテーション・サービスとJavaHostコンポーネント間の伝達を制御する特定のパラメータを構成できます。

プレゼンテーション・サービスを構成するには、プレゼンテーション・サービスをホストする各コンピュータ上にあるinstanceconfig.xmlファイルにパラメータを設定します。

1. 次の構成ファイルのinstanceconfig.xmlを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. ServerInstanceタグ下のJavaHostProxy要素にはオプションのサブ要素があります。次の表に、これらのオプションのサブ要素を示します。

サブ要素

属性

説明

LoadBalancer/Ping

keepAliveMaxFailures

ホストが機能していないと判断されるまでにpingの失敗を許容する回数を指定します。デフォルト値は5です。

LoadBalancer/Ping

keepAliveFrequencySecs

pingの頻度を秒単位で指定します。デフォルト値は20です。

3. ファイルを保存して閉じます。

4. Oracle Business Intelligenceを再起動します。

オプションのOracle BIプレゼンテーション・サービス・プラグイン・パラメータの設定

オプションでOracle BI Presentation Services Plug-inを構成して、セッションのリダイレクション動作を制御できます。

1. 次の場所のようにbridgeconfig.propertiesファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/bridgconfig.properties

2. オプションで、パラメータAlwaysKeepSessionAffiliationを追加すると、現在のOracle BIプレゼンテーション・サービス・プラグイン・コンポーネントのスコアが低すぎる場合に、同じセッションに属するリクエストを別のプレゼンテーション・サービス・コンポーネントにリダイレクトできるかどうかを制御できます。

インスタンス・スコアとは、ロード・バランシング・アルゴリズムによってクラスタ内の各Oracle BIプレゼンテーション・サービス・プラグイン・インスタンスに関連付けられている内部スコアのことです。これは、ロード・バランサで収集された様々なメトリックに基づいています。

このパラメータをtrueに設定するとリクエストのリダイレクションが禁止され、falseに設定すると許可されます。例:

oracle.bi.presentation.sawconnect.loadbalance.AlwaysKeepSessionAffiliation=true

3. ファイルを保存して閉じます。

4. Oracle WebLogic Server管理コンソールからanalyticsアプリケーションを再起動します。Oracle BIプレゼンテーション・サービス・プラグインでOracle BIプレゼンテーション・カタログを使用している場合は、xmlpserverアプリケーションも再起動する必要があります。

クラスタ・マネージャの使用

これまでのリリースでは、管理ツールのクラスタ・マネージャを使用してOracle BIサーバー、Oracle BIスケジューラおよびクラスタ・コントローラのインスタンスを監視および管理していました。

クラスタ・マネージャは現在のリリースでもサポートされています。

クラスタ化されたコンポーネントに関連するほとんどの管理タスクにはFusion Middleware Controlを使用しますが、それらのコンポーネントの状態を表示する場合はクラスタ・マネージャを使用すると便利です。たとえば、現在アクティブなOracle BIスケジューラ・インスタンスを表示して、どのOracle BIサーバーがマスターBIサーバーかを確認できます。Fusion Middleware Controlでは、クラスタ化されたコンポーネントの現在のステータスは表示されますが、現在の状態を表示することはできません。

クラスタ・マネージャを使用すると、クラスタ内のOracle BIサーバー、Oracle BIスケジューラおよびクラスタ・コントローラのインスタンスの操作を監視、分析および管理できます。このツールでは、ステータス、キャッシュおよびセッションの情報が提供されます。クラスタ・マネージャを使用できるのは、管理ツールがクラスタ化されたDSNに接続されている場合のみです。

クラスタ内のすべてのクラスタ・コントローラまたはOracle BIサーバーが現在停止しているかオフラインの場合、クラスタ・マネージャにアクセスしてそれらを起動することはできません。Cluster Controller(通常はプライマリ)とOracle BIサーバーをそれぞれ1つ手動で起動する必要があります。

「クラスタ・マネージャ」ウィンドウには、左側に「エクスプローラ 」ペインと 右側に「情報」ペインの2つのペインがあります。「エクスプローラ」ペインには、クラスタを構成するサーバー、スケジューラおよびコントローラの階層情報が表示されます。「情報」ペインには、「エクスプローラ」ペインで選択された項目の詳細情報が表示されます。

「クラスタ・マネージャ」ウィンドウは、デフォルトで1分ごとにリフレッシュされます。この間隔は変更できます。

1. 管理ツールで、リポジトリをオンライン・モードで開きます。

2. 「管理」、「クラスタ」の順に選択します。

3. 「リフレッシュ」、「間隔」の順に選択し、リストから別の値を選択します。

4. 必要に応じて表示をリフレッシュするには、クラスタ・マネージャがアクティブなウィンドウであることを確認してから[F5]を押すか、「リフレッシュ」、「即時」の順に選択します。このアクションにより、クラスタのほとんどの現在の情報が取得されます。

クラスタ情報の表示および管理

クラスタの情報はアプリケーションへの洞察をもたらします。

ここでは、クラスタに関するステータス、キャッシュ、およびセッションの情報と、表示される情報の意味について説明します。

ステータス情報

初めて「クラスタ・マネージャ」ウィンドウを開くと、「ステータス」ビューが自動的に表示されます。

また、「ビュー」、「クラスタ・マネージャ」ウィンドウの「ステータス」の順に選択することで「ステータス」ビューにアクセスすることもできます。

「情報」ペインに表示される情報のカテゴリは、管理ツールが接続しているサーバーに応じて異なる場合があります。次の表は、表示される可能性のあるカテゴリについて説明しています。

列

説明

最終報告時間

ロールが「制御中」のクラスタ・コントローラと、クラスタ・コントローラまたはOracle BIサーバーが通信した時間。サーバーまたはコントローラがオフラインの場合、このフィールドは空白になります。

名前

Oracle BIサーバーまたはクラスタ・コントローラをホストしているコンピュータの名前。

ロール

クラスタ内のオブジェクトのロールは、次のとおりです。

- 制御。現在クラスタの制御責任を割り当てられているクラスタ・コントローラ。

- プライマリ。プライマリのクラスタ・コントローラ。プライマリのクラスタ・コントローラが現在制御中のクラスタ・コントローラである場合、このロールは表示されません。

- セカンダリ。セカンダリのクラスタ・コントローラ。セカンダリのクラスタ・コントローラが現在制御中のクラスタ・コントローラである場合、このロールは表示されません。

- クラスタ化されたサーバー。クラスタのメンバーであるOracle BIサーバー。マスター・サーバーとして定義されているクラスタ化されたサーバーには、このロールは表示されません。

- マスター。管理ツールがリポジトリをオンライン・モードで編集するために接続するクラスタ化されたサーバー。

- アクティブ。Oracle BIスケジューラはアクティブです。

セッション

このフィールドは、「エクスプローラ」ペインで複数のサーバーまたは個別のサーバーが選択されている場合に利用できます。クラスタ化されたサーバーに現在ログオンしているセッション数を示します。

開始時間

クラスタ・コントローラまたはOracle BIサーバーが最後に起動された時間を示すタイムスタンプ。クラスタ・コントローラまたはクラスタ化されたサーバーがオフラインの場合、このフィールドは空白になります。

ステータス

クラスタ内のオブジェクトのステータスは、次のとおりです。

- オンライン。クラスタ・コントローラまたはOracle BIサーバーはオンラインです。オンラインのクラスタ・コントローラは、セッション・リクエストを受信して、それらをクラスタ内の使用可能なサーバーに割り当てることができます。クラスタ・コントローラにより、オンラインのOracle BIサーバーにセッションが割り当てられます。

- 停止。このステータスはクラスタ化されたサーバーにのみ適用されます。サーバーが静止された場合は、サーバーがオフライン・ステータスに移行する前に、未処理のセッションで進行中のアクティビティをすべて完了できます。

- オフライン。クラスタ・コントローラまたはOracle BIサーバーはオフラインです。オフラインのクラスタ・コントローラは、セッション・リクエストを受信して、それらをクラスタ内の使用可能なサーバーに割り当てることはできません。オフラインのOracle BIサーバーは制御中のクラスタ・コントローラと通信しないため、制御中のクラスタ・コントローラによって割り当てられたセッションを受信できません。その後、サーバーが使用可能になると、クラスタに参加できます。クラスタ・コントローラやクラスタ化されたサーバーを静止した後で停止するには、Stopコマンドを入力します。

- 強制オフライン。このステータスはクラスタ化されたサーバーにのみ適用されます。Oracle BIサーバーは停止しています。これはオフライン・ステータスと同じですが、このステータスでは、Oracle BIサーバーがオンラインに戻ってもリクエストは割り当てられません。このサーバーは、管理ツールのクラスタ・マネージャからこのサーバーに対してStartコマンドが発行されるか、両方のクラスタ・コントローラがシャットダウンして再起動するまで、停止した状態のままになります。

- オンライン: アクティブ。このOracle BIスケジューラ・インスタンスはオンラインで、実行中であり、Oracle BIスケジューラ・クライアントによって接続されています。このインスタンスがジョブを実行します。

- オンライン: 非アクティブ。このOracle BIスケジューラはオンラインですが実行されていません。このインスタンスは、アクティブ・インスタンスが利用できなくなった場合に、アクティブ・インスタンスとして処理をただちに引き継ぎます。

- オンライン: 非アクティブな保留。アクティブなOracle BIスケジューラが非アクティブの状態へ移行しようとしています。これには数分かかることがあります(複数のジョブが実行中の場合など)。

タイプ

「エクスプローラ」ペインで「クラスタ」を選択すると、このフィールドが利用できます。次の3つのタイプがあります。

- コントローラ。オブジェクトはクラスタ・コントローラです。

- サーバー。オブジェクトはOracle BIサーバーです。

- スケジューラ。オブジェクトはScheduler Serverです。

キャッシュの情報

「キャッシュ」ビューは、キャッシュが有効な場合に「クラスタ・マネージャ」ウィンドウに表示されます。

情報のカテゴリとその表示順は、「オプション」の設定により制御されます。次の表は、表示される可能性のあるカテゴリについて説明しています。

列

説明

ビジネス・モデル

キャッシュ・エントリに関連付けられているビジネス・モデルの名前。

列数

このキャッシュ・エントリの結果セットの各行における列数。

作成

キャッシュ・エントリの結果セットが作成された時間。

作成経過時間

このキャッシュ・エントリの結果セットの作成に必要な時間(ミリ秒)。

フル・サイズ

可変長の列、圧縮アルゴリズム、およびその他の要因を考慮して使用される最大サイズ。結果セットの実際のサイズはフル・サイズよりも小さくなります。

最終使用

キャッシュ・エントリの結果セットが問合せに対応した最後の日時(Oracle BIサーバーが予期せず停止した後、最終使用日時が一時的に実際よりも古い値となることがあります)。

行数

問合せによって生成された行数。

行サイズ

このキャッシュ・エントリの結果セットの各行のサイズ(バイト単位)。

SQL

キャッシュ・エントリを生成したSQL文のテキスト。

使用回数

Oracle BIサーバーの起動後、このキャッシュ・エントリの結果セットが問合せに対応した回数。

ユーザー

このキャッシュ・エントリを作成した問合せを送信したユーザー名。

キャッシュ情報を表示するには::

- 「エクスプローラ」ペインで個々のサーバーをクリックし、「ビュー」、「キャッシュ」の順に選択します。

セッション情報

セッション情報は2つの場所で確認できます。

「セッション」ビューはOracle BIサーバーに表示されます。この情報は、次の表に示すように、2つのウィンドウに配置されています。

- 「セッション」ウィンドウ: 上部に表示されます。Oracle BIサーバーに現在ログオンしているユーザーを表示します。

- 「リクエスト」ウィンドウ: 下部に表示されます。「セッション」ウィンドウで選択したユーザーについてアクティブな問合せリクエストを表示します。

次の表は、「セッション」ウィンドウに表示される情報について説明しています。

列

説明

カタログ

セッションが接続されるプレゼンテーション・カタログの名前。

クライアント・タイプ

クライアント・セッションのタイプ。「管理」クライアント・タイプは、管理者ユーザーのIDでログインするユーザーに予約されています。

最終アクティブ時刻

セッションや問合せに関する最新のアクティビティのタイムスタンプ。

ログオン時間

セッションがOracle BIサーバーにログオンした時間のタイムスタンプ。

リポジトリ

セッションが接続されているリポジトリの論理名。

セッションID

セッション開始時にOracle BIサーバーが各セッションに割り当てる一意の内部ID。

ユーザー

接続したユーザーの名前。

次の表は、「リクエスト」ウィンドウに表示される情報について説明しています。

列

説明

最終アクティブ時刻

セッションや問合せに関する最新のアクティビティのタイムスタンプ。

リクエストID

問合せ開始時にOracle BIサーバーが各問合せに割り当てる一意の内部ID。

セッションID

セッション開始時にOracle BIサーバーが各セッションに割り当てる一意の内部ID。

開始時間

最初の問合せリクエストの時刻。

ステータス

表示される値は次のとおりです。プロセスによっては、その完了する速度に応じて、指定されたリクエストやセッションのすべての値が表示されないことがあります。

- アイドル。リクエストやセッションに対するアクティビティは現在ありません。

- フェッチ中。リクエストを取得中です。

- フェッチ済。リクエストは取得されました。

- 準備中。リクエストは処理を準備しています。

- 準備済。リクエストは処理の準備を完了して、実行可能な状態です。

- 実行中。リクエストは現在実行中です。リクエストを終了するには、そのリクエストを選択して「リクエストの強制終了」をクリックします。ユーザーは、管理者がリクエストをキャンセルしたことを示す情報メッセージを受信します。

- 実行済。リクエストの実行は終了しました。

- 成功。リクエストの実行は正常に完了しました。

- 取消済。リクエストは取り消されました。

- 失敗。リクエストの処理中または実行中にエラーが発生しました。

セッション情報を表示するには:

- 「エクスプローラ」ペインでサーバーを選択し、「表示」、「セッション」の順に選択します。
サーバーのセッション情報が「情報」ペインに表示されます。ここには、サーバーにログインしたすべてのユーザーと、各ユーザーに対する現在のすべての問合せリクエストが表示されます。

セッションを切断するには:

- 「セッション」ビューで、「セッション」ウィンドウ(上部ウィンドウ)のセッションを右クリックして「切断」をクリックします。
セッションを切断するとODBCセッションは終了します。このセッションで接続されていたユーザーは、問合せを試行してもエラー・メッセージが返されます。ユーザーは、ログアウトしてから再度ログインし、新しいセッションを開始する必要があります。

問合せリクエストを終了するには:

- 「セッション」ビューで、「リクエスト」ウィンドウ(下部ウィンドウ)のリクエストを右クリックして「リクエストの強制終了」をクリックします。
問合せリクエストを終了すると、その問合せを開始しているユーザーにエラーが返されます。

サーバー情報

クラスタ・サーバーに関する情報は、アプリケーション・メニューから表示できます。

「ビュー」メニューから「サーバー情報」を選択すると、バージョン番号など、クラスタ・サーバーに関する情報が表示されます。

Fusion Middleware Controlのクラスタ化された環境のトラブルシューティング

Fusion Middleware Controlおよび管理コンソールを使用してシステム・プロセスのステータスを確認します。

「システム・コンポーネントの可用性を表示するためのFusion Middleware Controlの使用」および「管理対象サーバーの可用性を表示するための管理コンソールの使用」を参照してください。

クラスタ化、ロード・バランシングおよびフェイルオーバーの各機能を有効にしたら、次の情報を使用して、デプロイメントで発生する可能性のある問題のトラブルシューティングを実行できます。

- Fusion Middleware Controlで報告されているメッセージとエラー

- Fusion Middleware Controlコンポーネントのログ・ファイル(Fusion Middleware Controlからも使用できます)

クラスタ内の各Fusion Middleware Controlシステム・コンポーネントのログ・ファイルを確認します。ログ・ファイルには、誤った構成によって発生する可能性のあるクライアント側の障害がすべて記録されます。ログに記録されないフェイルオーバー・イベントもありますが、Cluster Controllerのログ・ファイルには、すべてのOracle BIスケジューラまたはOracle BIサーバー・コンポーネントのクラッシュが記録されます。イベント・ビューアのログは、WindowsでもLinuxまたはUNIXのsyslogでも確認できます。

「Oracle Business Intelligenceの問題の診断および解決」を参照してください。

Oracle BIサーバーがLinuxまたはUNIXで実行している際のNetwork Applianceデバイスでのエラーの回避

次の情報は、Network ApplianceからNASデバイス上のOracle Business Intelligenceの共有ファイルとディレクトリにアクセスする、LinuxまたはUNIXプラットフォームでのOracle BIサーバー・コンポーネントのデプロイメントに適用されます。

LinuxまたはUNIX上に、NTFSセキュリティ・スタイルを使用するOracle BIサーバー・コンポーネントがデプロイされた環境では、Network Appliance Data ONTAPストレージのオペレーティング・システムのバージョンは6.3.1以上をお薦めします。

LinuxコンピュータまたはUNIXコンピュータで、Data ONTAP(バージョン6.0.3 - 6.3)のNTFS qtreeに設計を保存しようとすると、権限エラーが発生する場合があります。設計ファイルの保存後、NTFS qtreeでのUNIX権限設定の試行をサイレントに無視するには、次のData ONTAP設定を使用します。

options cifs.ntfs_ignore_unix_security_ops on

5 パフォーマンス・チューニングと問合せキャッシングの管理

この章では、パフォーマンス・チューニングの概要やシステム・メトリックの監視に関する情報も含めて、Oracle Business Intelligenceの問合せのパフォーマンスを向上する方法について説明します。また、問合せキャッシュを管理および使用する方法についても説明します。問合せキャッシュ機能により、Oracle BIサーバーは、問合せの結果をキャッシュ・ファイルに保存し、後で同様の問合せが要求されたときにその結果を再利用できます。キャッシュを使用すると、問合せに対するデータベース処理の回数が1回で済み、問合せを実行するたびにデータベースを処理する必要はありません。

お使いのシステムのパフォーマンス・チューニングについては、次のOracle Fusion Middlewareのリソースも参照してください。

パフォーマンスのチューニング

Oracle WebLogic Serverのパフォーマンスのチューニング

この章の内容は次のとおりです。

- サービス・レベルの監視

- 問合せのパフォーマンス・チューニングについて

- Fusion Middleware Controlでのパフォーマンス・パラメータの設定

- Oracle BIサーバーの問合せキャッシュについて

- 問合せキャッシングの構成

- キャッシュの監視と管理

- キャッシュの使用方針

- イベント・ポーリング表によるキャッシュ・イベントの処理

- Oracle BI Presentation Servicesキャッシュ設定の管理

- Oracle BI Webクライアントのパフォーマンスの向上

- Oracle Business IntelligenceのJVMヒープ・サイズの設定

- ダイナミック・モニタリング・サービスを使用したメトリックの取得

サービス・レベルの監視

サービス・レベルを理解するには、通常、プロセスの状態を監視し、システム・メトリックを表示します。

Oracle Business Intelligenceは、ランタイム・パフォーマンスをリアルタイムで継続的に自動測定します。パフォーマンス・メトリックは自動的に有効になるため、メトリックを収集するためにオプションの設定や追加構成の実行は必要ありません。

特定のOracle Business Intelligenceインストール内のシステム・コンポーネントの場合、システム・メトリックをFusion Middleware Controlで参照できます。アプリケーションの実行速度の低下や停止などの問題が発生した場合、詳細なパフォーマンス情報を表示して、その問題について詳しく調べることができます。

WSLTコマンドを使用してメトリック情報を定期的にファイルに保存すると、過去のメトリック値の記録を作成できます。『WebLogic Server WLSTコマンド・リファレンス』のDMSカスタムWLSTコマンドに関する項を参照してください。

Oracle WebLogic Server管理コンソールを使用して、Javaコンポーネントのメトリックを表示することもできます。

この項では、次の項目について説明します。

- すべてのOracle Business Intelligenceメトリックを表示するためのFusion Middleware Controlの使用

- Javaコンポーネントのメトリックを表示するための管理コンソールの使用

すべてのOracle Business Intelligenceメトリックを表示するためのFusion Middleware Controlの使用

Fusion Middleware Controlの「パフォーマンス・サマリー」ページから、使用可能なすべてのOracle Business Intelligenceメトリックを表示してグラフを作成できます。

データは、一時的にロギングされます(つまり、ロギングが開始されるのは、そのページを表示し、特定のメトリックを表示するように選択したときです)。

1. ツリー・ナビゲータで、「Business Intelligence」フォルダを開き、biinstanceノードを右クリックします。

2. 「監視」を選択し、「パフォーマンス・サマリー」を選択します。「パフォーマンス・サマリー」ページが表示され、このOracle Business Intelligenceインストールで選択されているメトリックが表示されます。

3. 「パフォーマンス・サマリー」ページに表示されているメトリックをカスタマイズするには、「メトリック・パレットの表示」をクリックします。次に、該当のメトリック・カテゴリを開き、個々のメトリックを選択するか、選択を解除します。選択するメトリックが、「パフォーマンス・サマリー」ページに表示されます。

特定のメトリックの詳細は、メトリックを右クリックし、「ヘルプ」をクリックします。

Javaコンポーネントのメトリックを表示するための管理コンソールの使用

Javaコンポーネントのメトリックを表示するには、管理コンソールを使用します。

選択されている管理対象サーバーの「監視」タブでメトリックを表示したり、メトリック・ブラウザを使用したりできます。デプロイメントが簡易インストール・タイプに基づいている場合は、管理サーバーの「監視」タブを使用します。

1. 管理コンソールにログインします。

2. 「ドメイン構造」ウィンドウの「環境」ノードを開きます。

3. 「サーバー」をクリックします。「サーバーのサマリー」ページが表示されます。

4. サーバー名(oracle_bi1やAdminServer(admin)など)をクリックします。

5. 「監視」タブをクリックします。
このページに表示されるメトリックの詳細は、「ヘルプ」をクリックします。

1. 管理コンソールにログインします。

2. 「チャートとグラフ」で、「監視ダッシュボード」をクリックします。

3. 「メトリック・ブラウザ」タブをクリックします。

メトリック・ブラウザの使用の詳細は、「ヘルプ」をクリックします。

問合せのパフォーマンス・チューニングについて

この項では、Oracle BIサーバーにおいて問合せのパフォーマンスを向上する上で重要ないくつかの考慮事項について説明します。

問合せのパフォーマンス向上に使用できる方法の概要を、次に示します。

- 基礎となるデータベースのチューニングと索引付け: Oracle BIサーバーのデータベース問合せを迅速に返すには、基礎となるデータベースを正しく構成、チューニングおよび索引付けする必要があります。データベース製品ごとにチューニングの考慮事項がそれぞれ異なるので注意してください。
基礎となるデータベースからの戻りに時間がかかる問合せがある場合は、問合せのSQL文を問合せログに取得し、それをデータベース管理者(DBA)に提供して分析してもらいます。「問合せログの管理」を参照してください。

- 集計表: 問合せのパフォーマンスを向上するには、集計表の使用が非常に重要です。集計表には、データの合計があらかじめ計算されて含まれています。詳細な数千もの行から答えを再計算するより、集計表から答えを取得する方がはるかに高速です。
Oracle BIサーバーでは、リポジトリに正しく指定されている場合、集計表が自動的に使用されます。集計ナビゲーションの設定例については、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

- 問合せキャッシング: Oracle BIサーバーでは、後続の問合せで再利用するために、問合せ結果を保存しておくことができます。問合せキャッシングにより、よく使用されるダッシュボードの場合は特に、ユーザーに対する見かけ上のシステム・パフォーマンスが大幅に向上します。ただし、ほとんどの非定型な分析ではパフォーマンスは向上しません。「Oracle BIサーバーの問合せキャッシュについて」を参照してください。

- Fusion Middleware Controlでのパラメータの設定: Fusion Middleware Controlを使用して各種のパフォーマンス構成パラメータを設定することで、システムのパフォーマンスを向上できます。「Fusion Middleware Controlでのパフォーマンス・パラメータの設定」を参照してください。

- NQSConfig.INI内のパラメータの設定: NQSConfig.INIファイルには、一時記憶域用のディスク容量を構成するパラメータ、仮想表のページ・サイズを設定するパラメータ、その他の詳細な構成設定など、Oracle BIサーバーの構成およびチューニングの追加パラメータが含まれています。「構成ファイル設定」を参照してください。

システム・コンポーネントをスケールアウトしてスループットを増加することによっても、システムの全体のパフォーマンスを向上できます。「デプロイメントのスケーリング」を参照してください。

Fusion Middleware Controlでのパフォーマンス・パラメータの設定

Fusion Middleware Controlで設定できるいくつかのパフォーマンス・オプションがあります。

この項では、次の項目について説明します。

- RPD更新を禁止するためのFusion Middleware Controlの使用

- ユーザー・セッションのログオフ期間を設定するためのFusion Middleware Controlの使用

- 表およびピボット・テーブルのデータに対する構成オプションを設定するためのFusion Middleware Controlの使用

- 表をレンダリングするために処理する最大行数を設定するためのFusion Middleware Controlの使用

RPD更新を禁止するためのFusion Middleware Controlの使用

Fusion Middleware Controlを使用して、デフォルト・リポジトリ・ファイルへの更新を許可するか回避するかを指定できます。

このパラメータの設定は、管理ツールがオンライン・モードおよびオフライン・モードで接続されている際、リポジトリを更新できるかどうかに影響します。また、biserverxmlcliなど他のユーティリティを使用して、他のリポジトリ更新操作を実行できるかどうかにも影響します。リポジトリの更新を回避する場合、集計の永続性機能は使用できないことに注意してください。

リポジトリの更新を回避すると、Oracle BIサーバーのパフォーマンスが向上する可能性があります。このモードではOracle BIサーバーがロック・コントロールを処理する必要がないからです。

リポジトリの更新の回避を選択すると、管理ツールがオンライン・モードまたはオフライン・モードでリポジトリを開くときに、リポジトリが読取り専用であるというメッセージがユーザーに通知されます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. 「Business Intelligence概要」ページに移動します。

2. 「構成」ページの「パフォーマンス」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. 「RPD更新を許可しない」を選択して、リポジトリ・ファイルへの更新を回避します。

「このページのヘルプ」メニュー・オプションをクリックして、ページレベル・ヘルプにアクセスします。

5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。

6. 「可用性」ページの「プロセス」タブに移動して、「すべて再起動」をクリックします。

対応する構成ファイルの要素の詳細は、ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピングを参照してください。

ユーザー・セッションのログオフ期間を設定するためのFusion Middleware Controlの使用

ユーザーが自動的にログオフされるまでの経過時間(分単位)をオーバーライドできます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. 「Business Intelligence概要」ページに移動します。

2. 「構成」ページの「パフォーマンス」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. ページのヘルプ・トピックの説明を使用して、「ユーザー・セッションの失効」オプションを設定します。

「このページのヘルプ」メニュー・オプションをクリックして、ページレベル・ヘルプにアクセスします。

5. 「適用」をクリックし、「変更のアクティブ化」をクリックして、変更を実行し、別のシステム管理者が変更できるようにロックを解除します。

6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

対応する構成ファイルの要素の詳細は、ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピングを参照してください。

表およびピボット・テーブルのデータに対する構成オプションを設定するためのFusion Middleware Controlの使用

この手順では、表およびピボット表のデータの基本的な構成オプションについて説明します。

詳細な構成の設定は、「ビュー内のデータの表示と処理の構成」で説明されています。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. 「Business Intelligence概要」ページに移動します。

2. 「構成」ページの「パフォーマンス」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. このページのヘルプ・トピックの説明を参照して、各要素を設定します。

次のオプションに関するページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。

- 「最大ダウンロード行数」オプション

- 「1ページ当たりに含める最大行数」オプション

注意:
通常、「表をレンダリングするために処理する最大行数を設定するためのFusion Middleware Controlの使用」で説明されている「最大ダウンロード行数」オプションおよび「表ビューのレンダリング時に処理された最大行数」オプションは、「構成済の許容されている入力レコードの最大数を超えました。」エラーを回避するために同じ値に設定する必要があります。

5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。

6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

対応する構成ファイルの要素の詳細は、ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピングを参照してください。

表をレンダリングするために処理する最大行数を設定するためのFusion Middleware Controlの使用

表をレンダリングするためにOracle BIサーバーからフェッチして処理できる最大行数をオーバーライドできます。

表の行数を減らすと、指定のユーザー・セッションで消費されるシステム・リソースが減少し、パフォーマンスが大幅に向上することがあります。

詳細な構成の設定は、「ビュー内のデータの表示と処理の構成」で説明されています。

この値を設定する際は、次の点に注意してください。

- この指定は、表に適用されます。ピボット・テーブルには適用されません。

- デフォルト値は65000です。最小値は50です。最大値を超えると、表ビューのレンダリング時にサーバーからエラー・メッセージが返されます。最大値は少なくとも16ビットで、プラットフォームによって異なります。この値より大きな値の処理を試みる前に、システムのメモリーがすべて消費される可能性があります。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. 「Business Intelligence概要」ページに移動します。

2. 「構成」ページの「パフォーマンス」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. ページのヘルプ・トピックの説明を使用して、「表ビューのレンダリング時に処理された最大行数」オプションを設定します。50より大きな整数値を入力してください。

「このページのヘルプ」メニュー・オプションをクリックして、ボックスのページレベル・ヘルプにアクセスします。

注意:
通常、「表およびピボット・テーブルのデータに対する構成オプションを設定するためのFusion Middleware Controlの使用」で説明されている「表ビューのレンダリング時に処理された最大行数」オプションおよび「最大ダウンロード行数」オプションは、「構成済の許容されている入力レコードの最大数を超えました。」エラーを回避するために同じ値に設定する必要があります。

注意:
「表ビューのレンダリング時に処理された最大行数」オプションは、instanceconfig.xmlでResultRowLimitを設定します(「構成ファイル要素とのユーザー・インタフェース・ラベルのマッピング」の「パフォーマンス」タブの項を参照)。ResultRowLimitとCubeMaxRecordsは両方とも返される行数を制限します。この制限は大きい値の設定によって決定します(「ピボット・テーブルおよびグラフのキューブ設定を手動で構成する」を参照)。

5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。

6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

対応する構成ファイルの要素の詳細は、ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピングを参照してください。

Oracle BIサーバーの問合せキャッシュについて

Oracle BIサーバーを構成して、問合せ結果セットのディスクベース・キャッシュをローカルに保持できます(問合せキャッシュ)。

問合せキャッシュを使用すると、Oracle BIサーバーがバックエンド・データソースにアクセスせずに、後続の問合せリクエストを多数処理できるため、問合せパフォーマンスが向上します。

バックエンド・データベースで更新が発生すると、問合せキャッシュのエントリが古くなることがあります。このため、次のいずれかの方法を使用して、問合せキャッシュから定期的にエントリを削除する必要があります。

- 手動。Oracle BI管理ツールの「管理」メニューで「キャッシュ」を選択して、キャッシュ・マネージャを開きます。キャッシュ・マネージャでは、パージするキャッシュ・エントリやパージする日時をきわめて柔軟に選択できますが、手動の作業が必要です。「キャッシュ・マネージャの使用」を参照してください。

- 自動。管理ツールでは、システムのキャッシュの無効化、特定の物理表のキャッシュ属性の設定、およびOracle Business Intelligenceイベント表を使用してのキャッシュの自動パージが可能です。「キャッシュの監視と管理」を参照してください。

- プログラムによるサポート。Oracle BIサーバーには、プログラムでキャッシュ・エントリをパージするためのODBC拡張関数があります。これらの関数により、イベント表の自動化に関して、キャッシュ・マネージャの選択とタイミングの柔軟性が高まります。独自のスクリプトを記述して、これらの関数を必要に応じて呼び出すことができます。「ODBCプロシージャを使用するキャッシュのパージと保守」を参照してください。

問合せキャッシングを制御するパラメータは、Fusion Middleware Controlと、「構成ファイル設定」に記載されているNQSConfig.INIファイルにあります。「Oracle BIサーバー・キャッシュをシードするためのエージェントの使用」を参照してください。

この項では、次の項目について説明します。

- 問合せキャッシュのアーキテクチャ

- キャッシングの利点

- キャッシングに伴う代償

- ユーザー間でのキャッシュの共有

- XMLデータソースのリフレッシュ間隔について

- グローバル・キャッシュについて

問合せキャッシュのアーキテクチャ

問合せキャッシュは、キャッシュ記憶領域、キャッシュ・メタデータおよび問合せコンパイルでのキャッシュ検出で構成されます。

Oracle BIサーバーのキャッシュ・メタデータへのアクセスのプロセスは非常に高速です。メタデータがキャッシュ・ヒットを示す場合は、大部分の問合せ処理がなくなり、ユーザーに結果が即時に返されます。新しい結果をキャッシュに追加するプロセスは、ユーザーに返される結果には関係しません。実行中の問合せに影響するのは、キャッシュされた結果を書き込むプロセスで使用されるリソースだけです。

問合せキャッシュ・エントリは、WindowsやUNIXの64ビットのアーキテクチャなどの異なるオペレーティング・システム間で移植可能です。互換性のないキャッシュ・エントリは、自動的に削除されます。

問合せキャッシュ・エントリは、Oracle Business Intelligenceのバージョン10.1.3.2と11.1.1など、異なるリリース間では移植不可能であることに注意してください。

キャッシングはサブリクエスト・レベルでデフォルトで発生し、SQL文によっては複数のキャッシュ・エントリが生じます。リアルタイムと過去のデータを組み合せた問合せの場合は特に、サブリクエストのキャッシングによって、パフォーマンスとキャッシュ・ヒット率が向上します。サブリクエスト・キャッシングを無効にするには、NQSConfig.INIファイルのパラメータDISABLE_SUBREQUEST_CACHINGをYESに設定します。「構成ファイル設定」を参照してください。

キャッシングの利点

問合せを最も速く処理する方法は、大部分の処理をスキップして、あらかじめ計算された答えを使用する方法です。

問合せキャッシングにより、Oracle BIサーバーは、問合せのあらかじめ計算された結果をローカル・キャッシュに保存します。別の問合せでその結果を使用できる場合、その問合せに対するすべてのデータベース処理がなくなります。これにより、平均問合せレスポンス時間が大幅に向上します。

パフォーマンスが向上すること、およびローカル・キャッシュから問合せに応えることができることにより、ネットワーク・リソースとデータベース・サーバーの処理時間も節約できます。ネットワーク・リソースを節約できるのは、中間結果がネットワーク経由でOracle BIサーバーに届けられる必要がないためです。データベース上で問合せを実行しない分、データベース・サーバーは別の処理を実行できます。データベースが課金式のシステムを使用している場合は、経費も節減できます。

キャッシュを使用して問合せに応えるもう1つの利点は、問合せ結果が複数のデータベースから取得される場合は特に、Oracle BIサーバーの処理時間が短縮されることです。問合せによっては、かなりの数の結合とソートの処理がサーバーで実行されます。問合せがあらかじめ計算されていればこの処理が回避され、サーバー・リソースを他の処理で使用することもできます。

要約すると、問合せキャッシングには、次の利点があります。

- 問合せパフォーマンスの大幅な向上

- ネットワーク・トラフィックの減少

- データベース処理の低減

- Oracle BIサーバーでの処理のオーバーヘッドの低減

キャッシングに伴う代償

問合せキャッシングには明らかに多くの利点がありますが、次のような代償も伴います。

- キャッシュ用のディスク領域

- キャッシュを管理するためのコスト

- キャッシュされた結果が古くなる可能性

- サーバー・コンピュータ上のCPUとディスクI/O

キャッシュ管理では、通常、利点が代償をはるかに上回ります。

次の各項で、キャッシングに伴う代償について説明します。

ディスク領域

問合せキャッシュには、専用のディスク領域が必要です。

領域の大きさは、問合せのボリューム、問合せ結果セットのサイズおよびキャッシュに割り当てるために選択するディスク領域の大きさに依存します。パフォーマンスを向上するためには、ディスクをキャッシング専用で使用し、必ずパフォーマンスと信頼性に優れたディスク・システムとなるようにします。

管理タスク

管理タスクには、キャッシングに関連するがものがあります。各物理表に対して、その表内のデータの更新間隔を理解した上で、キャッシュの保持時間を適切に設定する必要があります。

更新の頻度が状況によって異なる場合は、変更が発生するタイミングを追跡し、必要に応じてキャッシュを手動でパージする必要があります。キャッシュのイベント・ポーリング表を作成し、データベースに対する変更が発生するときにポーリング表を更新するようにアプリケーションを変更することで、システムをイベント駆動型にすることもできます。

Oracle BIサーバーには、プログラムでキャッシュ・エントリをパージするためのODBC拡張関数もあります。独自のスクリプトを作成して、適切なタイミングでこれらの関数を呼び出すことができます。

最新の状態のキャッシュの維持

基礎となるデータベース内のデータが変更されたときにキャッシュ・エントリがパージされないと、問合せが返す結果が最新のものでなくなる可能性があります。

これが許容できるかどうかを評価する必要があります。キャッシュに多少古いデータが含まれていても、許容できる場合があります。許容できる古いデータのレベルを決定し、そのレベルを反映する一連のルールを構成(およびルールに準拠)する必要があります。

たとえば、大規模な複合企業の企業データを分析するアプリケーションがあり、企業内の様々な部門の年次サマリーを作成しているものとします。新しいデータは翌年度のサマリーにのみ影響するため、実質的には問合せに影響しません。この場合、キャッシュをパージするかどうかを決定するときに、トレードオフを考慮した上で、キャッシュにエントリを残しておくようにすることもできます。

ただし、データベースが1日に3回更新され、本日のアクティビティについて問合せを実行しているような場合は、例外です。その場合は、より頻繁にキャッシュをパージするか、場合によってはキャッシュをまったく使用しないようにすることも検討する必要があります。

また、定期的に(たとえば、1週間に1回)、データ・マートを最初から再構築するシナリオも考えられます。この例の場合、データ・マートの再構築のプロセスの一環としてキャッシュ全体をパージすることで、キャッシュ内に古いデータが残ることがなくなります。

どのような状況でも、ユーザーに返される最新でない情報として許容されるものは何であるかを評価する必要があります。

CPU使用率とディスクI/O

通常はごくわずかであるとはいえ、問合せキャッシングではCPU時間が必要であり、ディスクI/Oが増加します。

ほとんどの場合、CPU使用率とディスクI/Oは微々たるものです。ディスクI/Oの増加は、問合せで大量のデータ・セットが返される場合にのみ顕著となる可能性があります。

ユーザー間でのキャッシュの共有

特定の接続プールに対して共有ログオンが有効化されている場合は、ユーザー間でのキャッシュの共有が可能であり、ユーザーごとにキャッシュをシードする必要はありません。

共有ログオンが有効ではなく、ユーザー固有のデータベース・ログオンが使用されている場合は、各ユーザーが独自のキャッシュ・エントリを生成します。

接続プールの共有ログオンの有効化については、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

XMLデータソースのリフレッシュ間隔について

通常、XMLデータソースは頻繁にリアルタイムで更新されます。XMLデータソースのリフレッシュ間隔を設定することは、データベース表のキャッシュの永続性を設定するようなものです。

リフレッシュ間隔とは、キャッシュ内の結果を使用するのではなく、XMLデータソースに対する問合せが再び直接実行されるまでの時間間隔です。このリフレッシュ間隔は、「接続プール」ダイアログの「XML」タブで指定します。

間隔のデフォルト設定は「infinite」で、これは、XMLデータ・ソースが自動的にリフレッシュされないことを意味します。

リフレッシュ間隔を設定すると、Oracle BIサーバーXML Gatewayの接続がリフレッシュされる時間間隔が次のように決定されます。

- http://またはhttps://で始まるURLの場合、ゲートウェイは、所定の時間間隔が過ぎるとリフレッシュされます。

- ローカル・ドライブまたはネットワーク・ドライブ上のURLの場合、ゲートウェイは、所定の時間間隔が過ぎて、システムがURLの変更を検出したときにリフレッシュされます。

XMLデータソースの詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

グローバル・キャッシュについて

クラスタ環境では、グローバル・キャッシュと呼ばれる共有キャッシュにアクセスするようにOracle BIプレゼンテーション・サービスを構成できます。

このグローバル・キャッシュは、共有ファイル・システムのストレージ・デバイスに配置されており、パージ・イベント、シード・イベント(多くの場合はエージェントによって生成されます)、およびシード・イベントと関連付けられた結果セットを保存します。シード・イベントとパージ・イベントは、論理イベント・キューとして、時間でソートされ、共有記憶域に保存されます。個々のOracle BIプレゼンテーション・サービス・ノードは、論理イベント・キューに対してプッシュおよびプルを行います。各Oracle BIプレゼンテーション・サービスでは、通常の問合せ用に独自のローカル問合せキャッシュが引き続き保持されます。

次の図は、クラスタ環境内でのグローバル・キャッシュを示しています。グローバル・キャッシュを共有している3つのOracle BIプレゼンテーション・サービス・ノードが示されています。グローバル・キャッシュには、論理イベント・キューに保持されているシード・イベントまたはパージ・イベントが保存されています。ノード2およびノード3から共有キャッシュに向かう矢印は、Oracle BIプレゼンテーション・サービス・ノード2がシード・イベントをキューにプッシュし、Oracle BIプレゼンテーション・サービス・ノード3がパージ・イベントをキューにプッシュしていることを示します。共有記憶域から各Oracle BIプレゼンテーション・サービス・ノードに向かう矢印は、各ノードが共通の場所からプルしていることを示します。これは定期的に発生し、参加しているOracle BIプレゼンテーション・サービス・ノードが他のOracle BIプレゼンテーション・サービスによって行われた論理イベント・キューへの更新を取得できます。

Oracle BIプレゼンテーション・サービス・ノードは、最初にキャッシング・システムでシーディング・イベントまたはパージ・イベントをローカルに処理します。次に、共有記憶域上のグローバル・キャッシュにイベントをプッシュします。イベントをプッシュするときに、アクティブなOracle BIプレゼンテーション・サービス・ノードは共有記憶域上の論理イベント・キューをロックして、シード・イベントまたはパージ・イベントをプッシュします。シードとパージが競合する場合は(たとえば、あるノードが問合せをシードし、別のノードが同じ問合せをパージしようとする場合)、最後のイベントが適用されます。

共有記憶域上のグローバル・キャッシュ内の論理イベント・キューは、個々のOracle BIプレゼンテーション・サービス・ノードからのシード・イベントとパージ・イベントで構成されます。キューは、イベントのタイムスタンプでソートされます。このため、クラスタに参加しているすべてのOracle BIプレゼンテーション・サービス・ノードのクロックが同期している必要があります。

各Oracle BIプレゼンテーション・サービス・ノードは、グローバル・キャッシュを定期的にポーリングして新しいキャッシュ・エントリを検出します。このポーリングの頻度は構成可能です。共有記憶域にあるキューに入っている論理イベントのスナップショットが元のノードにプルされ、ローカル論理イベント・キューが構成されてから、処理されます。

注意:

クラスタに参加しているすべてのOracle BIプレゼンテーション・サービス・ノードに対するシード・キャッシュの設定またはパージの処理はリアルタイムでは実行されず、処理にかかる時間は、あらかじめ定義されたポーリング間隔、ネットワーク・バンド幅、CPUの負荷などの複数の要因の影響を受けます。

問合せキャッシュの結果セットは大きくなりがちなため、ネットワーク・バンド幅に関する制約を受ける可能性があります。したがって、次の項目を慎重に選択する必要があります。

- シード・キャッシュに適したキャッシュのセット

- 共有記憶域からシード・キャッシュを取得するBIノードの時間間隔(ネットワークの混雑の回避が目的)

主要なグローバル・キャッシュ・パラメータは、Fusion Middleware Controlで構成します。その他のオプションのパラメータは、クラスタに参加している各Oracle BIプレゼンテーション・サービス・ノードのNQSConfig.INIファイルで構成します。「グローバル・キャッシュ・パラメータを設定するためのFusion Middleware Controlの使用」および「追加のグローバル・キャッシュ・パラメータの手動での編集」を参照してください。

シード・プロシージャまたはパージ・プロシージャは、特定のOracle BIプレゼンテーション・サービス・ノードに対して発行されます。そのOracle BIプレゼンテーション・サービスがBIクラスタ内のノードであり、グローバル・キャッシュ・パラメータがOracle BIプレゼンテーション・サービス構成ファイルで定義されている場合、シード・イベントまたはパージ・イベントは、同じクラスタ環境に参加しているすべてのOracle BIプレゼンテーション・サービス・ノードに伝播されます。

問合せキャッシングの構成

問合せキャッシュとグローバル・キャッシュのどちらに対しても、キャッシュ記憶域などのパラメータは、Fusion Middleware ControlとNQSConfig.INIファイルで構成します。

古いキャッシュ・エントリのフラッシュの方針についても決める必要があります。詳細は、「キャッシュの監視と管理」を参照してください。

この項では、次の項目について説明します。

- 問合せキャッシングを有効または無効にするためのFusion Middleware Controlの使用

- 問合せキャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

- 追加の問合せキャッシュ・パラメータの手動での編集

- グローバル・キャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

- 追加のグローバル・キャッシュ・パラメータの手動での編集

問合せキャッシングを有効または無効にするためのFusion Middleware Controlの使用

Fusion Middleware Controlを使用して、問合せキャッシングを有効または無効にできます。

問合せキャッシュは、デフォルトで有効化されています。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. Fusion Middleware ControlのOracle Business Intelligenceページの表示の説明に従って、Business Intelligenceの「概要」ページに移動します。

2. 「構成」ページの「パフォーマンス」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. 問合せキャッシングを有効にするには、「キャッシュ有効」を選択します。問合せキャッシングを無効にするには、「キャッシュ有効」の選択を解除します。

「このページのヘルプ」メニュー・オプションをクリックして、ページレベル・ヘルプにアクセスします。

5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。

6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

対応する構成ファイルの要素の詳細は、ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピングを参照してください。

問合せキャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

Fusion Middleware Controlを使用して、問合せキャッシュ内のキャッシュ・エントリの最大数と、1つのキャッシュ・エントリの最大サイズを設定できます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. Fusion Middleware ControlのOracle Business Intelligenceページの表示の説明に従って、Business Intelligenceの「概要」ページに移動します。

2. 「構成」ページの「パフォーマンス」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. このページのヘルプ・トピックの説明を参照して、各要素を設定します。

次のオプションに関するページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。

- 最大キャッシュ・エントリ・サイズ

- 最大キャッシュ・エントリ

5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。

6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

対応する構成ファイルの要素の詳細は、ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピングを参照してください。

追加の問合せキャッシュ・パラメータの手動での編集

追加の問合せキャッシュ・パラメータをNQSConfig.INIファイルに設定できます。

次のようなパラメータがあります。

- DATA_STORAGE_PATHSパラメータは、問合せキャッシュ記憶域用の1つ以上のディレクトリと、各記憶域ディレクトリの最大サイズを指定します。これらのディレクトリは、キャッシュされた問合せ結果を保存するのに使用され、キャッシュ・ヒットが発生するとアクセスされます。キャッシュ・ヒットの発生の詳細は、「キャッシュ・ヒットについて」を参照してください。
キャッシュ記憶域ディレクトリは、パフォーマンスに優れたストレージ・デバイス上に存在し、キャッシュ記憶域専用であることが理想です。キャッシュ記憶域ディレクトリがいっぱいになり始めると、最低使用頻度(LRU)のエントリが破棄されて、新しいエントリ用の領域が確保されます。

- MAX_ROWS_PER_CACHE_ENTRYパラメータは、キャッシュ・エントリの最大行数を制御します。行数の制限は、大量の行を返すリソース集中型の問合せによるキャッシュ領域の使用を防ぐのに有効な手段です。問合せが返す行数がMAX_ROWS_PER_CACHE_ENTRYパラメータで指定される値を超える場合、問合せはキャッシュされません。

- 通常、以前に実行した問合せからキャッシュ・ヒットが得られる場合、新しい問合せはキャッシュに追加されません。POPULATE_AGGREGATE_ROLLUP_HITSパラメータは、以前に実行した問合せの集計をロールアップしてキャッシュ・ヒットが発生した場合のこのデフォルトを上書きします。

追加の問合せキャッシュ・パラメータの詳細は、「構成ファイル設定」を参照してください。

グローバル・キャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

グローバル・キャッシュ・パラメータを設定すると、システム・キャッシュ構成全体で一貫性が保たれます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. Fusion Middleware ControlのOracle Business Intelligenceページの表示の説明に従って、Business Intelligenceの「概要」ページに移動します。

2. 「構成」ページの「パフォーマンス」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. このページのヘルプ・トピックの説明を参照して、各要素を設定します。

次のオプションに関するページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。

- グローバル・キャッシュ・パス

- グローバル・キャッシュ・サイズ

5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。

6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

対応する構成ファイルの要素の詳細は、ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピングを参照してください。

追加のグローバル・キャッシュ・パラメータの手動での編集

追加のグローバル・キャッシュ・パラメータをNQSConfig.INIファイルに設定できます。

次のようなパラメータがあります。

- MAX_GLOBAL_CACHE_ENTRIESパラメータは、グローバル・キャッシュ・ストア内で許可されるエントリの最大数を制御します。

- CACHE_POLL_SECONDSパラメータは、Oracle BIサーバーがクラスタ内の他のサーバー・ノードと同期するために論理イベント・キューからプルする間隔を秒単位で指定します。

- CLUSTER_AWARE_CACHE_LOGGINGパラメータは、グローバル・キャッシュのロギングを有効にするかどうかを制御します。この設定をYESに変更するのは、デバッグを目的とする場合のみです。
ログ・エントリはnqquery.logにあります。このファイルは次の場所にあります:

BI_DOMAIN/servers/obisn/logs

「構成ファイル設定」を参照してください。

キャッシュの監視と管理

基礎となるデータベース内の変更を管理し、キャッシュ・エントリを監視するには、キャッシュの管理方針を決める必要があります。

キャッシュ・エントリの作成元である、基礎となる表内のデータが変更されたときにキャッシュ・エントリを無効化するプロセスと、不要なキャッシュ・エントリを監視、識別および削除するプロセスが必要です。

この項では、次の項目について説明します。

- キャッシュ管理方針の選択

- ODBCプロシージャを使用するキャッシュのパージと保守

- リポジトリの変更が問合せキャッシュに及ぼす影響

キャッシュ管理方針の選択

キャッシュ管理方針の選択は、基礎となるデータベース内のデータの変動性と、この変動を引き起こす変更の予測可能性に依存します。

また、キャッシュに含まれる問合せの数と種類、およびその問合せの使用状況にも依存します。この項では、様々なキャッシュ管理方法の概要を説明します。

システムのキャッシングの無効化

システム全体のキャッシングを無効にすることで、新しいすべてのキャッシュ・エントリを停止し、既存のキャッシュを使用する新しい問合せを停止できます。キャッシングを無効にしても、キャッシュ内に保存されているエントリを失うことなく、後で有効にできます。

キャッシュ・エントリが古い疑いがあるが、そのエントリまたはキャッシュ全体をパージする前に、それが本当に古いかどうかを確認することが望まれる状況では、キャッシングの一時的な無効化の方針が役に立ちます。キャッシュに保存されているデータに依然として関連性があることが判明した場合、または問題のエントリを無事にパージした後で、キャッシュを安全に有効化できます。必要に応じて、キャッシュを再び有効化する前に、キャッシュ全体をパージするか、特定のビジネス・モデルに関連するキャッシュをパージします。

「問合せキャッシングを有効または無効にするためのFusion Middleware Controlの使用」を参照してください。

指定された物理表のキャッシングとキャッシュ永続時間

各物理表のキャッシュ可能属性を設定することで、その表に対する問合せをキャッシュに追加して、今後の問合せに答えを返すかどうかを指定できます。

表のキャッシングを有効にすると、表に関係する問合せがキャッシュに追加されます。デフォルトではすべての表がキャッシュ可能ですが、「キャッシュ永続時間」の設定を使用している場合を除き、表によってはキャッシュに含める必要がない可能性があります。たとえば、毎分更新される株価データを保存している表があるものとします。「キャッシュ永続時間」の設定を使用すると、その表のエントリを59秒ごとにパージできます。

「キャッシュ永続時間」フィールドを使用して、この表のエントリを問合せキャッシュに格納する時間を指定することもできます。これは、頻繁に更新されるデータ・ソースに役立ちます。

1. 管理ツールの物理レイヤーで、物理表をダブルクリックします。

2. 「物理表プロパティ」ダイアログの「一般」タブで、次のいずれかを選択します。

- キャッシングを有効にするには、「キャッシュ可能」を選択します。

- 表をキャッシュしないようにするには、「キャッシュ可能」の選択を解除します。

3. キャッシュの有効期限を設定するには、「キャッシュ永続時間」を指定し、単位(日、時間、分または秒)を指定します。キャッシュ・エントリが自動的に期限切れにならないようにするには、「キャッシュ失効なし」を選択します。

4. 「OK」をクリックします。

Oracle BIサーバーのイベント・ポーリング表の構成

Oracle BIサーバーのイベント・ポーリング表には、基礎となるデータベース内の更新に関する情報が保存されます。

データベース表が更新されるたびにイベント・ポーリング表に行を追加するように、アプリケーション(データ・マートにデータをロードするアプリケーションなど)を構成できます。Oracle BIサーバーは、設定された間隔でこの表をポーリングし、更新された表に対応するキャッシュ・エントリを無効にします。イベント・ポーリング表は、キャッシュ管理の唯一の方法の場合もあれば、他のキャッシュ管理方式とともに使用することもできます。イベント表は、キャッシュ・エントリの選択とパージのタイミングに関して、あまり柔軟性はありません。「物理データベース上でのイベント・ポーリング表の設定」を参照してください。

ODBCプロシージャを使用するキャッシュのパージと保守

Oracle BIサーバーには、キャッシュ・エントリをパージするためのODBC拡張関数があります。

これらの関数の中には、抽出、変換およびロード(ETL)タスクに埋め込むのに特に役立つものがあります。たとえば、毎晩のETLの実行後に、すべてのOracle BIサーバー・キャッシュ・エントリをパージできます。ファクト表だけが変更された場合は、その表に関連するキャッシュのみをパージできます。場合によっては、特定のデータベースに関連するキャッシュ・エントリをパージする必要があります。

キャッシュをパージする権限を持つのは管理者だけです。したがって、このようなODBC拡張関数をコールするスクリプトは、管理者権限の資格証明の下で実行する必要があります。

次のODBC関数は、ODBC接続で指定されるリポジトリに関連するキャッシュ・エントリに影響します。

- SAPurgeCacheByQuery。指定された問合せに完全に一致するキャッシュ・エントリをパージします。たとえば、次の問合せを使用すると、給与が$100,000を超えるすべての従業員の名前を取得する、1つ以上の問合せキャッシュ・エントリが得られます。

SELECT lastname, firstname FROM employee WHERE salary > 100000;

次のコールによって、この問合せに関連するキャッシュ・エントリがパージされます。

Call SAPurgeCacheByQuery('SELECT lastname, firstname FROM employee WHERE salary > 100000' );

- SAPurgeCacheByTable。クライアントが接続されているリポジトリの、指定された物理表名(完全修飾)に関連するすべてのキャッシュ・エントリをパージします。
この関数は、完全修飾された物理表名の4つのコンポーネント(データベース、カタログ、スキーマおよび表名に固有)を表す、最大で4つのパラメータを使用します。たとえば、完全修飾名がDBName.CatName.SchName.TabNameという表があるものとします。Oracle Business Intelligenceリポジトリの物理レイヤーにあるこの表に関連するキャッシュ・エントリをパージするには、スクリプト内で次のコールを実行します。

Call SAPurgeCacheByTable( 'DBName', 'CatName', 'SchName', 'TabName' );

注意:

Oracle BIサーバーでは、この関数内でのワイルドカードをサポートしていません。また、DBNameとTabNameをnullにすることはできません。どちらかがnullの場合は、エラー・メッセージが表示されます。

- SAPurgeAllCache。すべてのキャッシュ・エントリをパージします。このコールの例を次に示します。

Call SAPurgeAllCache();

- SAPurgeCacheByDatabase。特定の物理データベース名に関連するすべてのキャッシュ・エントリをパージします。キャッシュをパージするODBCプロシージャがコールされると、レコードが返されます。この関数では、物理データベース名を表す1つのパラメータを使用し、パラメータをnullにすることはできません。このコールの構文を次に示します。

Call SAPurgeCacheByDatabase( 'DBName' );

ODBCプロシージャ構文について

プロシージャの文字列引数の中に一重引用符がある場合は、もう1つの一重引用符を使用してエスケープする必要があります。

例:

Call SAPurgeCacheByQuery('SELECT TOPN("- Currency"."Markdown %", 10) saw_0,
"XX Line"."Order No" saw_1, "- Bill-To Site"."Customer Name" saw_2, "-
Currency"."Net USD" saw_3, "- Currency"."Markdown USD" saw_4, "-
Currency"."Markdown %" saw_5 FROM "Apps 11i - XX Lines" WHERE
("XX Line"."Open Flag" = ''Y'') AND ("Operating Unit"."Group Name" = ''Group'')
AND ("- Currency"."Net USD" >= 10000) ORDER BY saw_0');

太字の行は、''Y''および''Group''というアイテムのエスケープ文字として使用されている、追加の一重引用符を示しています。

プレゼンテーション・サービス問合せキャッシュの共有について

ユーザーがアンサーにアクセスして問合せを実行すると、プレゼンテーション・サービスは問合せの結果をキャッシュします。

プレゼンテーション・サービスでは、リクエスト・キーと論理SQL文字列を使用して、キャッシュされた結果を後続の問合せが使用できるかどうかを決定します。キャッシュを共有できる場合、後続の問合せは保存されません。

- SAGetSharedRequestKey。プレゼンテーション・サービスから論理SQL文を受け取り、リクエスト・キー値を返すODBCプロシージャ。
このプロシージャの構文を次に示します。

SAGetSharedRequestKey('sql-string-literal')

リクエスト・キーの値は、次の要因の影響を受けます。

- リポジトリ物理データベース・オブジェクトで「仮想プライベート・データベース」オプションが選択されているかどうか

- セッション変数がリポジトリ内で「セキュリティ・センシティブ」としてマークされているかどうか

プレゼンテーション・サービスは、仮想プライベート・データベースとしてマークされているデータベース・オブジェクトに対して、論理リクエストのリクエスト・キーを計算するときに、セキュリティ・センシティブな変数を考慮します。

「Oracle BIプレゼンテーション・サービス・キャッシュ設定の管理」を参照してください。

結果レコードについて

キャッシュをパージするコマンドを実行すると、結果レコードが返されます。

結果レコードには、2つの列が含まれています。最初の列は結果コードで、2番目の列は、パージ操作の結果を説明する短いメッセージです。次の表は、結果レコードの例を示しています。

結果コード

結果メッセージ

1

SAPurgeCacheByDatabaseが正常終了しました。

59115

キャッシュが有効でないため、操作は実行されませんでした。

59116

指定されたデータベースが存在しません。

59117

指定された表が存在しません。

SAP/BWデータソースのキャッシュの保存とパージ

Microsoft Analysis ServicesとSAP/BWのデータ・ソースでは命名規則が異なるため、メンバーの一意の名前を格納するためのキャッシュ・サブシステムがあります。

Microsoft Analysis Servicesでは、メンバーのキャプション名は、メンバーの一意の名前と同じです。しかし、SAP/BWデータソースでは、メンバーのキャプション名とメンバーの一意の名前は異なります。したがって、Oracle BIサーバーでは、SAP/BWメンバーの一意の名前でキャッシュ・サブシステムを保持します。このサブシステムは、デフォルトでは無効です。構成情報については、「構成ファイル設定」のMDX Member Name Cacheセクションに関する項を参照してください。

メンバーの一意の名前で問合せを受信すると、サブシステムはキャッシュを確認して、この問合せに対するキャッシュの有無を判断します。キャッシュが存在する場合、キャッシュされている一意の名前のレコードが返されます。問合せに一致するキャッシュがない場合は、SAP/BWにプロービング問合せが送信されます。

プロービング問合せは、ログ・レベルが2以上の場合にロギングされます。サーバー・ログには、サブシステムが有効かどうかといったサブシステムの状態と、開始イベントや停止イベントなどのイベントも書き込まれます。

注意:
ログ・レベルが上がるごとに、パフォーマンスに影響が及びます。ユーザーのログ・レベルを上げる際は、注意してください。

キャッシュのパージに関して、次の点に留意してください。

- 多次元キャッシュ・エントリのサイズは、非常に大きくなる可能性があります。したがって、NQSConfig.INIファイルのMDX_MEMBER_CACHEセクションで、各メンバー・セットのサイズの制限が設定されています。

- アップグレードの後、保持されているキャッシュの形式が一貫しているとはかぎりません。このため、ソフトウェアのアップグレードの前に、すべてのキャッシュをパージします。

- 問合せを初めて実行するときに、キャッシュが移入されます。パフォーマンスへの影響を最小限にするために、オフピーク時にキャッシュを移入するように調整してください。

注意:
管理ツールでは、キューブ表を右クリックし、「メンバー・キャッシュのパージ」を選択することによって、個々のキューブ表のキャッシュをパージできます。これは、管理者権限を持つユーザーがオンライン・モードで実行する必要があります。

次のパージ・プロシージャは、SAP/BWデータソースに固有のものです。

- SAPurgeALLMCNCache。すべてのSAP/BWキャッシュ・エントリをパージします。
このプロシージャの構文を次に示します。

SAPurgeALLIMCNCache ()

- SAPurgeMCNCacheByCube。指定された物理キューブに関連するすべてのキャッシュ・エントリをパージします。データベース名とキューブ名は、リポジトリ・オブジェクトの外部名です。このプロシージャの構文を次に示します。

SAPurgeMCNCacheByCube( 'DBName', 'CubeName')

次の表は、返されるメッセージを示しています。

リターン・コード

戻りメッセージ

1

SAPurgeALLMCNCacheが正常終了しました。

1

SAPurgeMCNCacheByCubeが正常終了しました。

59116

指定されたデータベースが存在しません。

データベースと物理キューブの両方が間違っている場合に、この結果コードが返されます。

85025

指定された物理キューブが存在しません。

管理権限を持つユーザーのみが、ODBCパージ・プロシージャを実行できます。

リポジトリの変更が問合せキャッシュに及ぼす影響

Oracle Business Intelligenceリポジトリを変更すると、その変更が、キャッシュに保存されているエントリに影響することがあります。たとえば、物理オブジェクトや動的リポジトリ変数の定義を変更すると、そのオブジェクトや変数を参照しているキャッシュ・エントリが有効でなくなる場合があります。このような変更によって、キャッシュをパージする必要が生じる可能性があります。注意を要する3つのシナリオがあります。オンライン・モードで変更が行われる場合、オフライン・モードで変更が行われる場合およびリポジトリ間を切り替えている場合です。

オンライン・モード

オンライン・モードでOracle Business Intelligenceリポジトリを変更する場合、その変更がキャッシュ・エントリに影響するものであれば、変更されたオブジェクトを参照するすべてのキャッシュ・エントリが自動的にパージされます。パージは、変更をチェックインするときに発生します。たとえば、リポジトリから物理表を削除すると、その表を参照しているすべてのキャッシュ・エントリが、チェックイン時にパージされます。ビジネス・モデルとマッピング・レイヤー内でのビジネス・モデルへの変更によって、そのビジネス・モデルのキャッシュ・エントリがすべてパージされます。

オフライン・モード

オフライン・モードでOracle Business Intelligenceリポジトリを変更する場合、キャッシュに保存されている問合せに影響する変更を行い、キャッシュされた結果が古くなる可能性があります。オフライン・モードの編集時にサーバーはリポジトリをロードしないため、行われた変更がキャッシュ・エントリに影響するかどうかを判断できません。このため、オフラインでの変更の後、サーバーによってキャッシュが自動的にパージされることはありません。キャッシュをパージしないと、リポジトリが次にロードされたときに、無効なエントリが存在する可能性があります。オフラインでの変更の影響を受けるエントリがキャッシュに存在しないことが確実な場合を除いて、変更したビジネス・モデルのキャッシュをパージします。

リポジトリ間の切替え

Oracle BIサーバーの構成からリポジトリを削除する予定の場合は、リポジトリを参照するすべてのキャッシュ・エントリのキャッシュをパージする必要があります。パージしないと、キャッシュが損傷します。「管理ツールでのキャッシュのパージ」を参照してください。

動的リポジトリ変数の変更

動的リポジトリ変数の値は、問合せから返されるデータでリフレッシュされます。動的リポジトリ変数を定義する際には、初期化ブロックを作成するか、SQL問合せが含まれる既存の初期化ブロックを使用します。問合せを実行し、変数の値を定期的にリフレッシュする、Oracle BIサーバーのスケジュールも構成します。

動的リポジトリ変数の値が変更されると、列でこの変数を使用するBIサーバーのキャッシュ・エントリが失効し、そのエントリのデータが再び必要となったときに、新しいキャッシュ・エントリが生成されます。古いキャッシュ・エントリはすぐに削除されず、通常のキャッシュ・メカニズムによって消去されるまでそのまま残ります。

キャッシュの使用方針

問合せキャッシングの主要な利点の1つは、表面上の問合せパフォーマンスが向上することです。

問合せキャッシングは、オフピーク時に問合せを実行し、その結果をキャッシングしてキャッシュをシードするために重要であることがあります。適切なシード方針は、キャッシュ・ヒットがいつ発生するかを理解している必要があります。

すべてのユーザーのキャッシュをシードするには、次の問合せでキャッシュをシードします。

SELECT User, SRs

SELECT User, SRsを使用してキャッシュをシードすると、次の問合せがキャッシュ・ヒットです。

SELECT User, SRs WHERE user = valueof(nq_SESSION.USER) (and the user was USER1)
SELECT User, SRs WHERE user = valueof(nq_SESSION.USER) (and the user was USER2)
SELECT User, SRs WHERE user = valueof(nq_SESSION.USER) (and the user was USER3)

この項では、次の項目について説明します。

- キャッシュ・ヒットについて

- キャッシュを移入するための一連の問合せの実行

- Oracle BIサーバー・キャッシュをシードするためのエージェントの使用

- キャッシュ・マネージャの使用

キャッシュ・ヒットについて

キャッシングが有効な場合は、各問合せが評価されて、キャッシュ・ヒットと見なされるかどうかが判断されます。

キャッシュ・ヒットとは、サーバーがキャッシュを使用して問合せに答えを返すことができ、データベースにアクセスする必要がないことを意味します。Oracle BIサーバーは、問合せキャッシュを使用して、集計と同じかそれ以上のレベルで、問合せに答えを返すことができます。

キャッシュがヒットするかどうかは、多くの要因によって決まります。次の表はそれらの要因を示しています。

要因またはルール

説明

SELECTリスト内の列のサブセットが一致している

キャッシュ・ヒットと見なされるためには、新しい問合せのSELECTリスト内のすべての列が、キャッシュされた問合せ内に存在している必要があります。または、問合せ内の列から計算できる必要があります。

このルールはキャッシュ・ヒットの最小要件ですが、このルールを満たしていても、キャッシュ・ヒットが保証されるわけではありません。この表に記載されている他のルールも適用されます。

SELECTリスト内の列を、キャッシュされた問合せの列の式で作成できる

Oracle BIサーバーは、キャッシュされた結果の式を計算して、新しい問合せに答えを返すことができます。ただし、キャッシュされた結果にすべての列がある必要があります。たとえば、次の問合せ

SELECT product, month, averageprice FROM sales WHERE year = 2000

この問合せは、次の問合せのキャッシュをヒットします。

SELECT product, month, dollars, unitsales FROM sales WHERE year = 2000

averagepriceが、dollarsとunitsalesから計算できるためです(averageprice = dollars/unitsales)。

WHERE句が、意味的に同じか、論理的なサブセットである

問合せがキャッシュ・ヒットと見なされるためには、WHERE句による制約が、キャッシュされた結果と同等か、キャッシュされた結果のサブセットである必要があります。

WHERE句が、キャッシュされた問合せの論理サブセットで、そのサブセットが次のいずれかの条件を満たす場合は、キャッシュ・ヒットと見なされます。

- INリスト値のサブセット。キャッシュされた問合せのINリストに含まれる要素より、少ない要素を要求する問合せは、キャッシュ・ヒットと見なされます。次に例を示します。

SELECT employeename, region
FROM employee, geography
WHERE region in ('EAST', 'WEST')

この問合せは、次のキャッシュされた問合せのヒットと見なされます。

SELECT employeename, region
FROM employee, geography
WHERE region in ('NORTH', 'SOUTH', 'EAST', 'WEST')

- キャッシュされた結果より少ない(ただし同一の)OR制約が含まれている。

- リテラル比較の論理サブセットが含まれている。次に例を示します。

WHERE revenue < 1000

この述語は、次の述語を使用する類似の問合せのヒットと見なされます。

WHERE revenue < 5000

- WHERE句がない。WHERE句がない問合せがキャッシュされている場合、他のすべてのキャッシュ・ヒット・ルールを満たす問合せは、そのWHERE句にかかわらず、キャッシュ・ヒットと見なされます。

さらに、WHERE句で使用されている列はプロジェクション・リストに存在する必要があります。次に例を示します。

SELECT employeename
FROM employee, geography
WHERE region in ('EAST', 'WEST')

REGIONがプロジェクション・リストにないため、前のリストのシード中の問合せに対してキャッシュ・ヒットになりません。

ディメンションのみの問合せが完全一致している

問合せがディメンションのみで、問合せにファクトやメジャーが含まれない場合、キャッシュされた問合せの投影列が完全一致する場合のみ、キャッシュはヒットします。これにより、ディメンション表の論理ソースが複数ある場合の誤検出が回避されます。

特殊関数を使用する問合せが完全一致している

時系列関数(AGO、TODATEおよびPERIODROLLING)、極限関数およびオフセット関数(OFFSETおよびFETCH)、関係関数(ISANCESTOR、ISLEAF、ISROOTおよびISSIBLING)、外部集計関数などの特殊関数と一般的にフィルタ・メトリックを含むその他の問合せも、キャッシュされた問合せ内のプロジェクション列と完全一致する必要があります。このようなケースでは、フィルタも完全一致の必要があります。フィルタ・メトリックについては、フィルタ・メトリックをWHERE句として書き直せる場合、サブセット・キャッシュが利用される可能性があります。

一連の論理表が一致している

キャッシュ・ヒットと見なされるためには、受信するすべての問合せが、キャッシュ・エントリと同じ論理表のセットを持つ必要があります。このルールにより、誤ったキャッシュ・ヒットが回避されます。たとえば、SELECT * FROM productは、SELECT * FROM product, salesに一致しません。

セキュリティ・セッション変数を含めて、セッション変数値が一致している

論理SQL文または物理SQL文がセッション変数を参照している場合、セッション変数値が一致している必要があります。一致していない場合、キャッシュはヒットしません。

さらに、セキュリティ・センシティブなセッション変数の値は、論理SQL文自体がセッション変数を参照していない場合であっても、リポジトリ内で定義されるセキュリティ・セッション変数値に一致している必要があります。「行レベルのデータベース・セキュリティを使用している場合の適切なキャッシュ結果の確認」を参照してください。

同等の結合条件

キャッシュ・ヒットと見なされるためには、新しい問合せリクエストで作成された結合済論理表が、キャッシュされた結果と同じ(またはサブセット)である必要があります。

同じDISTINCT属性

キャッシュされた問合せでは、DISTINCT処理(たとえば、SELECT DISTINCT...)により重複するレコードがない場合、キャッシュされた列に対するリクエストにも、DISTINCT処理を含める必要があります。DISTINCT処理が含まれない、同じ列へのリクエストは、キャッシュ・ミスです。

問合せに互換性のある集計レベルが含まれている

集計レベルの情報をリクエストする問合せでは、下位の集計レベルで、キャッシュされた結果を使用できます。たとえば、次の問合せは、仕入先、地域および市区レベルでの販売数量をリクエストしています。

SELECT supplier, region, city, qtysold
FROM suppliercity

次の問合せは、市区レベルでの販売数量をリクエストしています。

SELECT city, qtysold
FROM suppliercity

2番目の問合せは、最初の問合せのキャッシュ・ヒットになります。

追加の集計の制限

たとえば、列qtysoldに関する問合せがキャッシュされている場合、RANK(qtysold)のリクエストはキャッシュ・ミスになります。また、国レベルのqtysoldをリクエストする問合せは、国と地域レベルのqtysoldをリクエストする問合せから、キャッシュ・ヒットを得ることができます。

ORDER BY句がSELECTリスト内の列で構成されている

SELECTリストに含まれていない列でソートする問合せは、キャッシュ・ミスになります。

詳細なヒット検出によるキャッシュ・ミスの回避

NQSConfig.INIファイル内でパラメータUSE_ADVANCED_HIT_DETECTIONをYESに設定することで、一部のキャッシュ・ミスを回避できます。詳細なヒット検出を使用すると、ヒットするキャッシュの拡張検索を行うことができます。「USE_ADVANCED_HIT_DETECTION」を参照してください。

キャッシュ・ヒット動作の診断

キャッシュ・ヒット動作をより適切に評価するには、次の例に示すように、ENABLE_CACHE_DIAGNOSTICSセッション変数を4に設定します。

ENABLE_CACHE_DIAGNOSTICS=4

行レベルのデータベース・セキュリティを使用している場合の適切なキャッシュ結果の確認

仮想プライベート・データベース(VPD)のような行レベルのデータベース・セキュリティ方針を使用している場合、返されるデータ結果は、ユーザーの認可資格証明で決まります。

このため、Oracle BIサーバーは、行レベルのデータベース・セキュリティを使用しているかどうか、およびセキュリティに関係する変数を把握する必要があります。

すべてのセキュリティ・センシティブ変数を含み、照合するキャッシュ・エントリでのみキャッシュ・ヒットが起こるようにするには、データベース・オブジェクトとセッション変数オブジェクトを管理ツールで次のように適切に構成する必要があります。

- データベース・オブジェクト。物理レイヤーにおいて、「データベース」ダイアログの「一般ー」タブで「仮想プライベート・データベース」を選択し、データ・ソースが行レベルのデータベース・セキュリティを使用していることを指定します。
共有キャッシングで行レベルのデータベース・セキュリティを使用している場合は、セキュリティ・センシティブ変数が一致しないキャッシュ・エントリの共有を防ぐために、このオプションを選択する必要があります。

- セッション変数オブジェクト。認証で使用する変数の場合は、「セッション変数」ダイアログで「セッション・センシティブ」を選択して、行レベルのデータベース・セキュリティ方針を使用するときに、この変数がセキュリティを区別できることを指定します。このオプションによって、キャッシュ・エントリはセキュリティ・センシティブ変数としてマークされ、受信するすべての問合せでセキュリティ・センシティブ変数を照合できます。

次のリソースを参照してください。

- Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドのデータベース内での行レベル・セキュリティの設定に関する項

- Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドのセッション変数の管理に関する項

- データベースおよびセッション変数オブジェクトの一般情報は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド

キャッシュを移入するための一連の問合せの実行

キャッシュ・ヒットの可能性を最大限に高める1つの方法は、一連の問合せを実行してキャッシュを移入することです。

キャッシュをシードする一連の問合せを作成するときに使用する問合せの種類に関して、いくつかの推奨事項があります。

- 共通の事前作成問合せ。よく実行される問合せや、処理に多くのリソースが必要な問合せは特に、優れたキャッシュ・シード問合せです。その結果がダッシュボードに埋め込まれる問合せは、共通問合せのよい例です。

- 式が含まれないSELECTリスト。SELECTリストの列から式をなくすと、キャッシュ・ヒットの可能性が広がります。式が含まれるキャッシュ列は、同じ式が含まれる新しい問合せにのみ答えを返します。式が含まれないキャッシュ列は、任意の式を含むその列に対するリクエストに答えを返すことができます。たとえば、キャッシュされた次のようなリクエストがあるものとします。

SELECT QUANTITY, REVENUE...

これは、次のような新しい問合せに答えを返すことができます。

SELECT QUANTITY/REVENUE...

ただし、逆は成り立ちません。

- WHERE句の不使用。キャッシュされた結果にWHERE句がない場合、これを使用して、プロジェクション・リストの列が含まれるSELECTリストとWHERE句のキャッシュ・ヒット・ルールを満たす問合せに、答えを返すことができます。

一般に、キャッシュのシードに最適な問合せは、データベースの処理リソースを大量に使用し、再実行される可能性がある問合せです。多くの行を返す単純な問合せでキャッシュをシードしないように注意してください。このような問合せでは(たとえば、SELECT * FROM PRODUCTS。PRODUCTSは単一のデータベース表に直接マップします)、データベース処理はほとんど必要ありません。このような問合せで問題となるのはネットワークとディスクのオーバーヘッドですが、これらはキャッシングでは軽減されません。

Oracle BIサーバーがリポジトリ変数をリフレッシュする際には、ビジネス・モデルを調べて、そのリポジトリ変数を参照しているかどうかを判断します。参照している場合は、Oracle BIサーバーによって、そのビジネス・モデルのすべてのキャッシュがパージされます。「動的リポジトリ変数の変更」を参照してください。

Oracle BIサーバー・キャッシュをシードするためのエージェントの使用

エージェントを構成して、Oracle BIサーバー・キャッシュをシードできます。

キャッシュをシードすることで、ユーザーが分析を実行したり、ダッシュボードに埋め込まれている分析を表示したりするときのレスポンス時間を向上できます。このデータをリフレッシュするリクエストを実行するようにエージェントをスケジュールすることで、これを実現できます。

1. Oracle Business Intelligenceにログインし、「新規」を選択し、「エージェント」を選択します。

2. 「一般」タブで、「実行者」オプションの「受信者」を選択します。パーソナライズされたキャッシュ・シードでは、各受信者のデータ可視性に基づいて、エージェントによる各受信者へのコンテンツの配信をカスタマイズします。

3. 「スケジュール」タブで、キャッシュをシードするタイミングを指定します。

4. 必要に応じて「条件」を選択し、条件付きリクエストを作成または選択します。たとえば、ETLプロセスがいつ完了するかを決定するビジネス・モデルがあるものとします。このビジネス・モデルに基づくレポートを使用して、キャッシュ・シードを開始する条件付きトリガーとなることができます。

5. 「配信コンテンツ」タブで、個々のリクエスト、またはキャッシュ・シードの対象となるダッシュボード・ページ全体を選択します。ダッシュボード・ページの選択は、時間の節約になります。

6. 「受信者」タブで、受信者である個々のユーザーまたはグループを選択します。

7. 「送信先」タブで、すべてのユーザー送信先の選択を解除し、「Oracle BIサーバー・キャッシュ」を選択します。

8. 右上隅にある「保存」ボタンを選択して、エージェントを保存します。

キャッシュ・シード・エージェントと他のエージェントの唯一の違いは、以前のキャッシュを自動的に消去して、ダッシュボードにアラートとして表示されないことです。

注意:
キャッシュ・シード・エージェントは、完全一致の問合せのみパージするため、古いデータが引き続き存在する可能性があります。エージェント問合せは非定型の問合せやドリルには対処しないため、必ずキャッシング方針には常にキャッシュのパージを含めるようにします。

キャッシュ・マネージャの使用

キャッシュ・マネージャを使用すると、問合せキャッシュ全体に関する情報と、開いているリポジトリに関連付けられている問合せキャッシュ内の個々のエントリに関する情報を表示できます。

また、キャッシュ・マネージャを使用して特定のキャッシュ・エントリを選択し、そのエントリに対して、キャッシュされているSQL文の表示と保存、エントリのパージなど、様々な操作を実行できます。

1. 管理ツールのツールバーで、「管理」→「キャッシュ」を選択します。

2. 左側のエクスプローラ・ペインの「キャッシュ」タブを選択すると、現在のリポジトリのキャッシュ・エントリ、ビジネス・モデルおよびユーザーが表示されます。関連するキャッシュ・エントリが右側のペインに反映され、上部の表示専用フィールドにエントリの総数が表示されます。

「オプション」設定を使用して、キャッシュ・エントリ情報およびその表示順序を制御できます(キャッシュ・マネージャから「編集」を選択し、「オプション」を選択するか、管理ツールのメニューから「ツール」→「オプション」→「キャッシュ・マネージャ」を選択します)。次の表に記載されているオプションを情報に含めることができます。

オプション

説明

ユーザー

キャッシュ・エントリを生成した問合せを発行したユーザーのID。

作成

キャッシュ・エントリの結果セットが作成された時間。

最終使用

キャッシュ・エントリの結果セットが問合せに対応した最後の日時(Oracle BIサーバーが予期せず停止した後、最終使用日時が一時的に実際よりも古い値となることがあります)。

作成経過時間

このキャッシュ・エントリの結果セットを作成するのに必要な時間(秒単位)。

注意: ディスク上のキャッシュ・オブジェクト・ディスクリプタに保存されている値は、ミリ秒単位です。表示用に秒単位に変換されます。

行数

問合せによって生成された行数。

行サイズ

このキャッシュ・エントリの結果セット内の各行のサイズ(バイト単位)。

フル・サイズ

可変長の列、圧縮アルゴリズム、およびその他の要因を考慮して使用される最大サイズ。結果セットの実際のサイズはフル・サイズよりも小さくなります。

列数

このキャッシュ・エントリの結果セットの各行内の列数。

論理リクエスト

このキャッシュ・エントリに関連付けられている論理リクエスト。サブリクエストがキャッシュされている場合、この列にはサブリクエストのテキストが表示されます。

使用回数

このキャッシュ・エントリの結果セットが問合せを満たした回数(Oracle BIサーバーの起動後)。

ビジネス・モデル

キャッシュ・エントリに関連付けられているビジネス・モデルの名前。

リポジトリ

キャッシュ・エントリに関連付けられているOracle Business Intelligenceリポジトリの名前。

SQL

このキャッシュ・エントリに関連付けられているSQL文。サブリクエストがキャッシュされている場合、1つのSQL文に複数のキャッシュ・エントリが関連付けられている可能性があります。

サーバーの問合せ

問合せを処理したOracle BIサーバー。

ファクト表ソース

このキャッシュ・エントリの論理リクエストに関連付けられたファクト表。

リポジトリ・ツリーを開くとすべてのビジネス・モデルとキャッシュ・エントリが表示され、ビジネス・モデルを開くとすべてのユーザーとキャッシュ・エントリが表示されます。右側のペインには、階層ツリー内で選択されているアイテムに関連するキャッシュ・エントリのみが表示されます。

キャッシュ・マネージャ内でのグローバル・キャッシュ情報の表示

グローバル・キャッシュ情報を表示するには、「アクション」を選択し、「情報の表示」を選択します。

次の表は、「グローバル・キャッシュ情報」ウィンドウに表示される情報を示しています。

列

説明

キャッシュ記憶域として使用できる空き容量

キャッシュ記憶域として使用できる空き領域(MB単位)です。

キャッシュ関連ファイルを含むディスクで使用される空き容量

キャッシュ関連ファイルが格納されているディスクの総使用量(MB単位)です(キャッシュ関連ファイル用に使用されている領域だけではありません)。

許容可能な最大キャッシュ・エントリ数

NQSConfig.INIファイルのMAX_CACHE_ENTRIESパラメータで指定される、キャッシュ内で可能な最大エントリ数です。

キャッシュ・エントリ結果セットごとの許容可能な最大行数

NQSConfig.INIファイルのMAX_ROWS_PER_CACHE_ENTRYパラメータで指定される、各キャッシュ・エントリの結果セットで許容される最大行数です。

現在のキャッシュ・エントリ数

グローバル・キャッシュ内の現在のエントリ数です。これらのエントリは、複数のリポジトリに関連付けられている可能性があります。

Oracle BIサーバーの起動以降にキャッシュから満足されなかった問合せ数

Oracle BIサーバーの前回の起動以降のキャッシュ・ミスです。

Oracle BIサーバーの起動以降にキャッシュから満足された問合せ数

Oracle BIサーバーの前回の起動以降のキャッシュ・ヒットです。

キャッシュ・マネージャがアクティブ・ウィンドウの状態で、[F5]キーを押すか、「アクション」→「リフレッシュ」を選択して、表示をリフレッシュします。開いているリポジトリの現在のキャッシュ・エントリと現在のグローバル・キャッシュ情報が取得されます。DSNがクラスタ化されている場合は、クラスタ内のすべてのリポジトリに関する情報が表示されます。

管理ツールでのキャッシュのパージ

キャッシュのパージは、問合せキャッシュからエントリを削除するプロセスです。

キャッシュ・エントリは、次の方法でパージできます。

- 管理ツールのキャッシュ・マネージャ機能(オンライン・モード)を使用して、手動で行います。

- 特定の表の「物理表」ダイアログの「キャッシュ永続時間」フィールドを設定して、自動で行います。

- Oracle BIサーバー・イベント・ポーリング表を設定して、自動で行います。

- キャッシュ記憶域がいっぱいになったときに、自動で行います。

注意:

キャッシュのパージは、ODBC拡張関数を使用してプログラムで行うこともできます。「ODBCプロシージャを使用するキャッシュのパージと保守」を参照してください。

また、動的リポジトリ変数の値が変化するときにもキャッシュをパージできます。「動的リポジトリ変数の変更」を参照してください。

次のように、キャッシュ・マネージャでキャッシュ・エントリを手動でパージできます。

1. 管理ツールを使用してオンライン・モードでリポジトリを開きます。

2. 「管理」→「キャッシュ」を選択して、「キャッシュ・マネージャ」ダイアログを開きます。

3. 左ペインの該当のタブを選択することによって、キャッシュ・モードまたは物理モードを選択します。

4. エクスプローラ・ツリーを参照して、関連するキャッシュ・エントリを右ペインに表示します。

5. パージするキャッシュ・エントリを選択し、「編集」→「パージ」を選択して、選択されているエントリを削除します。または、選択されているエントリを右クリックし、「パージ」を選択します。

- キャッシュ・モードでは、パージするエントリを右ペインに表示されている中から選択します。

- 物理モードでは、パージするデータベース、カタログ、スキーマまたは表を、左ペイン内のエクスプローラ・ツリーから選択します。

キャッシュ・モードでは、次のものをパージできます。

- 開いているリポジトリに関連する、選択されている1つ以上のキャッシュ・エントリ。

- 指定されたビジネス・モデルに関連する、選択されている1つ以上のキャッシュ・エントリ。

- ビジネス・モデル内の指定されたユーザーに関連する、選択されている1つ以上のキャッシュ・エントリ。

物理モードでは、次のものをパージできます。

- 選択されている1つ以上のデータベースに関連する、すべての表のすべてのキャッシュ・エントリ。

- 選択されている1つ以上のカタログに関連する、すべての表のすべてのキャッシュ・エントリ。

- 選択されている1つ以上のスキーマに関連する、すべての表のすべてのキャッシュ・エントリ。

- 選択されている1つ以上の表に関連する、すべてのキャッシュ・エントリ。

パージによって、選択されているキャッシュ・エントリと関連するメタデータが削除されます。キャッシュの表示を更新するには、「アクション」→「リフレッシュ」を選択するか、[F5]キーを押します。

イベント・ポーリング表によるキャッシュ・イベントの処理

1つ以上の物理表が更新されたことをOracle BIサーバーに通知する方法として、Oracle BIサーバーのイベント・ポーリング表(イベント表)を使用できます。イベント表に追加される各行は、本番データベース内の本番表に対して発生する更新など、単一の更新イベントを表します。

Oracle BIサーバー・キャッシュ・システムは、イベント表から行を読み込み(ポーリング)、物理表の情報を行から抽出し、その物理表を参照する古いキャッシュ・エントリをパージします。

イベント表は、Oracle BIサーバーがアクセス可能なリレーショナル・データベース上に存在する物理表です。専用のデータベースにあるか、他の表も含まれるデータベースにあるかにかかわらず、固定のスキーマ(「物理データベース上でのイベント・ポーリング表の設定」を参照)が必要です。通常は、管理ツールの物理レイヤーでのみ公開され、「物理表」ダイアログ内でOracle BIサーバー・イベント表として識別されます。

イベント表の使用は、古いキャッシュ・エントリを無効化する最も正確な手段の1つであり、多くの場合、最も信頼できる方法です。ただし、データベース表が更新されるたびに、イベント表を移入する必要があります。また、ポーリング間隔の間はキャッシュが必ずしも最新の状態ではないため、キャッシュ内のデータが古い可能性が常にあります。「Oracle BIサーバー・イベント・ポーリング表の移入」を参照してください。

イベント表を更新する一般的な方法は、データベースを移入する、抽出およびロードのスクリプトまたはプログラムに、SQLのINSERT文を指定する方法です。INSERT文によって、物理表が変更されるたびに1つの行がイベント表に追加されます。このプロセスが配置され、Oracle Business Intelligenceリポジトリ内でイベント表が構成されると、キャッシュの無効化が自動的に行われます。イベント表を更新するスクリプトが、表に対する変更を正確に記録しているかぎり、指定されたポーリング間隔で、古いキャッシュ・エントリが自動的にパージされます。

この項では、次の項目について説明します。

- 物理データベース上でのイベント・ポーリング表の設定

- イベント・ポーリング表のアクティブ化

- Oracle BIサーバー・イベント・ポーリング表の移入

- イベント・ポーリング表に関する問題のトラブルシューティング

物理データベース上でのイベント・ポーリング表の設定

各物理データベース上に物理イベント・ポーリング表を構成して、データベース内の変更を監視できます。

独自のデータベースでイベント表を構成することもできます。イベント表は、データベース内の表が変更されるたびに更新されます。

イベント・ポーリング表がOracle Databaseにある場合は、管理ツールの物理レイヤーで、イベント表をその独自のデータベース・オブジェクトで構成します。次に、イベント・ポーリング表の「データベース」ダイアログの「機能」タブで、機能PERF_PREFER_IN_LISTSの選択が解除されていることを確認します。このガイドラインに従うことで、リスト内で許容される最大式数を超えるエラーが回避されます。

イベント・ポーリング表を作成するには、リポジトリ作成ユーティリティ(RCU)を実行し、物理データベース内にBusiness Intelligence Platform (BIPLATFORM)スキーマを作成します。RCUによってS_NQ_EPTという名前のイベント・ポーリング表が作成されます。リポジトリ作成ユーティリティの実行の詳細は、Oracle Business Intelligenceのインストールと構成を参照してください。

イベント表は次の表に示す構造である必要があります。イベント表の配置場所によっては、一部の列にnull値を格納できます。列の名前は、次の表に記載されている列名に一致する必要があります。表示されているデータ・タイプは、Oracle Database用です。

イベント表の列

データ型

説明

CATALOG_NAME

VARCHAR2

更新された物理表が位置するカタログの名前。

イベント表が、更新された物理表と同じデータベース内にない場合のみ、CATALOG_NAME列を移入します。それ以外の場合は、null値に設定します。

DATABASE_NAME

VARCHAR2

更新された物理表が位置するデータベースの名前。これは、管理ツールの物理レイヤーで定義されるときのデータベースの名前です。たとえば、物理データベースの名前が11308Productionで、管理ツールに表示される場合のデータベース名がSQL_Productionの場合、イベント表内のポーリングされる行には、データベース名としてSQL_Productionが含まれている必要があります。

イベント表が、更新された物理表と同じデータベース内にない場合のみ、DATABASE_NAME列を移入します。それ以外の場合は、null値に設定します。

OTHER_RESERVED

VARCHAR2

将来の拡張に備えて予約されています。この列は、null値に設定する必要があります。

SCHEMA_NAME

VARCHAR2

更新された物理表が位置するスキーマの名前。

イベント表が、更新された物理表と同じデータベース内にない場合のみ、SCHEMA_NAME列を移入します。それ以外の場合は、null値に設定します。

TABLE_NAME

VARCHAR2

更新された物理表の名前。この名前は、管理ツールの物理レイヤーで表に対して定義されている名前に一致している必要があります。

null値は指定できません。

UPDATE_TS

DATE

イベント表に対する更新が発生する日時。これは、イベント表に追加される行ごとに増加する、キー(一意)値である必要があります。増加する一意の値であるためには、列のデフォルト値として現在のタイムスタンプを指定します。たとえば、Oracle Databaseの場合は、DEFAULT CURRENT_TIMESTAMPを指定します。

null値は指定できません。

注意: この列は、イベント表に追加される行ごとに増加する一意の値である必要があるため、1秒間に多くの挿入が行われる場合は、非常に高い精度を設定する必要がある可能性があります。このため、データベース機能のFRACTIONAL_SECOND_PRECISIONを調整して、UpdateTime列のフィルタで小数秒を使用するようにできます。Oracle BIサーバーでは、FRACTIONAL_SECOND_PRECISIONで定義される桁数でタイムスタンプが切り捨てられます。

たとえば、Oracle DatabaseやTeradataの場合は、FRACTIONAL_SECOND PRECISIONを0から6に変更します。

UPDATE_TYPE

NUMBER

更新スクリプトに値1を指定して、標準の更新であることを指定します(その他の値は、将来の使用に備えて予約されています)。

null値は指定できません。

Oracle BIサーバーは、イベント・ポーリング表に対して読取りと書込みの権限を持っている必要があります。サーバーは、指定された間隔でイベント表を読み取り、変更されたデータを探します。データベース表が変更されている場合は(たとえば、ロード処理時)、イベント表に行が追加されます。イベント表に行がある場合、基礎となるデータベースに変更されたデータがあります。変更された物理表に対応するキャッシュ・エントリが無効化され、イベント表から古い行が定期的に削除されます。次にイベント表を確認するときも、処理が繰り返されます。

注意:
クラスタ化されたOracle Business Intelligenceデプロイメントでは、1つのイベント・ポーリング表が、クラスタ内のすべてのOracle BIサーバー・ノードで共有されます。ただし、1つのイベント・ポーリング表を、複数のOracle BIサーバー・クラスタで共有することはできません。

Oracle BIサーバーに、イベント・ポーリング表(データベース内の他の表ではない)への書込み権限を与えるには、次のタスクを実行します。

- 権限を持つ接続プールを使用して、管理ツールの物理レイヤーに、個別の物理データベースを作成します。

- 削除権限を持つ接続プールにユーザーを割り当てます。

- イベント表を使用して権限が必要なデータベースを移入します。

Oracle BIサーバーは、イベント・ポーリング表への書込み権限は持っていますが、ユーザー問合せに答えを返すために使用される表への書込み権限は持っていません。

イベント・ポーリング表のアクティブ化

物理データベースに表を作成したら、Oracle BIサーバーでその表をアクティブ化できます。これを行うには、最初に物理表をインポートし、表オブジェクトをイベント・ポーリング表としてマークします。

物理表をインポートするには:

1. 管理ツールで、リポジトリを開き、物理データベースからメタデータをインポートします。これを行うには、「ファイル」を選択し、「メタデータのインポート」を選択します。

2. ウィザードの手順に従います。「メタデータ型の選択」画面の「表」オプションを選択して、表のメタデータをインポートします。
メタデータのインポート・ウィザードの詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

3. イベント・ポーリング表が複数ある場合は、イベント表ごとにステップ1および2を繰り返します。イベント表用に指定されているデータソースが、イベント表に対して読取りと書込みの権限を持つことを確認します。リポジトリは、表の読取りと表の行の削除を両方行うため、書込み権限が必要です。イベント表が、ビジネス・モデルとマッピング・レイヤーで公開されている必要はありません。

表オブジェクトをイベント・ポーリング表としてマークするには:

1. 「ツール」メニューから「ユーティリティ」を選択します。

2. オプション・リストから「Oracle BIイベント表」オプションを選択します。

3. 「実行」をクリックします。

4. イベント表として登録する表を選択し、「>>」ボタンをクリックします。

5. ポーリング間隔を分単位で指定し、「OK」をクリックします。

デフォルト値は60分です。10分未満のポーリング間隔は設定しないでください。非常に短いポーリング間隔が必要な場合は、表の一部またはすべてをキャッシュ不能とマークすることを検討します。

表がOracle BIサーバー・イベント表として登録されると、表のプロパティが変わります。イベント表として登録すると、イベント・ポーリング表から結果をキャッシュする理由がないため、表をキャッシュ可能とマークするオプションが削除されます。

Oracle BIサーバー・イベント・ポーリング表の移入

Oracle BIサーバーが、イベント・ポーリング表を移入することはありません。イベント表が更新されるたびに行を挿入することによって、イベント表が移入されます。

このプロセスは、通常、データベース管理者によって構成されます。一般には、データベース管理者が、表が変更されるたびにポーリング表に行を挿入するロード・プロセスを変更します。これは、(トリガーをサポートするデータベース内で)データベース・トリガーを使用するロード・スクリプト、アプリケーション、または手動で行うことができます。イベント表の移入のプロセスが正しく行われないと、サーバーでは、ポーリング表内の情報が正確で最新であるとみなされるため、Oracle BIサーバーのキャッシュのパージに影響します。

イベント・ポーリング表に関する問題のトラブルシューティング

イベント・ポーリング表に関する問題のトラブルシューティングは、アクティビティ・ログから開始できます。

キャッシュのポーリングに関して問題が発生した場合は、Oracle BIサーバー・アクティビティ・ログを検索して、サーバーとイベント表とのやり取りに関するエントリを確認できます。

- nqserver.logファイルは、Oracle BIサーバーに関するアクティビティを自動的に記録します。ログ・エントリは自明であり、Fusion Middleware Controlまたはテキスト・エディタで表示できます。

- Oracle BIサーバーがイベント表のポーリングを行うと、管理者アカウント(インストール時に設定)を使用して、nqquery.logファイルに問合せが記録されます。ただし、管理者アカウントのログ・レベルが0に設定されている場合を除きます。最も役立つレベルの情報を提供するためには、管理者アカウントのログ・レベルを2に設定します。

nqserver.logとnqquery.logは次の場所にあります。

BI_DOMAIN/servers/obisn/logs

Oracle BIプレゼンテーション・サービス・キャッシュ設定の管理

ユーザーが分析を実行すると、プレゼンテーション・サービスはその分析の結果をキャッシュします。プレゼンテーション・サービスでは、キャッシュされた結果を後続の分析が使用できるかどうかを決定します。キャッシュを共有できる場合、後続の分析は保存されません。

プレゼンテーション・サービス・キャッシュのファイルには、nQS_xxxx_x_xxxxxx.TMPのような名前が付けられます。ファイルはODBCドライバによって作成されますが、通常、プレゼンテーション・サービス・キャッシュが開いているODBCリクエストに対応しています。ファイルは、次のディレクトリに保存されています。

BI_DOMAIN/servers/obips/tmp/obis_temp

キャッシュのファイルは、プレゼンテーション・サービスが正常に停止するときに削除されます。プレゼンテーション・サービスが予期せず停止した場合、様々なキャッシュ・ファイルがディスクに残る可能性があります。プレゼンテーション・サービスが実行していないときにファイルを削除できます。

プレゼンテーション・サービス・キャッシュは、Oracle BIサーバーがアクセスするキャッシュとは異なります。instanceconfig.xmlファイルを変更してキャッシュ・エントリを含めることによって、プレゼンテーション・サービス・キャッシュのデフォルトを変更できます。

次のプロシージャは、プレゼンテーション・サービス・キャッシュを管理できる構成の変更に関する情報を示しています。

「プレゼンテーション・サービス問合せキャッシュの共有について」を参照してください。

1. 次の場所で編集するinstanceconfig.xmlファイルを開きます。
BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるセクションを見つけます。

注意:

時間に関係する要素に、3分より短い値を指定しないでください。このような短い時間を指定すると、リフレッシュが頻繁に発生するため、パフォーマンスに悪影響を及ぼし、画面がちらつく可能性があります。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Cache>
<Query>
<MaxEntries>100</MaxEntries>
<MaxExpireMinutes>60</MaxExpireMinutes>
<MinExpireMinutes>10</MinExpireMinutes>
<MinUserExpireMinutes>10</MinUserExpireMinutes>
</Query>
</Cache>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

要素

説明

デフォルト値

MaxEntries

プレゼンテーション・サービスが常に開いておくレコード・セットの最大数を指定します。最小値は3です。負荷が大きなシステムの場合、この値を700または1000に増加できます。

500

MaxExpireMinutes

キャッシュ内のエントリが削除されるまでの最大存続時間を、分単位で指定します。実行されている分析の数によっては、有効期限より前にエントリが削除される可能性があります。

60

MinExpireMinutes

キャッシュ内のエントリが削除されるまでの最小存続時間を、分単位で指定します。CacheMinUserExpireMinutesの設定によって、特定のユーザーのエントリが、CacheMaxExpireMinutes要素で指定される時間より長く存在できます。

10

MinUserExpireMinutes

キャッシュ内のエントリがユーザーに表示された後の最小存続時間を、分単位で指定します。

たとえば、CacheMaxExpireMinutesが60分に設定されていて、ユーザーが59分のときにエントリを表示すると、そのユーザーのエントリはさらに10分間存続します。ユーザーは新しい分析を実行することなく、データのページングを継続できます。

10

Oracle BI Webクライアントのパフォーマンスの向上

Oracle BI Webクライアントのパフォーマンスを向上させるには、すべての静的ファイルを処理するWebサーバーを構成し、静的リソースも動的リソースも圧縮を有効化します。

Webサーバー上でキャッシュおよびコンテンツの有効期限を有効にすると、Webブラウザでサーバーから静的ファイルをリロードする頻度を指定できます。

使用しているWebサーバー用の手順に従って、静的ファイルのキャッシングと、このディレクトリにあるファイルの圧縮を設定します。

注意:

Oracle WebLogic Serverを構成してApache HTTP Server、Microsoft Internet Information Server (Microsoft IIS)、Oracle HTTP ServerなどのWebサーバーと連携させる方法の詳細は、次のドキュメントを参照してください。

Oracle WebLogic Serverプロキシ・プラグイン12.2.1の使用

Oracle HTTP Server管理者ガイド

次の各項では、構成の例を示します。

- Apache HTTP Serverの静的ファイル・キャッシングの構成

- Oracle HTTP Serverの静的ファイル・キャッシングの構成

Apache HTTP Serverの静的ファイル・キャッシングの構成

この構成例は、Webサーバー・プラグインがインストールされていて、Apache HTTP ServerがOracle WebLogic Serverへリクエストをプロキシできることが前提です。

PLUGIN_HOME/libディレクトリが、LD_LIBRARY_PATHまたはオペレーティング・システムでこれに相当するものに追加されている必要があります。

この項の手順は、構成例専用です。必要に応じて、構成を調整してください。詳細は、Oracle WebLogic Server Proxy Plug-Ins 12.2.1の使用を参照してください。

プラグインの構成ディレクティブを追加するには:

1. Apache HTTP Serverのhttpd.confファイルを見つけます。

2. ファイルを編集用に開き、次のようなディレクティブを追加します。

LoadModule weblogic_module modules/mod_wl.so

<IfModule mod_weblogic.c>
WebLogicPort 9704
Debug OFF
WebLogicHost localhost
WLLogFile /tmp/wl-proxy.log
</IfModule>

<LocationMatch "/analytics/saw\.dll.*">
SetOutputFilter DEFLATE
SetHandler weblogic-handler
</LocationMatch>

<LocationMatch "/analytics/.*\.jsp.*">
SetOutputFilter DEFLATE
SetHandler weblogic-handler
</LocationMatch>

次の点に注意してください。

- LoadModuleディレクティブを、プラグインをインストールした場所と方法に基づいて変更します。

- IfModuleディレクティブによって、Oracle WebLogic Serverへの接続が有効になります。クラスタの構成方法やSSLに関する考慮事項など、接続オプションの詳細は、Oracle WebLogic Server Proxy Plug-Ins 12.2.1の使用を参照してください。

- LocationMatchディレクティブを使用して、すべての動的リクエストがOracle WebLogic Serverにルーティングされます。すべての動的リクエストでGZip圧縮を使用できるように、SetOutputFilter DEFLATEディレクティブを含めてください。

3. 保存してファイルを閉じます。

静的ファイルを処理する構成ディレクティブを追加するには:

1. Apache HTTP Serverのhttpd.confファイルを見つけます。

2. ファイルを編集用に開き、次のようなディレクティブを追加します。

Alias /analytics ORACLE_HOME/bi/bifoundation/web/appv2
<Directory ORACLE_HOME/bi/bifoundation/web/appv2>
# Disable cross-server ETags
FileETag none
# Enable compression for all files
SetOutputFilter DEFLATE
# Don't compress images
SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip dont-vary
# Enable future expiry of static files
ExpiresActive on
ExpiresDefault "access plus 1 week"
Header set Cache-Control "max-age=604800"
DirectoryIndex default.jsp
</Directory>

# Restrict access to WEB-INF
<Location /analytics/WEB-INF>
Order Allow,Deny
Deny from all
</Location>

次の点に注意してください。

- Apache HTTP Serverが、ORACLE_HOME/bi/bifoundation/web/appv2内のOracle BI Webクライアントの静的ファイルにアクセスできることを確認する必要があります。Webサーバーが実行されていて、この場所への読取り権限を持つことを確認します。

- 別名エントリおよびディレクトリ・エントリは、Apache HTTP Serverに対して、静的ファイルのリクエストをOracle WebLogic Serverにルーティングするのではなく、処理することを指定するものです。圧縮および静的ファイルの失効に関するディレクティブについて、次の点に注意してください。

- FileETag

FileETag none

このディレクティブは、Webサーバーに対して、レスポンス内でETagヘッダーを生成しないことを指定します。Apache HTTP ServerのデフォルトのETag生成は、単一サーバーのファイル・システムに密接に関係します。そのため、ETagの生成は推奨されません。

- 圧縮関連のディレクティブ

SetOutputFilter DEFLATE
# Don't compress images
SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip dont-vary

これらのディレクティブにより、Apache HTTP Serverは、イメージ以外のすべてのファイルを圧縮します。通常、イメージはすでに圧縮されており、さらに圧縮しても効果はありません。

- Expiresヘッダーの制御

# Enable future expiry of static files
ExpiresActive on
ExpiresDefault "access plus 1 week"

このフラグメントでは、Apache HTTP Serverに対して、Expiresヘッダーの設定を有効にすることを指定しています。この例では、クライアントがファイルに最初にアクセスした日の1週間後がデフォルトの失効日です。この期間を長くすることもできますが、静的ファイルに対するパッチや更新を十分に処理できるように、静的ファイルを頻繁にリフレッシュする必要があります。

- Cache-Controlヘッダーの制御

Header set Cache-Control "max-age=604800"

このフラグメントでは、Apache HTTPサーバーに対して、Cache-Controlヘッダーを設定することを指定しています。この例では、Expiresヘッダーと一致するように、デフォルトは1週間(秒単位)に設定されています。この値は、Expiresヘッダーと常に同期している必要があります。このヘッダーは、旧バージョンのMicrosoft Internet Explorerで静的ファイルを適切にキャッシュできるようにするために必要です。

- デフォルトURLの処理

DirectoryIndex default.jsp

このディレクティブは、ユーザーが/analytics URLをリクエストして、その下のコンテンツを指定しなかった場合のフォールバック・ハンドラを提供します。このURLは、後続の処理でOracle WebLogic Serverにルーティングされます。

- 最後のディレクティブでは、WEB-INFフォルダへのアクセスを制限します。このフォルダはJ2EEコンテナのデプロイメント・ディスクリプタの一部であり、Webクライアントに公開するものではありません。

3. ファイルを保存して閉じます。

Oracle HTTP Serverの静的ファイル・キャッシングの構成

Oracle HTTP Serverの構成は、Apache HTTP Serverの構成と似ています。ただし、Oracle HTTP Serverとともにデフォルトでmod_wl_ohs.soモジュールがインストールされるため、プラグインをダウンロードしてインストールする必要がない点が異なります。

mod_wl_ohs.soモジュールで直接行う構成もあれば、httpd.confで行う構成もあります。詳細は、Oracle HTTP Server管理者ガイドを参照してください。

Oracle Business IntelligenceのJVMヒープ・サイズの設定

管理サーバーおよび管理対象サーバーのデフォルトJVMヒープ・サイズは、Oracle WebLogic Serverの起動スクリプトでUSER_MEM_ARGSパラメータを設定することにより変更できます。

次の手順で、管理サーバーと管理対象サーバーの両方に同じ値を設定します。

『Oracle WebLogic Serverサーバーの起動と停止の管理』を参照してください。

1. WebLogic Server管理コンソールを使用して、サーバーを正常に停止します。

2. setDomainEnv.sh (Windowsシステムの場合はsetDomainEnv.bat)を編集用に開きます。次の場所にこのファイルを作成できます。

BI_DOMAIN/bin

3. USER_MEM_ARGSに、引数-Xmxを設定します。次のリストは、様々なオペレーティング・システムでUSER_MEM_ARGSを設定する方法の例を示しています。

- UNIXシェル・スクリプト(.sh)

USER_MEM_ARGS="-Xms256m -Xmx1024m -XX:CompileThreshold=8000 -xx:PermSize=128m -XX:MaxPermSize=512m"

- Windowsコマンド・スクリプト(.bat)

set USER_MEM_ARGS="-Xms256m -Xmx1024m -XX:CompileThreshold=8000 -xx:PermSize=128m -XX:MaxPermSize=512m"

注意:
USER_MEM_ARGSの引数は、JDKベンダーによって異なる可能性があります。

4. パラメータの設定後、ファイルを保存して閉じ、変更内容を有効にするため、管理サーバーと管理対象サーバーを再起動します。

5. スケールアウトされたシステムでは、各ドメインのホームでこれらの手順を繰り返します。

水平方向にスケールアウトする場合に設定がコピーされます。

ダイナミック・モニタリング・サービスを使用したメトリックの取得

Fusion Middleware Controlのメトリック・ブラウザを使用する以外に、ダイナミック・モニタリング・サービス(DMS)やWLSTコマンドを使用してOracle Business Intelligenceのメトリックを表示することもできます。

この項では、これらの方法について説明します。

ダイナミック・モニタリング・サービスを使用したメトリックの取得

ダイナミック・モニタリング・サービス(DMS)を使用して、Oracle Business Intelligenceのメトリックを表示できます。

このサービスにアクセスするには、次のURLを使用します。

http://<host>:<AdminServerのポート>/dms

左側のペインのメトリック表リストから「非J2EEメトリック」を選択してOracle Business Intelligenceのメトリックのリストを表示します。これは、Fusion Middleware Controlのメトリック・ブラウザで表示されるものと同じリストです。

ダイナミック・モニタリング・サービスを使用することで、メトリックのスナップショットを迅速に取得できます。Microsoft Excelスプレッドシートを使用したWeb問合せのソースとして特定のメトリックのURLを指定し、このWeb問合せに対して、アーカイブ・シートに値をコピーする処理と一定期間ループで問合せを更新する処理を自動的に実行するマクロを結合します。

たとえば、ダイナミック・モニタリング・サービスを使用して、Oracle_BI_Generalというメトリック表の詳細を表示するとします。メトリック表リストでOracle_BI_Generalリンクをクリックすると、画面の右側にこの表が表示されます。このメトリック表は、Active_Execute_RequestsやTotal_Sessionsなどのいくつかのモニター値で構成されています。メトリック・ブラウザに表示されたこの表の情報をWLSTコマンドの一部として使用できます。

WLSTコマンドを使用したDMSメトリックへのアクセスの詳細は、WLSTコマンドを使用したメトリックの取得を参照してください。

WLSTコマンドを使用したメトリックの取得

WLSTを使用すると、システムに関するメトリックを収集できます。

WLSTコマンドを使用して、Oracle Business Intelligenceのメトリックを取得できます。

1. ORACLE_HOME/oracle_common/bin/ディレクトリに移動します。

2. WLSTユーティリティを実行します。

3. 次の例のように、connectコマンドを使用してOracle BIシステムに接続します。

connect('user','password','t3://<host><port>)

4. 次のプロンプトが表示されたら、オンライン・モードになっています。

wls:/bi/serverConfig>

これで、DMSカスタムWLSTコマンドを対話的に使用できるようになりました。たとえば、先頭にOracle_BIが付くすべてのメトリック表を表示するには、次のコマンドを入力します。

wls:/bifoundation_domain/serverConfig> displayMetricTables('Oracle_BI*')

このコマンドでは、Oracle BIのメトリックごとにデータの長大なリストが生成されます。そのため、Oracle_BI_Generalなどの特定のメトリック表に焦点を絞ったほうが役立ちます。次のコマンドでは、次に示すサンプルのような出力が表示されます。

wls:/bifoundation_domain/serverConfig> displayMetricTables('Oracle_BI_General')

-----------------
Oracle_BI_General
-----------------
Active_Execute_Requests.value:  0
Active_Fetch_Requests.value:    0
Active_File_Handles.value:      1
Active_Initblock_Executions.value:      0
Active_Logins.value:    0
Active_Prepare_Requests.value:  0
Avg._Failed_Logins_Elapsed_Time.value:  0
Avg._Initblock_Executions_Elapsed_Time.value:   0
Avg._Succeeded_Logins_Elapsed_Time.value:       0
Avg._query_elapsed_time.value:  0
Busy_File_Handles.value:        0
File_Handle_Waiters.value:      0
Free_File_Handles.value:        502
Host:   oracle-bc5ac6af
Max._Initblock_Execution_Elapsed_Time.value:    0
Max_File_Handles.value: 503
Name:   Oracle BI General
New_Execute_Requests.value:     19
New_Fetch_Requests.value:       32
New_Initblock_Executions.value: 0
New_Logins.value:       7
New_Prepare_Requests.value:     19
New_Requests.value:     187
OBPERF_***.value:       7
Oracle_BI_Applications: Oracle BI Server
Parent: /Oracle BI Server
Process:        Oracle BI Server:4004:/instance1/coreapplication_obis1
Queries/sec.value:      0
ServerName:     /instance1/coreapplication_obis1
Succeeded_Initblock_Execution_Ratio_as_%.value: 0
Succeeded_Logins_Ratio_as_%.value:      7
Total_sessions.value:   0

WLSTのスクリプト作成機能を使用してDMSコマンドをPythonスクリプトに組み込み、必要なメトリック値をファイルに格納できます。次にこのようなスクリプトの例を示します。

# Script to dump timestamp (in milliseconds) for a single Oracle BI metric
# to a file
#
from java.util import Date
from java.text import SimpleDateFormat
#
# Modify to connect to your server
connect('biadmin','welcome1','t3://localhost:9500')
#
# This is the number of times to sample the metric
sample_length = 100
#
# This is where you define what metric table and metric to dump to file
metric_table = "Oracle_BI_General"
metric_of_interest = "Avg._query_elapsed_time.value"
#
# Some metrics have non-text characters in the name. Provide a reference here
# so it dumps to file without error in file name
output_file_metric_ref = "Avg_Qry_Elapse"
#
# This section defines the output file name with unique time
start_time = str(SimpleDateFormat("dd-MMM-yyyy_HH-mm-ss").format(Date()))
output_filename = start_time + "_" + output_file_metric_ref + "_dump.txt"
#
# Open the file and write summary of metric to be dumped
file = open(output_filename,'w')
print >>file, "Start Metric Dump of: " + str(metric_table) + " : " + str(metric_of_interest) + " at " + str(SimpleDateFormat("dd-MMM-yyyy HH-mm-ss").format(Date()))
#
#
# The following section forms a loop according to the sample length defined
# earlier. The 'displayMetricTables()' command returns the metric table in the
# form of a JMX composite data array. The code following this command access
# the metric data from this array. In this case, a particular metric of
# interest is tested for and only the value of that metric is output to file.
#
counter = 0
while counter <= sample_length:
results = displayMetricTables(metric_table)
for table in results:
name = table.get('Table')
rows = table.get('Rows')
rowCollection = rows.values()
iter = rowCollection.iterator()
while iter.hasNext():
row = iter.next()
rowType = row.getCompositeType()
keys = rowType.keySet()
keyIter = keys.iterator()
while keyIter.hasNext():
columnName = keyIter.next()
value = row.get(columnName)
if columnName == metric_of_interest:
print >>file, str(SimpleDateFormat("dd-MMM-yyyy HH-mm-ss-SSS").format(Date())) + "," + str(value)
counter = counter + 1
file.close()
disconnect()

「Oracle_BI_Thread_Pool」などの一部のOracle BIメトリック表は、実際には2つのディメンションで構成される表です。「Oracle_BI_Thread_Pool」表では、「Server」や「Usage_Tracking」などの様々な「名前」のメトリック値の問合せを実行できます。この場合、必要なメトリック値をファイルにエクスポートするには、前のスクリプト例のループで使用しているロジックを、2つのディメンションを扱うように変更する必要があります。次のスクリプト例では、このような場合の処理方法の1つを示しています。

# Script to dump timestamp (in milliseconds) and a
#single Oracle BI metric to a file for metrics with multiple sections
#
from java.util import Date
from java.text import SimpleDateFormat
#
# Modify to connect to your server
connect('biadmin','welcome1','t3://localhost:9500')
#
# This is the number of times to sample the metric
sample_length = 100
#
# This is where you define what metric table, category, and metric to
# dump to file
metric_table = "Oracle_BI_Thread_Pool"
category_of_interest = "Server"
metric_of_interest = "Avg._Request/sec.value"
#
# Some metrics have non-text characters - provide a reference here
# so it dumps to file without error
output_file_metric_ref = "Avg_Req_Sec"
#
# This section defines the output file name with unique time
start_time = str(SimpleDateFormat("dd-MMM-yyyy_HH-mm-ss").format(Date()))
output_filename = start_time + "_" + output_file_metric_ref + "_dump.txt"
#
# Open the file and write summary of metric to be dumped
file = open(output_filename,'w')
print >>file, "Start Metric Dump of: " + str(metric_table) + " : " + str(metric_of_interest) + " for Category: " + str(category_of_interest) + " at " + str(SimpleDateFormat("dd-MMM-yyyy HH-mm-ss").format(Date()))
#
#
counter = 0
while counter <= sample_length:
results = displayMetricTables(metric_table)
for table in results:
name = table.get('Table')
rows = table.get('Rows')
rowCollection = rows.values()
iter = rowCollection.iterator()
while iter.hasNext():
row = iter.next()
if row.containsValue(category_of_interest):
rowType = row.getCompositeType()
keys = rowType.keySet()
keyIter = keys.iterator()
while keyIter.hasNext():
columnName = keyIter.next()
value = row.get(columnName)
if columnName == metric_of_interest:
print >>file, str(SimpleDateFormat("dd-MMM-yyyy HH-mm-ss-SSS").format(Date())) + "," + str(value)
counter = counter + 1
file.close()
disconnect()

第IV部 問題の解決

Oracle Business Intelligenceの問題を解決する方法を学習します。

この部は、次の章で構成されています。

- Oracle Business Intelligenceの問題の診断および解決

- 使用状況トラッキングの管理

6 Oracle Business Intelligenceの問題の診断および解決

この章では、Fusion Middleware Controlやログ・ファイルなどのツールを使用してOracle Business Intelligenceの問題を診断および解決する方法について説明します。

この章の内容は次のとおりです。

- 使用可能な診断ツール

- 診断バンドルの収集

- 診断ログ・ファイルの表示と構成

- 診断ログ・ファイルとログ構成ファイルについて

- 問合せログの管理

- Oracle BIサーバーでのロギング

- ODBC/JDBCプロシージャを使用したOracle BIサーバーの診断の取得

- システム起動のトラブルシューティング

使用可能な診断ツール

問題のトラブルシューティングに利用できるいくつかの診断ツールがあります。

Oracle Business Intelligenceには、次の表に示されているとおり、問題の原因と解決策を見つけるのに役立つ様々な診断ツールが用意されています

ツール

説明

参照先

診断バンドル

Oracleサポート・リクエストに添付するログおよび構成情報を収集できます

診断バンドルの収集

Fusion Middleware Controlの「概要」ページ

システムに関する最近の問題を表示できます。

Fusion Middleware ControlのOracle Business Intelligenceページの表示

パフォーマンス・メトリック

パフォーマンスに影響を及ぼすメトリックを表示できます。

サービス・レベルの監視

Fusion Middleware Controlの「診断」ページ

問題を深く調べてログ・ファイルを表示および構成できます。

ログ情報、エラー・メッセージおよびアラートを表示するためのFusion Middleware Controlの使用

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

使用状況トラッキング

データベースの最適化、集計の戦略、ユーザーや部門が利用したリソースに基づく課金など、様々な方法で利用できる使用状況トラッキングの統計情報を生成できます。

使用状況トラッキングについて

カタログ・オブジェクトのレポート

Oracle BIプレゼンテーション・カタログのオブジェクトの詳細を知ることができます。

カタログ・マネージャを使用したカタログ・データを表示するためのレポートの作成

整合性チェック・マネージャ

リポジトリの有効性をチェックできます。

Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドのリポジトリまたはビジネス・モデルの整合性のチェックに関する項

モデル・チェック・マネージャ

Oracle BI Summary Advisorおよび集計の永続性エンジンに影響を及ぼす可能性のある問題のモデルについてチェックできます。

Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドのモデル・チェック・マネージャを使用した問題のモデルについてのチェックに関する項

ODBC/JDBCプロシージャ

Oracle BIサーバーに関する診断情報を取得できます。

ODBC/JDBCプロシージャを使用したOracle BIサーバーの診断の取得

診断バンドルの収集

この項では、問題を解決するためにOracleサポートが必要とする診断バンドルを収集する方法について説明します。

Oracle開発またはサポートがバグまたはサポート・リクエスト(SR)送信を受け入れる前に、構成後診断バンドルを収集する必要があります。

前提条件:

- 製品のFAQを確認する必要があります。

- BIインストールおよび構成に成功しました。特にBI構成アシスタントがエラーなしで完了しました。これに該当しない場合、Oracleサポートに問い合せる前に診断を収集する方法の詳細は、次を参照してください。BI構成アシスタントで障害が発生した場合は、Oracle Business Intelligenceのインストールと構成のOracle Business Intelligence 12c Configuration Assistantの実行に関する項を参照してください。

- セキュリティ機密情報は収集されません。

前提条件:

ファイル・システム権限を持つ必要があります。

1. 次のコマンドを実行して、診断バンドルを収集します。
DOMAINHOME/bitools/bin/diagnostic_dump.sh <zip file name>

2. リクエストされたときにサポートまたは開発組織にzipファイルを提供します。

診断ログ・ファイルの表示と構成

診断ログ・ファイルは、問題の発生前および発生後にトラブルシューティングするために役立ちます。

次の項で説明するように、診断ログ・ファイルを表示したり、診断ログ・ファイルおよびファイル内の情報に影響する設定を構成したりできます。

- ログ情報、エラー・メッセージおよびアラートを表示するためのFusion Middleware Controlの使用

- ログ・ファイルのローテーション・ポリシーの構成とログ・レベルの指定

ログ情報、エラー・メッセージおよびアラートを表示するためのFusion Middleware Controlの使用

Fusion Middleware Controlログ・ビューアを使用して、Oracle Business Intelligenceコンポーネントのログ・エントリを検索して表示できます。

ログ・ファイルを検索するとログ・メッセージが見つかり、たとえば、特定の日付範囲、ユーザー、ユーザー・トランザクションまたはメッセージのレベル(エラー、警告、通知など)をターゲットとするフィルタを適用できます。Fusion Middleware Controlログ・ビューアから、ログ・ファイル全体を表示することもできます。

エラー・メッセージと警告のログ・エントリが複数のログ・ファイルにまたがって生成される場合、その追跡は困難です。しかし、複数のログ・ファイルにわたる特定のユーザー・トランザクションのログ情報を表示することが可能です。トランザクション・レベルのロギングでは、実行コンテキストID(ECID)と呼ばれる一意のトランザクションIDを、ユーザー・リクエストに応答して生成されるすべてのログおよびエラー・メッセージに関連付けています。このロギングによって、基となる問題の原因を迅速に診断できます。ただし、ログ内のメッセージによっては(たとえば、サーバーの起動や停止のシステム・メッセージ)、トランザクション属性を持ちません。クライアント・リクエストに関連するすべてのログ・メッセージは、トランザクション属性を持ちます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. 「Business Intelligence概要」ページに移動します。

2. 「診断」ページの「ログ・メッセージ」タブを表示します。

要素のページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。

3. 次のリストを表示します。

- 「最新のエラー」領域の最新のエラー

- 「最新の警告」領域の最新の警告

4. 「ログ・メッセージの表示」の下のリンクを選択して、すべてのログ・ファイルのメッセージまたは指定されたコンポーネントのログ・ファイルのメッセージを表示します。

- ログ・ビューアを使用するログ・ファイルの検索

- プレゼンテーション・サービス・ログ

- サーバー・ログ

- スケジューラ・ログ

- JavaHostログ

- クラスタ・コントローラ・ログ

- アクション・サービス・ログ

- セキュリティ・サービス・ログ

- 管理者サービス・ログ

Fusion Middleware Controlでは、選択に応じた「ログ・メッセージ」ページにメッセージが表示されます。

5. 適切な検索基準を入力して、対応するエラー・メッセージを表示します。

メッセージをECID別に表示するには、「関連メッセージの表示」をクリックし、「ECID(実行コンテキストID)ごと」を選択します。

6. 1つ以上の行を選択して、選択されているメッセージのログ・ファイル・エントリの詳細を表示します。

ログ・ファイルのローテーション・ポリシーの構成とログ・レベルの指定

ログ・ファイルのサイズと経過時間に基づいて、新しいログ・ファイルを作成する必要があるタイミングを決定する基準を構成できます。

ログ・ファイルに保存するメッセージのレベルを決定するログ・レベルも指定できます。

この項では、次の項目について説明します。

- ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

- 追加のログ・ファイル設定の手動での変更

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

ログ・ファイルのローテーション・ポリシーおよびログ・レベルを構成すると、ログ・ファイルに十分なデータを保持しつつ、管理可能な状態に維持できます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. 「Business Intelligence概要」ページに移動します。

2. 「診断」ページの「ログ構成」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. このページのヘルプ・トピックの説明を参照して、各要素を設定します。

たとえば、使用するログ・レベルを指定したり、場合によってはその粒度を設定したりできます。

次のオプションに関するページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。

ログ構成

- 「最大ファイル・サイズ」オプション

- 「ログの最長保存期間」オプション

問合せログ

- 「最大ファイル・サイズ」オプション

- 「ログの最長保存期間」オプション

デフォルト・ログ・レベル

コンポーネント固有のログ・レベル

5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。

6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

追加のログ・ファイル設定の手動での変更

Fusion Middleware Controlで変更できるログ・ファイル設定に加えて、手動で変更できる設定もあります。コンポーネントのログ構成ファイル内の様々な要素を使用して、その設定を変更します。

1. 次のコンポーネント・ログ構成ファイルを開きます。

BI_DOMAIN/config/fmwconfig/biconfig/

詳細は、「診断ログ構成ファイルの概要とその位置」を参照してください。

2. ログ・ファイル形式を指定するFormat要素を追加する必要があるセクションを見つけます。デフォルトはODL-TEXTです。

Fusion Middleware Controlログ・ビューアを使用してOracle Business Intelligenceのログ・ファイルを表示および検索するには、ファイルがODL-Text形式またはODL-XML形式である必要があります。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<server>
<ServerInstance>
<Log>
<Format>ODL-TEXT</Format>
</Log>
</ServerInstance>
</server>

JavaHost Serverの診断ログ構成ファイルの詳細は、「診断ログ構成ファイルの概要とその位置」を参照してください。

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

ログ・ビューアを使用した問題の診断

Fusion Middleware Controlのログ・ビューアを使用して、Oracle Business Intelligenceシステムでの問題の解決に役立つ可能性があるメッセージを探すことができます。

1. Fusion Middleware Controlが表示されます。

2. ナビゲータで、「WebLogicドメイン」を選択して「bi」を右クリックし、「ログ」、「ログ・メッセージの表示」の順に選択します。
「ログ・メッセージ」ページが表示されます。ログ・ビューアがすべてのログ・ファイルから行を収集し、このページに表示します。行をフィルタして、関心のあるものを表示できます。

3. リストのフィルタを開始するには、検索基準を入力して関心のあるメッセージを探します。

- 特定の日付の前後にエラーが発生したことがわかっている場合は、「日付範囲」を「時間間隔」に設定します。フィルタの開始および終了の日付を選択します。

- エラーが繰り返し発生している場合は、「日付範囲」を「最新」に設定します。「日」を選択して、1や3などの数字を指定します。

- 「メッセージ・タイプ」には、次の「インシデント・エラー」、「エラー」、「警告」および「通知」を選択します。返されるメッセージの数が多すぎる場合は、「通知」を選択解除して、エラーと警告のみを表示します。
「通知」を選択する利点は、Oracle Business Intelligenceシステムの動作内容がわかることで、異常が発生したのがいつかを特定するのに役立てることができます。

4. Oracle Business Intelligenceのメッセージをフィルタするには、次のようにします。

a. 「フィールドの追加」をクリックし、「モジュール」を選択して、「追加」をクリックします。

b. 「モジュール」が「次を含む」に設定されていることを確認して、次の値を入力します。
oracle.bi.management

この値は、Oracle Business Intelligenceのシステム管理のためのすべてのログ・エントリが由来するJavaパッケージの名前を指定します。

5. 「検索」をクリックします。
このページには、診断中の問題に関係するエラーおよび警告を含め、条件に合うすべてのログ・メッセージがリストされます。

6. ログ・メッセージのコピーを保存するには、「メッセージをファイルにエクスポート」をクリックし、「Oracle診断ログ・テキスト(.txt)として」または必要に応じてその他の形式を選択します。

ログ・メッセージを表示すると、「メッセージ」列に、何の操作がいつ行われたかが表示されます。いつサーバーが再起動されたか、構成の変更が行われたかなど、重要な情報を知ることができます。「ログ・ファイル」列の値を使用すると、書込み先のファイルがわかり、Oracle Business Intelligenceの動作の手がかりとなります。たとえば、nqserver.logの値はOracle BIサーバーとの相互作用を示し、sawlog5.logの値はプレゼンテーション・サービスとの相互作用を示します。

ログ・メッセージを表示して、何が特定の状況の原因となったかを確認できます。たとえば、Fusion Middleware Controlで別のリポジトリを指定するという変更を行ったのに、プレゼンテーション・サービスではそのリポジトリを表示できないとします。ログ・メッセージを表示すると、管理対象サーバーをホストし、新規リポジトリのコピー先となるコンピュータのメモリーが不足していることを示すエラー・メッセージが見つかります。先のエラー・メッセージは、管理サーバーがリポジトリの変更をレポートし、その変更を管理対象サーバーに同期しようとしたことを示します。

診断ログ・ファイルとログ構成ファイルについて

診断ログ・ファイルおよびログ構成ファイルは、システム機能をトラブルシューティングおよび調査するための手段となります。

この項では、診断ログ・ファイルと診断ログ構成ファイルについて説明します。内容は次のとおりです。

- 診断ログ・ファイルの概要とその位置

- 診断ログ構成ファイルの概要とその位置

- ログ・ファイル・メッセージのカテゴリとレベルの概要

- ログ・ファイル・ローテーション

- システム・ログ内のメッセージ

診断ログ・ファイルの概要とその位置

診断ログ・ファイルは、Oracle Business Intelligence Serverによって生成されるメッセージ情報を格納するためのファイルです。

これらのログ・ファイルは、次の場所に保存されています。

BI_DOMAIN/servers/INSTANCE_KEY/logs (システム・コンポーネント用)

BI_DOMAIN/servers/WLS_SERVER_NAME/logs (JEEコンポーネント用)。

例:

oraclehome/user_projects/domains/bi/servers/obis1/logs (BIサーバー用)

oraclehome/user_projects/domains/bi/servers/AdminServer/logs (JEE管理サーバー用)

Oracle Business Intelligenceでは、次の診断ログ・ファイルが使用されます。

- プレゼンテーション・サービス

- \CatalogCrawler\sawcatalogcrawlerlogsysn.log - カタログ・クローラのログ・ファイル。Fusion Middleware Controlログ・ビューアで検索できません。

- sawlogn.log - 診断ログ出力の最新部分に相当し、Fusion Middleware Controlログ・ビューアで検索できる、プレゼンテーション・サービスのログ・ファイル。

プレゼンテーション・サービスのロギングの詳細は、Oracle BIサーバーでのロギングを参照してください。

- Oracle BIサーバー

- obis<n>_query.log - Oracle BIサーバー問合せログ。Fusion Middleware Controlログ・ビューアで検索できません。
たとえば、<n> = -1、-2などです。

注意: 日付およびタイムスタンプはログ・ファイルにあります。

- nqserver<n>.log - Oracle BIサーバー・メイン診断ログ。Fusion Middleware Controlログ・ビューアで検索できます。
たとえば、<n> = 1、2などです

注意: 日付およびタイムスタンプはログ・ファイルにあります。

- nqsadmintool.log - Oracle BI管理ツールのログ。

- Oracle BIサーバー・ユーティリティ - たとえば、biserverxmlexecやequalizerpdsも、実行時に独自のログを生成します。

- JavaHost

- jh.log - JavaHost Serverのメイン診断ログ。Fusion Middleware Controlログ・ビューアで検索できます。
注意: 日付およびタイムスタンプはログ・ファイルにあります。

- Oracle BIスケジューラ

- nqscheduler.log - Oracle BIスケジューラのログ・ファイル。Fusion Middleware Controlログ・ビューアで検索できます。
注意: 日付およびタイムスタンプはログ・ファイルにあります。

- クラスタ・コントローラ

- nqcluster.log - Oracle BIクラスタ・コントローラの診断ファイル。Fusion Middleware Controlログ・ビューアで検索できます。
注意: 日付およびタイムスタンプはログ・ファイルにあります。

- BI JEEログ(アクション・サービスおよびセキュリティ・サービス)。次のログ・ファイルは両方とも、Fusion Middleware Controlログ・ビューアで検索できます。

- AdminServer-diagnostic.log

- bi_server1-diagnostic.log

注意:
ログ・ファイルnqcluster.log、nqscheduler.logおよびnqserver<n>.logについては、ファイルにログ記録されるメッセージにタイムゾーンを設定できません。メッセージは、グリニッジ標準時(GMT)でファイルにログ記録されます。Fusion Middleware Controlログ・ビューアでメッセージを表示する際は、ローカルのタイムゾーンでメッセージが表示されます。

診断ログ構成ファイルの概要とその位置

診断ログ構成ファイルは、Oracle Business Intelligenceの診断ログ・ファイルへの出力を制御します。

注意:

変更が後で上書きされる可能性があるため、1つのコンポーネントの診断ログ構成ファイルを編集することはしないでください。

Oracle Business Intelligenceのログ構成ファイルは、次の場所に保存されています。

BI_DOMAIN/config/fmwconfig/biconfig/BI_COMPONENT_NAME

例:

oraclehome/user_projects/domains/bi/config/fmwconfig/biconfig

- ./OBICCS/ccslogconfig.xml

- ./OBIJH/logging_config.xml

- ./OBIPS/instanceconfig.xml

- ./OBSCH/schedulerconfig.xml

- ./OBIS/logconfig.xml

診断ログ構成ファイルの形式について

診断ログ構成ファイルは、見かけは多少異なる場合がありますが、ODL(Oracle Diagnostic Log)標準に準拠します。

例6-1と例6-2は、Oracle Business Intelligenceの2つのログ構成ファイルを示しています。

例6-1 BIサーバー診断ログ構成ファイルの形式 — 例1

<server>
<ServerInstance>
<Log>
<MaximumFileSizeKb>10000</MaximumFileSizeKb>
<MaximumLogAgeDay>60</MaximumLogAgeDay>
<Format>ODL-TEXT</Format>
<Level>
<IncidentError>1</IncidentError>
<Error>1</Error>
<Warning>16</Warning>
<Notification>1</Notification>
<Trace>16</Trace>
</Level>
</Log>
<UserLog>
<MaximumFileSizeKb>10000</MaximumFileSizeKb>
<MaximumLogAgeDay>10</MaximumLogAgeDay>
<Format>ODL-TEXT</Format>
</UserLog>
</ServerInstance>
</server>

例6-2 JavaHost Server診断ログ構成ファイルの形式 — 例2

<?xml version = '1.0' encoding = 'utf-8'?>
<logging_configuration>
<log_handlers>
<log_handler name='odl-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='C:\oracle_bi_ee_BIFNDNPTPSNT0911060426S-Release\jhlogs\javahost.log'/>
<property name='maxFileSize' value='1000000'/>
<property name='maxLogSize' value='5000000'/>
</log_handler>
</log_handlers>
<loggers>
<logger name='saw' level='NOTIFICATION:1' useParentHandlers='false'>         <handler name='odl-handler'/>
</logger>
</loggers>
</logging_configuration>

Oracle Business Intelligenceコンポーネントは、ログ構成ファイル内のサーバー固有の設定を使用して、診断ログ・ファイルを制御します。例:

- Oracle BIプレゼンテーション・サービス・ログ構成ファイル
- writerClassId設定によって、sawlog.logファイルに書き込まれるメッセージが構成されます。

- Oracle BIサーバー・ログ構成ファイル
- Log設定によって、nqserver.logファイルに書き込まれるメッセージが構成されます。

「システム・ログ内のメッセージ」を参照してください。

- UserLog設定によって、nqquery.logファイルに書き込まれるメッセージが構成されます。

「問合せログの管理」を参照してください。

- Oracle BIスケジューラ・ログ構成ファイル
- Log設定によって、nqscheduler.logファイルに書き込まれるメッセージが構成されます。

- JavaHost Serverログ構成ファイル
- log_handlers要素とサブ要素では、ログ・ファイルのローテーション・ポリシーを構成してログ・ファイル名とその位置を指定できます。

- loggers要素とサブ要素では、JavaHost Serverログ・レベルを標準のODL(Oracle Diagnostic Log)ログ・レベルにマップすることによって、Javaコンポーネント(JavaHost Server)のログ・レベルを適切に処理できます。

ログ・ファイル・メッセージのカテゴリとレベルの概要

ログ・ファイル・メッセージのカテゴリとレベルによって、ログ・ファイルに書き込まれるメッセージの詳細度と重要度のレベルが決まります。

Fusion Middleware Controlを使用すると、logconfig.xmlファイル内のこれらの設定を制御できます。

Oracle Business Intelligenceのログ・ファイル内の各メッセージ・カテゴリは、1 - 32の間の固有のデフォルト値に設定されており、ログ・レベル以下のレベルのメッセージのみが記録されます。

この表は、ログ・ファイル・メッセージのカテゴリを示しています。

カテゴリ:レベル

説明

IncidentError:1

原因不明の重大な問題が発生しました。問題を解決するには、Oracleサポート・サービスに問い合せてください。

パフォーマンスへの影響はありません。

Error:1

システム管理者による対応が必要な問題が発生しました。

パフォーマンスへの影響はありません。

Warning:1

エラーの発生を回避するための確認を必要とし、場合によっては対応が必要となる処理が実行されたか、状況が検出されました。

パフォーマンスへの影響はありません。

Notification:1

通常のアクションまたはイベントのレポートが発生しました。ログイン完了などのユーザー操作や、ログ・ファイルのローテーションなどの自動操作です。

パフォーマンスへの影響はありません。

Notification:16

構成関連のメッセージが生成されたか、問題が発生しました。

パフォーマンスへの影響はわずかです。本番環境でこのレベルを広範囲にわたって有効にしても、ソフトウェアのパフォーマンスに大きな影響はありません。

Trace:1

デバッグやパフォーマンス監視に使用されるトレースまたはデバッグ・メッセージが書き込まれました。通常、このメッセージには詳細なイベント・データが含まれており、内部の実装の詳細がわからなくても理解できます。

パフォーマンスに少し影響します。このレベルは、ソフトウェアに関する問題をデバッグするために、本番環境で広範囲にわたって有効にすることもできます。このレベルのロギングを有効にすると、パフォーマンスに少し影響する場合がありますが、ソフトウェアが使用できなくなるほどではありません。

Trace:16

かなり詳細なトレースまたはデバッグ・メッセージが書き込まれました。メッセージは明確に記述されており、製品に関する豊富な知識を持つOracleサポート・サービスの技術者であれば、内部の実装の詳細を完全に把握していなくても理解できます。

パフォーマンスに大きく影響します。このレベルは、ソフトウェアの問題をデバッグする特別な状況を除いて、本番環境では有効にしないでください。

Trace:32

非常に詳細なトレースまたはデバッグ・メッセージが書き込まれました。このソフトウェアを使用し、メッセージを生成するサブシステムの実装の詳細を十分に把握しているOracle開発者を対象としています。

パフォーマンスに非常に大きな影響があります。このレベルは本番環境では有効にしないでください。開発者がテスト環境または開発環境でこのソフトウェアをデバッグするときのみ使用してください。

次のログ構成ファイルの例の場合、Notificationメッセージ・カテゴリではレベル1のメッセージのみが記録されます。ログ・レベルが0に設定されている場合、そのメッセージ・カテゴリでは何も記録されません。

<Level>
<IncidentError>1</IncidentError>
<Error>1</Error>
<Warning>1</Warning>
<Notification>1</Notification>
<Trace>1</Trace>
</Level>

ログ・ファイル内のデフォルト設定を手動で変更することは避けてください。変更する場合は、Fusion Middleware Controlを使用します。「ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用」を参照してください。

ログ・ファイル・ローテーション

ログ・ファイル・ローテーションとは、ログ・ファイルが指定されたしきい値や日付を超えたときに新しいログ・ファイルが作成されることを言います。

例として、Oracle BIスケジューラのコンポーネント・ログ構成ファイルのMaximumFileSizeKb設定を考えてみましょう。この設定で指定されるサイズをログ・ファイルが超えると、既存のスケジューラ・ログ・ファイルの名前が変更され、新しいログ・ファイルが作成されます。また、MaximumLogAgeDayの設定より古いログ・ファイル日付も削除されます。

Oracle BIコンポーネントはそれぞれ異なるログ・ファイル名を持ち、ログ構成ファイルの設定が異なります。たとえば、スケジューラのファイル・ネーミング規則は次のとおりです。

- nqscheduler.log - 最新のログ・ファイル。

- nqscheduler-<n>.log - 名前が変更された、以前のログ・ファイル。
<n> = 日付とタイムスタンプ(例: nqscheduler-20100909-2135.log)

「ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用」を参照してください。

システム・ログ内のメッセージ

Oracle BIサーバーでは、構成設定に基づいてnqserver.logファイルにメッセージが書き込まれます。

このログ・ファイルへのメッセージの書込みに加えて、Oracle BIサーバーによって、UNIXシステムのシステム・ログ・ファイルに、特定の重大なメッセージも書き込まれます。Oracle BIサーバーによってシステム・ログ・ファイルに書き込まれるメッセージの種類は、次のとおりです。

- Oracle BIサーバーが起動できない場合(たとえば、別のサーバーがすでに起動しているため)、システム・ログ・ファイルには次のようなメッセージが書き込まれます。
@1%lsおよびポート@2%ls上で別のサーバーがすでに実行されています。

- メモリーの問題が発生した場合、システム・ログ・ファイルには次のようなメッセージが書き込まれます。
低断片化ヒープを有効にできませんでした。

- コンピュータのハード・ディスクがいっぱいの場合、システム・ログ・ファイルには次のようなメッセージが書き込まれます。
ディスクの空き容量不足です。

問合せログの管理

Oracle BIサーバーには、問合せアクティビティを個々のユーザー・レベルでロギングする機能があります。ロギングは、品質保証テスト、デバッグおよびOracleサポート・サービスによるトラブルシューティングで使用します。本番モードでは、通常、問合せロギングは無効にされています。

問合せログ・ファイルの名前はnqquery.logで、次の場所にあります。

BI_DOMAIN/servers/obisn/logs

Oracle BIサーバーの問合せロギングはユーザー・レベルで追跡されます。ユーザー・コミュニティ全体を追跡すると、リソースが集中的に使用されます。

注意:

本番システムでは、ターゲットを絞ったユーザー・コミュニティのみを対象に問合せロギングを有効にすることをお薦めします。本番システムでは、使用状況トラッキングを本番レベルのロギング機能として使用できます。「使用状況トラッキングの管理」を参照してください。

ユーザー名が明らかにテスト・ユーザーを示しており、問合せロギングが有効であることが確認されている場合のみ、ユーザーをテストしてください。このようなユーザーのロギングが有効な場合、ユーザーにはsales_admin_with_logging、sales_dev_with_logging、sales_test_with_loggingなどの名前を付けることが推奨されているため、ユーザーを簡単に識別できます。なお、本番の管理者ログインは、使用可能なリソースに負担がかかるため、問合せロギングを有効にしないでください。

次のものについても、問合せロギングを無効にします。

- 初期化文字列内のSQL文。「初期化文字列」フィールドは、「一般」タブの「初期化ブロック」ダイアログにあります。
LOGGING列は、ログ・レベルで格納されている値を参照します。

- 各本番ユーザーのロギング・レベルは0(ゼロ)に設定します。「ロギング・レベル」フィールドは、「ユーザー」タブの「ユーザー」ダイアログにあります。管理ツールで、メイン・ツールバーの「管理」オプションから「アイデンティティ」を選択します。「Identity Manager」ダイアログで、ユーザーをダブルクリックし、「ユーザー」タブを選択します。

この項では、次の項目について説明します。

- 問合せロギングの構成

- ログ・ビューアの使用

問合せロギングの構成

この項では、問合せログのサイズの設定、ロギング・レベルの選択およびユーザーの問合せログの有効化について説明します。

問合せロギングによって非常に大きなログ・ファイルが作成されるため、デフォルトでは、ロギング・システムは無効化されています。ロギングを有効にすることで、リポジトリが正しく構成されているかどうかのテスト、システム上でのアクティビティの監視、パフォーマンスの問題の解決またはOracleサポート・サービスの支援が可能となります。ロギングが必要なユーザーごとに、システム上の問合せロギングを有効にする必要があります。そのためには、Oracle BI管理ツールを使用します。

問合せロギング・レベルの設定

収集されるデータ問合せログの量をユーザーごとに構成できます。

ユーザーの問合せロギング・レベルの設定の説明に従って、個々のユーザーの問合せロギング・レベルを有効にできます。グループのロギング・レベルは構成できません。

特定のユーザーのロギング・レベルは、セッション変数によって上書きされます。たとえば、管理者のロギング・レベルが4で、セッション変数のロギング・レベルがリポジトリ内でデフォルト0(ゼロ)と定義される場合、管理者のロギング・レベルは0になります。

ロギング・レベルは、組織に適したロギングの量に基づいて設定します。一般の操作の場合、通常、ロギングは無効です(ロギング・レベルは0に設定されています)。ロギングを有効にする場合は、1または2のロギング・レベルを選択します。この2つのレベルは、管理者による使用を目的としています。

問合せの一時的なログ・レベルを設定することで、パフォーマンスやデータの問題を診断できます。Oracle BIプレゼンテーション・サービスの「詳細設定」タブで、「高度なSQL句」セクションに接頭辞句を追加することで、SELECT文の問合せロギングを有効にできます。SELECT文の例を次に示します。

SELECT year, product, sum(revenue) FROM time, products, facts;

「接頭辞」フィールドで、次のようにロギング・レベル5を指定できます。

Set Variable LOGLEVEL=5;

この問合せでは、基礎となるLOGLEVEL変数の値にかかわらず、ロギング・レベル5が使用されます。

注意:
3以上のロギング・レベルは、Oracleサポート・サービスの支援を受ける場合のみ使用してください。

次の表は、問合せロギング・レベルを示しています。

ロギング・レベル

記録される情報

レベル0

ロギングは行われません。

レベル1

クライアント・アプリケーションから発行されたSQL文が記録されます。次のものも記録されます。

- 物理問合せのレスポンス時間 - バックエンド・データベースで問合せが処理されるのにかかった時間。

- 物理問合せの数 - バックエンド・データベースで処理された問合せの数。

- 累積時間 - リクエストに関するすべての物理問合せの合計時間(すべてのバックエンド・データベース処理時間とDB接続時間の合計)。

- DB接続時間 - バックエンド・データベースへの接続にかかった時間。

- 問合せキャッシュの処理 - キャッシュからの論理問合せの処理にかかった時間。

- 経過時間 - プレゼンテーション・サービスに論理問合せが発行されてからユーザーに結果が返されるまでに経過した時間。経過時間には、プレゼンテーション・サービスに論理問合せが発行されてから論理問合せの準備が開始されるまでにかかるわずかな時間も含まれるため、レスポンス時間より短くなることはありません。この時間の差が非常に短い場合は、経過時間とレスポンス時間は等しくなります。

- レスポンス時間 - 論理問合せの準備、実行および最新レコードのフェッチにかかった時間。これは、「使用状況トラッキング・データの説明」に記載されているように、使用状況トラッキングで記録されるTOTAL_TIME_SECに一致します。

- コンパイル時間 - 論理問合せのコンパイルにかかった時間。

- 各問合せについて、問合せのステータス(成功、失敗、終了またはタイムアウト)、ユーザーID、セッションIDおよびリクエストIDが記録されます。

- BIサーバーの合計時間 — 問合せ実行のみにBIサーバーで要した時間(つまり、コンパイル時間でない)。

レベル2

レベル1で記録されるすべてのものが記録されます。

加えて、各問合せについて、リポジトリ名、ビジネス・モデル名、サブジェクト・エリア名、物理データベースに対して発行されたSQL文、キャッシュに対して発行された問合せ、物理データベースに対する問合せとキャッシュに対して発行された問合せからそれぞれ返された行数、およびクライアント・アプリケーションに返される行数が記録されます。

レベル3

レベル2で記録されるすべてのものが記録されます。

加えて、キャッシュをシードする予定だった問合せがキャッシュに挿入されなかった場合、既存のキャッシュ・エントリを消去して現在の問合せ用の領域を作成する場合、および完全一致のヒット・ディテクタを更新できなかった場合、論理問合せ計画のログ・エントリが追加されます。

Oracleサポート・サービスの支援がない場合は、このレベルを選択しないでください。

レベル4

レベル3で記録されるすべてのものが記録されます。

加えて、問合せ実行計画が記録されます。Oracleサポート・サービスの支援がない場合は、このレベルを選択しないでください。

レベル5

レベル4で記録されるすべてのものが記録されます。

加えて、実行計画内の様々な時点における中間の行数が記録されます。Oracleサポート・サービスの支援がない場合は、このレベルを選択しないでください。

レベル6および7

使用されません。

ユーザーの問合せロギング・レベルの設定

ユーザーごとに問合せデータの量を構成できます。

1. Oracle BI管理ツールで、「管理」→「アイデンティティ」を選択します。

「Identity Manager」ダイアログが表示されます。

2. 問合せロギング・レベルを設定するユーザーの名前をダブルクリックします。

「ユーザー」ダイアログが表示されます。

3. 「ロギング・レベル」フィールドの横の「↑」または「↓」の矢印をクリックして、ロギング・レベルを設定します。

ユーザーの問合せロギングを無効にするには、ロギング・レベルを0に設定します。

4. 「OK」をクリックします。

ログ・ビューアの使用

問合せログを表示するには、Oracle Business Intelligenceのログ・ビューア・ユーティリティ(またはテキスト・エディタ)を使用します。

問合せログ内の各エントリには、問合せを発行したユーザーの名前、問合せが開始されたセッションのセッションIDおよび個々の問合せのリクエストIDのタグが付けられています。

ログ・ビューア・ユーティリティの実行

ログ・ビューア・ユーティリティを使用すると、特定のログ・ファイルを検索および確認できます。

ログ・ビューア・ユーティリティ(UNIXのORACLE_HOME/bi/bifoundation/server/bin)を実行するには、コマンド・プロンプトを開き、nqlogviewerと引数の組合せを入力します。構文は次のとおりです。

nqlogviewer [-u user_name] [-f log_input_filename]
[-o output_result_filename]
[-s session_ID] [-r request_ID]

この構文では:

- user_nameは、Oracle Business Intelligenceリポジトリ内のユーザーの名前です。このパラメータによって、エントリの範囲が特定のユーザーに限定されます。このパラメータを指定しないと、問合せロギングが有効なすべてのユーザーが表示されます。

- log_input_filenameは、コンテンツが取得される既存のログ・ファイルの名前です。このパラメータは必須です。

- output_result_filenameは、ログの出力が保存されるファイルの名前です。ファイルがすでに存在する場合、ファイルに結果が追加されます。ファイルが存在しない場合は、新しいファイルが作成されます。この引数を指定しないと、出力はモニター画面に送信されます。

- session_IDは、ユーザー・セッションのセッションIDです。BIサーバーでは、セッションの開始時に、各セッションに一意のIDが割り当てられます。このパラメータによって、ログ・エントリの範囲が指定のセッションIDに限定されます。このパラメータを指定しないと、すべてのセッションIDが表示されます。

- request_IDは、個々の問合せのリクエストIDです。BIサーバーでは、問合せの開始時に、各問合せに一意のIDが割り当てられます。このパラメータによって、ログ・エントリの範囲が指定のリクエストIDに限定されます。このパラメータを指定しないと、すべてのリクエストIDが表示されます。
リクエストIDはアクティブなリクエスト間で一意ですが、セッションを通じて一意であるとはかぎりません。リクエストIDは循環方式で作成され、リクエストがクローズされたりセッションの実行に長時間かかったりする場合には、リクエストIDが再利用されます。

セッション・マネージャを通じてユーザー名、セッションIDおよびリクエストIDを見つけることもできます。詳細は、『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』を参照してください。

管理者は、プレゼンテーション・サービスの「管理」ページの「セッションの管理」オプションを使用して、問合せログを表示できます。

ログ・レコードの解析

いくつかの問合せ情報を記録し、ログ・ビューアを起動すると、ログを分析できます。レベル1および2のログ・エントリは、通常、自明です。

ログ・エントリは、基礎となるデータベースを担当するデータベース管理者(DBA)が、データベースを調整して最適な問合せパフォーマンスを実現するうえでの手がかりになります。問合せログは、BIサーバーを使用するアプリケーションの精度の確認にも役立ちます。

ログは、次のセクションに分かれています。

- SQLリクエスト - このセクションには、クライアント・アプリケーションから発行されたSQL文が示されます。この情報を使用して、同じアプリケーションまたは別のアプリケーションから問合せを再実行できます。

- 一般の問合せ情報 - このセクションには、リポジトリ、ビジネス・モデル、および問合せが実行されたサブジェクト領域が示されます。この情報は、今後のアプリケーション開発やシステム管理における優先順位を設定するために使用可能な、問合せの使用状況に関する統計を収集する目的で使用できます。

- データベース問合せ - このセクションは、"Sending query to the database named <data_source_name>"というエントリで開始します(ここで、<data_source_name>は、BIサーバーが接続しているデータソースの名前です)。複数のデータベース問合せを1つ以上のデータソースに送信できます。各問合せはログ内の1つのエントリに相当します。
データベース問合せセクションには、基礎となるデータベースに送信されたSQL文の記録など、様々な用途があります。記録されたこのSQL文を使用してデータベースに対して問合せを直接実行することで、パフォーマンス・チューニング、結果の検証またはその他のテストを行うことができます。この情報を使用して、問合せを受けている表を調べて、集計ナビゲーションが予測どおりに動作していることを確認することもできます。基礎となるデータベースの構造を理解している場合は、効果的な集計表や索引の構築など、パフォーマンス向上の手がかりにもなります。

- 問合せのステータス - ログ内の問合せ成功のエントリは、問合せが正常終了したか失敗したかを示します。失敗した問合せをログで検索して、失敗の原因を判断できます。たとえば、特定の時間帯のすべての問合せが、データベースの停止時間が原因で失敗することがあります。

Oracle BIサーバーでのロギング

この項では、特にプレゼンテーション・サービスにおけるロギングについて説明します。

次のトピックがあります。

- Oracle BIプレゼンテーション・サービスのロギング機能の使用

- Oracle BIプレゼンテーション・サービスのロギング・レベルの設定

- Oracle BIプレゼンテーション・サービス構成ファイルの構造

- ログ・メッセージの形式例

- Oracle BIプレゼンテーション・サービス・メッセージの構造

- Oracle BIプレゼンテーション・サービスsログ・フィルタ

- エージェントに関する問題の診断

「診断ログ・ファイルとログ構成ファイルについて」を参照してください。

Oracle BIプレゼンテーション・サービスのロギング機能の使用

Oracle BIプレゼンテーション・サービスのログを使用すると、問題およびエラーをトラブルシューティングできます。

デフォルトでは、Oracle BIプレゼンテーション・サービスは、すべてのエラー・イベントと、十分な重要性のある情報イベントや警告イベントを記録するように構成されています。サーバーの起動や停止が、重要な情報イベントの例です。ログ・ファイルには、sawlogxx.logという名前が付けられます。xxは、増分する値に置き換えられます。

発生する特定の問題をデバッグするために、ロギング・レベルを増やして、デフォルト構成より多くの情報を記録することができます。たとえば、Oracle BIプレゼンテーション・サービスの特定の接続問題をデバッグする場合は、saw.odbcログ・ソースのみ、最大ロギングを増やすことができます。これにより、このコンポーネントの詳細なロギングが追加されますが、他のイベントによる詳細なロギングでログがいっぱいになることはありません。Oracle BIプレゼンテーション・サービスのすべての構成情報は、instanceconfig.xmlファイルからロードされます。

注意:
ロギングはパフォーマンスに影響するため、特定の問題を診断する場合を除いて、本番実装でロギングを増やさないでください。

Oracle BIプレゼンテーション・サービスのロギング・レベルの設定

プレゼンテーション・サービスの「管理」ページのオプションを使用してロギング・レベルを変更します。

1. グローバル・ヘッダーで「管理」をクリックします。

2. 「メンテナンスとトラブルシューティング」領域の「ログ構成の再ロード」で、使用するロギング・レベルを選択します。

3. 「ログ構成の再ロード」をクリックすると、プレゼンテーション・サービスを再起動しなくても変更を有効にできます。

プレゼンテーション・サービスを停止して再起動しても、変更は引き続き有効です。

4. 「セッションの管理」リンクをクリックして「セッションの管理」ページを表示します。

5. セッションごとに、適切なレベルを表の「ログ・レベル」列に指定します。

更新後のレベルは、そのセッションに対して即時有効になります。レベルを選択する際、必ず重大度の値をプレゼンテーション・サービスですべてのメッセージに指定されている値以下にします。

Oracle BIプレゼンテーション・サービス構成ファイルの構造

Oracle BIプレゼンテーション・サービスの構成ファイルの構造によって、システムの出力が適切に表示されます。

構成ファイルの構造を次の例に示します。各ノードのカーディナリティは大カッコ内に示します。

例6-3 instanceconfig.xmlファイル内のログ・セクションの構造

Logging [1..1]
Writers [0..1]
Writer [0..1]
WriterClassGroups [0..1]
Filters [0..1]
FilterRecord [0..n]

4つのライターを含むinstanceconfig.xmlファイルの例を次に示します。

例6-4 4つのライターが含まれるinstanceconfig.xmlファイル

<?xml version="1.0" ?>
<Server>
. . . . . . .
<Logging>
<Writers>
<Writer implementation="FileLogWriter" name="Global File Logger"
writerClassId="1" dir="{%ORACLE_BIPS_INSTANCE_LOGDIR%}" filePrefix="sawlog"
maxFileSizeKb="10000" filesN="10" fmtName="ODL-Text" ODLLogFilePath="{%ORACLE_BIPS_INSTANCE_LOGDIR%}/diagnostic.log"/>
<Writer implementation="CoutWriter" name="Global Output Logger"
writerClassId="2" />
<Writer implementation="EventLogWriter" name="Event Logger"
writerClassId="3" />
<Writer implementation="CrashWriter" name="CrashWriter"
writerClassId="4"
/>
</Writers>
<WriterClassGroups>
<WriterClassGroup name="All">1,2,3,4</WriterClassGroup>
<WriterClassGroup name="File">1</WriterClassGroup>
<WriterClassGroup name="Console">2</WriterClassGroup>
<WriterClassGroup name="EventLog">3</WriterClassGroup>
<WriterClassGroup name="Crash">4</WriterClassGroup>
</WriterClassGroups>
<Filters>
<FilterRecord writerClassGroup="Console" path = "saw" information="1" warning="31" error="31" trace="0" incident_error="32" />
<FilterRecord writerClassGroup="File" path = "saw" information="1" warning="31" error="31" trace="0" incident_error="32" />
<FilterRecord writerClassGroup="File" path="saw.mktgsqlsubsystem.joblog" information="1" warning="2" error="31" trace="0" incident_error="32"/>
<FilterRecord writerClassGroup="File" path="saw.httpserver.request"
information="16" warning="32" error="32" trace="0" incident_error="32"/>
<FilterRecord writerClassGroup="File" path="saw.httpserver.response"
information="16" warning="32" error="32" trace="0" incident_error="32"/>
</Filters>
</Logging>
</Server>

次の表は、構成階層内の各ノードの説明を示しています。

要素

属性

説明

Writers

なし

ライター構成が含まれます。

この構成は起動時にロードされます。

Writer

なし

ライターを構成します。

Writer

disableCentralControl

(オプション)このエントリがFusion Middleware Controlによって更新されないように指定します。デフォルト値はtrueです。

Writer

implementation

次の実装が定義されています。

- FileLogWriterディスク・ファイルに書き込みます。

- CoutWriter。標準出力に書き込みます。

- EventLogWriter。Windowsイベント・ログまたはUNIX syslogに書き込みます。

- CrashWriter。Windowsのみの機能で、プレゼンテーション・サービスが特定のソース・ファイルと行番号からのログを試みると、クラッシュ・ダンプ・ファイルに書き込みます。
ログ記録可能であっても回復可能ではないエラー(たとえば、NQTESTの失敗)に関する情報を得るために、本番環境で使用されます。

注意: サーバーが不安定な状態になる可能性があるため、この実装の使用には注意が必要です。この実装は、テスト・システムでごくまれに診断目的でのみ使用します。

WindowsでCrashWriterを使用するには、適切なバージョンのdbghelp.dll(6.0.17.0以上)が必要です。

適切なdbghelp.dllは、support/windows/system64にあります。

このDLLをWINNT/system64またはmain/binディレクトリに配置します。

登録は必要ありません。

Writer

name

ライターの一意の名前です。

Writer

writerClassId

1 - 10の範囲の整数値を指定します。この値は、ロギングを許可または禁止するために、フィルタで使用されます。

個々のライターはそれぞれ一意の値を持つ必要があり、その値が後でフィルタ構成で使用されます。

異なるライターが同じクラスIDを持つこともありますが、その場合、フィルタでそれらのライターを区別することはできません。

Writer

fmtName

(オプション)ログ・メッセージの形式を指定します。有効な値は次のとおりです。

- デフォルト10gスタイル。識別の見出しを使用してメッセージを書式設定します。

- ODL-TEXT。Oracle診断テキスト形式でメッセージを書式設定します。

- ODL-XML。Oracle診断XML形式でメッセージを書式設定します。

この属性を設定しないと、ログ・メッセージはデフォルト形式で表示されます。デフォルト形式は、ファイル・ログ・ライターの場合は10g形式で、コンソールの場合はODL-TEXTです。

例は、「ログ・メッセージの形式例」を参照してください。

Writer(FileLogWriter固有の属性)

dir

ログ・ファイルが作成されるディレクトリを指定します。

Writer(FileLogWriter固有の属性)

ODLLogFilePath

Fusion Middleware Controlがログ・ビューアに表示するファイルを指定します。

Writer(FileLogWriter固有の属性)

maxFileSizeKb

ログ・ファイルの最大サイズをKB単位で指定します。

ファイル・サイズの上限に達するとファイルは閉じられ、新しいログ・ファイルが作成されます。

Writer(FileLogWriter固有の属性)

filePrefix

ログ・ファイルの接頭辞を指定します。

Writer(FileLogWriter固有の属性)

filesN

ログ・ファイルの最大数を指定します。

この値を超えると、最初のファイルが削除され、再び作成されます。ログ出力が起動し、最初のファイルの先頭に書き込みが実行されます。

Writer(EventLogWriter固有の属性)

winSource

ログに記録されるイベントのイベント・ログ・ソースを指定します。

Writer(CrashWriter固有の属性)

file

ダンプ・ファイル・パスを指定します。

Windowsの場合、ダンプ・ファイルはbin/coredumpsに作成され、プレゼンテーション・サービスは実行を続けます。

Writer(CrashWriter固有の属性)

line

ダンプ・ファイルの行番号です。

WriterClassGroups

なし

ライター・クラスの定義が含まれます。ライター・クラスは、ライター・クラスIDのグループです。

WriterClassGroup(クラスIDのカンマ区切りのリストを子テキストとして含む。)

name

WriterClassGroupの名前を指定します。

Filters

なし

フィルタ構成が含まれます。

FilterRecord

writerClassGroup

このレコードが適用されるライターのグループを指定します。WriterClassGroupは通常、WriterClassGroupsセクションであらかじめ定義されています。

FilterRecord

disableCentralControl

(オプション)このエントリがFusion Middleware Controlによって更新されないように指定します。デフォルト値はtrueです。

FilterRecord

path

ログ・ソース・パスを指定します。SOAP情報のロギングを有効にするには、次の値を入力します。

saw.httpserver.request.soaprequest
現在のフィルタ・レコードは、パスで識別されるソフトウェア・コンポーネントとそのすべてのサブコンポーネントに適用されます。

FilterRecord

情報

対応するメッセージ・タイプの重大度を指定する整数が含まれます。

指定の値より重大度が低いメッセージのみが記録されます。

FilterRecord

警告

対応するメッセージ・タイプの重大度を指定する整数が含まれます。

指定の値より重大度が低いメッセージのみが記録されます。

FilterRecord

エラー

対応するメッセージ・タイプの重大度を指定する整数が含まれます。

指定の値より重大度が低いメッセージのみが記録されます。

FilterRecord

trace

対応するメッセージ・タイプの重大度を指定する整数が含まれます。

指定の値より重大度が低いメッセージのみが記録されます。

FilterRecord

incident_error

対応するメッセージ・タイプの重大度を指定する整数が含まれます。

指定の値より重大度が低いメッセージのみが記録されます。

ログ・メッセージの形式例

Writer要素のfmtName属性により、ログ・メッセージは、デフォルト(10g形式)、ODL-TEXT、ODL-XMLのいずれかの形式になります。

次の例はデフォルト形式を示しています。

例6-5 デフォルト形式

デフォルト形式の場合、次のように、識別の見出しを伴うメッセージが生成されます。

Type: Information
Severity: 30
Time: Wed Jul 26 11:22:20 2006
File: project\sawserver\sawserver.cpp
Line: 399
Properties: ThreadID-2552
Location:
saw.sawserver
saw.sawserver.initializesawserver
saw.sawserver
Oracle BI Presentation Services has started successfully.

次の例はODL-TEXT形式を示しています。

例6-6 ODL-TEXT形式

短縮形式の場合、次のように、識別の見出しを伴わない省略された形式でメッセージが生成されます。

[timestamp] [component id] [messagetype:level] [message-id] [module id] ([field-name: field-value])* message-text [[
supplemental-detail
]]

[2010-05-27T10:51:20.000-07:00] [OBIPS] [NOTIFICATION:1] [] [saw.sawserver] [ecid: 1243446680218334471555761] [tid: 2552] Oracle BI Presentation Services (OBIPS) 11.1.1.2 (Build 0) are starting up.[[
File:sawserver.cpp
Line:432
Location:
saw.sawserver
saw.sawserver.initializesawserver
saw.sawserver
ecid: 1243446680218334471555761
]]

次の例はODL-XML形式を示しています。

例6-7 ODL-XML形式

xml形式の場合、次のように、XML形式のメッセージが生成されます。

<msg time="2010-05-08T18:41:05.000+00:00"
comp_id="OBIPS" type="NOTIFICATION" level="1" msg_id=""
module="saw.sawserver" ecid="124180446517874242628761" tid="127c">
<txt> Oracle BI Presentation Services has started successfully</txt>
<suppl_detail />
</msg>

Oracle BIプレゼンテーション・サービス・メッセージの構造

BI Publisherによって記録される各メッセージは、次の表に示されている様々なコンポーネントで構成されます。

メッセージ・コンポーネント

説明

メッセージ・テキスト

ユーザーへのログ・メッセージのテキストです。

メッセージ・タイプ

5種類(情報、警告、エラー、インシデント・エラー、トレース)のうちの1つです。

詳細は、ログ・ファイル・メッセージのカテゴリとレベルの概要を参照してください。

重大度

重大度は、正の整数で表されます。

値が低くなるほど、メッセージの重大度は増します。重大度が0のメッセージは最も重要なタイプのメッセージであり、重大度が32のメッセージはまったく重要ではありません。

メッセージ・プロパティ

プロパティには、他の種類の情報が含まれます。その種類はメッセージによって異なり、ユーザー名、クライアント・ブラウザのIPアドレス、スレッドIDなどが含まれる場合があります。

Oracle BIプレゼンテーション・サービスログ・フィルタ

FilterRecordで、ロギングの詳細をカスタマイズします。FilterRecordを使用して、実装(出力タイプ)とWebログのカテゴリ(インシデント・エラー、エラー、トレース、警告および情報)のロギング・レベルを指定します。

次の例では、最初の2つのFilterRecordに、次の文字列が含まれています。

path="saw"

この文字列は、情報イベントをレベル1、エラー・メッセージをレベル31などで記録します。

<FilterRecord writerClassGroup="Console" path="saw" information="1" warning="31" error="31" trace="0" incident_error="32" />
<FilterRecord writerClassGroup="File" path="saw" information="1" warning="31" error="31" trace="0" incident_error="32" />
<FilterRecord writerClassGroup="File" path="saw.mktgsqlsubsystem.joblog" information="1" warning="2" error="31" trace="0" incident_error="32"/>

この上位パスはすべてのイベントに適用されます。

前述の例の3番目のFilterRecordのように、各種タイプのイベントのログ・レベルをさらに詳細に指定する新しいFilterRecordを追加することで、FilterRecordをカスタマイズできます。この例の場合、saw.mktgsqlsubsystem.logからディスク・ファイルに情報が記録され、Marketingジョブ・イベントが生成されます。

次の例に示すように、情報レベルを1から0に変更することによって、または行をコメント・アウトすることによって、ジョブの詳細のロギングを無効にできます。

<FilterRecord writerClassGroup="Console" path="saw" information="1" warning="31" error="31" trace="0" incident_error="32" />
<FilterRecord writerClassGroup="File" path="saw" information="1" warning="31" error="31" trace="0" incident_error="32" />
<FilterRecord writerClassGroup="File" path="saw.mktgsqlsubsystem.joblog" information="1" warning="2" error="31" trace="0" incident_error="32"/>

エージェントに関する問題の診断

この項では、次の項目について説明します。

- Fusion Middleware Controlを使用したエージェントのデバッグ

- instanceconfig.xmlを使用したエージェントの手動デバッグ

Fusion Middleware Controlを使用したエージェントのデバッグ

エージェント・エラーおよびデバッグのログ・エントリが、Fusion Middleware Controlを使用してメイン・スケジューラ・ログ・ファイル、nqscheduler.logに書き込まれ、ログ・ビューアに表示されます。

「ログ情報、エラー・メッセージおよびアラートを表示するためのFusion Middleware Controlの使用」を参照してください。

エージェント・ログ・エントリには、キー・エージェント・イベントが含まれ、単一のトレース行に情報が記載されます。例:

Agent Chain Completed. Status: Completed, Agent ID: /users/weblogic/ChainedAgent, UserID: weblogic, OBIPS: example.com:0:9710, Job/Instance ID: 123/4567

次の表に、エージェント・イベント・ロギングおよび関連するトレース・タイプとレベルを示します。

イベント

状態

メッセージ・タイプ:レベル

エージェント・チェーンを開始しました。

実行中

TRACE:1

エージェント・チェーンを開始しました。

再実行

NOTIFICATION:1

エージェント・チェーンが完了しました。

失敗

ERROR:1

エージェント・チェーンが完了しました。

タイムアウト

ERROR:1

エージェント・チェーンが完了しました。

タイムアウト

WARNING:1

エージェント・チェーンが完了しました。

警告

WARNING:1

エージェント・チェーンが完了しました。

取消

NOTIFICATION:1

エージェント・チェーンが完了しました。

再試行してください

NOTIFICATION:1

エージェント・チェーンが完了しました。

完了

TRACE:1

開始されたエージェント

該当なし

TRACE:1

終了したエージェント

該当なし

TRACE:1

Fusion Middleware Control内のレベルを設定すると、nqscheduler.logファイルに書き込まれたログ出力の詳細を確認できます。「ログ・ファイルのローテーション・ポリシーの構成とログ・レベルの指定」を参照してください。ECIDを使用してログ・エントリをフィルタ処理をし、特定のエージェント・チェイン固有の情報を検索できます。

instanceconfig.xmlを使用したエージェントの手動デバッグ

エージェントが実行に完全に失敗した場合やOracle BIスケジューラでデバッグが有効な場合には、エージェントのログ・ファイルが生成されます。

Oracle BIスケジューラのinstanceconfig.xmlファイル内でDebug要素をtrueに設定することによって、デバッグを手動で有効にできます。たとえば、次の場所にあります。

oraclehome/user_projects/domains/bi/config/fmwconfig/biconfig/OBISCH

「診断ログ構成ファイルの概要とその位置」を参照してください。

エージェント・ログ・ファイルの場所は、Oracle BIスケジューラのinstanceconfig.xmlファイルでも指定されます(詳細は、「エージェントのスケジューラ構成設定」を参照)。ログ・ファイルのデフォルトの場所は、Oracle BIスケジューラがインストールされるコンピュータの、Oracle Business Intelligenceインストール・ディレクトリ内のLogディレクトリです。

ログ・ファイル名の形式は、次のとおりです。

Agent-JobID-InstanceID.xxx

このファイル名の各部の内容は、次のとおりです。

- Agentは、すべてのエージェント・ログ・ファイルの接頭辞です。

- JobIDは、エージェントのOracle BIスケジューラ・ジョブ識別子です。

- InstanceIDは、エージェントのOracle BIスケジューラ・インスタンス識別子です。

- xxxは、ファイル拡張子です。

- .errは、エージェント・エラー・ログ・ファイルを表します。

- .logは、デバッグ・ログ・ファイルを表します。

エージェント・エラー・ログ・ファイルとデバッグ・ログ・ファイルは、実行に失敗したエージェント・インスタンスごとに、個別のファイルとして作成されます。テキスト・エディタを使用してファイルを表示できます。エントリは、通常、自明です。

エラー・ログがあるからといって、エージェントが完全に失敗したとはかぎりません。たとえば、エージェントが複数の電子メール・アドレスにコンテンツを配信するものとします。無効なアドレスがある場合や、メール・サーバーが停止している場合には、エージェントに対してエラー・ログが生成されます。

ジョブ・マネージャで、エラー・メッセージと、ジョブ・インスタンスの終了コードを表示することもできます。詳細は、Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイドのジョブ・マネージャのインスタンス・プロパティに関する項を参照してください。終了ステータスは、正常終了した配信の数を示します。

ODBC/JDBCプロシージャを使用したOracle BIサーバーの診断の取得

この項では、ODBC/JDBCプロシージャを使用してOracle BIサーバーに関する診断情報を取得する方法について説明します。

この項では、次の項目について説明します。

- Oracle BIサーバーのODBC/JDBCプロシージャについて

- 使用可能な診断カテゴリのリストの取得

- 特定の診断の実行

- ODBC/JDBCプロシージャのパラメータについて

Oracle BIサーバーのODBC/JDBCプロシージャについて

ODBC/JDBCプロシージャを使用して、Oracle BIサーバーに関する診断情報を取得できます。

これらのプロシージャは、管理ツールを実行できない非Windowsプラットフォーム上で特に有用です。

nqcmdユーティリティで、ODBCを使用してプロシージャを実行します。『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のnqcmdを使用したリポジトリのテストと調整に関する項を参照してください。

JDBCを使用してプロシージャを実行することもできます。JDBCを使用してOracle BIサーバーに接続する方法の詳細は、ORACLE_HOME/bi/bifoundation/jdbcのbijdbc.jarファイルに含まれるREADME.TXTファイルを参照してください。

使用可能な診断カテゴリのリストの取得

最初にOBISAvailableDiagnostics()を実行して、使用可能な診断カテゴリのリストと説明を取得できます。

次の例を参照してください。

call OBISAvailableDiagnostics()

この結果は、次のように表示されます。

カテゴリ

説明

General

接続したOBISインスタンスの一般的な概要

DBInstance:DBNAME1

DBNAME1で名前が付けられたDBインスタンスに関連するすべての統計

DBInstance:DBNAMEn

DBNAMEnで名前が付けられたDBインスタンスに関連するすべての統計

LDAP:Instance1

Instance1で名前が付けられたLDAPインスタンスに関連するすべての統計

LDAP:Instancen

Instancenで名前が付けられたLDAPインスタンスに関連するすべての統計

DBConnectionPool:Instance1

Instance1で名前が付けられたDB接続プールに関連するすべての統計

DBConnectionPool:Instancen

Instancenで名前が付けられたDB接続プールに関連するすべての統計

ThreadPool:Instance1

Instance1で名前が付けられたスレッド・プールに関連するすべての統計

ThreadPool:Instancen

Instancenで名前が付けられたスレッド・プールに関連するすべての統計

Cache:Instance1

Instance1で名前が付けられたキャッシュに関連するすべての統計

Cache:Instancen

Instancenで名前が付けられたキャッシュに関連するすべての統計

「General」カテゴリを除き、カテゴリはすべて「Instance」カテゴリです。「Instance」カテゴリは、(特定の物理データベースなどの)特定のインスタンス・オブジェクトに関連する統計です。オブジェクトの複数のインスタンスを初期化した場合、category_name:instance_nameという形式で、インスタンスごとに個別のカテゴリが存在します。例については、上の表を参照してください。

ODBC/JDBCカテゴリについて次の点に注意してください。

- 「ThreadPool」カテゴリには、DbConnection PoolMgrによって作成および管理されているスレッドからの統計のみが表示されます。

- 「Cache」カテゴリには、Compiler CacheおよびLDAP Internal Cacheからの統計が表示されます。

特定の診断の実行

特定のカテゴリに対して診断を実行すると、問題をトラブルシューティングするために役立ち、システムが最適化されます。

使用可能な診断カテゴリを取得すると、OBISDiagnostics(string)をコールして、個々のカテゴリの診断を取得できます。ここで、stringはカテゴリ名です。例:

call OBISDiagnostics('ThreadPool:orcldb_pool')

この結果は、次のように表示されます。

パラメータ名

値

CAPACITY

1000

THREAD COUNT

20

BUSY THREAD COUNT

15

ACCUMULATED REQUESTS

5

MAX STACK SIZE

100

カテゴリのスペルは正しくなければなりません。正しくない場合は、行が返されません。

次にもう1つの例を示します。

call OBISDiagnostics('General')

この結果は、次のように表示されます。

パラメータ名

値

TOTAL SESSIONS

10

QUERIES PER SEC

5

NEW LOGINS

10

ACTIVE LOGINS

7

NEW REQUESTS

30

DATA CACHE HIT PER SEC

5

NEW INIT BLOCKS

10

ODBC/JDBCプロシージャのパラメータについて

次の表は、各カテゴリ・タイプのパラメータ参照情報を示しています。

パラメータ名

説明

TOTAL SESSIONS

Oracle BIサーバーにクライアントを接続しているセッションの合計数。

QUERIES PER SEC

Oracle BIサーバーで完了した問合せの1秒当たりの数。

NEW LOGINS

Oracle BIサーバーが受信した新規ログイン・リクエストの合計数。

ACTIVE LOGINS

Oracle BIサーバー内でアクティブなログインの合計数。

NEW REQUESTS

Oracle BIサーバーが受信した新規実行リクエストの数。

DATA CACHE HIT PER SEC

1秒当たりのデータ・キャッシュ・ヒットの割合。

NEW INIT BLOCKS

Oracle BIサーバーが受信した新規初期化ブロック・リクエストの合計数。

パラメータ名

説明

QUERIES PER SEC

バックエンド・データベースで完了した問合せの1秒当たりの数。

FAILED QUERIES PER SEC

バックエンド・データベースで失敗した1秒当たりの問合せの数。

NEW PREPARES

バックエンド・データベースに送信された準備の数。

ROWS PER SEC

バックエンド・データベースから取得された1秒当たりの行数。

KB PER SEC

バックエンド・データベースから取得された1秒当たりのKB数。

パラメータ名

説明

NEW REQUESTS

受信された新規LDAP認証リクエスト数の合計数。

NEW IMPERSONATED REQUESTS

受信された新規偽装LDAP認証リクエスト数の合計数。

ACTIVE REQUESTS

Oracle BIサーバー内でアクティブなLDAP認証リクエストの数。

パラメータ名

説明

CAPACITY

データベース接続プールで許可される最大の接続数。

CONNECTION COUNT

スレッド・プールのオープン接続の現在の数。

BUSY CONNECTION COUNT

データベース接続プールで問合せを処理するために割り当てられた接続、または問合せを現在処理中の接続の数。

AVG REQUESTS PER SEC

データベース接続プールに送信された1秒当たりの平均リクエスト数。

AVG OPEN REQUESTS PER SEC

1秒当たりにオープンされる接続の平均数。他の接続がタイムアウトになったか、接続に問題があるため、新しい接続に対して接続がオープンされている可能性があります。

パラメータ名

説明

CAPACITY

スレッド・プールで許容されるスレッドの最大数。

THREAD COUNT

スレッド・プール内の現在のスレッド数。

BUSY THREAD COUNT

作業が割り当てられている現在のスレッド数。スレッドがリソースまたはデータを待機中にブロックされたか、CPU上でアクティブに実行されている可能性があります。

ACCUMULATED REQUESTS

スレッド・プールに送信されたリクエストの合計数。

MAX STACK SIZE

スレッド・プール内のすべてのスレッドによって消費されたスタック・バイトの最大数。

パラメータ名

説明

CAPACITY

指定したキャッシュ・オブジェクトの合計容量。

TOTAL REQUESTS

指定したキャッシュ・オブジェクトに対する1秒当たりのリクエストの合計数。

AVG REQUESTS

指定したキャッシュ・オブジェクトに対する1秒当たりのリクエストの平均数。

AVG HITS

指定したキャッシュ・オブジェクトの1秒当たりの平均ヒット数。

AVG MISS

指定したキャッシュ・オブジェクトの1秒当たりの平均ミス数。

システム起動のトラブルシューティング

起動エラーの場合は、特定のトラブルシューティング手順が必要となります。

ここでは、システムの起動に関連した解決策について説明します。

- データベースが実行されていない場合の管理サーバーの起動エラー

- 管理対象サーバーの停止

- Oracle BIサーバーの起動エラー

- ログイン不能

データベースが実行されていない場合の管理サーバーの起動エラー

管理サーバーの起動時は、インストール時に指定したリポジトリ・データベースが実行されている必要があります。実行されていないと、JDBCエラーにより起動できなくなります。

問題: 管理サーバーを起動できない。

管理サーバーを起動できない場合は、次の操作を実行します。

- 次のディレクトリにある、管理サーバーおよび管理対象サーバーのログ・ファイルを参照します。
BI_DOMAIN/servers/AdminServer/logs

次のディレクトリにある管理対象サーバーのログ・ファイルを確認することも可能です。

BI_DOMAIN/servers/bi_server1/logs

原因: データベースが停止している。AdminServer.logに、次のスタック・トレースとともに「Caused By: java.net.UnknownHostException: yourcomputername」が書き込まれます。

####<Jan 19, 2010 8:04:09 PM PST> <Info> <JDBC> <username> <AdminServer> <[ACTIVE] ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)'> <<anonymous>> <Stack trace associated with message 001129 follows:

java.sql.SQLException: The Network Adapter could not establish the connection.

解決: データベースを起動します。

管理対象サーバーの停止

管理対象サーバーが停止している場合、コマンドラインを使用して起動します。

詳細は、「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください。

Oracle BIサーバーの起動エラー

BIサーバーを起動できない場合は、ログ・ファイルを参照します。

ログ・ファイルはログ・ビューアで表示するか、次のディレクトリから表示します。

BI_DOMAIN/servers/obis1/logs。またはログ・ビューアを使用します。

ログイン不能

問題: Oracle WebLogic Server管理コンソールにログインできない。

- 原因: 管理サーバーが稼動していない。
解決策: http://<host>:<port>/consoleが起動するかどうか確認してください。起動しない場合、BIシステムを起動します。詳細は、「コマンドを使用した起動、停止およびOracle BI EEプロセスのステータスの表示」を参照してください。

7 使用状況トラッキングの管理

この章では、Oracle Business Intelligenceの使用状況トラッキングを管理する方法について説明します。Oracle BIサーバーでは、使用状況トラッキング・データの収集がサポートされます。使用状況トラッキングが有効な場合、Oracle BIサーバーは各問合せの使用状況トラッキングのデータを収集し、そのデータをデータベース表に直接挿入します。

注意:

Oracle BI Summary Advisor機能は、使用状況トラッキング機能と連携しています。Summary Advisorは、使用状況トラッキングの直接挿入とのみ連携して機能します。

Oracle BI Summary Advisorは、Oracle Business IntelligenceをOracle Exalytics Machineで実行している場合にのみ使用できます。『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のOracle BIサマリー・アドバイザを使用した集計の問合せ候補の識別に関する項を参照してください。

この章の内容は次のとおりです。

- 使用状況トラッキングについて

- 使用状況トラッキングの情報を収集するための直接挿入の設定

- 使用状況トラッキング・データの説明

使用状況トラッキングについて

Oracle BIサーバーでは使用状況トラッキングの累積統計をサポートしており、これは、データベースの最適化、集計計画、使用するリソースに基づくユーザーや部門への請求など、様々な形で使用できます。

BIサーバーは、詳細な問合せレベルで使用状況を追跡します。

使用状況トラッキングを有効にすると、すべての問合せの統計がデータベース表に挿入されるか、使用状況トラッキング・ログ・ファイルに書き込まれます。直接挿入を使用する場合は、BIサーバーによって、使用状況トラッキング・データがリレーショナル・データベース表に直接挿入されます。直接挿入を使用して統計をデータベース表に書き込むことをお薦めします。

BIサーバーが起動すると、メタデータ内の列名が、使用状況トラッキング表内の有効な列のリストに対して検証されます。次のイベントが発生します。

- 列名。データベース表内の列とメタデータ内の列が一致しない場合、挿入のデータベース・エラーが発生します。

- Varchar長。メタデータ内の長さと表で設定されている長さが一致しない場合、nqserver.logファイルにエラーが書き込まれ、使用状況トラッキングが無効になります。

使用状況トラッキングの情報を収集するための直接挿入の設定

直接挿入は、使用状況トラッキングの設定における推奨方法です。

この項では、直接挿入を設定する方法および次の内容について説明します。

- 使用状況トラッキングの統計データベースの設定

- 直接挿入パラメータの設定

- オプションの直接挿入パラメータの設定

使用状況トラッキングの統計データベースの設定

使用状況トラッキングの直接挿入を使用する前に、使用状況トラッキングの統計を格納するデータベースを設定する必要があります。

ターゲット・データベースでリポジトリ作成ユーティリティ(RCU)を実行し、必要な統計スキーマを作成する必要があります。

通常、Oracle Business Intelligenceとともに使用するためにインストールしたデータベースを統計データベースとして使用します。それは、このデータベースにはすでにRCUで作成したスキーマが存在するためです。使用状況トラッキング用にRCUで作成された表の名前は、S_NQ_ACCT、S_NQ_DB_ACCTおよびS_NQ_INITBLOCKです。「使用状況トラッキング・データの説明」を参照してください。

また、そのデータベースを、Oracle BIリポジトリの物理レイヤーにインポートすることも必要です。

1. 選択した外部データベース上でリポジトリ作成ユーティリティを実行します。Oracle Business Intelligenceで使用するためにインストールしたデータベースを使用状況トラッキングの統計用に使用する場合は、RCUで作成したスキーマがすでに含まれているため、この手順をスキップできます。

2. 管理ツールを開き、このデータベースを物理レイヤーにインポートします。『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』を参照してください。

3. リポジトリを保存して閉じます。

直接挿入パラメータの設定

新しいインストールには、直接挿入のための特定のパラメータを設定できます。

新しい(アップグレードでない)インストールに直接挿入を設定するには、テキスト・エディタを使用します。

使用状況トラッキングの直接挿入を設定するには、次の手順を使用します。

1. Oracle BIサーバー・コンピュータで、NQSConfig.INIファイルをテキスト・エディタで開きます。このファイルは次の場所にあります:

BI_DOMAIN/config/fmwconfig/biconfig/OBIS

編集する前に、ファイルのバックアップ・コピーを作成します。

2. [USAGE_TRACKING]セクションで、次のパラメータを更新します。

- ENABLEをYESに設定します。

- DIRECT_INSERTをYESに設定します。

- Oracle BIリポジトリの物理レイヤーに表示されているように、PHYSICAL_TABLE_NAMEを、問合せ統計情報を収集するための完全修飾データベース表の名前に設定します。例:

PHYSICAL_TABLE_NAME = "My_DB"."DEV_BIPLATFORM"."S_NQ_ACCT";

- Oracle BIリポジトリの物理レイヤーに表示されているように、CONNECTION_POOLを、問合せ統計データベースの完全修飾接続プールの名前に設定します。例:

CONNECTION_POOL = "My_DB"."Usage Connection Pool";

- 初期化ブロックの統計に対応するレコードを挿入するデータベース表の完全修飾名にINIT_BLOCK_TABLE_NAMEを(Oracle BIリポジトリの物理レイヤーに表示されているとおりに)設定します。例:

INIT_BLOCK_TABLE_NAME = "My_DB"."DEV.BIPLATFORM"."S_NQ_INITBLOCK;

- 初期化ブロックの統計に対応するレコードを挿入する表の完全修飾接続プール名にINIT_BLOCK_CONNECTION_POOLを(Oracle BIリポジトリの物理レイヤーに表示されているとおりに)設定します。例:

INIT_BLOCK_CONNECTION_POOL = "My_DB"."Usage Connection Pool";

注意:
使用状況トラッキングの挿入が行われるためには、バックエンド・データベースへの書込み権限を持つユーザーIDで接続プールを構成する必要があります。また、接続タイプが国際データをサポートすることもお薦めします。

3. ファイルを保存して閉じます。

4. Oracle BIサーバーを再起動します。

オプションの直接挿入パラメータの設定

NQSConfig.INIファイルのUsage Trackingセクションには、いくつかのパラメータがあります。

前述の設定パラメータに加えて、次のオプションのパラメータもNQSConfig.INIファイルの使用状況トラッキング・セクションで更新できます。

- BUFFER_SIZE。このパラメータは、挿入文のバッファリング用にBIサーバーが割り当てるメモリー量を示します。このようなバッファにより、BIサーバーは複数の挿入文を1つのトランザクションに含めて発行でき、使用状況トラッキング挿入のスループットが向上します。また、通常の分析では使用状況トラッキング挿入を待つ必要がないため、問合せの平均レスポンス時間も向上します。サーバー・コンピュータ上の使用可能なメモリーとメモリーの使用状況に応じて、この値を調整します。

- BUFFER_TIME_LIMIT_SECONDS。このパラメータは、使用状況トラッキング・サブシステムが挿入文の発行を試行するまでの、挿入文がバッファ内に存続する最大時間を示します。この時間制限によって、静止状態が長く続いていても、BIサーバーは挿入文をすぐに発行できます。

- NUM_INSERT_THREADS。このパラメータは、バッファから挿入文を削除し、それを使用状況トラッキング・データベースに挿入するスレッドの数を示します。読取りと挿入で接続プールがそれぞれ別の場合、挿入スレッド数は通常、接続プールの最大接続設定に等しくなります。

- MAX_INSERTS_PER_TRANSACTION。このパラメータは、使用状況トラッキング・サブシステムが、1つのトランザクションの一部として発行を試みる挿入文の最大数を示します。この値が大きくなるほど、使用状況トラッキング挿入が長時間にわたって行われ、潜在的なスループットが増します。ただし、値が大きいと、デッドロックが原因でトランザクションが失敗する可能性も増します。BUFFER_TIME_LIMIT_SECONDSに小さい値を指定すると、トランザクション当たりの挿入数を制限できます。

「NQSConfig.INIファイルの構成設定」を参照してください。

使用状況トラッキング・データの説明

次の表は、S_NQ_ACCT使用状況トラッキング表内の各列の説明です。該当する場合は、データ型と長さも示されています。

次の表で説明している時間に関連したいくつかの列には、加算または減算によってその正確な値を求められると推測できるものがあります。たとえば、END_TSからSTART_TSを引けば、TOTAL_TIME_SECを求められるように思われるかもしれません。次の理由により、これらの列を使用しても正確な値は求められません。

- 様々なプロセスが並列に実行されており、その処理速度はBIサーバーにかかる負荷およびデータベースのパフォーマンスに応じて異なります。サーバーベースの処理は、軽いか集中的であるかのどちらかになります。

- すべての接続が使用中の場合、問合せはキューで処理を待機します。そのタイミングは、BIサーバーの負荷と構成に応じて異なります。

列

説明

CACHE_IND_FLG

デフォルトはNです。

Yは問合せのキャッシュ・ヒットを示し、Nはキャッシュ・ミスを示します。

COMPILE_TIME_SEC

問合せのコンパイルにかかった時間(秒単位)です。この表で説明しているように、COMPILE_TIME_SECの秒数はTOTAL_TIME_SECに含まれます。

CUM_DB_TIME_SEC

データベースに送信されるすべての問合せの累積時間。問合せは並行して実行されるため、累積問合せ時間はデータベースに接続している時間以上になります。たとえば、データベースに送信する4つの物理SQL文を論理リクエストが生成する場合に、それら3つの問合せ時間が10秒で、1つの問合せ時間が15秒であるとします。問合せは並行して実行されるため、nqsserverがデータベースに接続する時間は15秒間ですが、CUM_DB_TIME_SECには45秒と表示されます。

CUM_NUM_DB_ROW

バックエンド・データベースから返された合計行数です。

END_DT

論理問合せが完了した日付です。

END_HOUR_MIN

論理問合せが完了した時間(時間と分)です。

END_TS

論理問合せが終了した日付と時間です。開始タイムスタンプと終了タイムスタンプも、リソースが使用可能になるまでの問合せの待機時間を表します。

問合せの終了前に、問合せを発行しているユーザーがページから移動すると、最終的なフェッチは行われず、3600というタイムアウト値が記録されます。しかし、タイムアウトの前にユーザーがページに戻ると、その時点でフェッチが完了し、これがend_ts時間として記録されます。

ERROR_TEXT

デフォルトはNullです。Varchar(250)

バックエンド・データベースからのエラー・メッセージです。この列は、SUCCESS_FLG(詳細は、この表の後述のエントリを参照)が0(ゼロ)以外の値に設定されている場合のみ適用されます。複数のメッセージは連結され、BIサーバーによって解析されません。

ID

一意の行IDです。

NODE_ID

<hostname>:<component_name>を連結します。ここで、<component_name>は、環境変数COMPONENT_NAMEによってオーバーライドされます。たとえば、examplehost:obis1のようになります(単一インスタンスの場合)。

COMPONENT_NAMEのデフォルト値はobis1です。

NUM_CACHE_HITS

問合せに対してキャッシュ結果が返された回数を示します。NUM_CACHE_HITSは32ビットの整数(または10桁の整数)です。

デフォルトはNullです。

NUM_CACHE_INSERTED

問合せによってキャッシュ・エントリが生成された回数を示します。

デフォルトはNullです。NUM_CACHE_INSERTEDは32ビットの整数(または10桁の整数)です。

NUM_DB_QUERY

論理問合せリクエストを満たすためにバックエンド・データベースに対して発行された問合せの数です。成功した問合せ(SuccessFlag = 0)の場合、この値は1以上です。

PRESENTATION_NAME

デフォルトはNullです。Varchar(128)

Oracle BIプレゼンテーション・カタログの名前です。

QUERY_BLOB

論理SQL文全体が切り捨てられることなく含まれています。

QUERY_BLOB列は、長い文字列です。

QUERY_KEY

デフォルトはNullです。Varchar(128)です。

Oracle Business Intelligenceによって論理SQL文から生成されたMD5ハッシュ・キーです。

QUERY_SRC_CD

リクエストのソースです。

挿入可能な値の例は、次のとおりです。

分析またはエクスポート操作により、'Report'が挿入されます。

フィルタ・ダイアログで「値」ドロップダウンを使用するか、ダッシュボード・プロンプトを使用すると、'ValuePrompt'が挿入されます。

分析サーバー・キャッシュをシードするエージェントにより、'Seed'が挿入されます。

オンライン管理ツールの物理表または列行数、あるいはビュー・データにより、'NULL'が挿入されます。

QUERY_TEXT

Varchar(1024)です。

問合せで発行されたSQL文です。

この列の長さはALTER TABLEコマンドで変更できますが、この列に書き込まれるテキストは、物理レイヤーで定義されているサイズに常に切り捨てられます。リポジトリ管理者は、この列の長さを、バックエンド物理データベースでサポートされている最大問合せ長より大きな値に設定しないでください。

たとえば、Oracle Databaseでは最大4000のVarcharを使用できますが、4000文字ではなく4000バイトに切り捨てられます。このため、マルチバイト・キャラクタ・セットを使用している場合、使用しているキャラクタ・セットと文字に応じて、実際の最大文字列サイズの文字数が異なります。

REPOSITORY_NAME

問合せがアクセスするリポジトリの名前です。

ROW_COUNT

問合せクライアントに返される行数です。

大量のデータが問合せから返される場合、すべてのデータがユーザーに表示されるまで、この列には移入されません。

IMPERSONATOR_USER_NAME

デフォルトはNoneです。Varchar(128)です。

偽装ユーザーのユーザー名です。リクエストが偽装ユーザーとして実行されない場合、値は'None'です。

SAW_DASHBOARD

ダッシュボードのパス名です。問合せがダッシュボードを通じて発行されなかった場合、値はNULLです。

SAW_DASHBOARD_PG

デフォルトはNullです。Varchar(150)

ダッシュボード内のページ名です。リクエストがダッシュボード・リクエストでない場合、値はNULLです。

SAW_SRC_PATH

分析するOracle BIプレゼンテーション・カタログ内のパス名です。

START_DT

論理問合せが発行された日付です。

START_HOUR_MIN

論理問合せが発行された時間(時間と分)です。

START_TS

論理問合せが発行された日時です。

SUBJECT_AREA_NAME

アクセスされるビジネス・モデルの名前です。

SUCCESS_FLG

次のリストで定義される、問合せの完了ステータスです。

- 0 - 問合せがエラーを発生せずに正常終了しました。

- 1 - 問合せがタイムアウトしました。

- 2 = 行制限を越えたために問合せが失敗しました。

- 3 = その他の理由で問合せが失敗しました。

TOTAL_TIME_SEC

クライアントが分析へのレスポンスを待機している間に、BIサーバーが問合せの処理に要した時間(秒単位)です。TOTAL_TIME_SECには、COMPILE_TIME_SECの時間が含まれます。

この設定は、「問合せのロギング・レベルの設定」で説明されている、nqquery.logファイル内のレスポンス時間と同じです。

USER_NAME

問合せを発行したユーザーの名前です。

次の表は、S_NQ_DB_ACCT表の説明です。これは、S_NQ_ACCTに格納されている論理問合せに対応する物理SQL情報を提供することで、使用状況トラッキング表を補足しています。S_NQ_DB_ACCTには、S_NQ_ACCTへの逆方向の外部キー・リレーションシップがあります。

列

説明

END_DT

物理問合せが完了した日付です。

END_HOUR_MIN

物理問合せが完了した時間(時間と分)です。

END_TS

物理問合せが終了した日付と時間です。開始タイムスタンプと終了タイムスタンプも、リソースが使用可能になるまでの問合せの待機時間を表します。

ID

一意の行IDです。

LOGICAL_QUERY_ID

Varchar2(50)です。

S_NQ_ACCT表の論理問合せを参照します。

QUERY_BLOB

物理SQL文全体が切り捨てられることなく含まれています。

QUERY_BLOB列は、長い文字列です。

QUERY_TEXT

Varchar(1024)です。

問合せで発行されたSQL文です。

ROW_COUNT

問合せクライアントに返される行数です。

TIME_SEC

物理問合せの実行時間です。

START_DT

物理問合せが発行された日付です。

START_HOUR_MIN

物理問合せが発行された時間(時間と分)です。

START_TS

物理問合せが発行された日時です。

次の表はS_NQ_INITBLOCK使用状況トラッキング表の列を説明しています。これは初期化ブロックの情報を追跡します。

列

説明

USER_NAME

Varchar2(128)です。

初期化ブロックを実行したユーザーの名前。

REPOSITORY_NAME

Varchar2(128)です。

問合せがアクセスするリポジトリの名前です。

TENANT_ID

Varchar2(128)です。

初期化ブロックを実行したユーザーのテナント名。

SERVICE_NAME

Varchar2(128)です。

サービスの名前。

ECID

Varchar2(1024)です。

システム生成された実行コンテンツID。

SESSION_ID

Number(10)です。

セッションのID。

BLOCK_NAME

Varchar2(128)です。

実行済の初期化ブロックの名前。

START_TS

初期化ブロックが開始された日時。

END_TS

初期化ブロックが終了した日時。開始タイムスタンプと終了タイムスタンプも、リソースが使用可能になるまでの問合せの待機時間を表します。

DURATION

Number(13,3)です。

初期化ブロックの実行に要した時間の長さ。

NOTES

Varchar2(1024)です。

初期化ブロックおよびその実行に関する注意事項。

第V部 Oracle Business Intelligenceの構成

インストーラによってOracle Business Intelligenceがインストールされ、構成アシスタントによって動作するサンプル・アプリケーションが提供されますが、機能によっては追加の構成の変更が必要です(たとえば、外部システムや電子メール・システムへの接続の詳細の指定)。

デフォルトの構成設定を変更して、Oracle Business Intelligenceを環境やユーザーのニーズに適合させることもできます。

この部は、次の章で構成されています。

- Oracle Business Intelligenceを管理および構成するためのツールの使用

- メタデータの管理およびサービス・インスタンスの操作

- 外部システムへの接続の構成

- プレゼンテーション設定のデフォルトの構成

- マッピングおよび空間情報の構成

- タイムゾーンの構成

- Oracle Business Intelligenceのローカライズ

- 通貨オプションの構成

- Oracle BIプレゼンテーション・カタログの構成と管理

8 Oracle Business Intelligenceを管理および構成するためのツールの使用

この章では、Fusion Middleware Control、WebLogic Server管理コンソール、テキスト・エディタおよびWebLogic Scripting Toolを含むOracle Business Intelligenceを管理および構成するツールについて説明します。

この章の内容は次のとおりです。

- Fusion Middleware ControlおよびWebLogic Server管理コンソールを使用する理由

- Fusion Middleware Controlを使用したOracle Business Intelligenceシステム・コンポーネントの管理

- Oracle Business Intelligenceシステム設定の構成

- 「Oracle WebLogic Server管理コンソールによるOracle Business IntelligenceJavaコンポーネントの管理」

Fusion Middleware ControlおよびWebLogic Server管理コンソールを使用する理由

Fusion Middleware ControlおよびWebLogic Server管理コンソールを使用して、Oracle Business Intelligenceシステムを管理します。

これらのWebベース・ツールは、Oracle Business Intelligenceのほとんどの一般的なシステム管理タスクをサポートします。「Oracle Business Intelligenceの管理について」を参照してください。

Fusion Middleware Controlでは、ステータスの監視、プロセスの開始と停止、問題の解決およびコンポーネントの構成などのタスクを実行して、システム・コンポーネントを管理できます。また、Javaコンポーネントの状況を管理することもできます。たとえば、それらのステータスを監視して、それらを開始および停止できます。

WebLogic Server管理コンソールでは、Javaコンポーネントのステータスを監視してセキュリティを構成できます。「Oracle Business Intelligenceのシステム管理の概要」を参照してください。

複数の管理者による同時操作を可能にするロック・メカニズム

大規模なデプロイメントでは、複数の管理者が同時にアクセスしてシステムの状況を確認しているときに、別の管理者が構成設定を変更しようとする場合があります。Fusion Middleware ControlおよびOracle WebLogic Serverでは、複数の管理者が同じ構成設定を同時に更新しないよう、ロック・メカニズムを採用して、一度に1人の管理者のみが設定を変更できるようにしています。

注意:
複数の管理者が同じ管理者アカウントを使用して、気付かずに同じ構成設定を同時に更新する可能性があります。そのため、複数の管理者が同じ管理者アカウントを共有しないようにすることをお薦めします。

Fusion Middleware Controlを使用したOracle Business Intelligenceシステム・コンポーネントの管理

Fusion Middleware Controlを使用して、Oracle Business Intelligenceシステム・コンポーネント(Oracle BIサーバー、Oracle BIプレゼンテーション・サービス、Oracle BIスケジューラなど)を管理、監視および構成できます。また、Fusion Middleware Controlを使用して、管理サーバーおよび管理対象サーバーを管理することもできます。

この項では、次の項目について説明します。

- Fusion Middleware Controlへのログイン

- Fusion Middleware ControlのOracle Business Intelligenceページの表示

- Fusion Middleware Controlのナビゲーション・ツリーの使用

- Fusion Middleware ControlをOracle Business Intelligenceとともに使用するためのヒント

Fusion Middleware Controlへのログイン

Fusion Middleware Controlにログインするには、Webブラウザを開き、Fusion Middleware ControlのURLを入力します。

URLを次の形式で入力します。

http://hostname.domain:port/em

ポート番号は管理サーバーの番号で、デフォルトは9500です。

Fusion Middleware Controlは、「Oracle Business Intelligenceシステムを起動する条件」で説明しているように、管理サーバーが稼働している場合にのみ使用できます。

1. URLをWebブラウザに入力します。次に例を示します。

http://host1.example.com:9500/em

2. システム管理者のユーザー名とパスワードを入力し、「ログイン」をクリックします。

システム全体にわたる管理者のユーザー名とパスワードは、インストール・プロセスの実行時に指定します。このユーザー名とパスワードを使用して、WebLogic Server管理コンソール、Fusion Middleware ControlおよびOracle Business Intelligenceにログインできます。

または、Oracle BIのAdministratorアプリケーション・ロールに付与されている別のユーザー名とパスワードを入力します。Fusion Middleware Controlが表示されます。

注意:

HTTPリクエストをプロキシ・サーバーに送信するようにブラウザが構成されている場合、管理サーバーのHTTPリクエストをプロキシ・サーバーに送信しないようにブラウザを構成しなければならないことがあります。管理サーバーがブラウザと同じコンピュータに配置されている場合は、localhostまたは127.0.0.1に対して送信されたリクエストがプロキシ・サーバーに送信されないようにしてください。

Fusion Middleware ControlのOracle Business Intelligenceページの表示

ここでは、Oracle Business Intelligenceシステム・コンポーネントを管理するための、Oracle Business Intelligenceのページを表示する方法について説明します。

1. Fusion Middleware Controlにログインします。

2. 「Business Intelligence」フォルダを展開して、biinstanceノードを選択します。

次の図に示すように、Fusion Middleware Controlに「概要」ページが表示されます。

注意:

「Business Intelligence」フォルダが表示されない場合、またはその下にbiinstanceノードが存在しない場合は、Oracle Business Intelligenceシステム・コンポーネントはインストールされていません。『Oracle Business Intelligenceのインストールと構成』を参照してください。

可用性およびBIドメイン内で確認されている問題について情報を入力すると、現在のシステムのステータスが「概要」ページに表示されます(「システムの論理アーキテクチャとは」を参照)。「概要」ページでは、Oracle Business Intelligenceを起動および停止することもできます。

3. 「概要」ページで適切なタブを選択して、Oracle Business Intelligenceの管理タスクを実行します。

Fusion Middleware Controlのナビゲーション・ツリーの使用

ナビゲーション・ツリーを使用して、Fusion Middleware Controlで管理できるBIドメイン内のノードを移動および選択できます。

インストール時の選択内容に応じて、次のドメイン・コンポーネントをノードとしてナビゲーション・ツリーに表示できます。

- アプリケーション・デプロイメント
BIドメインにデプロイされているすべてのアプリケーションが表示されます(analytics、Oracle Business Intelligence for Microsoft Office、Oracle BI Publisherなど)。

- WebLogicドメイン
WebLogicサーバーの概要情報が表示されます。ノードを選択し、「Oracle WebLogic Server管理コンソール」メニュー・オプションをクリックしてWebLogic Server管理コンソールを表示し、Oracle WebLogic Serverを管理できます。

- bidomain
このノードは、Oracle Business IntelligenceのWebLogicサーバー・ドメインを表します。ここには、管理サーバーを含むAdminServerノードと、管理対象サーバー(デフォルトではbi_server1などのシングル・ノード・クラスタ)を含むbi_clusterノードがあります。「管理サーバー、管理対象サーバーおよびシステム・コンポーネントについて」を参照してください。

- AdminServer

- bi_cluster

- ビジネス・インテリジェンス

- biinstance
このノードは、Fusion Middleware Controlで管理できるOracle Business Intelligenceシステム・コンポーネントを表します。

このノードを選択して「概要」ページを表示し、システム・コンポーネントを管理します。

- メタデータ・リポジトリ
このノードは、Fusion Middleware Controlで管理できるメタデータ・サービス(MDS)のスキーマ・リポジトリを表します。

Fusion Middleware ControlをOracle Business Intelligenceとともに使用するためのヒント

Fusion Middleware ControlをOracle Business Intelligenceとともに使用する場合は、注意する必要がある考慮事項がいくつかあります。

Fusion Middleware Controlを使用してOracle Business Intelligenceを管理する場合は、次のヒントに留意してください。

- 『Oracle Fusion Middlewareの管理』の「Oracle Fusion Middlewareの管理のスタート・ガイド」を参照してください。

- Fusion Middleware Control内でOracle Business Intelligenceに関する情報を表示できる(ただし変更はできない)ユーザーが必要な場合があります。このようなユーザーは、Monitorsグループのメンバーにすることで構成できます。『Oracle WebLogic Serverロールおよびポリシーによるリソースの保護』 を参照してください。

- Fusion Middleware ControlとともにInternet Explorer 8を使用すると、表示に問題が発生することがあります。たとえば、「診断」ページの「ログ・メッセージ」タブで、全テキストを参照するためにスクロール・バーが必要なときにバーが消失していることがあります。
この問題を回避するには、ブラウザで必ず互換表示モードの選択を解除してください。

1. 「ツール」メニューから「インターネット オプション」を選択します。「詳細設定」タブの「ブラウズ」セクションで、「ページ レイアウト エラーから互換表示で自動的に回復」の選択が解除されていることを確認します。

2. 「ツール」メニューから「互換表示設定」を選択します。「互換表示でイントラネット サイトを表示する」および「互換表示ですべての Web サイトを表示する」の選択が解除されていることを確認します。

Oracle Business Intelligenceシステム設定の構成

機能的な動作(キャッシュ、しきい値など)または環境設定(ホスト名、ポート、ファイルまたはメタデータの場所)に関連するドメイン固有の場所に格納されている値を変更して、Oracle Business Intelligenceシステム設定を構成します。

次の方法を使用できます。

- Fusion Middleware Controlの使用

- テキスト・エディタの使用

- WLST (WebLogic Scripting Tool)の使用

次の表に、Oracle Business Intelligenceシステム設定を構成する場合に使用する方法を示します。各方法により、特定の構成ファイルの設定が更新されます。

実行する処理

使用可能なメソッド

更新方法

使いやすいユーザー・インタフェースの一般的な構成設定を変更します。

- Fusion Middleware Control
「Fusion Middleware Controlの使用」を参照してください。

この方法を使用することをお薦めします。ただし、設定を使用できない場合は、テキスト・エディタを使用できます。

Fusion Middleware Controlの特定のOracle Business Intelligence構成ページの値を変更します。

たとえば、BIサーバー・キャッシュを有効化するには、「構成」ページの「パフォーマンス」タブで「キャッシュ使用可能」チェック・ボックスをクリック(選択/選択解除)します。

ファイルを手動で編集して、構成設定を変更します。

- テキスト・エディタ
「テキスト・エディタの使用」を参照してください。

Fusion Middleware ControlのOracle Business Intelligenceページで設定を使用できない場合にこの方法を使用することをお薦めします。

テキスト・エディタを使用して構成テキスト・ファイルの値を変更します。

スクリプティング・ツールを使用して、より複雑な構成変更を行います。

- WebLogic Scripting Tool(WLST)
「WLST (WebLogic Scripting Tool)の使用」を参照してください。

ドキュメントで指示されている場合にこの方法を使用することをお薦めします。

WLSTスクリプティング・ツールを使用してコマンドを実行し、構成変更を行います。

Fusion Middleware Controlの使用

Fusion Middleware Controlを使用して、特定のOracle Business Intelligence構成設定を更新できます。

変更できる構成設定には、パフォーマンス設定、ダッシュボードおよび分析のデフォルト・プレゼンテーション設定、エージェントが使用するメール・サーバー設定などがあります。

Oracle Business Intelligence構成設定をFusion Middleware Controlで使用できない場合、テキスト・エディタを使用して構成ファイルの設定を更新できます。「Oracle Business Intelligenceシステム設定の構成」を参照してください。

1. Fusion Middleware ControlのOracle Business Intelligenceページの表示の説明に従って、Business Intelligenceの「概要」ページに移動します。

2. 該当するページとタブを選択して、変更する設定を表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

注意:
複数の管理者で同じ管理者アカウントを共有しないことをお薦めします。同じ構成設定に対して同時更新を気付かずに実行する可能性があります。

4. 各ページで変更を行います。

5. 変更後は、ページごとに「適用」をクリックします。

6. 変更が完了したら、次のいずれかを実行します。

- 「変更のアクティブ化」をクリックして変更内容を実行し、ロックを解除して、他のシステム管理者が変更を実行できるようにします。

- 「構成の解放」をクリックして、「構成をロックして編集」をクリックした以降のすべての変更を元に戻し、ロックを解除して、他のシステム管理者が変更を実行できるようにします。

7. 変更をアクティブ化したら、「概要」ページに移動して「再起動」をクリックします。

テキスト・エディタの使用

テキスト・エディタを使用して、構成ファイルの設定を追加または変更できます。

Fusion Middleware Controlで使用できないシステム構成設定に対してテキスト・エディタを使用します。

テキスト・エディタを使用して構成ファイルを更新する手順は、次のとおりです。

1. 編集するファイルのバックアップ・コピーを作成します。

2. テキスト・エディタで適切な構成ファイルを開きます。

詳細は、「構成ファイル」を参照してください。

3. 構成ファイルで、対象要素を探すか、ファイルに設定を追加する場合は新しい要素を作成します。

4. 該当する変更内容を入力します。

5. 変更内容を保存して構成ファイルを閉じます。

6. Fusion Middleware ControlでOracle Business Intelligenceを再起動し、「可用性」ページの「プロセス」タブに移動して、すべてのコンポーネントを再起動します。

詳細は、「Oracle Business Intelligenceプロセスの管理について」を参照してください。

WebLogic Scripting Tool (WLST)の使用

Oracle Business Intelligence WebLogic構成タスクを実行するためにWebLogic Scripting Tool (WLST)スクリプトが用意されています。たとえば、インストール中にドメインを作成したり、高可用性のためにマシンを追加する場合です。

次の場所からWLSTスクリプト・コマンドを実行します。

ORACLE_HOME/oracle_common/common/bin/wlst.sh (Windowsの場合はwlst.cmd)

オンライン(実行中のシステム・プロセス)またはオフライン(停止しているシステム・プロセス)・モードで、Oracle Business Intelligenceシステム設定を構成できます。以降の項では、オンラインおよびオフラインの構成変更を行う場合に適用される様々な条件について説明します。

- オフラインの構成変更の実行

- オンラインの構成変更の実行

オフラインの構成変更の実行

ノード・マネージャに関連する構成変更を除くすべてのオフラインの構成変更をマスター・ホストで行う必要があります。また、すべてのOracle BI EEプロセスを最初に停止する必要があります。

オフラインの変更を使用するには、管理サーバー、管理対象サーバー、システム・コンポーネントの順に起動する必要があります。管理対象サーバーを起動するコマンドは実行中の管理サーバーから構成をレプリケートする唯一のプロセスであるため、これは構成変更の一般的な要件です。

仮定と前提条件:

- ファイル・システム(オフライン)またはWeblogic管理者(オンライン)権限を持つ必要があります

- オフラインでコンポーネントを起動する場合、管理サーバーおよびノード・マネージャを最初に起動する必要があります。「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください

オフラインのWLSTの実行

次の場所からWLSTスクリプト・コマンドを実行します。

ORACLE_HOME/oracle_common/common/bin/wlst.sh

- オフライン・コマンドを発行する前に、readDomain(DOMAIN_HOME)コマンドを使用してドメインを選択する必要があります。
例:

readDomain('/u01/bi')

- オフライン・コマンドを発行した後、updateDomain()コマンドを使用して変更をコミットする必要があります。
例:

updateDomain('/u01/bi')

- closeDomain()コマンドを使用してドメインを選択解除します。
例:

closeDomain('/u01/bi')

間違えたか変更を破棄する場合、updateDomain()コマンドを使用せずにcloseDomain()コマンドを使用する必要があります。

オンラインの構成変更の実行

管理サーバー・ドメインMBeanにアクセスできるコンピュータからオンラインの構成変更を行うことができます。

仮定と前提条件:

- Weblogic管理者権限が必要です。

- 管理サーバーが稼働している必要があります。

- 変更後、影響を受けたBIコンポーネントを再起動する必要があります。「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください。

オンラインのWLSTの実行

次の場所からWLSTスクリプト・コマンドを実行します。

ORACLE_HOME/oracle_common/common/bin/wlst.sh

- 次のコマンドを発行して、管理サーバーに接続します。
./wlst.sh connect(<username>, <password>, <connect string>)

次に例を示します。

./wlst.sh connect('weblogic', 'mypassword', 't3://localhost:9500')

- コマンドを発行する前にedit()およびstartEdit()コマンドを発行して、編集ツリーを入力して編集セッションを起動する必要があります。

- save()コマンドを使用して、編集セッション中に行われたすべての変更を保存します。

- activate()コマンドを使用して変更をコミットします。

編集セッションの外側でコマンドを発行しようとすると、コマンドは失敗し、ヘルプ・メッセージが表示されます。

間違えたか変更を破棄する場合、undo()またはcancelEdit()コマンドを使用する必要があります。

Java Development Kit (JDK)の更新

Oracle Business Intelligenceのインストールおよび構成後、たとえば、組織のポリシーごとに更新が必要な場合には、そのインスタンスのJDKを更新する必要が生じることもあります。

JDKの更新を決定する前に、システム要件および動作保証ドキュメントの説明に従って、適切なバージョンを検討してください。「システム要件および動作保証の確認」を参照してください。

1. Oracle Business Intelligenceのすべてのサービスを停止します。

2. 適切なJDKバージョンをOracle Java Webサイトからダウンロードし、ORACLE_HOMEディレクトリにコピーします。

3. 既存のjdkディレクトリをjdk.OLDに名前変更します。

4. JDKインストーラを実行します。これにより、ディストリビューションがjdkversion-numディレクトリに解凍されます。

5. 既存の構成リファレンスがすべてそのまま有効となるように、ディレクトリ名をjdkversion-numからjdkに変更します。

6. Oracle Business Intelligenceのサービスを再起動します。

特定のJDKを使用したインストールの詳細は、Oracle Business Intelligenceのインストールと構成を参照してください。

Oracle WebLogic Server管理コンソールによるOracle Business Intelligence Javaコンポーネントの管理

Oracle WebLogic Server管理コンソールを使用して、Oracle Business Intelligence Javaコンポーネントを管理します。

Oracle WebLogic Server管理コンソールを表示する方法は、次のとおりです。

- Fusion Middleware Controlの「WebLogicドメイン」メニューのリンクをクリックする

- WebブラウザのウィンドウにURLを入力する

Oracle WebLogic Server管理コンソールは、WebLogic Serverの管理サーバーが実行されている場合にのみ使用できます。「Oracle Business Intelligenceプロセスの管理について」を参照してください。

1. WebLogic Serverの管理サーバーが稼動していない場合は、サーバーを起動します。

2. 次のいずれかの方法を使用して、Oracle WebLogic Server管理コンソールを表示します。
Fusion Middleware Controlの「概要」ページのリンクをクリックする:

a. Fusion Middleware Controlが表示されます。

b. 「WebLogicドメイン」メニューの「Oracle WebLogic Server管理コンソール」リンクをクリックします。
Oracle WebLogic Server管理コンソールのログイン・ページが表示されます。

WebブラウザのウィンドウでURLを使用する:

a. Webブラウザを起動します。

b. ブラウザに次のURLを入力します。
http://<hostname>:<port>/console/

例, http://example.com:9500/console/

この場合、hostnameは管理サーバーのDNS名またはIPアドレス、portは管理サーバーがリクエストを待ち受けるリスニング・ポート(デフォルトはポート9500)です。ドメイン全体に対応する管理ポートを構成している場合は、そのポート番号を使用します。Secure Sockets Layer (SSL)を使用するように管理サーバーを構成している場合は、次のようにhttpの後に「s」を追加する必要があります。

https://<hostname>:9500/console/

このURLの例では、SSLが使用されます。

Oracle WebLogic Server管理コンソールのログイン・ページが表示されます。

3. システム管理者のユーザー名とパスワードを入力し、「ログイン」ボタンをクリックします。
システム全体にわたる管理者のユーザー名とパスワードは、インストール・プロセスの実行時に指定します。このユーザー名とパスワードを使用して、WebLogic Server管理コンソール、Fusion Middleware ControlおよびOracle Business Intelligenceにログインできます。または、次のセキュリティ・グループのいずれかに属するユーザー名を入力します。

- Administrators

- Operators

- Deployers

- Monitors

これらのグループには、Oracle WebLogic Server管理コンソールのシステム管理機能に対する様々なアクセス・レベルが用意されています。

セキュリティ・システムを使用して、これらのグループのユーザーを追加または削除することにより、コンソールへのアクセスを制御できます。

HTTPリクエストをプロキシ・サーバーに送信するようにブラウザが構成されている場合、管理サーバーのHTTPリクエストをプロキシ・サーバーに送信しないようにブラウザを構成しなければならないことがあります。管理サーバーがブラウザと同じコンピュータに配置されている場合は、localhostまたは127.0.0.1に対して送信されたリクエストがプロキシ・サーバーに送信されないようにしてください。

次の図に示すように、Oracle WebLogic Server管理コンソールでbiドメインを選択します。

このページで、Oracle Business Intelligence Javaコンポーネントを監視および管理できます。

注意:

Oracle WebLogic Server管理コンソールの使用の詳細は、Oracle WebLogic Server管理コンソールのオンライン・ヘルプ・システムを参照してください。このヘルプ・システムでは、コンソールを使用して、デプロイされたWebアプリケーションに対するコンテキスト・ルートをオーバーライドする方法について説明します。Oracle Business Intelligenceに対するコンテキスト・ルートの変更はサポートされていません。これは、内部リンクやエンドユーザーのエンド・ポイントには多くのコンテキスト・ルートが使用されているためです。

9 メタデータの管理およびサービス・インスタンスの操作

この章では、BIアプリケーション・アーカイブ(BAR)・ファイルのOracle Business Intelligenceのメタデータを管理する方法とサービス・インスタンスを操作する方法について説明します。

この章の内容は次のとおりです。

- Oracle Business Intelligenceアプリケーション・アーカイブ(BAR)・ファイルについて

- サービス・インスタンスの管理

Oracle Business Intelligenceアプリケーション・アーカイブ(BAR)・ファイルについて

この節の内容は以下のとおりです。

- Oracle Business Intelligenceのアプリケーション・アーカイブ(BAR)・ファイルの概要

- 使用可能な定義済のBARファイル

- BARファイルのインポートについて

Oracle Business Intelligenceのアプリケーション・アーカイブ(BAR)・ファイルの概要

Oracle Business Intelligenceのアプリケーション・アーカイブ(BAR)・ファイルは、密接したセットのBIメタデータ・アーティファクト(データ・モデル、コンテンツ・モデルおよび認可モデル)を含む圧縮されたアーカイブ・ファイルです。

BARファイルをBIサービス・インスタンスにインポートできます。BIサービス・インスタンスをBARファイルにバックアップし、BIドメインで実行している既存のサービス・インスタンスまたは別のBIインストールで実行している異なるサービス・インスタンスに後でリストアできます。

BARファイルには、次のBIアプリケーション・モジュール・アーティファクトが含まれます。

- Oracle BIサーバーのデータ・モデル・メタデータ。このメタデータはxmlベースですが、.RPDファイルと機能的に同等です。

- サービス・インスタンスのプレゼンテーション・サービス・カタログ・メタデータ。

- アプリケーション・ロールおよびアプリケーション・ロール・メンバーシップとサービス・インスタンスの権限および権限セット付与を含むセキュリティ・ポリシー・メタデータ。

- BARファイルの依存性を宣言するマニフェスト・ファイル。

使用可能な定義済のBARファイル

オラクル社では、サービス・インスタンスとともに使用するBIメタデータを含む多数の定義済のBARファイルを提供しています。

インストール中に次のBARファイルのいずれかを選択できます。

- 空のBAR - oracle.bi.application.empty.bar
空のBARファイルを使用すると、メタデータおよびセキュリティ・ポリシーを完全に制御できます。または、インポートできる別のシステムから既存のBARを使用できます。

ORACLE_HOME/bi/bifoundation/admin/provisioning/oracle.bi.application.empty.bar

空のBARファイルには、システムへのログインおよび管理を行う管理者ユーザーの十分な権限のみが含まれます。

次の表に、空のBARファイルに含まれるアプリケーション・ロールおよび対応する権限セットを示します。

アプリケーション・ロール

権限セット

BIServiceAdministrator

obisch.administrator

essbase.administrator

obips.administrator

cds.administrator

bip.administrator

obis.administrator

- SampleAppLite BAR - SampleAppLite.bar
インストール時にSampleAppLiteを選択できます(Oracle Business Intelligenceのインストールと構成を参照)。

SampleAppLite BARは、すぐにBI分析を使用して起動し、製品の機能を示すことができます。

SampleAppLite BARファイルには、2つのサブジェクト・エリア、レポートのコレクション、読取り、書込みおよび管理タスク用のアプリケーション・ロールを使用したファイル・ベースのデータ・ソースが含まれます。

ORACLE_HOME/bi/bifoundation/samples/sampleapplite/SampleAppLite.bar

次の表に、SampleAppLite BARファイルに含まれるアプリケーション・ロールおよび対応する権限セットを示します。

アプリケーション・ロール

権限セット

BIServiceAdministrator

obisch.administrator

essbase.administrator

obips.administrator

cds.administrator

bip.administrator

obis.administrator

BIConsumer

bip.consumer

BIContentAuthor

va.author

obisch.author

bip.author

「サンプル・アプリケーションでの作業」を参照してください。

- 初期BAR
最初からメタデータを作成する場合に初期BARを使用する必要がありますが、通常のセキュリティ・ポリシーを配置する必要があります。

初期BARは、サンプル・アプリケーションBARと同じセキュリティ・ポリシーを含むことを除いて実質的に空です。

たとえば、初期BARをサービス・インスタンスにインポートしてユーザーが最初から固有のデータをインポートする場合にVisual Analyzerのサービス・インスタンスを作成すると、初期アプリケーション・ロールを使用してユーザーをプロビジョニングするだけで、製品を使用してすぐにログインおよび起動できます。

BARファイルのインポートについて

BARファイルをサービス・インスタンスにインポートする場合、サービス・インスタンスはBARファイルからインポートされたデータ・モデル、コンテンツおよびセキュリティ・ポリシーを使用します。

インポート・プロセスは次の処理を行います。

- BARで定義されているコンテンツ、モデルおよびセキュリティ・ポリシーを取得して、サービス・インスタンスにデプロイします。

- サービス・インスタンスですでに確立されている既存のコンテンツ、モデル、セキュリティ・ポリシーを上書きします。

サービス・インスタンスの管理

サービス・インスタンスには、すべてのOracle Business Intelligenceメタデータ(つまり、リポジトリ・データ、プレゼンテーション・カタログ、セキュリティ・ポリシー)が含まれ、メタデータに行うカスタマイズが含まれます。次の表で説明されているWebLogic Scripting Tool (WLST)コマンドを使用してBIドメインのサービス・インスタンスを管理します。

「WLST (WebLogic Scripting Tool)の使用」を参照してください。

コマンド

説明

listBIServiceInstances

このコマンドは、BIドメインのすべてのサービス・インスタンス・キーを示します。

getBIServiceInstance

このコマンドは、特定のサービス・インスタンス・キーのサービス・インスタンスの詳細を取得します。

scaleOutBIServiceInstance

このコマンドは、新しいコンピュータにサービス・インスタンスをスケールアウトし、サービス・インスタンスがBIドメイン内の指定されたコンピュータで使用できることを確認します。このコマンドは、拡張した場合のみ使用されます。

exportServiceInstance

このコマンドは、BARファイル形式でサービス・インスタンスを特定のエクスポート・ディレクトリにエクスポートします。

importServiceInstance

このコマンドは、カスタマイズとしてすでにエクスポートされたバー(サービス・インスタンス)を特定の環境にインポートします。

refreshServiceInstance

このコマンドは、BIドメインから継承されるサービス・インスタンスのserviceKeyの一部の側面をリフレッシュします。たとえば、新しいモジュールまたは製品がBIドメインに追加されると、サービス・インスタンスがリフレッシュされる場合にそのモジュールまたは製品の権限セットのみをサービス・インスタンスで使用できます。

refreshDomainServiceInstances

このコマンドは、ドメインのすべてのサービス・インスタンスをリフレッシュします。

resetServiceInstance

このコマンドは、特定のサービス・インスタンスを空の状態にリセットします。空のBARファイルのインポートと同等です。

パラメータ

説明

domainHome

BIドメイン・ホームへのパス。

/oraclehome/user_projects/domains/bi

serviceInstanceKey

関連付けるかスケール・アウトするサービス・インスタンスのキー。

例:

mycompany.facility

machine

スケール・アウトするコンピュータの名前。

例:

machine=mycompany.example.com

port

スケール・アウトしたコンピュータで使用するポート番号。

例:

port=9768

monitorPort

スケール・アウトしたコンピュータで使用するモニター・ポートの名前。

例:

portMonitor=9502

BIサービス・インスタンスおよびBARファイルに対するすべてのWLSTコマンドの前提:

- ファイル・システム(オフライン)権限を持つ必要があります。

- WLSTコマンドをオフラインで実行します。

- WLSTを使用してサービス・インスタンスを変更した後、システムを起動する必要があります。

listBIServiceInstances

このコマンドでは、すべてのサービス・インスタンスをリストできます。

1. WLSTコマンドライン・スクリプティング・ツールを起動します。

「WLST (WebLogic Scripting Tool)の使用」を参照してください。

2. 次のようにコマンドを入力します。

listBIServiceInstances(domainHome)

domainHomeはBIドメイン・ホームのパスです。

例:

listBIServiceInstances('/oraclehome/user_projects/domains/bi')

3. コマンドは、サービス・インスタンス・キーのリストを返します

「getBIServiceInstance」を参照してください。

getBIServiceInstance

このコマンドは、サービス・インスタンス詳細を表示します。

情報の一部を次に示します。

- メタデータ構成: アプリケーションの関連付けおよびカスタマイズ。

- コンポーネントの詳細。

- 説明。

1. 次のコマンドを入力して、指定されたサービス・インスタンス詳細をフェッチします。

getBIServiceInstance(domainHome, serviceInstanceKey)

例:

getBIServiceInstance('/oraclehome/user_projects/domains/bi', 'mycompany.facility')

2. コマンドは、詳細の一部を含むサービス・インスタンス・オブジェクトを返します。

- サービス・インスタンス・キー。

- 説明。

- コンポーネントのリスト。

- アプリケーション・モジュールの一覧表示。

scaleOutBIServiceInstance

このコマンドは、サービス・インスタンスを新しいコンピュータにスケールアウトして、ドメインでサービス・インスタンスを使用できるようにします。

可用性が増えた後にサービス・インスタンスが作成される場合、このコマンドを使用します。「Oracle Business Intelligenceの可用性の管理(水平方向のスケーリング)」を参照してください。

scaleOutBIServiceInstance(domainHome, serviceInstanceKey, machine, port=None, portMonitor=None)

このコマンドは、詳細を含むサービス・インスタンス・オブジェクトを返します。

前提条件:

- 指定しないかぎり、すべてのポートがデフォルトのBIポート範囲から割り当てられます。

- クラスタ・コントローラ、スケジューラおよびBIサーバー・マスターが変更されていません。

- 新しいコンポーネントを起動する必要があります。オフラインにする場合、管理サーバーとノード・マネージャを最初に起動する必要があります。「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください。

次の表に、このコマンドのパラメータを示します。

パラメータ

説明

domainHome

BIドメイン・ホームへのパス。

serviceInstanceKey

スケール・アウトするサービス・インスタンスのキー。

machine

サービス・インスタンスをスケール・アウトするコンピュータの名前。

次に例を示します。

scaleOutBIServiceInstance('/oraclehome/user_projects/domains/bi','mycompany.facility', 'example.com')

事後状態:

- 新しいコンポーネントが作成されます。

- 新しいポートが割り当てられます。

- 新しいサービス・インスタンスが登録されます。

exportServiceInstance

このコマンドは、BARファイルとしてサービス・インスタンスを指定されたエクスポート・ディレクトリにエクスポートします。

次に、別の環境または同じ環境にBARファイルをインポートできます。これらのオプション・パラメータの詳細は、次の表に示されています。

exportServiceInstance(domainHome serviceInstanceKey workDir, exportDir, applicationModuleName, applicationModuleDesc, applicationModuleVersion, includeCatalogRuntimeInfo, includeCredentials)

パラメータ

説明

domainHome

BIドメイン・ホームへのパス。

serviceInstanceKey

サービス・インスタンスのキー。

workDir

実行用の作業ディレクトリ。

exportDir

BARファイルをエクスポートするディレクトリ

applicationModuleName

将来の使用のために予約されています。

applicationModuleDesc

将来の使用のために予約されています。

applicationModuleVersion

将来の使用のために予約されています。

includeCatalogRuntimeInfo

オプション - このフラグがtrueである場合、カタログ・ランタイム情報(たとえば、ユーザー・フォルダ)がエクスポートに含まれます。それ以外の場合、カタログ・ランタイム情報がスキップされます。このフラグのデフォルト値はfalseです。

includeCredentials

オプション - これは、エクスポートされたメタデータ・リポジトリ・コンテンツを暗号化するパスワードです。このフィールドのデフォルト値は、Noneです。この値を指定しない場合、接続資格証明はエクスポートされません。それ以外の場合、接続資格証明がエクスポートされます。

次に例を示します。

exportServiceInstance( '/oraclehome/user_projects/domains/bi','mycompany.facility', '/workDir', '/scratch/exportDir')

exportServiceInstance('/oraclehome/user_projects/domains/bi/','mycompany.dev', '/scratch/workDir', '/scratch/exportDir', 'mycompany.dev.test' , 'mycompany dev test', '11.1.1.0')

exportServiceInstance('/oraclehome/user_projects/domains/bi/','mycompany.dev', '/scratch/workDir', '/scratch/exportDir', 'mycompany.dev.test' , 'mycompany dev test', '11.1.1.0', true, 'Test123')

exportServiceInstance('oraclehome/user_projects/domains/bi/','mycompany.dev', '/scratch/workDir', '/scratch/exportDir', 'mycompany.dev.test' , 'mycompany dev test')

exportServiceInstance('/oraclehome/user_projects/domains/bi/','mycompanyexample.dev', '/scratch/workDir', '/scratch/exportDir', None , 'mycompany dev test')

importServiceInstance

このコマンドは、指定されたBARファイルからターゲット・サービス・インスタンスにBIメタデータをインポートします。

importServiceInstance(domainHome, serviceInstanceKey, barLocation, importRpd, importWebcat, importJazn, includeCredentials)

次の表に、このコマンドのパラメータを示します。

パラメータ

説明

domainHome

BIドメイン・ホームへのパス。

serviceInstanceKey

サービス・インスタンスのキー。

barLocation

インポートされたサービス・インスタンス・バーの絶対パス。

importRpd

オプション - このパラメータの値はtrueまたはfalseに設定できます。デフォルト値は'true'です。このパラメータはメタデータの選択インポートをサポートします。このフラグが'false'に設定されている場合、コマンド実行はリポジトリ・メタデータをインポートしません。

importWebcat

オプション - このパラメータの値はtrueまたはfalseに設定できます。デフォルト値は'true'です。このパラメータはカタログの選択インポートをサポートします。このフラグがfalseである場合、コマンドはカタログをインポートしません。

importJazn

オプション - このパラメータの値はtrueまたはfalseに設定できます。デフォルト値は'true'です。このパラメータはJaznの選択インポートをサポートします。このフラグがfalseである場合、コマンドはJaznをインポートしません。

includeCredentials

オプション - このパスワードを使用して、インポートされたrpdコンテンツを復号化します。

次に例を示します。

importServiceInstance( '/scratch/mydir/oraclehome/user_projects/domains/bi','mycompany.facility', '/scratch/exportDir/mycompany.finance.bar')

importServiceInstance('/scratch/mydir/oraclehome/user_projects/domains/bi', 'demosvc1', '/scratch/mydir/oraclehome/bi/bifoundation/samples/sampleapplite/test/SampleAppLite1.bar', true, false, false, 'Test123')

importServiceInstance('/scratch/mydir/oraclehome/user_projects/domains/bi', 'demosvc1', '/scratch/mydir/orahome/bi/bifoundation/samples/sampleapplite/test/SampleAppLite1.bar', importRPD=true,includeCredentials='Test123')

注意:12.2.1.2.0 BARファイルを、12.2.1.1.0や12.2.1.0.0などの以前のOracle BI EEリリースにインポートし、BARファイルに12.2.1.2.0より前のリリースでサポートされないデータセット・メタデータ(Excelスプレッドシートなど)が含まれている場合、データセット・メタデータはインポートされず、インポートされないメタデータはログにも記録されません。動作の概要は次のとおりです。

- データセット・メタデータ(Excelスプレッドシートのsales.xlsなど)を含む上位バージョンのBARが、データセット・メタデータをサポートしない以前のOracle BI EEリリースにインポートされると、インポート・プロセスでは、新しいバージョン(リリース12.2.1.2.0以上)のインポート済BARにあるデータセット・メタデータのコンテンツがサイレントにスキップされます。

- サービス・インスタンス・ログには、インポートされるメタデータの情報が示されます。ただし、このログには、インポート操作の一部として無視されるメタデータの情報は示されません。

refreshServiceInstance

このコマンドは、BIドメインから継承されるサービス・インスタンスの一部の側面をリフレッシュします。

たとえば、新しいモジュールまたは製品がBIドメインに追加されると、サービス・インスタンスがリフレッシュされる場合にそのモジュールまたは製品の権限セットのみをサービス・インスタンスで使用できます。

refreshServiceInstance(domainHome, serviceKey)

次の表に、このコマンドのパラメータを示します。

パラメータ

説明

domainHome

BIドメイン・ホームへのパス。

serviceKey

サービス・インスタンスのキー。サービス・インスタンスの一意の識別子です。

次に例を示します。

refreshServiceInstance('/oraclehome/user_projects/domains/bi', 'mycompany.finance')

refreshDomainServiceInstances

このコマンドは、BIドメインのすべてのサービス・インスタンスをリフレッシュします。

refreshDomainServiceInstances(domainHome)

次の表に、このコマンドのパラメータを示します。

パラメータ

説明

domainHome

BIドメイン・ホームへのパス。

次に例を示します。

refreshDomainServiceInstances('/oraclehome/user_projects/domains/bi')

resetServiceInstance

このコマンドは、特定のサービス・インスタンスのすべてのカスタマイズを削除します(空のBAR状態と同様)。

resetServiceInstance(domainHome, serviceKey)

次の表に、このコマンドのパラメータを示します。

パラメータ

説明

domainHome

BIドメイン・ホームのパス。たとえば、/oraclehome/user_projects/domains/biなどです。

serviceKey

サービス・インスタンスのキー。サービス・インスタンスの一意の識別子です。たとえば、'ssi'などです。

この例では、resetServiceInstanceコマンドを使用してカスタマイズを削除しています。

1. 空のサービス・インスタンスを使用(空のBARファイルの使用と同じ)して、Oracle Business Intelligenceを構成します。

注意:
空のBARファイルは次の場所にあります。

$BI_PRODUCT_HOME/bi/bifoundation/admin/provisioning/oracle.bi.application.empty.bar

2. SampleAppLiteをBIドメインにデプロイし、サービス・インスタンスに関連付けます。

3. ベースBAR上でカスタマイズを行います。

4. resetServiceInstanceコマンドを使用します。

次に例を示します。

resetServiceInstance('/oraclehome/user_projects/domains/bi', 'ssi')

これにより、手順3で作成されたカスタマイズが削除され、サービス・インスタンスが手順2の状態に戻ります。

10 外部システムへの接続の構成

この章では、Oracle Business Intelligenceの外部にあるシステムへの接続を構成する方法について説明します。

この章の内容は次のとおりです。

- 電子メールおよびエージェントの構成

- アクション・フレームワークを使用したアクションの構成

- マーケティング・コンテンツ・サーバーへの接続の構成

- データ・ソースへの接続の構成

外部システムへの接続を構成するプロセスの一部として、Oracle BIスケジューラ用のデータベースを構成できます。Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイドのOracle BIスケジューラ用のデータベースを構成するためのFusion Middleware Controlの使用に関する項を参照してください。

電子メールおよびエージェントの構成

Fusion Middleware Controlを使用して、エージェントで使用される一般的な電子メール設定を構成できます。

拡張構成設定については、「エージェントの構成および管理」で説明しています。

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

エージェントに影響する電子メール設定を構成すると、ユーザーおよび他の通知受信者がメッセージを適切に受け取ることができます。

この手順を開始する前に、次の情報を理解しておく必要があります。

1. 「Business Intelligence概要」ページに移動します。

2. 必要に応じて、「構成」ページの「メール」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. このページのヘルプ・トピックの説明を参照して、各要素を設定します。次のオプションに関するページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。

- SMTPサーバー

- ポート

- 送信者の表示名
このオプションは、送信者アドレスの重要な代わりとしてSMTPのFromフィールドで使用されます。デフォルトはOracle Business Intelligenceです。

- 送信者の電子メール・アドレス
このオプションは、Oracle BIスケジューラから送信されるすべてのメールに対して、送信者の返信先アドレスとして使用されるSMTPサーバーの電子メール・アドレスを指定します。初期値はdefaultuser@defaultmailserver.comです。この値は、有効な電子メール・アドレスに変更する必要があります。電子メール受信者が返信する必要がないことを示す場合は、このフィールドにno_reply@mycompany.comまたはdo_not_reply@mycompany.comを追加してください。

- ユーザー名

- パスワード

- パスワードの確認

- 失敗時の再試行回数

- 最大受信者数

- アドレッシング方式 宛先、ブラインド・コピー受信者(BCC)

- 接続のセキュリティ

- CA証明書ソースの指定

- CA証明書ディレクトリ

- CA証明書ファイル

- SSL証明書検証の深さ

- SSL暗号リスト

5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。

6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

エージェントの詳細構成設定の詳細は、「エージェントの構成および管理」を参照してください。

対応する構成ファイルの要素の詳細は、ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピングを参照してください。

アクション・フレームワークを使用したアクションの構成

ユーザーはOracle BIプレゼンテーション・サービスのユーザー・インタフェースを使用してアクションを作成できます。

アクションは、ユーザーがアクション・リンクをクリックすることで明示的に起動できる操作またはプロセスです。エージェントの最終ステップとして、アクションを自動的に起動することもできます。

組織で使用するアクションを構成できます。各構成設定の詳細な説明および例を含む、外部システムに対するアクションを有効にするアクション・フレームワークの使用方法についての包括的な説明は、Oracle Business Intelligence Enterprise Editionインテグレーターズ・ガイドを参照してください。

マーケティング・コンテンツ・サーバーへの接続の構成

Oracle Marketing Segmentationはセグメンテーションを処理します。これには、サブジェクト・エリアに基づく各種条件を指定して、対象者を異なるセグメントに分割する処理が含まれます。

セグメントが準備されると、ユーザーは、セグメントの条件を満たす連絡先とアカウントのリストを作成します。その後、生成したリストを、ファイル・システム、データベース、または指定したコンテンツ・サーバーに格納するかどうかを指定します。

ユーザーがコンテンツ・サーバーにリストを格納できるようにするには、管理者として、適切なURLおよびinstanceconfig.xmlファイルの他の値を指定することで、コンテンツ・サーバーへの接続を構成する必要があります。

instanceconfig.xmlファイル内の様々な要素を使用して、マーケティング・コンテンツ・サーバーへの接続用に設定を構成できます。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次のリストで説明されている要素を追加する必要のあるセクションを見つけます。

- URL: コンテンツ・サーバー・マシンのアドレスを指定します。

- SocketTimeoutSec: レコードの送信時にソケットがコンテンツ・サーバーからの応答を待機する秒数を指定します。デフォルト値は60です。最小値および最大値はありません。

- FileSizeMB: リスト作成時に生成されコンテンツ・サーバーに挿入されるファイルのサイズをMB単位で指定します。デフォルトは10です。最小サイズは1MB、最大サイズは50MBです。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Marketing>
<ContentServer>
<URL>myhost.com:6666/st1b2rep/idcplg</URL>
<SocketTimeoutSec>120</SocketTimeoutSec>
<FileSizeMB>5</FileSizeMB>
</ContentServer>
</Marketing>
</ServerInstance>

instanceconfig.xmlファイルには、ユーザー名とパスワードの値は指定できません。かわりに、中央の資格証明ウォレットに他のすべてのユーザー名およびパスワードとともに安全に格納される値を指定します。

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

データ・ソースへの接続の構成

データ・ソースへの接続はOracle BIリポジトリで定義されます。リポジトリ開発者は、管理ツールを使用し、メタデータをインポートして接続プールを構成することによりデータ・ソース接続を構成します。

『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のメタデータのインポートおよびデータソースの操作に関する項を参照してください。

本番環境およびその他の環境への移行時に、リポジトリ内の接続プール情報を更新する必要がある場合があります。Oracle BIサーバーXML APIを使用して、これらの接続プールの変更を自動化できます。『Oracle Business Intelligence Enterprise Edition XMLスキーマ・リファレンス』のテスト環境から本番環境への移行に関する項を参照してください。

11 プレゼンテーション設定のデフォルトの構成

この章では、管理者がFusion Middleware Controlを使用して一般に変更する、Oracle Business Intelligenceのデフォルトのプレゼンテーション設定を変更する方法について説明します。

拡張構成設定については、「プレゼンテーション設定の手動による変更」で説明しています。

Fusion Middleware Controlを使用したプレゼンテーション設定のデフォルトの変更

プレゼンテーション設定のデフォルトを変更すると、ユーザーが自分用にプレゼンテーションをカスタマイズするときに同じルック・アンド・フィールから作業を開始できます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

1. 「Business Intelligence概要」ページに移動します。

2. 「構成」ページの「プレゼンテーション」タブを表示します。

3. 「ロックと編集」をクリックして、変更を実行できるようにします。

4. このページのヘルプ・トピックの説明を参照して、各要素を設定します。次のオプションに関するページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。

- 「ページ・タブの表示」オプション

- 「セクション見出しの表示」オプション

- 「ダッシュボードのセクションを閉じられるようにする」オプション

- 「ピボット・テーブルで自動プレビューを表示」オプション

5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。

6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

分析とダッシュボードの詳細構成設定の詳細は、「分析とダッシュボードの構成および管理」を参照してください。

対応する構成ファイルの要素の詳細は、ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピングを参照してください。

12 マッピングおよび空間情報の構成

この章では、Oracle BI管理ツールでマップ・ビューのマッピングおよび空間情報を構成する方法について説明します。

Oracle BI管理ツールをインストールすると、ユーザーにデータを提供するマップを表示するための機能がインストールされます。分析でマップを利用したり、ダッシュボードにマップを表示できるようにするには、この章の説明に従って、事前にシステム要件を理解し、レイヤーおよびマップを指定して、メタデータを構成する必要があります。

この章の内容は次のとおりです。

- マップ・ビューのシステム要件

- ハードウェアのサイズ設定およびマップのデプロイメント戦略

- マップ・ビューで使用するためのサンプル空間データセット

- マップの管理

マップの拡張構成オプションの詳細は、「マッピングおよび空間情報の高度なオプションの構成」を参照してください。

マップ・ビューのシステム要件

マップ・ビューをダッシュボードに追加するには、いくつかのコンポーネントを構成する必要があります。

ダッシュボードにマップ・ビューを表示するには、システムに次のコンポーネントが必要です。

- Oracle MapViewer。Oracle Spatialが管理する空間データを使用してマップをレンダリングするエンジンとして機能するJ2EEサービスです。MapViewerはOracle BI EEと密接に統合されています。MapViewerは、Oracle BI EEの一部としてインストールされ、Webアプリケーション・サーバー上のOracle BI EEと同じドメインにデプロイされます。
MapViewerには、空間データの問合せおよび地図レンダリングの複雑さを意識させず、より上級のユーザーに対してはカスタマイズ可能なオプションを提供するサービスとツールが備わっています。MapViewerはロケーション・ベースのサービスおよびアプリケーションと統合することを目的として設計されています。

「MapViewerでのマップ・ビューのサポートの構成」を参照してください。

- 空間境界データ。このデータはNAVTEQなどにより提供され、Oracleカスタマは、Oracle Technology Networkからデータをダウンロードできます。この空間データ、およびテーマやスタイルを含むその他の空間メタデータは、Oracle MapViewerがマップ・ビューで表示する際にアクセスできるよう、Oracle Databaseに格納する必要があります。

- ホスト・マップ。Oracle BI EEでは、ユーザーはOracle eLocationサービスからホスト・マップにアクセスできます。使用に関する条項および条件は、次のURLに記載されています。
http://elocation.oracle.com/elocation/legal.html

- Oracle Database 10g以降。空間データを格納します。
Oracle Locator。ほとんどのカスタマ・アプリケーションが必要とするコア・ロケーション機能を提供するOracle Database(すべてのエディション)の機能です。

Oracle Databaseをリポジトリ作成ユーティリティ(RCU)データベースとして使用する場合は、その同じOracle Databaseを空間データにも使用できます。詳細は、Oracle Business Intelligenceのインストールと構成を参照してください。

- (オプション)Oracle Spatial。Oracle Database Enterprise Editionのオプションで、ハイエンドの地理情報システム(GIS)ソリューションおよびロケーションベース・サービス(LBS)ソリューションをサポートする高度な空間機能を提供します。このオプションは、Locatorオプションでは使用できない高度な空間機能を必要とするマップまたは機能を使用する場合のみ必要になります。その他、Oracle Spatialには、ラスター・データや3Dデータの管理、空間Webサービス、トポロジ、ネットワーク・データ・モデリング、Resource Description Framework(RDF)、およびセマンティクWebなどの機能があります。

- Oracle BI EEデータと空間データをマッピングするメタデータ。Oracle BIプレゼンテーション・カタログのファイル・システムに格納できます。

図は、Oracle BI EEをインストールしたときのマップ・ビューのデフォルトのアーキテクチャを示しています。Oracle Database、またはOracle BI EEがサポートするその他のデータベースにデータを格納できます。マップ・ビューの推奨されるアーキテクチャ図については、MapViewerでのマップ・ビューのサポートの構成を参照してください。

これらが配置されている場合は、「マップの管理」の説明に従い、「Oracle BIプレゼンテーション・サービス管理」ページを使用してマップを管理します。

ハードウェアのサイズ設定およびマップのデプロイメント戦略

マップ・ビューのレンダリングは表ビューのレンダリングよりもコンピュータに負荷がかかります。

マップのレンダリングには次の処理が伴うため、多くのコンピューティング・リソースが必要となります。

- 空間データの問合せ。

- 国や州などの地理エンティティに応じた多角形および図形の作成。

- 多角形および図形の背景マップへの配置。

- エンドユーザー機能の提供。これには、パンやズーム、色しきい値の調整、フォーマットの表示/非表示などの機能が含まれます。

マップ・ビューを使用するユーザー数、マップ・ビューに表示するデータ量、(「都市の境界線のみ」や「番地レベルの詳細」など)表示する空間データの量など、組織で予想されるマップ・ビューの使用範囲を評価します。この評価に基づいて、適切なハードウェアのサイズおよびデプロイメント戦略を決定します。また、Oracle MapViewerのデプロイメントにおいて最適なパフォーマンスおよびスケーラビリティを実現するためのベスト・プラクティスについて、入手可能なドキュメントで確認します。

マップ・ビューで使用するためのサンプル空間データセット

サンプルのMapViewer空間データセットを見つけてセットアップする方法、および完全な空間データセットを取得する方法について学習します。

サンプルの(完全な)空間データセットに関する情報

サンプル空間データセットは、Oracle Business Intelligenceでインストールしたときに、サンプル・アプリケーションに含められます。Oracle Business Intelligence Enterprise EditionサンプルでOTNから入手することもできます。

サンプル空間データセットは、Oracle DatabaseのOBIEE_NAVTEQスキーマのSampleAppイメージに含まれています。OBIEE_NAVTEQスキーマ(obiee_navteq.dmp)のスタンドアロン・エクスポートは、SampleAppアーカイブ・ページ(OBIEE SampleApp Archives)の「OBIEE 11.1.1.3 - Sample Application (Build 825)」の下のNAVTEQ Data Bundle for OBIEEリンクを使用してダウンロードできます。

データ・バンドルをインポートするための手順は、Documentation Downloadsリンクからアクセスできるドキュメントの「Loading MapViewer Content」に含まれています。注意: インポート処理では、Sample Application - Setup Filesリンクから入手できるセットアップ・ファイルのSQLスクリプトが必要となります。

MapViewerのサンプル・データセットには、世界の国境、米国、カナダ、オーストラリアの州、米国の郡、世界の主要都市、米国の高速道路、およびストリート・レベルの詳細データ(サンフランシスコ、ロンドンおよびシドニーのみ(2012年))が含まれています。

サンプルのデータセットの利用条件は、Oracleエンドユーザー利用条件を参照してください。

完全な空間データセットを取得するには、次のURLを使用してNAVTEQにお問合せください。

HERE: Oracle開発者向けマッピング・ソリューション

マップの管理

コンテンツ・デザイナがマップ・ビューを作成できるようにするには、管理者として、事前にレイヤーおよびマップを指定し、メタデータを構成する必要があります。

この項では、次の内容について説明します。

- マップおよびレイヤーの使用

- 管理ページの機能

- 管理ページを使用したマップの管理

- マップ内のレイヤーの翻訳処理

マップおよびレイヤーの使用

マップには、使用する1つ以上のレイヤーを持つことができます。

最初の手順は、マップで使用するレイヤーを選択することです。管理者は、Oracle SpatialのMap Builderツールを使用してレイヤーを構成しています。その後、管理者がOracle SpatialのMap Builderツールを使用して構成したマップのリストから、少なくとも1つのマップを選択します。このマップは、レイヤーが適用される背景になります。オプションで、マップ・フォーマットで使用するイメージを指定できます。この項では、マップおよびレイヤーに関する次の情報を提供します。

- レイヤーと列の関連付け

- マップ上のレイヤーの順序付け

- 再起動を必要とする空間メタデータの変更

レイヤーと列の関連付け

レイヤーおよびマップを選択した後、特定のレイヤーをOracle Business Intelligenceのサブジェクト・エリア・フォルダ内の列に関連付けることができます。

列とレイヤーの関連付けが正しくないと、レイヤーをマップに正しく表示できません。この関連付けにより、マップのレンダリング時に、列値に対する図形定義をデータベースで見つけられるようになります。各列値に対する図形のジオメトリ定義がデータベースに存在している必要があります。特定の列値に対して図形のジオメトリ定義が存在しない場合、その図形がマップに表示されず、ユーザー操作を実行できないことがあります。

図形の参照は列値に基づいており、列対レイヤーのマッピングはロケールまたは言語に依存しません。したがって、レイヤーに関連付けられる空間列自体が、ロケールまたは言語に影響される値を持たないようにする必要があります。この関連付けを確実にするには、次のいずれかを実行します。

- ビジネス・モデリング・レイヤーで、空間列を二重列としてモデリングします(推奨)。

- ロケール間または言語間で変更されない値を持つ特別な空間列を作成します。コンテンツ・デザイナが分析を使用するとき、サブジェクト・エリアでこの特別な列を参照して混乱しないようにする必要があります。

二重列を使用する場合の詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。二重列を使用した場合の利点を次に示します。

- 図形定義ごとにコード値(ディスクリプタID)を提供でき、同時にロケールまたは言語に応じた表示値(ディスクリプタの値)を示すことができます。

- コード値は、参照用のレイヤー・キー値としてのみ渡されます。

- 図形を一意に特定するために、各種列を複雑に結合する必要がなくなります。たとえば、レイヤー・ジオメトリ表に、Londonという名前を含む複数の市があるとします。これらの市を一意に区別するために、US_Kansas_LondonやCanada_Ontario_Londonなど、Country_State_Cityというパターンを使用する場合があります。この方法の問題点は、場合によって、3つの個別列をグループ化し、区切り記号(アンダースコアなど)で結合して、レイヤーに関連付ける必要があることです。この関連付けでは、コンテンツ・デザイナは、単一レイヤーを作成する条件に従い、3つの列(Country、State、City)を選択する必要があります。

BIレイヤーは、複数のサブジェクト・エリアの複数の列に関連付けることができます。レイヤーは少なくとも1つの空間列に関連付ける必要があります。レイヤーの関連付けが失われると、ユーザーがマップされているBI列にドリルダウンしても、マップが更新されないことがあります。機能レイヤーも使用できます。これは、BI列に関連付けられていないレイヤーです。

マップ上のレイヤーの順序付け

マップ・レイヤーの順序付けは非常に重要です。ユーザーがマップを移動するとき(つまり、ドリル操作およびズーム操作を行うとき)、シームレスに操作できるように細心の注意を払う必要があります。

「背景マップの編集」ダイアログで、各レイヤーに最小および最大のズーム範囲を割り当てます。マップ・ズーム・スライダを垂直方向にのみスライドできる場合、最小ズーム・レベルが低いレイヤーはスライダの下に配置されます。ダイアログの「インタラクティブなBIレイヤー」セクションのレイヤー・グリッドが同様のパターンに従っていることを確認してください。これにより、最小ズーム・レベルの低いレイヤーがリストの下に配置されるようになります。次の項目を必ず実行してください。

- ダイアログを閉じる前に、「ソート」アイコンをクリックしてレイヤーをソートします。

- BIレイヤーは、非BIレイヤーより上位の順序にします。非BIレイヤーがBIレイヤーより上位の順序になっていると、マップでは、下位のBIレイヤーの上に非BIレイヤーが表示されるので、BIレイヤーがインタラクティブでなくなります。

レイヤーのズーム範囲がスケールに関係しない場合、レイヤーの順序付けは重要ではありません。レイヤーに一般的な最小ズーム範囲および最大ズーム範囲が設定されている場合、順序付けは非常に重要になります。ドリル操作またはズーム操作時に、重なるレイヤーによって詳細レイヤーが隠されないように注意してください。

複数のレイヤーが表示可能であるため、ズーム・レベル4ではレイヤーの順序は明確ではありません。ダイアログの「インタラクティブなBIレイヤー」セクションで指定されているレイヤー順により、ズーム・レベル4では、マップは下位から上位に、Country、State、Cityの順でレンダリングされます。

ダイアログでレイヤーが正しい順序で表示されない場合は、ダイアログのズーム・グリッドにある「下に移動」ボタンおよび「上に移動」ボタンをクリックするか、「ズーム・レベルによるレイヤーのソート」ボタンをクリックすることでレイヤーの順番を変更できます。

レイヤーの詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

例 12-1 3つのレイヤーが設定された世界地図

3つのレイヤー(Country、StateおよびCity)が設定された世界地図があり、15のズーム・レベルが定義されているとします。Countryレイヤーの最小および最大ズーム範囲は0 - 5、Stateレイヤーの範囲は6 - 10、Cityレイヤーの範囲は11 - 15です。ユーザーがマップで最小ズーム・レベルから最大ズーム・レベルにナビゲートすると、レイヤーがCountry、StateおよびCityの順(表示順)で表示されます。

前述の最初の図は、この例について指定された「インタラクティブなBIレイヤー」セクションを含む「背景マップの編集」ダイアログを示しています。このセクションでは、下から上に向かって、レイヤー順がCountry、StateおよびCityであることを確認できます。

例12-2 共通レベルの設定された世界地図

共通のズーム範囲が設定されたレイヤーを持つ同じ世界地図を考えてみます。前述の2番目の図に示す「背景マップの編集」ダイアログに対応するマップで、ユーザーがレベル4にズームしたとします。3つすべてのレイヤーにズーム・レベル4が設定されていることに注意してください。

再起動を必要とする空間メタデータの変更

管理者は、Oracle Databaseに格納されMapViewerによってアクセスされる空間メタデータを編集できます。

たとえば、新しいレイヤーを追加できます。これらの編集内容は、MapViewerを再起動して最新データで更新するまで、マップを管理するOracle BIサーバーの「管理」ページには表示されません。

管理ページの機能

Oracle BIサーバーの「管理」ページには「マップ・データの管理」リンクがあります。

このリンクをクリックすると、各種物理データ・ソースのデータの論理バージョンおよび表示バージョンを管理できる「マップ・データの管理」ページが表示されます。ここで、コンテンツ・デザイナがマップ・ビューを作成する際に使用するレイヤーを定義します。マップおよびデータを管理するために使用できるデータは、MapViewerの一部としてOracle Databaseに格納されます。

このページでは、次の項目を指定できます。

- 論理名。物理データまたはデータ・ソースの変更に起因して既存のBI列マッピングおよびマップ分析が破損しないようにできます。

- 表示名。地理データをユーザーにわかりやすく表示できます。

管理ページを使用したマップの管理

この項は、Oracle BI Enterprise Editionがインストールされ、Oracle MapViewerが自動的に構成およびデプロイされていることを前提としています。

MapViewerの詳細は、Oracle MapViewerユーザーズ・ガイドを参照してください。

1. Oracle Business Intelligenceにサイン・インします。

「管理へのアクセス」および「マップ・データの管理」の権限が付与されていることを確認してください。

2. グローバル・ヘッダーで「管理」をクリックします。

3. 「マップ・データの管理」リンクをクリックして、「マップ・データの管理」ページを表示します。

4. 「レイヤー」タブをクリックします。

5. 「レイヤーのインポート」ボタンをクリックして、「レイヤーのインポート」ダイアログを表示します。

6. ダイアログで、ズーム操作およびドリル操作に必要な接続およびレイヤーを選択します(このタブには、管理ページでの他の選択は事前移入されません。マップでは任意のレイヤーまたはイメージを使用できます)。

使用するサブジェクト・エリアに適したレイヤーの選択が完了したら、「OK」をクリックします。

7. 「レイヤー」タブに戻ってレイヤーを選択し、「レイヤーの編集」ボタンをクリックして、「レイヤーの編集」ダイアログを表示します。ここで、レイヤーを属性列に関連付けて、マップ・ビューにBIデータを表示できるようにします。

レイヤーの編集が完了したら、「OK」をクリックします。

このタブを使用してレイヤーをBIデータに関連付けます。複数のサブジェクト・エリアでCity列を使用する場合、各サブジェクト・エリアのレイヤーにCity列を関連付ける必要があります。

8. 「背景マップ」タブをクリックし、「背景マップのインポート」ボタンをクリックして、「背景マップのインポート」ダイアログを表示します。

9. ダイアログで、使用する接続およびメイン・マップを選択します。

メイン・マップ用の接続には、レイヤーまたはイメージ用とは異なる接続を選択できます。

メイン・マップの選択が完了したら、「OK」をクリックします。

10. 「背景マップ」タブに戻ってマップを選択し、「背景マップの編集」ボタンをクリックして、「背景マップの編集」ダイアログを表示します。ここで、マップに名前を付け、レイヤーの順序とそれらのズーム・レベルを指定します。

マップの編集が完了したら、「OK」をクリックします。

11. オプションで、「イメージ」タブをクリックし、「イメージのインポート」ボタンをクリックして、「イメージのインポート」ダイアログを表示します。マップでイメージをフォーマットとして使用する場合は、イメージをインポートできます。

12. ダイアログで、使用する接続およびイメージを選択します。

イメージの選択が完了したら、「OK」をクリックします。

13. 「管理」ページでの作業が完了したら、「戻る」をクリックします。変更が自動的に保存されます。

背景マップ、レイヤーおよびズーム・レベルを指定すると、この情報を使用してマップの静的イメージがMapViewerで作成されます。その後、マップ・ビューでコンテンツ・デザイナおよびエンド・ユーザーが使用するためにブラウザでレンダリングするため、そのイメージがMapViewerから送信されます。

マップ内のレイヤーの翻訳処理

MapViewerの機能を使用すると、テーマの機能(Oracle BI EEではマップのレイヤーと呼ばれます)に特定の言語およびロケールを使用してラベルを付けることができます。

マップに対してこれらの翻訳済ラベルを構成するには、Oracle MapViewerユーザーズ・ガイドに記載されている情報を参照してください。

13 タイムゾーンの構成

この章では、Oracle Business Intelligenceのタイムゾーンを構成する方法について説明します。

この章の内容は次のとおりです。

- タイムゾーンが使用される理由および場所

- タイムゾーンの設定

- タイムゾーンの優先順位

- タイムゾーン指定の格納場所

- タイムゾーン設定の説明

- 例: タイムゾーンを指定する構成ファイルの設定

タイムゾーンが使用される理由および場所

タイムゾーンはOracle Business Intelligence全体で様々な目的に使用されます。

タイムスタンプはオブジェクトが変更されたタイミングを示し、ユーザーはエージェントを実行する時間を指定できます。ほとんどの場合、ユーザーは、それぞれのローカル・タイムゾーンで操作することを望みます。管理者は、様々なコンポーネントに対してユーザーの優先タイムゾーンを構成できます。

優先タイムゾーンの設定を開始する前に、次の表を参照して、タイムゾーンが使用される場所について確認してください。

タイプ

説明

Oracle BIサーバー

プレゼンテーション・サービスのゾーンとは異なるタイムゾーンのユーザーがいる場合、管理者は、それらのユーザーがOracle Business Intelligenceで表示するタイムスタンプを指定できます。たとえば、サーバーのタイムゾーンが米国の太平洋標準時であるとします。その場合、米国東海岸のユーザーには東部標準時でタイムスタンプが表示されるように指定できます。

タイムゾーン設定を行わず、ユーザーが「マイ・アカウント」ダイアログで優先タイムゾーンを指定していない場合、ユーザーには、プレゼンテーション・サービスのローカル・タイムゾーンに従った時間が表示されます。

優先タイムゾーンの指定方法の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

データベースのデータ

管理者が、データベースから取得されるデータのタイムゾーンを指定します。

タイムゾーン設定を行わない場合、ユーザーには、管理者が設定した元のデータのタイムゾーンでタイムスタンプ・データが表示されます。

Oracle Business Intelligenceで表示されるコンテンツ

分析を作成するユーザーは、分析プロンプトおよびダッシュボード・プロンプトに表示されるタイムゾーンを指定できます。この指定は、管理者による指定や、以前の問合せで対象列を使用してタイムゾーンを設定したエンド・ユーザーの指定よりも優先されます。

指定した表示タイムゾーンが夏時間をサポートする場合、表示されるタイムゾーン値は、夏時間に合せて自動的に調整されます。

イベントの発生時刻を示す一般的なタイムスタンプ

エンド・ユーザーは、次を含む多くの一般的なスタンプのタイムゾーンを指定できます。

- エージェントのスケジュール時刻

- アラートまたは分析が生成された時刻

- Oracle BIプレゼンテーション・カタログでオブジェクトが作成、変更またはアクセスされた時刻

ログ・ファイル

ログ・ファイルには各種アクティビティのタイムスタンプが含まれます。

タイムゾーンの設定

ユーザーのタイムゾーンの選択は、すべてのユーザーで一貫性があるタイムゾーンでオーバーライドできます。

ユーザーのタイムゾーンを設定するには、次の手順を使用します。

1. プレゼンテーション・サービスを実行するサーバーに設定されているタイムゾーンを確認します。

2. プレゼンテーション・サービスの構成ファイル(instanceconfig.xml)の要素またはセッション変数を使用します。
instanceconfig.xmlファイルはBI_DOMAIN/config/fmwconfig/biconfig/OBIPSにあります。

次を参照してください。

- タイムゾーンの優先順位の詳細は、 タイムゾーンの優先順位を参照してください。

- セッション変数および要素の詳細は、 タイムゾーン設定の説明を参照してください。

- 例: タイムゾーンを指定する構成ファイルの設定を参照してください。

- セッション変数の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

3. エンド・ユーザーに「マイ・アカウント」ダイアログを使用して優先タイムゾーンを指定するように指示します。

4. 分析を作成するユーザーに、次の手順を実行して分析のタイム・スタンプを設定するように指示します。

a. 「列のプロパティ」ダイアログの「データ書式」タブを使用して、分析の列に表示されるタイムゾーンを指定します。

b. 「タイム・ゾーン」ダイアログを使用して、ダッシュボード・プロンプトに表示されるタイムゾーンを設定します。

タイムゾーンの優先順位

タイムゾーンは特定の順序で表示されます。

各種コンテンツの表示で使用される実際のタイムゾーンは、次の表に示す優先順位に従います。小さい番号の項目によって、大きい番号の項目がオーバーライドされます。たとえば、項目1は項目2よりも優先されます。

タイムゾーンの対象

優先順位

データ

1. DATA_TZセッション変数の設定

2. instanceconfig.xmlファイルのDefaultDataOffset要素の設定

3. 管理者が設定した元のデータのタイムゾーン(プレゼンテーション・サービスのタイムゾーンが不明であるため)

データの表示

1. コンテンツ・デザイナの設定

2. DATA_DISPLAY_TZセッション変数の設定

3. instanceconfig.xmlファイルのDefaultDataDisplay要素の設定

4. ユーザー優先タイムゾーン

一般的なタイム・スタンプ(列データおよびログ・ファイルは含まれません)

1. ユーザー優先タイムゾーン

2. Oracle BIプレゼンテーション・サービスのタイムゾーン

ログ・ファイルの情報

1. instanceconfig.xmlファイルのLogging要素の設定

2. プレゼンテーション・サービスのタイムゾーン

ユーザー優先タイムゾーン

ユーザーはインタフェースに表示されるタイムゾーンを選択できます。

ユーザー優先タイムゾーンは、次により決定されます。

- 「マイ・アカウント」ダイアログでのユーザーの指定ユーザーは、コンテンツを参照するタイムゾーンを選択します。
「マイ・アカウント」ダイアログの「プリファレンス」タブでの優先タイムゾーンの設定の詳細は、『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』を参照してください。

- TIMEZONEセッション変数の設定

- instanceconfig.xmlファイルのDefaultUserPreferred要素の設定

タイムゾーン指定の格納場所

タイムゾーンの指定は独自のファイルに格納されます。

タイムゾーン指定がリストに表示される場合、またはセッション変数の値やinstanceconfig.xmlファイルの要素として表示される場合、その指定は常に次のTimeZones.xmlファイルに基づいています。

orahome/bi/bifoundation/timezone

TimeZones.xmlファイルには、世界中のほとんどすべてのタイムゾーンが含まれています。このファイルにゾーンを追加する必要はありませんが、必要に応じて編集できます。組織内のユーザーが使用しないタイムゾーンは削除できます。

タイムゾーン値の指定

各種エディタでは、タイムゾーン値に含まれるアンパサンドは、アンパサンド文字自体を使用するか、そのエスケープ・シーケンスを使用することで表示されます。タイムゾーン値を入力する場合は、次の指示に従って注意して入力してください。

- セッション変数の値でアンパサンドを使用する場合は、「Pacific Time (US & Canada); Tijuana」のように、アンパサンド文字(&)を値に含めます。

- Oracle BIプレゼンテーション・サービスの構成ファイル(instanceconfig.xml)の要素の値でアンパサンドを使用する場合、「Pacific Time (US &amp; Canada); Tijuana」のように、アンパサンドのエスケープ・シーケンスを値に含めます。

タイムゾーン設定の説明

次の表は、タイムゾーンの設定に使用するセッション変数およびinstanceconfig.xmlファイルの要素について説明しています。

instanceconfig.xmlファイルに要素を含める場合は、すべてのユーザーに表示するタイムゾーンを指定します。セッション変数を使用する場合は、ユーザーごとに異なるタイムゾーンを指定できます。セッション変数を使用し、かつinstanceconfig.xmlファイルの要素に値を指定すると、セッション変数の値がinstanceconfig.xmlファイルの設定よりも優先されます。

注意:

特定のシステム・セッション変数(USER、ROLESなど)をリクエスト変数でオーバーライドすることはできません。DATA_TZ、DATA_DISPLAY_TZ (タイムゾーン)などのその他のシステム・セッション変数は、Oracle BI管理ツールで構成されている場合、オーバーライドできます。

『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のリポジトリ変数の操作に関する項を参照してください。

要素

セッション変数

説明

値

DefaultDataOffset

DATA_TZ

元のデータのタイムゾーン・オフセット。適切なゾーンを表示するためにタイムゾーンを変換できるようにするには、この要素または変数に値を設定する必要があります。

このオプションを設定しない場合は、値が不明であるため、タイムゾーンの変換は実行されません。

たとえば、東部標準時(EST)に変換する必要があるとします。これは「グリニッジ標準時(GMT) - 5」になります。ESTへの変換を有効にするには、この値を指定する必要があります。

GMT時から減算する時間数を示すオフセット。例:

GMT-05:00または-300。これは5時間減算することを示します。

DefaultDataDisplay

DATA_DISPLAY_TZ

データの表示に使用するタイムゾーンを指定します。

このオプションを設定しない場合、値はユーザー優先タイムゾーンになります。

TimeZones.xmlファイルで指定されているタイムゾーンのいずれか。

「タイムゾーン値の指定」を参照してください。

DefaultUserPreferred

TIMEZONE

ユーザーが「マイ・アカウント」ダイアログで独自のタイムゾーンを選択する前の、ユーザーのデフォルト優先タイムゾーンを指定します。

このオプションを設定しない場合、値はOracle BIプレゼンテーション・サービスのローカル・タイムゾーンになります。

TimeZones.xmlファイルで指定されているタイムゾーンのいずれか。

「タイムゾーン値の指定」を参照してください。

ロギング

該当なし

プレゼンテーション・サービスで生成されるログ・ファイルに表示されるタイム・スタンプのタイムゾーン。

このオプションを設定しない場合、値はプレゼンテーション・サービスのローカルタイムゾーンになります。

TimeZones.xmlファイルで指定されているタイムゾーンのいずれか。

「タイムゾーン値の指定」を参照してください。

TimeZone

該当なし

優先タイムゾーンを変更する要素の親要素。ServerInstance要素の子になります。

該当なし

例: タイムゾーンを指定する構成ファイルの設定

次の例は、TimeZone要素が追加された、instanceconfig.xmlファイルのサンプル・セクションを示しています。

<TimeZone>
<DefaultDataOffset>0</DefaultDataOffset>
<Logging>(GMT-08:00) Pacific Time (US &amp; Canada); Tijuana</Logging>
<DefaultUserPreferred>(GMT-08:00) Pacific Time (US &amp; Canada); Tijuana</DefaultUserPreferred>
<DefaultDataDisplay>(GMT-06:00) Central Time (US &amp; Canada); Tijuana</DefaultDataDisplay>

</TimeZone>

14 Oracle Business Intelligenceのローカライズ

この章では、英語以外の1つ以上の言語環境にデプロイするようにOracle Business Intelligenceを構成する方法について説明します。ユーザーは言語およびロケールのプリファレンスを簡単かつ動的に変更できます。ユーザーが言語を選択すると、その言語で多くの要素が表示されます。これらの要素には、ユーザー・インタフェース・コンポーネント、メタデータ、メッセージおよびヘルプ・ファイルが含まれます。

この章の内容は次のとおりです。

- ローカライズとは

- Oracle BIプレゼンテーション・サービスのローカライズ

- Catalog Managerでの現在のロケールの設定

- Oracle BI Serverでの現在のロケールの設定

- リポジトリでのメタデータ名のローカライズ

- 多言語データのサポート

ローカライズとは

ローカライズとは、Oracle Business Intelligenceのデプロイメントを特定の言語に対応させるプロセスを指します。

ユーザーが英語以外の言語を話す場合は、ローカライズに関する情報を使用して、複数言語をサポートするようにデプロイメントを構成します。

サポートされる言語の詳細は、「システム要件と動作保証」を参照してください。

翻訳対象コンポーネント

インタフェースのいくつかの領域は、ユーザーのネイティブ言語に翻訳されています。

英語以外の言語に翻訳されているOracle Business Intelligenceのコンポーネントを次に示します。

- インストーラ

- Webユーザー・インタフェース

- Oracle BIスケジューラのジョブ・マネージャ・インタフェース

- カタログ・マネージャ

- Oracle BIプレゼンテーション・サービスのメッセージ:

- エラー

- 警告

- 情報

- Oracle BIサーバーの関数:

- DayName

- MonthName

注意:
DayName関数またはMonthName関数を使用して問合せを発行しても、その関数がバックエンド・データベースに転送されない場合、日または月の名前はローカライズされた言語で戻されますが、列名は英語のままになります(または他のローカライズ制御の影響を受ける場合があります)。この例として、LOCALEパラメータがGermanに設定されている場合のMonthName問合せでは、文字列Maiが戻されますが、列ヘッダーはName of Monthのままです。

- Oracle BIサーバーおよびOracle BIスケジューラのメッセージ:

- エラー

- 警告

- 情報

- ログ・ファイル:

- Oracle BIサーバーのnqserver.log

- Oracle BIサーバーのnqquery.log

- Oracle BIサーバー・クラスタのnQCluster.log (クラスタリングが有効な場合)

- メタデータ:

- ダッシュボードおよび分析(Oracle BIプレゼンテーション・カタログ)

- プレゼンテーションの表および列の名前(.rpdファイル)

- Oracle BI管理ツールのインタフェース

- ODBCの設定

次のリストは、ローカライズされていないOracle Business Intelligenceのコンポーネントを示しています。

- ODBCクライアント・ツール:

- nqcmd (UNIX)

- nqcmd.exe (Windows)

- nqclient.exe (Windows)

Oracle WebLogic Server管理コンソールやFusion Middleware Controlなど、数多くのOracle Fusion Middlewareコンポーネントが翻訳されています。詳細は、Oracle Fusion Middlewareのドキュメントを参照してください。

Oracle Business Intelligenceコンポーネントをローカライズするためのタスク

各国語で使用できるようにシステム・コンポーネントをローカライズするには、いくつかの手順が必要となります。

次の各項の説明に従い、管理者として、Oracle Business Intelligenceのコンポーネントをローカライズするための各種タスクを実行します。

- Oracle BIプレゼンテーション・サービスのローカライズ

- Oracle BI Serverでの現在のロケールの設定

- リポジトリでのメタデータ名のローカライズ

- 多言語データのサポート

Oracle BIプレゼンテーション・サービスのローカライズ

管理者として、Oracle BIプレゼンテーション・サービスをローカライズするための各種タスクを実行します。

次のトピックがあります。

- Oracle BIプレゼンテーション・サービスのユーザー・インタフェースのローカライズ

- Oracle BI Presentation Catalogのキャプションのローカライズ

- Mozilla Firefoxブラウザでのアラビア語およびヘブライ語に関するヒント

Oracle BIプレゼンテーション・サービスのユーザー・インタフェースのローカライズ

ユーザーが英語以外の言語を使用する場合は、Oracle BIプレゼンテーション・サービスのユーザー・インタフェースをローカライズできます。

ユーザーは、Oracle BI EEのサインイン・ページで言語を選択できます。これにより、ユーザー・インタフェースの多くの要素が適切な言語で自動的に表示されます。サイン・イン後、ユーザーは、「マイ・アカウント」ダイアログの「プリファレンス」タブで言語設定を変更できます。

ユーザーの設定はWEBLANGUAGEセッション変数に保存されます。Oracle BIプレゼンテーション・サービスのユーザー・インタフェースでは、ユーザーがサインイン・ページで言語を選択したときにWEBLANGUAGEが設定されます。

注意:

Oracle BIアプリケーションでは、ユーザーの初回ログイン時にWEBLANGUAGEがブラウザの言語に設定されます。たとえば、言語がフランス語に設定されているブラウザを使用してOracle BIアプリケーションに初めてログインすると、WEBLANGUAGEの値はFrenchになり、メタデータはフランス語に翻訳されます。

次の各項の説明に従い、管理者として、Oracle BIプレゼンテーション・サービスのユーザー・インタフェースの他の要素をローカライズするための各種タスクを実行します。

- プレゼンテーション・サービスをローカライズするためのディレクトリ構造の理解

- ユーザーの優先通貨のメッセージのローカライズ

- サインイン・ページのデフォルト言語の指定

- サインイン・ページの言語およびロケールの構成

- URLでの言語の指定

プレゼンテーション・サービスをローカライズするためのディレクトリ構造の理解

Oracle BI EEは、ユーザー・インタフェースの各要素およびメッセージを制御する多くのファイルとともにインストールされます。

これらのファイルは、ORACLE_HOME/bi/bifoundation/web/msgdbディレクトリのmessagesサブディレクトリおよびpagesサブディレクトリにインストールされます。これらの要素およびメッセージをローカライズするには、それらのファイルをSDD/service_instances/service1/metadata/content/msgdb/l_xxのl_xxサブディレクトリにコピーします。

SDDはシングルトン・データ・ディレクトリで、_xxは言語拡張子を示します。「Oracle Business Intelligenceの主なディレクトリ」を参照してください。ファイルをコピーしたら、コピー先のサブディレクトリに対応する言語に合せてコンテンツを変更できます。

ユーザーの優先通貨のメッセージのローカライズ

優先通貨に関連付けられたメッセージをローカライズできます。

ユーザーの優先通貨の使用の詳細は、「静的マッピングを使用したユーザーの優先通貨オプションの定義」を参照してください。

1. SDD/service_instances/service1/metadata/content/msgdb/l_xxディレクトリに移動します。xxは、優先通貨を指定する言語の言語拡張子です。

SDDはシングルトン・データ・ディレクトリ(DOMAIN_HOME/bidataなど)です。「Oracle Business Intelligenceの主なディレクトリ」を参照してください。

2. このディレクトリで、custommessagesという名前のサブディレクトリを作成します。

3. このディレクトリで、usercurrencymessages.xmlという名前のXML形式のファイルを作成します。

4. 作業しているディレクトリに対応する言語用のこのファイルに、次のようなエントリを追加します。次の例には、kmsgMyCurrency1およびkmsgMyCurrency2という2つのメッセージが含まれています。

<?xml version="1.0" encoding="utf-8"?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web/message/v1">
<WebMessageTable system="CurrencyDisplay" table="Messages" code="false">
<WebMessage name="kmsgMyCurrency1"><TEXT>My Currency Text 1</TEXT></WebMessage>
<WebMessage name="kmsgMyCurrency2"><TEXT>My Currency Text 2</TEXT></WebMessage>
</WebMessageTable>
</WebMessageTables>

5. このメッセージを使用するために、ファイルを編集してdisplayMessage="kmsgMyCurrency1"と指定します。

6. これらのメッセージをローカライズする各言語に対して、ステップ1 - 5を繰り返します。

7. Oracle BIプレゼンテーション・サービスのサービスを再起動します。

Oracle BI EEで、適切にローカライズされたテキストがユーザーに表示されます。この例では、表示されるテキストはMy Currency Text 1です。

サインイン・ページのデフォルト言語の指定

ユーザーに表示される言語を変更するには、ユーザーのブラウザに指定されている言語をオーバーライドします。

プレゼンテーション・サービスのサインイン・ページの表示に使用されるデフォルト言語は、ユーザーのクライアント・ブラウザの設定から取得されます。次の手順は、この言語を変更する方法について説明しています。

注意:
次の手順では、例としてInternet Explorer 7.0を使用しています。別のブラウザを使用する場合は、必要に応じて内容を置き換えてください。

1. Internet Explorerで、「ツール」メニューから「インターネット オプション」を選択します。

「インターネット オプション」ダイアログが表示されます。

2. 「言語」をクリックします。

「言語の優先順位」ダイアログが表示されます。

インストールされている言語が「言語」リストに表示されます。リストの最上部にある言語がデフォルト言語として使用されます。

3. 目的の言語がブラウザにインストールされていない場合は追加します。

4. 「上へ」ボタンおよび「下へ」ボタンを使用して、目的の言語をリストの最上部に移動します。

5. ブラウザを再起動し、プレゼンテーション・サービスにサインインします。

デフォルト言語は通常、ブラウザの言語リストの言語と一致します。

注意:
ユーザーがサインイン・ページのリストからデフォルト言語を選択しない場合は、ユーザーの「マイ・アカウント」ダイアログの「ユーザー・インタフェース言語」の設定によってユーザー・インタフェースの表示に使用される言語が決定されます。

サインイン・ページの言語およびロケールの構成

サインイン・ページでユーザーが使用できる言語およびロケールを構成できます。

この機能は、ユーザーがアクセスできる言語およびロケールの数を制限する場合に便利です。instanceconfig.xmlファイルのAllowedLanguages要素およびAllowedLocales要素によって、使用できる言語およびロケールを指定します。

開始前に構成ファイル内の情報を理解しているか確認します。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. ServerInstanceセクションを見つけます。ここで、次の要素を追加する必要があります。

- AllowedLanguages - 選択できる言語を、カンマ区切りリストとして指定します。次の識別子(ISO 639言語コード)のリストを指定できます。
ar es da de el en es fi fr he hr hu it ja ko nl no pl pt pt-BR ro ru sk sv th tr zh-CN zh-TW

- AllowedLocales - 選択できるロケールを、カンマ区切りリストとして指定します。ORACLE_HOME/bi/bifoundation/web/displayディレクトリにあるlocaledefinitions.xmlファイル内の任意の定義を指定できます。ロケールは、ISO 639言語コードの後ろにISO 3166国コードを記述して指定します(たとえば、fr-fr、fr-ca)。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Localization>
<AllowedLanguages>en,fr,pt-BR</AllowedLanguages>
<AllowedLocales>en-ca,en-us</AllowedLocales>
</Localization>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

パフォーマンス・タイルの数字のスケーリングの指定

プレゼンテーション・サービスでは、パフォーマンス・タイルを使用して、上位レベルの集計データの1つに関心を集めることができます。

タイルには、1,000,000のような数字を含めることも、たとえば1Mのように、インジケータを使用した値の「圧縮」または「スケーリング」を指定することもできます。

数字をスケーリングするために、プレゼンテーション・サービスでは現在のロケールで使用可能なスケール変更係数を検索して、数字を処理し、そのインジケータの値を追加します。現在のロケールでスケール変更係数が定義されていない場合、スケーリングは適用されません。数字のスケーリングは言語によって異なるため、次の手順の説明に従って、localedefinitions.xmlファイルを手動で編集してスケーリングを制御できます。

1. テキスト・エディタで、次のディレクトリ内のlocaledefinitions.xmlファイルを開きます。

ORACLE_HOME/bi/bifoundation/web/display

2. このファイルに、新規プロパティ「scaleFactors」を追加し、ロケールに適した値を入力します。

次に、英語ロケールの値を示します。

<localeDefinition name="en">
<!-- existing data -->
<property name="scaleFactors">
<property name="thousand">K</property>
<property name="million">M</property>
<property name="billion">B</property>
<property name="trillion">T</property>
<property name="quadrillion">Q</property>
<property name="quintillion">Qu</property>
<property name="sextillion">S</property>
<property name="septillion">Sp</property>
<property name="octillion">O</property>
<property name="nonillion">N</property>
<property name="decillion">D</property>
<property name="undecillion">UD</property>
<property name="duodecillion">DD</property>
</property>
</localeDefinition>

次に、インド・ロケールの値を示します。

<localeDefinition name="en-in" basedOn="en">
<!-- english - india -->
<!-- existing data -->
<property name="scaleFactors">
<property name="thousand">K</property>
<property name="hundred-thousand">L</property>
<property name="ten-million">Cr</property>
</property>
</localeDefinition>

3. 変更内容を保存し、ファイルを閉じます。

4. プレゼンテーション・サービスを再起動します。

『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のパフォーマンス・タイル・ビューの編集に関する項を参照してください。

URLでの言語の指定

ユーザーは、サインイン・ページを表示してOracle BI EEを起動するとき、サインイン・プロセスの一部として言語を選択できます。

ユーザーは「マイ・アカウント」ダイアログの「プリファレンス」タブで言語を選択することもできます。

ダッシュボードまたはアプリケーションの他のページを表示するURLをユーザーに提供する場合、URLパラメータをプロファイル属性として定義できます。これにより、アプリケーションの言語設定と一致するように、ダッシュボードおよび分析の言語が動的に設定されます。

運用アプリケーションでは、シンボリックURLによって統合環境内のダッシュボードおよび分析が組み込まれます。Oracle BIプレゼンテーション・サービスの場合、URLパラメータLangによってWebページのレンダリングで使用される言語が指定されます。

Langパラメータは、Oracle Business Intelligenceに接続する運用アプリケーションで定義されたシンボリックURLに含めることができます。Langパラメータはプロファイル属性として定義されますが、シンボリックURLが実行時に作成される場合は、プロファイル属性のLanguageCodeが値として設定されます。次の表に、Langを含む、シンボリックURLパラメータ・アプレットのパラメータ設定の例を示します。

たとえば次のURLでは、サインイン・ページがフランス語で表示されます。

http://Server_Name:port_number/analytics/saw.dll?Dashboard&Lang=fr

名前

タイプ

Path引数の値

追加

シーケンス番号

Cmd

定数

Go

Y

1

Path

定数

/shared/Sales/Pipeline/Overview/Top 10 Deals

Y

2

nQUser

コマンド

UseLoginId

Y

3

nQPassword

コマンド

UseLoginPassword

Y

4

PostRequest

コマンド

PostRequest

Y

5

Lang

プロファイル属性

LanguageCode

Y

6

Oracle BIプレゼンテーション・カタログのキャプションのローカライズ

Oracle BIプレゼンテーション・カタログには、分析およびダッシュボードなど、ユーザーが作成するオブジェクトが格納されます。これらのオブジェクトの名前および説明はテキスト文字列に保持されます。

オブジェクトのテキスト文字列をローカライズする必要がある場合は、翻訳するために、カタログからテキスト文字列をエクスポートします。その後、文字列を翻訳して公開します。

この項では、キャプションをローカライズする手順について説明します。

- ステップ1: エクスポート・プロセスについて

- ステップ2: カタログ内のテキスト文字列のエクスポート

- ステップ3: XMLファイル内のエクスポートされた文字列の編集

- ステップ4: 重複するエクスポートされたテキスト文字列の処理

- ステップ5: カタログでのテキスト文字列の公開

ステップ1: エクスポート・プロセスについて

エクスポート・プロセスでは、順番に行う必要がある一連の手順が必要となります。

エクスポート・プロセスでは、共有フォルダ内の第1レベルのサブフォルダそれぞれに対してXMLファイルが1つ作成されます。このファイル名の形式はfoldername captions.xmlで、foldernameは共有フォルダ内のサブフォルダの名前を表します。各XMLファイルには、対応する第1レベル・フォルダおよびそのサブフォルダ内にあるすべてのコンテンツのテキスト文字列が含まれます。

たとえば、プレゼンテーション・カタログの共有フォルダにMarketing、ServiceおよびSalesという第1レベル・フォルダが含まれている場合は、エクスポート・プロセスによって次の3つのXMLファイルが作成されます。

- marketingcaptions.xml

- salescaptions.xml

- servicecaptions.xml

コンテンツを翻訳した後、これらのフォルダを次のディレクトリ内の対応する場所に配置します。

SDD/service_instances/service1/metadata/content/msgdb/l_xx/captions

SDDはDOMAIN_HOME/bidataなどのシングルトン・データ・ディレクトリです(「Oracle Business Intelligenceの主なディレクトリ」を参照)。

エクスポート・プロセスでは、新しいXMLファイルが生成されるだけでなく、カタログが変更され、各オブジェクトの適切なメッセージIDが挿入されます。プレゼンテーション・サービスでは、これらのメッセージIDによって新しい翻訳済テキストが特定されます。

補助(拡張Unicode)文字を含む名前を持つフォルダをエクスポートする場合、エラーが発生する可能性があることに注意してください。

ステップ2: カタログ内のテキスト文字列のエクスポート

次の手順は、カタログ内のテキスト文字列をエクスポートする方法について説明しています。

1. エクスポートする前に、カタログをバックアップします。

エクスポート・ユーティリティは、カタログのコピーではなく、実際のカタログに対して実行する必要があります。これは、エクスポート・ユーティリティにより、実行対象のカタログ内のオブジェクトのプロパティが変更されるためです。

2. Catalog Managerで、カタログをオフライン・モードで開きます。これは、オンライン・モードでは、すべてのオブジェクトを変更するための権限がない可能性があるためです。

3. エクスポートする文字列を含むフォルダを選択します。ユーティリティは、対象フォルダ内、およびそのすべてのサブフォルダ内のファイルに対して実行されます。

たとえば、次の図に示す分析のタイトル(Another Report)をエクスポートして翻訳できます。

4. 「ツール」メニューから「キャプションのエクスポート」を選択します。

5. 「参照」をクリックして、出力ファイルを書き込む場所を選択し、「OK」をクリックします。

6. 新しいテキスト文字列と前回のエクスポート以降に変更されたテキスト文字列のみをエクスポートするには、「新規または変更済の文字列のみエクスポート」を選択します。

7. エクスポートから説明プロパティを除外するには、「説明の除外」を選択します。

8. 「OK」をクリックします。

エクスポート・プロセスは数分かかる場合があります。

ステップ3: XMLファイル内のエクスポートされた文字列の編集

エクスポート・プロセスが完了したら、出力XMLファイルをローカライズ・チームに配信します。

XMLファイルを編集する場合は、XMLファイル用に設計されたエディタを使用します。XMLファイルの上部に指定されているエンコーディングに従うこと、および必要に応じて特殊文字をエスケープすることに注意してください。管理者およびローカライズ・チームのスタッフが、翻訳済テキスト文字列に関するエラーを解決する責任者です。オブジェクトが追加、削除または変更された場合は、常に、カタログのコンテンツが最新であることを確認します。

翻訳対象言語ごとに、すべての出力ファイルのコピーを作成できます。

最初の図は、エクスポートされたキャプションXMLファイルの翻訳前の抜粋です。ファイル名はmyfoldercaptions.xmlです。2番目の図は翻訳後のファイルからの抜粋です。ファイル名はmyfoldercaptions_fr.xmlです。

ステップ4: 重複するエクスポートされたテキスト文字列の処理

カタログからエクスポートしたテキスト文字列が重複する問題が発生することがあります。

カタログからエクスポートされたテキスト文字列の重複は、複数のユーザーが「キャプションのエクスポート」ユーティリティを同時に実行した場合、または同じユーザーが1分以内にこのユーティリティを2回実行した場合に発生します。次の手順は、重複するキャプションに対処する方法について説明しています。

「キャプションのエクスポート」ユーティリティは、「ステップ2: カタログ内のテキスト文字列のエクスポート」を参照してください。

1. 「キャプションのエクスポート」ユーティリティを実行します。

2. Catalog Managerで、カタログをオフライン・モードで開いたまま、エクスポートする文字列を含むフォルダを選択します。

3. 「ツール」メニューから「キャプションのエクスポート」を選択します。

4. 「参照」をクリックして、出力ファイルを書き込む場所を選択し、「OK」をクリックします。

5. 「重複するキャプションの処理方法」セクションで、次のいずれかのオプションを選択します。

- 同一文字列にも一意のIDを作成します - カタログ内である文字列が何度も重複する場合でも、文字列のインスタンスごとに一意のIDを作成するように指定します。たとえば、カタログに「Hello」という文字列が1000個含まれているとします。このオプションを使用すると、一意のIDを1つ生成し、その文字列を1回のみ翻訳するのではなく、1000個の一意のIDを生成し、その文字列を1000回翻訳するように指定できます。

- いいえ、すべての同一文字列に同じIDを使用します - 文字列にIDを作成し、その同じIDをその文字列のすべてのインスタンスに使用するように指定します。たとえば、カタログに「Hello」という文字列が1000個含まれているとします。このオプションを使用すると、1000個の一意のIDを生成し、その文字列を1000回翻訳するのではなく、一意のIDを1つ生成し、その文字列を1回のみ翻訳するように指定できます。

6. 「OK」をクリックします。

重複するキャプションを含む、次のwebmessages.xmlファイルを考えてみます。

<WebMessageTable system="catalog" type="folder" path="/shared/example/A">
<WebMessage name="kcap12790830_5" use="Caption" status="new">
<TEXT>A Really Good Report</TEXT>
</WebMessage>
</WebMessageTable>
<WebMessageTable system="catalog" type="folder" path="/shared/example/B">
<WebMessage name="kcap12790830_5" use="Caption" status="new">
<TEXT>I like this report</TEXT>
</WebMessage>
</WebMessageTable>
<WebMessageTable system="catalog" type="folder" path="/shared/example/Copy of A">
<WebMessage name="kcap12790830_5" use="Caption" status="new">
<TEXT>A Really Good Report</TEXT>
</WebMessage>
</WebMessageTable>

このサンプル・ファイルでは、重複する無効なメッセージIDがオブジェクトBに含まれています。オブジェクトCopy of Aには、有効であるものの、重複するメッセージIDが含まれています。「キャプションのエクスポート」ダイアログで、次のいずれかを選択できます。

- 「1つ残す」を選択すると、ファイルのコンテンツは変更されません。

- 「IDの削除」を選択すると、オブジェクトBおよびオブジェクトCopy of Aの両方に対して新しい一意のIDが生成されます。

- 「テキストの削除」を選択すると、オブジェクトBに対して新しい一意のIDが生成され、オブジェクトCopy of AのWebMessage要素が削除されます。このオプションにより、通常、翻訳するメッセージは少なくなりますが、プレゼンテーション・サービスおよびCatalog Managerのカタログのディレクトリ・リストで、同じ名前を持つ2つのオブジェクトが表示されることに注意してください。

ステップ5: カタログでのテキスト文字列の公開

カタログのテキスト文字列をエクスポートしたら、それをユーザーに公開する必要があります。

1. 翻訳済のXMLファイルを次のディレクトリ内の対応する場所に配置して、プレゼンテーション・サービスを再起動します。

SDD/service_instances/service1/metadata/content/msgdb/l_xx/captions

SDDはシングルトン・データ・ディレクトリで、xxは言語拡張子を示します。

例:

DOMAIN_HOME/bidata/service_instances/service1/metadata/content/msgdb/l_en/captions/myfoldercaptions_fr.xml

言語拡張子には、チェコ語を表すcs、ドイツ語を表すdeなどがあります。

注意:

Oracle Business Intelligence Applicationsがインストールされている場合のみ、SDD/service_instances/service1/metadata/content/msgdb/l_xx/captionsディレクトリが存在します。このディレクトリが存在しない場合は作成する必要があります。

SDDは、DOMAIN_HOME/bidataなどのシングルトン・データ・ディレクトリです。

2. エクスポート・プロセスでは、新しいXMLファイルが生成されるだけでなく、カタログが変更され、各オブジェクトの適切なメッセージIDが挿入されます。ステップ1の指示に従って翻訳済のXMLファイルをディレクトリに配置したら、変更済のカタログを、そのデフォルトの場所に配置するか、システムが現在使用している適切な場所に配置します。詳細は、「Oracle Business Intelligenceの主なディレクトリ」を参照してください。

3. Oracle Business Intelligenceにサインインして、フランス語など、適切な言語を選択します。

4. 翻訳済のコンテンツを表示します。

たとえば、次の図に示すように、分析の翻訳済のタイトルを表示します。

翻訳済のキャプションを開発環境から本番環境に移動するには:

- キャプション・ファイルの処理:

- キャプション・ファイルが本番環境に存在しない場合は、開発環境から本番環境へ単純にファイルをコピーします。

- キャプション・ファイルが本番環境に存在する場合は、最初に既存ファイルのバックアップ・コピーを作成します。次に、テキスト・エディタまたはXML編集ツールを使用して本番環境のキャプション・ファイルを開き、開発環境で行った変更を手動で(十分に注意しながら)挿入します。

Mozilla Firefoxブラウザでのアラビア語およびヘブライ語に関するヒント

Mozilla Firefoxブラウザでは、右から左に記述される言語の表示が若干異なります。

デフォルトでは、スクロール・バーはMozilla Firefoxブラウザの右側に表示されます。アラビア語またはヘブライ語を使用する場合、右側にスクロール・バーが表示されるのは適切ではありません。スクロール・バーが左側に表示されるように、Firefoxでブラウザ設定を変更できます。

layout.scrollbar.side設定の変更の詳細は、Firefoxのドキュメントを参照してください。

Catalog Managerでの現在のロケールの設定

Catalog Managerを使用する場合、そのユーザー・インタフェース要素に使用するロケール、およびカタログ内のオブジェクトに使用するロケールを指定できます。

カタログ・マネージャのロケールは同じロケールにするか、別のロケールにできます。ユーザー・インタフェース要素には10のロケールを使用でき、特定アプリケーションのカタログ・コンテンツには28のロケールを使用できます。

Catalog Managerのユーザー・インタフェース要素(ダイアログ、メニューなど)は、使用可能な10のロケールのいずれかで表示できます。データ処理などのCatalog Managerの特定の領域は、現時点では翻訳またはローカライズされていません。Catalog Managerでは、次のプロセスで、表示するロケールが決定されます。

1. Catalog Managerが起動されたら、-nl <locale>パラメータの設定をチェックします。このパラメータは、次の例に示すように、runcat.cmdまたはruncat.shファイルのCATMAN_VMARGS変数の一部としてユーザーが設定します。

set CATMAN_VMARGS=-nl fr -vmargs -Xmx1024M -Dosgi.clean=true

set CATMAN_VMARGS=-nl fr_CA -vmargs -Xmx1024M -Dosgi.clean=true

2. コンピュータに指定された、Javaのデフォルト・ロケールをチェックします。

3. デフォルト・ロケールの英語(厳密にはen_US)を使用します。

Catalog Managerを起動してカタログをオンライン・モードで開くと、そのコンテンツを表示するためのロケールを選択できます。選択可能なロケールは次の条件により決まります。Catalog Managerでは、以降のオンライン接続に、この選択したロケールが使用されます。

- インストール・プロセスでプレゼンテーション・サービス用にロケールが選択されているかどうか。

- カタログのコンテンツが特定のロケールで翻訳されているかどうか。

ロケールの翻訳済ファイルがない場合、コンテンツはデフォルト・ロケールの英語(厳密にはen_US)で表示されます。

次の点に注意してください。

- セッション・エラー(ログインの失敗やセッション・タイムアウトなど)はデフォルトのロケールで表示されます。これは、必ずしもユーザーがログインしようとしたロケールであったり、そのセッションがタイムアウトしたロケールであるとはかぎりません。

- Catalog Managerのユーザー・インタフェースの一部の文字列(文字列Maximizeなど)は翻訳されません。

「カタログ・マネージャについて」を参照してください。

Oracle BIサーバーでの現在のロケールの設定

アプリケーションでローカライズをカスタマイズするための様々な方法について学習します。

次の各項では、Oracle BIサーバーでのロケールの設定について説明します。

- Oracle BIサーバーでのロケール・パラメータの設定

- エラー・メッセージの言語が決定される方法

- Oracle BIサーバーのコンポーネントの言語の設定

- 管理ツールのユーザー・インタフェースの言語の変更

- Oracle BIサーバーでの現在のロケールに関するトラブルシューティング

- Oracle BIサーバー・ユーティリティのテキストが正しい言語で表示されることの確認

- 基礎となるOracle DatabaseのNLS_CHARACTERSETがUnicodeでない場合のメタデータ・リポジトリの変更

Oracle BIサーバーでのロケール・パラメータの設定

複数言語をサポートするには、Oracle BIサーバーを適切に構成する必要があります。

NQSConfig.INIファイルのGeneralセクションには、ローカライズおよび国際化に必要なパラメータが含まれています。また、Oracle BIサーバーからクライアント・アプリケーションへのデータの送信方法を決定するデフォルト・パラメータも含まれています。「構成ファイル設定」を参照してください。

NQSConfig.INIファイル内のローカライズに影響するパラメータは次のとおりです。

- LOCALE

- SORT_ORDER_LOCALE

- SORT_TYPE

- CASE_SENSITIVE_CHARACTER_COMPARISON

Oracle Business Intelligenceを正常に実行するには、ユーザーがアプリケーションを実行する言語について、オペレーティング・システムのロケールを適切に構成する必要があります。ロケールおよび言語に関する一部の設定は相互に関連しており、Oracle BIサーバーでのデータのソート方法の決定に役立ちます。

UNIXシステムでのロケールの設定

サーバー起動時にC-runtimeロケールに対して使用される値は、NQSConfig.INIファイルのSORT_ORDER_LOCALEパラメータに指定されています。このパラメータは、通常、Oracle BIサーバーにより設定されます。

このロケールは、日付や通貨の表示、およびデータのソートなどの機能で使用されます。

設定を調整する必要がある場合は、NQSConfig.INIファイルのGeneralセクションで、プラットフォーム非依存の名前を入力してLOCALEパラメータおよびSORT_ORDER_LOCALEパラメータを設定します。

次の表に、プラットフォーム非依存の名前と、サポートされる各UNIXプラットフォーム固有の名前の言語マッピングを示します。たとえば、HP-UXまたはLinuxオペレーティング・システムでは、中国語にzh_CN.utf8設定が使用されます。

zh_CN.utf8やfr-FR-UTF-8などの名前文字列はプラットフォーム固有のロケール・コンポーネントの名前であり、システム管理者がインストールする必要があります。NQSConfig.INIファイルでは、ChineseやFrench(大文字小文字は区別されません)など、プラットフォーム非依存の名前が使用されます。

ロケール(プラットフォーム非依存の名前)

Solarisでの名前

AIXでの名前

HP-UX/Linuxでの名前

アラビア語

ar_SA.UTF-8

AR_AA.UTF-8

ar_SA.utf8

中国語

zh_CN.UTF-8

ZH_CN.UTF-8

zh_CN.utf8

中国語(繁体字)

zh_TW.UTF-8

ZH_TW.UTF-8

zh_TW.utf8

クロアチア語

hr_HR.UTF-8

HR_HR.UTF-8

hr_HR.utf8

チェコ語

cs_CZ.UTF-8

CS_CZ.UTF-8

cs_CZ.utf8

デンマーク語

da_DK.UTF-8

DA_DK.UTF-8

da_DK.utf8

オランダ語

nl_NL.UTF-8

NL_NL.UTF-8

nl_NL.utf8

英語(米国)

en_US.UTF-8

EN_US.UTF-8

en_US.utf8

フィンランド語

fi_FI.UTF-8

FI_FI.UTF-8

fi_FI.utf8

フランス語

fr_FR.UTF-8

FR_FR.UTF-8

fr_FR.utf8

ドイツ語

de_DE.UTF-8

DE_DE.UTF-8

de_DE.utf8

ギリシャ語

el_GR.UTF-8

EL_GR.UTF-8

el_GR.utf8

ヘブライ語

he_IL.UTF-8

HE_IL.UTF-8

iw_IL.utf8

ハンガリー語

hu_HU.UTF-8

HU_HU.UTF-8

hu_HU.utf8

イタリア語

it_IT.UTF-8

IT_IT.UTF-8

it_IT.utf8

日本語

ja_JP.UTF-8

JA_JP.UTF-8

ja_JP.utf8

韓国語

ko_KR.UTF-8

KO_KR.UTF-8

ko_KR.utf8

ノルウェー語

no_NO.UTF-8

NO_NO.UTF-8

no_NO.utf8

ポーランド語

pl_PL.UTF-8

PL_PL.UTF-8

pl_PL.utf8

ポルトガル語

pt_PT.UTF-8

PT_PT.UTF-8

pt_PT.utf8

ポルトガル語(ブラジル)

pt_BR.UTF-8

PT_BR.UTF-8

pt_BR.utf8

ルーマニア語

ro_RO.UTF-8

RO_RO.UTF-8

ro_RO.utf8

ロシア語

ru_RU.UTF-8

RU_RU.UTF-8

ru_RU.utf8

スロバキア語

sk_SK.UTF-8

SK_SK.UTF-8

sk_SK.utf8

スペイン語

es_ES.UTF-8

ES_ES.UTF-8

es_ES.utf8

スウェーデン語

sv_SE.UTF-8

SV_SE.UTF-8

sv_SE.utf8

タイ語

th_TH.UTF-8

TH_TH.UTF-8

th_TH.utf8

トルコ語

tr_TR.UTF-8

TR_TR.UTF-8

tr_TR.utf8

エラー・メッセージの言語が決定される方法

Oracle BIプレゼンテーション・サービスでは、エラー・メッセージの言語はNQ_SESSION.WEBLANGUAGEセッション変数に基づいて設定されます。

プレゼンテーション・サービスでは、インストレーション時にこの変数のデフォルト値が指定されます。この値は、ユーザーがOracle BI EEサインイン・ページで言語を選択すると更新されます。

サード・パーティのクライアントを含むその他のクライアントでは、エラー・メッセージの言語は次の優先順位モデルにより決定されます。

- エラー・メッセージの言語はWEBLANGUAGEセッション変数に基づいて設定されます。

- WEBLANGUAGEセッション変数が設定されていない場合は、Oracle BIプレゼンテーション・サービスへのアクセスで使用されるODBCデータ・ソース名(DSN)に指定されたエラー言語に基づいて設定されます。
ODBC DSNでのエラー・メッセージ言語の設定の詳細は、Oracle Business Intelligence Enterprise Editionインテグレーターズ・ガイドを参照してください。

- ODBC DSNにエラー・メッセージの言語が設定されていない場合は、ORACLE_BI_LANG環境変数で指定されている言語がエラー・メッセージに対して使用されます。
ORACLE_BI_LANGの値を変更するには、NQSConfig.INIでこの変数の文字コードを更新します。サポートされている言語の文字コードは、ORACLE_HOME/bi/bifoundation/server/localeディレクトリで確認できます(たとえば、enは英語を表し、pt-BRはポルトガル語/ブラジル語を表します)。

- ORACLE_BI_LANG環境変数が設定されていない場合、エラー・メッセージは英語で表示されます。

管理ツールおよびジョブ・マネージャのクライアントでは、WEBLANGUAGEセッション変数は設定されないので注意してください。したがって、これらのクライアントは、ODBC DSNエラー・メッセージ設定以降の優先順位モデルに従います。

Oracle BIサーバーのコンポーネントの言語の設定

ORACLE_BI_LANG変数は、アプリケーションのコンポーネントをユーザーに表示するために使用される言語を制御します。

NQServer.logファイルの内容など、Oracle BIサーバーのコンポーネントの正しい言語を表示するには、次の手順の説明に従い、ORACLE_BI_LANG変数を設定する必要があります。

1. 次の編集するNQSConfig.INIファイルを開きます。

BI_DOMAIN/config/fmwconfig/biconfig/OBIS

2. ORACLE_BI_LANG環境変数を設定するための行を挿入します。次の例では、言語を日本語に設定しています。

<variable id="ORACLE_BI_LANG" value="ja"/>

3. 変更内容を保存し、ファイルを閉じます。

4. BIシステム・コンポーネントおよびBIサーバーを再起動します。

「Oracle Business Intelligenceプロセスの管理」を参照してください。

管理ツールのユーザー・インタフェースの言語の変更

Oracle BI管理ツールのユーザーインタフェースは、オペレーティング・システムに指定されている言語を継承します。

たとえば、Windowsオペレーティング・システムがフランス語を使用するように設定されている場合は、メモ帳や管理ツールなどのすべてのWindowsベース・アプリケーションで、メニューやボタンなど、すべてのユーザー・インタフェース要素がフランス語で表示されます。Windowsのコントロール・パネルで設定したロケールは、通貨、日時、表示単位およびキーボードのレイアウトなどの項目に影響します。これは、メニューやボタンなどのユーザー・インタフェース要素とは異なります。

推奨される方法は、管理ツールでオペレーティング・システムの言語を継承できるようにすることです。オペレーティング・システムの言語を変更せずに、管理ツールのユーザー・インタフェースの言語を変更する必要がある場合は、ORACLE_BI_LANG環境変数を使用できます。この変数の設定の詳細は、「エラー・メッセージの言語が決定される方法」を参照してください。

また、「リポジトリでのメタデータ名のローカライズ」で説明されているように、プレゼンテーション・レイヤーでサブジェクト領域、表、階層および列の名前とその説明をローカライズすることもできます。

Oracle BIサーバーでの現在のロケールに関するトラブルシューティング

一部の地域では、特定のトラブルシューティング手順が必要となります。

この項では、Oracle BIサーバーでの現在のロケールに関するトラブルシューティングについて説明します。

- NLSロケール非サポート・エラー・メッセージの処理

- AIXシステムでの日本語ロケールの設定

NLSロケール非サポート・エラー・メッセージの処理

適切なロケールがインストールされていない場合、Oracle BIサーバーは起動せず、obis1-query.logファイルに次のエラーが格納されます。

NLSのロケールxxxは、このオペレーティング・システムでサポートされていません。

xxxは、NQSConfig.INIファイルでSORT_ORDER_LOCALEパラメータに指定されているロケールです。このエラーを解決するには、次の操作を実行します。

- UNIXの場合。UNIXシステムでのロケールの設定の表に示すロケールのうち、必要な言語に対応するものをインストールします。

- Windowsの場合。「地域の設定」ダイアログを使用して、対応する言語パックを追加します。

AIXシステムでの日本語ロケールの設定

AIXシステムでは、日本語のローカライズが適切に解釈されないことがあります。

AIXプラットフォームで日本語ローカライズを使用すると、Oracle BIサーバーが起動しないことがあります。この問題が発生した場合は、次の手順を実行します。

1. JA_JP.UTF-8ロケールがインストールされていることを確認します。インストールされていない場合はインストールします。

2. 次の編集するNQSConfig.INIファイルを開きます。

BI_DOMAIN/config/fmwconfig/biconfig/OBIS

3. Generalセクションで、次のパラメータを設定します。設定では大文字と小文字が区別されるので注意してください。

- LOCALE = "Japanese";

- SORT_ORDER_LOCALE = "Japanese";

4. NQSConfig.INIファイルを保存して閉じます。

Oracle BIサーバー・ユーティリティのテキストが正しい言語で表示されることの確認

Oracle BIサーバーのユーティリティの使用状況情報およびエラー・メッセージが正しい言語で表示されることを確認します。

- Linux環境では、マルチバイト文字を表示するにはターミナル・エンコーディングをUTF-8に設定します。これには、「Terminal」メニュー、「Set Character encoding」、「utf8」の順に選択します。

- ネイティブWindows環境では、コンソールのフォントを「Lucida Console」に設定します。このオプションがリストに表示されない場合は、まず、コード・ページを65001に変更します。これによりUTF-8がサポートされるので、コマンドchcp 65001を使用します。

基礎となるOracle DatabaseのNLS_CHARACTERSETがUnicodeでない場合のメタデータ・リポジトリの変更

Oracle DatabaseのNLS_CHARACTERSETがUnicode以外の派生コード・ページに設定されている場合、Oracle DatabaseとOracle BIサーバー間で文字ソートが一致するように、メタデータ・リポジトリの追加設定を構成する必要があります。

1. 管理ツールで、メタデータ・リポジトリを開きます。

2. 物理レイヤーでデータベース・オブジェクトを展開します。

3. 「接続プール」ダイアログの「接続スクリプト」タブを開き、次の新しい接続プール・スクリプトを追加します。

alter session set NLS_SORT = unicode_binary

4. リポジトリを保存して、Oracle BIサーバーを再起動します。

リポジトリでのメタデータ名のローカライズ

管理ツールの「文字列の外部化」ユーティリティを使用すると、プレゼンテーション・レイヤーのサブジェクト・エリア名、表名、階層名、列名およびそれらの説明をローカライズできます。

これらのテキスト文字列を、ANSI、UnicodeおよびUTF-8のエンコーディング・オプションを使用して外部ファイルに保存できます。

1. 管理ツールでリポジトリを開きます。

2. サブジェクト・エリア、プレゼンテーション表またはプレゼンテーション列など、プレゼンテーション・レイヤーのオブジェクトを右クリックし、「表示名の外部化」→「カスタム名の生成」を選択するか、「記述子の外部化」→「カスタム説明の生成」を選択して文字列を外部化します。「カスタム名の生成」を選択して、「文字列の外部化」ユーティリティを実行すると、変換キーも「文字列の外部化」ダイアログに表示されます。
これらの外部化オプションのいずれかを選択すると、選択したオブジェクトとそのすべての子オブジェクトについて、「プロパティ」ダイアログの「カスタム表示名」オプションまたは「カスタム説明」オプションが自動的に選択されます。

たとえば、サブジェクト・エリアを右クリックして外部化オプションのいずれかを選択すると、サブジェクト・エリア内のすべてのプレゼンテーション表、列、階層およびレベルに対して外部化フラグが設定されます。

3. 「ツール」→「ユーティリティ」を選択します。

4. 「文字列の外部化」を選択し、「実行」をクリックします。

5. 「文字列の外部化」ダイアログの左側のペインで、1つ以上のサブジェクト・エリアを選択します。
右側のペインに、翻訳済の値と元の文字列(名前および説明)が表示されます。これらは、プレゼンテーション・サービスで使用されるセッション変数の値になります。

プレゼンテーション・レイヤーで外部化フラグが設定されているオブジェクトのみ右側のペインに表示されます。

6. 「保存」をクリックします。

7. 「名前を付けて保存」ダイアログで、次のいずれかを実行します。

- 選択したサブジェクト・エリアが1つのみの場合は、ファイルのタイプおよびエンコーディング値を選択し、「保存」をクリックします。

- 複数のサブジェクト・エリアを選択し、それぞれを別々のXMLファイルに外部化する場合は、ディレクトリ名を選択し、[SHIFT]を押しながら「保存」をクリックします。サブジェクト・エリアはそれぞれ、Unicodeで暗号化されたXMLファイルに保存されます。

8. 「外部化された文字列」ダイアログで、「閉じる」をクリックします。

9. (オプション)外部化を無効にするには、プレゼンテーション・レイヤーのオブジェクトを右クリックし、「表示名の外部化」→「外部化の無効化」を選択するか、「記述子の外部化」→「外部化の無効化」を選択します。
これらのオプションのいずれかを選択すると、選択したオブジェクトとそのすべての子オブジェクトについて、「プロパティ」ダイアログの「カスタム表示名」オプションまたは「カスタム説明」オプションが自動的に選択解除されます。

「文字列の外部化」ユーティリティを使用して文字列ファイルを作成した場合は、次の手順に従い、そのファイルを使用してメタデータ・オブジェクトの文字列を翻訳できます。

1. 各文字列ファイルを開いて次の列を調べます。

- 1列目には、実際のリポジトリ・オブジェクトの名前が記述されています。この名前には、オブジェクトのタイプと接頭辞が含まれます。

- 2列目には、各オブジェクトの名前または説明に対応するセッション変数が記述されています。これらには、カスタム名を示すデフォルト接頭辞のCN_、またはカスタム説明を示すデフォルト接頭辞のCD_が含まれます。

- 3番目の列には、それぞれのオブジェクト名に対応する変換キーが含まれています。

2. Languageという名前の4番目の列を追加します。この列で、deなど、名前が翻訳された言語のコードを指定します。

3. 文字列ファイルをデータベース表にロードします。

4. 管理ツールで、この表を物理レイヤーにインポートします。

5. 行単位の初期化ブロックを使用して、翻訳済の文字列をロードします。初期化ブロックのターゲットが「行単位の初期化」に設定されていること、および実行優先順位が正しく設定されていることを確認します。
たとえば、次の手順を実行します。

a. 次のようなSQL文を使用して、データベースからのデータ・ソースを含むセッション初期化ブロックを作成します。

SELECT 'VALUEOF(NQ_SESSION.WEBLANGUAGE)' FROM DUAL

b. 設定言語の「セッション変数初期化ブロック」ダイアログで、「変数ターゲット」にLOCALEセッション変数を指定します。
この仕様により、ユーザーがサインインするときは常に、WEBLANGUAGEセッション変数が設定されるようになります。その後、この変数によって、LOCALE変数が初期化ブロックを使用して設定されます。

c. 「セッション変数初期化ブロックのデータソース」ダイアログで、次のようなデータベース固有のSQL文を使用して、一連のセッション変数を作成する別のセッション初期化ブロックを作成します。

select SESSION_VARIABLE, TRANSLATION from external where LANGUAGE =
'VALUEOF(NQ_SESSION.LOCALE)'

このブロックで作成されるすべての変数の言語は、サインイン時にユーザーが指定した言語に一致します。

d. 「セッション変数初期化ブロックの変数ターゲット」ダイアログで、初期化ブロックのターゲットを「行単位の初期化」に設定します。

e. 「セッション変数初期化ブロック」ダイアログの「実行優先度」領域で、前に作成した初期化ブロックを指定して、最初に作成したブロックが最初に実行されるようにします。

6. 変更を保存します。

ヒント

管理ツールの言語の詳細は、「管理ツールのユーザー・インタフェースの言語の変更」を参照してください。

Oracle Application Development Frameworkデータ・ソースを使用する場合は、「文字列の外部化」ユーティリティを使用するかわりに、そのデータ・ソースからラベルおよびツールチップを伝播できます。『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』を参照してください。

多言語データのサポート

Oracle BIサーバーはいくつかの言語の翻訳をサポートしています。

この項では、複数の言語でフィールド情報を表示できるようにOracle BIサーバーを構成する方法について説明します。内容は次のとおりです。

- 多言語データのサポートとは

- 参照とは

- 二重列サポートとは

- 多言語スキーマでの翻訳参照表の設計

- 論理参照表および論理参照列の作成

- 物理参照表および物理参照列の作成

- 別名表を使用したEssbaseでの多言語データのサポート

- 辞書編集上の差異によるソートの有効化

管理ツールの使用の詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

多言語データのサポートとは

多言語データのサポートとは、データベース・スキーマのデータを複数の言語で表示する機能です。

Oracle BIサーバーは、翻訳の管理を簡素化し、その問合せパフォーマンスを改善することによって多言語スキーマをサポートします。多言語スキーマでは、通常、翻訳済フィールドが参照表と呼ばれる個別の表に格納されます。参照表には記述子列の翻訳が複数言語で格納され、ベース表にそのデータが元の言語で格納されます。記述子列は、キー列のテキストによる説明を提供します。記述子列とキー列の間には1対1の論理的関係があります。たとえば、記述子列はProduct_Nameなどで、これはProduct_Key列のテキストによる説明を提供します。

参照とは

参照とは、問合せによってベース表と参照表を結合し、ベース表の各行に対して翻訳済の値を取得することを指します。

その性質上、参照表には「密」および「疎」があります。密である参照表には、ベース表のすべてのレコードの翻訳が、すべての言語で格納されています。疎である参照表には、ベース表の一部のレコードの翻訳のみが格納されています。場合によって、参照表は密および疎の両方であることがあります。たとえば、参照表に、Product Descriptionフィールドのすべての翻訳が含まれる一方、Product Categoryフィールドの一部の翻訳のみが含まれるような場合です。密および疎とは、表の性質というよりも、参照操作のタイプになります。参照表は、管理ツールを使用して構成します。

二重列サポートとは

二重列サポートとは、論理レイヤーの2つの列(記述子ID列と記述子列)を関連付ける機能であり、言語非依存フィルタの定義に役立ちます。

ユーザーが記述子列に基づいてフィルタを作成すると、問合せツールにより、記述子列から選択された値のリストがユーザーに表示されます。

この記述子列の手法は、CLOBやBLOBなどのLOBデータ型に関連する問合せを処理する場合、およびCOUNTまたはSUMなどの集計関数を処理する場合にも便利です。一部のデータ・ソースでは、GROUP BY句でのLOB列の使用は許可されていません。したがって、LOB列をGROUP BYに追加するかわりに、LOB列との1対1の関係を持つ他の列でグループ化し、集計が行われた後にLOB列を結合する必要があります。

多言語スキーマでの翻訳参照表の設計

多言語スキーマで翻訳参照表を設計する一般的な手法には、次の2つがあります。

- 各ベース表に対応する参照表

- 各翻訳済フィールドに対応する参照表

各ベース表に対応する参照表

多くの場合、ベース表ごとに個別の参照表があります。参照表には、ベース表内のレコードへの外部参照キーが含まれ、各翻訳済フィールドの値が個別の列に含まれます。

参照表が完全に密である場合、特定言語用の参照表内の行数は、ベース表内の行数と等しくなります。

次の図の例は、ベース表内の1つの行のみに一致する、参照表内の各レコードを示しています。

各翻訳済フィールドに対応する参照表

ベース表ごとに1つの参照表を使用するかわりに、次の図に示すように、翻訳済フィールドごとに個別の参照表を使用する方法があります。

各フィールドの翻訳済値を取得するには、参照表に対する個別の結合が必要です。実際には、これは多くの場合、複数フィールドの翻訳を含む1つの物理表になります。単一の表に複数フィールドの翻訳が含まれる場合は、参照表にフィルタを設定して、データを、ベース表内の特定の列に関連する値のみに制限する必要があります。

論理参照表および論理参照列の作成

この項では、論理参照表および論理参照列の作成について説明します。内容は次のとおりです。

- 論理参照表の作成

- 論理表の参照表としての指定

- LOOKUP関数の構文について

- 論理参照列の作成

論理参照表の作成

ビジネス・モデルで論理参照表オブジェクトを作成して、翻訳参照表に必要なメタデータを定義します。

「論理表の参照表としての指定」で説明しているように、参照表とは、自身を参照表として指定するプロパティを持つ論理表のことです。次の図は、参照表の例を示しています。

- 参照表の各主キーをまとめて参照キーと見なし、参照が実行されます。参照は、すべての参照キー列に値が指定されている場合にのみ実行できます。たとえば、前述の図では、Product_CodeとLanguage_Keyの組合せによってこの参照表の主キーが形成されます。

- 参照キーは論理表キーとは異なります。参照キー列ではその順序が考慮されます。たとえば、Product_CodeとLanguage_Keyの参照キーは、Language_KeyとProduct_Codeの参照キーとは異なると見なされます。参照キー列の順序は管理ツールで指定できます。参照キーのすべての列は参照関数で結合する必要があります。

- 参照表には参照キーが1つのみ含まれます。

- 参照表には少なくとも1つの値列が含まれます。前述の図ではDescriptionが値列であり、製品の説明の翻訳済値が含まれています。

- 参照キーから各値列への関数従属性が存在する必要があります。言い換えれば、参照キーによって値列を識別できます。参照キーおよび値列は、どちらも同じ物理表に属している必要があります。

- 参照表は独立しており、他の論理表には結合されません。
整合性チェック・ルールは参照表に対しては緩和されているため、表が参照表として指定されている場合、サブジェクト・エリア内の他の表と結合する必要はありません(論理表は、通常、サブジェクト・エリア内の1つ以上の表に結合されます)。

- 参照列を使用した集計の結果は、ベース列を使用した結果と一致する必要があります。たとえば、次のコードを実行したとします

SELECT product.productname_trans, sales.revenue FROM snowflakesales;

これは、次のコードと同じ結果を戻す必要があります。

SELECT product.productname, sales.revenue FROM snowflakesales;

この例の参照表productname_transで参照キーProductIDおよびLANGUAGEを使用している場合、両方の問合せで同じ集計結果が戻されます。

参照キーにproductnameとは異なる集計レベルの列が含まれる場合は、問合せで変更が取得され、集計に反映されます。

論理表の参照表としての指定

論理表を参照表として使用するには、管理ツールを使用して、事前に論理表を参照表として指定する必要があります。

論理表を参照表として指定するには、管理ツールを使用して、最初に参照表を物理レイヤーにインポートし、それを「ビジネス・モデルとマッピング」レイヤー内にドロップします。次に、論理参照表ごとに、「論理表」ダイアログで「参照表」オプションを選択する必要があります。

参照表の主キーに指定されている列の順番により、LOOKUP関数の対応する引数の順番が決まります。

たとえば、参照表の主キーがRegionKey列、CityKey列およびLanguageKey列で構成される場合、LOOKUP関数の対応する引数を同じ順番で指定する必要があります。主キー列の順番を変更するには、管理ツールを使用します。

LOOKUP関数の構文について

LOOKUP関数は通常、「ビジネス・モデルとマッピング」レイヤーで、翻訳済の論理表列の式として使用されます。

LOOKUP関数の構文は、次のようになります。

Lookup ::= LookUp([DENSE] value_column, expression_list ) | LookUp(SPARSE value_
column, base_column, expression_list )

expression_list ::= expr {, expression_list }

expr ::= logical_column | session_variable | literal

例:

LOOKUP( SPARSE SnowflakeSales.ProductName_TRANS.ProductName, SnowflakeSales.Product.ProductName, SnowflakeSales.Product.ProductID, VALUEOF(NQ_SESSION."LANGUAGE"))

LOOKUP( DENSE SnowflakeSales.ProductName_TRANS.ProductName, SnowflakeSales.Product.ProductID, VALUEOF(NQ_SESSION."LANGUAGE"))

次の点に注意してください。

- LOOKUP関数は密または疎のいずれかで、キーワードDENSEまたはSPARSEを使用して指定します。DENSEとSPARSEをどちらも指定しない場合、デフォルト動作は密参照になります。DENSE参照の場合、翻訳表は内部結合を通じてベース表に結合されますが、SPARSE参照の場合は左外部結合が実行されます。

- 第1パラメータ(DENSEまたはSPARSEキーワードの後のパラメータ)は、論理レイヤーで定義されている有効な参照表の有効な値列にする必要があります。

- SPARSEキーワードを指定した場合、第2パラメータは、value_columnのベース値を提供する列にする必要があります。DENSE参照の場合、このベース列は必要ありません。

- expression_listの式の数は、value_columnで定義した、参照表で定義されている参照キー列の数と同じにする必要があります。また、式リストで指定した式は、参照キー列と1対1で順番に一致している必要があります。
例:

- 参照表ProductName_TRANSの参照キーは、Product_codeおよびLanguage_Keyの両方です。

- expression_listの式は、SnowflakeSales.Product.ProductIDおよびVALUEOF(NQ_SESSION."LANGUAGE")です。

- この参照の意味を次に示します。
Product_code = SnowflakeSales.Product.ProductIDおよびLanguage_Key = VALUEOF(NQ_SESSION."LANGUAGE")という条件を使用して、翻訳表からProductNameの翻訳済の値を戻します。

論理参照列の作成

参照関数を含む論理列を作成するには、管理ツールで式ビルダーを使用します。

論理列の値は、現在のユーザーに関連付けられている言語に基づきます。

たとえば、翻訳済の製品名を取得するには、「列ソース」タブで、導出された列式を使用して新しい論理列を作成します。

LAN_INTはセッション初期化ブロックMLSにより移入されるセッション変数で、基本言語または他の言語を表します。

- 基本言語(たとえば、en - English)の場合は0

- 他の言語コード(たとえば、fr - Frenchまたはcn - Chinese)の場合は1

WEBLANGUAGEは、ユーザーがログイン時に選択した言語に基づいて自動的に初期化されるセッション変数です。

INDEXCOL関数は、適切な列の選択をサポートします。前述の例では、ユーザー言語が基本言語の場合(つまり、セッション変数LAN_INTの値が0の場合)にのみ、基本列(ProductName)の値が戻されます。ユーザー言語が基本言語でない場合(セッション変数LAN_INTの値が1の場合)は、WEBLANGUAGEセッション変数に渡された言語の参照表から値が戻されます。

(前述の例の)DENSE関数を使用する場合、翻訳対象言語の列に値がないと、参照関数により空白のエントリが表示されます。

(次の例の)SPARSE関数を使用する場合、翻訳対象言語の列に値がないと、参照関数により基本言語で対応する値が表示されます。

INDEXCOL( VALUEOF(NQ_SESSION."LAN_INT"), "Translated Lookup Tables"."Product".
"ProductName", LOOKUP( SPARSE "Translated Lookup Tables"."Product Translations".
"ProductName", "Translated Lookup Tables"."Product"."ProductName", "Translated
Lookup Tables"."Product"."ProductID", VALUEOF(NQ_SESSION."WEBLANGUAGE")))

派生論理列を使用するためのヒント

派生論理列を使用する場合は、エラーを減らすための計画が必要となります。

派生論理列を使用する場合は、次のヒントに留意してください。

- LOOKUP関数の結果として導出された論理列を、主論理キーとして使用することはできません。この制限が存在する理由は、LOOKUPの操作は集計が計算された後に適用されますが、レベル・キー列は集計が計算される前に利用可能である必要があるためです(レベル・キー列は集計計算の粒度を定義するため)。
LOOKUP関数の結果として導出された論理列は、2次論理レベル・キーとして使用できます。

- 導出した式に参照関数が含まれる派生論理列については、次の点に留意してください。

- 参照関数で使用される論理列に関連付けられたレベルは、派生論理列自体のレベルよりも低くしないでください。

- 推奨される方法は、記述子ID列を構成することです。

非ISOタイプの言語コードの処理

表内のデータに非ISOタイプの言語コードが含まれる場合は、ISO言語コードを非ISO言語コードにマップする表が必要になります。

ユーザーのログイン時にISO言語コードを設定する既存のWEBLANGUAGE変数を使用できます。個別のLANGUAGE変数を定義し、その初期化ブロックでマッピング表に対して問合せを実行して、WEBLANGUAGE変数の値でフィルタされた非ISO言語コードをフェッチします。次の表に、非ISO言語コードのマッピング表を示します。LANGUAGEが非ISO言語コードです。

WEBLANGUAGE

LANGUAGE

LAN_INT

en

ENG

0

cn

CHI

1

fr

FRA

1

物理参照表および物理参照列の作成

ビジネス・モデルで物理参照表オブジェクトを作成して、翻訳参照表に必要なメタデータを定義できます。物理参照表は、その意味と使用方法の両方において論理参照表に類似しています。

物理参照表は、論理参照表で処理できない次のシナリオに対処します。

- 参照表ソースが断片化されている。この場合、複数の物理参照表を使用して値を保持します。たとえば、断片化されている製品名データの翻訳値を、productname_trans_AtoMおよびproductname_trans_NtoZという2つの物理参照表に分散させることができます。

- 異なるレベルの翻訳表を使用できる。たとえば、Essbaseデータ・ソースとリレーショナル・データ・ソースの両方で翻訳を使用できます。基本問合せと同じソースを使用することをお薦めします。

論理参照表は「論理表」ダイアログでオプションを選択することにより指定しますが、物理参照表は論理表ソース・マッピングで参照関数を作成することにより構成します。

たとえば、次の物理表があるとします。

- categoryidおよびcategorynameなどの列を含む、Categoriesという名前のベース表。

- categoryid、language_keyおよびcategorynameなどの列を含む、Categories_Transという名前の翻訳表。categorynameの翻訳済値は、categoryid列およびlanguage_key列の組合せにより決定されます。

Categoriesという名前の論理表があるとします。この表に、categoryname_pという名前の新しい論理列を追加します。この列は、現在の言語に基づく翻訳列です。論理参照列とは異なり、この列は他の論理列からは導出されません。

次の手順で、前述の例を使用して、物理参照翻訳列を構成する方法について説明します。

1. 管理ツールでリポジトリを開きます。

2. 「ビジネス・モデルとマッピング」レイヤーで、適切な論理表(たとえば、Categories)を右クリックし、「新規オブジェクト」、「論理列」の順に選択して新しい論理列を作成します。

3. 論理列の名前(たとえば、categoryname_p)を指定します。

4. 「列ソース」タブを選択します。

5. 「物理マッピングから派生」の下の「論理表ソース」ボックスで、ベース表列を含む論理表ソース・オブジェクトをダブルクリックします。「論理表ソース」ダイアログの「列マッピング」タブが表示されます。

6. 「マップされていない列の表示」が選択されていることを確認します。

7. 新しい論理列(たとえば、categoryname_p)の「式」列に、次のような式を入力します。

INDEXCOL(VALUEOF(NQ_SESSION."LAN_INT"),
"DB_Name"."My_Category"."My_Schema"."Categories"."CategoryName", LOOKUP(SPARSE
"DB_Name"."My_Category"."My_Schema"."CATEGORIES_TRANS"."CATEGORYNAME",
"DB_Name"."My_Category"."My_Schema"."Categories"."CategoryName",
"DB_Name"."My_Category"."My_Schema"."Categories"."CategoryID",
VALUEOF(NQ_SESSION."LANGUAGE")))

式ビルダーを使用して作成することもできます。

8. 「論理表ソース」ダイアログで「OK」をクリックします。

9. 「論理列」ダイアログで「OK」をクリックします。

10. 変更を保存します。

Categories_trans物理翻訳表を論理表ソースに組み込む必要はありません。INDEXCOL関数により、LAN_INTセッション変数が0であるかどうかチェックされ、ベース表からcategoryname列がフェッチされます。LOOKUP関数について次の点に注意してください。

- 物理LOOKUP関数は論理LOOKUP関数と同様に機能します。唯一の違いは、論理表および論理列に対するすべての参照が、物理表および物理列に置き換えられることです。

- LOOKUP関数の第1列は値列で、これは翻訳表の翻訳値列です。疎参照が存在する場合、第2列は基本値列です。残りの列は、物理翻訳表に結合される列または値です。この物理翻訳表は、LOOKUP関数の値列により示されます。

ダイアログを使用して物理参照表を構成できないため、結合列および値の順番と、物理翻訳表の「物理表」ダイアログに表示される列の順序に互換性があることを確認する必要があります。たとえば、Categories_trans表の「物理表」ダイアログの「Keys」タブでは、主キーはCategoryID列とLanguage_Key列により構成されます。

LOOKUP関数で指定される列は、次のように対応します。

- 次の行があるとします。

"DB_Name"."My_Category"."My_Schema"."Categories"."CategoryID"

これはCategories_trans.CategoryID列に対応します。

- 次の行があるとします。

valueof(NQ_SESSION."LANGUAGE")

これはCategories_trans.Language_key列に対応します。

LAN_INTセッション変数やLANGUAGEセッション変数などの参照の概念の詳細、およびLOOKUP関数の完全な構文の情報は、「論理参照表および論理参照列の作成」を参照してください。

別名表を使用したEssbaseでの多言語データのサポート

多くの場合、Essbaseキューブのメンバーは、ユーザー言語ごとに個別の別名を用意して、ユーザーが自分の言語でメンバー名を表示できるようにします。

通常、セッション変数を定義して、ユーザーのログイン時に適切な別名を動的に選択します。Essbaseの別名表について、およびそれらをセッション変数で使用する方法の詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

辞書編集上の差異によるソートの有効化

辞書編集上の差異によるソートは、データをアルファベット順にソートする機能です。

ほとんどのデータ・ソースは辞書編集上の差異によるソートをサポートしています。ただし、辞書編集上の差異によるソートが特定のデータ・ソースに対して適切に動作しない場合、Oracle BIサーバーを構成して、バックエンド・データ・ソース以外でソートを実行できます。この構成を実行するには、管理ツールの「データベース」ダイアログの「機能」タブで、ORDERBY_SUPPORTEDが選択解除されていることを確認します。データベース機能の指定の詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

データ・ソースでORDERBY_SUPPORTEDを無効にすると、パフォーマンスに非常に大きな影響を与える場合があるので注意してください。これは、無効にした結果、多数の結合がデータ・ソースにプッシュダウンされないためです。多くの場合、パフォーマンスへの影響は非常に大きいため、辞書編集上の差異によるソート機能への影響に関係なく、ORDERBY_SUPPORTEDはデータ・ソースで有効にしておくことができます。

15 通貨オプションの構成

この章では、Oracle Business Intelligenceの通貨オプションを構成する方法について説明します。コンテンツ・デザイナが分析を作成する際は、その多くの場合に、米国ドルなどの通貨を示すデータを使用します。管理者として、ユーザーが使用できる通貨オプションを制御する各種タスクを実行できます。

この章の内容は次のとおりです。

- 分析用デフォルト通貨の変更

- ユーザーの優先通貨オプションの定義

分析用デフォルト通貨の変更

フランスのフランをユーロにするなど、表示されるデフォルトの通貨を変更できます。

アンサーでのフォーマット関数の使用の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

1. ORACLE_HOME/bi/bifoundation/web/displayディレクトリにあるcurrencies.xmlファイルを開きます。

2. デフォルトに設定する通貨(USD、CAD、PEN、MADなど)を検索します。

3. 通貨要素全体をコピーします。
たとえば、ユーロの通貨タグをコピーします。

- <Currency tag="int:euro-l" type="international" symbol="_" displayMessage="kmsgCurrencyEuroLeft" digits="2" format="$ #">
<negative tag="minus" format="-$ #" />
</Currency>

4. ファイルの上部付近にあるテキスト文字列int:wrhsを検索します。

5. 要素全体を選択し、その上にコピーした要素を貼り付けて置き換えます。

6. タグ属性がint:wrhsとなるように置き換えます。
たとえば、tag="int:euro-l"をtag="int:wrhs"に置き換えます。

7. Oracle BIサーバーのサービスを再起動します。

注意:

アップグレード、パッチセット、バンドル・パッチまたは個別パッチを適用する際に、currencies.xmlファイルが上書きされます。このファイルを変更した場合、新しいcurrencies.xmlに変更内容を再入力する必要があります。

カスタマイズしたサブジェクト領域の列の通貨を指定するには、次の手順を実行します。

1. アンサーで、サブジェクト・エリアを使用する分析を変更します。

2. 「分析」エディタの「基準」タブで、通貨列の「オプション」ボタンをクリックし、「列のプロパティ」を選択して「列のプロパティ」ダイアログを表示します。

3. 「データ書式」タブをクリックし、「デフォルトのデータ書式のオーバーライド」ボックスを選択します。

4. 「数値の取扱い」ボックスで、「通貨」を選択します。

5. 「通貨記号」リストで、「ユーザーの優先通貨」を選択します。

6. タブ内の他のオプションを適切に指定します。

7. 必要に応じて、この設定をシステム全体のデフォルトとして保存します。

8. 完了したら「OK」をクリックし、変更する他の列について前述の手順を繰り返します。

ユーザーの優先通貨オプションを定義する場合、次を考慮してください。

- すべてのユーザーに対するデフォルトを作成する場合、CURRENCYTAG要素をINIT BLOCKを使用して設定します。

- ユーザーの優先通貨を構成する場合、PREFERRED_CURRENCY要素をINIT BLOCKを使用して設定します。
「ユーザーの優先通貨オプションの定義」を参照してください。

INIT BLOCKの詳細は、『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ・ビルダーズ・ガイド』の初期化ブロックの操作に関する項を参照してください。

ユーザーの優先通貨オプションの定義

分析およびダッシュボードの通貨列に優先して表示する通貨のタイプを選択できます。

2つの方法のいずれかを使用して、通貨のタイプを選択します。

- 「マイ・アカウント」ダイアログの「プリファレンス」タブの「通貨」ボックス

- 通貨プロンプト

「マイ・アカウント」ダイアログの「プリファレンス」タブでの優先通貨の設定、または通貨プロンプトの詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

「通貨」ボックスや通貨プロンプトに表示する通貨オプションは、userpref_currencies.xmlファイルで定義します(ご使用のインストレーションでは列を通貨に変換できますが、これらの通貨オプションは、その変換先の通貨用のオプションです)。通貨オプションを定義することで、「マイ・アカウント」ダイアログの「プリファレンス」タブで「通貨」ボックスを使用できるかどうか、および「プロンプト」エディタの「定義」ペインで「通貨プロンプト」オプションを使用できるかどうかも制御されます。

これらの通貨オプションを定義する場合は、次のいずれかのマッピング・タイプを使用します。

- 静的 - すべてのユーザーに表示される通貨オプションの静的リストを作成します。

- 動的 - 指定する論理SQL文に基づいて動的に変更される通貨オプションのリストを作成します。これは、たとえば通貨オプションを動的に変更して、各ユーザーに自身のアカウント固有のリストを表示させる場合に便利です。各ユーザーには、使用できるすべてのオプションのサブセットが表示されます。たとえば、あるユーザー・グループには「Global Currency 1」または「Global Currency 2」のいずれかからのみ通貨を選択させ、他のグループには別の異なるオプションから通貨を選択させることができます。

注意:

ユーザーの優先通貨オプションを有効にするには、Oracle Business Intelligenceリポジトリで次の構成も実行する必要があります。

- PREFERRED_CURRENCYセッション変数の作成。

- ビジネス・モデルおよびマッピング・レイヤーでの論理通貨列の変換設定。

- インストレーションの通貨情報を使用したuserCurrencyPreference表の作成。これにより、指定する論理SQL文に基づいて通貨オプションを動的に変更できます(動的マッピングを使用する場合にのみ必要)。

『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』の複数通貨サポートの論理列の構成に関する項を参照してください。

ユーザーの優先通貨のコンテンツは、PREFERRED_CURRENCYセッション変数を使用して設定できます。次のファイルのいずれかでUserCurrencyPreferences要素を定義します。

- 次のinstanceconfig.xmlファイルまたはuserpref_currencies.xmlファイル。
BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

- yourfilename。instanceconfig.xmlファイルに含まれるエントリが含まれ、使用するファイルを指しています。次に例を示します。

<UserprefCurrenciesConfigFile>yourpath</UserprefCurrenciesConfigFile>

ここで、yourpathはファイルの場所です。

静的マッピングを使用したユーザーの優先通貨オプションの定義

マッピングを使用して、通貨の選択時にすべてのユーザーに表示するオプションの静的リストを定義できます。

1. テキスト・エディタを使用して、次のディレクトリにあるuserpref_currencies.xmlファイルを開きます。
BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次のようにUserCurrencyPreferences要素を追加します。

<UserCurrencyPreferences currencyTagMappingType="static">

</UserCurrencyPreferences>

3. 「通貨」ボックスまたは通貨プロンプトに各通貨オプションが表示されるようにするには、次のフォーマットを使用して、<UserCurrencyPreferences>タグの間にUserCurrencyPreference要素を追加します。

<UserCurrencyPreference sessionVarValue="sessionVarValuevalue" displayMessage="displayMessagevalue" displayText="displayTextvalue" currencyTag="currencyTagvalue"/>

この形式の詳細は次のとおりです。

- sessionVarValue="sessionVarValue ": セッション変数PREFERRED_CURRENCYを設定します。この値として、通貨を一意に識別する文字列を指定します(gc1など)。

- (オプション)displayMessage="displayMessagevalue": プレゼンテーション変数currency.userPreferenceをローカライズされた値に設定します。ローカライズされた値を指定するには、最初に、通貨のローカライズ済メッセージをusercurrencymessages.xmlファイルで作成する必要があります。詳細は、「ユーザーの優先通貨のメッセージのローカライズ」を参照してください。次に、displayMessageの値として、usercurrencymessages.xmlファイルで通貨用に指定しているWebMessage名を指定します。たとえば、usercurrencymessages.xmlファイルで次の英語エントリを作成します。

<WebMessage name="kmsgMyCurrency1"><TEXT>My Currency 1</TEXT></WebMessage>

次に、displayMessageの値としてkmsgMyCurrency1を指定します。

- (オプション)displayText="displayTextvalue": プレゼンテーション変数currency.userPreferenceをローカライズされていない値に設定します。値として、Global Currency 2など、通貨を示す文字列を指定します。
currency.userPreference変数の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

- currencyTag="currencyTagvalue": 「マイ・アカウント」ダイアログの「プリファレンス」タブの「通貨」ボックスおよび通貨プロンプトに移入するdisplayMessage値を含む、currencies.xmlファイルの通貨タグを識別します(currencies.xmlファイルは、ORACLE_HOME/bi/bifoundation/web/displayにあり、通貨フォーマットを提供します)。

注意:

currency.userPreference変数の値は、次の優先順位で、UserCurrencyPreference要素のdisplayMessage属性およびdisplayText属性から取得されます。

a. displayText

b. displayMessage

displayTextおよびdisplayMessageの値が存在しない場合は、currencies.xmlファイルの対応する通貨タグのdisplayMessage属性の値が使用されます。

4. userpref_currencies.xmlファイルを保存して閉じます。

5. Oracle Business Intelligenceを再起動します。

例: ユーザーの優先通貨オプションを定義する静的マッピング

次の例は、静的マッピングを使用してユーザーの優先通貨オプションを定義するuserpref_currencies.xmlファイルを示しています。

<UserCurrencyPreferences currencyTagMappingType="static">
<UserCurrencyPreference sessionVarValue="gc1" displayText="Global Currency 1" currencyTag="int:USD" />
<UserCurrencyPreference sessionVarValue="gc2" displayText="Global Currency 2" currencyTag="int:euro-l" />
<UserCurrencyPreference sessionVarValue="gc3" displayText="Global Currency 3" currencyTag="loc:ja-JP" />
<UserCurrencyPreference sessionVarValue="orgc" displayText="Org Currency" currencyTag="loc:en-BZ" />
</UserCurrencyPreferences>

次の図は、userpref_currencies.xmlファイルのこれらの値が、ダッシュボード・ページに表示されるプロンプトの通貨オプションのドロップダウン・リストでどのように表示されるかを示しています。このドロップダウン・リストは、「マイ・アカウント」ダイアログの「プリファレンス」タブの「通貨」ボックスに表示される内容と似ています。

動的マッピングを使用したユーザーの優先通貨オプションの定義

マッピングを使用して、通貨の選択時にユーザーに表示されるオプションの動的リストを定義できます。

このリストは、指定する論理SQL文に基づいて動的に変更されます。これは、たとえば、ユーザーごとに通貨オプションを動的に変更する場合に便利です。

1. テキスト・エディタを使用して、次のディレクトリにあるuserpref_currencies.xmlファイルを開きます。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次のようにUserCurrencyPreferences要素を追加します。

<UserCurrencyPreferences currencyTagMappingType="dynamic">

</UserCurrencyPreferences>

3. 次のフォーマットを使用して、<UserCurrencyPreferences>タグの間にUserPrefCurrencyLogicalSQL要素を追加します。

<UserPrefCurrencyLogicalSQL>
SELECT column1, column2, column3 FROM userCurrencyPreference
</UserPrefCurrencyLogicalSQL>

この形式の詳細は次のとおりです。

- column1には、セッション変数PREFERRED_CURRENCYを設定するために使用する値を含めます。この列の各値は、一意に通貨を識別する文字列です(gc1など)。

- column2には、たとえばint:euro-1など、「通貨」ボックスおよび通貨プロンプトに移入するdisplayMessage値を含む、currencies.xmlファイルの通貨タグを含めます(currencies.xmlファイルは、ORACLE_HOME/bi/bifoundation/web/displayにあり、通貨フォーマットを提供します)。

- (オプション)column3には、プレゼンテーション変数currency.userPreferenceを設定するために使用する値を含めます。この列の各値は、Global Currency 2など、通貨を識別する文字列です。

注意:

column3を省略した場合、currencies.xmlファイルの対応する通貨タグのdisplayMessage属性の値が使用されます。

currency.userPreference変数の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

4. userpref_currencies.xmlファイルを保存して閉じます。

5. Oracle Business Intelligenceを再起動します。

例: ユーザーの優先通貨オプションを定義する動的マッピング

次の例は、動的マッピングを使用してユーザーの優先通貨オプションを定義するuserpref_currencies.xmlファイルを示しています。

<UserCurrencyPreferences currencyTagMappingType="dynamic">
UserPrefCurrencyLogicalSQL>
<!-- In this SELECT statement, column1 contains the values to set the PREFERRED_CURRENCY variable, column2 contains the currency tag values, and column3 contains the values to set the currency.userPreference variable. -->
SELECT markets.userpreferences, markets.currencyTag, markets.userpreferencename FROM userCurrencyPreference
</UserPrefCurrencyLogicalSQL>
</UserCurrencyPreferences>

次の表は、論理SQL文の結果の例を示しています。

"Markets"."UserPreference"

"Markets"."CurrencyTag"

"Markets"."UserPreferenceName"

varchar

varchar

varchar

orgc1

loc:en-BZ

Org currency

gc2

int:euro-1

Global currency 2

lc1

int:DEM

Ledger currency

gc1

int:USD

Global Currency 1

次の図は、userpref_currencies.xmlファイルのSQL文から動的に生成された値が、「マイ・アカウント」ダイアログの「プリファレンス」タブにある「通貨」ボックスの通貨オプションのドロップダウン・リストにどのように表示されるかを示しています。このドロップダウン・リストは、ダッシュボード・ページのプロンプトで表示される内容に似ています。

16 Oracle BIプレゼンテーション・カタログの構成と管理

この章では、Oracle BIプレゼンテーション・カタログの構成方法および管理方法について説明するとともに、基本的なメンテナンス手順と全文検索のための構成について情報を提供します。

この章の内容は次のとおりです。

- Oracle BIプレゼンテーション・カタログについて

- Oracle BI Presentation Catalogのメンテナンス

- カタログ・マネージャについて

- カタログ・マネージャの起動とカタログのオープン

- カタログ・マネージャの作業領域の使用方法

- カタログ・マネージャでのオブジェクトの使用

- XMLでのカタログ・オブジェクトの表示と編集

- カタログ・マネージャを使用したカタログ・テキストの検索と置換

- カタログ・マネージャを使用したカタログ・データを表示するためのレポートの作成

- カタログ・マネージャを使用したアーカイブとアンアーカイブ

Oracle BIプレゼンテーション・カタログについて

Oracle BIプレゼンテーション・カタログは、ユーザーが、個々のファイルからなるディレクトリ構造内に作成したコンテンツを格納します。

このコンテンツには、フォルダ、ショートカット、Oracle BI EEオブジェクト(分析、フィルタ、プロンプト、ダッシュボードなど)およびOracle BI Publisherオブジェクト(レポート、テンプレートなど)が含まれます。

この項では、次の項目について説明します。

- カタログ内のオブジェクト

- カタログのファイル・システムのガイドライン

カタログ内のオブジェクト

次の図は、プレゼンテーション・サービスで表示されるカタログ内のサンプル・オブジェクトを示しています。

オブジェクト名のガイドライン

カタログ内の各オブジェクトは、独自のファイルに格納されます。たとえば、Analysis 1という分析はAnalysis1という名前のファイルに格納されます。ユーザーに表示されるオブジェクト名(Analysis 1など)は、論理オブジェクト名と呼ばれます。

オブジェクト名のガイドラインは次のとおりです。

- カタログ内のオブジェクトの論理名には、有効なUnicode文字であれば、どの文字でも使用できます。次のものは有効な論理名です。

Hello World
Profit / Loss
% Sales * $ Cost ~~ $ "Expense"?

- 論理オブジェクト名の長さは、256 Unicode文字以内にしてください。

- オブジェクトの論理パス名の長さは、16,000 Unicode文字以内にしてください。

- オブジェクトの論理パス名のディレクトリ・セグメントの数は、255セグメント以内にしてください。
たとえば、/n1/n2/n3/n4/…./n253/n254/n255などの名前を持つディレクトリは有効ですが、/n1/n2/n3/n4/…./n254/n255/n256などの名前は無効です。

- SOAPを使用してオブジェクトのパス名を渡す場合は、次に示す文字をエスケープする必要があります。

Forward slash (/)
Backward slash (\)
Tilde (~)
Asterisk (*)
Question mark (?)

次に示す論理パス名はすべて有効です。

/shared/test/Hello World
/shared/test/Profit \/ Loss
/shared/test/% Sales \* $ Cost \~\~ $ "Expense"\?

カタログ・パスを作成する際は十分に注意してください。一般的に、コードではスラッシュ(/)は常にパス・セパレータとみなされます。パス・コードに「Profit / Loss」などのオブジェクト名が含まれていないか常に確認してください。

- SOAPを使用してカタログ検索フィルタを渡す場合は、次に示す文字をエスケープする必要があります。

Forward slash (/)
Backward slash (\)
Tilde (~)
Asterisk (*)
Question mark (?)
Caret (^)
Dollar sign (?)

次に示す検索フィルタはすべて有効です。

Hello World
Profit \/ Loss
% Sales \* \$ Cost \~\~ \$ "Expense"\?

オブジェクトの属性ファイル

各オブジェクトには、対応する属性ファイルがあります。たとえば、Analysis1という分析であれば、Analysis1.atrという名前の対応する属性ファイルがあります。属性ファイルには、オブジェクトの完全な名前、アクセス制御リスト(ACL)、説明などが含まれます。カタログ内のオブジェクトにアクセスするには、ユーザーはそのオブジェクトに適したACLエントリを持っている必要があります。カタログ内のすべてのオブジェクトがACLエントリを使用します。

オブジェクトのロック・ファイル

一度に1人のユーザーのみがファイルに書き込めるようにするため、オブジェクトに書き込んでいるときにロック・ファイルが作成されます。まれに(停電の後など)、カタログ内の一時ロック・ファイルが完全に削除されないことがあります。プレゼンテーション・サービスによってそのようなロック・ファイルが検出された場合は、それを手動で削除する必要があります。

カタログのファイル・システムのガイドライン

この項では、ファイル・システム内でカタログのオブジェクトを使用するためのガイドラインについて説明します。

カタログのユーザーの処理

カタログは、数千の同時ユーザーにスケーリングするように設計されています。このスケーリングを実現するために、カタログは次のガイドラインに従います。

- 平均的なユーザーは、一般的にカタログから読み取るのみであり、書き込むことはほとんどありません。各ユーザーは定期的および自動的にそのユーザーの最近使用したファイルを更新していますが、各ユーザーの読取り操作は、そのユーザーの書込み操作よりもはるかに多くなっています。したがって、読取りと書込みの比率は、通常、少なくとも100対1です。

- ロック・メカニズムによって、オブジェクトに書き込めるユーザーは一度に1人のみであることが保証されていますが、まれに、複数のユーザーが同じオブジェクトに同時に書込みを試みることがあります。遅延ロックと呼ばれる機能によって、ユーザーは、別のユーザーがオブジェクトを更新しているときでも、そのオブジェクトの読取りを続行できます。

- 最新のファイル・システムでは、小さいファイルはディレクトリ・レコード内に直接キャッシュされるため、ディレクトリ上の情報を読み取ると同時に、すべての小さいファイルがオペレーティング・システムのメモリー・キャッシュに直接ロードされます。したがって、カタログ内のファイル、特に頻繁に読み取られる.atrメタデータ・ファイルは小さくしておくことをお薦めします。これらのメタデータ・ファイルを小さいまま保持すると、ディレクトリ内のすべての.atrファイルが一度の物理ハード・ディスクの読取りでメモリーにロードされます。「小さい」しきい値を超えるすべてのファイルで、ファイルごとに追加の物理ハード・ディスク読取りが実行され、それにより、大きいファイルごとに100%の劣化が発生することがあります。したがって、.atrファイルに任意のプロパティを格納することを検討している場合は注意してください。

- NFSによるオブジェクトの.atrメタデータ・ファイルの読取りは、ローカル・ディスクからの直接読取りよりもはるかに遅くなります。そのため、プレゼンテーション・サービスはすべての.atrファイルを追加で内部にキャッシュします。クラスタ内の別のノードが、現在のノードがキャッシュしたデータよりも新しいデータをファイルに書き込む場合、このキャッシュは短期間で古くなる可能性があります。そのため、すべてのノードは、instanceconfig.xmlのMaxAgeMinutes要素(クラスタに対するデフォルトは5分)に従ってリフレッシュされます。このデフォルト設定は、データが古くなる可能性とパフォーマンスに関する既知の影響の間で、一般的に最良の妥協点になります。(クラスタなしの環境のデフォルトは、60分です。)
MaxAgeMinutes要素はシステムに合せて変更できます。その親要素はCacheとCatalogAttributesです。

異機種ノードの処理

1つのクラスタ内での異機種ノードの使用を可能にするために、カタログは次のガイドラインに従います。

- ディスク上のオブジェクトの名前の長さは最大で256バイト(64 Unicode文字)です。論理名は、256 Unicode文字に制限されています。この制限に従うために、32文字よりも大きい論理名はハッシュされます。

- ディスク上のパスの名前の長さは最大で32KB (8,000 Unicode文字)です。論理パスは、16,000 Unicode文字までに制限されています。

- ディスク上のすべてのパス名は、すべて小文字です。論理パス名では、大文字小文字は組み合せて使用できますが区別はされません。

- ディスク上のパス名には特定の文字を使用できませんが、論理パス名にはすべての文字を使用できます。たとえば、Windowsシステムでは、コロン(:)などの特定の文字列は使用できません。そのため、それらの文字は標準HTMLエスケープ・シーケンスを使用してマッピングされます。たとえば、ピリオド文字(.)は%2eになります。

- ディスク上では特定のファイル名を使用できませんが、論理オブジェクト名には制限はありません。たとえば、Windowsシステムでは、COMなどの特定のファイル名は使用できません。そのため、それらの名前は標準HTMLエスケープ・シーケンスを使用してマッピングされます。たとえば、comはco%6dになります。

様々なプラットフォーム上のカタログ・ファイルの処理

様々なプラットフォーム上のカタログ・ファイルを処理するときは、次の点に注意してください。

- UNIXプラットフォームの場合: UNIXカーネルは、通常、ディレクトリごとに4,000を超えるサブディレクトリを配置可能にするように構成する必要があります。HashUserHomeDirectories要素の詳細は、「カタログの構成設定の手動による変更」を参照してください。

- Windowsプラットフォームの場合:
ユーザーがMicrosoft Windowsエクスプローラなどのツールを使用してカタログ・ファイルをナビゲートする場合、c:/obi/demoなどの短いパス名に基づいたカタログ構造が好まれます。長いデフォルト・パス名は好まれず、そのようなナビゲーションはお薦めできません。

- FATはサポートされておらず、NTFSが必須です。

- Windowsプラットフォーム上のパフォーマンスは、1つのディレクトリに8,000個を超えるファイルが存在すると著しく低下します。各カタログ・オブジェクトには2つのファイル(データ・ファイルと.atrメタデータ・ファイル)があるため、1つのディレクトリ内に格納するカタログ・オブジェクトは4,000個以内にすることを強くお薦めします。

- Windowsエクスプローラでは、長いパス名は適切に処理されないため、カタログの内部構造のナビゲートにはWindowsエクスプローラを使用しないことをお薦めします。ファイル・システムは32KBまでのパス名を処理でき、プレゼンテーション・サービスに悪影響を及ぼすことはありませんが、Windowsエクスプローラは約2KBを超えるパス名では使用できません。
1つのUnicode文字に4バイト必要な場合があるため、わずか500個のUnicode文字からなるパス名でもWindowsエクスプローラを使用できないことがあります。この制限によって、プレゼンテーション・サービスが影響を受けることはありません。この制限のため、カタログはc:\mycatalog\salesなどのように最上位レベルのディレクトリに配置してください。

カタログ・ファイルの既知の問題

カタログ・ファイルを使用する際の既知の問題は次のとおりです。

- NFSシステム全体のロックは困難ですが、プレゼンテーション・サービスは最新のバージョンで効果的なロック・メカニズムを提供しています。必要に応じて、該当するパッチを入手し、旧バージョンのOracle BI EEを更新してください。
「カタログの検証」を参照してください。

- サードパーティの各種FTPプログラムでは、%エスケープ・シーケンスの処理に問題があり、二重にエスケープされたファイル名に変更されることがよくあります。たとえば、sa%2epaint(論理名はSA.Paint)という名前のファイルは、誤ってsa%252epaint(論理名はSA%2ePaint)に変更されます。
カタログに対してFTPプログラムを直接使用しないでください。かわりに、7-Zipユーティリティをダウンロードして使用し、カタログ・ファイルを圧縮して、その圧縮済ファイルをFTPプログラムを使用して転送します。

Oracle BI Presentation Catalogのメンテナンス

カタログの保守に関する情報については、次のトピックを参照してください。

- カタログの構成設定の手動による変更

- 本番環境へのカタログとオブジェクトのデプロイ

- カタログ・オブジェクトの更新

- カタログの検証

カタログの構成設定の手動による変更

これらの設定を変更するには、instanceconfig.xmlファイルの様々な要素を使用して手動で設定を変更します。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の要素を追加する必要があるCatalogセクションをみつけます。

- HashUserHomeDirectories: ディレクトリのハッシングを指定します。カタログ・ユーザーが4,000を超える場合、または将来、超える予定がある場合は、ユーザーのホーム・ディレクトリのハッシングをオンにして、ファイル・システムの制限に対処してください。それには、HashUserHomeDirectories要素をそのデフォルト値の0から2に設定します。この要素をオンにすると、たとえば、Steveというユーザーのデフォルトのホーム・ディレクトリは/users/st/steveになります。

注意:

以下の点に注意します。

- ハッシングは、最新のファイル・システム(たとえば、ext4、ZFS、ntfsなど)を使用する最新のオペレーティング・システムには通常必要ありません。ただし、ユーザー・ベースが約4,000人のユーザーを超える場合のパフォーマンスに引き続き役立つ可能性があります。

- 作成時にカタログをハッシュすることをお薦めしますが、使用中にカタログのハッシュが必要になる場合があります。バックアップし、詳細は次のコマンドを実行します。
UNIXの場合:

runcat.sh -cmd rehash -help

Windowsの場合:

runcat.cmd -cmd rehash -help

- 通常は、HashUserHomeDirectories要素を2より大きい値に設定しないでください。2より大きい値に設定すると、ハッシングが無効になります。

- instanceconfig.xmlに含めるCatalog要素は1つのみにします。そうしないと、予期しない結果になることがあります。明記されていないかぎり、ほとんどのノードはXMLドキュメントに一度のみ含めます。

3. 必要に応じて、次の例に示すように、要素とその祖先の要素を含めます。

<ServerInstance>
<Catalog>
<HashUserHomeDirectories>2</HashUserHomeDirectories>
</Catalog>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. プレゼンテーション・サービスを再起動します。

本番環境へのカタログとオブジェクトのデプロイ

次の各項の説明に従って、テスト環境から本番環境にカタログおよびシンプル・オブジェクト(権限付きダッシュボードなど)をデプロイできます。

- 本番環境へのカタログのデプロイ

- 本番環境へのオブジェクトのデプロイ

本番環境へのカタログのデプロイ

BARファイルを使用して、カタログを本番環境にデプロイします。

「環境間のOracle Business Intelligenceの移動」を参照してください。

本番環境へのオブジェクトのデプロイ

テスト環境から本番環境にオブジェクト(権限付きダッシュボードなど)をデプロイできます。

1. (オプション)新しい本番環境にカタログ・オブジェクトをデプロイする場合。
次のようにして、テスト環境でカタログ・オブジェクトをアーカイブし、それを本番環境でアンアーカイブします。

a. 次のいずれかを使用して、テスト環境のカタログ・オブジェクトをアーカイブします。

- Oracle BIプレゼンテーション・サービス

- カタログ・マネージャ
「カタログ・マネージャを使用したアーカイブとアンアーカイブ」を参照してください。

b. アーカイブ済ファイルを本番コンピュータにコピーします。

c. 本番コンピュータで、オブジェクトをアンアーカイブします。
オブジェクトのアンアーカイブ方法の詳細は、「カタログ・マネージャを使用したアーカイブとアンアーカイブ」を参照してください。

d. 必要に応じて、オブジェクトに権限を設定します。

2. (オプション)既存の本番環境にカタログをデプロイする場合。
次のように、新規または更新されたオブジェクトをテスト・カタログから本番カタログにコピーして貼り付けます。

a. 2つのカタログ・マネージャ・ウィンドウ(一方はテスト・カタログ、他方は本番カタログ)を開きます。

b. 必要なフォルダをテスト・カタログから選択してコピーし、本番カタログに貼り付けます。
テスト環境または本番環境で同じコンテンツを変更済のフォルダをコピーして貼り付けると、テスト環境のコンテンツによって本番環境のコンテンツが上書きされます。

カタログ・オブジェクトの更新

より新しいバージョンのOracle Business Intelligenceにアップグレードするかパッチをインストールして、カタログでオブジェクトを使用すると、特定のオブジェクトへのアクセスが以前のリリースのように高速に実行されないことがあります。

この変化は、オブジェクトが正しくアップグレードされていない場合に発生する可能性があります。更新が必要かどうかは、Fusion Middleware Controlでメトリックを表示することによって確認できます。「カタログ」フォルダで、アップグレードが必要であることを示すオブジェクトの数という説明の付いた要アップグレードというメトリックを見つけます。この数が大きい場合は、プレゼンテーション・サービスの「管理」ページを使用してカタログ内のオブジェクトを更新することにより、この問題を解決できます。

Oracle Business Intelligenceアップグレード・ガイドの手順に従うことで、Oracle Business Intelligenceの新しいバージョンにアップグレードできます。カタログ・オブジェクトをアップグレードするには、Oracle Business Intelligenceアップグレード・ガイドのタスク5: Oracle BIリポジトリおよびカタログのアップグレードに関する項を参照してください。プレゼンテーション・サービスが実行されていないときにアップグレードすることをお薦めします。アップグレード・プロセス中にオブジェクトのアップグレードが完全には実行されなかったことが疑われる場合は、「管理」ページを使用して、自分でオブジェクトを更新できます。この方法の利点は、プレゼンテーション・サービスを実行したまま更新を行えることにあります。

オブジェクトの更新を準備する際は、次の点に留意してください。

- クラスタ内でマシンのローリング・アップグレードを実行している場合は、クラスタ内のすべてのマシンがアップグレードされるまで、このオプションやUpgradeAndExit構成設定は使用しないでください。

- このオプションは、一度にクラスタ内の1つのノードでのみ使用します。

1. グローバル・ヘッダーで「管理」をクリックします。

2. 「更新が必要なカタログ・オブジェクトのスキャンおよび更新」リンクをクリックします。

3. 「カタログ・オブジェクトの更新」をクリックして更新プロセスを開始します。

どのオブジェクトが更新され、どのオブジェクトが更新されていないのかを確認するには、このページの他のリンクをクリックします。更新されなかったオブジェクトの詳細に関するログ・ファイルを参照できます。

カタログの検証

カタログは保守が必要となる動的なコンポーネントです。

時間の経過とともに、リンクが破損する、ユーザーが削除される、NFSファイル・システムの問題が発生するなどカタログ内に非一貫性が発生することがあります。これらの非一貫性は、最終的にエージェントの受信者リストを編集できなくなるなど、不適切な動作につながることがあります。本番システムを定期的にオフラインにしてカタログを検証し、非一貫性を検出して、修正操作を実行できます。

この項では、カタログの検証に関する次の項目について説明します。

- プロセス: カタログの検証

- 検証プロセスのタスク

- カタログ検証の重要なガイドライン

- 基本的なカタログ検証の実行

- カタログを検証するための要素の指定

プロセス: カタログの検証

カタログの検証プロセスには、オフライン・モードでのカタログのレポートの作成や、調整または削除が必要なオブジェクトの確認があります。

一部のオブジェクトは、オフライン・モードで手動で修正できます。その後、検証操作を再度実行して、不要なオブジェクトを削除することによりシステムを「クリーン」にできます。カタログの検証が終了するまで、レポートの作成、エラーの手動修正およびカタログのクリーンを繰り返します。

検証プロセスのタスク

システムを検証すると、プロセスが円滑に実行されていることを確認できます。

検証プロセスでは、次のタスクを実行します。

- カタログ内の各オブジェクトが0バイトよりも大きいことを確認します。

- カタログ内の各項目に、対応する有効な.atrファイルがあることを確認します。

- カタログ内の各リンクが有効であることを確認します。

- アカウント・キャッシュ内のファイルが有効であることを確認します。

- カタログ内のすべてのXMLオブジェクトがスキーマ検証に通ることを確認します。

- ftpプログラムによって損傷したオブジェクト名の修復を試みます。

カタログ検証の重要なガイドライン

カタログを検証する前に、特定のガイドラインに留意してください。

- 開発環境に本番環境とは異なるセキュリティ・ストアがある場合は、開発環境でカタログを検証する際に注意する必要があります。異なるセキュリティ・ストアを使用して検証を実行すると、多くのアカウントがカタログから削除される可能性があります。

- カタログの検証をオンにすると、すべてのACL (つまり、すべての権限と各項目の権限)が「スクラブ」されます。これは、それらからデッド・アカウントが削除され、変更されたすべての項目がディスクに書き込まれることを意味します。そのため、破損した項目を自動的に修正せずに単にレポートを作成するだけであっても、カタログが広範囲に「変更」されることがあります。

- クラスタ環境でカタログを検証する前に、次のいずれかを実行します。

- プレゼンテーション・サービス・クラスタを停止し、そのクラスタのカタログに対して検証を直接実行します。

- クラスタのカタログのコピーを作成し、そのコピーに対して検証を実行します。
7-Zipユーティリティを使用してカタログのコピーを作成する前に、プレゼンテーション・サービス・クラスタのすべてのノードを停止するか、そのクラスタのすべてのノードをメンテナンス・モードにします(推奨方法)。

検証プロセスと同時にオンラインでカタログに行った変更は、検証には含まれません。

カタログのバックアップが常に推奨されていますが、検証をカタログに対して直接実行することと、バックアップ・コピーに対して実行することの実際的な違いはありません。

基本的なカタログ検証の実行

カタログの基本的な検証は、非定型ベースで必要に応じて、コンテンツを開発環境から本番環境に移行する直前や、定期的(たとえば、毎月第1火曜日など)に実行できます。

1. プレゼンテーション・サービスを停止します。

「Fusion Middleware Controlを使用したBIシステム・コンポーネント・プロセスの起動および停止」を参照してください。

2. 7-Zipユーティリティを使用してカタログをバックアップし、その圧縮済ファイルを作成します。

3. 次のinstanceconfig.xmlファイルのバックアップ・コピーを作成します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

4. instanceconfig.xmlファイルを編集し、検証を実行するために適した要素が含まれるようにします。レポートの作成およびカタログの「クリーニング」のタスクを適宜実行するための要素を設定する必要があります。

「カタログを検証するための要素の指定」を参照してください。

5. プレゼンテーション・サービスを起動し、instanceconfig.xmlファイルに指定した値に従って検証を実行します。

6. instanceconfig.xmlファイルを再度編集し、検証を実行するために適した要素が含まれるようにします。レポートの作成およびカタログの「クリーニング」のタスクを適宜実行するための要素を設定する必要があります。

7. カタログが検証されるまで、ステップ5 - 7を繰り返します。

8. プレゼンテーション・サービスを停止します。

9. 検証要素を追加したinstanceconfig.xmlファイルのバックアップ・コピーを作成し、そのファイルの名前をinstanceconfig_validate.xmlのような名前に変更します。このようにして、後続の検証の出発点として使用するファイルのバージョンを用意します。

10. 現行バージョンとして使用するために前に作成したinstanceconfig.xmlのバックアップ・バージョンをリストアします。

11. プレゼンテーション・サービスを起動します。

カタログを検証するための要素の指定

カタログ検証手順の一部として、プレゼンテーション・サービスを再起動するときに検証を実行する要素をinstanceconfig.xmlファイルに含めます。

次の手順は、instanceconfig.xmlファイルを編集してこれらの要素を含める方法を示しています。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の要素を追加する必要がある「カタログ」セクションを見つけます。

要素

説明

デフォルト値

Validate

このセクションの他のValidate関連の要素の値に従ってカタログの検証を実行します。値は次のとおりです。

- None - 検証は実行しません。

- OnStartupAndExit - プレゼンテーション・サービスを起動したときに検証を実行し、Report操作またClean操作を実行してから、プレゼンテーション・サービスを停止します。カタログが検証されるまで、(ValidateAccounts、ValidateHomes、ValidateItemsおよびValidateLinksなどの)要素ごとにReport、Clean、Reportのサイクルを複数回実行できます。

この値がNoneではない場合は、他のValidate関連要素の設定に関係なく、終了したアカウントから、カタログ全体におけるすべての権限と各オブジェクトのACLが消去されます。

なし

ValidateAccounts

カタログ内のユーザー、ロール、およびグループに関するすべての情報に一貫性があることを検証します。値の説明は、この表の後に記載してあります。

なし

ValidateHomes

カタログ内のホーム・ディレクトリに関するすべての情報に一貫性があることを検証します。値の説明は、この表の後に記載してあります。

ValidateHomesは、ValidateAccountsがReportまたはCleanのどちらかに設定されている場合にのみ実行されます。

なし

ValidateItems

カタログ内のオブジェクトに関するすべての情報に一貫性があることを検証します。値の説明は、この表の後に記載してあります。

なし

ValidateLinks

カタログのショートカットをクリーンにしますが、オブジェクトに対する内部参照は調整しません。たとえば、ダッシュボード・ページにテキスト「/shared/sales/myfavreportの実行後、ここに結果を表示します」が表示されているとします。その後、ユーザーがmyfavreportオブジェクトを削除しても、検証時には修正やメッセージは表示されません。値の説明は、この表の後に記載してあります。

なし

要素には、次のリストに示す値が設定されます。

- None - 検証を実行しないことを指定します。

- Report - 一貫性のないオブジェクトそれぞれの詳細をsawlog.logファイルに書き込むことを指定します。
「診断ログ構成ファイルの概要とその位置」を参照してください。

- Clean - 一貫性のないオブジェクトそれぞれの詳細をsawlog.logファイルに書き込み、各オブジェクトをカタログから削除することを指定します。

3. 次の例に示すように、必要に応じて要素およびそれらの祖先要素を含めます。この例では、検証はプレゼンテーション・サービスが起動されたときに実行され、検証が完了するとプレゼンテーション・サービスは終了します。一貫性のないアカウント(削除されたユーザーのものなど)、リンク、およびオブジェクトが削除されます。一貫性のないユーザーのホーム・ディレクトリ名は記録されますが、ディレクトリが削除されることはありません。

<ServerInstance>
<Catalog>
<Validate>OnStartupAndExit</Validate>
<ValidateAccounts>Clean</ValidateAccounts>
<ValidateHomes>Report</ValidateHomes>
<ValidateItems>Clean</ValidateItems>
<ValidateLinks>Clean</ValidateLinks>
</Catalog>
</ServerInstance>

注意:
instanceconfig.xmlに含めるCatalog要素は1つのみにします。そうしないと、予期しない結果になることがあります。明記されていないかぎり、ほとんどのノード(Catalog要素のノードなど)はXMLドキュメントに一度のみ含めます。

4. 変更内容を保存し、ファイルを閉じます。

カタログ・マネージャについて

カタログ・マネージャは、Oracle BIプレゼンテーション・カタログのオンラインおよびオフラインでの管理を可能にするツールです。カタログ・マネージャは、Oracle BI管理者のみがアクセスできるセキュアなコンピュータにインストールします。

カタログ・マネージャの用途

カタログ・マネージャを使用して実行できることは次のとおりです。

- フォルダ、ショートカット、グローバル変数およびオブジェクト(分析、フィルタ、プロンプト、ダッシュボードなど)の管理。たとえば、オブジェクトの名前変更や削除を実行したり、カタログ内およびカタログ間でオブジェクトを移動およびコピーできます。

- eXtensible Markup Language(XML)でのカタログ・オブジェクトの表示および編集。

- 分析やプロンプトなどのオブジェクトのプレビュー。

- カタログ・テキストの検索および置換。

- カタログ・オブジェクトの検索。

- カタログ・データを表示するための分析の作成。

- キャプションのローカライズ。「Oracle BIプレゼンテーション・カタログのキャプションのローカライズ」を参照してください。

カタログ・マネージャで行う操作の多くは、Oracle BIプレゼンテーション・サービスの「カタログ」ページでも実行できます。『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のOracle BIプレゼンテーション・カタログのオブジェクトの管理に関する項を参照してください。

カタログ・マネージャの使用のガイドライン

カタログ・マネージャを使用する場合は、次のガイドラインに従ってください。

- 使用しているOracle BIプレゼンテーション・カタログのバックアップ・コピーを常に作成します。

- 実行しようとしている変更を確認します。カタログ・マネージャでは変更はただちにコミットされます。元に戻す機能はなく、特定の変更がユーザーに適切に表示されないことを示すエラー・メッセージも表示されません。ただし、意図しない変更を行った場合は、最新の保存済バックアップまで戻すことができます。

- カタログ・コンテンツをコピーして電子メールに貼り付けないでください。これはサポートされていません。

カタログ・マネージャの使用のヒント

カタログ・マネージャを使用するときは、次のヒントに注意してください。

- オンライン・モードで使用している場合、カタログ・コンテンツを読取り専用フォルダに貼り付けたり、そこから貼り付けるには、コピーする前にそのフォルダ・ツリーの読取り専用プロパティをオフにし、貼り付けた後にその読取り専用属性を再び適用します。

- カタログ・マネージャで/system/securityディレクトリからファイルをコピー、アーカイブまたはドラッグすることはできません。

- キーボード・ショートカットのなかには適切に機能しないものがあります。

- カタログ・マネージャ・ペインは、サイズ変更インジケータが表示されていなくてもサイズ変更できる場合があります。

- カタログ・マネージャは、英語以外の言語で使用できます。「Catalog Managerでの現在のロケールの設定」を参照してください。

カタログ・マネージャの起動とカタログのオープン

以下のトピックでは、カタログ・マネージャの起動およびカタログのオープンについて学習します。

この節では、以下のトピックについて説明します。

- カタログ・マネージャの実行要件

- カタログ・マネージャのユーザー・インタフェースの起動

- Linuxシステムでの起動に関する問題の解決

- 2つのカタログ・モードの理解

- オンライン・モードおよびオフライン・モードで使用可能な操作

- Oracle BI Presentation Catalogのオープン

カタログ・マネージャの実行要件

カタログ・マネージャを実行するには、次のコンポーネントを使用する必要があります。

カタログ・マネージャの実行要件を、次に示します。

- グラフィカル・ユーザー・インタフェース — 次のプラットフォーム上でグラフィカル・ユーザー・インタフェースを起動することができます。

- Windows 64ビット

- Linux 64ビット

- コマンド・ライン・ユーティリティ — Windows、Linux、IBM-AIX、Sun Solaris、HP-UXなど、Oracle Business Intelligenceでサポートされているプラットフォーム上でコマンド・ライン・ユーティリティを起動できます。Linuxでコマンド・ライン・ユーティリティの使用方法のヘルプを表示するには、次のようなコマンドを入力します。
./runcat.sh -help

カタログ・マネージャのユーザー・インタフェースの起動

カタログ・マネージャのユーザー・インタフェースは、Windowsのメニュー・オプションあるいはWindowsまたはLinuxのコマンドを使用して起動できます。

1. Windowsの「スタート」メニューから、「Oracle Business Intelligence」、カタログ・マネージャの順に選択します。

または

コマンドラインを使用して、次に示すディレクトリに変更します。

BI_DOMAIN\bitools\bin

次に示す適切なスクリプトを実行します。

runcat.cmd (Windowsの場合)

runcat.sh (Linuxの場合)

次の図は、Windowsプラットフォームの場合のカタログ・マネージャ内のサンプル・オブジェクトを示しています。

Linuxシステムでの起動に関する問題の解決

Linuxシステムでは、グラフィカル・ユーザー・インタフェースのxtermでカタログ・マネージャを起動する必要があります。

xtermの例として、ネイティブgnome、kdeコンソール、VNC、またはローカルxサーバー(Xming、Tarantella、Hummingbird Exceed、Citrixなど)があげられます。(これらの例は、認証やサポートに関する声明を構成するものではありません。)PuTTy、FSecure、またはコマンドラインSSHなどのASCIIテキスト端末を使用して、カタログ・マネージャのグラフィカル・ユーザー・インタフェースを起動することはできません。

カタログ・マネージャが起動されない場合は、次の点を確認します。

- xclockやxeyesなどのネイティブ・アプリケーションを実行できること。

- ネイティブ・コンソールまたはVNCを使用してコントロール・マネージャを起動できること。場合によって、オペレーティング・システムの管理者がX-Windowsをロックすることがあります。

- 次に示す、すべてのxterm接続を可能にするコマンドを実行できること。
xhost +

- デバッグが使用可能なコマンドラインからカタログ・マネージャを実行し、次のコマンドを使用して、追加の出力が生成されるかどうかを確認できること。
./runcat.sh -consoleLog -noExit

- straceなどのオペレーティング・システム・ユーティリティを使用して、runcat.shコマンドの実行をトレースし、ライブラリやファイルをオープンできないなどのエラー・メッセージが生成されるかどうかを確認できること。Eclipse Javaプラグインを使用できます。この場合、Standard Widget Toolkit (SWT)をインストールし、続けてGTK (Gimp Toolkit) をインストールすることが必要になります。次のコマンドを入力します。
strace -aef -o ./runcat_trace.txt runcat.sh

2つのカタログ・モードの理解

カタログは、オンラインとオフラインの2つのモードのいずれかで開くことができます。どちらのモードでも、実際の本番カタログに対して操作でき、停止時間は必要ありません。

オンライン・モード

オンライン・モードでは、稼動中のWebサーバー上のカタログに接続します。このモードでは、権限が適用され、ロケールを選択でき、カタログ上のローカライゼーションの結果を表示できます。そのユーザーが適切な権限を持つオブジェクトのみが表示されます。オンライン・モードでカタログを開くには、プレゼンテーション・サービスとWebサーバーの両方が稼働中であることが必要です。

オンライン・モードは、カタログに小さな増分変更や追加を実行する場合に使用します。たとえば、権限の変更、1つのオブジェクトの更新、新しいオブジェクトの本番環境への移行などの場合です。

オフライン・モード

オフライン・モードでは、ローカル・ファイル・システムに接続します。このモードでは、ユーザーはスーパー・ユーザーまたはシステム・ユーザーとしてログインし、権限は適用されません。このユーザーはカタログ内のすべてのオブジェクトを表示できます。

通常、オフライン・モードでの作業は、オンライン・モードでの作業よりも高速です。これは、個別のファイルに直接アクセス、作成および更新を行うためであり、オンライン・モードで作業するときのようにカタログがプレゼンテーション・サービスと通信する必要がないためです。

オブジェクトの名前をグローバルに変更したり、再編成のために複数のオブジェクトを移動するなどカタログ全体にわたる変更を実行する場合は、次の手順で説明しているように、オフライン・モードを使用します。

1. プレゼンテーション・サービスをメンテナンス・モードにします。
クラスタ環境では、プレゼンテーション・サービスのインスタンスをメンテナンス・モードにでき、数分以内に、クラスタ内のその他すべてのインスタンスも自動的にメンテナンス・モードに移行します。クラスタ環境にかぎり、数分待機してから、プレゼンテーション・サービスをメンテナンス・モードにした目的のタスクを実行してください。

メンテナンス・モードの詳細は、『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』の「管理ページ」を参照してください。

2. 7-Zipユーティリティを使用してカタログをバックアップし、その圧縮済ファイルを作成します。

3. 「Oracle BIプレゼンテーション・カタログのオープン」の説明に従って、カタログ・マネージャで、オフライン・モードでカタログを開きます。

4. システム全体にわたる変更を行います。

5. カタログを再度バックアップします。

6. プレゼンテーション・サービスのメンテナンス・モードを解除します。
クラスタ環境では、プレゼンテーション・サービスのインスタンスのメンテナンス・モードを解除でき、数分以内に、クラスタ内のその他すべてのインスタンスも自動的にメンテナンス・モードが解除されます。そのため、クラスタ環境にかぎり、カタログ・コンテンツの編集を再開できるようになるまで数分必要です。

オンライン・モードおよびオフライン・モードで使用可能な操作

カタログ・マネージャを使用して実行できる操作の多くは、オンライン・モードとオフライン・モードの両方で実行できます。いくつかの操作はどちらか一方のモードのみで使用できます。

一般的に、実行可能な操作は次のとおりです。

- オンライン・モードで実行可能な操作には、読取り専用操作と、カタログ全体に影響を与えない書込み操作(オブジェクトの権限の設定など)があります。

- オフライン・モードには、オンライン・モードで使用可能な操作の大部分と、カタログ全体に影響を与える書込み操作が含まれています。

さらに、オンライン・モードおよびオフライン・モードでは次の操作を実行できます。

- オブジェクトの切取り

- オブジェクトのコピー

- オブジェクトの貼付け

- 別のカタログのためのオブジェクトのコピー

- 別のカタログからのオブジェクトの貼付け

- オブジェクトのショートカットの作成

- オブジェクトの削除

- 参照の更新を伴わないオブジェクトの名前の変更

- 参照の更新を伴うオブジェクトの名前の変更(この機能はスマート名前変更として知られており、両方のモードで使用できます。オフライン・モードでは、すべてのオブジェクトの名前を変更できます。オンライン・モードでは、権限によっては特定のオブジェクトの名前を変更できない場合があります)。

- カタログ・マネージャの作業領域のリフレッシュ

- フォルダの作成

- オブジェクトに対する権限の設定

- オブジェクトのプロパティの操作

- 作業領域の表示の管理

- オブジェクトの検索

- カタログ・テキストの検索および置換(この機能は両方のモードで使用できます。オフライン・モードではすべてのオブジェクトを置換できます。オンライン・モードでは、ユーザーの権限によっては特定のオブジェクトを置換できない場合があります)。

- カタログ・マネージャのデータを表示するためのレポートの作成

- ブラウザのプリファレンスの設定

- オブジェクトのプレビュー(オンライン・モードのみ使用可能)

- ローカライゼーションを目的としたキャプションのエクスポート

Oracle BIプレゼンテーション・カタログのオープン

Oracle BIプレゼンテーション・カタログを開くには、次の手順に従います。

1. カタログ・マネージャで、「ファイル」メニューから「カタログを開く」を選択します。

2. 次のリストの説明に従って、必須フィールドに入力します。

- タイプ - カタログを開く際のモード(オンラインまたはオフライン)を選択します。

- パス - オフライン・モードでカタログを開く場合は、次の例のようにローカル・ファイル・システム上のカタログ・フォルダへのパスを入力します。
「参照」をクリックし、カタログの場所を指定するためのダイアログを表示します。

SDD/metadata/content

SDDはシングルトン・データ・ディレクトリ(DOMAIN_HOME/bidataなど)です。「Oracle Business Intelligenceの主なディレクトリ」を参照してください。

- URL - オンライン・モードでカタログを開く場合は、次の例のようにOracle BIプレゼンテーション・サービスのURLを入力します。
https://hostname/analytics/saw.dll

- ユーザー - オンライン・モードでカタログを開く場合は、ホストURLのユーザー名を入力します(オフライン・モードでは無効)。

- パスワード - オンライン・モードでカタログを開く場合は、ホストURLのパスワードを入力します(オフライン・モードでは無効)。

- ロケール - オンライン・モードでカタログを開く場合にカタログ・マネージャのユーザー・インタフェース要素およびカタログ内のオブジェクトに使用するロケールを選択します。

- 読取り専用 - 読取り専用モードでカタログを開くにはこのフィールドを選択します(オフライン・モードでは無効)。

3. 「OK」をクリックします。

オンライン・モードでカタログのURLを指定する際は、セキュリティ強化のために、httpではなくhttpsを指定してください。httpを指定すると、「カタログを開く」ダイアログを閉じた後、安全でない接続を使用してカタログを開くことを確認するメッセージ・ボックスが表示されます。httpsを使用してカタログを開くには、『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』のOracle Business IntelligenceでのSSL構成に関する項に示すとおり、SSL通信用にOracle BI EEを構成する必要があります。

カタログ・マネージャの作業領域の使用方法

カタログ・マネージャの作業領域は、ユーザー・コンテンツのリソースを提供します。

この項には、カタログ・マネージャの作業領域に関する次のトピックが含まれています。

- カタログ・マネージャの作業領域で行える操作

- カタログ・マネージャの作業領域の外観

- カタログ・マネージャの作業領域の表示の管理

カタログ・マネージャの作業領域で行える操作

カタログ・マネージャの作業領域では、カタログ・オブジェクトを表示および操作できます。

ここには、開いているカタログについて次のフォルダが表示されます。

- 共有フォルダ: カタログ・ユーザー間で共有するコンテンツが含まれています。これには、ビルトイン・アプリケーションによって配布される事前構成済ダッシュボードと分析、および共有フィルタなどのその他のオブジェクトが含まれています。

- システム・フォルダ - プレゼンテーション・サービスの管理要素が含まれています。これらの要素には製品によって配布されるものと、権限など管理者が構成するものがあります。このフォルダ内のファイルは変更しないでください。プレゼンテーション・サービスはこれらのファイルを内部で使用しており、それらを変更すると予期しない結果になることがあります。

- ユーザー・フォルダ - 適切な権限を持つカタログ・ユーザーが彼らの個人フォルダに保存した、個別の分析などのコンテンツが含まれています。

カタログ・マネージャの作業領域の外観

カタログ・マネージャの作業領域では、データを操作するための様々なツールが提供されています。

カタログ・マネージャは、次の主なコンポーネントで構成されています。

- メニュー・バー - 次のメニューにアクセスできます。

- ファイル - カタログを開く、閉じる、カタログ・マネージャを終了するなどのオプションを提供します。

- 編集 - カタログ・オブジェクトの管理を可能にするオプションを提供します。「切取り」、「コピー」、「権限」などがあります(これらのオプションの多くはコンテキスト・メニューでも使用可能です)。

- 表示 - カタログ・マネージャの作業領域の表示を管理するためのオプションを提供します。「ツリーの表示」、ジョブ・ステータスの表示などがあります。

- ツール - カタログの管理を可能にするオプションを提供します。「XML検索と置換」、「レポートの作成」などがあります。

- ヘルプ - Oracle BI Enterprise Edition Webサイトにアクセスし、カタログ・マネージャに関する情報を表示するためのオプションを提供します。

- ツール・バー - 「切取り」、「コピー」、「貼付け」などよく使用するオプションにすばやくアクセスできます。

- ツリー・ペイン - カタログ・フォルダを表示します。ペインには、オブジェクトも表示されますが、それは「表示」メニューの「オブジェクトのツリー表示」オプションが選択されている場合のみです。

- 表ペイン - カタログ・フォルダおよびオブジェクトが表示されます。次のもので構成されています。

- ナビゲーション・バー。ここに作業対象のカタログ・オブジェクトのパス名を入力することで、そこに移動できます。

- 「名前」、「タイプ」、「所有者」、「マイ権限」、「属性」、「作成日」、「最終変更」の列。タイプなどその値でソートするには、列名をクリックします。
「タイプ」列は、オブジェクトのタイプを識別します。不明なファイルと識別されたオブジェクトは、通常、内部で使用されるオブジェクトであり、それらのタイプはカタログ・マネージャに表示されません。

- コンテキスト・メニュー - カタログ・オブジェクトの管理を可能にするオプションを提供します。「名前の変更」、「プロパティ」、「権限」などがあります(これらのオプションの多くは「編集」メニューでも使用可能です)。

カタログ・マネージャの作業領域の表示の管理

カタログ・マネージャに何を表示するのかを管理できます。たとえば、ツリー・ペインにオブジェクトを表示したり、ジョブ・ステータスを表示したりできます。

1. カタログ・マネージャで、「表示」を選択し、次のオプションのいずれかを選択します。

- ツリーの表示 - ツリー・ペインを閉じていた場合はそれを表示します。

- 表の表示 - 表ペインを閉じていた場合はそれを表示します。

- 「ジョブ・ステータスの表示」 - 「バックグラウンド・ジョブ・ステータス」ペインを表示します。ここで、検索と置換、スマート名前変更など、実行したプロセスの進行状況を表示できます。また、完了したジョブをすべて削除したり、ペインの右上隅にあるアイコンを使用して進行状況プリファレンスを設定できます。

- オブジェクトのツリー表示 - ツリー・ペインに、フォルダに加えてオブジェクト(分析、フィルタなど)を表示します。

- リフレッシュ - 「ツリー」ペインおよび「表」ペインに表示されているオブジェクトをリフレッシュします(たとえば、カタログの使用中に他のユーザーがそれに行った変更を表示する場合などに、データのリフレッシュが必要になります)。

カタログ・マネージャでのオブジェクトの操作

カタログ・マネージャでは、いくつかの方法でオブジェクトを変更できます。

この項では、オブジェクトの使用に関する次の情報を示します。

- カタログ・マネージャを使用したカタログ・オブジェクトの検索

- オブジェクトのコピーおよび貼付け

- カタログ・オブジェクトの名前の変更

- カタログ・オブジェクトのプロパティの使用

- カタログ・オブジェクトの権限の設定

- カタログ・マネージャからのオブジェクトのプレビュー

プレゼンテーション・サービスの「カタログ」ページで、非表示オブジェクトを含めてフォルダおよびコンテンツを表示できます。フォルダおよびコンテンツを作成、名前変更、コピー、移動および削除できます。『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のOracle BIプレゼンテーション・カタログのオブジェクトの管理に関する項を参照してください。

注意:
Oracle BI管理ツールのプレゼンテーション・レイヤーで行った変更は、それらの表および列に基づく分析およびダッシュボードに影響を与えます。カタログ・マネージャを使用して、プレゼンテーション・レイヤーでのこれらの変更とカタログの同期を保つことができます。

カタログ・マネージャを使用したカタログ・オブジェクトの検索

検索機能を使用してカタログ内のオブジェクトを検索できます。

たとえば、administratorという値のプロパティを持つすべてのオブジェクトを検索できます。

検索するときに、次の項目で検索を制限できます。

- 大文字/小文字の区別 - 検索基準に大文字と小文字の区別を適用する場合はこのチェック・ボックスを選択します。デフォルト値は選択解除です。

- 名前 - 検索をオブジェクトの名前に制限します。

- 説明 - 検索を「説明」プロパティに制限します。

- プロパティ値 - 検索をプロパティの値に制限します。

- 所有者 - 検索をオブジェクトの所有者に制限します。

- XML - 検索をXMLに制限します。

- オブジェクト・タイプ - すべてのタイプのオブジェクトを検索するか、指定した特定のタイプのオブジェクト(分析、フィルタ、エージェント、ダッシュボード・プロンプト、ダッシュボード・ページなど)に検索を制限します。

- 日付 - 指定した日に作成されたオブジェクト、または指定した日に最後の変更が実行されたオブジェクトに検索を制限します。

オブジェクトを検索するには、次の手順を実行します。

1. カタログ・マネージャで、カタログを開き、ツリー内の検索を開始する場所にナビゲートします。

2. ツールバーの「検索」をクリックします。

3. 「次の基準の一部またはすべてを検索します。」フィールドに、検索する語句を入力します。

4. 検索で大文字と小文字を区別するには、「大文字/小文字の区別」ボックスを選択します。

5. 検索を制限するには、「拡張検索」をクリックします。

6. 「拡張検索」エリアで、検索の絞込み条件を指定します。

7. 「検索」をクリックします。

ヒント:
検索を完了したら、ツールバーの「カタログ・ツリー全体の検索」をクリックし、ツリー・ペインおよび表ペインに戻ります。

オブジェクトのコピーおよび貼付け

1つのカタログ内でオブジェクトをコピーして貼り付けることができます。

1つのカタログからオブジェクトをコピーし、別のカタログにそれらを貼り付けることもできます。

コピーおよび貼付けのヒント

コピーと貼付けは、いくつかの方法で実行および使用できます。

オブジェクトをコピーして貼り付けるときは、次のヒントを参考にしてください。

- 次の方法を使用して、オブジェクトをコピーし、貼り付けることができます。

- メニュー・オプション。「メニューを使用したカタログ間でのオブジェクトのコピーおよび貼付け」の説明に従ってください。

- ドラッグ・アンド・ドロップ。2つのカタログ間または同じカタログ内でオブジェクトをコピーする場合に使用します。ドラッグ・アンド・ドロップでは、1つのカタログ内で実行する場合であっても、常に、ドラッグしたオブジェクトのコピーが作成されます。

- アーカイブおよびアンアーカイブ。「カタログ・マネージャを使用したアーカイブとアンアーカイブ」の説明に従ってください。アーカイブすると、後で使用するために保存できるファイルが作成されます。アンアーカイブ・プロセスでは、上書きしないファイルを指定する機会が提供されることなく、すべてのファイルが自動的に上書きされます。

- カタログは、階層フォルダに構造化されています。オブジェクトをコピーまたはマージするときは、それらと関連付けられたオブジェクト(ダッシュボード・フォルダ、ショートカット、分析など)もすべてコピーすることを忘れないでください。外部アプリケーションのURLパスは、フォルダ・パス全体がコピーされない場合(ショートカットまたはテキストとしてダッシュボードに追加された場合など)は、コピーまたはマージ操作の後に再構築できます。

- 多くの場合、単に必要に応じてオブジェクトをコピーして貼り付けることができます。必要であれば、貼り付けるオブジェクトに適用される拡張オプションを設定できます。「オブジェクトの貼付けの拡張オプション」を参照してください。

メニューを使用したカタログ間でのオブジェクトのコピーおよび貼付け

次の手順は、メニュー・オプションを使用して2つのカタログ間でオブジェクトをコピーして貼り付ける方法を示しています。

2つのカタログの名前が同じ場合は、作業時に2つのカタログを区別するために、カタログを開く前にそのどちらか一方の名前を変更できます。カタログはどちらも同じバージョン11.1.1(またはそれ以降)である必要があります。

1. カタログ・マネージャで、変更するカタログ(ターゲット・カタログ)を開きます。

2. カタログ・マネージャのもう1つのインスタンスを使用して、コピーするオブジェクトを含むカタログ(ソース・カタログ)を開きます。

3. 必要に応じて、画面上のカタログ・マネージャの両方のインスタンスの位置を調整し、両方のカタログ・マネージャ・インスタンスのタイトル・バーが表示されるようにします。

4. ソース・カタログを表示するカタログ・マネージャ・インスタンスで、ソース・オブジェクトを右クリックし、「コピー」を選択します。

5. ターゲット・カタログを表示するカタログ・マネージャ・インスタンスで、ソース・オブジェクトを貼り付ける位置で右クリックし、「貼付け」を選択します。

オブジェクトの貼付けの拡張オプション

次の項の説明に従って、コピーしたオブジェクトを貼り付けるための拡張オプションを「設定」ダイアログで設定できます。

- 貼付けによる上書き

- ACLの貼付け

注意:

「設定」ダイアログで設定する拡張オプションを有効にするには、コピーおよび貼付け操作を開始する前にそれらを設定する必要があります。

貼付けによる上書き

「設定」ダイアログの「貼付けによる上書き」エリアにはいくつかのオプションがあります。

次のオプションがあります。

- 強制 - すべてのファイルを貼り付け、読取り専用属性が設定されているものも上書きされます。

- すべて - 該当するファイルをすべて貼り付け、読取り専用属性が設定されていないもののみが上書きされます(デフォルト)

- 古い - 該当するファイルをすべて貼り付け、ソースよりも古い場合を除いて既存のファイルは上書きされません。

- なし - 該当するファイルをすべて貼り付けますが、既存のファイルは上書きされません。

次に上書きオプションを設定した貼付けの例を示します。/users/joeフォルダに、次の分析が含まれているとします。

- 分析A (2010年1月1日作成)

- 分析B (2010年5月31日作成)

- 分析C (2010年1月1日作成)

/users/sueフォルダに、次の分析が含まれているが、分析Cは含まれていないとします。

- 分析A (2010年2月28日作成)

- 分析B (2010年1月1日作成)

Sueは/users/joeフォルダからA、BおよびCの分析をコピーし、それらをusers/sueフォルダにコピーするとします。「貼付けによる上書き」オプションの設定に応じて次のようになります。

- なし: Sueは彼女の分析AとBを保持し、Joeの分析は無視されます。Sueは、分析Cのコピーを入手します。

- すべて: Sueの分析AとBは、Joeのもので上書きされ、Sueは分析Cのコピーを入手します。

- 古い: Sueは、彼女の分析Aを保持し(Sueの分析Aは古くない)、Sueの分析BはJoeの分析によって上書きされ(Sueの分析Bは古い)、Sueは分析Cのコピーを入手します。

ACLの貼付け

「設定」ダイアログの「ACLの貼付け」エリアにはいくつかのオプションがあります。

次のオプションがあります。

- 継承 - オブジェクトの権限(ACL)を、その新規親フォルダから継承します(デフォルト)

- 保存 - 必要に応じて元のマッピング・アカウントで保持されていた、オブジェクトの権限(ACL)を保持します。

- グループのみ保存 - 「保持」と同じですが、グループ・アカウントとアプリケーション・ロールに適用され、ユーザー・アカウントには適用されません。これは開発と本番の両方で顧客が同じグループ(売上とマーケティング)を使用する可能性がある開発から本番環境の場合のためのものです。各グループのユーザーは、開発ではTestUserAとTestAdminBで、本番ではSteveとSueのように異なることがあります。

- 作成 - 次の説明のようにモードと所有者のタイプに基づいて、必要に応じて元の作成およびマッピング・アカウントで保持されていた、オブジェクトの権限(ACL)を保持します。

- オンライン・モード - オンライン・モードでは、カタログ・マネージャはバックエンド・セキュリティ・サーバーと通信します。カタログ・マネージャはそのサーバーからユーザーおよびアプリケーション・ロールの情報を入手し、通常、コピーされたオブジェクトを適切なユーザー名またはロールとともに貼り付けることができます。オブジェクトを貼り付けるときは、自身が特定のオブジェクトに対してアカウントを作成するための適切な権限を持っていない可能性があることに注意してください。

- オフライン・モード - オフライン・モードでは、カタログ・マネージャは、バックエンド・セキュリティ・サーバーと接続しておらず、そこに格納されているユーザーおよびアプリケーション・ロールについては、カタログのキャッシュからそれらの名前を入手できないかぎり、認識しません。コピーされたオブジェクトのユーザー名またはロールをキャッシュから入手できない場合、カタログ・マネージャはコピーされたオブジェクトをその名前またはロールとともに貼り付けることはできません。かわりに、貼り付けられたオブジェクトは、その所有者をその新規親フォルダから継承します。これは「継承」オプションに似ています。

この機能は、管理者が、ユーザーを本番環境に移動する前に、ステージング領域でアカウントを作成するアプリケーションで使用されます。

適切な権限を持っている場合は、新しく貼り付けられたオブジェクトを選択し、所有権を適切なユーザーに再帰的に設定できます。

次にACLオプションを設定した貼付けの例を示します。Steveは/users/steve/MyFavReportフォルダを所有しており、すべてのユーザーが読取り/実行でき、steveが完全な制御権を持つという権限(ACL)を持っているとします。Joe(いくつかの管理権限を持つ)がログインしてMyFavReportをコピーし、それを/users/sue(administratorによって所有され、管理者が完全な制御権を持つ、sueが完全な制御権を持つの権限が設定されている)に貼り付けるとします。

Joeが設定する「ACLの貼付け」オプションに応じた動作は次のとおりです。

- 継承: /users/sue/MyFavReportフォルダは、Joeによって所有され、/users/sueフォルダに設定されていた権限(管理者が完全な制御権を持つ、sueが完全な制御権を持つ)が設定されます。

- 保存: /users/sue/MyFavReportフォルダは、Joeによって所有され、/users/steve/MyFavReportフォルダに設定されていた権限(すべてのユーザーが読取り/実行でき、steveが完全な制御権を持つ)が設定されます。Joeが2つ目のカタログ・マネージャに貼り付け、このカタログにsteveが存在しない場合、Steveの権限は破棄されます。steveは存在しているが異なるユーザーIDを持っている場合、SteveのユーザーIDが新しいものにマッピングされます。

- 作成: オンライン・モードでは、/users/sue/MyFavReportフォルダは、Joeによって所有され、/users/steve/MyFavReportフォルダに設定されていた権限(すべてのユーザーが読取り/実行でき、steveが完全な制御権を持つ)が設定されます。Joeが2つ目のカタログ・マネージャに貼り付け、このカタログにsteveが存在しない場合、所有者は親フォルダから継承されます(「作成」オプションが適用されるのはカタログ・グループのみのため、これはリリース11gでは非推奨となっています)。

カタログ・オブジェクトの名前の変更

カタログ内のオブジェクトの名前は変更できます。

これは、テスト環境から本番環境に移行する場合に便利です。

オブジェクトの名前の変更方法には、次の2つがあります。

- 参照の更新を伴わない名前の変更 - オブジェクトの名前を変更し、他のカタログ・オブジェクトで使用されている可能性がある元の名前への参照を保持します。

- 参照の更新を伴う名前の変更 - オブジェクトの名前を変更し、他のオブジェクトが使用している可能性がある参照を新しい名前に変更します(元の名前の参照は保持されません)。この機能は、スマート名前変更とも呼ばれます。カタログはオフライン・モードでもオンライン・モードでも開くことができます。オフライン・モードでは、すべてのオブジェクトの名前を変更できます。オンライン・モードでは、権限によっては特定のオブジェクトの名前を変更できません。

注意:オブジェクトの名前を変更するときは、次の点に注意してください。

- カタログ内のユーザー・アカウントの名前は変更できません。ユーザーのホーム・ディレクトリの名前を変更する場合、そのユーザーの名前を変更しないと予期しない結果になることがあります。

- カタログに含まれるオブジェクトの名前には予約済のものがいくつかあります。名前の変更は自身のオブジェクトに対してのみ行い、プレゼンテーション・サービスによって内部で作成されたものは変更しないでください。たとえば、自身のホーム・ディレクトリ内の_portalディレクトリの名前を変更しないでください。変更すると「マイ・ダッシュボード」が表示されなくなります。

参照の更新を行わずにオブジェクトの名前を変更するには、次の手順を実行します。

1. カタログ・マネージャでカタログを開きます。

2. 名前を変更するオブジェクトにナビゲートします。

3. 「名前」列でオブジェクトを右クリックし、「名前の変更」を選択します。

4. オブジェクトの新しい名前を入力します。

参照を更新してオブジェクトの名前を変更するには:

1. カタログ・マネージャで、オフライン・モードでカタログを開きます。

2. 名前を変更するオブジェクトにナビゲートします。

3. 「名前」列でオブジェクトを右クリックし、スマート名前変更を選択します。

4. オブジェクトの新しい名前を入力します。

ウィンドウの右下隅にあるプログレス・バーに、参照の更新の進行状況が表示されます。

カタログ・オブジェクトのプロパティの使用

オブジェクトのプロパティはカタログ・マネージャを使用して操作できます。

カタログ・マネージャの「プロパティ」オプションを使用して実行できる操作は次のとおりです。

- カタログ・オブジェクトのプロパティの作成、表示、編集および削除

- Oracle Business Intelligenceで表示から非表示にするためのカタログ・オブジェクトの属性の変更

1. カタログ・マネージャでカタログを開きます。

2. オブジェクトにナビゲートします。

3. 「名前」列でオブジェクトを右クリックし、「プロパティ」を選択します。

4. 次のうちの必要な操作を実行します。

a. 適切な権限を持っている場合は、オブジェクトの適切な所有者を「所有者」リストで選択します。
「所有者」リストには、カタログ・マネージャにログインするために使用した名前が含まれています。このリストを使用して自身をオブジェクトの所有者として選択できます。

『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のオブジェクトの所有者の割当てに関する項を参照してください。

b. オブジェクトの属性を変更するには、必要に応じて「読取り専用」または「非表示」を選択します。非表示オブジェクトはOracle Business Intelligenceで表示されません。

注意:

「システム」オプションは、オブジェクトが内部で保持されており、変更できないことを示しています。

c. プロパティを作成、編集または削除するには、必要に応じて「新規」、「編集」または「削除」ボタンを使用します。

注意:
「新規」ボタンはプロパティを作成するために使用します。Oracleサポート・サービスによる指示がある場合にのみ使用します。

5. 「OK」をクリックします。

複数のオブジェクトを選択して、それらのプロパティや権限を同時に更新できます。選択したオブジェクトのいずれかがフォルダである場合、それらの変更をそのフォルダのツリー構造のすべてのオブジェクトに再帰的に適用することもできます。

たとえば、/shared/DontTouchディレクトリのすべてのファイルを読取り専用に設定できます。DontTouchディレクトリを右クリックし、「プロパティ」を選択します。「プロパティ」ダイアログで、「読取り専用」オプションを選択し、「再帰的に適用」オプションを選択し、「OK」をクリックします。「再帰的に適用」を選択して、オブジェクトおよびそのすべてのサブオブジェクトの所有権を取得することもできます。

カタログ・オブジェクトの権限の設定

制限は、カタログ・オブジェクトへのアクセスを制御するために使用されます。

1. カタログ・マネージャでカタログを開きます。

2. オブジェクトにナビゲートします。

3. 「名前」列でオブジェクトを右クリックし、「権限」を選択します。

「権限」ダイアログに次の2つのリストが表示されます。

- ユーザーおよびアプリケーション・ロール(明示的な権限) - このオブジェクトに対する明示的な権限を与えられたユーザー、グループおよびアプリケーション・ロールが表示されます。

- 追加のユーザーとアプリケーション・ロール - グループ継承によりアクセスを与えられたユーザー、グループおよびアプリケーション・ロールと、リクエストにアクセスできないユーザー、グループおよびアプリケーション・ロールが表示されます。

プレゼンテーション・サービスでの許可および権限の割当て方法の詳細は、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドのダッシュボードと分析のセキュリティの管理を参照してください。

4. 権限を設定するユーザー、グループまたはアプリケーション・ロールが「追加のユーザーとアプリケーション・ロール」リストに含まれている場合は、それを選択し、左矢印ボタン(<)をクリックすることでユーザーおよびアプリケーション・ロール(明示的な権限)リストに移動します。

5. (オプション)「追加ユーザーとアプリケーション・ロール」リストに表示されるユーザー、グループおよびアプリケーション・ロールをフィルタ処理するには、「リスト」ボタンおよびその横にあるフィールドを次のように使用します。

- 「リスト」ボタンの横にあるフィールドにフィルタ基準(大文字/小文字を区別しない)を入力し、名前による検索を実行します。
部分的なフィルタ基準を入力するには、アスタリスク(*)記号を使用します。たとえば、bi*と入力すると、bi、BI、bIおよびBiで始まるユーザーまたはグループが表示されます。

- 検索するアカウントを制限するにはリストから値を選択します。
使用可能な値は、「すべて」、「ユーザー」および「アプリケーション・ロール」です。

6. ユーザーおよびアプリケーション・ロール(明示的な権限)リストでユーザーまたはグループを選択します。

7. 「権限」列のリストから新しい権限を選択するか、リストから「カスタム」をクリックして「カスタム権限」ダイアログを表示し、権限の組合せを選択します。

各権限の意味の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドの権限の定義を参照してください。

8. 「再帰的に適用」オプションを選択し、そのオブジェクトが含むすべてのオブジェクトに変更を適用します。

9. 「置換オプション」リストで次のように値を選択します。

- すべて置換 - 既存のACLを、ダイアログ内に現在のあるもので置換します。

- リストされた項目の置換 - ダイアログに現在表示されているアカウントのみを変更し、他のものはそのまま残します。

- リストされた項目の削除 - ダイアログに現在表示されているアカウントのみを削除し、他のものはそのまま残します。

10. 「OK」をクリックします。

注意:
「ユーザーとグループ(明示的な権限)」リストから「追加のユーザーとアプリケーション・ロール」リストにユーザーまたはグループを移動すると、そのユーザーまたはグループの権限は「アクセス権なし」にリセットされます。リストから別のリストにユーザーまたはグループを移動するには、それを強調表示し、必要に応じて右矢印ボタンまたは左矢印ボタンをクリックします。

権限、グループおよびユーザーの詳細は、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドを参照してください。

カタログ・マネージャからのオブジェクトのプレビュー

オンライン・モードでは、カタログ・マネージャから分析やプロンプトなどのオブジェクトをプレビューできます。カタログ・マネージャからオブジェクトをプレビューする場合は、これらのオブジェクトの表示に使用するデフォルト・ブラウザを指定する必要があります。

1. カタログ・マネージャで、「ツール」メニューから「設定」を選択します。

2. 「レポート・プレビューに使用するWebブラウザを選択します。」フィールドで、使用しているオペレーティング・システムのデフォルト・ブラウザに設定したものと同じブラウザを選択します。「参照」ボタンをクリックし、そこで適切なブラウザの実行可能ファイルを選択できます。

3. 「OK」をクリックします。

オブジェクトをプレビューするには:

1. カタログ・マネージャで、オンライン・モードでカタログを開きます。

2. オブジェクトにナビゲートします。

3. 「名前」リストでオブジェクトを右クリックし、「プレビュー」を選択します。

XMLでのカタログ・オブジェクトの表示と編集

カタログ・マネージャでは、分析、ダッシュボード、フィルタなどのカタログ・オブジェクトのXML記述を表示および編集できます。

XMLコードの表示は行っても問題ありませんが、コードの編集はお薦めしません。

注意:
XMLコードを編集すると、カタログでのオブジェクトの表現が変更されます。いずれのディレクトリのカタログ・オブジェクトでもXMLコードの編集はお薦めしません。予期しない結果を招くことがあります。
分析のためにXMLを編集する場合は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドの分析のための論理SQL文の調査に関する項の情報を使用します。

1. カタログ・マネージャでカタログを開きます。

2. オブジェクトにナビゲートします。

3. 「名前」列でオブジェクトを右クリックし、「プロパティ」を選択します。

4. 「XMLの編集」をクリックします。

5. XML定義の表示を完了したら、「取消」をクリックします。

6. 「プロパティ」ダイアログで「OK」をクリックします。

次の図は、オブジェクトのカタログ・マネージャでのサンプルXMLコードを示しています。

オブジェクトのXML記述を編集するには(お薦めしません):

1. カタログ・マネージャでカタログを開きます。

2. オブジェクトにナビゲートします。

3. 「名前」列でオブジェクトを右クリックし、「プロパティ」を選択します。

4. 「XMLの編集」→「編集」をクリックします。

5. 「オブジェクトXML」エリアで変更を行います。

注意:
オブジェクトのXML記述を編集する場合、カタログではXMLの形式が正しいことのみが確認され、その他のエラーについては確認されません。

6. 「XMLの編集」ダイアログで「OK」をクリックします。

7. 「プロパティ」ダイアログで「OK」をクリックします。

カタログ・マネージャを使用したカタログ・テキストの検索と置換

カタログ・マネージャを使用して、カタログ内の特定のテキストを検索し、それを他のテキストに置換できます。

カタログはオンライン・モードでもオフライン・モードでも開くことができます。オフライン・モードではすべてのオブジェクトを置換できます。オンライン・モードでは、ユーザーの権限によっては特定のオブジェクトを置換できない場合があります。

具体的には、検索および置換できるものは次のとおりです。

- 単純なテキスト文字列(ダイアログを使用)。「単純なカタログ・テキスト文字列の検索と置換」を参照してください。
たとえば、オブジェクトに文字列「My Misspeled Wirds」が含まれているとします。カタログ・マネージャを使用してその文字列を検索し、適切な文字列である「My Misspelled Words」に置換できます。

- 複数または複雑なテキスト文字列(XMLファイルを使用してすべて同時に実行)。「複数のカタログ・テキスト文字列の検索と置換」を参照してください。
たとえば、管理者がリポジトリ・ファイル内のサブジェクト・エリア、表または列の名前を変更したとします。表SalesがMySalesという名前に変更されている可能性があります。カタログ・マネージャを使用して、カタログ全体でそのオブジェクトが使用されているすべての箇所を検索して置換できます。

単純なカタログ・テキスト文字列の検索と置換

カタログ内の単純なテキスト文字列を検索し、他のテキストに置換できます。

1. カタログ・マネージャで、オンライン・モードまたはオフライン・モードでカタログを開きます。

2. 「ツール」メニューから「XML検索と置換」を選択します。

3. 「旧テキスト」フィールドに、検索するテキスト文字列を入力します。

4. 「置換文字列」フィールドに、置換後のテキストを入力します。

5. 検索で大文字と小文字を区別しない場合は、「大文字/小文字の区別」ボックスを選択解除します。

6. 「OK」をクリックします。

複数のカタログ・テキスト文字列の検索と置換について

検索および置換する各テキスト文字列を識別するXMLファイルをインポートすることで、複数のカタログ・テキスト文字列に対してすべて同時に、より強力な検索および置換操作を実行できます。

テキスト文字列の検索と置換のためのXMLファイル形式

検索および置換のXMLファイルでは、action要素を使用して検索および置換する各テキスト文字列を識別します。

action要素は、commands要素に含まれています。action要素の属性は次のとおりです。

- command - 置換するテキストを指定します。有効な値は次のとおりです。

- textReplace - 列名など、XMLファイル内で一致するすべてのテキストを置き換えます。

- oldValue - 検索するテキスト文字列を指定します。
検索と置換のXMLファイルのtextReplaceコマンドに対してこの属性を指定する場合は、Java regexの完全な構文使用する必要があります。これは、通常の文字列と異なります。文字列を置換するには、次を実行する必要があります。

1. Java regex特殊文字(角カッコ、丸カッコ、ドル記号、カレットなど)はすべてエスケープします。

2. バックスラッシュや引用符などの「一般的な」特殊文字をエスケープします。

3. XMLファイルで作業しているため、HTMLの特殊文字(引用符やアンパサンドなど)はすべてエスケープします。

完全なJava regex構文については、次のドキュメントを参照してください。

java.util.regex: クラス・パターン

次の表は、検索基準内のregex構文で使用するためのサンプル文字列を示しています。

入力した検索文字列

結果

a

検索文字列の前後にワイルドカードを追加し(たとえば、*a*)、検索でaという文字を含む結果を返すことが可能になります。

^a

検索文字列の後にワイルドカードを追加し(たとえば、a*)、検索でaという文字で始まる結果を返すことが可能になります。

a$

検索文字列の前にワイルドカードを追加し(たとえば、*a)、検索でaという文字で終わる結果を返すことが可能になります。

a\*

アスタリスク(*)が後に続く文字を含む文字列(たとえば、a*)を明示的に検索します。

?

疑問符(?)を文字とアスタリスク(*)とともに使用し、文字のゼロ(0)個以上の出現を返します。たとえば、?a*では、aという文字の0個以上の出現が返されます。

- newValue - 置換テキストを指定します。

- ignoreCase - trueに設定すると大文字と小文字が区別されず、falseに設定すると大文字と小文字が区別されます。デフォルト値はfalseです。

テキスト文字列の検索と置換のためのXMLファイルの例

次に、テキスト文字列を検索および置換するXMLファイルの例の一部を示します。

<?xml version="1.0" encoding="utf-8"?>
<actions>
<action command="textReplace" oldValue="boots" newValue="HoleyShoes" ignoreCase="true"/>
</actions>

複数のカタログ・テキスト文字列の検索と置換

複数のカタログ・テキスト文字列をすべて一度に検索および置換する手順は、次のとおりです。

1. 複数のテキスト文字列を検索および置換するためのXMLファイルを作成します。

「複数のカタログ・テキスト文字列の検索と置換について」を参照してください。

2. カタログ・マネージャで、オフライン・モードでカタログを開きます。

3. 「ツール」メニューから「XML検索と置換」を選択します。

4. 「ファイルからインポート」フィールドで、パスを入力するか、「参照」をクリックしてステップ1で作成したXMLファイルを指定します。

5. 検索で大文字と小文字を区別するには、「大文字/小文字の区別」ボックスを選択します。

6. 「OK」をクリックします。

カタログ・マネージャを使用したカタログ・データを表示するためのレポートの作成

レポートを作成して、すべてのカタログ・オブジェクト・タイプのカタログ・データを表示できます。レポートは画面上に表示することもファイルに保存することもできます。

レポートを作成するとき、空白または空のフィールドはタブ文字としてエクスポートされます。デフォルトでタブをフィールド・セパレータとして使用するレポートを作成する場合、レポート・ファイル内では2つのタブ文字が空白フィールドを示します。

1. カタログ・マネージャでカタログを開きます。オブジェクトのOracle BIサーバーに送信されるSQL文を示すレポートを作成するには、オンライン・モードでカタログを開きます。

2. カタログの最上位フォルダを選択します。

3. 「ツール」メニューから、「レポートの作成」を選択します。

4. レポートを作成するカタログ・オブジェクト・タイプを選択します。

5. レポートから同一の行を排除するには、「個別」ボックスを選択します。

6. 「レポート内の列」リストでレポートに表示する列を指定します。左矢印および右矢印ボタン(<および>)を使用して、列を「使用可能な列」リストと「レポート内の列」リストの間で移動し、プラスおよびマイナス・ボタン(+および-)を使用してレポート内での列の表示順序を設定します。

7. 「OK」をクリックします。

8. レポートに適切な列が含まれるようになるまでステップ4 - 7を繰り返します。

9. ファイルにレポートを保存するには、レポートの保存先フィールドにファイルのパス名を指定します。「参照」ボタンをクリックし、「名前を付けて保存」ダイアログを表示してパス名を選択します(ファイルが存在していない場合は、それが作成されます)。

10. Microsoft Excelにインポート可能な.tab拡張子付きのファイルの作成を指定するには、「Excel形式」を選択します。

Microsoft Officeの一部としてサポートされるExcelのバージョンの詳細は、システム要件および動作保証ドキュメント「システム要件と動作保証」を参照してください。

11. 「OK」をクリックします。

レポートの使用方法の例

レポートを実行すると、システム内のデータの管理に役立つだけではなく、問題が顕在化する前に特定するためにも役立ちます。

次の例に示すように、レポートは様々な目的で生成できます。

- 分析を使用しているダッシュボードを確認するには、分析を含むダッシュボード・レポートを実行し、そのレポートで分析を探します。

- リポジトリ表の変更済列の影響を受ける分析を確認するには、すべての列と計算式を含む分析レポートを実行し、そのレポートでCatalog Managerで置換する必要のある項目を探します。

- すべてのダッシュボード・プロンプトおよびダッシュボード内の関連フィールド(列、式、サブジェクト領域など)が表示されるレポートを作成できます。また、分析のレポートを作成し、そのような分析で使用されているフィルタを抽出することもできます。要求される保存済フィルタを使用して式が導出される、フィルタ抽出の例を次に示します。
例: "Markets"."Region" [Filter, prompted]

- オブジェクトのACLを表示するレポートを作成できます。レポートでACLを確認することにより、オブジェクトへのアクセス権が、読取り/書込みなどの適切な権限を備えた適切なロールに付与されていることを検証できます。次の行は、レポートのACLの例を示しています。
"^biconsumer=RX:steve=F"。ここで、キャレット(^)はアプリケーション・ロール、および"nothing"はユーザーを示しています。

カタログ・マネージャを使用したアーカイブとアンアーカイブ

カタログ・マネージャでは、個別のカタログ・フォルダとカタログ全体のどちらでもアーカイブおよびアンアーカイブできます。

この機能に関する重要な情報は、次のリストを参照してください。

- 個別のカタログ・フォルダをアーカイブする場合は、そのフォルダ内のすべてのオブジェクトとそのフォルダのサブフォルダが1つの圧縮済ファイルに保存されます。オブジェクトのプロパティおよび属性はそのアーカイブ・ファイルに含まれます。

- 個別のカタログ・フォルダをアンアーカイブする場合、そのアーカイブ・ファイルが展開され、そのフォルダ内のすべてのオブジェクトとそのフォルダのサブフォルダが現行のオフライン・カタログに格納されます。アンアーカイブされるフォルダと同じ名前を持つ既存のフォルダは、警告が表示されることなく上書きされます。

- カタログ・マネージャ、またはプレゼンテーション・サービスの「カタログ」ページを使用してカタログ全体をアーカイブおよびアンアーカイブすることはお薦めしません。カタログ全体のアーカイブおよびアンアーカイブには、かわりに7-ZipユーティリティまたはUNIXシステム上では.tar.gzファイルを使用してください。

- ルート・レベル(\)から開始して、カタログ全体をアーカイブすることはしないでください。アーカイブ時には、常に特定のフォルダ名を指定します。

- カタログ全体のアーカイブおよびアンアーカイブには次のユーティリティを使用しないでください。

- WinZip - WinZipユーティリティは、拡張UNIXファイル権限を適切に処理できないことがあります。異機種環境でWinZipユーティリティを使用してカタログを移動すると、カタログ・ファイルが破損することがあります。

- FTP - サードパーティ製のFTPプログラムのなかには内部ファイルの名前を変更するものがあり、それによってカタログ・ファイルが破損することがあります。FTPプログラムを使用してカタログを移動する前に、7-Zipユーティリティを使用してカタログを1つのファイルに圧縮してください。

プレゼンテーション・サービスの「カタログ」ページを使用して、オブジェクトをアーカイブおよびアンアーカイブできます。詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドのオブジェクトのアーカイブに関する項を参照してください。

カタログ・マネージャを使用したフォルダのアーカイブ

カタログ・フォルダをアーカイブする手順は、次のとおりです。

1. カタログ・マネージャで、オフライン・モードでカタログを開きます。

2. カタログ・フォルダを強調表示し、「ファイル」メニューから「アーカイブ」を選択します。

3. 「アーカイブ・ファイル・パス」フィールドでフォルダのアーカイブ先のファイルのパス名を指定します。「参照」ボタンをクリックし、ダイアログを表示してパス名を選択します。

4. フォルダをアーカイブするには:

- アーカイブするオブジェクトおよびフォルダに割り当てられたタイムスタンプをアーカイブするには、「ファイルのタイム・スタンプの保持」オプションを選択します。
このオプションを選択しない場合、アーカイブ・プロセスにタイムスタンプ情報は含まれず、「設定」ダイアログの「貼付けによる上書き」エリアの「古い」オプションは無視されます。アンアーカイブするときに、オブジェクトまたはフォルダがアンアーカイブされた時刻を示すタイムスタンプがシステムによって適用されます。

「オブジェクトの貼付けの拡張オプション」を参照してください。

- 各オブジェクトまたはフォルダに割り当てられた権限をアーカイブするには、「権限の保持」オプションを選択します。
このオプションを選択しない場合、アーカイブ・プロセスに権限は含まれず、「設定」ダイアログの「ACLの貼付け」エリアのオプションは無視されます。アンアーカイブ時には、システムによって親フォルダの権限がすべてのオブジェクトおよびフォルダに割り当てられます。

5. 「OK」をクリックします。

カタログ・マネージャを使用したフォルダのアンアーカイブ

カタログ・マネージャを使用してアーカイブからフォルダを削除できます。

アンアーカイブは貼付けに似ているため、「オブジェクトの貼付けの拡張オプション」に記載されている権限とACLに関する問題を理解しておく必要があります。カタログ・フォルダをアンアーカイブする手順は次のとおりです。

1. カタログ・マネージャで、オフライン・モードでカタログを開きます。

2. カタログ・フォルダをアンアーカイブするには、フォルダをアンアーカイブする場所にナビゲートします。

3. 「ファイル」メニューから、「アンアーカイブ」を選択します。

4. 「アーカイブ・ファイル・パス」フィールドに、アンアーカイブするカタログ・フォルダのパス名を指定します。「参照」ボタンをクリックし、ダイアログを表示してパス名を選択します。

5. 「OK」をクリックします。

第VI部 詳細な構成設定

第V部ではシステムのデプロイに必要な構成の設定について説明しました。

このパートでは、必須ではなく任意で指定できる詳細な構成設定と、デプロイメントの調整のための詳細設定について説明します。

この部は、次の章で構成されています。

- 分析とダッシュボードの構成および管理

- エージェントの構成および管理

- マッピングおよび空間情報の高度なオプションの構成

- リソースの可用性とURL生成の構成

17 分析とダッシュボードの構成および管理

この章では、Oracle Business Intelligenceにおける、分析およびダッシュボードと、それらに含まれるビューなどのオブジェクトの構成および管理方法について説明します。コンテンツ・デザイナが行う分析およびダッシュボードの操作方法の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

エンド・ユーザーは、適切な権限を持っていれば、個人用のダッシュボードと共有ダッシュボードに対して、ページやコンテンツの追加などの変更操作を実行できます。分析およびダッシュボードの作成については、エンド・ユーザーは実行できません。

この章の内容は次のとおりです。

- ダッシュボードの管理

- 分析の一般的な構成タスクの実行

- ビュー内のデータの表示と処理の構成

- プロンプトの構成

- 第18.4項「プレゼンテーション設定の手動による変更」

- アンサーでの分析のブロック

- 分析およびダッシュボードのデフォルト表示の指定

- 分析およびダッシュボードでのライトバックの構成

- Oracle BI Webユーザー・インタフェースのカスタマイズ

- ダッシュボードでの外部コンテンツの埋込み

ダッシュボードの管理

共有ダッシュボードを作成する場合は、事前に、Oracle BIプレゼンテーション・カタログのディレクトリまたはフォルダ構造とセキュリティ戦略を確実に計画しておきます。

通常、共有ダッシュボードを作成するときには、ダッシュボード・ビルダーを使用して、最初にダッシュボードを作成し、コンテンツを追加します。ダッシュボードにアクセスするための権限を割り当てることもできます。複数のアプリケーション・ロールのメンバーとなっているユーザーは、権限を与えられているすべてのダッシュボードの中からデフォルトで表示するダッシュボードを選択できます。

次に、ダッシュボード関連の情報を提供する他のリソースを示します。

- Oracle BIプレゼンテーション・カタログ構造およびセキュリティ・フレームワークのより広いコンテキストにおける共有ダッシュボードの作成のガイドラインについては、『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』のダッシュボードでの保存されているカスタマイズ・オプションへのアクセスの制御に関する項に記載されています。

- Oracle BIプレゼンテーション・カタログの共有フォルダ構造の詳細は、「Oracle BIプレゼンテーション・カタログの構成と管理」に記載されています。

- 権限の詳細は、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドに記載されています。

- ユーザーが他のユーザーの代理として他のユーザーのダッシュボードにアクセスできるようにする方法の詳細は、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドのユーザーが他のユーザーの代理操作を実行できるようにする方法に関する項に記載されています。

分析の一般的な構成タスクの実行

この項では、分析の作成を構成するために実行できる一般タスクについて説明します。

次の項が含まれます:

- Excelへのエクスポートに役立つヒープ・サイズの増加

- エクスポートの手動による構成

- ネストされたフォルダ、ナビゲーションおよびドリルダウンのサポート

Excelへのエクスポートに役立つヒープ・サイズの増加

Microsoft Excelへのエクスポートなど、分析結果をエクスポートするための様々なオプションが用意されています。

このようなオプションの詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドの結果のエクスポート関する項を参照してください。Excel形式に直接エクスポートすることは可能ですが、大量の行数をエクスポートする場合は、まずCSVにエクスポートしてからそのファイルをExcelにインポートすると、パフォーマンスが向上することがあります。

ユーザーがCSV形式を使用せずに大きいデータ・セットをエクスポートし、メモリー不足エラーを取得する場合、JavaHostサービスのヒープ・サイズを増やす必要があります。デフォルトのヒープ・サイズは1024MBです。コンピュータ上の使用可能なメモリーに応じて、JavaHostサービスのヒープ・サイズを増やすことができます。

1. 編集のためにobijh.propertiesファイルを開きます。ファイルは次の場所にあります。

ORACLE_HOME/bi/modules/oracle.bi.cam.obijh/env/obijh.properties

2. 既存の-Xmx1024Mエントリ(OBIJH_ARGS=で始まる行)を変更します。

-Xmxパラメータを2048M(または必要に応じてそれ以上。システムにおける使用可能なメモリーや必要とするExcelエクスポートのサイズによる)に設定します。

3. ファイルを保存して閉じます。

これはすべてのJavaHostに影響します。

4. com.siebel.analytics.javahost.io.ChannelWithTimeoutクラスからSocketTimeoutExceptionについてのエラー・メッセージが表示される場合は、JavaHostサービスのためのSocketTimeoutパラメータを更新します。

次のJavaHostシステム・コンポーネントのconfig.xmlファイルを開きます。

BI_DOMAIN/config/fmwconfig/biconfig/OBIJH/config.xml。

MessageProcessorセクションとSocketTimeoutパラメータを見つけます。コメント・アウトされている可能性もあります。必要に応じてSocketTimeoutを非コメント化し、大きな値を指定します。たとえば、最小でも300000ミリ秒を指定します。

config.xmlファイルとその設定の詳細は、「Oracle BIプレゼンテーション・サービスに対するJavaHostサービスの使用」を参照してください。

5. ファイルを保存して閉じます。

6. Oracle Business Intelligenceを再起動します。

エクスポートの手動による構成

分析結果やビューをエクスポートする方法を変更する各種オプションを構成できます。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次のネームスペース宣言をWebConfig要素に挿入します。

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

Export要素に、エクスポートのタイプを指定する必須属性xsi:typeが含まれていることに注意してください。有効な値は次のとおりです。

- excel (Microsoft Excelへのエクスポート)

- formattedText (データ・エクスポートの場合)

- pdf (PDFにエクスポートする場合)

- ppt (Microsoft Powerpointへのエクスポート)

3. 次の表で説明している要素を追加する必要があるDownloadセクションを見つけます。

4. 次の例に示すように、必要な要素とその祖先要素を追加します。

注意:
デフォルトのエクスポート値はUseRawValueです。ただし、丸められた値をエクスポートする場合、かわりにUseFormattedValue値を使用する必要があります。

<ServerInstance>
<Download>
<Export xsi:type="excel">
<DataValue>UseRawValue</DataValue>
<RepeatRows>false</RepeatRows>
</Export>

<Export xsi:type="formattedText">
<Delimiter char=","/>
</Export>

<Export xsi:type="pdf">
<KeepRowsTogether>true</KeepRowsTogether>
<Orientation>Landscape</Orientation>
</Export>

<Export xsi:type="ppt">
<Orientation>Portrait</Orientation>
</Export>

</Download>
</ServerInstance>

5. 変更内容を保存し、ファイルを閉じます。

6. Oracle Business Intelligenceを再起動します。

次の表に、エクスポートの手動構成に使用される要素について説明します。

要素

説明

デフォルト値

DataValue

データ値(数値および日付)をExcelにエクスポートする場合に、完全な数値精度および書式設定マスクが設定されたRAW書式でエクスポートするか、または指定されたデータ書式の文字列でエクスポートするかどうかを指定します。

有効な値は次のとおりです。

- UseRawValue

- UseFormattedValue

エクスポート・タイプは次のとおりです。

xsi:type="excel"

UseRawValue

RepeatRows

表およびピボット表をExcelにエクスポートする場合に、複数の行にわたるセルおよび複数の列にわたるセルを繰り返すかどうかを指定します。

trueに設定すると、分析エディタの「値の抑制」の設定に関係なく、複数の行にわたるセルおよび複数の列にわたるセルが繰り返されます。たとえば、年と月の値を含む表では、年はすべての月の値に対して繰返し表示されます。

falseに設定すると、その動作は、分析エディタの「値の抑制」オプションで定義されているのと同じです。

- 「値の抑制」が「抑制」に設定されている場合、複数の行にわたるセルおよび複数の列にわたるセルは繰り返されません。たとえば、年と月の値を含む表では、年は月の値に対して1回のみ表示されます。

- 「値の抑制」が「繰返し」に設定されている場合、複数の行にわたるセルおよび複数の列にわたるセルは繰り返されます。たとえば、年と月の値を含む表では、年はすべての月の値に対して繰返し表示されます。

「値の抑制」オプションの詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

エクスポート・タイプは次のとおりです。

xsi:type="excel"

false

Delimiter

結果およびビューからRAWデータをエクスポートする場合に、セミコロン(;)などの「CSV形式」オプションの列区切り文字を指定します。

エクスポート・タイプは次のとおりです。

xsi:type="formattedText"

","

KeepRowsTogether

PDFにエクスポートする場合に、複数の行をページ区切りでまとめるかどうかを指定します。

trueに設定すると、複数の行をページ区切りでまとめます。

falseに設定すると、複数の行をページ区切りをまたいで分割します。

エクスポート・タイプは次のとおりです。

xsi:type="pdf"

false

Orientation

PDFおよびPowerpointへエクスポートする場合に、方向(PortraitまたはLandscape)を指定します。

PDFへエクスポートする場合のエクスポート・タイプは次のとおりです。

xsi:type="pdf"

Powerpointへエクスポートする場合のエクスポート・タイプは次のとおりです。

xsi:type="ppt"

Landscape (PDFへのエクスポート)

Portrait (Powerpointへのエクスポート)

QuoteTxtTab

「CSV形式」オプションの引用符を追加します。falseに設定すると、引用符は追加されません。

エクスポート・タイプは次のとおりです。

xsi:type="formattedText"

true

ネストされたフォルダ、ナビゲーションおよびドリルダウンのサポート

管理者は、コンテンツ・デザイナの分析作業が容易化されるようにサブジェクト・エリアを設定できます。

Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドでは、サブジェクト・エリアの設定に関するあらゆる情報を提供しています。コンテンツ・デザイナを支援するサブジェクト・エリアの機能のリストを次に示します。

- コンテンツ・デザイナが分析の作成時に「サブジェクト領域」ペインで選択内容を容易に見分けられるようにするため、管理者はOracle BI管理ツールでプレゼンテーション・レイヤーを設定してネストされたフォルダが表示されるようにできます。たとえば、Sales FactsフォルダをFactsフォルダのサブフォルダとして表示できます。

- コンテンツ・デザイナは、分析の作成時に、関連する分析およびコンテンツにユーザーが移動できるように設定できます。管理者によってサブジェクト・エリアのディメンション階層が設定されている場合、ユーザーは、グラフ、表およびピボット表に表示されたデータ結果をドリルダウンして詳細情報を取得できます。
ナビゲーション機能とドリルダウン機能には、アクセスを制御する権限設定が特にないため、すべてのユーザーがこれらの機能を利用できます。

- コンテンツ・デザイナは、主要サブジェクト・エリアの列と1つ以上の関連エリアの列を含む分析を作成できます。

ビュー内のデータの表示と処理の構成

ビュー内のデータの表示と処理の様々な変更オプションを構成できます。

関連情報として、「表およびピボット・テーブルのデータに対する構成オプションを設定するためのFusion Middleware Controlの使用」と「表をレンダリングするために処理する最大行数を設定するためのFusion Middleware Controlの使用」も参照してください。

この項では、次の項目について説明します。

- ビュー内のデータの手動による変更

- グラフとゲージの手動による構成

- 交互する行の色の手動による変更

- ビュー内の相互作用の手動による構成

ビュー内のデータの手動による変更

ビュー内のデータの処理と表示の様々な変更オプションを構成できます。

次の項を参照してください。

- ピボット表とグラフのキューブ設定の手動による構成

- ビュー内のデータ設定の手動による構成

- 表ビュー、ピボット表ビューおよびトレリス・ビューのデータをフェッチするための設定の手動による構成

ピボット表とグラフのキューブ設定の手動による構成

Cube要素内の設定を使用して、ピボット表およびグラフのデータの表示と処理に作用することができます。この設定はXMLAのエクスポートにも有効です。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. Cubeセクションを見つけて、このセクションに次の要素を追加する必要があります。

- CubeMaxRecords — ビューでの処理用に分析が返す最大レコード数を指定します。この値によって、ビューに移入される最大セル数がだいたい決まります。スパース・ビューの未移入セルはカウントされません。デフォルトは40000です。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Views>
<Cube>
<CubeMaxRecords>40000</CubeMaxRecords>
</Cube>
</Views>
</ServerInstance>

注意:
CubeMaxRecordsとResultRowLimitは両方とも返される行数を制限します。制限は、大きい値の設定によって決定します(「表をレンダリングするために処理する最大行数を設定するためのFusion Middleware Controlの使用」を参照)。

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

ビュー内のデータ設定の手動による構成

表、ピボット表、グラフ、トレリス、ナレーティブ、ティッカおよびツリーマップ・ビューのデータ表示に作用する同様の設定グループを構成できます。

設定の多くは同じですが、対象の要素を該当する各親要素に追加して、そのビューに適用されるデフォルトの設定をオーバーライドする必要があります。たとえば、多数のビューでMaxVisiblePages要素を使用するとします。その場合、Table、Pivot、Trellis、ChartsおよびTreemap親要素内にこの要素を追加して、これらのビュー・タイプの該当する設定のデフォルト値をオーバーライドする必要があります。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるTable、Pivot、Trellis、Charts、Narrative、TickerおよびTreemap親セクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Views>
<Table>
<MaxCells>10000</MaxCells>
<MaxPagesToRollOutInDelivery>1000</MaxPagesToRollOutInDelivery>
<MaxVisiblePages>1000</MaxVisiblePages>
<MaxVisibleRows>500</MaxVisibleRows>
<MaxVisibleSections>25</MaxVisibleSections>
<DefaultRowsDisplayed>30</DefaultRowsDisplayed>
<DefaultRowsDisplayedInDelivery>250</DefaultRowsDisplayedInDelivery>
<DefaultRowsDisplayedInDownload>65000</DefaultRowsDisplayedInDownload>
<DefaultRowsDisplayedInDownloadCSV>65000</DefaultRowsDisplayedInDownloadCSV>
</Table>
<Pivot>
<MaxPagesToRollOutInDelivery>1000</MaxPagesToRollOutInDelivery>
<MaxVisibleColumns>300</MaxVisibleColumns>
<MaxVisiblePages>1000</MaxVisiblePages>
<MaxVisibleRows>500</MaxVisibleRows>
<MaxVisibleSections>25</MaxVisibleSections>
<DefaultRowsDisplayed>30</DefaultRowsDisplayed>
<DefaultRowsDisplayedInDelivery>250</DefaultRowsDisplayedInDelivery>
<DefaultRowsDisplayedInDownload>65000</DefaultRowsDisplayedInDownload>
</Pivot>
<Trellis>
<Simple>
<MaxCells>1000</MaxCells>
<MaxVisibleSections>10</MaxVisibleSections>
<MaxVisiblePages>1000</MaxVisiblePages>
<MaxVisibleRows>100</MaxVisibleRows>
<MaxVisibleColumns>75</MaxVisibleColumns>
<MaxPagesToRollOutInDelivery>1000</MaxPagesToRollOutInDelivery>
<DefaultRowsDisplayed>10</DefaultRowsDisplayed>
<DefaultRowsDisplayedInDelivery>100</DefaultRowsDisplayedInDelivery>
<DefaultRowsDisplayedInDownload>6500</DefaultRowsDisplayedInDownload>
</Simple>
<Advanced>
<MaxCells>5000</MaxCells>
<MaxVisibleSections>50</MaxVisibleSections>
<MaxVisiblePages>1000</MaxVisiblePages>
<MaxVisibleRows>250</MaxVisibleRows>
<MaxVisibleColumns>150</MaxVisibleColumns>
<MaxPagesToRollOutInDelivery>1000</MaxPagesToRollOutInDelivery>
<DefaultRowsDisplayed>25</DefaultRowsDisplayed>
<DefaultRowsDisplayedInDelivery>250</DefaultRowsDisplayedInDelivery>
<DefaultRowsDisplayedInDownload>10000</DefaultRowsDisplayedInDownload>
</Advanced>
</Trellis>
<Charts>
<MaxVisibleColumns>2000</MaxVisibleColumns>
<MaxVisiblePages>1000</MaxVisiblePages>
<MaxVisibleRows>2000</MaxVisibleRows>
<MaxVisibleSections>25</MaxVisibleSections>
<JavaHostReadLimitInKB>4096</JavaHostReadLimitInKB>
</Charts>
<Narrative>
<MaxRecords>40000</MaxRecords>
<DefaultRowsDisplayed>30</DefaultRowsDisplayed>
</Narrative>
<Ticker>
<MaxRecords>40000</MaxRecords>
</Ticker>
<Treemap>
<MaxCells>5000</MaxCells>
<MaxVisiblePages>10000</MaxVisiblePages>
<MaxVisibleRows>10000</MaxVisibleRows>
<MaxVisibleSections>50</MaxVisibleSections>
</Treemap>
</Views>
</ServerInstance>

ファイルに含まれていても、Fusion Middleware Controlによって集中管理され、手動による変更はできない要素については、この例では除外されていますので注意してください。

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

次の表では、ビュー内のデータの表示に作用する一般的な要素について説明します。ユーザーの操作でこれらの値を超えると、ビューのレンダリング時にOracle BIサーバーからエラー・メッセージが返されます。

要素

説明

デフォルト値

該当するビュー

DefaultRowsDisplayed

分析およびダッシュボードのビューに表示するデフォルトの行数を指定します。MaxVisibleRows要素に指定された数を超える行数を指定することはできません。

25 (単純トレリスの場合は10)

ナレーティブ、ピボット表、表、トレリス

DefaultRowsDisplayedInDelivery

ダッシュボードに表示されたときにビューに含めることができるデフォルトの行数を指定します。

単純トレリスの場合は100、拡張トレリス、表およびピボット表の場合は250

ピボット表、表、トレリス

DefaultRowsDisplayedInDownload

PDFファイルなどに、ダウンロードされたときにビューに含めることができるデフォルトの行数を指定します。

65000 (単純トレリスの場合は6500、拡張トレリスの場合は10000)

ピボット表、表、トレリス

DefaultRowsDisplayedInDownloadCSV

CSVファイルにダウンロードされるときにビューに含めることができるデフォルトの行数を指定します。

65000

表

MaxCells

セルの最大数、またはツリーマップの場合、ビューに表示するグループおよびタイルの最大数を指定します。ピボット表、表およびトレリスの場合、この数値は、システムが表示を試みるMaxVisibleColumnsとMaxVisibleRowsを掛けた結果を上回ることができません。

50000 (単純トレリスの場合は1000、ツリーマップの場合は5000)

ピボット表、表、トレリス、ツリーマップ

MaxPagesToRollOutInDelivery

ダッシュボードに表示されたときにビューに含めることができる最大ページ数を指定します。

1000

ピボット表、表、トレリス

MaxRecords

ビューに含めることができる最大レコード数を指定します。

40000

ナレーティブ、ティッカ

MaxVisibleColumns

ビューに表示する最大列数を指定します。

2000 (単純トレリスの場合は75、拡張トレリスの場合は150)

グラフ、ピボット表、トレリス

MaxVisiblePages

ビューに表示する最大ピュー・プロンプト(またはPDFページ)数を指定します。

1000 (ツリーマップの場合は10000)

グラフ、ピボット表、表、トレリス、ツリーマップ

MaxVisibleRows

ビューに表示する最大行数を指定します。DefaultRowsDisplayedには、この値を超える値を指定することはできません。

表およびピボット表の場合は、「最大([tk1])行/ページの表示」ページ・コントロール・ボタンのツールチップに表示する行数を指定します。

2000 (単純トレリスの場合は100、拡張トレリスの場合は250、ツリーマップの場合は10000)

グラフ、ピボット表、表、トレリス、ツリーマップ

MaxVisibleSections

ビューに表示する最大セクション数を指定します。

グラフにスライダがある場合、この要素は適用されません。スライダがある場合は、SectionSliderDefault要素とSectionSliderLimit要素を使用してセクションの値を制限します。表17-*を参照してください。

25 (単純トレリスの場合は10、拡張トレリスおよびツリーマップの場合は50)

グラフ、ピボット表、表、トレリス、ツリーマップ

JavaHostReadLimitInKB

1つのグラフでブラウザに送る最大データ量を指定します。

4096

グラフ

表ビュー、ピボット表ビューおよびトレリス・ビューのデータをフェッチするための設定の手動による構成

データを参照する方法としてスクロールを使用する表ビュー、ピボット表ビューおよびトレリス・ビューのデータのフェッチ方法を指定するには、GridViews要素(DefaultRowFetchSlicesCountなど)内の設定を使用できます。

コンテンツ・デザイナは、「表のプロパティ」ダイアログ: 「スタイル」タブ、「ピボット表のプロパティ」ダイアログまたは「トレリスのプロパティ」ダイアログ: 「一般」タブにある、それぞれ表ビュー、ピボット表ビューまたはトレリスビューで、データの参照に使用する方法(スクロールまたはページ・コントロールのいずれか)を指定します。『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』を参照してください。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるGridViewsの親セクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Views>
<GridViews>
<DefaultRowFetchSlicesCount>1000</DefaultRowFetchSlicesCount>
<DefaultColumnFetchSlicesCount>300</DefaultColumnFetchSlicesCount>
<DefaultFreezeHeadersClientRowBlockSize>60</DefaultFreezeHeadersClientRowBlockSize>
<DefaultFreezeHeadersClientColumnBlockSize>15</DefaultFreezeHeadersClientColumnBlockSize>
<DefaultFreezeHeadersWidth>1000</DefaultFreezeHeadersWidth>
<DefaultFreezeHeadersHeight>1000</DefaultFreezeHeadersHeight>
<DefaultScrollingEnabled>false</DefaultScrollingEnabled>
</GridViews>
</Views>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

次の表では、データのフェッチのための一般的な要素について説明します。

要素

説明

デフォルト値

DefaultRowFetchSlicesCount

スクロールするビューが最初に表示されるときに、そのサイズの計算に使用する最大行数を指定します。ユーザーがビュー内の最後の行までスクロールすると、(さらに行がある場合は)残りの行をフェッチするためのリンクが表示されます。

1000

DefaultColumnFetchSlicesCount

スクロールするビューが最初に表示されるときに、そのサイズの計算に使用する最大列数を指定します。ユーザーがビュー内の最後の列までスクロールすると、(さらに列がある場合は)残りの列をフェッチするためのリンクが表示されます。

300

DefaultFreezeHeadersClientRowBlockSize

AJAXリクエストで(つまり、ユーザーのスクロールにより、表ビュー、ピボット表ビューまたはトレリス・ビューに行を追加するようサーバーに対してリクエストが必要となるような場合)、クライアントに返す行数を指定します。

60

DefaultFreezeHeadersClientColumnBlockSize

AJAXリクエストで(つまり、ユーザーのスクロールにより、表ビュー、ピボット表ビューまたはトレリス・ビューに列を追加するようサーバーに対してリクエストが必要となるような場合)、クライアントに返す列数を指定します。

15

DefaultFreezeHeadersWidth

表ビュー、ピボット表ビューおよびトレリス・ビューのデフォルトの最大幅をピクセルで指定します。

ビューのプロパティ・ダイアログの「最大幅」フィールドを使用して、コンテント・デザイナはこの値をオーバーライドします。

700

DefaultFreezeHeadersHeight

表ビュー、ピボット表ビューおよびトレリス・ビューのデフォルトの最大高さをピクセルで指定します。

ビューのプロパティ・ダイアログの「最大高さ」フィールドを使用して、コンテント・デザイナはこの値をオーバーライドします。

400

DefaultScrollingEnabled

次のように、テーブル・ビューのデータ・ビューのスクロールを指定します。

- false (インストール時のデフォルト)は、「スクロール・コンテンツがある固定ヘッダー」としてデータ・ビューで出力を表示するようにレポートを設定します。

- trueは、「コンテンツ・ページング」としてデータ・ビューを表示するようにレポートを設定します。

false

グラフとゲージの手動による構成

ファンネル・グラフやゲージなどのグラフの表示を変更する様々なオプションを構成できます。

このタイプのビューは、「ビュー内のデータの手動による構成」で説明している設定の影響も受けます。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるChartsセクションを検索します。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Views>
<Charts>
<EmbedFonts>true</EmbedFonts>
<SectionSliderDefault>150</SectionSliderDefault>
<SectionSliderLimit>300</SectionSliderLimit>
<DefaultWebImageType>flash</DefaultWebImageType>
<FlashCodeBase>\\CORPORATE\Download\Flash</FlashCodeBase>
<FlashCLSID>E38CDB6E-BA6D-21CF-96B8-432553540000</FlashCLSID>
</Charts>
</Views>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

要素

説明

デフォルト値

EmbedFonts

詳細は、「グラフのフォントの構成」を参照してください。

false

DefaultWebImageType

ビューのURLまたはXMLファイルでイメージのレンダリング形式が指定されていない場合に使用するデフォルトのレンダリング・タイプを指定します。有効な値は次のとおりです。

- flash
フラッシュ・フォーマットをサポートしていないブラウザでは、イメージはレンダリングしません。かわりに、html5を値として使用してください。

- png (W3C Portable Network Graphics)

- svg (W3C Scalable Vector Graphics)
このリリースでは値svgはサポートされていないため、svgを指定した場合はflashが使用されます。

- html5
html5フォーマットをサポートしていないブラウザでは、イメージはかわりにフラッシュ・フォーマットでレンダリングします。

Flash、pngおよびhtml5メージは、マウスオーバー動作(ポップアップデータラベルなど)、ナビゲーションおよびドリルをサポートしているため、最大限の対話が可能です。

flash

SectionSliderDefault

セクションのスライダ・バーに表示可能な値のデフォルト数を指定します。セクション・スライダは、1つ以上の属性列または階層列のメンバーを長方形の棒上の値として表示し、値を選択するメカニズムを提供します。

グラフ、ゲージおよびファンネルでのセクション・スライダの定義の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

5

SectionSliderLimit

セクションのスライド・バーに表示可能な値の最大数を指定します。

10

FlashCodeBase

Flashプラグインのダウンロード元の名前を指定します。Flashプラグインのデフォルトのダウンロード元はベンダーのWebサイトです。組織によっては、ベンダーのWebサイトではなく社内の一定の場所から最新のFlashソフトウェアをダウンロードするようにユーザーに指示する場合もあります。この設定を編集して、Flashコード・ベースが格納されている別の場所を指すように変更できます。それにより、ユーザーがグラフを表示したときに企業サーバーにFlashの新しいバージョンがあれば、新バージョンをダウンロードするようにユーザーに指示できます。

ベンダーのWebサイト

FlashCLSID

Flashのダウンロード時に適用するカスタムのグローバル識別子(clsid)プロパティを指定します。

FlashCodeBase要素を使用してFlashのダウンロード・ディレクトリを変更した後に、Flash ActiveXコントロールの新しいclassIDを作成してカスタムのグローバル識別子プロパティを追加することによって、ダウンロードのプロンプトを有効化できます。現在のグローバル識別子プロパティは、Oracle BIプレゼンテーション・サービスのグラフを使用しているどのコンピュータからも取得できます。(Oracle Business Intelligenceで使用されているグローバル識別子プロパティはD27CDB6E-AE6D-11CF-96B8-444553540000です)。カスタムのグローバル識別子プロパティは、デフォルトのFlash ActiveXコントロールで使用されているグローバル識別子と同じ数の文字およびダッシュで構成する必要があります。

Oracle Business Intelligenceとは別に、Flashのグラフをテストして、グラフがカスタムのグローバル識別子プロパティで機能することを確認してください。

デフォルト値なし

グラフのフォントの構成

グラフのフォントを構成する方法は2つあります。

- 埋込みフォント要素の設定

- 印刷用フォント・ファイルの配布

埋込みフォント要素の設定

デフォルトでは、グラフで多言語のテキストを表示するためには、ユーザーのシステムに適切なデバイス・フォントがインストールされていることが必要になります。ユーザーがO1の軸ラベルで回転を有効にした場合、一定の角度のときにグラフの見栄えが悪くなる可能性があります。アンチエイリアスを何も適用しない状態でもラベルがぼやけて表示されます。EmbedFonts要素をtrueに設定して、デバイス・フォントではなく埋込みフォントを使用するように指定すれば、この問題が解決されます。

埋込みフォントの使用によって忠実性が失われるおそれがある点に注意してください。エンド・ユーザーがフォントを選択するたびに、Oracleがライセンスするプレーン・フォントAlbany WTがデフォルトで表示されることになります。グラフ・エンジンは中国語、日本語および韓国語ロケール用の埋込みフォントを備えていないため、これらのロケールのユーザーがラベルを回転した場合、フォントの見栄えが悪くなります。

印刷用フォント・ファイルの配布

双方向言語を使用しているグラフのPDFへの印刷や、中国語、日本語または韓国語を使用しているグラフのPNGイメージへの印刷を予定している場合は、必要なフォント・ファイル(.TTF)を次の方法で配布する必要があります。

- 双方向言語のグラフをPDFに印刷する場合は、Albanyフォント・ファミリを次のJava Runtime Environment(JRE)ディレクトリに配布する必要があります。
JAVA.HOME/lib/fonts

このJAVA.HOMEは、java.homeシステム・プロパティで指定されているディレクトリ名です。

- 中国語、日本語または韓国語のグラフをPNGイメージに印刷する場合は、必要なすべての絵文字を含むフォント・ファイルを次のJREディレクトリに配布する必要があります。
lib/fonts/fallback

フォント構成ファイルの詳細は、使用しているJavaのドキュメントを参照してください。

グラフおよびゲージのレンダリングの構成

イメージをレンダリングするデフォルト・タイプが、ビューのURLまたはXMLファイルでまだ指定されていない場合、DefaultWebImageType要素を使用して指定します。

有効な値は次のとおりです。

- flash
フラッシュ・フォーマットをサポートしていないブラウザでは、グラフまたはゲージはレンダリングしません。かわりに、html5を値として使用してください。

- png (W3C Portable Network Graphics)

- svg (W3C Scalable Vector Graphics)
このリリースでは値svgはサポートされていないため、svgを指定した場合はflashが使用されます。

- html5
フラッシュ・フォーマットのみをサポートしているブラウザでは、グラフまたはゲージはフラッシュ・フォーマットでレンダリングします。

FlashおよびSVGイメージは、マウスオーバー動作(ポップアップデータラベルなど)、ナビゲーションおよびドリルをサポートしているため、最大限の対話が可能です

交互する行の色の手動による変更

表およびピボット表では、交互する行の色を設定できます。このような書式設定は、隔行の色を緑色にするスタイル設定と呼ばれることもあります。この設定の隔行のデフォルトの色は緑です。ピボット表の場合、コンテンツ・デザイナは、表およびピボット表の編集時に、交互する行の色設定を有効にするかどうかやその他の書式設定機能を制御できます。

管理者は、スタイル構成ファイルを編集することによって、交互する行のデフォルトの色を変更できます。色を変更するには、b_mozilla_4フォルダにあるviews.cssファイルを次のように編集します。6桁の16進値を新しい色の値に変更します。

- CSSセレクタを使用する表:
.ECell(偶数行)

.OCell(奇数行)

- CSSセレクタを使用するピボット表:
.PTE (奇数行)

交互する行の色の設定を有効にするオプションは、「ビューの編集」ダイアログにあり、「隔行の色を緑にするスタイル設定を有効にする」といるラベルが付いています。行の色を変えた場合は、必要に応じて、設定した色に合せてこのラベルも変更します。

表およびピボット表のダイアログ内のラベルを変更するには、tableviewmessages.xmlファイルを開いて次のエントリを探します。

WebMessageName = "kmsgTableViewEnableGreenbarReporting"

このエントリとその下にあるテキスト行をカスタム・メッセージ・フォルダのカスタム・メッセージ・ファイルにコピーし、テキスト行を適切に変更します。例:

WebMessageName = "kmsgTableViewEnableGreenbarReporting"
<TEXT>Enable alternating row "RED bar" styling</TEXT>"

ビュー内の相互作用の手動による構成

実行時に分析のビューを右クリックすることで起こる相互作用の処理方法を変更する各種オプションを構成できます。

新規またはアップグレードした分析のデフォルトの設定は、instanceconfig.xmlファイル内の要素を使用して指定します。プレゼンテーション・サービスで分析のプロパティを編集し、分析のビューを右クリックすることで起こる相互作用の処理方法を変更できます。

1. 次のinstanceconfig.xmlファイルを開いて編集します。
BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるセクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Analysis>
<InteractionProperties>
<InteractionPropertyAddRemoveValues>false</InteractionPropertyAddRemoveValues>
<InteractionPropertyCalcItemOperations>false</InteractionPropertyCalcItemOperations>
<InteractionPropertyDrill>true</InteractionPropertyDrill>
<InteractionPropertyGroupOperations>false</InteractionPropertyGroupOperations>
<InteractionPropertyInclExclColumns>true</InteractionPropertyInclExclColumns>
<InteractionPropertyMoveColumns>true</InteractionPropertyMoveColumns>
<InteractionPropertyRunningSum>false</InteractionPropertyRunningSum>
<InteractionPropertyShowHideSubTotal>false</InteractionPropertyShowHideSubTotal>
<InteractionPropertySortColumns>true</InteractionPropertySortColumns>
<InteractionPropertyHideColumns>false</InteractionPropertyHideColumns>
</InteractionProperties>
</Analysis>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

要素

説明

デフォルト値

InteractionPropertyAddRemoveValues

「値の追加/削除」オプションが「分析プロパティ」ダイアログの「相互作用」タブでデフォルトで選択されるようにするかどうかを指定します。

false

InteractionPropertyCalcItemOperations

「計算項目の作成/編集/削除」オプションが「分析プロパティ」ダイアログの「相互作用」タブでデフォルトで選択されるようにするかどうかを指定します。

false

InteractionPropertyDrill

「ドリル(プライマリ相互作用でない場合)」オプションが「相互作用」タブの「分析プロパティ」ダイアログでデフォルトで選択されるようにするかどうかを指定します。

true

InteractionPropertyGroupOperations

「グループの作成/編集/削除」オプションが「分析プロパティ」ダイアログの「相互作用」タブでデフォルトで選択されるようにするかどうかを指定します。

false

InteractionPropertyInclExclColumns

「列を含める/除外」オプションが「分析プロパティ」ダイアログの「相互作用」タブでデフォルトで選択されるようにするかどうかを指定します。

true

InteractionPropertyMoveColumns

「列の移動」オプションが「相互作用」タブの「分析プロパティ」ダイアログでデフォルトで選択されるようにするかどうかを指定します。

true

InteractionPropertyRunningSum

「累計の表示/非表示」オプションが「分析プロパティ」ダイアログの「相互作用」タブでデフォルトで選択されるようにするかどうかを指定します。

false

InteractionPropertyShowHideSubTotal

「小計の表示/非表示」オプションが「分析プロパティ」ダイアログの「相互作用」タブでデフォルトで選択されるようにするかどうかを指定します。

false

InteractionPropertySortColumns

「列のソート」オプションが「分析プロパティ」ダイアログの「相互作用」タブでデフォルトで選択されるようにするかどうかを指定します。

true

プロンプトの構成

ユーザーのプロンプト操作方法に作用する設定を構成できます。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるセクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Prompts>
<MaxDropDownValues>256</MaxDropDownValues>
<ResultRowLimit>65000</ResultRowLimit>
<AutoApplyDashboardPromptValues>true</AutoApplyDashboardPromptValues>
<AutoSearchPromptDialogBox>true</AutoSearchPromptDialogBox>
<AutoCompletePromptDropDowns>
<SupportAutoComplete>true</SupportAutoComplete>
<CaseInsensitive>true</CaseInsensitive>
<MatchingLevel>MatchAll</MatchingLevel>
<ResultsLimit>50</ResultsLimit>
</AutoCompletePromptDropDowns>
<ShowNullValueWhenColumnIsNullable>never</ShowNullValueWhenColumnIsNullable>
</Prompts>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

要素

説明

デフォルト値

AutoApplyDashboardPromptValues

次のリストに示す各種フィールドを表示するかどうかを指定します。

trueの場合

- 「ページ設定の編集」ダイアログに「「適用」ボタンの表示」および「「リセット」ボタンの表示」フィールドが表示されます。

- 「ダッシュボードのプロパティ」ダイアログに「「適用」ボタンのプロンプト」および「「リセット」ボタンのプロンプト」フィールドが表示されます。

- ダッシュボード・ビルダーの「ツール」メニューに「現在のページのボタンをプロンプト」オプションが表示されます。

falseの場合

- 「ページ設定の編集」ダイアログに「「適用」ボタンの表示」および「「リセット」ボタンの表示」フィールドが表示されません。

- 「ダッシュボードのプロパティ」ダイアログに「「適用」ボタンのプロンプト」および「「リセット」ボタンのプロンプト」フィールドが表示されません。

- ダッシュボード・ビルダーの「ツール」オプションに「現在のページのボタンをプロンプト」オプションが表示されません。

true

AutoSearchPromptDialog

ユーザーが検索パラメータを(「検索」ボタンをクリックせずに)入力した場合に、検索結果がハイライト表示されるようにするかどうかを指定します。

true

CaseInsensitive

オートコンプリート機能で大/小文字を区別しないかどうかを指定します。trueに設定すると、ユーザーが「Oracle」や「oracle」などのプロンプト値を入力した場合に大/小文字は区別されません。falseに設定すると、ユーザーがプロンプト値を入力した場合に大/小文字が区別されるので、Oracleレコードを検索するには、「oracle」ではなく「Oracle」と入力する必要があります。システムによって、大/小文字を適切に使用した値を入力するよう求められます。

true

Matching Level

ユーザーがプロンプト・フィールドに入力したプロンプト値を検索するために、オートコンプリート機能で一致検索を使用するかどうかを指定します。ユーザーが「検索」ダイアログにアクセスしてプロンプト値の検索および指定を行う場合、これらの設定は適用されません。

次の設定を使用します。

- StartsWith: ユーザーが入力したテキストで始まる値を検索します。 たとえばユーザーが「M」と入力すると、保存されている値から「MicroPod」や「MP3 Speakers System」が一致として表示されます。

- WordStartsWith: 1つの単語または単語のグループの先頭で一致を検索します。 たとえばユーザーが「C」と入力すると、「ComCell」、「MPEG Camcorder」および「7 Megapixel Digital Camera」が一致として表示されます。

- MatchAll: 1つまたは複数の単語内で任意の一致を検索します。

MatchAll

MaxDropDownValues

次の場所に表示する最大選択数を指定します。

- 実行時のプロンプトの選択リスト、チェック・ボックス、リスト・ボックスおよびラジオ・ボタン。

- 実行時、ユーザーがプロンプト値リストから「検索」オプションを選択したときの「値の選択」ダイアログの「値」リスト。

- 設計時のフィルタ・エディタの「値」リスト、およびユーザーがフィルタ・エディタの「値」リストから「検索」リンクをクリックしたときに表示される「値の選択」ダイアログの「使用可能」リスト。

- 設計時、ユーザーが「選択リストの値」フィールドの「特定の列値」または「デフォルトの選択」フィールドの「固有値」を選択し、対応する「値の選択」ボタンをクリックすると表示される、「値の選択」ダイアログの「使用可能」リスト。

- 設計時、スライダ・ユーザー入力タイプで作業している場合に、「下限」、「上限」、「デフォルトの下限」および「デフォルトの上限」フィールドに表示されるリスト、またはこれらのいずれかのフィールド内でユーザーが対応する「検索」リンクをクリックした場合に表示されるリスト。

256

ResultsLimit

オートコンプリート機能が有効な場合に返される一致する値の数を指定します。

50

ResultRowLimit

プロンプト(分析およびダッシュボード・プロンプト)の論理SQLから返されるレコード数を指定します。

65000

ShowNullValueInPromptsWhenDatabaseColumnIsNullable

データベースでnull値を許容する場合、ドロップダウン・リストで列セパレータの上に位置する列プロンプトに単語"NULL"を実行時に表示するかどうかを指定します。

次の設定を使用します。

- always — ドロップダウン・リストで列セパレータの上に単語"NULL"を常に表示します。

- never — ドロップダウン・リストに単語"NULL"を一切表示しません。

- asDataValue — ドロップダウン・リストで列セパレータの上に単語"NULL"としてではなく、ドロップダウン・リストにデータ値として表示します。

always

SupportAutoComplete

プロンプトのオートコンプリート機能を有効または無効にします。trueに設定するとオートコンプリートがオンになり、「マイ・アカウント」ダイアログおよび「ダッシュボードのプロパティ」ダイアログに「オートコンプリートのプロンプト」フィールドが表示され、「オン」に設定されます。

falseに設定するとオートコンプリートがオフになり、「マイ・アカウント」ダイアログおよび「ダッシュボードのプロパティ」ダイアログにはオートコンプリートのフィールドが表示されません。

Oracle Exalytics In-Memory MachineでOracle BI EEを実行していないかぎり、false

プレゼンテーション設定の手動による変更

ダッシュボードとプレゼンテーションの表示設定を構成できます。

次の項を参照してください。

- プレゼンテーション設定のデフォルトの手動変更

- プレゼンテーション・サービスでのカスタム・リンクの提供

- ダッシュボード・ページへのリンクの作成機能の有効化

- Oracle BI Publisherの代替ツールバーの構成

- ダッシュボード・ページをOracle BI Publisherにエクスポートする機能の有効化

- ブリーフィング・ブックのPDFバージョンの目次の変更

- Smart Viewインストーラ用のカスタム・ダウンロード・リンクの構成

プレゼンテーション設定のデフォルトの手動変更

Fusion Middleware Controlで変更できるプレゼンテーション設定に加えて、他の設定を手動で変更できます。これらの設定を変更するには、instanceconfig.xmlファイルの様々な要素を使用します。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるセクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<AnalysisEditorStartTab>answerResults</AnalysisEditorStartTab>
<Enable508>false</Enable508>
<Dashboard>
<DefaultName>Templates</DefaultName>
<EnableDelayExecution>true</EnableDelayExecution>
</Dashboard>
<BriefingBook>
<MaxFollowLinks>6</MaxFollowLinks>
</BriefingBook>
<Formatters>
<NumericFormatter maxSignificantDigits="16"/>
<Formatters>
</ServerInstance>

注意:
ファイルに含まれていても、Fusion Middleware Controlによって集中管理され、手動による変更はできない要素については、この例では除外されていますので注意してください。

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

要素

説明

デフォルト値

AnalysisEditorStartTab

「基準」タブまたは「結果」タブにデフォルトで分析エディタを開くかどうかを指定します。この設定は、ダッシュボード、ホーム・ページまたは「カタログ」ページから、分析の「編集」リンクをクリックすると適用されます。

有効な値は次のとおりです。

- answerResults

- answerCriteria

このデフォルト設定は、「マイ・アカウント」ダイアログで「フル・エディタ」オプションを設定するとオーバーライドできます。

answerResults

Enable508

スクリーン・リーダーの使用を容易にする方法で、Oracle BI EEのコンテンツをブラウザでレンダリングするかどうかを指定します。

trueに設定すると、「分析エディタ」コンポーネントの設定に関係なく、アクセシビリティ・モードのBIコンポーザ・ウィザードが分析エディタとして使用されます。

falseに設定すると、「分析エディタ」コンポーネントの設定が「ウィザード(制限付き機能)」の場合は、標準モードのBIコンポーザ・ウィザードが分析エディタとして使用されます。

このデフォルト設定は、「サインイン」ページまたは「マイ・アカウント」ダイアログで「アクセシビリティ・モード」オプションを設定するとオーバーライドできます。

false

DefaultName

ダッシュボード・テンプレート・ページを格納するダッシュボードに使用する名前を指定します。ここで指定した名前によって、Oracle BI EEによるダッシュボード・テンプレート・ページの検索場所のパスがオーバーライドされます。デフォルトでは、Oracle BI EEによるダッシュボード・テンプレート・ページの検索は、「/共有フォルダ」にあるdefaultという名前のダッシュボードで行われます。

default

EnableDelayExecution

コンテンツ・デザイナがダッシュボード・ページの実行を遅延できるかどうかを指定します。trueに設定すると、「ダッシュボードのプロパティ」ダイアログに「開く前に プロンプト」オプションが表示されます。Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドのダッシュボード・ページの実行の遅延に関する項を参照してください。

true

MaxFollowLinks

ブリーフィング・ブックでたどるナビゲーション・リンクの最大数のデフォルト値を指定します。ブリーフィング・ブックのナビゲーション・リンクは、ダッシュボード・ビルダーを使用してダッシュボードに追加できるリンク・タイプです。

この要素のデフォルト値は5、最小値は1、最大値は10です。

ブリーフィング・ブックをPDF形式でダウンロードすることを予定している場合は、目次のリンク数が9個までに制限されているため、この要素の値を9以下に設定します。目次の詳細は、「ブリーフィング・ブックのPDFバージョンの目次の変更」を参照してください。

ブリーフィング・ブックの使用の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

5

NumericFormatter

固定桁数で一貫した出力を行うために使用する値を指定します。一定の有効桁数を超えると、数字が適切に表示されない場合があります。Linuxプラットフォームの16のように、最大有効桁数を指定する場合はこの設定を使用します。

デフォルト値なし

注意:

Bookmarks、MaxAgeMinutes、EnableBookmarkURLおよびEnablePromptedURL要素のデフォルト値の詳細は、「ダッシュボード・ページへのリンク作成機能の有効化」を参照してください。ReportingToolbarMode要素のデフォルト値の詳細は、「Oracle BI Publisherの代替ツールバーの構成」を参照してください。

プレゼンテーション・サービスにおけるカスタム・リンクの提供

Oracle BI EEのグローバル・ヘッダーには、デフォルトで、機能間の移動を容易にするメニューおよびオプションが含まれています。特定のリンクを無効にしたり固有のリンクを含めたりすることで、グローバル・ヘッダーおよびホーム・ページの「はじめに」セクションをカスタマイズできます。これにより、ユーザーのニーズにより適切に対応することが可能になります。

「はじめに」セクションを変更しても、グローバル・ヘッダーの「ヘルプ」メニューには影響しません。カスタム・リンクには、次のような属性を指定できます。

- リンクのテキスト(静的文字列またはローカライゼーション用に使用するメッセージ名)。

- アクセスするURL。

- URLから開くページで現在のページを置き換えるかどうか、またはそのページを名前を指定した新しいタブやウィンドウで開くかどうか。

- ヘッダー内のリンクの相対的な順序付け。

- リンクとともに使用するオプションのアイコン。

グローバル・ヘッダーをカスタマイズするには、次の各項で説明しているタスクを実行します。

- customlinks.xmlファイルの更新

- CustomLinks要素の追加

- カスタム・リンク権限の設定

customlinks.xmlファイルの更新

次の各項の説明に従ってcustomlinks.xmlファイルを更新し、グローバル・ヘッダーに対してカスタマイズを指定します。

ファイルのデフォルトの場所

このファイルはデフォルトで、プレゼンテーション・サービスの次のデータ・ディレクトリにあります。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

ファイル内の要素

次の表は、customlinks.xmlファイルで指定できる要素と属性について説明しています。デフォルトで表示される既存のリンクを非表示にするには、それらのエントリをファイルでコメント・アウトできます。「お気に入り」や「ダッシュボード」などのデフォルトのリンクの順序は変更できません。

要素または属性

オプションかどうか

データ型

説明

locations

オプション

該当なし

追加するリンクの場所を指定するための親要素として使用します。場所を指定しない場合はデフォルトで、グローバル・ヘッダーの「ヘルプ」リンクの前、「はじめに」セクションの終わりにリンクが配置されます。

location: name

必須

String

locations親要素を指定する場合は、この属性を使用します。値は次のとおりです。

header: グローバル・ヘッダーにリンクを配置するように指定します。

getstarted: ホーム・ページの「はじめに」セクションにリンクを配置するように指定します。

location: insertBefore

オプション

String

その前にこのリンクを挿入する、既存のリンクのIDを指定します。指定したIDが無効な場合、リンクはデフォルトの場所に挿入されます。

有効な値の詳細は、「insertBefore属性の指定」を参照してください。

link: id

必須

String

リンクの位置を指定する一意のIDとして使用します。カスタム・リンクのIDを指定し、それらをデフォルト・リンクに対して相対的な場所に配置できます。

link: name

必須

String

翻訳されないリンクの名前を指定します。

link: localizedName

オプション

String

翻訳されるリンクのメッセージIDを指定します。これは、翻訳されない名前に優先します。

link: iconSmall

オプション

String

グローバル・ヘッダーにリンクとともに表示するアイコンのファイル名を指定します。アイコンの表示はfmap構文によって制御されます。

fmap構文の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドを参照してください。

link: iconLarge

オプション

String

「はじめに」セクションにリンクとともに表示するアイコンのファイル名を指定します。アイコンの表示はfmap構文によって制御されます。

link: privilege

オプション

String

リンクを表示するためにユーザーへの付与が必要な権限の名前を指定します。次の例に示すように、この権限は式として表されます。

privileges.Access['Global Answers']&amp;&amp; privileges.Access['Global Delivers']

link: accessibility

オプション

Boolean

アクセシビリティ・モードで、accessibility属性がtrueに設定されている場合にのみリンクが使用可能になるように指定します。値は、trueおよびfalseで、falseがデフォルトです。

以前のリリースでは、vpat属性はaccessibility属性と同じ目的を果たしていました。vpat属性は非推奨となりました。

link: src

必須

String

リンクのURLを指定します。

link: target

オプション

String

リンクを開くブラウザ・ウィンドウを指定します。値は次のとおりです。

self: プレゼンテーション・サービスが実行されているウィンドウと同じウィンドウで開きます。

blank: 新しいウィンドウで開きます。

any-name: 指定された名前のウィンドウで開きます。

link: description

オプション

String

翻訳されないリンクの説明を指定します。

link: localizedDesc

オプション

String

翻訳されるリンクのメッセージIDを指定します。これは、翻訳されない説明に優先します。

「Oracle Business Intelligenceプロセスの管理」で説明されているように、customlinks.xmlファイルの更新後、このファイルは次回プレゼンテーション・サービスを再起動する際にリロードされます。

insertBefore属性の指定

前述の表で説明しているinsertBefore属性を含めると、その前に別のリンクを挿入する、既存のリンクのIDを指定できます。次のリストは、グローバル・ヘッダーの有効なIDを示しています。

- Navigation Bar

- catalog

- dashboard

- favorites

- home

- new

- open

- user

- Search Bar

- admin

- advanced

- help

- logout

そのコンテンツをカスタマイズできるよう、「はじめに」セクションには固定されたIDは含まれません。

ファイルと出力の例

次のコード例は、リンクをグローバル・ヘッダーと「はじめに」セクションに配置するよう編集した、customlinks.xmlファイルの一部を示しています。

<link id="l1" name="OTN" description="OTN open in new window" src="http://www.oracle.com" target="blank" >
<locations>
<location name="header" />
</locations>
</link>

<link id="l2" name="Google Search" description="Google open in named window" src="http://www.google.com/" target="google" iconSmall="common/info_ena.png" >
<locations>
<location name="header" insertBefore="advanced" />
</locations>
</link>

<link id="l3" name="Yahoo" description="Yahoo" src="http://www.yahoo.com" target="yahoo" iconLarge="common/helptopics_lg_qualifier.png">
<locations>
<location name="getstarted" />
</locations>
</link>

<link id="l5" name="Gmail" description="gmail" src="http://www.gmail.com" target="blank" iconLarge="common/gmail.png" >
<locations>
<location name="getstarted" />
<location name="header" insertBefore="catalog" />
</locations>
</link>

このファイルは、次のように「ホーム」ページを変更します。ホーム・ページに対する次の変更に注意してください。

- 次を含むようにグローバル・ヘッダーが変更されます。

- Google Search: カスタム・アイコンを使用するGoogleホーム・ページへのリンク。「詳細」リンクの前に配置されます。

- OTN: Oracle Technology Networkページへのリンク。「ヘルプ」リンクの前に配置されます。

- Gmail: Gmailホーム・ページへのリンク。「カタログ」リンクの前に配置されます。

- 「はじめに」セクションが変更され、カスタム・アイコンを使用するYahoo!およびGmailのホーム・ページへのリンクが含まれます。

CustomLinks要素の追加

カスタム・リンクをホーム・ページに表示する前に、instanceconfig.xmlファイルを編集して、その中にCustomLinks要素とEnabled要素を含める必要があります(このデフォルトはtrueになります)。CustomLinks要素を省略することはEnabled要素をfalseに設定することと同じです。カスタム・リンクは表示されません。

customlinks.xmlファイルはデフォルト以外の場所にも格納できます。デフォルト以外の場所に格納し、customlinks.xmlファイルで指定した変更をホーム・ページ上に表示するには、filePath要素をこのファイルに追加する必要があります。customlinks.xmlファイルをそのままデフォルトの場所に置く場合は、instanceconfig.xmlファイルにfilePath要素を含める必要はありません。「ファイルのデフォルトの場所」を参照してください。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. ServerInstanceセクションを探し、ここにCustomLinks要素を追加する必要があります。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<CustomLinks>
<Enabled>true</Enabled>
<filePath>c:/mydir/mysubdir/customlinks.xml</filePath>
</CustomLinks>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

カスタム・リンク権限の設定

カスタマイズをユーザーに表示するには、ソフトウェアを適切に構成する必要があります。

実行したカスタマイズをユーザーが表示できるようにするには、カスタム・リンク権限がBI Consumerロールに割り当てられていることを確認する必要があります。この割当てはデフォルトで行われます。この権限は、BI Consumer以外の個人ユーザー、グループまたはロールに割り当てることはできません。

この権限のロールを確認するには、プレゼンテーション・サービスの「管理」ページにある「権限の管理」ページを使用します。詳細は、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドのプレゼンテーション・サービスの権限の管理に関する項 を参照してください。

ダッシュボード・ページへのリンクの作成機能の有効化

ユーザーは、ダッシュボード・ページへのリンク(ブックマーク・リンクとプロンプト・リンクの両方)を作成できます。

それによって、たとえば、リンクをブックマークとして保存したり、リンクをコピーして電子メールで他のユーザーに送信したりできます。ブックマークは、ダッシュボード・ページの状態を取得する非表示オブジェクトであり、Oracle BIプレゼンテーション・カタログの/system/bookmarksフォルダに格納されます。ユーザーがページのブックマーク・リンクを作成すると、ブックマークが作成されます。システム管理者は、ダッシュボード・ページへのこれらのリンクの作成機能を有効または無効にできます。また、ユーザーがこれらのリンクを作成できるようにするには、この機能に関連付けられた「ブックマーク・リンクの作成」権限と「プロンプト・リンクの作成」権限を付与する必要があります。

これらのリンクの詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドのダッシュボード・ページへのリンクの作成に関する項を参照してください。権限の詳細は、『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』のプレゼンテーション・サービス権限の管理に関する項を参照してください。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. Server Instanceセクションを見つけます。

3. 必要に応じて、次の要素とその祖先要素を含めます。

- EnableBookmarkURL: ダッシュボード・ページへのブックマーク・リンクの作成機能を有効にするには、この要素を使用します。

- true: ブックマーク・リンク作成機能を有効にします(デフォルト)

- false: ブックマーク・リンク作成機能を無効にします。

- EnablePromptedURL: ダッシュボード・ページへのプロンプト・リンクの作成機能を有効にするには、この要素を使用します。

- true: プロンプト・リンク作成機能を有効にします(デフォルト)

- false: プロンプト・リンク作成機能を無効にします。

- MaxAgeMinutes: Bookmarks要素内でこの要素を使用することによって、指定した分数より前のブックマークを削除することを指定できます。デフォルトは43200分(=30日)です。
ブックマークにアクセスするたびに、そのブックマークの有効期限のタイマがリセットされる点に注意してください。つまり、ブックマークへのアクセスが頻繁に行われる場合、そのブックマークはいつになっても削除されない可能性があります。この値を0に設定した場合、ブックマークの保存期間が0分であることを意味します(有効期限なしを意味するわけではありません)。ブックマークを有効期限なしとして設定することはできません。ブックマークが長期間維持されるようにするには、この分数の値を大きくするとともに、割り当てた分数が経過する前にブックマークにアクセスします。

この設定の入力例を次に示します。

<ServerInstance>
<Dashboard>
<EnableBookmarkURL>true</EnableBookmarkURL>
<EnablePromptedURL>true</EnablePromptedURL>
</Dashboard>
<Cache>
<Bookmarks>
<MaxAgeMinutes>43200</MaxAgeMinutes>
</Bookmarks>
</Cache>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

Oracle BI Publisherの代替ツールバーの構成

BI Publisherレポートをダッシュボードに含める場合は通常、コア・ダッシュボード・プロンプトを使用してそのレポートにダッシュボードのコンテキストを渡すことにより、そのレポートをダッシュボードの状態の受信者として加えることができます。

ダッシュボードベースの大きなAnalyticsアプリケーションとBI Publisherレポートとの間においてコンテキストの授受が必要でない場合、デフォルトのBI Publisherツールバーが一部変更されたツールバーを表示できます。そのツールバーには、BI Publisherレポートで基礎となるパラメータ・プロンプトが表示されます。そのフレーム内において、ユーザーはパラメータを単一のBI Publisherレポートに渡すことができます。

このアプローチの場合、ページ上の他のダッシュボード・プロンプトがBI Publisherレポートに作用せず、またアプリケーションの他の部分へのコンテキストの受渡しにも関与しないため、ユーザーを混乱させる可能性があります。さらに、BI Publisherツールバーの変更は、BI Publisherインスタンス全体でダッシュボードに埋め込まれているすべてのBI Publisherレポートにグローバルに適用されます。

Oracle BI EEへのBI Publisherレポートの埋込み方法に作用するには、ReportingToolbarMode要素を使用します。BI Publisherの代替ツールバーを構成するには、この要素の値を6に設定します。ツールバーのデフォルトの動作に戻すには、ReportingToolbarMode要素を削除するか、またはこの要素の値をデフォルトの1に設定します。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. ReportingToolbarMode要素を追加する必要があるAdvancedReportingセクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<AdvancedReporting>
<ReportingToolbarMode>6</ReportingToolbarMode>
</AdvancedReporting>
</ServerInstance>

この要素の値は次のとおりです。

- 1 = ツールバーを表示しません。

- 2 = ロゴ、ツールバー、タブおよびナビゲーション・パスなしでレポートのURLを表示します。

- 3 = ヘッダーおよびパラメータ選択なしでレポートのURLを表示します。「テンプレート選択」、「表示」、「エクスポート」、「送信」などのコントロールは、引き続き使用できます。

- 4 = レポートのURLのみを表示します。他のページ情報やオプションはいずれも表示しません。

- 6 = BI Publisherレポートのパラメータ・プロンプトを表示するBI Publisherツールバーを表示します。

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

Oracle BI Publisherへのダッシュボード・ページのエクスポート機能の有効化

コンテンツ・デザイナは、ダッシュボード・ページを印刷およびエクスポートするためのカスタム・レイアウトを作成します。

コンテンツ・デザイナがダッシュボード・ページのカスタム・レイアウトを作成すると、ダッシュボード・ページがOracle BI Publisherにエクスポートされます。システム管理者は、EnableDashPageExport要素を設定することによって、Oracle BI Publisherへのダッシュボード・ページのエクスポート機能を有効または無効にできます。

『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のダッシュボード・ページを印刷およびエクスポートするためのカスタム・レイアウトの作成に関する項を参照してください。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. EnableDashPageExport要素を追加する必要があるAdvancedReportingセクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<AdvancedReporting>
<EnableDashPageExport>true</EnableDashPageExport>
</AdvancedReporting>
</ServerInstance>

要素の値は次のとおりです。

- true: 「印刷とエクスポートのオプション」ダイアログの「印刷とエクスポートのカスタム・レイアウト」コンポーネントを表示することによって、Oracle BI Publisherへのダッシュボード・ページのエクスポート機能を有効にします。(デフォルト)

- false: 「印刷とエクスポートのオプション」ダイアログの「印刷とエクスポートのカスタム・レイアウト」コンポーネントを非表示にすることによって、Oracle BI Publisherへのダッシュボード・ページのエクスポート機能を無効にします。

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

ブリーフィング・ブックのPDFバージョンの目次の変更

PDF版のブリーフィング・ブックには、自動生成された目次が含まれます。ブリーフィング・ブック内の各ダッシュボード・ページ、分析およびレポートに対するエントリが含まれます。

目次の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドのブリーフィング・ブックの使用に関する項を参照してください。

目次のデフォルトのテンプレートtoc-template.rtfは、ORACLE_INSTANCE\config\OracleBIPresentationServicesComponent\coreapplication_obisnディレクトリにあります。組織のニーズにわせて、このテンプレートを変更できます。

Smart Viewインストーラ用のカスタム・ダウンロード・リンクの構成

Oracle Business Intelligenceに同梱されているSmart Viewのバージョンは、Oracle Business Intelligenceサーバーまたは入手可能な最新バージョンのSmart Viewと一致していないことがあります。

Oracle Business Intelligenceホーム・ページの「BIデスクトップ・ツールのダウンロード」リストに表示される「Smart View for MS Office」リンクを、Smart Viewインストーラ用のカスタム・ダウンロード・リンクを指すように構成できます。そうすることで、環境に適したバージョンのSmart Viewを常にユーザーが使用できるようになります。そのためには、instanceconfig.xmlにSmartViewInstallerURL要素を追加します。

次のようなsmartview.exeが存在する場所を指すようにダウンロード・リンクを構成できます。

- 最新バージョンのSmart Viewを常に入手できる、Oracle Technology NetworkのSmart Viewのダウンロード・ページなどの外部URL

- インストールを即時開始できる内部Webページやイントラネット・サイトなどの内部URL

- インストールを即時開始できるローカル・サーバーのフォルダ

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. <CatalogPath>および<DSN>AnalyticsWeb</DSN>要素を見つけ、それらの要素の後にSmartViewInstallerURL要素を追加します。

3. 次の例の構文を使用して、SmartViewInstallerURL要素を追加します。

Oracle Technology Networkからのダウンロードの11gの例:

<CatalogPath>/example/path/work/abc/instances/instance1/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1/catalog/SampleApp</CatalogPath>
<DSN>AnalyticsWeb</DSN>
<SmartViewInstallerURL>http://www.oracle.com/technetwork/middleware/epm/downloads/smart-view-1112x-1939038.html</SmartViewInstallerURL>

イントラネット・サイトからのダウンロードの11gの例:

<CatalogPath>/example/path/work/abc/instances/instance1/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1/catalog/SampleApp</CatalogPath>
<DSN>AnalyticsWeb</DSN>
<SmartViewInstallerURL>http://myserver:8080/downloads/smartview.exe</SmartViewInstallerURL>

内部サーバーからのダウンロードの11gの例

<CatalogPath>/example/path/work/abc/instances/instance1/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1/catalog/SampleApp</CatalogPath>
<DSN>AnalyticsWeb</DSN>
<SmartViewInstallerURL>\\myserver\downloads\smartview.exe</SmartViewInstallerURL>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

アンサーでの分析のブロック

特定の分析をブロックする必要が生じることがあります。たとえば、特定の列を他の列と併用するようにコンテンツ・デザイナに要求したり、特定の列がリクエストされたときにフィルタを要求したりする場合です。

アンサーには、分析で指定している基準や分析内の式に基づく問合せのブロックに使用できるAPIが含まれています。JavaScriptを使用してこのAPIにアクセスすることによって、条件のチェックや分析の検証を行えます。

この項では、次の項目について説明します。

- JavaScriptファイルの保存

- 基準に基づく分析のブロック

- 式に基づく分析のブロック

- 検証ヘルパー関数

JavaScriptファイルの保存

この項では、JavaScriptを使用した条件のチェックと分析の検証について説明します。

これらのタスクや他の同様のタスクを実行する独自のJavaScriptプログラムを作成します。Oracle BI EEでは、JavaScriptプログラムはインストールされません。JavaScriptプログラムを作成したら、これらをシングルトン・データ・ディレクトリ(SDD)に保存できます。これらは仮想ディレクトリとして最初にデプロイするディレクトリです。

SDD/components/OBIPS/analyticsRes

SDDは、DOMAIN_HOME/bidataなどのシングルトン・データ・ディレクトリです。

「共有ファイルとディレクトリの設定」を参照してください。

これ以外のディレクトリにJavaScriptプログラムを配置する場合は、プログラムを呼び出すコードでフルパス名を指定してください。たとえば、次のようなコードを使用できます。

<script type="text/javascript" src="http://example/mydir/myblocking.js" />

基準に基づく分析のブロック

コードによるブロック対象の分析をユーザーが実行しようとしたときに、エラー・メッセージを表示できます。分析は実行されません。

answerstemplates.xmlファイルには、kuiCriteriaBlockingScriptというメッセージが含まれており、validateAnalysisCriteria関数を定義するJavaScriptを含むかまたはこのようなJavaScriptを定義するように、このメッセージをオーバーライドできます。デフォルトでは、このメッセージには、常にtrueを返す関数が含まれます。

ユーザーが分析を実行しようとすると、編集したvalidateAnalysisCriteria関数がアンサーによって呼び出されます。分析がブロックされない場合、この関数はtrueを返し、分析がブロックされる場合は、falseまたはメッセージを返します。メッセージまたはfalse以外の値が返された場合は、ポップアップ・ウィンドウにそのメッセージが表示されます。いずれにしても、問合せはブロックされます。

次のコード例は、問合せのブロックを示しています。最初に、answerstemplates.xmlファイルに次のXMLコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web.messageSystem">
<WebMessageTable system="QueryBlocking" table="Messages">
<WebMessage name="kuiCriteriaBlockingScript" translate="no">
<HTML>
<script type="text/javascript" src="fmap:myblocking.js" />
</HTML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

このXMLコードは、myblocking.jsというJavaScriptプログラムを呼び出します。次のディレクトリにこのファイルが配置されていることを確認します。

SDD/components/OBIPS/analyticsRes

SDDはシングルトン・データ・ディレクトリです。

このmyblocking.jsプログラムのサンプル・コードを次に示します。

// This is a blocking function. It ensures that users select what
// the designer wants them to.
function validateAnalysisCriteria(analysisXml)
{
// Create the helper object
var tValidator = new CriteriaValidator(analysisXml);
// Validation Logic
if (tValidator.getSubjectArea() != "Sample Sales")
return "Try Sample Sales?";
if (!tValidator.dependentColumnExists("Markets","Region","Markets","District"))
{
// If validation script notifies user, then return false
alert("Region and District are well suited, do you think?");
return false;
}
if (!tValidator.dependentColumnExists("Sales Measures","","Periods","Year"))
return "You selected a measure so pick Year!";
if (!tValidator.filterExists("Sales Measures","Dollars"))
return "Maybe filter on Dollars?";
if (!tValidator.dependentFilterExists("Markets","Market","Markets"))
return "Since you are showing specific Markets, filter the markets.";
var n = tValidator.filterCount("Markets","Region");
if ((n <= 0) || (n > 3))
return "Select 3 or fewer specific Regions";
return true;
}

前述のテンプレートを使用してこの関数をオーバーライドしなかった場合や、この関数でfalse以外が返された場合は、基準は有効とみなされ、分析が発行されます。プレビューおよび保存操作に対しても、同じメカニズムで基準が検証されます。

この変更を行った後は、Oracle BIプレゼンテーション・サービスのサーバーを停止して再起動するか、または管理ページで「ファイルとメタデータの再ロード」リンクをクリックします。

式に基づく分析のブロック

アンサー付属のフックを使用して、JavaScript検証機能を組み込み、コンテンツ・デザイナが列の式を入力または変更したときにアンサーからこの検証機能を呼び出すことができます。呼出しに失敗してメッセージが返されると、アンサーによってそのメッセージが表示され、操作が取り消されます。

また、ヘルパー関数を使用することによって、Document Object Model(DOM)を手動で走査するかわりに、問合せブロック関数でフィルタや列などをチェックできますDOMは、アンサーで現在表示されているHTML UIページの内部ブラウザ表現を記述する手段です。「検証ヘルパー関数」を参照してください。

criteriatemplates.xmlファイルには、kuiFormulaBlockingScriptというメッセージが含まれており、validateAnalysisFormula関数を定義するJavaScriptを含むようにこのメッセージをオーバーライドできます。デフォルトでは、このメッセージには、常にtrueを返す関数が含まれます。

アンサーは、コンテンツ・デザイナが行った変更を適用する前にvalidateAnalysisFormulaを呼び出します。この関数がtrueを返すと、式は受け入れられます。この関数がfalseを返すと、式は拒否されます。それ以外の場合は、無効な式が入力されたときの現行の動作と同じように、この関数からの戻り値が式の下のメッセージ領域に表示されます。

コンテンツ・デザイナは、必要に応じて「OK」をクリックしてエラーを無視できます。独自のアラートを表示して、コンテンツ・デザイナが作業を続行できるようにするには、関数からtrueを返すようにします。問合せをブロックするには、falseまたはメッセージを返します。JavaScript文字列および正規表現技術を使用して関数に渡された式をチェックし、関数で式を検証する必要があります。

次のコード例は、サンプルのカスタム・メッセージを示しています。

<?xml version="1.0" encoding="utf-8"?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web.messageSystem">
<WebMessageTable system="QueryBlocking" table="Messages">
<WebMessage name="kuiFormulaBlockingScript" translate="no">
<HTML>
<script type="text/javascript" src="fmap:myblocking.js" />
</HTML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

次のコード例は、入力された式に基づくブロックを示しています。

// This is a formula blocking function. It makes sure the user does not enter an unacceptable formula.
function validateAnalysisFormula(sFormula, sAggRule)
{
// do not allow the use of concat || in our formulas
var concatRe = /\|\|/gi;
var nConcat = sFormula.search(concatRe);
if (nConcat >= 0)
return "You used concatenation (character position " + nConcat + "). That is not allowed.";
// no case statements
var caseRe = /CASE.+END/gi;
if (sFormula.search(caseRe) >= 0)
return "Do not use a case statement.";
// Check for a function syntax: aggrule(formula) aggrule should not contain a '.'
var castRe = /^\s*\w+\s*\(.+\)\s*$/gi;
if (sFormula.search(castRe) >= 0)
return "Do not use a function syntax such as RANK() or SUM().";
return true;
}

この変更を行った後は、Oracle BIプレゼンテーション・サービスのサーバーを停止して再起動するか、または管理ページで「ファイルとメタデータの再ロード」リンクをクリックします。

検証ヘルパー関数

検証ヘルパー関数はJavaScriptファイルに定義されています。

これらの関数は、answers/queryblocking.jsという名前のファイル内で定義されます。この表に各ヘルパー関数を示し、それぞれについて説明します。

検証ヘルパー関数

説明

CriteriaValidator.getSubjectArea()

分析で参照されたサブジェクト・エリアの名前を返します。通常これは、他の検証を実行する前に関数内のswitch文で使用されます。分析がセット・ベースの基準である場合はnullを返します。

CriteriaValidator.tableExists(sTable)

指定されたフォルダ(表)がコンテンツ・デザイナによって分析に追加されている場合はtrue、フォルダが追加されていない場合はfalseを返します。

CriteriaValidator.columnExists(sTable, sColumn)

指定された列がコンテンツ・デザイナによって分析に追加されている場合はtrue、列が追加されていない場合はfalseを返します。

CriteriaValidator.dependentColumnExists(sCheckTable, sCheckColumn, sDependentTable, sDependentColumn)

checkColumnが存在する場合に、dependentColumnが存在するかチェックして確認します。checkColumnが存在しない場合またはcheckColumnと依存列がどちらも存在する場合はtrueを返します。checkColumnとdependentColumnがnullの場合は、フォルダが検証されます。checkTableのいずれかの列が存在する場合は、dependentTableの列が存在する必要があります。

CriteriaValidator.filterExists(sFilterTable, sFilterColumn)

指定された列にフィルタが存在する場合はtrueを、存在しない場合はfalseを返します。

CriteriaValidator.dependentFilterExists(sCheckTable, sCheckColumn, sFilterTable, sFilterColumn)

プロジェクション・リストにcheckColumnが存在する場合に、dependentFilterが存在するかチェックして確認します。checkColumnが存在しない場合またはcheckColumnと依存フィルタがどちらも存在する場合はtrueを返します。

CriteriaValidator.filterCount(sFilterTable, sFilterColumn)

特定の論理列に対して指定されたフィルタ値の数を返します。フィルタ値がequals、null、notNullまたはinの場合は、選択された値の数を返します。フィルタで列が使用されていない場合は、ゼロを返します。列がデフォルトなしで要求されている場合は-1を返します。他のフィルタ操作(greater than、begins withなど)に対しては、値の数が判定不可能なため、いずれも999を返します。

分析およびダッシュボードのデフォルト表示の指定

分析に追加された新しいビュー、およびダッシュボード・ページに追加された新しいオブジェクトの初期状態の一部の側面を制御できます。

たとえば、新しい分析にデフォルトのフッターを追加したり、ダッシュボードの各セクションのデフォルトを設定したりできます。これらの側面を制御するには、関連するXMLメッセージ・ファイルをカスタマイズして、インストール時に指定したデフォルト値をオーバーライドします。

デフォルト表示用のXMLメッセージ・ファイル

この項では、XMLメッセージ・ファイルのカスタマイズについて説明します。このカスタマイズによって、Oracle BIプレゼンテーション・サービスで配布されるデフォルト表示をオーバーライドできます。

分析用には、ファイルanswerstemplates.xmlのkuiAnswersReportPageEditorHead内にkuiCriteriaDefaultViewElementsWrapperというメッセージが含まれています。このメッセージには2つの追加メッセージが含まれており、そのうちkuiCriteriaDefaultViewElementsでデフォルト値を定義できます。もう1つのkuiCriteriaDefaultViewElementsMaskではマスクが定義されています。マスクのXMLメッセージは保護されており、内容の編集はできません。

ラッパー・メッセージによって、結合されたXMLが、新しいデフォルト値の適用に使用されるJavaScript変数kuiDefaultViewElementsXMLに追加されます。

ダッシュボード用には、ファイルdashboardtemplates.xmlに、ダッシュボード・エディタ内で使用できるようにXMLをkuiDefaultDashboardElementsXMLというJavaScript変数に追加する、kuiDashboardDefaultElementsWrapperというメッセージが含まれています。

分析およびダッシュボードのデフォルト表示のカスタマイズ例

次の各項では、デフォルト値のカスタマイズの例を示します。

- 新しい分析へのデフォルトのヘッダーまたはフッターの追加

- 結果の自動プレビューの抑止

- 複合レイアウトの分析のデフォルトの設定

- ダッシュボード・セクションのデフォルトの変更

- ヘッダーおよびフッターを含むダッシュボード・ページのデフォルトの指定

これらのカスタマイズを有効にするには、Oracle BIプレゼンテーション・サービスのサーバーを停止して再起動するか、または管理ページで「ファイルとメタデータの再ロード」リンクをクリックします。

新しい分析へのデフォルトのヘッダーまたはフッターの追加

すべての新しい分析でデフォルトのヘッダーとフッターが表示されるように指定できます。

たとえばフッターに、機密保持に関する注意や会社名などのメッセージを挿入できます。デフォルトのヘッダーまたはフッターを指定するには、テキストと適用する書式設定を指定するXMLメッセージを作成します。

次のXMLコード例では、Acme Confidentialという赤色の太字テキストを含むフッターを作成しています。

<?xml version="1.0" encoding="utf-8"?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web.messageSystem">
<WebMessageTable system="Answers" table="ViewDefaults">
<WebMessage name="kuiCriteriaDefaultViewElements" translate="no"><HTML>
<view signature="compoundView" >
<pageProps pageSize="a4">
<pageFooter showOnDashboard="true" show="true">
<zone type="top"><caption>[b]Acme Confidential[/b]</caption>
<displayFormat fontColor="#FF0000"/></zone>
</pageFooter>

</pageProps>
<pageProps pageSize="a4">
<pageFooter showOnDashboard="true" show="true">
<zone position="top">
<caption fmt="html">
<text>[b]Acme Confidential[/b]
</text>
</caption>
<displayFormat>
<formatSpec hAlign="center" fontColor="#FF0000"/>
</displayFormat>
</zone>
</pageFooter>
</pageProps>
</view>
</HTML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

結果の自動プレビューの抑止

データのビューの編集時には分析の結果が表示されます。コンテンツ・デザイナが結果の表示を明示的に要求するように設定する場合、新しいビューの作成時に自動プレビューを無効にすることを指定するXMLメッセージを作成できます。

この場合も、コンテンツ・デザイナは、「結果の表示」リンクをクリックすることによって、ビューの編集時に結果を表示できます。

注意:

XMLコードには各種ビューの署名エントリを追加できます。XML表現の分析でビューの署名の値を特定できます。分析を編集しながら、分析エディタの「詳細設定」タブで分析のXMLフィールドを確認します。<saw:view>要素のxsi:type属性を探します。署名の値は、接頭辞"saw:"がない値です。

次のXMLコード例では、アンサーでのビューの使用時に結果の自動プレビューを無効にしています。

<?xml version="1.0" encoding="utf-8"?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web.messageSystem">
<WebMessageTable system="Answers" table="ViewDefaults">
<WebMessage name="kuiCriteriaDefaultViewElements" translate="no"><HTML>
<view signature="tableView" showToolBar="true" showHeading="true />
<view signature="pivotTableView" autoPreview="false" />
<view signature="titleView" autoPreview="false" />
<view signature="viewSelector" autoPreview="false" />
<view signature="htmlviewnarrativeView" autoPreview="false" />
<view signature="tickerview" autoPreview="false" />
<view signature="htmlview" autoPreview="false" />
<view signature="dvtchart" autoPreview="false" />
<view signature="dvtgauge" autoPreview="false" />
<view signature="dvtfunnel" autoPreview="false" />
<view signature="trellisView" autoPreview="false" />
</HTML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

複合レイアウトの分析のデフォルトの設定

新たに作成した分析の結果は、タイトル・ビューと、それに続く表またはピボット表の複合レイアウトで表示されます。

表は分析に属性列しかない場合に作成され、ピボット表は分析に1つ以上の階層列が含まれている場合に作成されます。

ナレーティブとそれに続くグラフなどのように、異なるビューの集合を複合ビューのデフォルトとして指定するXMLメッセージを作成できます。この場合も、コンテンツ・デザイナは複合レイアウト内でのビューの追加や配置変更を行えます。

次のXMLコード例では、ナレーティブとそれに続くグラフを複合レイアウトのデフォルトとして設定しています。

<?xml version="1.0" encoding="utf-8"?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web.messageSystem">
<WebMessageTable system="Answers" table="ViewDefaults">
<WebMessage name="kuiCriteriaDefaultViewElements" translate="no"><HTML>
<view signature="compoundView" >
<cv signature="narrativeView" />
<cv signature="dvtchart" />
</view>
</HTML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

ダッシュボード・セクションのデフォルトの変更

デフォルトでは、ダッシュボードでドリル操作を行った結果は新しいページに表示され、セクション名はダッシュボードに表示されず、各セクションは展開/縮小可能に設定されます。

これらのデフォルト値を変更するには、ダッシュボード・セクションの新しいデフォルト値を指定するXMLメッセージを作成します。この場合も、ダッシュボードを編集するコンテンツ・デザイナは、ダッシュボード・エディタ内のオプションを使用してこの動作を変更できます。

次のXMLコード例では、セクション・ヘッダーを表示し、ドリル操作を有効にし、セクションの縮小を無効として指定しています。

<?xml version="1.0" encoding="utf-8"?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web.messageSystem">
<WebMessageTable system="Answers" table="ViewDefaults">
<WebMessage name="kuiDashboardDefaultElements" translate="no"><HTML>
<element signature="dashboardSection" drillInline="true" showHeading="true" collapsible="false" />
</HTML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

ヘッダーおよびフッターを含むダッシュボード・ページのデフォルトの指定

デフォルトでは、ダッシュボードはヘッダーとフッターなしで縦の向きで印刷されます。

カスタムのヘッダーおよびフッター付きと横向き印刷を新たに追加されるダッシュボード・ページのデフォルトとして設定するには、これらの特性を指定するXMLメッセージを作成します。この場合も、ダッシュボードを編集するコンテンツ・デザイナは、ダッシュボード・エディタ内のオプションを使用してこの動作を変更できます。

次のXMLコードでは、カスタムのヘッダーとフッターをダッシュボード・ページに追加し、横向きを指定しています。

<?xml version="1.0" encoding="utf-8"?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web.messageSystem">
<WebMessageTable system="Answers" table="ViewDefaults">
<WebMessage name="kuiDashboardDefaultElements" translate="no">
<HTML>
<element signature="dashboardPage" personalSelections="false">
<pageProps orientation="landscape" printRows="all" pageSize="a4">
<pageHeader showOnDashboard="true" show="true">
<zone position="top">
<caption>[b]Acme is Cool[/b]</caption>
<displayFormat>
<formatSpec fontSize="9pt" hAlign="center"
fontColor="#FFFFFF" backgroundColor="#000000"/>
</displayFormat>
</zone>
</pageHeader>
<pageFooter showOnDashboard="true" show="true">
<zone position="top">
<caption>[b]CONFIDENTIAL[/b]</caption>
<displayFormat>
<formatSpec fontSize="7.5pt" hAlign="center"
fontColor="#999999" borderColor="#CC99CC" fontStyle="italic"
borderPosition="all" borderStyle="single"/>
</displayFormat>
</zone>
</pageFooter>
</pageProps>
</element>
</HTML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

分析とダッシュボードにおけるライトバックのための構成

ダッシュボード・ページまたは分析のユーザーは表に表示されているデータを変更する機能を使用できる場合があります。

この機能は、通常ライトバックと呼ばれます。管理者は、コンテンツ・デザイナがユーザー用にライトバック機能を構成できるように支援します。

次の各項では、ライトバックの構成方法について説明します。

- ライトバックの仕組み

- ライトバックの構成手順

- 例: ライトバックの構成手順

- ライトバックの制限

- ライトバック・テンプレート・ファイルの作成

- LightWriteback要素の設定

ライトバックの仕組み

ライトバック・フィールドが適切に構成されている場合、ユーザーが「データベースへのライトバック」権限を持っていれば、分析でライトバック・フィールドが編集可能フィールドとして表示されます。

ユーザーがこの権限を持っていないと、ライトバック・フィールドは通常のフィールドとして表示されます。ユーザーが編集可能フィールドに値を入力して適切なライトバック・ボタンをクリックすると、アプリケーションによってライトバック・テンプレートが読み取られ、適切なinsertまたはupdate SQLコマンドが取得されます。その後、そのinsertまたはupdateコマンドが発行されます。コマンドが正常に実行されると、レコードが読み取られ、分析が更新されます。テンプレートの読取りまたはSQLコマンドの実行でエラーが発生した場合は、エラー・メッセージが表示されます。

insertコマンドは、レコードがまだ存在していない場合に実行され、ユーザーが新しいデータを表に入力します。この場合、ユーザーが入力した表内のレコードの値は、入力前はnullとなっています。

updateコマンドは、ユーザーが既存のデータを変更する場合に実行されます。まだ物理表に存在していないレコードをライトバック先として表示するには、類似する別の表を作成します。類似するこの表を使用してプレースホルダ・レコードを表示し、このプレースホルダ・レコードに対してユーザーがダッシュボードで変更を実行できるようにします。

注意:

ライトバックを使用してデータが変更された分析を含むダッシュボードを、ログオンしたユーザーがすでに表示している場合、ダッシュボードではデータが自動的にリフレッシュされません。更新されたデータを参照するには、ユーザーがダッシュボードを手動でリフレッシュする必要があります。

ライトバックの構成手順

ライトバックを設定するには、次の手順に従ってください。

1. (コンテンツ・デザイナ対象)リポジトリのOracle BI管理者と協力して組織でのレポートのニーズを評価し、必要なライトバック列とそれを表示する分析のリストを作成します。

階層列では、ライトバック機能はサポートされませんが、属性列、メジャー列および二重列では、ライトバック機能はサポートされます。二重列では、表示列にライトバックできます。コード列は自動的には解釈されません。

2. (リポジトリのOracle BI管理者対象)データベースで、必要なライトバック列ごとに1つの列を持つ物理表を作成し、「データベース」ダイアログの「一般」タブで、「デフォルトで直接データベース・リクエストを許可」オプションを選択します。

注意:

最大限のセキュリティを確保するには、ライトバック・データベース表を固有のデータベース・インスタンスに格納します。

『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』を参照してください。

3. (リポジトリのOracle BI管理者対象)Oracle BI管理ツールを使用して、列でライトバックを有効にします。次の内容が含まれます。

- 物理表でのキャッシングを無効にします。

- 論理列を書込み可能にします。

- プレゼンテーション列の「読取り/書込み」権限を有効にします。

『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』の列でのライトバックの有効化に関する項を参照してください。

4. (管理者対象)ライトバックを有効にする表ビューへの値の挿入と更新の両方に必要なSQLコマンドを指定する、ライトバック・テンプレート・ファイルを作成します。

方法については、「ライトバック・テンプレート・ファイルの作成」を参照してください。

5. (管理者対象)instanceconfig.xmlファイルに、LightWriteback要素を追加します。

「LightWriteback要素の設定」を参照してください。

6. (管理者対象)Oracle BIプレゼンテーション・サービスで、ライトバック権限「ライトバックの管理」と「データベースへのライトバック」を適切なユーザーに付与します。

方法については、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドのプレゼンテーション・サービス権限の管理に関する項を参照してください。

7. (コンテンツ・デザイナ対象)列にライトバック機能を追加します。

『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』の列へのライトバック機能の追加に関する項を参照してください。

8. (コンテンツ・デザイナ対象)表ビューにライトバック機能を追加します。

『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』の表ビューへのライトバック機能の追加に関する項を参照してください。

例: ライトバックの構成手順

Oracle BI管理者がコンテンツ・デザイナと協力してライトバック処理を構成する方法を示している次の例を参照してください。

1. リポジトリのOracle BI管理者とのやり取りの後、コンテンツ・デザイナは次のように決定します。

- YR、Quarter、Region、ItemTypeおよびDollarsのライトバック列が必要である。

- これらの列が表示される分析のタイトルはRegion Quotaとする。

2. リポジトリのOracle BI管理者は、次のことを行います。

- YR、Quarter、Region、ItemTypeおよびDollarsの各列を含むregiontypequotaという物理表を作成します。

- 「データベース」ダイアログの「一般」タブで、「デフォルトで直接データベース・リクエストを許可」オプションを選択します。

3. Oracle BI管理ツールを使用して、リポジトリのOracle BI管理者は、次のことを行います。

- 物理レイヤーでWriteBack表をキャッシュ不能にします。

- ビジネス・モデル・レイヤーでWriteBack表のDollars列を書込み可能にします。

- プレゼンテーション・レイヤーでWriteBack表のDollars列の書込み/読取り権限を、BI作成者と認証済ユーザーに対して有効にします。

4. 管理者は、次のライトバック・テンプレートを含むSetQuotaUseIDというライトバック・テンプレート・ファイルを作成します。

<?xml version="1.0" encoding="utf-8" ?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web/message/v1">
<WebMessageTable lang="en-us" system="WriteBack" table="Messages">
<WebMessage name="SetQuotaUseID">
<XML>
<writeBack connectionPool="Supplier">
<insert>INSERT INTO regiontypequota VALUES(@{c0},@{c1},'@{c2}','@{c3}',@{c4})</insert>
<update>UPDATE regiontypequota SET Dollars=@{c4} WHERE YR=@{c0} AND Quarter=@{c1} AND Region='@{c2}' AND ItemType='@{c3}'</update>
</writeBack>
</XML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

さらに、これを次の場所に保存します。

SDD/components/OBIPS/custommessages

SDDは、DOMAIN_HOME/bidataなどのシングルトン・データ・ディレクトリです。

5. 管理者は、次のようにLightWriteback要素をinstance.config.xmlファイルに追加します。

<WebConfig>
<ServerInstance>
<LightWriteback>true</LightWriteback>
</ServerInstance>
</WebConfig>

6. 管理者は、Oracle BIプレゼンテーション・サービスの「管理」にある「権限の管理」ページを使用して、次の権限を付与します。

- BI作成者に対して「ライトバックの管理」

- 認証済ユーザーに対して「データベースへのライトバック」

7. コンテンツ・デザイナはRegion Quota分析を編集し、次の列ごとに「列のプロパティ」ダイアログの「ライトバック」タブを記入して、列をライトバックに対して有効にします。

- YR

- Quarter

- Region

- ItemType

- Dollars

8. コンテンツ・デザイナはRegion Quota分析の表ビューを編集し、「表のプロパティ」ダイアログの「ライトバック」タブで「ライトバックの有効化」ボックスを選択し、「テンプレート名」フィールドにSetQuotaUseIDと入力することにより、この表ビューをライトバックに対して有効にします。

ライトバックの制限

ユーザーは、Oracle BIサーバーからSQL問合せを実行できるあらゆるデータソース(ADFデータソースを除く)に対してライトバックを実行できます。ライトバックの構成時には、次の制限に留意してください。

- 数値列に入力できるのは数字のみです。ドル記号($)、番号記号またはハッシュ記号(#)、パーセント記号(%)などのデータ書式設定文字は使用できません。

- テキスト列に入力できるのは文字列データのみです。

- ライトバックを使用してデータが変更された分析を含むダッシュボードを、ログオンしたユーザーがすでに表示している場合、ダッシュボードではデータが自動的にリフレッシュされません。更新されたデータを参照するには、ユーザーがダッシュボードを手動でリフレッシュする必要があります。

- テンプレート・メカニズムは、表のビューで単一値に対してのみ使用できます。ピボット表のビューや他のあらゆるタイプのビュー、複数値データおよび単一値データのドロップダウン列には、テンプレート・メカニズムはサポートされていません。

- ライトバック列の値はすべて編集可能です。編集可能フィールドは、プリンタ優先以外のコンテキストで表示された場合、ユーザーに「データベースへのライトバック」権限が与えられているかのように表示されます。しかし、論理列が変更可能な物理列にマップされている場合、論理列は複数のレベルの共通部分に対する値を返します。このシナリオの場合、問題が発生する可能性があります。

- 作成したライトバック表から導出されたものではないフィールドも含めて、分析内のあらゆるフィールドにライトバックのフラグを設定できます。しかし、表がライトバック有効に設定されていないと、ライトバック操作を正常に実行できません。フィールドへの正しいタグ付けは、コンテンツ・デザイナが責任を持って行います。

- テンプレートではinsertとupdate以外のSQL文も使用できます。ライトバック機能はこれらの文をデータベースに渡します。しかし、insertまたはupdate以外の文の使用はOracleではサポートしていません。使用しないことをお薦めします。

- プレゼンテーション・サービスが実行するのは、データ入力の最小限の検証のみです。数値フィールドにユーザーがテキスト・データを入力した場合、プレゼンテーション・サービスはこれを検出し、無効なデータがデータベースに送られるのを防止します。しかし、他の形式の無効なデータ入力(範囲外の値、テキストと数値の混合など)は検出されません。ユーザーがライトバック・ボタンをクリックして挿入または更新を実行した場合、データが無効なときは、データベースからエラー・メッセージが出力されます。その後、ユーザーは、誤った入力を修正できます。コンテンツ・デザイナは、数値データ・フィールドには英数字が混ざった値は入力できないことを通知する、ユーザーを支援するテキストをライトバック分析に含めることができます。

- テンプレート・メカニズムは、任意の新しいレコードの入力には適しません。このメカニズムをデータ入力ツールとして使用しないでください。

- ライトバック用にテーブルを作成する場合、少なくとも1つ以上の列にライトバック機能が組み込まれず、各行に固有かつNULL以外の値が含まれるようにします。

- ライトバック分析では、ドリルダウンはサポートされていません。ドリルダウンを実行すると表の構造が変わるため、ライトバック・テンプレートが機能しなくなります。

注意:
テンプレート・メカニズムでは、ユーザーの入力が取得され、データベースに直接書き込まれます。物理データベースのセキュリティについては、管理者が責任を持って対処してください。最大限のセキュリティを確保するには、ライトバック・データベース表を固有のデータベース・インスタンスに格納します。

ライトバック・テンプレート・ファイルの作成

ライトバック・テンプレート・ファイルは、1つ以上のライトバック・テンプレートを含むXML形式のファイルです。

ライトバック・テンプレートは、テンプレートの名前を指定するWebMessage要素、接続プール、および作成したライトバック表と列のレコードの挿入と更新に必要なSQL文で構成されます。コンテンツ・デザイナがライトバックに対して表ビューを有効にした場合、コンテンツ・デザイナは、表ビューでのレコードの挿入および更新に使用するライトバック・テンプレートの名前を指定する必要があります。

複数のライトバック・テンプレート・ファイルを作成できます。複数のライトバック・テンプレートを1つのテンプレート・ファイルに含め、それぞれのテンプレートを特定の分析で使用するフィールド用にカスタマイズできます。ただし、1つのファイルには1つのテンプレートのみを含めることをベスト・プラクティスとしてお薦めします。

1. XMLファイルを作成します。custommessagesフォルダにあるすべてのXMLファイルがシステムに読み取られるため、ライトバック・テンプレート・ファイルには任意の名前を付けることができます。

2. 「ライトバック・テンプレートの要件」に指定された要件と「例: ライトバック・テンプレート・ファイル」に示した例に従って適切な要素を追加します。

3. ライトバック・テンプレート・ファイルは、管理者が静的ファイルとカスタマ・メッセージ用に構成した、次の場所にあるmsgdbディレクトリに保存します。

SDD/components/OBIPS/custommessages

SDDは、DOMAIN_HOME/bidataなどのシングルトン・データ・ディレクトリです。

各言語固有のユーザー・インタフェースに影響するXMLメッセージはローカライズする必要がありますが、ライトバック・テンプレートの構成に使用するXMLファイルは、言語に依存しないため、通常翻訳しません。

まれに、ライトバック・テンプレート・ファイルを言語固有にする必要がある場合があります(たとえば、l_es(スペイン語)ロケールを使用してログインするユーザーと、l_fr(フランス語)ロケールを使用してログインするユーザーが、異なるSQLコマンドを使用する場合など)。その場合は、ライトバック・テンプレート・ファイルを適切な言語ディレクトリに配置します。

ライトバック・テンプレートの要件

ライトバック・テンプレートでは、次の要件を満たす必要があります。

- ライトバック・テンプレートの名前は、WebMessage要素のname属性を使用して指定する必要があります。
ライトバックを正しく機能させるには、ライトバックに対して表ビューを有効にする際に、ビューでのレコードの挿入および更新に使用するライトバック・テンプレートの名前をコンテンツ・デザイナが指定する必要があります。

次の例では、SetQuotaUseIDというライトバック・テンプレートを指定しています。

<WebMessage name="SetQuotaUseID">

- セキュリティ要件を満たすために、レコードの挿入と更新を実行するSQLコマンドとともに接続プールを指定する必要があります。これらのSQLコマンドでは、ライトバック・スキーマで渡され、データベース表を変更するためのSQL文を生成する値が参照されます。値は列位置(@1や@3など)または列ID(@{c1234abc}や@{c687dfg}など)によって参照できます。列位置の開始番号は1です。列IDの使用が優先されます。各列IDはランダムに生成された英数字であり、分析エディタの「詳細設定」タブにある分析のXML定義に表示されます。

- <insert>要素と<update>要素の両方をテンプレートに含める必要があります。これらの要素内にSQLコマンドを挿入しない場合は、開始タグと終了タグの間に空白を挿入する必要があります。たとえば、次のように要素を入力する必要があります。

<insert> </insert>

次は不適切な例です。

<insert></insert>

空白を省略すると、「システムがライトバック・テンプレート'[tk1]'を読み取ることができません。[tk2]」のようなライトバック・エラー・メッセージが表示されます。

- パラメータのデータ型が整数または実数でない場合は、一重引用符で値を囲みます。データベースがコミットを自動的に実行しない場合は、insertノードとupdateノードの後にオプションのpostUpdateノードを追加してコミットを強制的に実行します。一般的なpostUpdateノードの例を次に示します。

<postUpdate>COMMIT</postUpdate>

例17-1 例: ライトバック・テンプレート・ファイル

列IDで値を参照するライトバック・テンプレート・ファイルは次のようなものです。

<?xml version="1.0" encoding="utf-8" ?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web/message/v1">
<WebMessageTable lang="en-us" system="WriteBack" table="Messages">
<WebMessage name="SetQuotaUseID">
<XML>
<writeBack connectionPool="Supplier">
<insert>INSERT INTO regiontypequota VALUES(@{c0},@{c1},'@{c2}','@{c3}',@{c4})</insert>
<update>UPDATE regiontypequota SET Dollars=@{c4} WHERE YR=@{c0} AND Quarter=@{c1} AND Region='@{c2}' AND ItemType='@{c3}'</update>
</writeBack>
</XML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

列位置で値を参照するライトバック・テンプレート・ファイルは次のようなものです。

<?xml version="1.0" encoding="utf-8" ?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web/message/v1">
<WebMessageTable lang="en-us" system="WriteBack" table="Messages">
<WebMessage name="SetQuota">
<XML>
<writeBack connectionPool="Supplier">
<insert>INSERT INTO regiontypequota VALUES(@1,@2,'@3','@4',@5)</insert>
<update>UPDATE regiontypequota SET Dollars=@5 WHERE YR=@1 AND Quarter=@2 AND Region='@3' AND ItemType='@4'</update>
</writeBack>
</XML>
</WebMessage>
</WebMessageTable>
</WebMessageTables>

LightWriteback要素の設定

ユーザーが値のライトバックを実行できるようにするには、instanceconfig.xmlファイルにLightWriteback要素を手動で追加する必要があります。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. LightWriteback要素を追加する必要があるServerInstanceセクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<WebConfig>
<ServerInstance>
<LightWriteback>true</LightWriteback>
</ServerInstance>
</WebConfig>

ファイルに含まれていても、Fusion Middleware Controlによって集中管理され、手動による変更はできない要素については、この例では除外されていますので注意してください。

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

Oracle BI Webユーザー・インタフェースのカスタマイズ

Oracle BI EEのユーザー・インタフェースは、スクリプトを使用して生成されているため、カスタマイズ性に優れています。

ルック・アンド・フィールはスキンおよびスタイルで制御します。スキンは、ホームおよびダッシュボード領域外のユーザー・インタフェース・クローム(目に見えるグラフィック機能)を定義します。

Oracle BI EEには、Skyros、blafp (ブラウザのルック・アンド・フィール)、FusionFX (Fusionアプリケーション)など、スタイルがいくつか同梱されています。

次の各項では、Webユーザー・インタフェースをカスタマイズする方法について説明します。

- スキンおよびスタイルとは

- Webユーザー・インタフェースのカスタマイズに関する一般的なヒント

- スタイルのカスタマイズについて

- プレゼンテーション・サービス用のユーザー・インタフェースのスタイルの変更

- スタイルのカスタマイズ

- Skyrosマスター・ブランディング・クラスの変更の例

スキンおよびスタイルとは

スキンおよびスタイルはインタフェースの外観を変更します。

Oracle BI EEのインタフェースをユーザーに表示する方法は、スキンおよびスタイルを作成することで制御できます。スキンとスタイルの主な違いは、スタイルはダッシュボード・コンテンツのみに適用されるのに対して、スキンはユーザー・インタフェースのその他すべての部分に適用されます。たとえば、Oracle BI EE内では、分析およびスコアカード化で使用されるコンポーネントにスキンが適用されます。

デフォルトのスタイルおよびスキンをinstanceconfig.xmlファイルに指定します。その上で、コンテンツ・デザイナが特定の要素を変更して、テキストやリンクの色、テキストのフォントやサイズ、表の枠線、グラフの色や属性など、ダッシュボードの表示用の書式設定を制御します。詳細は、「プレゼンテーション・サービス用のユーザー・インタフェースのスタイルの変更」を参照してください。

スタイルおよびスキンは、カスケーディング・スタイル・シート(CSS)とイメージを含むフォルダに編成されます。スキンおよびスタイルは通常、ロゴ、色スキーム、フォント、表の枠線などの要素を指定することで分析およびダッシュボードのルック・アンド・フィールをカスタマイズするのに使用する一方で、適切なスタイル・シート・ファイルで特定のスタイル・タグを挿入することで様々な要素の位置および行端揃えを制御するのにも使用できます。詳細は、「スタイルのカスタマイズについて」を参照してください。

Webユーザー・インタフェースのカスタマイズに関する一般的なヒント

Webユーザー・インタフェースのカスタマイズを計画する場合は、次の事項に注意してください。

- Oracle BIプレゼンテーション・サービスでは、JavaScriptではなくスタイルおよびスキンを変更してユーザー・インタフェースの要素および表示をカスタマイズします。スクリプトのオブジェクトおよびメソッドが変更され、アップグレード時にこれらのファイルが置き換えられる可能性があるため、JavaScriptファイルは変更しません。
ダッシュボードでは、適切な権限を持つユーザーが個々のダッシュボード・セクションを、HTMLを追加することでカスタマイズできます。このHTMLにはJavaScriptを含めることができます。『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のHTMLマークアップの操作に関する項を参照してください。

- Oracle BI EEデプロイメントは、特定の言語に適応させることができます。「Oracle Business Intelligenceのローカライズ」を参照してください。

スタイルのカスタマイズについて

Oracle BI EEには、blaf (ブラウザのルック・アンド・フィール)、FusionFX (Fusionアプリケーション)、Skyrosなど、様々なスタイルが同梱されています。Oracle BI EEまたはOracle BI Publisherのルック・アンド・フィールをカスタマイズする場合、bicustom-template.earに用意されているカスタム・スタイルを叩き台として使用することをお薦めします。

このカスタム・スタイルは、Skyrosスタイルのコピーです。詳細は、「プレゼンテーション・サービス用のユーザー・インタフェースのスタイルの変更」を参照してください。

スタイル・シート(master.css)を含め、一般的なSkyrosスタイルおよびイメージ・ファイルのほとんどは、マスター・ディレクトリに格納されます。(トピック)スタイルのカスタマイズに、このディレクトリとその構造について詳しく説明します。

スタイル・シート内では、更新できる各要素(またはクラス)にコメントが付けられています。

他のスタイル・シートもSkyrosのスタイル・フォルダおよびスキン・フォルダに格納されます。ユーザー・インタフェースの詳細ごとにスタイルを指定する拡張カスタム・スキンを作成している場合を除き、通常、これらのファイルを更新する必要はありません。

プレゼンテーション・サービス用のユーザー・インタフェースのスタイルの変更

プレゼンテーション・サービス用に独自のスタイルおよびスキンを作成している場合、CSS、graph.xmlおよびイメージ・ファイルを作成し、それらをOracle BI EEで使用可能にする必要があります。これらのファイルを使用可能にするには、次の2つの方法があります。

- 方法1: bicustom.earファイルを使用して独自のファイルを単一ファイルにパッケージ化し、クラスタ内のノード全部に簡単にデプロイできるようにします。この方法は、スケール・アウトした本番システムのクラスタ化された環境でデプロイする場合に便利です。「方法1: "bicustom.ear"ファイルの初回デプロイ」を参照してください。
bicustom.earファイルを再デプロイする場合は、「方法1: "bicustom.ear"ファイルの再デプロイ」を参照してください。

- 方法2: 共有ファイル・システムを使用します。この方法は、Oracle BI EEですぐに変更を確認する場合やカスタマイズがプレゼンテーション・サービスのファイアウォールの外にある場合に便利です。「方法2: 共有フォルダを使用したデプロイ」を参照してください。
方法2を使用して加えた変更を表示する場合は、「方法2: 共有フォルダに対する変更の表示」を参照してください。

方法1: "bicustom.ear"ファイルの初回デプロイ

エンタープライズ・アーカイブ(EAR)ファイルとは、特殊なフォルダおよびファイル構造からなるアーカイブ(ZIP)ファイルです。

EARファイルを作成するには、ZIPツール(7-zipなど)を使用した後、ZIP拡張子をEARに変更します。bicustom-template.earファイルが叩き台として用意されています。

bicustom-template.earファイルには、bicustom.warファイルが格納されています。Webアーカイブ(WAR)ファイルも、特殊なフォルダおよびファイル構造からなるZIPファイルです。カスタム・スキン・ファイルを含めるには、bicustom-template.earファイル内のbicustom.warファイルを更新する必要があります。Oracle BI EEに同梱されているbicustom.warファイルには、使い始めるにあたって役立つフォルダ構造の例が格納されています。

注意:

この方法では、Oracle BI EEクラスタ内のすべてのノードにカスタム・スキンを自動的にデプロイします。

1. ORACLE_HOME/bi/bifoundation/jee/bicustom-template.earをBI_DOMAIN/bidata/components/OBIPS/bicustom.earにコピーします。

注意:

パッチ適用またはアップグレードのプロセスでは、bicustom-template.earファイルは上書きされる場合がありますが、bicustom.earファイルは上書きされません。

2. bicustom.earファイルを更新します。

a. bicustom.earファイルからbicustom.warファイルを抽出します。

b. bicustom.warファイルからファイルを抽出します。

c. ファイルを編集してカスタム・スタイルを作成し、変更を保存します。「スタイルのカスタマイズ」を参照してください。

d. 変更でbicustom.warファイルを更新します。

e. 新しいbicustom.warファイルでbicustom.earファイルを更新します。

3. bicustom.earファイルをデプロイします。

a. Oracle Weblogic Server管理コンソールにログインします。

b. 「ロックして編集」をクリックします。

c. 「ドメイン構造」リージョンで、「デプロイメント」をクリックします。

d. 「デプロイメント」表の「インストール」をクリックします。

e. bicustom.earファイルが格納されているフォルダにナビゲートします(デフォルトでは、このファイルはBI_DOMAIN/bidata/components/OBIPS/にあります)。

f. bicustom.earファイルを選択します。

g. 「次へ」をクリックします。

h. 「Install this deployment as an application」を選択します。

i. 「次へ」をクリックします。

j. 「デプロイメントを次の場所からアクセス可能にする」を選択します。

k. 「終了」をクリックします。

l. 「保存」をクリックします。

m. 「変更のアクティブ化」をクリックします。

4. 新しいアプリケーションを起動します。

a. 「ドメイン構造」リージョンで、「デプロイメント」をクリックします。

b. 「デプロイメント」表の「bicustom」チェック・ボックスを選択します。

c. 「開始」をクリックして、「すべてのリクエストを処理」を選択します。

5. instanceconfig.xmlファイルを更新して、「ダッシュボードのプロパティ」ダイアログの「スタイル」オプションのデフォルト値として使用するスタイルおよびスキンを指定します。ダッシュボードのスタイルの更新の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドのダッシュボードとそのページのプロパティの変更に関する項を参照してください。
これらのエントリがinstanceconfig.xmlファイルに存在しない場合は、fusionFXがデフォルト・スタイルです。スタイルおよびスキンは、ORACLE_HOME\bi\bifoundation\web\appv2\resディレクトリにあります。

a. 次のinstanceconfig.xmlファイルを開いて編集します。
BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

b. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<UI>
<DefaultStyle>Skyros</DefaultStyle>
<DefaultSkin>Skyros</DefaultSkin>
</UI>
</ServerInstance>

DefaultStyleおよびDefaultSkinはそれぞれ、カスタムのスタイル・プロパティおよびスキン・プロパティの名前です。

Altaカスタム・スタイルおよびスキンを使用するには、上のSkyrosをAltaに置き換えます。

注意:

これらの名前は、スタイルおよびスキンが格納されているフォルダに付けられた名前と一致する必要があります。アンダースコアを使用しないでください。例: フォルダがs_Skyrosのように文字s_で始まっている場合、s_は省略されます。

c. 変更内容を保存し、ファイルを閉じます。

6. プレゼンテーション・サービスを再起動します。「Oracle Business Intelligenceプロセスの管理について」を参照してください。

bicustom.earファイルを再デプロイする場合は、「方法1: "bicustom.ear"ファイルの再デプロイ」を参照してください。

方法1: "bicustom.ear"ファイルの再デプロイ

エンタープライズ・アーカイブ(EAR)ファイルとは、特殊なフォルダおよびファイル構造からなるアーカイブ(ZIP)ファイルです。

カスタム・スキンを更新するには次のタスクを使用します。

1. bicustom.earファイルを更新します。

2. デプロイメントを更新します。

a. Oracle Weblogic Server管理コンソールにログインします。

b. 「ロックして編集」をクリックします。

c. 「ドメイン構造」リージョンで、「デプロイメント」をクリックします。

d. 「デプロイメント」表の「bicustom」チェック・ボックスを選択します。

e. 「更新」をクリックします。

f. 「終了」をクリックします。

g. 「変更のアクティブ化」をクリックします。

h. 「構成の解放」をクリックします。

3. プレゼンテーション・サービスを再起動します。

注意:

カスタマイズしたファイルでイメージやフォント色などのコンポーネント値を変更した場合、プレゼンテーション・サービスを再起動する必要はありません。また、instanceconfig.xmlファイルでデフォルトのスキンまたはスタイルを変更した場合も、プレゼンテーション・サービスを再起動する必要はありません。

方法2: 共有フォルダを使用したデプロイ

方法2は、カスタムのスタイル・フォルダおよびスキン・フォルダ内のCSSおよびイメージ・ファイルに加えた変更をできるだけ速くOracle BI EEで表示するデプロイメント環境またはテスト環境に最も適しています。

この方法は、カスタマイズがプレゼンテーション・サービスのファイアウォールの外にある場合にも使用されます。

Oracle BI EEでは、静的ファイルはORACLE_HOME\bi\bifoundation\web\appv2にあります。Webサーバーには、クラスタリングなどの共有ファイル・システムを含め、ファイル・システム内のどの場所にでも配置できる静的ディレクトリを公開する独自の方法があります。静的ディレクトリの公開については、ご使用のサーバーのドキュメントを参照してください。

注意:

Oracle WebLogic Serverを構成してApache HTTP Server、Microsoft Internet Information Server (Microsoft IIS)、Oracle HTTP ServerなどのWebサーバーと連携させる方法の詳細は、次のドキュメントを参照してください。

Oracle WebLogic Serverプロキシ・プラグイン12.2.1の使用

Oracle HTTP Server管理者ガイド

1. カスタム・スタイルを作成します。

a. bicustom-template.earファイルからbicustom.warファイルを抽出します。

b. bicustom.warファイルの内容をOracle Weblogic Serverがアクセス可能な場所(c:\customなど)に抽出します。

c. ファイルを編集してカスタム・スタイルを作成し、変更を保存します。詳細は、「スタイルのカスタマイズ」を参照してください。

2. カスタム・フォルダをデプロイします。

a. Oracle Weblogic Server管理コンソールにログインします。

b. 「ロックして編集」をクリックします。

c. 「ドメイン構造」リージョンで、「デプロイメント」をクリックします。

d. 「デプロイメント」表の「インストール」をクリックします。

e. カスタム・スタイルが格納されているフォルダ(c:\customなど)にナビゲートします。

f. 「次へ」をクリックします。

g. 「Install this deployment as an application」を選択します。

h. 「次へ」をクリックします。

i. デプロイメント・ターゲットとしてbi_clusterを選択します。

j. 「次へ」をクリックします。

k. 名前をAnalyticsResに設定します。

l. 「デプロイメントを次の場所からアクセス可能にする」を選択します。

m. 「次へ」をクリックします。

n. 「はい、デプロイメントの構成画面に移動します。」を選択します。

o. 「終了」をクリックします。

p. 「構成」タブをクリックします。

q. 「コンテキスト・ルート」ボックスに/analyticsResと入力します。

r. 「保存」をクリックします。

s. 「OK」をクリックします。

t. 「変更のアクティブ化」をクリックします。

u. 「構成の解放」をクリックします。

3. 新しいアプリケーションを起動します。

a. 「ドメイン構造」リージョンで、「デプロイメント」をクリックします。

b. 「デプロイメント」表の「analyticsRes」チェック・ボックスを選択します。

c. 「開始」をクリックして、「すべてのリクエストを処理」を選択します。

4. instanceconfig.xmlファイルを更新してカスタマイズを指すパスを指定します。これで、プレゼンテーション・サービスでアクセスできるようになります。
プレゼンテーション・サービスにより、Oracle BIサーバー(Oracle Business Intelligenceの背後にあるコア・サーバー)からのデータを表示する分析エディタおよびダッシュボードのユーザー・インタフェースが生成されます。

a. 次のinstanceconfig.xmlファイルを開いて編集します。
BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

b. ServerInstanceセクションを探します。

c. 次の例に示すように要素を追加します。

<ServerInstance>
<UI>
<DefaultStyle>Skyros</DefaultStyle>
<DefaultSkin>Skyros</DefaultSkin>
</UI>
<URL>
<CustomerResourcePhysicalPath>c:\custom\res
</CustomerResourcePhysicalPath>
<CustomerResourceVirtualPath>/analyticsRes/res
</CustomerResourceVirtualPath>
</URL>
</ServerInstance>

DefaultStyleおよびDefaultSkinはそれぞれ、カスタムのスタイル・プロパティおよびスキン・プロパティの名前です。

Altaカスタム・スタイルおよびスキンを使用するには、上のSkyrosをAltaに置き換えます。

注意:

CustomerResourceVirtualPathは、「コンテキスト・ルート」ボックスに入力した場所を指します。

プレゼンテーション・サービスのダッシュボードまたはレポートをADFアプリケーションに埋め込んでいる場合、次の例に示すように、DefaultStyle要素とDefaultSkin要素の後にSkinMappings要素を追加する必要があります。

<ServerInstance>
<UI>
<DefaultStyle>Skyros</DefaultStyle>
<DefaultSkin>Skyros</DefaultSkin>
<SkinMappings>
<skinMapping>
<biadfSkinFamily>fusion</biadfSkinFamily>
<biSkin>FusionFx</biSkin>
</skinMapping>
<skinMapping>
<biadfSkinFamily>blafplus-rich</biadfSkinFamily>
<biSkin>blafp</biSkin>
</skinMapping>
<skinMapping>
<biadfSkinFamily>skyros</biadfSkinFamily>
<biSkin>Skyros</biSkin>
</skinMapping>
</SkinMappings>
</UI>
<URL>
<CustomerResourcePhysicalPath>c:\custom\res
</CustomerResourcePhysicalPath>
<CustomerResourceVirtualPath>/analyticsRes/res
</CustomerResourceVirtualPath>
</URL>
</ServerInstance>

d. 変更内容を保存し、ファイルを閉じます。

e. プレゼンテーション・サービスを再起動します。

方法2: 共有フォルダに対する変更の表示

共有フォルダの構成が済むと、CSSファイルおよびイメージに対する変更を表示できます。

1. メタデータを再ロードします。

a. Oracle BI EEで、グローバル・ヘッダーの「管理」リンクをクリックします。

b. 「管理」タブで、「ファイルとメタデータの再ロード」リンクをクリックします。

2. ブラウザ・キャッシュのクリアこのプロセスは、使用しているブラウザによって異なります。

3. グローバル・ヘッダーのリンク(「ホーム」や「カタログ」など)をクリックして変更を確認します。

注意:

イメージ・ファイルなどのファイルをカスタム・スタイル・フォルダに追加した場合、プレゼンテーション・サービスを再起動する必要があります。

スタイルのカスタマイズ

カスタム・スタイルを作成するには、ファイルを1つ以上編集する必要があります。

スタイル・ディレクトリが抽出されるbicustom.warフォルダ構造では、アプリケーション・リソース(res)ディレクトリ内(./res/)は次のようになっており、関連ファイルが格納されています。

- ./res/filemap.xml

- ./res/s_Custom/

- ./res/s_Custom/master/

- ./res/s_Custom/master/master.css

- ./res/s_Custom/master/graph.xml

- ./res/s_Custom/master/custom.css

- ./res/s_Custom/master/styleproperties.res

- ./res/s_Custom/master/*.png

- ./res/s_Custom/master/*.gif

接頭辞としてs_が付いているスタイル・ディレクトリには、スタイル・シート、イメージ・ファイルおよびgraph.xmlファイルが格納されます。

クラスはすべて、CSSまたはgraph.xmlファイル内にあります。

次の表に、"res"フォルダ構造の内容について説明します。

フォルダまたはファイル名

説明

filemap.xml^2

filemap.xmlファイルを使用すると、スタイルまたはスキンによって別のスタイルまたはスキンを拡張することを指定できるようになります。デフォルトでは、s_Custom^1がs_Skyrosを拡張しますが、これはfilemap.xmlファイルに定義されています。つまり、カスタムのスタイルまたはスキンの一部としてファイルが見つからない場合、プレゼンテーション・サービスはそのファイルを次にどこに探し行けばよいか認識しています。filemap.xmlファイルの内容は、次のようになっています。

<FileMap>
<Styles Default="s_blafp">
<Hierarchy>s_Skyros/s_Custom</Hierarchy>
</Styles
<Skins Default="sk_blafp">
<Hierarchy>sk_Skyros/sk_Custom</Hierarchy
</Skins>
</FileMap>

s_Custom

s_Customは、Customという名前のスタイルを定義するファイルが格納されているフォルダです。接頭辞s_は、フォルダにスタイルが格納されることを示します。この名前は、「ダッシュボードのプロパティ」ダイアログの「スタイル」オプションに表示されます。ダッシュボードのスタイルの更新の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドのダッシュボードとそのページのプロパティの変更に関する項を参照してください。

instanceconfig.xmlファイルを使用してデフォルト・スタイルを手動で変更する場合、instanceconfig.xmlファイルに指定するスタイル名はこのフォルダ名の一部として指定したスタイル名と一致する必要があります。スタイルには好きな名前を付けることができますが、s_で始める必要があります。カスタム・スタイルの名前を変更する場合は、filemap.xmlファイルも新しいスタイル名で更新する必要があります。

新しいスタイル・フォルダに追加するファイルおよびフォルダが、基本スタイルのファイルおよびフォルダと同じ名前(filemap.xmlファイルで定義)を共有する場合、これらの新しいファイルおよびフォルダは基本スタイルのファイルのかわりに使用されます。基本スタイルのファイルおよびフォルダを参考にしてカスタム・スタイル・フォルダを作成します。

必要な数だけ様々なスタイルを定義できます。s_Customフォルダのコピーを同じフォルダに作成し、接頭辞としてs_を付けて名前を付けます(s_Corporateなど)。追加のカスタム・スタイルを作成した場合は、filemap.xmlファイルのスタイル階層にそれらを追加する必要もあります。

sk_Custom

sk_Custom^1は、スタイルだけでなくフル・スキンをカスタマイズするために作成するフォルダです。sk_Customは、s_Customフォルダの兄弟として作成します。sk_Customは、bicustom-template.earファイルの一部として提供されません。接頭辞sk_は、フォルダにスキンが格納されることを示します。

instanceconfig.xmlファイルを使用してデフォルト・スキンを手動で変更する場合、instanceconfig.xmlファイルに指定するスキン名はこのフォルダ名の一部として指定したスキン名と一致する必要があります。スキンには好きな名前を付けることができますが、sk_で始める必要があります。カスタム・スキンの名前を変更する場合は、filemap.xmlファイルも新しいスキン名で更新する必要があります。

新しいスキン・フォルダに追加するファイルおよびフォルダが、基本スキンのファイルおよびフォルダと同じ名前(filemap.xmlファイルで定義)を共有する場合、これらの新しいファイルおよびフォルダは基本スキンのファイルのかわりに使用されます。基本スキンのファイルおよびフォルダを参考にしてカスタム・スタイル・フォルダを作成します。

必要な数だけ様々なスキンを定義できます。sk_Customフォルダのコピーを同じフォルダに作成し、接頭辞としてsk_を付けて名前を付けます(sk_Corporateなど)。追加のカスタム・スキンを作成した場合は、filemap.xmlファイルのスキン階層にそれらを追加する必要もあります。

master

masterフォルダには、カスタム・スタイルの作成に必要なファイルがすべて格納されます。

master.css

master.cssファイルには、スタイルで使用されるCSSクラスがすべて含まれ、プレゼンテーション・サービスおよびOracle BI Publisher全体で使用されるCSSクラスおよびスタイルのほとんどが定義されます。このファイルに含まれるクラスに定義されているスタイルを変更すると、Oracle BI EEで広範囲に影響します。

このファイルのCSSクラス・セレクタ(CSSクラス名)の変更はお薦めしません。各CSSクラス内に定義されているスタイルを変更してください。master.cssファイルには、どのクラスが適用され、ユーザー・インタフェースのどの部分に適用されるかを理解するのに役立つコメントも含まれます。

custom.css

custom.cssファイルは、master.cssファイルによってインポートされる空(空白)のファイルです。custom.cssファイルを使用すると、master.cssを変更せずに(たとえば、スタイルを分析に適用するために)独自のCSSクラスを追加したり、master.cssファイルのクラスをオーバーライドできます。別ファイルであるcustom.cssファイルで変更を維持すると、パッチおよびアップグレードで適用されるmaster.cssファイルに対する今後の改善を利用できるようになります。

graph.xml

graph.xmlファイルを使用すると、分析での各種グラフに適用するデフォルト・スタイルをすべて定義できます。graph.xmlファイルにはコメントが付いています。このようなコメントでは、各設定の有効な値とそのスタイルの要素について説明しています。

styleproperties.res

styleproperties.resファイルにより、ユーザー・インタフェースの要素のいくつかを詳細に制御できます。たとえば、ダッシュボードのレンダリング時に使用するデータ・ロード・アニメーションのバージョンを指定できます。データ・ロード・アニメーションは、Webページでサーバーからデータをロードする際に、ページの"ステータス・インジケータ"領域で使用されます。データ・ロード・アニメーションには異なるバージョンが2つあり、明るい背景で使用するために暗い前景色を使用しているアニメーションと、その反対のアニメーションです。

styleproperties.resファイルにはコメントが付いています。このようなコメントでは、要素を説明しています。

.pngおよび.gif (イメージ・ファイル)

masterディレクトリには、必要なすべてのイメージと最も一般的なイメージがあります。これらのイメージは、主に.png形式と.gif形式です。これらのイメージは、独自のファイル(できれば同じサイズのイメージ)で置き換えることができます。

1. s_Customなどのファイル名は、大/小文字が区別され、Linuxでは小文字です。

2. filemap.xmlファイルを使用した拡張対象のスタイルまたはスキンの指定は、プレゼンテーション・サービスに対してのみ適用されます。

Skyrosマスター・ブランディング・クラスの変更の例

SkyrosのCSSを変更すると、CSS内に含まれる要素に対する変更を有効にできます。

たとえば、マスター・ブランディング領域の背景色を黒から明るい青色に変更する場合、次の手順を実行します。

1. master.cssファイルを開きます。

2. 下にスクロールして、カスタマイズするクラスを探します。サンプル・コードの.masterBrandingAreaクラスを変更します。また、コードには、そのコード・セクションを特定するインライン・コメントがあることに注意してください。

.
.
.
.masterHeader
{
font-weight: bold;
color: #003d5b;
text-align: left;
}
/* BRANDING AREA ========================================================= */
/* This class applies to the branding area shown at the top of most pages. */
{
.masterBrandingArea
{
background-color: #000000;
color: #ffffff;
padding: 5px;
}
/* This class applies to the brand name text shown at the top of most pages. */
.masterBrandingAreaBrandName
{
font-size: 17px;
font-weight: bold;
.
.
.

注意:

custom.css設定をダッシュボードで使用するには、custom.cssファイルのコロン(;)の前にテキスト!importantを追加します。これにより、custom.cssの後に開いた他のcssファイルが値を上書きすることが防止されます。

たとえば、masterBrandingAreaクラスの背景色を黒から薄い灰色に変更し、テキストの色を白から黒に変更する場合などです。ログイン、ホーム、カタログ、分析およびログオフのブランド領域が薄い灰色で表示されますが、ダッシュボードのブランド領域は黒、テキストは白のままです。ダッシュボードのカスタム設定を保持するには、次のようにセミコロン(;)の前に!importantを追加します。

.masterBrandingArea
{
background-color: #ffffff !important; /* white background */
color: #333333 !important; /* almost black text color */
}

3. HTMLの背景色コード値を#000000から#3300ffに変更します。

4. ファイルを保存します。

5. メタデータを再ロードし、ブラウザのキャッシュをクリアします。詳細は、「Oracle BI Webユーザー・インタフェースのカスタマイズ」を参照してください。

ダッシュボードでの外部コンテンツの埋込み

セキュリティ上の理由から、ダッシュボードの外部ドメインからコンテンツを埋め込むことはできなくなりました。ダッシュボードで外部コンテンツを埋め込むには、instanceconfig.xmlファイルを編集する必要があります。

1. 次のinstanceconfig.xmlファイルを開いて編集します。
ORACLE_HOME/user_projects/domains/bi/config/fmwconfig/biconfig/OBIPS

2. すべての外部ドメインまたは特定の外部ドメインからコンテンツを埋め込むかどうかに応じて、次の操作のいずれかを実行します。

a. すべての外部ドメインからコンテンツを埋め込むには、次の例に示すように、要素およびその祖先要素を含めます。

<ServerInstance>
<Security>
<ContentSecurityPolicy>
<PolicyDirectives>
<Directive>
<Name>frame-src</Name>
<Value>*</Value></Directive>
<Directive><Name>img-src</Name>
<Value>*</Value>
</Directive>
</PolicyDirectives>
</ContentSecurityPolicy>

注意:

<Value>要素のワイルドカード文字"*"を使用して、内部および外部ドメインからダッシュボードでコンテンツを埋め込むことができます。

b. www.xxx.com、www.yyy.comなどの多数の特定のドメインからコンテンツを埋め込むには、次の例に示すように要素およびその祖先要素にスペースで句切られた各ドメインの名前を含めます。

<ServerInstance>
<Security>
<ContentSecurityPolicy>
<PolicyDirectives>
<Directive>
<Name>frame-src</Name>
<Value>www.xxx.com www.yyy.com</Value></Directive>
<Directive><Name>img-src</Name>
<Value>www.xxx.com www.yyy.com</Value>
</Directive>
</PolicyDirectives>
</ContentSecurityPolicy>

特定のドメインのinstanceconfig.xmlファイルを構成する場合、次の点に注意してください。

- instanceconfig.xmlファイルのデフォルト設定は、内部ドメインからのみコンテンツを埋め込むことができます。instanceconfig.xmlファイルを編集して外部ドメインを指定する場合、ファイルのデフォルト設定を上書きするため、内部ドメインにアクセスできなくなります。内部ドメインのアクセスを続行するには、外部ドメインの名前の前に'self'とスペースを付ける必要があります。たとえば、内部ドメインおよび特定のドメイン(www.xxx.com)からコンテンツを引き続き埋め込むには、<Value>要素に次のテキストを入力します。
'self' www.xxx.com

- 特定のドメインのinstanceconfig.xmlファイルを構成する場合、ワイルドカード文字を使用して親ドメインの下にあるすべてのサブドメインからコンテンツを埋め込むことができます。たとえば、www.xxx.*.comを指定する場合、xxx.hr.com、xxx.fin.comなどのすべてのサブドメインからコンテンツを埋め込むことができます。

3. 変更内容を保存し、ファイルを閉じます。

18 エージェントの構成および管理

この章では、Oracle Business Intelligenceでエージェントを構成および管理する方法について説明します。

所属組織がOracle BI Deliversのライセンスを受けており、かつユーザーに適切な権限が付与されている場合、そのユーザーはデフォルトのインストールの一部として、追加構成なしにエージェント機能を使用できます。エージェントの使用の詳細は、Oracle Business Intelligence Enterprise Editionユーザーズ・ガイドのコンテンツの配布に関する項を参照してください。

この章の内容は次のとおりです。

- エージェントの使用方法

- ウイルス対策ソフトウェアおよび権限がエージェントに及ぼす影響

- エージェントに影響する設定の構成

- エージェントのデバイス・タイプの管理

- アクティブなエージェント・セッションの監視

注意:

Oracle Business Intelligence環境を新しいシステムに移行する場合は、Oracle Business Intelligenceリポジトリ・ファイル、Oracle BIプレゼンテーション・カタログおよびOracle BIスケジューラの表も必ず移行してください。エージェントはOracle BIスケジューラの表を必要とします。

エージェントの診断およびログ・ファイルの詳細は、「エージェントに関する問題の診断」を参照してください。

エージェントの使用方法

エージェントは、スケジュールとトリガー・イベントの組合せに基づいて、ターゲットの分析をユーザーに配信します。この配信には、ダッシュボード・アラートや電子メールなどの様々なルートを使用できます。

Oracle Business Intelligenceのユーザー(「エージェントの作成」権限を持つユーザー)がエージェントを作成するには、そのエージェントに実行させる操作を定義します。Oracle BIサーバーによって、優先度、配信デバイス、ユーザーなどの情報がジョブにパッケージ化され、そのジョブをいつ実行するかがOracle BIスケジューラに通知されます。『Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイド』のOracle BIスケジューラの概要に関する項を参照してください。

ウイルス対策ソフトウェアおよび権限がエージェントに及ぼす影響

この項では、エージェントへのアンチウィルス・ソフトウェアおよび権限の影響に関する次の情報を提供します。

ウイルス対策ソフトウェアがエージェントに及ぼす影響

Norton AntiVirusなどの一部のウイルス対策ソフトウェア・プログラムは、スクリプトによって実行されるシステム・オブジェクト(Windowsファイル・システム・オブジェクトなど)の呼出しのうち、安全ではないと判断されるすべての呼出しをブロックする、スクリプト・ブロック機能を有効化します。

エージェントのポスト処理の一部としてスクリプトを起動した場合、このウイルス対策機能が予期しない結果を招く可能性があります。Oracle BIスケジューラがインストールされているコンピュータ上で、スクリプト・ブロック機能を有効にしてウイルス対策ソフトウェアを実行している場合は、エージェントのスクリプトによる呼出しが予想外にブロックされないように、スクリプト・ブロック機能を無効にします。

エージェントに影響する権限

エージェントの権限の設定は、「Oracle BIプレゼンテーション・サービス管理」の「権限の管理」ページにある「デリバー」セクションで行います。

ユーザーがエージェントを作成するには、「エージェントの作成」権限が付与されている必要があります。エージェントの変更/削除を実行できる「エージェントの登録を公開」権限をユーザーに持たせるには、Oracle BI Presentation Catalog内の共有エージェント・オブジェクトと子オブジェクトの「変更」権限を付与する必要があります。『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』のプレゼンテーション・サービス権限の管理に関する項を参照してください。

注意:

Oracle BIプレゼンテーション・サービスがデータベース・ログオンによってユーザーを認証するように構成されている場合、関連付けられた変数の数が1を超えるまでは偽装が許可されます(USER以外のセッション変数が初期化ブロックに関連付けられている場合など)。関連付けられた変数の数が1を超えると、偽装されたユーザーは、データベースにログインし、他のセッション変数を入力するためのパスワードを与えられません。エージェントがデータベース認証と連動するのは、Oracle BI管理ツールで認証用に設定された初期化ブロックが、パススルー・ログインによる接続プールを使用する場合に限られます。この接続ブロックは、他の初期化ブロックやリクエストに対しては使用できません。

ユーザーの認証オプションの詳細は、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドを参照してください。パススルー・ログインの詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

エージェントに影響する設定の構成

エージェントの設定を構成するには、Oracle BIプレゼンテーション・サービスまたはOracle BIスケジューラの値を変更します。

エージェントの配信オプションの構成には、SAシステム・サブジェクト・エリアを使用します。この項では、次の項目について説明します。

- エージェントに影響するプレゼンテーション・サービス設定の手動による構成

- エージェントに影響するスケジューラの追加設定の手動による変更

- エージェントに影響するスケジューラの追加構成設定の内容

- エージェントの配信オプションの制御

エージェントに影響するプレゼンテーション・サービス設定の手動による構成

プレゼンテーション・サービスのinstanceconfig.xmlファイルに含まれている様々な要素を使用して、これらの設定を変更できます。変更は、クラスタ内のプライマリ・スケジューラとセカンダリ・スケジューラの両方のinstanceconfig.xmlに適用する必要があります。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるセクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<Alerts>
<Enabled>false</Enabled>
<DefaultDeliveryFormat>pdf</DefaultDeliveryFormat>
</Alerts>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. プレゼンテーション・サービスを再起動します。

要素

説明

デフォルト値

Enabled

Oracle BI Deliversを有効にするかどうかを指定します。可能な値はtrueまたはfalseです。

デリバーはプレゼンテーション・サービスのオプション・コンポーネントであり、該当するライセンスを購入すると、デフォルトで有効化されます。エージェントを作成するには、デリバー・コンポーネントを使用します。

true

DefaultDeliveryFormat

エージェントを介して送信する、電子メールによるレポートのデフォルトの形式を指定します。

たとえばコンテンツ・デザイナは、開発チームに毎日レポートを送信するエージェントを作成することによって、前日に修正された不具合数に関する情報を共有できます。コンテンツ・デザイナがエージェントを作成する際には、電子メールの形式を指定できます。管理者は、このような電子メールのデフォルトの形式として次のいずれかの値を指定できます。

- html

- pdf

- excel

- text

html

エージェントに影響するスケジューラの追加設定の手動による変更

Fusion Middleware Controlで変更できるスケジューラ設定に加えて、その他の設定を手動で変更できます。これらの設定を変更するには、instanceconfig.xmlファイルの様々な要素を使用します。変更は、クラスタ内のプライマリ・スケジューラとセカンダリ・スケジューラの両方のinstanceconfig.xmlに適用する必要があります。

1. 次のOracle BIスケジューラ・バージョンのinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBISCH

2. 「エージェントに影響するスケジューラの追加構成設定の内容」で説明している要素を追加または更新する必要があるセクションを見つけます。

3. 必要な要素とその祖先要素を追加します。Log_Dirの入力例を次に示します。

<xs:element name="Log_Dir" type="xs:string" default="ibots" minOccurs="0">
<xs:annotation>
<xs:documentation xml:lang="en">
The directory where Agent logs are stored.
</xs:documentation>
</xs:annotation>
</xs:element>

注意:

instanceconfig.xmlファイルには、ユーザー名とパスワードの値は指定できません。かわりに、Fusion Middleware Controlで値を指定します。これにより、指定した値が、その他すべてのユーザー名およびパスワードとともに集中管理された資格証明ウォレットに安全に格納されます。

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

エージェントに影響するスケジューラの追加構成設定の内容

エージェントはスケジューラ構成設定によって変更できます。

変更が可能な、エージェントに影響するOracle BIスケジューラの追加構成設定は次のとおりです。

- エージェントに影響するスケジューラの一般構成設定

- エージェントに影響する、スケジューラの電子メール関連の構成設定

- エージェントのスケジューラ構成設定

エージェントに影響するスケジューラの一般構成設定

一般構成設定として、スケジューラのバックエンド・データベースへのアクセスと構成、一部の動作設定、セキュア・ソケットの設定、およびクラスタ構成などがあります。

設定を次の表で説明します。

要素

説明

デフォルト値

PoolTimeout

操作の完了後に、データソースへの接続をオープンのままにしておく時間を分数で指定します。

この時間中は、最大接続数に指定された数に達するまで、新しい操作で新しい接続はオープンされず、この接続が使用されます。この時間は接続リクエストの完了ごとにリセットされます。

1以上の値を指定します。

60

NumDbConnections

Oracle BIスケジューラが同時にオープンできる、データベースの最大接続数を指定します。1以上の値を指定します。この制限に達すると、接続要求は接続が利用可能になるまで待機します。

5

TABLE_JOBS

スケジュールされたジョブに関する情報の格納に使用するデータベース表の名前を指定します。

データベース表の名前の変更の詳細は、Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイドのOracle BIスケジューラの表名の変更に関する項とOracle Business Intelligenceアプリケーションのインストールおよび構成ガイドを参照してください。

S_NQ_JOB

TABLE_INSTANCES

ジョブ・インスタンスに関する情報の格納に使用するデータベース表の名前を指定します。

S_NQ_INSTANCE

TABLE_PARAMS

ジョブのパラメータに関する情報の格納に使用するデータベース表の名前を指定します。

S_NQ_JOB_PARAM

TABLE_ERRMSGS

正常に終了しないジョブ・インスタンスに関する情報の格納に使用するデータベース表の名前を指定します。

S_NQ_ERR_MSG

SchedulerScriptPath

Oracle BIスケジューラが作成したジョブ・スクリプトの格納場所のパスを参照します。通常、このディレクトリに対してクリプトの追加と削除は行わないでください。デフォルトでは、このフィールドは次に設定されます。

BI_DOMAIN/servers/obisch1

scripts\scheduler

DefaultScriptPath

ユーザー(エージェントではなく)が作成したジョブの格納場所のパスを指定します。

ジョブの追加または変更時に「スクリプト」フィールドにファイル名が入力されると、Oracle BIスケジューラはこのディレクトリの内容を調べて、指定されたファイルを探します。しかし、「スクリプト」フィールドにフルパスが指定された場合は、このディレクトリをチェックしません。デフォルトでは、このフィールドは次に設定されます。

BI_DOMAIN/servers/obisch1

scripts\common

TempPath

Oracle BIスケジューラの実行中に一時ファイルを格納する場所のパスを指定します。

デフォルト値なし

BulkFetchBufferSize

データベースのゲートウェイで使用されます。データソースからデータを取得するためのバルク・フェッチ・ページの最大サイズをバイト単位で指定します。

33,792

LogAllSqlStmts

場合によっては、ODBCのような汎用プロトコルを使用してデータベースを指すようにスケジューラを設定することもあります。これは通常、「ターゲット・タイプ」を指定しないときに行われます。このような場合にSQL文がエラーになると、どの文でエラーになったのか判別する必要があります。この設定をオンにすると、問題のSQL文がスケジューラのログ・ファイルに書き込まれます。この設定では、オーバーヘッドがかなり高くなるため、本番モードではTRUEに設定しないでください。

false

ServerPortNumber

サーバーのポート番号を指定します。デフォルトは、Oracle BIスケジューラのポート番号です。

スケジューラ用に設定されているポート番号。

PurgeInstDays

バックエンド・データベースから古いジョブ・インスタンスを自動的に削除するまでの日数を指定します。

7

PurgeIntervalMinutes

Oracle BIスケジューラが表を更新し、影響を受けた行に削除済のフラグを設定する間隔を分数で指定します。

注: ジョブまたはインスタンスの削除時、Oracle BIスケジューラによって実際にSQL DELETE文が発行されるわけではなく、単に行に削除対象のフラグが設定されるだけです。

X分経過するたびに、実際のSQL DELETE文が発行されます(Xはこのフィールドで定義された値)。

60

MinExecThreads

実行時にジョブを実行する、Oracle BIスケジューラのスレッド・プール内の複数スレッドの最小数を指定します。

1

MaxExecThreads

実行時にジョブを実行する、Oracle BIスケジューラのスレッド・プール内の複数スレッドの最大数を指定します。

100

PauseOnStartup

Oracle BIスケジューラの開始時にジョブを何も実行しないことを指定します。Oracle BIスケジューラが一時停止している間に、ユーザーはジョブの追加、変更および削除を実行できます。しかし、ジョブは実行されません。「サービス管理」メニューで「スケジュールの続行」を選択すると、通常の実行が続行されます。

false

CertificateFileName

SSL証明書ファイル・パスを指定します。

この設定ではSSLがサポートされます。

デフォルト値なし

CertPrivateKeyFileName

SSL証明書秘密鍵ファイルを指定します。

この設定ではSSLがサポートされます。

デフォルト値なし

PassphraseFileName

パス・フレーズを含むSSLファイルを指定します。

この設定ではSSLがサポートされます。

デフォルト値なし

PassphraseProgramName

パス・フレーズを生成するSSLプログラムを指定します。

この設定ではSSLがサポートされます。

デフォルト値なし

CertificateVerifyDepth

SSL証明書検証の深さを指定します。

デフォルト値なし

CACertificateDir

CA証明書ディレクトリを指定します。

この設定ではSSLがサポートされます。

デフォルト値なし

CACertificateFile

CA証明書ファイルを指定します。

この設定ではSSLがサポートされます。

デフォルト値なし

TrustedPeerDNs

SSL信頼できるピアのDNを指定します。

デフォルト値なし

VerifyPeer

ピアを検証するかどうかを指定します。

この設定ではSSLがサポートされます。

false

CipherList

暗号リストを指定します。

この設定ではSSLがサポートされます。

デフォルト値なし

ScriptRPCPort

スクリプト・プロセスとOracle BIスケジューラ・プロセスとのプロセス間通信に使用するポートを指定します。このポートはOracle BIスケジューラを実行するコンピュータからの接続のみを受け入れます。

9707

エージェントに影響する、スケジューラの電子メール関連の構成設定

次の構成パラメータを指定してエージェントを構成します。

要素

説明

デフォルト値

SmtpCipherList

SMTPサーバーがサポートする暗号スイート名に一致する暗号のリストを指定します。たとえば、RSA+RC4+SHAなどです。『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』の構成テンプレートで構成されたシステムでのSSLの有効化に関する項を参照してください。

デフォルト値なし

UseStartTLS

UseSSLがtrueでない場合は無視されます。UseStartTlsがtrueの場合は、SMTPセッションに対してSTARTTLSオプション(RFC 2487)を使用します。最初の接続には非保護リンク(通常、ポート25)が使用されます。その後、STARTTLS SMTPを使用して、接続が保護リンクに昇格されます。UseStartTlsがfalseの場合は、ただちに保護接続が作成され、その後SMTPプロトコルが開始されます。これはSMTPSとも呼ばれます。SMTPSでは、通常、ポート465が使用されます。

true

エージェントのスケジューラ構成設定

機能的には、エージェントはOracle BIサーバーとOracle BIスケジューラに格納されているデータを組み合せたものです。

スケジューラのinstanceconfig.xmlファイルの各要素によって、特定のOracle BIスケジューラ上で実行されるすべてのエージェントの動作が定義されます。エージェントの各構成要素を次の表に示します。

要素

説明

デフォルト値

Log_Dir

例外エラー状態が発生した場合、エージェントによってログ・ファイルを作成できます。Log_Dirには、このようなファイルの保存場所のディレクトリを指定します。このディレクトリは、Oracle BIスケジューラ・サーバーからアクセス可能である必要があります。Windowsの場合、デフォルトのインストールでは、Oracle BIスケジューラのサービスはシステム・アカウントとして実行されるため、Oracle BIスケジューラは、ネットワーク・ディレクトリに対する書込みと読取りは実行できません。スクリプト・ファイルをネットワーク共有に配置する場合や、スクリプトからネットワーク共有にアクセスする場合は、Oracle BIスケジューラをネットワーク・ユーザーとして実行する必要があります。

ログ・ファイルの詳細は、「エージェントに関する問題の診断」を参照してください。

ibots

LogPurgeDays

古いエージェント・ログ・ファイルを自動的に削除するまでの日数を指定します。古いログが自動的に削除されないようにするには、この値を0(ゼロ)に設定します。

7

NumGlobalRetries

Webサーバーやメール・サーバーにあまりに多くのユーザーがログオンしていると、Oracle BIスケジューラからの接続も含めて、新しい接続がサーバーから拒否されることがあります。このような負荷に対処するため、エージェントは接続を再試行します。この要素では、配信内容と配信先に関するグローバル情報を取得するための再試行の最大回数を設定します。この回数に達すると、エージェントは接続試行を取りやめます。この値を0(ゼロ)に設定すると、再試行はまったく行われません。

2

MinGlobalSleepSecs

エージェントが配信内容と配信先に関するグローバル情報を取得するためのサーバーへの接続を拒否された後、サーバーへの再接続を試みる前にランダムに停止する最小秒数を指定します。

3

MaxGlobalSleepSecs

エージェントが配信内容と配信先に関するグローバル情報を取得するためのサーバーへの接続を拒否された後、サーバーへの再接続を試みる前にランダムに停止する最大秒数を指定します。

10

NumRequestRetries

エージェントは、グローバル情報の受信後、サーバーに対して、ユーザーごとに一意の一連のリクエストを発行します。この要素では、これらのリクエストを発行するためにOracle BIスケジューラが行うサーバーへの接続の再試行回数を指定します。この値を0(ゼロ)に設定すると、再試行はまったく行われません。

3

MinRequestSleepSecs

エージェントがリクエストを発行するためのサーバーへの接続を拒否された後、サーバーへの再接続を試みる前にランダムに停止する最小秒数を指定します。

2

MaxRequestSleepSecs

エージェントがリクエストを発行するためのサーバーへの接続を拒否された後、サーバーへの再接続を試みる前にランダムに停止する最大秒数を指定します。

10

NumDeliveryRetries

一意のリクエストの実行後、エージェントは指定されたデバイスへの結果の配信を試みます。この要素では、Oracle BIスケジューラが結果を配信するために行うサーバーへの接続の再試行回数を指定します。この値を0(ゼロ)に設定すると、再試行はまったく行われません。

4

MinDeliverySleepSecs

エージェントが結果を配信するためのサーバーへの接続を拒否された後、サーバーへの再接続を試みる前にランダムに停止する最小秒数を指定します。

5

MaxDeliverySleepSecs

エージェントが結果を配信するためのサーバーへの接続を拒否された後、サーバーへの再接続を試みる前にランダムに停止する最大秒数を指定します。

10

MaxRowsTimesColumns

この値は、複数のエージェントが結合されている場合にエージェント間で渡されるフィルタのサイズを制御します。エージェントから、結合されている別のエージェントにフィルタを渡す場合、Oracle BIスケジューラによって、パーソナライズされた各受信者の条件付きレポートの結果セットの結合が作成されます。場合によっては、このレポートのサイズが非常に大きくなることがあります(1つのレポートに、10個の列からなる100個の一意行を持つ1000人のユーザーが存在する場合、フィルタの列値は1,000,000個になります)。Oracle Business Intelligenceサーバーはこのような大規模なフィルタを処理できない場合があるため、この要素によってフィルタの列*行の最大数を指定します。

10,000

Debug

デバッグ有効。

この要素を設定すると、Oracle BIスケジューラはエージェントごとにログ・ファイルを生成します。このログ・ファイルには、問題の診断時に役立つロギング・メッセージが記録されます。このログ・ファイルは次の場所に格納されます

BI_DOMAIN/servers/obisch1/logs

ジョブ・インスタンスごとに、Agent-<ジョブ番号>-<インスタンス番号 >.logという新しいログ・ファイルが作成されます。ジョブ・マネージャを使用して、個々のジョブのDebug設定をオーバーライドすることもできます。

「エージェントに関する問題の診断」を参照してください。

false

KeepErrorLogFiles

この要素をtrueに設定すると、各エージェントのエラー・ログ・ファイルが生成されます。このログ・ファイルは、エージェントの実行中にエラーが発生した場合にのみ作成され、エラー・メッセージのみが記録されます。ファイルは次の場所に格納されます。

BI_DOMAIN/bi/servers/obisch1/logs

true

エージェントの配信オプションの制御

配信オプション(つまり、配信デバイスと配信プロファイル)によって、エージェントのコンテンツのユーザーへの配信方法が決まります。

ユーザーは配信オプションの構成を、LDAPサーバー(電子メール・アドレスの構成)またはSAシステムのサブジェクト・エリアで設定できます。詳細は、Oracle Business Intelligence Enterprise Editionジョブ・スケジュール・ガイドのSAシステム・サブジェクト領域の設定に関する項を参照してください。

エージェントのデバイス・タイプの管理

ユーザーへのエージェントのコンテンツの配信には、携帯電話やページャなど、各種カテゴリのデバイス・タイプを使用できます。個々のデバイス・カテゴリの作成、表示、編集および削除が可能です。多数のデバイス・タイプが自動的に提供されます。ユーザー向けに必要なタイプを追加できます。

注意:

システムによってシードされたデバイス・タイプ(AT&Tモバイルなど)については、表示のみ可能です。編集と削除はできません。

「デバイス・タイプの管理」権限を持つユーザーは、デバイス・タイプの管理機能を利用できます。『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』の「アプリケーション・ロールを使用したプレゼンテーション・サービス権限の管理」を参照してください。

1. Oracle Business Intelligenceにログインします。

2. グローバル・ヘッダーで「管理」をクリックします。

3. 「デバイス・タイプの管理」リンクをクリックして、「デバイス・タイプの管理」ページを表示します。

4. 「新規デバイス・タイプの作成」リンクをクリックします。

5. 「新規デバイス・タイプの作成」ダイアログで必要な設定を行い、「OK」をクリックします。

6. 「デバイス・タイプの作成」をクリックすると、「デバイス・タイプの管理」画面に戻ります。

デバイス・タイプを表示または編集するには:

1. グローバル・ヘッダーで「管理」をクリックします。

2. 「デバイス・タイプの管理」リンクをクリックします。

3. 該当するデバイス・タイプの「編集」ボタンをクリックします。

4. 「デバイス・タイプの編集」ダイアログで必要な設定を行い、「OK」をクリックします。

デバイス・タイプを削除するには:

1. グローバル・ヘッダーで「管理」をクリックします。

2. 「デバイス・タイプの管理」リンクをクリックします。

3. 削除するデバイス・タイプの「削除」ボタンをクリックします。

確認ボックスが表示されます。

4. 「OK」をクリックして、削除を確定します。

アクティブなエージェント・セッションの監視

「Oracle BIプレゼンテーション・サービス管理」の「エージェント・セッションの管理」ページを使用して、Oracle BIスケジューラによってトリガーされた現在アクティブなエージェントを監視します。たとえば、セッション別のアクティブ・エージェント・リストを表示できます。

1つ以上のエージェント・セッションがアクティブな場合は、Oracle BIスケジューラによってエージェント・セッションに割り当てられているジョブ識別子やインスタンス識別子など、各エージェント・セッションの情報が表示されます。エージェント・セッションを展開すると、個々のエージェント(1つのエージェントまたは結合された複数のエージェント)が表示されます。エージェントの状態は、「作成済」、「移入済」または「条件付きリクエスト解決済」のいずれかになります。

特定のセッションの特定のエージェントを展開すると、そのエージェントの受信者と、グループで定義されているエンジニアリング受信者や個別ユーザーなどの受信者のタイプが表示されます。受信者がグループの場合、グループの個々のメンバーのリストは表示されません。

注意:

複数のエージェントが結合されている場合、受信者リストは親エージェントに依存します。受信者は親エージェント定義に対してのみ表示され、結合されたエージェントの実際の実行に対しては表示されません。

1. グローバル・ヘッダーで「管理」をクリックします。

2. 「エージェント・セッションの管理」リンクをクリックして、「エージェント・セッションの管理」ページを表示し、次のいずれかを実行します。

- 特定の列の値に基づいてエージェント・セッションをソートするには、その列の「ソート」ボタンをクリックします。
リストを再ソートすると、ページがリフレッシュされるため、アクティブなエージェント・セッションの数が増えたり、減ったりする場合があります。

- 特定のセッション内の個々のエージェント・セッションの詳細を表示するには、「展開」ボタンをクリックします。

- 個々のエージェントの定義を表示するには、そのリンクをクリックします。

『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』の「管理」ページに関する項を参照してください。

19 マッピングおよび空間情報の高度なオプションの構成

この章では、Oracle Business Intelligenceでマップ・ビューに対して設定できる高度な構成オプションについて説明します。

この章の内容は次のとおりです。

- MapViewerでのマップ・ビューのサポートの構成

- マップ・ビューの手動による構成

- マップ上へのテキストの挿入

- マップを外部で使用するための構成

追加情報は、「マッピングおよび空間情報の構成」を参照してください。マップ・ビューを構成する前に、次のガイドの情報を理解しておく必要があります。

- 『Oracle MapViewerユーザーズ・ガイド』(Oracle Fusion Middlewareドキュメント・ライブラリの一部)

- Oracle Spatial開発者ガイド(Oracle Databaseドキュメント・ライブラリの一部)

MapViewerでのマップ・ビューのサポートの構成

Oracle Fusion Middleware MapViewerは、Oracle BI Enterprise Editionの一部としてインストールされ、Webアプリケーション・サーバー上でOracle BI EEと同じドメインにデプロイされます。

アプリケーション・サーバーでのMapViewerのデフォルトのコンテキスト・パスは、/mapviewerです。MapViewerの管理コンソールを使用して、MapViewerでマップ・ビューを使用できるように構成する必要があります。『Oracle MapViewerユーザーズ・ガイド』のMapViewerの構成に関する項を参照してください。

MapViewer専用のリモート・インスタンスを別に構成して、マップで必要となる重い処理負荷をサポートするプロキシとしてそのインスタンスを機能させることができます。パフォーマンスがそれほど重要ではない場合は、Oracle BI EEと同じ場所に配置されている(コロケート) MapViewerインスタンスをレンダリング・エンジンとして使用できます。

MapViewerエンジンは、次の役割で使用できます。

- コロケートMapViewer - 非プロキシ・モードとも呼ばれます。MapViewerをOracle BI EEと同じドメインに配置し、レンダリング・エンジンとして使用した場合、すべてのマップ・リソース(JavaScriptファイルやイメージなど)がそのMapViewerインスタンスからダウンロードされます。

- リモートMapViewer - プロキシ・モードとも呼ばれます。MapViewerの独立したリモート・インタンスをレンダリング・エンジンとして構成した場合、ブラウザはそのリモート・インスタンスと通信してリソースを要求できません。セキュリティ上の理由から、ブラウザではドメイン間のAJAX呼出しは実行できません。この制限に対処するため、すべてのリクエストがまずコロケートMapViewerに転送され、その後このMapViewerと実際のリモート・インスタンスとの通信が行われます。
リモートMapViewerを構成する手順は次のとおりです。

- 「マップ・ビューの手動による構成」で説明している手順に従って、instanceconfig.xmlファイルのRemoteOracleMapViewerAbsoluteURL要素を編集します。

- MapViewerの構成ファイルmapViewerConfig.xmlのproxy_enabled_hosts要素を編集して、リモート・サーバー上のMapViewerを指すように設定します。次に例を示します。

<security_config>
<proxy_enabled_hosts>http://remoteserver:9704/mapviewer</proxy_enabled_hosts>
</security_config>

mapViewerConfig.xmlファイルは次のディレクトリにあります。

ORACLE_BI1\bifoundation\jee\mapviewer.ear\web.war\WEB_INF\conf

注意:

mapViewerConfig.xmlファイルを編集した場合、その編集結果は、Oracle Business Intelligenceのアップグレードまたはパッチ適用時に上書きされます。アップグレードまたはパッチの適用を行う前には、必ずmapViewerConfig.xmlファイルのバックアップ・コピーを作成してください。アップグレードまたはパッチ適用操作が完了したら、バックアップされたファイルを元の場所にコピーします。ファイルをコピーしたら、マップ・ビューがOracle Business Intelligenceの分析およびダッシュボードで適切に表示されるようMapViewerのサーバーを再起動してください。

次の図は、マップ・ビューの優先アーキテクチャを示しています。プロキシを使用したこのアーキテクチャでは、次の表で示しているデフォルトのアーキテクチャよりもパフォーマンスが向上します。Oracle Database、またはOracle BI EEがサポートするその他のデータベースにデータを格納できます。

マップ・ビューの手動による構成

マップ・ビューの構成には、instanceconfig.xmlファイルの様々な要素を使用します。

1. 次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. SpatialMapsセクションを見つけ、このセクションに次の用語を追加する必要があります。

- ColocatedOracleMapViewerContextPath - Oracle BI EEと同じ場所にある(コロケート)MapViewerインスタンスのコンテキスト・パスを指定します。デフォルト値は/mapviewerです。

- RemoteOracleMapViewerAbsoluteURL - リモートのMapViewerインスタンスのURLを指定します。この要素にはデフォルト値はありません。
この要素に値が指定されていない場合、マップ・レンダリング・エンジンはコロケートMapViewerインスタンス(/mapviewerなど)であるとみなされます。この要素に値が指定されている場合は、コロケートMapViewerがリモート・サーバーに対するすべてのリクエストのプロキシとして機能します。次の例は値のサンプルです。

<RemoteOracleMapViewerAbsoluteURL>http://remoteserver:9704/mapviewer </RemoteOracleMapViewerAbsoluteURL>

- MaxRecords - マップ上の個々のレイヤーに含めることができる最大レコード数を指定します。この設定はマップ上のすべてのレイヤーに適用されるとともに、この設定によって、データ・キューブに適用されるMaxVisibleRows要素がオーバーライドされます。デフォルト値は500です。レイヤーの形式が原因でこの値を超える場合は、警告メッセージが表示されます。親要素はLayerDataLayoutです。

- SyndicatedOracleMapViewerContextPath — マップを外部ページに埋め込む場合に使用するMapViewerインスタンスのURLを指定します。詳細と例は、「マップを外部で使用するための構成」を参照してください。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<SpatialMaps>
<ColocatedOracleMapViewerContextPath>/mapviewer</ColocatedOracleMapViewerContextPath>
<RemoteOracleMapViewerAbsoluteURL></RemoteOracleMapViewerAbsoluteURL>
<LayerDataLayout>
<MaxRecords>600</MaxRecords>
</LayerDataLayout>
</SpatialMaps>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

マップ上へのテキストの挿入

マップのタイル・レイヤー定義に、著作権の文字列などの任意のテキストを追加できます。

タイル・レイヤーが追加または削除されたときや、タイル・レイヤーが非表示になったときには、Oracle BI EEでマップ上のテキストが自動的に更新されます。また、ユーザーが概要マップを最小化したり、元のサイズに戻したり、削除したりしたときには、テキストの位置が自動的に調整されます。

次の図は、マップ上の著作権文字列の例を示しています。文字列は画面の右下にあります。

1. タイル・レイヤーを作成します。

詳細は、Oracle MapViewerユーザーズ・ガイドを参照してください。

2. タイル・レイヤー定義を選択し、「詳細の編集/表示」ボタンをクリックして定義を編集します。

3. 「編集」ページで、「著作権情報」フィールドに適切なテキストを入力します。

たとえば、次のコードでは前述の図にあるような著作権行が表示されます。

<copyright>Map data © 2010, NAVTEQ</copyright>

4. 「送信」ボタンをクリックすると、変更内容が保存されます。

5. 更新されたテキストがマップに表示されない場合は、ブラウザの「最新の情報に更新」ボタンをクリックして、マップの表示を更新します。

マップを外部で使用するための構成

対応する構成オプションを設定することによって、Oracle WebCenter Portalのページなどの外部ページにマップ・ビューを埋め込むことができます。

独立したWebアプリケーション・サーバーにホストされているビューを埋め込むには、前の項で概説しているプロキシ・ルールに従ってください。ブラウザの制限があるため、外部ページまたはポータルと同じアプリケーション・サーバーにMapViewerインスタンスをインストールします。外部ページをホストしているWebアプリケーション・サーバーにインストールされているMapViewerインスタンスのプロキシ・コンテキスト・パスが、Oracle BI EEのコンテンツをホストしているアプリケーション・サーバーと異なる場合があります。その場合は、SyndicatedOracleMapViewerContextPath要素を設定します。Oracle BIプレゼンテーション・サービスのサーバーは、サード・パーティ・ページから送信されたリクエストを識別すると、この要素の値をチェックしてプロキシ・リクエストをどこに渡すかを判断します。

次の例では、この要素のサンプル値を示しています。

<ServerInstance>
<SpatialMaps>
<SyndicatedOracleMapViewerContextPath>/mapviewer</SyndicatedOracleMapViewerContextPath>
<RemoteOracleMapViewerAbsoluteURL>http://myserver:9704/mapviewer</RemoteOracleMapViewerAbsoluteURL>
</SpatialMaps>
</ServerInstance>

20 リソースの可用性とURL生成の構成

この章では、Oracle BIプレゼンテーション・サービスでのHTTPアクセスに対するリソースの利用可能化方法とURLの生成方法を構成する方法について説明します。

この構成を実行するには、instanceconfig.xmlファイルを変更してURL要素およびこの要素と相関性のあるサブ要素をファイルに含める必要があります。手順は次のとおりです。

1. 次のinstanceconfig.xmlファイルを開いて編集します。
BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるセクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<URL>
<AbsoluteCommandURLPrefix>value</AbsoluteCommandURLPrefix>
<CustomerResourcePhysicalPath>value</CustomerResourcePhysicalPath>
<CustomerResourceVirtualPath>value</CustomerResourceVirtualPath>
<ForceAbsoluteResourceURL>value</ForceAbsoluteResourceURL>
<ResourcePhysicalPath>value</ResourcePhysicalPath>
<ResourceServerPrefix>value</ResourceServerPrefix>
<ResourceVirtualPath>value</ResourceVirtualPath>
</URL>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

要素

説明

デフォルト値

AbsoluteCommandURLPrefix

プレゼンテーション・サービスによるコマンドURLの生成方法を指定します。値を明示的に指定する場合は、次の形式にする必要があります。

protocol://server/virtualpath

このvirtualpathは、プレゼンテーション・サービスへの完全な仮想パスです。デフォルトは、各クライアントからプレゼンテーション・サービスに送られたURLに基づいて、クライアントごとに個別に決定されます。

状況により異なる

CustomerResourcePhysicalPath

デフォルト・インストールに含まれていないリソース・ファイルの物理的な場所を指定します。このようなリソース・ファイルとして、カスタマイズしたスタイルおよびスキンが含まれます。内部デフォルトは、ORACLE_HOME\bi\bifoundation\web\appv2\resです。

フルパスを指定する必要があります。このパスに対する読取り権限がプレゼンテーション・サービスに付与されていることが必要です。たとえば、これが共有ネットワーク・リソースの場合、プレゼンテーション・サービスの実行元ユーザーにこの共有リソースへの読取り権限と、共有リソースのエクスポート元ファイル・システムへの読取り権限が付与されていることを確認する必要があります。

状況により異なる

CustomerResourceVirtualPath

CustomerResourcePhysicalPath要素に指定された、デフォルト・インストールに含まれていないリソース・ファイルに使用する仮想パスを指定します。

デフォルト値なし

ForceAbsoluteResourceURL

完全修飾仮想パスを持つリソース・ファイルに対して、プレゼンテーション・サービスが完全修飾URLを常に生成するかどうかを指定します。

falseに設定すると、リソースとプレゼンテーション・サービス拡張機能が1つのサーバーから供給されます。trueに設定すると、デフォルトのリソースはプレゼンテーション・サービス拡張機能と同じサーバーから供給され、カスタマ・リソースは別のサーバーから供給されます。この表で説明している他の設定の値に応じて、デフォルトのリソースとカスタマ・リソースを同じサーバーから供給し、プレゼンテーション・サービス拡張機能を別のサーバーから供給するように構成することも可能です。

false

ResourcePhysicalPath

プレゼンテーション・サービスのプライマリ・リソース・ファイルの物理的な場所を指定します。これらは、カスタムのスタイルやスキンなど、ユーザーがカスタマイズしたファイルではなく、プレゼンテーション・サービスとともに配布されるリソース・ファイルです。内部デフォルトは、ORACLE_HOME\bi\bifoundation\web\appv2\resです。

フルパスを指定する必要があります。このパスに対する読取り権限がプレゼンテーション・サービスに付与されていることが必要です。たとえば、これが共有ネットワーク・リソースの場合、プレゼンテーション・サービスの実行元ユーザーにこの共有リソースへの読取り権限と、共有リソースのエクスポート元ファイル・システムへの読取り権限が付与されていることを確認する必要があります。

このエントリの値がプレゼンテーション・サービスのDLLの物理的な場所と異なる場合は、ResourceVirtualPath要素の値を指定する必要があります。

デフォルト値なし

ResourceServerPrefix

イメージ、スクリプト・ファイル、スタイル・シート、ユーザーが指定する他のファイルなどの静的リソースのURLをプレゼンテーション・サービスでどのように生成するかを指定します。デフォルトは、 AbsoluteCommandURLPrefix要素のprotocol://serverです。

値を明示的に指定する場合は、次の形式にする必要があります。

protocol://server

仮想パスを指定すると、これは削除されます。

この要素では、メインのWebサーバーの負荷を減らすために静的リソースを提供する独立したWebサーバーを指定します。この接頭辞は、'/Path/file'形式の完全修飾仮想パスを持つリソースに使用されます。リソース・ファイルのパスが'Path/file'形式の相対仮想パスである場合は、使用する接頭辞は、プレゼンテーション・サービス拡張機能へのコマンドに使用されるものと同じになります。

protocol://server

ResourceVirtualPath

ResourcePhysicalPath要素に指定された、プレゼンテーション・サービスのプライマリ・リソース・ファイルに使用する仮想パスを指定します。これらのリソース・ファイルとカスタマ定義リソース・ファイルは、同じWebサーバーから供給する必要があります。

相対URLの生成では、リソース・フォルダがOracle BIプレゼンテーション・サービスのDLLファイルと同じディレクトリに存在すれば、resが仮想パスのデフォルトになります。

絶対URLの生成では、AbsoluteCommandURLPrefix要素の値がデフォルトとして使用されます。

値は次の形式の完全修飾仮想パスにする必要があります。

'/VirtualPath'

先頭のスラッシュを省略した場合は、このスラッシュが追加されます。

res

第VII部「ライフサイクルの管理」

ここでは、Oracle BI Enterprise Editionのライフサイクル管理タスクについて説明します。ライフサイクル管理は、システムのインストール、アップグレード、パッチの適用、新しい環境への移動、本番環境への移動、およびバックアップとリカバリで構成されます。

インストールの詳細は、Oracle Business Intelligenceのインストールと構成を参照してください。

アップグレードの詳細は、Oracle Business Intelligence移行ガイドを参照してください。

この部は、ライフサイクル管理タスクに関する次の章で構成されています。

- Oracle Business Intelligenceシステムへのパッチの適用

- 環境間のOracle Business Intelligenceの移動

- Oracle Business Intelligenceシステムのバックアップとリカバリ

21 Oracle Business Intelligenceシステムへのパッチの適用

この章では、Oracle Business Intelligenceのパッチについて説明します。

詳細は、『Oracle Fusion Middlewareパッチ適用ガイド』を参照してください。

この章の内容は次のとおりです。

- Oracle Business Intelligenceシステムへのパッチの適用について

- Oracle Business Intelligenceプラットフォームに適用されるパッチの内容

- プラットフォームに適用したパッチのロールバック

- 現在のパッチ・レベルの判定

Oracle Business Intelligenceシステムへのパッチの適用について

パッチの適用では、小さなファイルの集まりを既存のシステムにコピーする処理を行います。

通常、パッチはOracle製品の特定のバージョンに関連付けられており、製品の1つのマイナー・バージョンから同じ製品のより新しいバージョンへの(たとえば、バージョン12.2.1.1.0からバージョン12.2.1.2.0などへの)更新が実行されます。パッチ・セットとは、一度に適用することを意図して構成された一連のパッチを含む単一パッチです。

一般に、1台以上のコンピュータに分散する既存のOracle BI EE本番システムに対して、1つ以上の不具合の修正を含むパッチを適用します。不具合の修正は、Oracle WebLogic Serverの内部にデプロイされたシステム・コンポーネントおよびJavaコンポーネントに影響を及ぼす場合があります。パッチには、サーバーの新しい実行可能ファイルや、更新された、または新しいJavaクラス・ファイルが含まれることがあります。

完全なパッチ情報の入手先

Oracle BI EEプラットフォームへのパッチの適用(およびロールバック)には、Oracle OPatchユーティリティを使用します。パッチは、Oracleサポート・サービスからダウンロードできます。次を参照してください。

- Oracle Fusion Middlewareへのパッチ適用の詳細は、『Oracle Fusion Middlewareパッチ適用ガイド』を参照してください。

- パッチのReadmeには、パッチの用法の理解およびパッチを適用する手順で必要な情報が含まれます。パッチをダウンロードする場合、ReadmeドキュメントはMy Oracle Supportサイトの「Patches & Updates」画面からアクセスできます。

既存の12c BIサーバー・インストールの更新

この項では、既存の12.2.x BIサーバー・インストールを更新する方法について説明します。

前提条件:

- 個別パッチの場合、次の場所から<patch-number>.ZIPをダウンロードします。
https://support.oracle.com

- 他のすべての更新の場合、次の場所からbi_platform-12.2.x.y.z-<platform>.<extension>をダウンロードします。
https://otn.oracle.com

- ソフトウェア更新により、ORACLE_HOMEおよびPRODUCT_HOMEコンテンツのみが変更され、DOMAIN_HOMEおよびBI_DATA_HOMEはそのままです。

前提条件:

すべての製品プロセスが停止しています。

1. ORACLE_HOMEごとに、Oracle Universal Installerを実行します。
詳細は、Oracle Business Intelligenceのインストールと構成の新しいサーバーのインストールに関する項を参照してください。

2. (オプション)ORACLE_HOMEごとに、zipファイルを使用してOPatch(ORACLE_HOME/OPatch/opatch)を起動します。
これにより、ORACLE_HOMEが更新されます。

パッチの競合が発生した場合

パッチの競合が発生すると、処理は停止します。たとえば、1つのパッチで修復された同一のバグのセットを、重複するパッチで修復しようとすると、競合が発生します。

パッチの競合を解決する方法の詳細は、『Oracle Opatchユーザーズ・ガイド』を参照してください。競合の解決について、Oracleサポート・サービスに連絡してください。

Oracle Business Intelligenceプラットフォームに適用されるパッチの内容

Oracle Business Intelligenceプラットフォームのパッチは、DLL、JAR、EXEなどの拡張子を持つバイナリ・ファイルに適用されます。

Oracle Business Intelligenceプラットフォームのパッチは、次のものには適用されません。

- 構成ファイル
パッチの一部として構成の更新が必要な場合は、パッチ付属のREADME.txtファイルでその詳細を説明しています。この説明に従って、構成を手動で更新する必要があります。カスタマの構成ファイルとパッチを適用した構成ファイルを自動的にマージするメカニズムはありません。

- スキーマ・ベースのメタデータ
データベース・スキーマ(スケジューラ、使用状況統計、イベント・ポーリング、リポジトリ・ファイルおよびOracle BIプレゼンテーション・カタログのスキーマを含む)に格納されている非デザインタイム・メタデータにはパッチは適用されません。

アプリケーションのコンテキストで配布されるその他のプラットフォーム・メタデータ(リポジトリ・ファイルやOracle BIプレゼンテーション・カタログ・ファイルなど)にはパッチが適用されますが、これはプラットフォーム・パッチの一部としてではなく、アプリケーション・パッチの一部として適用されます。

プラットフォームに適用したパッチのロールバック

OPatchは、それぞれのOracleホームに適用された各パッチのメタデータを維持し、パッチ適用時の置換内容のコピーを保存しています。

パッチ全体をロールバックできます。

注意:
ロールバック後、Oracle BI EEのプラットフォーム・パッチがもう適用されていないことを確認するために、ロールバックの適用前に、パッチ・レベルを確定し、ロールバック後に再びパッチ・レベルの確定を行う必要があります。「現在のパッチ・レベルの判定」を参照してください。

現在のパッチ・レベルの判定

Oracle BI EEを正しく機能させるためには、OPatchと同じバージョンになるように各Oracleホームにパッチを適用する必要があります。

システム内の任意のOracleホームの現在のパッチ・バージョンを調べるには、OPatchのlsinventoryユーティリティを使用します。またこのユーティリティでは、特定のOracleホームのすべてのパッチのリストを対応するIDとともに取得することもできます。

1. コマンド・ウィンドウを表示し、OPatch実行可能ファイルがある場所へ移動します。

ORACLE_HOME/OPatch

2. 次のコマンド構文を使用して、lsinventoryユーティリティを実行します。

<Path_to_OPatch>/opatch lsinventory [-all] [-detail] [-patch] [-oh (Oracleホームの場所)]

例:

opatch lsinventory -patch -detail

lsinventoryのオプションの詳細は、ORACLE_HOME/OPatch/docsディレクトリにあるユーザー・ガイドを参照してください。

3. Oracleホームごとに前述のステップを繰り返して、他のOracleホームに対してもlsinventoryユーティリティを実行します。

詳細は、『Oracle Fusion Middlewareパッチ適用ガイド』を参照してください。

22 環境間のOracle Business Intelligenceの移動

この章では、Oracle Business Intelligenceを複数の環境間で移動させる方法について説明します。次のようにテスト環境から本番環境または新しい環境にOracle Business Intelligenceを移動できます。

- 環境間の移動

- 新しい環境への移動

- 11gから12cへのアップグレード

- サーバー全体の移行

環境間の移動

12.2.1のテスト環境から本番環境への移動は、メタデータ(コンテンツ、データ・モデルおよび認可)のみに適用されます。

テスト環境から本番環境へ移動するには、通常テスト環境でのアプリケーションの開発およびテストと、本番環境の同じオペレーティング・システム上へのテスト・アプリケーション(および必要に応じてテスト・データ)のロールアウトを行います。これには、単一のコンピュータ環境から複数のコンピュータ環境への移動も含むことができます。

前提条件

- ファイル・システム(オフライン)権限を持つ必要があります。

- コマンドはオフラインのみで実行できます。

- コマンドはエクスポートで読取り専用です(ソース・システムは変更されません)。

前提条件

- WLSTスクリプティングを使用します。
「WLST (WebLogic Scripting Tool)の使用」を参照してください。

- BIデプロイメントAおよびBサービス・インスタンスが異なるドメインに存在します。

- BIデプロイメントAサービス・インスタンスに変更が行われています。

- 管理ツール(データモデル)、アンサー(カタログ)、Fusion Middleware Control(セキュリティ)またはWLST。メタデータを変更する場合のみ、これらのツールが必要です。

- コマンドは読取り専用です。

テスト環境から本番環境へ移行するには:

次のオプションを使用できます。

- すべてのエクスポート
すべてのユーザーおよびデータソースが2つのシステム間で同じ場合などにこのオプションを使用できます。

- ユーザー・フォルダ・コンテンツなしでエクスポート
テスト・ユーザーが異なるコンテンツを持ち、同じデータ・ソースにアクセスする(ただし、異なるデータ・アクセスを使用)ユーザー承認テストの一部としてこのオプションを使用できます

- 接続プール資格証明なしでエクスポート
実行する必要がある処理がテスト後にあるシステムから別のシステムにアップグレードされたメタデータを移動するだけである場合にこのオプションを使用できます(共通のユーザーなし、異なるデータソース・セキュリティ)。

これらのオプションをサポートするため、エクスポート・コマンドには、ユーザー・フォルダ・コンテンツまたは接続プール資格証明をエクスポートする次のようなオプション・パラメータがあります。

exportServiceInstance(domainHome, serviceInstanceKey, workDir, exportDir, applicationName=None, applicationDesc=None, applicationVersion=None, includeCatalogRuntimeInfo=false, includeCredentials=None)

1. (オプション)既存のユーザー本番サービス・インスタンス・フォルダを保存する場合、本番に対してruncatアーカイブ・コマンドを使用してユーザー・フォルダを保存します。

2. exportServiceInstanceコマンドを実行して、TESTサービス・インスタンスをBARファイルにエクスポートします(ユーザー・フォルダおよび接続資格証明を使用または未使用)。

例:

exportServiceInstance('/u01/Oracle/Middleware/Oracle_Home/user_projects/domains/bi', 'ssi', '/u01/workDir', '/u01/exportDir', applicationName=None, applicationDesc=None, applicationVersion=None, includeCatalogRuntimeInfo=false, includeCredentials=None)

この例は、キーssiを使用してサービス・インスタンスを/u01/exportDir/ssi.barにエクスポートします。

3. importServiceInstanceコマンドを実行して、エクスポートされたTEST BARファイルをPRODサービス・インスタンスにインポートします。

importServiceInstance('/u01/Oracle/Middleware/Oracle_Home/user_projects/domains/bi','ssi','/u01/exportDir/ssi.bar')

この例は、BARファイル/u01/exportDir/ssi.barをキーssiを使用したサービス・インスタンスにインポートします。

4. ステップ1のruncatアーカイブ・コマンドを使用した場合、runcatアンアーカイブ・コマンドを使用して本番ユーザー・フォルダを元に戻すことができます。

事後状態:

- PRODサービス・インスタンス・メタデータは、TESTメタデータで置き換えられます。

- つまり、PRODサービス・インスタンスで直接作成されたコンテンツが置き換えられるか失われます。

- PRODサービス・インスタンスをホストするドメインの構成は変更されません

- TESTサービス・インスタンスをホストするドメインのメタデータまたは構成は変更されません。

新しい環境への移動

既存のOracle BIシステムを元のインストール場所とは別の場所で再作成することによって、Oracle Business Intelligenceを新しい環境に移動(移行)できます。この場合の目標は、別のハードウェアで同一のデプロイメントを再作成することです。

新しい環境への移動理由として、次のような状況が考えられます。

- より強力なハードウェアにシステム全体を移動する場合

- 別のオペレーティング・システムに移動する場合

- 別の物理的な場所に移動する場合
新しい環境への移行の詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

11gから12cへのアップグレード

11gメタデータを新しい12cデプロイメントに移行して、11gデプロイメントをアップグレードできます。

プロセスは、12c ドメインをターゲットとして作成する必要があるアウトオブプレース・アップグレードです。読取り専用の11gの動作保証されているリリースからエクスポート・バンドルを最初に作成し、それを使用して新しい12cドメインを再構成します

移行およびアップグレードの詳細は、Oracle Business Intelligence移行ガイドを参照してください。

サーバー全体の移行

Oracle Business Intelligenceでは、サーバー全体の移行もサポートしており、障害発生時にWebLogic Serverインスタンスを別の物理コンピュータに手動または自動で移行できます。

『Oracle WebLogic Serverクラスタの管理』のサーバー全体の移行に関する項および『Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイド』のエンタープライズ・デプロイメントのためのサーバー移行の構成に関する項を参照してください。

23 Oracle Business Intelligenceシステムのバックアップとリカバリ

この章では、Oracle Business Intelligenceのバックアップとリカバリに関する一般的な情報について説明します。バックアップとリカバリとは、ハードウェア障害とデータ消失からの保護、およびデータが消失した場合のデータの再構築に必要な様々な戦略および手順のことです。

Oracle Business Intelligenceのバックアップとリカバリの詳細は、Oracle Fusion Middlewareの管理のOracle Business Intelligenceのバックアップとリカバリの推奨事項に関する項に記載されています。

Oracle Business Intelligenceの障害回復の詳細は、Oracle Fusion Middlewareディザスタ・リカバリ・ガイド12c R2 (12.2.1)のOracle Fusion Middlewareコンポーネントの推奨事項に関する項を参照してください。

Oracle Business Intelligenceメタデータのバックアップおよびリストアの詳細は、「メタデータの管理およびサービス・インスタンスの操作」を参照してください。

第VIII部 Oracle Business IntelligenceでのOracle Essbaseの使用

Oracle EssbaseはOracle Business Intelligenceと連携して一連の完全なデータ分析機能およびプレゼンテーション機能を提供します。

ここでは、Oracle Business Intelligenceとともにインストールされた場合のOracle Essbaseの使用方法について説明します。この部は、次の章で構成されています。

- Oracle Business IntelligenceでのOracle Essbaseの使用の概要

24 Oracle Business IntelligenceでのOracle Essbaseの使用の概要

この章では、Oracle Business Intelligenceとともにインストールされた場合に、Oracle Essbaseの使用に関して知る必要があることについて説明します。この章には、上位レベルのロードマップが含まれ、インストール、システム管理、サービス・レベルのメンテナンスとセキュリティ、およびその他の情報源へのリンクが含まれています。

この章の内容は次のとおりです。

- 概要

- Oracle Business IntelligenceでインストールされたEssbaseを使用するための上位レベルのロードマップ

- Oracle BI EEでインストールされたEssbaseのタスクの実行と、EPMでの同じタスクの実行との比較および、参照先ガイドについての情報

- Oracle Business IntelligenceでのEssbaseのインストール

- Oracle Business IntelligenceでのEssbaseのセキュリティの構成

- Oracle Business IntelligenceでのEssbaseシステム管理

- Oracle Business IntelligenceでのEssbaseデータの使用

- Essbaseの詳細情報

概要

Oracle Business Intelligenceのインストール時に、Essbaseと関連ツールを簡単にデプロイでき、Oracle Business Intelligenceユーザーも使用できる共有管理、ユーザー管理、インストールおよび構成サポート機能を利用できます。

Oracle Business IntelligenceでEssbaseをデプロイする際は、Essbase多次元データベースにアクセスできます。このデータベースでは多次元分析を使用でき、カスタム分析アプリケーションを素早く開発できます。Essbaseを使用して、複雑なシナリオのモデリング、ビジネス・トレンドの予測および「What-If」分析の実行を行う分析アプリケーションを開発および管理できます。Essbaseでは、多数のユーザー、大量のデータ・セットおよび複雑なビジネス・モデルには事前に集計されたディメンションを使用して、問合せへの高速レスポンスをサポートします。Essbaseは、幅広いデータソースで使用するように構成できます。

Essbase StudioおよびEASは11g EPMインストーラを使用して別のドメインにデプロイでき、Oracle Business Intelligenceを介してインストールされた12c Essbaseサーバーで使用できます。

この章では、Oracle Business Intelligenceを使用してインストールされたEssbaseのインストール、構成、管理および保護について、さらにOracle Business Intelligenceを使用したEssbaseデータベースの作成、保護およびアクセスについて説明します。

この章には、EPMシステム・インストーラでインストールされたEssbaseの使用についての説明はありません。EPMシステム・インストーラでインストールされたEssbaseと関連ツールの使用の詳細は、EPMシステム・ドキュメント・ライブラリの「Deployment and Installation」タブにある、EPMシステムのデプロイメントのドキュメントを参照してください。

Oracle Business IntelligenceでインストールされたEssbaseと関連ツールについての情報の参照先ガイドの詳細は、「Oracle BI EEでインストールされたEssbaseのタスクの実行と、EPMでの同じタスクの実行との比較および、参照先ガイドについての情報」を参照してください。

Oracle Business Intelligenceのデータ・ソースとして使用するコンテキストにおけるEssbaseの他の使用では、EssbaseのEPMデプロイメントおよび11gの関連ツールを利用します(EPMデプロイメント・ガイドを参照)。将来のリリースで、Oracle Business Intelligenceを介してデプロイされたEssbaseの役割が展開されます。このため、BIドメインを展開する将来の課題を回避するためにEssbaseソフトウェアをインストールすることをお薦めします。『Oracle Essbaseデータベース管理者ガイド』のBI 12.2.1でデプロイされたEssbaseの理解に関する項を参照してください。

Oracle Business IntelligenceでインストールされたEssbaseを使用するための上位レベルのロードマップ

この項を読んだ後、Oracle Business IntelligenceでインストールされたEssbaseの使用を開始してください。

この上位レベルのロードマップでは、実行するタスクと適用可能な選択肢について説明します。また、この項では、どのような場合にOracle Business Intelligenceのドキュメントを参照するか、またはEPMシステムのドキュメントを参照するかについても説明します。

1. この章の残りの部分を読み、Essbaseの概念と構成タスクの概要を把握してください。

たとえば、「Oracle BI EEでインストールされたEssbaseのタスクの実行と、EPMでの同じタスクの実行との比較および、参照先ガイドについての情報」を参照してください。

2. 「Oracle Business IntelligenceでのEssbaseのインストール」の説明に従って、Essbaseスイート・オプションを選択してOracle Business IntelligenceとともにEssbaseをインストールします。

3. 「Oracle Business IntelligenceでのEssbaseのセキュリティの構成」の説明に従って、重要なセキュリティ・タスクを実行します。
EssbaseではOracle Fusion Middlewareのセキュリティ・モデルを使用しており、Oracle Business Intelligenceでも同じものを使用しています。詳細は、『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』を参照してください

4. 「Oracle Business IntelligenceでのEssbaseシステム管理」の説明に従って、重要なシステム管理タスクを実行します。

これらのタスクは、Oracle Business IntelligenceでEssbaseをインストールした後、Essbaseが正しく構成されていることを確認した後で実行します。

5. 「Oracle Business IntelligenceでのEssbaseデータの使用」の説明に従って、Essbaseキューブを作成、管理および使用します。

Oracle BI EEでインストールされたEssbaseのタスクの実行と、EPMでの同じタスクの実行との比較および、参照先ガイドについての情報

EssbaseをOracle Business Intelligenceでインストールする際は、Enterprise Performance Management Systemの完全インストールを実行しません。したがって、タスクによっては完了の指示がEPMのドキュメントの説明とは異なる場合があります。

次の表を使用すると、EPMシステムと比較して、Oracle Business Intelligenceでは何を使用して特定のタスクを実行するか、どのガイドを参照するかを判断するのに役立ちます。

Oracle BIおよびEPMシステムで実行されるEssbase関連タスク

Oracle BIシステムでのEssbase関連タスクの実行方法および参照先ガイド

11g EPMシステムでのEssbase関連タスクの実行方法および参照先ガイド

認証

Essbaseをインストール・プロセスの一部として設定する必要があり、12.2.1リリースのすべてのセキュリティをBIセキュリティを介して自動的に処理する必要があります。

EPM 11gガイドを参照してください。

11g EPMシステムを使用する場合は、HSS、MaxLを使用します。

EPMのガイドを参照してください。

認可

Essbaseをインストール・プロセスの一部として設定する必要があり、12.2.1リリースのすべてのセキュリティをBIセキュリティを介して自動的に処理する必要があります。

EPM 11gガイドを参照してください。

11g EPMシステムを使用する場合は、HSS、MaxLを使用します。

EPMのガイドを参照してください。

データ・セキュリティ(プロビジョニング)

Oracle Business IntelligenceでインストールしたEssbaseおよび関連ツールを使用する際は、Fusion Middleware Controlおよびセキュリティを使用します。

EPM 11gガイドを参照してください。

注意: 行レベルのセキュリティにEssbaseフィルタを定義する必要はありません。BIセキュリティ権限で処理されます。

ユーザーまたは非アクセラレーション・キューブによって直接アクセスされる12cキューブがある場合は、Essbaseにフィルタを作成する必要があります。

11g EPMシステムを使用する場合は、HSSを使用します。

EPMのガイドを参照してください。

データ・セキュリティ(フィルタ定義)

Oracle Business IntelligenceでインストールしたEssbaseおよび関連ツールを使用する際は、MaxLを使用します。

EPM 11gガイドを参照してください。

行レベルのセキュリティにEssbaseフィルタを定義する必要はありません。BIセキュリティ権限で処理されます。

ユーザーまたは非アクセラレーション・キューブによって直接アクセスされる12cキューブがある場合は、Essbaseにフィルタを作成する必要があります。

11g EPMシステムを使用する場合は、EAS (GUI)またはMaxl (コマンドライン)を使用します。

EPMのガイドを参照してください。

システム構成

Oracle Business IntelligenceでインストールしたEssbaseおよび関連ツールを使用する際は、Fusion Middleware Controlおよびessbase.cfgを使用します。

Oracle Business Intelligenceのガイドを参照してください。

11g EPMシステムを使用する際は、テキスト・エディタおよびMaxL、essbase.cfgを使用します。

EPMのガイドを参照してください(EASおよびStudioの場合)。

バックアップおよびリカバリ

Oracle Business IntelligenceでインストールしたEssbaseおよび関連ツールを使用する際は、Fusion Middleware Controlを使用します。

Oracle Fusion Middlewareの管理およびOracle Business Intelligenceのガイドを参照してください。

EPMのガイドを参照してください(Studioのバックアップも参照)。

移行(テストから本番へ)

移行ではアーティファクトにファイル・システムのコピーを使用します。パーティション、CDF/M,、セキュリティ・フィルタおよびデータは、EPM列にMaxlを使用してエクスポートします。

ライフサイクル管理ガイドを参照してください。

Essbaseキューブ

Essbaseを使用する場合、アクセラレーション・ウィザードを使用します。

EASおよびStudioを使用してキューブを作成および管理します。

EPMのガイドを参照してください(EASおよびStudioへの参照)。

『Oracle Essbaseデータベース管理者ガイド』を参照してください。

容量

該当なし

アクティブ/パッシブ・モデルを使用します(1クラスタのみ)。

Oracle Business Intelligenceのガイドを参照してください。

Nクラスタ1、2、3、4エージェントを使用します。

アクティブ/アクティブまたはアクティブ/パッシブ・モデルを使用します。

EPMのガイドを参照してください。

可用性

Fusion Middleware Controlを使用します

アクティブ/パッシブ・モデルを使用します。

Oracle Business Intelligenceのガイドを参照してください。

EPMのガイドを参照してください。

アクティブ/パッシブ・モデルを使用します。

財務レポート

財務レポート、計算マネージャおよびワークスペースは12cのデプロイメントの一部ではありません。

EPMのガイドを参照してください。

計算マネージャ

財務レポート、計算マネージャおよびワークスペースは12cのデプロイメントの一部ではありません。

EPMのガイドを参照してください。

ワークスペース

財務レポート、計算マネージャおよびワークスペースは12cのデプロイメントの一部ではありません。

EPMのガイドを参照してください。

API

12.2.1のカスタムAPI作業は必要はありません。

該当なし

Oracle Business IntelligenceでのEssbaseのインストール

Oracle Business Intelligenceのインストール時に、Essbaseをインストールできます。

EssbaseをOracle Business Intelligenceでインストールすると、Oracle Business IntelligenceユーザーがEssbaseデータベースを使用できるようになり、Oracle Business IntelligenceのツールとEssbase EPMシステムのツールを組み合せて使用してEssbaseコンポーネントを管理できます。どのバージョンのEssbaseがインストールされるかの詳細は、次の場所でOracleサポートの「動作保証」ページにアクセスし、Oracle Essbaseが同梱されているOracle Business Intelligence Enterprise Editionの該当リリースに関する製品詳細を確認してください。

https://support.oracle.com

注意:

Essbaseを既存のOracle Business Intelligenceのインストールに追加することはできませんが、Essbaseをデータソースとして使用することはできます。Oracle Business IntelligenceでEssbaseをインストールする唯一の方法は、新しいOracle Business Intelligenceのインストールを実行して、Essbaseコンポーネントを選択することです。

EASおよびStudioはEPMのインストールを使用してインストールします。詳細は、EPMガイドを参照してください。

この節の内容は以下のとおりです。

- Essbaseのインストール

- インストール時のEssbaseスイート・オプションの選択

- EssbaseがOracle Business Intelligenceでインストールされた場合のクライアント・ツールの使用制限

- EssbaseがOracle Business Intelligenceでインストールされた場合にサポートされないEssbaseの機能

Essbaseのインストール

Oracle Business Intelligence Enterpriseインストールの一部としてEssbase Suiteをインストールします。

『Oracle Business Intelligenceのインストールと構成』を参照してください。

エンタープライズ・インストール・タイプでは、管理サーバーと管理対象サーバーが各1つのクラスタを1つ含む、単一のWebLogic Serverドメインを作成および構成します。インストール時にEssbaseスイートを選択すると、Essbase JEEコンポーネントおよびOracle Business Intelligence JEEコンポーネントが管理対象サーバーにインストールされます。「インストール時のEssbaseスイート・オプションの選択」を参照してください。

インストール時のEssbaseスイート・オプションの選択

インストール時に、JEEのアプリケーションおよびサービスをインストールできます。

インストール時にEssbaseスイート・オプションを選択すると、次のようになります。

- 「Oracle Business Intelligence Enterprise Edition」オプションを事前に選択します。

- 次のEssbase関連のJEEアプリケーションおよびサービスが、エンタープライズ・インストールではローカルOracle BI EE管理対象サーバーにインストールされます。

- Essbaseエージェント

- キューブ・デプロイメント・サービス

- Hyperion Provider Services (APS)

- 次のEssbaseサーバー・プロセスがインストールされます。

- Essbaseアプリケーション

- 次のEssbase関連クライアント・アプリケーションを「BIデスクトップ・ツールのダウンロード」オプションでダウンロードできます。このオプションは、Oracle BI EEのホームページの「はじめに」領域で使用できます。

- Smart View for Office (EPMアプリケーション)

『Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のBIデスクトップ・ツールのダウンロードに関する項を参照してください。

- ユーザーが、次のEssbaseコマンドライン・ツールにログインできます。

- ESSCMD

- ESSMSH (MaxL)

- ユーザーは次のサポート対象Essbase API言語を使用してログインできます。

- JAPI

- C-API

注意:
この項に含まれていないクライアント・アプリケーションおよびAPI言語は、Oracle Business IntelligenceでインストールされたEssbaseおよび関連コンポーネントではサポートされていません。

EssbaseがOracle Business Intelligenceでインストールされた場合のクライアント・ツールの使用制限

EssbaseをOracle Business Intelligenceでインストールした場合、次のEssbaseツールの使用に制限があります。

- MaxLコマンドライン・インタフェース
MaxLコマンドラインは、Oracle Business Intelligence Essbaseのほとんどのタスクをサポートしますが、これらのタスクはOracle EPM System Essbaseでも実行できます。

注意:
MaxLコマンドラインを使用してセキュリティをプロビジョニングすることはできません。

EssbaseがOracle Business Intelligenceでインストールされた場合にサポートされないEssbaseの機能

EssbaseをOracle Business Intelligenceでインストールすると、Enterprise Performance Managementが完全にはインストールされません。

次のEssbaseの機能はサポートされていません。

- 権限の付与が、データベース・レベルでサポートされません。たとえば、1つのアプリケーションで2つの多次元データベースを使用する場合、権限の付与は、アプリケーションで2つの多次元データベースに等しく適用されます。

- 複数クラスタがサポートされません。

- アクティブ/アクティブ・フェイルオーバー・プロセスがサポートされません。一度にアクティブにできるマシンまたはクラスタは1つのみなので、コンピュータまたはクラスタ間でのロード・バランシングができません。

- EssbaseをEnterprise Performance Management Systemの一部としてインストールすると、Essbaseでどのユーザー、グループおよびアプリケーション・ロールが何を実行できるかが監査レポートに表示されますが、そのレポートをこのリリースでは使用できません。ただし、Oracle Fusion Middlewareを使用して、アプリケーション・ロールに割り当てられているEssbase権限を表示できます。

- EssbaseをOracle Business Intelligenceでインストールすると、サポートされないEnterprise Performance Managementの機能が他にもある可能性があります。誤解を防ぐため、(EssbaseをOracle Business Intelligenceでインストールした場合は)このドキュメントで指示されていないかぎり、EPMシステムまたはEssbaseのドキュメントを使用しないでください。

Oracle Business IntelligenceでのEssbaseのセキュリティの構成

この項では、EssbaseをOracle Business Intelligenceでインストールした場合の、Essbase関連の一般的なセキュリティ構成について説明します。Oracle Business Intelligenceの既存のインストールでEssbaseのセキュリティをメンテナンスする場合にも、この項を参照できます。

Oracle Business Intelligenceインストーラでは、Oracle Fusion Middlewareのセキュリティを使用して認証および認可するようにEssbaseを構成します。Essbase環境を保護して、Hyperion Shared Servicesで保護されたEssbaseと同等の機能を提供できます。例外は、Oracle Business Intelligenceの動作保証マトリクスを参照してください。

Oracle Business Intelligenceインストーラを使用してインストールされたEssbaseは、ネイティブEssbaseまたはHyperion Shared Services (HSS)セキュリティを使用できません。しかし、EssbaseをOracle Business Intelligenceでインストールすると、Common Security Service (CSS)トークン・ベースのアイデンティティ・アサーションを引き続き使用でき、Oracle Business Intelligenceを使用して、エンド・ユーザーの資格証明でEssbaseデータソースに(Oracle Business IntelligenceでインストールしたEssbaseにもEPMでインストールしたEssbaseにも)接続できます。このメカニズムをOracle Business Intelligenceのインストールの外部のEssbaseデータソースで使用するには、ドキュメントの指示に従う必要があります。また、Oracle Business IntelligenceでEssbaseの複数のデータソースを使用し、このメカニズムを使用する必要がある場合は、すべてのEssbaseデータソースで同じ共有シークレットを使用してCSSトークンを作成する必要があります。「Oracle Business IntelligenceでEssbase、Hyperion Financial Management、Hyperion PlanningおよびEPM Workspaceとの通信時にHyperion SSOトークンを使用する構成」を参照してください。

Oracle Business Intelligenceインストーラでは、Essbaseのコア・ユーザー、グループ、アプリケーション・ロール、資格証明および権限を事前構成します。EPMシステム・インストーラでインストールされたEssbaseからOracle Business IntelligenceでインストールされたEssbaseへのセキュリティ・アーティファクトの自動移行はありません。Oracle Business IntelligenceでEssbaseをインストールした場合は、Essbaseで同等の認証および認可のメカニズムを構成する必要があります。

トピック

- Essbaseと関連ツールでのユーザーによる特定の操作の実行の有効化

- Oracle BI EE 12.2.1.xでのドリルスルー・レポートの有効化

- Essbaseフィルタを使用したデータレベル・セキュリティの構成

- Essbase計算へのアクセスの構成

- Oracle Business IntelligenceでのEssbaseのポートの変更

- Essbaseと関連ツールのリソース権限リファレンス

Essbaseと関連ツールでのユーザーによる特定の操作の実行の有効化

アプリケーション・ロールに対するリソース権限の定義を付与することにより、Essbaseと関連ツールで特定の操作をユーザーが実行できるようにします(たとえば、読取りと書込み、計算の使用、フィルタの使用、特定のフィルタの使用など)。

適切なリソース権限を最初に定義する必要があります(「Essbaseフィルタを使用したデータレベル・セキュリティの構成」および「Essbase計算へのアクセスの構成」を参照してください)。リソース権限には、Essbaseアプリケーションでユーザーが実行できるEssbaseアクションの定義が含まれます。Essbaseアクションは、Essbaseリソース・タイプから派生しており、リソース権限にリンクしています。

リソースは階層化されているので、グローバル、クラスタおよびアプリケーション・レベルのリソースがリストされます。

注意:

ここで説明するEssbaseアクションは、Oracle Business Intelligenceのアクションと同じではありません。

インストール・プロセスでは、Oracle Business Intelligenceの既存のアプリケーション・ロールにデフォルトのEssbaseリソース権限を付与します。

Oracle Business IntelligenceでEssbaseをインストールする際にデフォルトで構成される、デフォルトのEssbaseリソース権限の詳細は、「Essbaseと関連ツールのリソース権限リファレンス」を参照してください。

注意:

BIConsumerアプリケーション・ロールはすべてのユーザーに付与され、oracle.essbase.server /EssbaseCluster-1アクセスおよびoracle.essbase.application /EssbaseCluster-1 user_filterを持ちます。これにより、すべてのユーザーがデフォルトでEssbaseにアクセスできます。

注意:

リソース権限はデフォルトで、ファイルベースの共有ポリシー・ストアに格納されますが、OID LDAP共有ポリシー・ストアに再度関連付けることができます。『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』の代替認証プロバイダの使用に関する項を参照してください。

注意:

親ロールは、子グループまたはロール・メンバーから権限の付与を継承します。権限の付与は累積し、たとえば、oracle.essbase (フィルタ)をアプリケーション・ロールを通じて付与されているが、別のロールを通じては付与されていないユーザーは、それでもoracle.essbase (フィルタ)ロールを持っていると見なされます。

リソース権限をユーザーおよびアプリケーション・ロールに付与するには、次の手順を実行します。

1. リソース権限の定義をEssbaseフィルタまたはEssbase計算に付与する場合は、そのフィルタまたは計算がすでに存在する必要があります。
存在しない場合は、次のリンクのいずれかを参照してください。

- Essbaseフィルタのリソース権限定義の構成

- Essbase計算のリソース権限定義の構成

2. Oracle Fusion Middlewareにログインします。
「Oracle Business Intelligenceを管理するためのFusion Middleware Controlへのログイン」を参照してください。

3. 「Business Intelligence」,を選択し、「coreapplication」を選択します。

4. 「Business Intelligenceインスタンス」メニューで(または「coreapplication」を右クリックして)、「セキュリティ」と「アプリケーション・ポリシー」を選択します。

5. obiアプリケーション・ストライプを選択します。

6. 「プリンシパル・タイプ」を選択し、「検索」をクリックして、アプリケーション・ロールのリストを表示します。

ベスト・プラクティスは、アプリケーション・ロールに権限を割り当てることです。

この検索では、ポリシーまたは権限がすでに割り当てられているプリンシパルのみが返されます。新規アプリケーション・ロールがあり、まだ権限を割り当てていない場合は、「作成」または「類似作成」をクリックする必要があります。

注意:

選択されたプリンシパルに、Essbase以外の権限も表示される場合があります。

7. 「作成 」をクリックして、「アプリケーション権限の作成」ページを表示します。

8. 「権限受領者」セクションで「追加」をクリックして、アプリケーション・ロールを追加します。

9. 「タイプ」リストから「アプリケーション・ロール」を選択し、検索の矢印をクリックします。

10. 「OK」をクリックします。

11. 「権限」セクションで「追加」をクリックして、「権限の追加」ページを表示します。

12. 「リソース・タイプ」をクリックして、リストから適切なリソース・タイプを選択します。
たとえば、oracle.essbase.applicationを選択します。

13. 検索の矢印ボタンをクリックして、選択内容を確認します。

注意:

EASで作成したフィルタまたはアプリケーションと、ポリシー・ストアで返されたリストの間では、同期は行われていません。したがって、特定のリソース(サーバー、アプリケーション、フィルタまたは計算)を最初にプロビジョニングする際に、次の手順で「リソース名」を手動で入力する必要があります。

14. 「続行」をクリックして、「権限の追加」ページを表示します。

15. 「リソース名」および「リソース・タイプ」フィールドに適切な情報を入力します。

たとえば、アクセス権限を構成して、デモ・アプリケーション内の任意のフィルタを使用するには、次の情報を入力します。

リソース・タイプ: oracle.essbase.application

リソース名: /EssbaseCluster-1/Demo

権限アクション: use_filter

リソース権限をフィルタまたは計算に付与する際、「リソース・タイプ」、「リソース名」および「権限アクション」フィールドに入力する内容の例は、次を参照してください。

- Essbaseフィルタのリソース権限定義の構成

- Essbase計算のリソース権限定義の構成

注意:

リソースの権限アクションも、「権限アクション」フィールドに手動で入力できます。Essbaseアクションは階層化されており、リストの上位にあるアクションには、下位メンバーが含まれます。たとえば、readを選択すると、readおよびrestart権限が/EssbaseCluster-1/Demo Essbaseアプリケーションに付与されます。

16. 「選択」をクリックします。

17. 「OK」をクリックします。

Oracle BI EE 12.2.1.xでのドリルスルー・レポートの有効化

Essbaseリリース12.2.1.xではEssbase Studioは提供されません。Essbase 12.2.1.xでEssbase Studioを使用し、Essbaseキューブをデプロイしてドリルスルー機能を有効にするには、別のホストにEPM 11gをインストールしていくつかの構成ステップを完了する必要があります。

Essbase 12.2.1.xでEssbase Studio 11gを実行するには、次の手順を実行します。

1. EPM 11.1.2.4をインストールし、最新のOpatchを適用します。

2. BI 12.2.1を別のホストにインストールします。

3. Essbase Studioのサーバー・プロパティ・ファイルをserver.trustedAuthenticationHost=<HOSTNAME>:<PORT>で更新します。ここで、HOSTNAMEはEssbaseが実行されているホストであり、PORTはEssbaseのポートです。

注意:
server.propertiesファイルは、EPM 11.1.2.4環境のORACLE_INSTANCE/EssbaseStudio/essbasestudio1/binにあります。

4. Essbase Studioサーバーを停止して再起動します。

5. BIインスタンスを停止します。

6. 11.1.2.4 EPMからcpld.jarをコピーします。
${EPM_ORACLE_HOME}/common/essbase-studio-sdk/11.1.2.0/lib
BI12cに配置します。

${MIDDLEWARE_HOME}/user_projects/domains/${DOMAIN_NAME}/lib

7. Oracle Business Intelligenceを起動します。

注意:
複数のBI Essbaseインスタンスにドリススルー・レポートをデプロイしてアクセスすることはできません。複数のEssbaseインスタンスはサポートされません。

Essbase フィルタを使用したデータレベル・セキュリティの構成

データレベル・セキュリティを使用すると、Essbase多次元データベースでユーザーに表示されるディメンション・データを制限できます。Essbaseフィルタのリソース権限定義を構成し、それをアプリケーション・ロールに付与することで、Oracle Business Intelligenceユーザーのデータレベル・アクセスを保護します。

「Essbaseと関連ツールでのユーザーによる特定の操作の実行の有効化」を参照してください。

トピック

- Essbaseフィルタとは

- Essbaseフィルタのリソース権限定義の構成

- Essbaseフィルタでのデータ・アクセスの保護

- フィルタ・アクセス権限の付与の変更が使用済になる時点

- Oracle Business IntelligenceとEPMでのフィルタ権限の付与の相違点

Essbaseフィルタとは

Essbaseフィルタとは、Essbaseのリソースで、ディメンション・データのアクセス制御メカニズムを提供します。たとえば、フィルタがユーザーによるデータの表示または更新を、特定の地域または特定の製品のみに制限している場合があります。

Essbaseフィルタはリレーショナル・データベースに格納されています。

権限

説明

アクセスなし、またはなし

アクセス権がグローバルに付与されていないかぎり、データ値への固有のアクセス権はなし

読取り

データ値の読取りが可能

書込み

データ値の読取りおよび更新が可能

メタ読取り

メタデータの読取りが可能(ディメンションおよびメンバー名)

Essbaseフィルタは、Essbase Administration Services (およびMaxLコマンドライン)を使用して作成します。これにより、次のことも可能になります。

- ディメンションおよびそのメンバーの表示

- フィルタ操作のリスト表示

- デザインタイムでのフィルタの検証

Oracle Essbase Administration Servicesオンライン・ヘルプおよび『Oracle Essbaseデータベース管理者ガイド』を参照してください。

Oracle Essbaseのドキュメント

Enterprise Performance ManagementドキュメントのHyperion Shared Services (HSS)に関する記述は無視してかまいません。

Essbaseフィルタのリソース権限定義の構成

リソース権限定義はポリシー・ストアのEssbaseフィルタと結合して、アプリケーション・ロールに付与されます。これにより、アプリケーション・ロールに関連づけられたユーザーは、Essbaseフィルタのリソース権限定義を1つ以上結合して定義されたデータを保護できます。

Essbaseフィルタのリソース権限定義をアプリケーション・ロールに付与する前に(「Essbaseと関連ツールでのユーザーによる特定の操作の実行の有効化」を参照)、まず、適切なリソース権限定義がポリシー・ストアに存在している必要があります。この項の例を使用して、ユーザーがEssbaseフィルタを使用できるようにするためのリソース権限定義の構成方法を理解します。

アプリケーション・ロールには、特定のフィルタにアクセスするための少なくとも2つのポリシー・ストア権限付与が必要です。特定のスコープ内のフィルタを使用するアプリケーション・ロールの権限を付与する必要があります。

「Essbaseと関連ツールのリソース権限リファレンス」を参照してください。

次の例を使用して、Essbaseフィルタのリソース権限定義の構成方法を理解します。

例1 - デモ・アプリケーション内でのフィルタの使用を有効化するリソース権限の構成:

この例では、リソース権限定義を構成して、デモ・アプリケーション内でのフィルタの使用を有効にします。この例では、次のリソース権限定義のいずれかがポリシー・ストアに必ず存在する必要があります。例:

- oracle.essbase.application, /EssbaseCluster-1, use_filter
ここで:

- oracle.essbase.application, - リソース・タイプ(この場合はアプリケーション)

- /EssbaseCluster-1, - クラスタ名

- use_filter - アクション権限(この場合、フィルタの使用を有効化します)

この例では、use_filterアクション権限でoracle.essbase.applicationリソース・タイプを構成して、ポリシー・ストアでこの定義と関連づけられているユーザーが、EssbaseCluster-1内の任意のアプリケーション(デモ・アプリケーションを含む)でフィルタを使用できます。

または

- oracle.essbase.application, /EssbaseCluster-1/Demo, use_filter
この例では、use_filterアクション権限でoracle.essbase.applicationリソース・タイプを構成して、ポリシー・ストアでこの定義と関連づけられているユーザーが、EssbaseCluster-1内のデモ・アプリケーションでフィルタを使用できます。

例2 - 特定のフィルタのリソース権限の構成:

この例では、リソース権限定義を構成して、特定のフィルタの使用を有効にします。最初の権限付与の範囲でフィルタに名前を付けるリソース権限定義をさらに指定する必要があります。

たとえば、Basicというデータベースでユーザーのディメンション・アクセスを、read_filterというフィルタで定義されたメンバーに制限するには、次のリソース権限定義が必要です。

- oracle.essbase.application, /EssbaseCluster-1, use_filter
または

- oracle.essbase.application, ./EssbaseCluster-1/Demo, use_filter
および

- oracle.essbase.filter, /EssbaseCluster-1/Demo/Basic/read_filter, apply
この例では、read_filterアクション権限でoracle.essbase.applicationリソース・タイプを構成して、ポリシー・ストアでこの定義と関連づけられているユーザーの、EssbaseCluster-1内のデモ・アプリケーションでのBasicデータベースのフィルタの読込みを制限します。

例3 - 複数のフィルタのリソース権限の構成:

この例では、複数のフィルタで複数のリソース権限定義を有効化して、データベースBasicでのユーザーのディメンション・アクセスを、フィルタ「read_filter」または「readFeb_filter」のいずれかで定義されたメンバーに制限します。次のリソース権限定義が必要です。

注意:

これは、ユーザーとグループが単一のアクティブ・フィルタに制限されるEPMのインストールとは異なります。

- oracle.essbase.application, /EssbaseCluster-1, use_filter
または

- oracle.essbase.application, ./EssbaseCluster-1/Demo, use_filter
および

- oracle.essbase.filter, /EssbaseCluster-1/Demo/Basic/read_filter, apply
および

- oracle.essbase.filter, /EssbaseCluster-1/Demo/Basic/readFeb_filter apply

例4 - データベース・レベルでデータ・アクセスを拡張または制限するフィルタのリソース権限の構成:

この例ではアクティブ・フィルタを使用して、データベース・レベルでデータ・アクセスを拡張または制限します。

たとえば、次のリソース権限定義に関連づけられたユーザーは、noAccess1がすべてのディメンションへのアクセスを制限するDemoからの読込みができません。

- oracle.essbase.application, /EssbaseCluster-1/Demo, read

- oracle.essbase.filter,/EssbaseCluster-1/Demo/Basic/noAccess1, apply

Essbaseフィルタでのデータ・アクセスの保護

Essbaseフィルタをアプリケーション・ロールに付与して、データ・アクセスを保護します。Essbaseフィルタのリソース権限定義は、データベース・レベルで権限受領者のデータ・アクセスを保護します。

1. 特定のフィルタが存在しない場合は、Essbase Administration ServicesコンソールまたはMaxLコマンドラインを使用して作成します。

Oracle Essbase Administration Servicesオンライン・ヘルプおよび『Oracle Essbaseデータベース管理者ガイド』を参照してください。

Oracle Essbaseのドキュメント

2. Oracle Fusion Middlewareを使用して、フィルタのリソース権限定義をアプリケーション・ロールに付与します。

「Essbaseと関連ツールでのユーザーによる特定の操作の実行の有効化」を参照してください。

これは、Oracle WebLogic Scripting Toolを使用してプログラムで実行することもできます『Oracle Platform Security Servicesによるアプリケーションの保護』のOPSSスクリプトを使用したアプリケーション・ポリシーの管理に関する項を参照してください。

注意:

EssbaseをOracle Business Intelligenceでインストールした場合、次のEnterprise Performance Managementの制限は適用されません。

EPMでインストールしたシステムの場合、多次元データベースにつき、ユーザーまたはアプリケーション・ロールごとに、フィルタは1つのみです。ユーザーまたはアプリケーション・ロールが2番目のフィルタに直接プロビジョニングされている場合、1番目は取り消されます。ユーザーが、プロビジョニングされたフィルタをそれぞれ持つ複数のアプリケーションのメンバーである場合、複数のフィルタを間接的にプロビジョニングできます。

フィルタのリソース権限定義は、特定のEssbase多次元データベースに接続する際に決定されます。フィルタのリソース権限定義は、認証中にEssbaseエージェントに渡されます。ユーザーが正常に認証されると、ローカルに格納された.SECファイルで、そのユーザーのフィルタのリストが更新されます。

フィルタ・アクセス権限の付与の変更が使用済になる時点

ユーザーのフィルタ・アクセス権限はログイン時に決定され、Essbaseデータベースが選択されると使用済になります(SetActive)。

認可の変更は既存のセッションでは通知されないので、ユーザーは再度ログインして、認可ポリシーの変更を使用済にする必要があります。

Oracle Business IntelligenceとEPMでのフィルタ権限の付与の相違点

EssbaseをOracle Business Intelligenceでインストールした場合は、EssbaseをEPMシステムの一部としてインストールした場合と比べて異なるフィルタ・リソース権限を付与します。

フィルタ・リソース権限を付与するときは、次のガイドラインに従います。

- EssbaseをOracle Business Intelligenceでインストールした場合
フィルタのリソース権限定義をアプリケーション・ロールに付与するか、管理者権限をアプリケーション・ロールに割り当てます。

- EssbaseをEPMシステムの一部としてインストールした場合
フィルタのリソース権限をグループに付与するか、管理者権限をグループに割り当てます。

Oracle Business IntelligenceでインストールしたEssbaseは、ユーザーにすべての権限を組み合せて付与します。この権限は、直接またはグループやアプリケーション・ロールを通じて付与されます。EPMシステムとは異なり、Oracle Business Intelligenceを使用する場合は、たとえばoracle.essbase.applicationフィルタ・アクションをフィルタと同じグループを使用して付与する必要があるという制限はありません。Oracle Business Intelligenceでは、競合するロールを使用できます。これらの権限付与の結果については、次の表を参照してください。

アプリケーション・ロール(グループ)

アプリケーション権限

フィルタ権限付与

A

oracle.essbase.application, /EssbaseCluster-1/Demo, use_filter

oracle.essbase.filter, /EssbaseCluster-1/Demo/Basic/read_filter, apply

B

oracle.essbase.application, /EssbaseCluster-1/Demo, use_filter

oracle.essbase.filter, /EssbaseCluster-1/Demo/Basic/readFeb_filter, apply

この表で、ユーザーJDoeはグループAおよびBのメンバーであり、Basicの問合せの際、JDoeはread_filterおよびreadFeb_filterで定義される行にアクセスできます。グループAに、EPMシステムのインストールで削除されたアプリケーション権限がある場合、グループAのユーザーはその後、どのフィルタにもアクセスできなくなります。ただし、EssbaseをOracle Business Intelligenceでインストールすると、ユーザーJDoeは、両方のフィルタの行に引き続きアクセスできます。JDoeはグループBのメンバーシップからも権限を継承するためです。

Essbase計算へのアクセスの構成

Essbase計算を使用すると、Essbase多次元データベースのデータに数式を適用できます。Essbase計算のリソース権限定義を構成し、アプリケーション・ロールに付与することで、ユーザーがEssbase計算にアクセスできます。

「Essbaseと関連ツールでのユーザーによる特定の操作の実行の有効化」を参照してください。

トピック

- Essbase計算とは

- Essbase計算のリソース権限定義の構成

- Essbase計算へのユーザーのアクセスの有効化

Essbase計算とは

Essbase計算を使用すると、ユーザーはディメンション・メンバーに複雑な式を定義および適用できます。計算に名前を付け、アプリケーションまたはデータベース・レベルでファイルに保存できます。これを計算スクリプトと呼びます。計算は、対話的に作成し、実行することもできます。これをインライン計算と呼びます。最後に、各データベースにはデフォルトの計算がアウトラインで定義されています。

計算スクリプトはローカル・ファイル・システムに格納され、その定義は複雑な場合があり、ツールのサポートが必要となります。たとえば、Essbase Administration Services (EAS)とCalculation Managerを使用して、次のことができます。

- ディメンションおよびそのメンバーの表示

- 計算の定義にはMaxLも使用できます。

計算の定義にはMaxLも使用できます。

Essbase計算のリソース権限定義の構成

Essbaseの計算を使用するためにアプリケーション・ロール権限を付与する前に、適切なリソース権限定義がポリシー・ストアに存在している必要があります。

「Essbaseと関連ツールでのユーザーによる特定の操作の実行の有効化」を参照してください。

この項の例を使用して、ユーザーがEssbase計算を使用できるようにするためのリソース権限定義の構成方法を理解します。

「Essbaseと関連ツールのリソース権限リファレンス」を参照してください。

例1 - リソース権限定義を構成して、/cluster/App1のデフォルトおよびインラインの計算を使用するには:

この例では、リソース権限定義を構成して、/EssbaseCluster-1/App1のデフォルトおよびインラインの計算を使用します。次のリソース権限定義がポリシー・ストアに存在する必要があります。例:

- oracle.essbase.application, /EssbaseCluster-1, use_calculation
この例では、アプリケーションのリソース権限でクラスタ内のすべてのアプリケーションにuse_calculation権限を付与します。

または

- oracle.essbase.application, /EssbaseCluster-1/App1, use_calculation
この例では、アプリケーションのリソース権限でApp1のアプリケーションにuse_calculation権限を付与します。

例2 - リソース権限定義を構成して、/cluster/App1のすべての計算を使用するには:

この例では、リソース権限定義を構成して、/EssbaseCluster-1/App1のすべての計算スクリプトを使用します。次の権限がポリシー・ストアに必ず存在する必要があります。例:

- oracle.essbase.application, /EssbaseCluster-1, use_calculation
または

oracle.essbase.application, /EssbaseCluster-1/App1, use_calculation

および

- oracle.essbase.calculation, /EssbaseCluster-1/App1, all
この計算の権限は、App1のすべての計算スクリプトに、アクセス権限を付与します。

例3 - リソース権限定義を構成して、クラスタ内のすべての計算を使用するには:

この例では、リソース権限定義を構成して、クラスタ内のすべての計算を使用します。次の権限の両方がポリシー・ストアに必ず存在する必要があります。例:

- oracle.essbase.application, /EssbaseCluster-1, use_calculation

- oracle.essbase.calculation, /EssbaseCluster-1, all

例4 - リソース権限定義を構成して、計算スクリプトforcastQ1およびforcastQ2を使用するには:

この例では、リソース権限定義を構成して、クラスタ内の特定の計算スクリプト(たとえば、forcastQ1およびforcastQ2)を使用します。次の権限がポリシー・ストアに必ず存在する必要があります。例:

- oracle.essbase.application, /EssbaseCluster-1, use_calculation
または

oracle.essbase.application, /EssbaseCluster-1/App1, use_calculation

- oracle.essbase.calculation, /EssbaseCluster-1/App1/Db1/forcastQ1, execute
および

- oracle.essbase.calculation, /EssbaseCluster-1/App1/Db1/forcastQ2, execute

注意:

特定の計算スクリプトに権限付与すると、すべての計算へのクラスタまたはアプリケーション・レベルのアクセスが取り消されます。計算スクリプトへの特定の権限付与は、制限と見なされます。

例:

次の権限を付与されたユーザーは、計算スクリプトforcastQ1のみにアクセスできます。

- oracle.essbase.application, /EssbaseCluster-1, use_calculation

- oracle.essbase.calculation, /EssbaseCluster-1, all

- oracle.essbase.calculation, /EssbaseCluster-1/App1/Db1/forcastQ1, execute

注意:

oracle.essbase.calculationの権限付与は、oracle.essbase.application calculateのアクセスを示すものではありません。例:

oracle.essbase.applicationの計算の権限付与がない場合、ユーザーには、次のいずれかの権限付与を含む計算、アウトライン、インラインまたはスクリプトへのアクセス権がありません。

- oracle.essbase.calculation, /EssbaseCluster-1/App1, all

- oracle.essbase.calculation, /EssbaseCluster-1, all

- oracle.essbase.calculation, /EssbaseCluster-1/App1/Db1/forcastQ1, execute

Essbase計算へのユーザーのアクセスの有効化

1つ以上のEssbase計算のアクセス権限を、ユーザーに関連づけられたアプリケーション・ロールに付与することにより、そのユーザーがEssbase計算にアクセスできるようにします。

デフォルトでは、計算の権限を持つユーザーは、すべてのデータベースでデフォルトおよびインラインの計算を実行できます。

1. 計算スクリプトが存在しない場合は、Essbase Administration ServicesコンソールまたはMaxLコマンドラインを使用して作成し、アクティブにします。

『Oracle Essbaseデータベース管理者ガイド』およびOracle Essbase Administration Servicesオンライン・ヘルプを参照してください。

Oracle Essabaseのドキュメント

2. Essbase計算のアクセス権限を、Fusion Middleware Controlを使用してアプリケーション・ロールに付与します。
「Essbaseと関連ツールでのユーザーによる特定の操作の実行の有効化」を参照してください。

Oracle Business IntelligenceでのEssbaseのポートの変更

Essbaseエージェントは、2つのタイプのポートで実行されます。エージェントはBI管理対象WebLogicサーバーで実行されるため、リスニングするHTTPポートを持ちます。

このポートはBI管理対象サーバーでホストされるすべてのアプリケーションに共通であるため、この項はEssbase固有のポートの変更を含みます。

デフォルトでは、Essbaseエージェントは9799ポートで実行するよう常に設計されています。このポートを変更するには、biee-domain.xmlで"Essbase" port=""設定を編集します。

Essbaseサーバーはポート範囲を使用し、デフォルトでは使用可能なポートを使用します。サーバー・ポート範囲を明示的に指定するには、essbase.cfgのSERVERPORTBEGINおよびSERVERPORTEND設定を定義します。

Essbaseエージェントのポート番号またはEssbaseサーバーのポート範囲を更新するには、次の手順を実行します。

1. Essbaseエージェントのポート番号を更新します。

a. 次の場所にあるbiee-domain.xmlを開いて編集します。
BI_DOMAIN/config/fmwconfig

b. "Essbase" port=""設定を見つけて更新します。

例:

<BIComponent id="essbaseserver1" componentType="Essbase" port="9798" clusterStyle="SELF_MANAGED"/>

c. biee-domail.xmlファイルを保存します。

d. Essbaseサーバーを再起動します。

2. Essbaseサーバーのポート範囲を更新します。

a. 次の場所にあるessbase.cfgファイルを開いて編集します。
DOMAIN_HOME/config/fmwconfig/biconfig/essbase

b. 環境に応じてSERVERPORTBEGINおよびSERVERPORTENDエントリを追加します。

例:

SERVERPORTBEGIN 9000

SERVERPORTEND 9499

c. essbase.cfgファイルを保存します。

d. BI管理対象サーバーを再起動します。

注意:

スケールアウト後にこの手順を実行している場合、他のすべてのノードの対応するessbase.cfgを編集してプライマリと同じエントリを使用し、BIクラスタ(bi_clusterのすべての管理対象サーバー)を再起動してください。

Essbaseのリソース権限リファレンス

この項では、EssbaseをOracle Business Intelligenceでインストールしたときにデフォルトで構成されるEssbaseのリソース権限についてのリファレンス情報を示します。

Essbase関連機能にアクセスするには、ユーザー(またはグループや、そのユーザーが所属するアプリケーション・ロール)は1つ以上のリソース権限を付与されている必要があります。Essbase関連のリソース権限は、リソース・タイプ、名前およびアクションで定義され、Oracle Fusion Middlewareのセキュリティ・モデルの一部としてポリシー・ストアに格納されます。『Oracle Platform Security Servicesによるアプリケーションの保護』の「ポリシー・ストアの管理」を参照してください。

- リソース・タイプ
権限の名前付きグループが含まれます。

- リソース名
権限を適用する範囲を指定します。

- アクション
権限により、権限受領者が実行できる操作を定義します。

Essbase関連のリソース権限は、Oracle Fusion Middleware Controlを使用して管理します。ただし、JMXまたはOracle WebLogic Scripting Toolを使用して、Oracle Platform Security ServicesのAPIも使用できます。

注意:

EssbaseをOracle Business Intelligenceでインストールすると、Hyperion Shared Servicesがユーザーのプロビジョニングで提供する機能は、この章で説明する機能に置き換えられます。

この節の内容は以下のとおりです。

- Essbaseと関連ツールに適用されるリソース・タイプ

- Essbaseと関連ツールに適用されるリソース名

- Essbaseと関連ツールに適用されるアクション

Essbaseに適用されるリソース・タイプ

リソース・タイプは、特定のアクションに関連付けできる権限の名前付きグループです。Essbaseサーバーにはいくつかの認可レベルがあり、それぞれにリソース・タイプがあります。リソース・タイプはFusion Middleware Controlで、新規権限付与の選択の際に、適用可能なEssbase関連のアクションのリストの制限に使用されます。

次の表は、Oracle Business IntelligenceでサポートされるEssbase関連のリソース・タイプの一覧を示しています。

リソース・タイプ

説明

oracle.essbase.server

グローバル、クラスタおよびサーバー・レベルの権限。

oracle.essbase.application

フィルタおよび計算の使用に必要なアプリケーション・レベルの権限。

oracle.essbase.filter

フィルタのアクセス制御。

oracle.essbase.calculation

計算スクリプトのアクセス制御。

Essbaseに適用されるリソース名

各リソース・タイプには、認可可能なリソースおよびアクションのセットがあります。Essbase関連のリソース名は、特定のオブジェクトまたはオブジェクトが含まれるスコープのどちらかです。

oracle.essbase.serverおよびoracle.essbase.applicationのリソース・タイプでは、リソース名はスコープです。これらは階層化されているので、次の表のスコープには、その中に含まれるスコープのセットが含まれます。

次の表は、サポートされるEssbaseスコープの一覧を示しています。

名前

スコープ

/

グローバル、すべてのクラスタ、すべてのアプリケーション、すべてのキューブ。

/cluster

論理クラスタ内のすべてのアプリケーション。

/cluster/application

特定のアプリケーションとそのキューブ。

次の表は、サポートされるoracle.essbase.filterスコープの一覧を示しています。

名前

スコープ

/cluster/application/database/filtername

特定の名前付きフィルタへのアクセス。

次の表は、サポートされるEssbase計算スコープの一覧を示しています。

名前

スコープ

/cluster/

クラスタ・レベルのすべての計算スクリプト。任意のアプリケーション、任意のキューブ。

/cluster/application

アプリケーション・レベルのすべての計算スクリプト。名前付きのアプリケーション内の任意のキューブ。

/cluster/application/database/scriptname

特定の名前付き計算スクリプトへのアクセス。

Essbaseに適用されるアクション

Essbase関連のアクション(権限)は、ユーザーがEssbaseで実行できる操作を表します。

oracle.essbase.serverまたはoracle.essbase.applicationリソース・タイプに付与されるアクションは階層化されているので、リストに示すアクションには、その下に示す権限のセットが含まれます。

たとえば、oracle.essbase.application, /EssbaseCluster-1, readを付与すると、権限受領者は多次元データベースの読取りおよびEssbaseCluster-1でのアプリケーションの再起動を実行できます。

その他のEssbase関連のリソース・タイプのアクションは、階層化されず、個別に権限を付与する必要があります。

次の一連の表では、Essbase関連の各リソース・タイプで使用できるアクションの詳細を示します。

次の表は、サポートされるoracle.essbase.serverアクションの一覧を示しています。

アクション

説明

administer

サーバー、アプリケーションおよびデータベースを管理するための完全なアクセス。

Create

アプリケーションおよびアプリケーション内のデータベースを作成および削除する機能。このユーザーが作成したアプリケーションおよびデータベースの、アプリケーション・マネージャおよびデータベース・マネージャの権限が含まれます。

Access

Essbaseにログインする機能。

これは非推奨ですが、サーバーまたはアプリケーションの権限が1つでも存在すれば、今は十分です。

注意:

アプリケーションを作成するユーザーには、そのアプリケーションを同じセッション内で管理する権限があります。同じユーザーに、以降のセッションで、アプリケーションを管理する明示的な権限を付与する必要があります。

次の表は、サポートされるoracle.essbase.applicationアクションの一覧を示しています。

アクション

説明

manage_application

特定のアプリケーション内のデータベースおよびアプリケーションの設定を作成、削除および変更する機能。アプリケーション内のデータベースのデータベース・マネージャの権限が含まれます。

manage_database

割り当てられたアプリケーション内のデータベース、データベース・アーティファクト、ロックおよびセッションを管理する機能(たとえば、データベース・プロパティまたはキャッシュ設定の変更)。

use_calculation

割り当てられたスコープに基づき、割り当てられた計算およびフィルタがある場合は使用して、データ値の計算、更新および読取りを実行する機能。

write

割り当てられたスコープに基づき、割り当てられたフィルタがある場合は使用して、データ値の更新および読取りを実行する機能。

read

データ値を読み取る機能。

use_filter

フィルタの制限に従って、特定のデータおよびメタデータにアクセスする機能。

restart

アプリケーションまたはデータベースを起動および停止する機能。

次の表は、サポートされるoracle.essbase.filterアクションの一覧を示しています。

アクション

説明

Apply

リソース名で識別されるフィルタを適用します。

次の表は、サポートされるoracle.essbase.calculationアクションの一覧を示しています。

アクション

説明

all

リソース名で参照されるスコープに含まれる計算を、ユーザーが実行できます。

execute

リソース名で識別される計算スクリプトを、ユーザーが実行できます。

次の表は、Oracle Business Intelligenceのアプリケーション・ロールに付与される権限の一覧を示します。

ロール名

リソース権限

ロール・メンバー

BIAdministrator

oracle.essbase.server, /, administrator

BIAdministratorsグループ

BIAuthor

該当なし

BIAuthorsグループ

BIAdministratorアプリケーション・ロール

BIConsumer

oracle.essbase.server,/,access,use_filter

BIConsumersグループ

BIAuthorアプリケーション・ロール

AuthenticatedUser

該当なし

BIConsumer

このアプリケーション・ロールの階層および付与される権限はデフォルトのみで、管理者ユーザーがFusion Middleware Controlで変更できます。

AuthenticatedUserは、デフォルトでBIConsumerのメンバーです。これは、正常に認証されたユーザーにはBIConsumerロール権限が付与されるということを意味します。

Oracle Business IntelligenceでのEssbaseシステム管理

Oracle Business IntelligenceでのEssbaseのシステム管理では、Essbaseエージェントの起動と停止、ログ・ファイルの有効化と表示、ロギング・レベルの設定、ドメイン間でのEssbaseの構成の移行、Essbaseメトリックの監視、およびEssbaseデータのバックアップとリカバリを行います。

この節の内容は以下のとおりです。

- Essbaseコンポーネントの起動と停止

- Oracle Business IntelligenceでのEssbaseコンポーネントの高可用性の維持

- Essbaseコンポーネントのロギングの構成

- ドメイン間でのEssbaseの構成の移行

- Essbaseメトリックの監視

- Essbaseのデータのバックアップとリカバリ

Essbaseコンポーネントの起動と停止

ステータスを監視し、BIプロセス制御コマンド(JAgentの使用)を使用してEssbaseコンポーネントを起動および停止できます。

「Oracle Business Intelligenceプロセスの管理」を参照してください。

Oracle Business IntelligenceでのEssbaseコンポーネントの高可用性の維持

Oracle Business IntelligenceのEssbaseの高可用性は、アクティブ/パッシブ・フォルト・トレランス・モデルを使用して自動的に維持されます。

高可用性のサポートのためのEssbaseのスケールアウト

Essbaseを追加のコンピュータにスケール・アウトして、コンピュータ間の高可用性をサポートします。スケールアウトは、既存のOracle BI EEコンポーネントと同様の方法で実現します(「Oracle Business Intelligenceの可用性の管理(水平方向のスケーリング)」を参照)。

Essbaseのアクティブ/パッシブ・トポロジについて

2ノードのアクティブ/パッシブ・トポロジは、Essbaseサーバーおよびエージェントに加えて、中間層のEssbase Administration Services、Analytic Provider ServicesおよびEssbase Studio Serverのコンポーネントに適用されます。

『高可用性ガイド』のOracle Essbase高可用性の概念に関する項、Oracle Essbaseクラスタリングの構成に関する項およびOracle Hyperion Provider Servicesコンポーネントのアーキテクチャに関する項を参照してください。

Essbaseの容量の管理

Fusion Middleware Controlを使用して、Essbaseのコンポーネントおよびサービス・レベルを監視し、次のことを確認して、Oracle Business Intelligence内のEssbaseの容量を管理します。

- Essbaseコンポーネントが実行中であることを知る方法
「Fusion Middleware ControlのOracle Business Intelligenceページの表示」を参照してください。

- 使用しているシステムがオーバーロードであるかどうかを知る方法
「サービス・レベルの監視」を参照してください。

Essbaseコンポーネントのロギングの構成

BIドメインlogging.xmlファイルのすべてのEssbaseコンポーネントのロギングを構成します。

このファイルの場所は次のとおりです。

DOMAIN_HOME/config/fmwconfig/servers/<BI_MANAGED_SERVER_NAME>

各Essbaseサブコンポーネントのログ構成詳細および対応するOracle Diagnostic Log(ODL)ファイルの場所を次に示します。

- Essbase Java-Agent固有のロギング構成

- Essbaseアプリケーション固有のロギング構成

- Provider Services(APS)固有のロギング構成

- Essbase WebServices固有のロギング構成

- Essbaseキューブ・デプロイメント・サービス固有のロギング構成

注意:

特定のコンポーネントの使用可能な各レベルのロギング情報を取得するには、ロガー・レベル・フィールド値を'TRACE:32'に設定します。

Essbase Java-Agent固有のロギング構成

<log_handler name='jagent-handler-text' class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='${domain.home}/servers/${weblogic.Name}/logs/essbase/jagent.log'/>
<property name='maxFileSize' value='10485760'/>
<property name='maxLogSize' value='104857600'/>
<property name='useSourceClassAndMethod' value='true'/>
</log_handler>
<logger name='oracle.JAGENT' level='NOTIFICATION:1' useParentHandlers='false'>
<handler name='jagent-handler-text'/>
</logger>

Essbaseアプリケーション固有のロギング構成

<log_handler name='serverhandler' class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='${domain.home}/servers/${weblogic.Name}/logs/essbase/essbase'/>
<property name='maxFileSize' value='10485760'/>
<property name='maxLogSize' value='524288000'/>
</log_handler>
<logger name='DefSvrLogger' level='TRACE:1' useParentHandlers='false'>
<handler name='serverhandler'/>
</logger>

Provider Services(APS)固有のロギング構成

<log_handler name='provider-services-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='${domain.home}/servers/${weblogic.Name}/logs/aps/apsserver.log'/>
<property name='maxFileSize' value='10485760'/>
<property name='maxLogSize' value='104857600'/>
</log_handler>
<logger name='oracle.EPMOHPS' level='WARNING' useParentHandlers='false'>
<handler name='provider-services-handler'/>
</logger>

Essbase WebServices固有のロギング構成

<log_handler name='essbase-ws-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='${domain.home}/servers/${weblogic.Name}/logs/essbasews.log'/>
<property name='maxFileSize' value='10485760'/>
<property name='maxLogSize' value='104857600'/>
</log_handler>
<logger name='oracle.EPMOHEWS' level='WARNING:1' useParentHandlers='false'>
<handler name='essbase-ws-handler'/>
</logger>

Essbaseキューブ・デプロイメント・サービス固有のロギング構成

<log_handler name='cds-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='${domain.home}/servers/${weblogic.Name}/logs/cds/cds.log'/>
<property name='maxFileSize' value='10485760'/>
<property name='maxLogSize' value='104857600'/>
</log_handler>
<logger name='oracle.essbase.cds' level='NOTIFICATION:1' useParentHandlers='false'>
<handler name='cds-handler'/>
</logger>

ドメイン間でのEssbaseの構成の移行

Essbase構成は、Oracle Enterprise Performance Management Systemインストール環境のドメイン間で移行できます。

『Oracle Fusion Middlewareの管理』のOracle Hyperion Enterprise Performance Management Systemのターゲット環境への移行に関する項を参照してください。

Essbaseメトリックの監視

Essbaseのメトリックは、Fusion Middleware Controlを使用して監視します。

「サービス・レベルの監視」を参照してください。

Essbaseのデータのバックアップとリカバリ

この項では、Oracle Business IntelligenceでEssbaseをインストールした場合のEssbaseデータのバックアップとリカバリについて説明します。

Essbaseデータのバックアップとリカバリの詳細は、次を参照してください。

- Oracle Business IntelligenceおよびEssbase - Oracle Business Intelligenceインストーラを使用してインストールした場合は、『Oracle Fusion Middlewareの管理』のOracle Essbaseのバックアップおよびリカバリに関する推奨事項に関する項を参照してください。

- EPM System製品 - EPM Systemインストールを使用してインストールした場合は、次の場所で『Oracle Enterprise Performance Management Systemバックアップおよびリカバリ・ガイド』を参照してください。
http://www.oracle.com/technetwork/middleware/performance-management/documentation/index.html

Oracle Business IntelligenceでのEssbaseデータの使用

次のトピックは、Oracle Business IntelligenceでEssbaseを使用するための概要について説明しています。

この項では、Oracle Business IntelligenceでのEssbaseキューブの使用について説明します。

- Essbaseデータソースでのシングル・サインオンの有効化

- Essbaseがデータソースの場合の分析とレポートの作成、スケジューリングおよび実行

- Oracle BI EEによるSSLを介したEssbaseへの接続の有効化

Essbaseデータソースでのシングル・サインオンの有効化

Oracle Business Intelligenceインストーラを使用してインストールされたEssbaseデータソースでSSOを有効化するには、Oracle BIリポジトリのEssbaseデータソースに対応する接続プール・オブジェクトの「一般」タブで「SSO」を選択します。

また、対応するデータベース・オブジェクトの「仮想プライベート・データベース」オプションを選択して、キャッシュ・エントリを保護します。

『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』の「一般」タブの多次元接続プールのプロパティに関する項を参照してください。

次のノート1993210.1も参照してください。

https://support.oracle.com

Essbaseがデータソースの場合の分析とレポートの作成、スケジューリングおよび実行

BI Authorのアプリケーション・ロールを持つユーザーは、Essbaseがデータソースの場合、エンド・ユーザーのアイデンティティを使用してフィルタが適用されている場合、およびSSOが構成されている場合に、分析とレポートを作成、スケジュールおよび実行できます。

詳細は、次を参照してください。

- Oracle Business Intelligenceの分析の作成、スケジューリングおよび実行については、次のものを参照してください。
Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド

- BI Publisherレポートの作成および実行については、次のものを参照してください。
Oracle Business Intelligence Publisher管理者ガイド

Oracle BI EEによるSSLを介したEssbaseへの接続の有効化

この項では、Oracle BIサーバーおよびEssbaseがOracle Business Intelligenceの一部としてインストールおよび構成される場合にOracle BIサーバーがEssbase接続を処理する方法について説明します。

EssbaseがSSLに構成されている場合、BIサーバー(Essbase RTCクライアントを使用)はEssbaseクライアントとしてすべてのクライアント側SSL構成を実行する必要があります。

BIサーバーおよびEssbaseが同じマシンで実行され、EssbaseサーバーがSSLに構成されている場合、BIサーバーはEssbase構成ファイル(essbase.cfg)を指すことができます。これを実行するには、ESSBASE_CONFIG_PATHプロパティをobis.propertiesに追加し、essbase.cfgの場所を指定します。

Oracle BIサーバーでカスタム・クライアント側essbase.cfg(たとえば、特定のEssbaseクライアント設定を制御する場合など)を使用する必要があり、Essbaseサーバー構成ファイルを使用しない場合は、12cバージョンの『Oracle Essbaseデータベース管理者ガイド』のEssbaseクライアント・ウォレットの設定およびウォレット・パスのコピーおよび構成に関する項を参照してください。この場合、obis.propertiesファイルはOracle BIサーバーに定義されているessbase.cfgを含むディレクトリの場所を指す必要があります。

BIサーバーがessbase.cfgの場所を指すには:

1. 次の場所にあるobis.propertiesファイルを開きます。

DOMAIN_HOME/config/fmwconfig/bienv/OBIS/obis.properties

Oracle BI EEに定義されているessbase.cfgの場所またはEssbaseサーバーですでに使用されている場所のパスを表す値を使用して、ESSBASE_CONFIG_PATHプロパティを追加します。

たとえば、Essbaseサーバーの構成ファイルを指すには、次のとおりです。

ESSBASE_CONFIG_PATH=DOMAIN_HOME/config/fmwconfig/biconfig/essbase

2. obis.propertiesファイルを保存します。

注意:

12.2.1.0.0リリースのエンドツーエンドSSL構成はサポートされていません。つまり、Oracle BIサーバーもSSLに構成されている場合、Oracle BIサーバーとEssbaseサーバー間の接続が機能しません。ただし、これは12cの今後のリリースでサポートされます。

Essbaseの詳細情報

Essbaseについて学習できるいくつかの場所があります。

Oracle Enterprise Performance Management SystemのEssbaseの詳細は、次のリンクを参照してください。

- すべてのEssbaseおよびEPMのドキュメントは、次のPerformance Managementのドキュメント・ページを参照してください。
http://www.oracle.com/technetwork/middleware/performance-management/documentation/index.html

このページには、EPM Systemでサポートされるプラットフォームのマトリクス、My Oracle Supportおよびその他の情報リソースへのリンクも記載されています。

ドリルダウンして、リリース固有のドキュメントを表示します。

- システム要件の適合やリリース互換性の詳細は、Oracle Enterprise Performance Management Systemの動作保証マトリクスを参照してください。
http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

- EssbaseをOracle BI Enterprise Editionの一部としてインストールする場合、システム要件およびリリース互換性の詳細は、Oracle Business Intelligence Suite Enterprise Editionのシステム要件およびサポートされるプラットフォームを参照してください。

第IX部 参照情報

プレゼンテーション・サービスを管理するための参照情報があるリソースがいくつかあります。

付録の内容は次のとおりです。

- 構成ファイル設定

- 拡張構成リファレンス

- ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピング

- BI固有のWLSTコマンド・リファレンス

A 構成ファイル設定

この項では、主なOracle Business Intelligenceシステム構成ファイルを示し、NQSConfig.INIファイル・パラメータの詳細を提供します。

この付録の内容は次のとおりです。

- 構成ファイル

- NQSConfig.INIファイルの構成設定

構成ファイル

Oracle Business Intelligence構成ファイルは、システムの動作を制御します。

次の表に、主なOracle Business Intelligence構成ファイルとその場所を示します。

「診断ログ構成ファイルの概要とその位置」を参照してください。

BIコンポーネント

構成ファイル

ファイルの場所

Oracle BIサーバー

NQSConfig.INI

logconfig.xml

例:

BI_DOMAIN/config/fmwconfig/biconfig/OBIS

DBFeatures.iniもこのディレクトリに格納されていますが、このファイルは直接編集しないでください。データベースの機能を編集する方法の詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドを参照してください。

Oracle BIサーバー

instanceconfig.xml

credentialstore.xml

marketingwebexpressions.xml

userpref_currencies.xml

例:

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

記載されているデフォルト値をオーバーライドする場合を除いて、instanceconfig.xmlファイルに要素を追加しないでください。所属組織のニーズに合せるためにシステムを構成する際に必要な設定のみをオーバーライドします。

クラスタ・コントローラ

bi_cluster_config.xml

ccslogconfig.xml

例:

BI_DOMAIN/config/fmwconfig/biconfig/OBICCS

Oracle BIスケジューラ

instanceconfig.xml

schedulerconfig.xml

例:

BI_DOMAIN/config/fmwconfig/biconfig/OBISCH

JavaHost

config.xml

logging_config.xml

例:

BI_DOMAIN/config/fmwconfig/biconfig/OBIJH

Oracle BIプレゼンテーション・サービス・プラグイン

bridgeconfig.properties

例:

BI_DOMAIN/config/fmwconfig/biconfig

Oracle BI Environment

bi-environment.xml

odbc.ini

obis.properties

例:

BI_DOMAIN/config/fmwconfig/bienv/core

bi-environment.xmlには、次のようなBI固有の環境構成設定が含まれます(プロセス・コマンド固有のパラメータと分割)。

- データ・ディレクトリ(SDD) - シングルトン・ディレクトリのパス(高可用性の目的のため)。デフォルトはSDD = $DOMAIN_HOME/bidataです。
11gと同様、SDDがスケールアウトしたシステムのすべてのマシンに対して同じポイントにマウントされていることが必要です。混合モード(一部のコンポーネントがSDDを使用し、一部が使用しない)は許可されていません。

「Oracle Business Intelligenceの主なディレクトリ」を参照してください。

- 11gランタイム互換性フラグ。

- ハードウェア・アクセラレーション・フラグ。

- ポート範囲。

- SSL外部/内部認証局(CA)および証明書パス。内部証明書DNは検証されませんが(このため、ホスト名は表示されません)、クローニング操作中にこれらの変更が必要になる場合があります。

odbc.iniには、ODBC接続エンドポイントの真の単一ソースが含まれます。

- エンドポイントが内部(たとえば、BIEEクラスタ・コントローラまたはEssbase)で、ドライバ(またはドライバのクライアント)がエンドポイントAPIを使用して適切なエンドポイントをリカバリする必要があります。

- エンドポイントがシステムの外部で、ドメインをコピーまたは移動するとこのファイルが変更される場合があります。

- OPSSおよびBIPLATFORM DSNがodbc.iniに提供されます。BIPLATFORM DSNの資格証明はOPSS資格証明ストア内にあります。

obis.propertiesは、指定された値で置き換えられるBIサーバー固有の環境および構成設定が含まれ、次の場所にあります。

BI_DOMAIN/config/fmwconfig/bienv/OBIS

『Oracle Business Intelligenceのインストールと構成』を参照してください。

NQSConfig.INIファイルの構成設定

この項では、Oracle Business IntelligenceのNQSConfig.INIファイルのパラメータのリスト、および各パラメータの簡潔な説明と必須構文を示します。Oracle BIサーバー・ソフトウェアでは、起動時にパラメータを設定するために、NQSConfig.INIと呼ばれる初期化ファイルが使用されます。この初期化ファイルには、個別のインストールの要件に基づいて動作をカスタマイズするためのパラメータが含まれています。通常、パラメータは構成ファイルに出現する順序でリストされます。

注意:

この項の例では、NQSConfig.INIのWindowsバージョンを編集していると想定しています。このファイルをUNIXシステムで編集している場合は、UNIXの適切なファイルシステム・パスと変換を使用してください。

このトピックには、次の項があります。

- NQSConfig.INIファイルのパラメータについて

- Repositoryセクションのパラメータ

- Multitenancyセクションのパラメータ

- Query Result Cacheセクションのパラメータ

- Generalセクションのパラメータ

- Securityセクションのパラメータ

- Serverセクションのパラメータ

- 高可用性パラメータ

- Dynamic Libraryセクションのパラメータ

- Usage Trackingセクションのパラメータ

- Query Optimization Flagsセクションのパラメータ

- MDX Member Name Cacheセクションのパラメータ

- Aggregate Persistenceセクションのパラメータ

- JavaHostセクションのパラメータ

- Datamart Automationセクションのパラメータ

NQSConfig.INIファイルのパラメータについて

Oracle BIサーバーには、1つのNQSConfig.INIファイルがあります。

NQSConfig.INIファイルのエントリに関する次のルールとガイドラインに留意してください。

- Oracle BIサーバーは、起動時に毎回NQSConfig.INIファイルを読み取ります。

- NQSConfig.INI内の各パラメータ・エントリは、パラメータが属するセクション(Repository、Cache、Generalなど)内に記述する必要があります。

- 各エントリはセミコロン( ; )で終わる必要があります。

- コメントは、NQSConfig.INIファイル内の任煮の場所に追加できます。コメントは、次のいずれかで始まる必要があります。
#

//

これらのコメント文字から行末までのテキストは、Oracle BIサーバーによってファイルが読み取られるときに無視されます。

- バイト単位で設定する必要があるパラメータには、バイト、KB、MBまたはGBで値を指定できます。サイズ修飾子を省略すると、その値はバイト単位の数として解釈されます。サイズ修飾子を含める場合は、修飾子の前に必ずスペースを含めてください。有効な値の例は次のとおりです。

MAX_QUERY_PLAN_CACHE_ENTRY_SIZE = 1 MB;
MAX_QUERY_PLAN_CACHE_ENTRY_SIZE = 1024 KB;
MAX_QUERY_PLAN_CACHE_ENTRY_SIZE = 1048576;

- 構文エラーがあると、Oracle BIサーバーが起動しません。エラーは、次の場所にあるnqserver.logファイルに記録されます。

BI_DOMAIN/servers/obis1/logs

システム・ログに、エラーに関連するサマリー・メッセージが記録される場合もあります。

エラーが発生した場合は、問題を修正してOracle BIサーバーを再起動します。エラーなしでサーバーが起動するまで、この手順を繰り返します。

NQSConfig.INIのパラメータの更新方法

次の手順では、NQSConfig.INIのパラメータを更新する方法を説明します。

NQSConfig.INIのパラメータを更新する手順は次のとおりです。

1. テキスト・エディタでNQSConfig.INIファイルを開きます。このファイルは次の場所にあります:

BI_DOMAIN/config/fmwconfig/biconfig/OBIS

編集する前に、ファイルのバックアップ・コピーを作成します。

2. 変更するパラメータを検索し、更新します。

3. ファイルを保存して閉じます。

4. Oracle BIサーバーを再起動します。

「Oracle Business Intelligenceプロセスの管理について」を参照してください。

Repositoryセクションのパラメータ

Repositoryセクションには、サーバーの起動時にロードされるリポジトリごとに1つのエントリがあります。

注意:
単一Oracle BIサーバー上で複数のリポジトリをホストすることは、本番システムではお薦めしません。

構文: logical_name = repository_name.rpd;

オプションの構文: logical_name = repository_name.rpd, DEFAULT;

この構文では:

- logical_name: リポジトリの論理名。クライアント・ツールでは、この名前を使用して、リポジトリに接続するODBCデータソースが構成されます。OCI7またはOCI8などの予約済のキーワードを名前に使用するには、そのキーワードを一重引用符で囲みます。

- repository_name.rpd: リポジトリのファイル名。ファイル名には、ファイル拡張子.rpdが付いている必要があり、ファイルはリポジトリのサブディレクトリにある必要があります。
Oracle Business Intelligenceのインストール時に選択された場合にデモ用のリポジトリSampleAppLite.rpdがインストールされます。

リポジトリにDEFAULTが指定されている場合、DSNに論理リポジトリ名が指定されていない接続はデフォルト・リポジトリに接続します。

例: Star = SampleAppLite.rpd, DEFAULT;

Multitenancyセクションのパラメータ

Multitenancyセクションのパラメータは、複数のテナントが含まれる構成をサポートします。このセクションのパラメータは、将来の使用に備えて確保されています。

MT_ROOT_DIRECTORY

このパラメータは、将来の使用に備えて確保されています。

例: MT_ROOT_DIRECTORY= "";

MT_ENTRIES

このパラメータは、将来の使用に備えて確保されています。

例: MT_ENTRIES= ;

Query Result Cacheセクションのパラメータ

Query Result Cacheセクションのパラメータは、Oracle BIサーバー・キャッシュの構成情報を提供します。

問合せキャッシュは、デフォルトで有効化されています。古いエントリのフラッシュ方法を決定した後、Fusion Middleware ControlとNQSConfig.INIファイルでキャッシュ記憶域のパラメータを構成します。

問合せキャッシングは、本来、ランタイム・パフォーマンスの改善機能です。長期にわたってシステムを使用するにつれ、以前に実行された問合せに対するキャッシュ・ヒット率が高くなるため、パフォーマンスが改善する傾向にあります。問合せのパフォーマンスを最適化するための最も効果的で普及している方法は、集計の永続性ウィザードと集計ナビゲーションの使用です。

ここでは、問合せキャッシングを制御するパラメータのみを説明します。エージェントを使用してOracle BIサーバー・キャッシュをシードする方法など、Oracle Business Intelligenceでのキャッシングの使用方法の詳細は、「パフォーマンス・チューニングと問合せキャッシングの管理」を参照してください。

ENABLE

注意:

ENABLEパラメータは、Fusion Middleware ControlまたはNQSConfig.INIを手動で編集して管理できます。

Fusion Middleware Controlの「構成」ページの「パフォーマンス」タブにある「キャッシュ有効」オプションがENABLEパラメータに対応します。「問合せキャッシングを有効または無効にするためのFusion Middleware Controlの使用」を参照してください。

キャッシュ・システムを有効にするかどうかを指定します。NOに設定すると、キャッシングが無効になります。YESに設定すると、キャッシングが有効になります。問合せキャッシュは、デフォルトで有効化されています。

例: ENABLE = YES;

DATA_STORAGE_PATHS

キャッシュされた問合せ結果データが格納され、キャッシュ・ヒットが発生した場合にアクセスされる場所の1つ以上のパスと、バイト、KB、MBまたはGB単位の最大容量を指定します。

各パスの最大容量は4GBです。最適なパフォーマンスを維持するために、高いパフォーマンスのストレージ・システム上に存在するパスを指定します。

指定する各パスは、既存の書込み可能なパス名である必要があり、パス名は二重引用符( " )で囲む必要があります。マップされたディレクトリのみを指定します。UNCパス名およびマップされたネットワーク・ドライブは、サービスが修飾ユーザー・アカウントで実行する場合にのみ使用可能です。

完全修飾パスまたは相対パスを指定できます。""/"(UNIX)または"<drive>:"(Windows)で始まらないパスを指定すると、Oracle BIサーバーでは、ローカルの書込み可能ディレクトリに対する相対パスであると見なされます。たとえば、パス"cache"を指定すると、Oracle BIサーバーでは、ランタイムに次のものが使用されます。

BI_DOMAIN/servers/obisn/cache

注意:

クラスタ内の複数のOracle BIサーバーは、キャッシュされたデータを共有しません。このため、DATA_STORAGE_PATHSエントリは、クラスタ化された各サーバーに対して一意である必要があります。このエントリが一意であることを確実にするには、キャッシュが各Oracle BIサーバーのローカルの書込み可能なディレクトリに格納されるように相対パスを入力するか、各サーバーに異なる完全修飾パスを入力します。

複数のディレクトリは、カンマ区切りリストとして指定します。複数のディレクトリを指定する場合、それらは異なる物理ドライブ上に存在する必要があります。(すべてが同じ物理ディスクに解決される複数のキャッシュ・ディレクトリ・パスがある場合、使用可能な領域と使用済領域の両方が二重にカウントされる可能性があります)。複数のディレクトリを指定する場合、ディレクトリ名は互いの一部ではない必要があります。たとえば、"cache"と"cache2"ではなく、"cache1"と"cach2"などの名前を使用します。

構文: DATA_STORAGE_PATHS = "path_1" sz[, "path_2" sz{, "path_n" sz}];

例: DATA_STORAGE_PATHS = "cache" 256 MB;

注意:

各ドライブに複数のディレクトリを指定しても、ファイルの入出力(I/O)は同じI/Oコントローラを介して行われるため、パフォーマンスは向上しません。一般に、各ディスク・ドライブに対して1つのディレクトリのみを指定します。異なる複数のドライブ上に複数のディレクトリを指定すると、複数のデバイス間でI/Oを分散することによって、Oracle BIサーバーの全体的なI/Oスループットが内部的に改善される可能性があります。

キャッシュされるデータのディスク領域要件は、キャッシュされるエントリを生成する問合せの数、およびこれらの問合せの結果セットのサイズによって異なります。問合せ結果セットのサイズは、行サイズ(または結果セット内のすべての列の最大長の合計)に結果セットのカーディナリティ(つまり、結果セット内の行数)を掛けて計算されます。予測される最大値は、必要な領域のガイドラインです。

この計算は、キャッシュされた結果セット内のすべてのレコードの平均サイズではなく、ハイエンドの見積りを提供します。このため、結果セットのサイズが可変長の文字列によって左右され、これらの文字列の長さが標準的に分配される場合、平均レコード・サイズは最大レコード・サイズの約半分になります。

注意:

64ビット・システムで4GB未満の値を使用することが最善です。4GBを超える値がある場合は、複数のパスを作成してください。

MAX_ROWS_PER_CACHE_ENTRY

問合せキャッシュへの格納に制限を付与するための問合せ結果セット内の最大行数を指定します。

行数の制限は、多数の行を戻すリソース集中型の問合せによってキャッシュ領域が消費されることを防ぐために役立ちます。問合せが返す行数がMAX_ROWS_PER_CACHE_ENTRYパラメータで指定される値を超える場合、問合せはキャッシュされません。

0に設定した場合、キャッシュ・エントリ当たりの行数に制限はありません。

例: MAX_ROWS_PER_CACHE_ENTRY = 100000;

MAX_CACHE_ENTRY_SIZE

MAX_CACHE_ENTRY_SIZEパラメータは、Fusion Middleware ControlまたはNQSConfig.INIを編集して管理できます。

注意:

Fusion Middleware Controlの「構成」ページの「パフォーマンス」タブにある「最大キャッシュ・エントリ・サイズ」オプションがMAX_CACHE_ENTRY_SIZEパラメータに対応します。「問合せキャッシュ・パラメータを設定するためのFusion Middleware Controlの使用」を参照してください。

キャッシュ・エントリの最大サイズを指定します。このサイズを超える可能性があるエントリはキャッシュされません。デフォルト・サイズは20MBです。

ギガバイトの場合はGB、キロバイトの場合はKB、メガバイトの場合はMB、およびバイトの場合は単位なしで指定してください。

例: MAX_CACHE_ENTRY_SIZE = 20 MB;

MAX_CACHE_ENTRIES

Fusion Middleware Controlの「構成」ページの「パフォーマンス」タブにある「最大キャッシュ・エントリ」オプションがMAX_CACHE_ENTRIESパラメータに対応します。

注意:

MAX_CACHE_ENTRIESパラメータは、Fusion Middleware ControlまたはNQSConfig.INIを編集して管理できます。

「問合せキャッシュ・パラメータを設定するためのFusion Middleware Controlの使用」を参照してください。

キャッシュ記憶域の管理を支援するために、問合せキャッシュで保持できる最大キャッシュ・エントリ数を指定します。キャッシュ・エントリの実際の制限は、同時問合せの数によって微妙に異なる可能性があります。デフォルト値は1000です。

例: MAX_CACHE_ENTRIES = 1000;

POPULATE_AGGREGATE_ROLLUP_HITS

以前にキャッシュされた問合せ結果セットからのデータを集計して、ロールアップ・キャッシュ・ヒットのために問合せキャッシュに新規エントリを作成するかどうかを指定します。デフォルト値はNOです。

通常、以前に実行した問合せからキャッシュ・ヒットが得られる場合、新しい問合せはキャッシュに追加されません。ユーザーには、特定の詳細のレベルでの情報を含む(たとえば、郵便番号別の販売収益)、キャッシュされた結果セットがあります。2番目の問合せもこれと同じ情報を求めますが、1位上の詳細のレベルです(たとえば、都道府県別の販売収益)。POPULATE_AGGREGATE_ROLLUP_HITSパラメータは、以前に実行された問合せからの集計をロールアップすることによって(この例では、キャッシュに格納されている最初の結果セットからのデータを集計することによって)キャッシュ・ヒットが発生する場合、このデフォルトを上書きします。つまり、Oracle Business Intelligenceでは、特定の都道府県内のすべての郵便番号の販売収益を加算して、都道府県別の販売収益を取得できます。これをロールアップ・キャッシュ・ヒットと呼びます。

通常、キャッシュ・ヒットが発生する問合せでは、新しいキャッシュ・エントリは作成されません。POPULATE_AGGREGATE_ROLLUP_HITSをYESに設定することにより、この動作をキャッシュ・ロールアップに対してのみ上書きできます。非ロールアップ・キャッシュ・ヒットは、このパラメータによる影響を受けません。問合せの結果がキャッシュによって満たされる場合(つまり、問合せでキャッシュ・ヒットが発生する場合)、その問合せはキャッシュに追加されません。このパラメータをYESに設定すると、問合せで集計ロールアップ・ヒットが発生した場合に結果がキャッシュに追加されます。このパラメータをYESに設定すると、パフォーマンスが改善する可能性がありますが、キャッシュに追加されるエントリの数が多くなります。

例: POPULATE_AGGREGATE_ROLLUP_HITS = NO;

USE_ADVANCED_HIT_DETECTION

キャッシングが有効な場合は、各問合せが評価されて、キャッシュ・ヒットと見なされるかどうかが判断されます。

キャッシュ・ヒットとは、サーバーがキャッシュを使用して問合せに答えを返すことができ、データベースにアクセスする必要がないことを意味します。Oracle BIサーバーは問合せキャッシュを使用して、集計の同一レベルまたは後のレベルでの問合せに回答できます。

USE_ADVANCED_HIT_DETECTIONパラメータは、ヒットのためにキャッシュの拡張検索を有効にします。拡張検索はパフォーマンスに影響を与えますが、カスタマの要件が変動するため、この影響を定量化することは容易ではありません。問合せキャッシングに頼る割合が大きく、キャッシュ・ミスを経験しているカスタマは、問合せの一致とユーザーの負荷が高い場合の全体的なパフォーマンスのトレードオフをテストできます。詳細は、パラメータMAX_SUBEXPR_SEARCH_DEPTHを参照してください。

例: USE_ADVANCED_HIT_DETECTION = NO;

問合せがキャッシュに追加されない理由

パフォーマンスKPIを満たすためにOracle BIサーバーで問合せ結果のキャッシングに頼っているカスタマは、キャッシング・パラメータを使用して、キャッシュ・ヒットが発生しない理由の特定に役立てることができます。

ロギング機能は、キャッシュ・ミスが発生する一般的な理由の診断に役立ちます。キャッシュ・ミスとは、キャッシュをシードするはずの論理SQL問合せがキャッシュに挿入されないことです。次に、キャッシュ・ミスが発生する可能性のある状況をいくつか説明します。

- キャッシュ不能のSQL要素。SQLリクエストにCURRENT_TIMESTAMP、CURRENT_TIME、RAND、POPULATEまたはパラメータ・マーカーが含まれている場合、その要素はキャッシュに追加できません。

- キャッシュ不能の表。Oracle BIサーバー・リポジトリにある物理表は、キャッシュ不能とマークされることがあります。問合せがキャッシュ不能の表を参照する場合、その問合せ結果はキャッシュに追加されません。

- キャッシュ・ヒット。一般に、問合せが以前にキャッシュされた問合せに対してキャッシュ・ヒットすると、現在の問合せの結果はキャッシュに追加されません。
この例外は、ロールアップ・ヒットを集計する問合せヒットです。これらは、NQSConfig.INIパラメータPOPULATE_AGGREGATE_ROLLUP_HITSがYESに設定されている場合、キャッシュに追加されます。

- 結果セットが大きすぎる場合。
この状況は、DATA_STORAGE_PATHSで設定されたサイズを超えた場合、またはMAX_ROWS_PER_CACHE_ENTRYで設定された行数を超える行がある場合に発生します。DATA_STORAGE_PATHSおよびMAX_ROWS_PER_CACHE_ENTRYを参照してください。

- 問合せが取り消された場合。これは、Oracle BIプレゼンテーション・サービスまたは管理ツールからの明示的な取消しによって発生するか、タイムアウトによって暗黙的に発生します。

- Oracle BIサーバーがクラスタ化されている場合。キャッシュ・シーディング・ファミリに属する問合せは、クラスタを介して伝播されます。他の問合せは、ローカルに格納されます。このため、問合せがOracle BIサーバー・ノード1にあるキャッシュに追加されても、Oracle BIサーバー・ノード2には追加されない可能性があります。

問合せロギングのレベル4は、Oracle BIサーバー・コンパイラがエントリを問合せ結果キャッシュに追加しようとしたかどうかを診断できる最良のツールです。「問合せロギングの構成」を参照してください。

MAX_SUBEXPR_SEARCH_DEPTH

ヒット・ディテクタによって問合せの式の不完全一致が検索される深さを構成します。デフォルトは5です。

たとえば、レベル5の場合、式SIN(COS(TAN(ABS(ROUND(TRUNC(profit))))))の問合せでレベル7のprofitがミスします。検索の深さを7に変更すると、profitがヒット候補に入れられます。

例: MAX_SUBEXPR_SEARCH_DEPTH = 7;

DISABLE_SUBREQUEST_CACHING

YESに設定すると、サブリクエスト(副問合せ)レベルでのキャッシングが無効になります。

デフォルト値はNOです。

リアルタイムと過去のデータを組み合せた問合せの場合は特に、サブリクエストのキャッシングによって、パフォーマンスとキャッシュ・ヒット率が向上します。ただし、他の問合せ最適化方法によって優れたパフォーマンスが提供される場合など、場合によってはサブリクエストのキャッシングを無効にできます。

例: DISABLE_SUBREQUEST_CACHING = NO;

CACHE_FILE_BUFFER_SIZE

ディスクへの書込み時に一時的にキャッシュ・ファイルの保存に使用するメモリー量を指定します。

デフォルト値は128KBです。

例: CACHE_FILE_BUFFER_SIZE = 128;

GLOBAL_CACHE_STORAGE_PATH

GLOBAL_CACHE_STORAGE_PATHパラメータは、Fusion Middleware ControlまたはNQSConfig.INIを編集して管理できます。

注意:

Fusion Middleware Controlの「構成」ページの「パフォーマンス」タブにある「グローバル・キャッシュ・パス」および「グローバル・キャッシュ・サイズ」オプションがGLOBAL_CACHE_STORAGE_PATHパラメータに対応します。「グローバル・キャッシュ・パラメータを設定するためのFusion Middleware Controlの使用」を参照してください。

クラスタ環境では、Oracle BIサーバーは、グローバル・キャッシュと呼ばれる共有キャッシュにアクセスするように構成できます。グローバル・キャッシュは共有ファイル・システムのストレージ・デバイスに存在し、シード・イベントやパージ・イベント、およびシード・イベントに関連する結果セットを格納します。

このパラメータは、クラスタリング間で共有されるキャッシュ・エントリを格納するための物理的場所を指定します。このパスは、ネットワーク共有をポイントしている必要があります。すべてのクラスタリング・ノードが同じ場所を共有します。

KB、MBまたはGB単位のサイズを指定するか、接尾辞なしの数値を入力してバイトを指定できます。

構文: GLOBAL_CACHE_STORAGE_PATH = "ディレクトリ名" SIZE;

例: GLOBAL_CACHE_STORAGE_PATH = "C:\cache" 250 MB;

MAX_GLOBAL_CACHE_ENTRIES

GLOBAL_CACHE_STORAGE_PATHによって指定された場所に格納されるキャッシュ・エントリの最大数。

例: MAX_GLOBAL_CACHE_ENTRIES = 1000;

CACHE_POLL_SECONDS

GLOBAL_CACHE_STORAGE_PATHによって指定された共有場所から各ノードがポーリングする間隔(秒単位)。

例: CACHE_POLL_SECONDS = 300;

CLUSTER_AWARE_CACHE_LOGGING

クラスタ・キャッシング機能のロギングをオンにします。

トラブルシューティングにのみ使用されます。デフォルトはNOです。

例: CLUSTER_AWARE_CACHE_LOGGING = NO;

Generalセクションのパラメータ

Generalセクションには、ローカライズと国際化、一時領域およびメモリー割当て、およびOracle BIサーバーからクライアントにデータが戻される方法を決定するために使用されるその他のデフォルト・パラメータなど、一般的なサーバー・デフォルト・パラメータが含まれています。

注意:

次の各項目で説明するパラメータLOCALE、SORT_ORDER_LOCALE、SORT_TYPEおよびCASE_SENSITIVE_CHARACTER_COMPARISONの設定は、互いに関連しています。これらは、Oracle BIサーバーによるデータのソート方法を決定するために役立ちます。

LOCALE

サーバーから戻されるデータのロケールを指定します。このパラメータは、日および月のローカライズされた名前も決定します。

Oracle Business Intelligenceを正常に実行するには、ユーザーがアプリケーションを実行する言語について、オペレーティング・システムのロケールを適切に構成する必要があります場合によっては、ロケールをサポートするために追加のコンテンツをシステムにインストールする場合があります。Oracle BIサーバーは、サーバーの起動中にCランタイム・ロケールを設定します。ロケールおよび言語に関する一部の設定は相互に関連しており、Oracle BIサーバーでのデータのソート方法の決定に役立ちます。次のパラメータの設定が相互に機能することを確認します。

- LOCALE

- SORT_ORDER_LOCALE

- SORT_TYPE

- CASE_SENSITIVE_CHARACTER_COMPARISON

LOCALEおよびSORT_ORDER_LOCALEのプラットフォーム非依存の有効値は、次のとおりです。

- アラビア語

- 中国語

- 中国語(繁体字)

- クロアチア語

- チェコ語

- デンマーク語

- オランダ語

- 英語(米国)

- フィンランド語

- フランス語

- ドイツ語

- ギリシャ語

- ヘブライ語

- ハンガリー語

- イタリア語

- 日本語

- 韓国語

- ノルウェー語

- ポーランド語

- ポルトガル語

- ポルトガル語(ブラジル)

- ルーマニア語

- ロシア語

- スロバキア語

- スペイン語

- スウェーデン語

- タイ語

- トルコ語

Oracle BI Catalog Managerと言語拡張の詳細は、「Oracle Business Intelligenceのローカライズ」を参照してください。

SORT_ORDER_LOCALE

Oracle BIサーバーがORDER BY句をリレーショナル・データベースにファンクションシップ(プッシュ・ダウン)できるかどうかを特定するために役立ちます。

ORDER BY句は、ソートに使用されます。

Oracle BI管理ツールの物理レイヤーで定義されるすべてのデータベースには、機能表が関連付けられています。特定のタイプのリレーショナル・データベースについて、機能表のデフォルト値を上書きする場合は、物理レイヤーでのその発生すべてに対して上書きする必要があります。

Oracle BI管理ツールの「データベース」ダイアログの「機能」タブにある機能表には、リレーショナル・データベースでサポートされる機能と関数が指定されています。機能表とNQSConfig.INIファイルのSORT_ORDER_LOCALEの各設定は、データベースとOracle BIサーバーでデータが同じ方法でソートされる場合にのみ一致します。

リレーショナル・データベースとOracle BIサーバーでデータが同じ方法でソートされるには、次の表に示すパラメータの値が一致している必要があります。

機能カテゴリ

固有パラメータ

基本言語

LOCALE

基本言語

SORT_ORDER_LOCALE

機能表とNQSConfig.INIファイルの両方におけるSORT_ORDER_LOCALEのデフォルト値は、english-usaです。

Oracle BIサーバーとデータベースが異なる方法でデータをソートする場合は、データベースに対する機能表のエントリSORT_ORDER_LOCALEをenglish-usa以外の値に設定する必要があります。そうでないと、異なるデータ・ソート方法が競合します。

LOCALEパラメータとSORT_ORDER_LOCALEパラメータは、プラットフォーム非依存の名前のみを受け入れます。詳細は、「LOCALE」に記載されているリストを参照してください。

大/小文字

CASE_SENSITIVE_CHARACTER_COMPARISON

バイナリと言語の比較

SORT_TYPE

実際のデータソースでのSORT_ORDER_LOCALE設定がOracle BIリポジトリの「データベース」ダイアログの「機能」タブにおけるSORT_ORDER_LOCALE設定と一致しない場合、結果セットが不正になる可能性があります。この設定が一致しない場合、複数のデータベースの結合を使用した場合に不正な結果が得られたり、UNION、INTERSECTおよびEXCEPT演算子を使用した場合にエラーが返されたりする可能性があります。これらの演算子はすべて、バックエンドのデータソースとOracle BIサーバー間の一貫性のあるソートに基づいています。

NQSConfig.INIのSORT_ORDER_LOCALE設定がOracle BIリポジトリの「データベース」ダイアログの「機能」タブにおけるSORT_ORDER_LOCALE設定と一致しない場合、問合せのパフォーマンスに悪影響が及ぶ可能性があります。ただし、この状況は結果セットの正確さには影響しません。

SORT_ORDER_LOCALE = "english-usa";

UNIXオペレーティング・システムでのSORT_ORDER_LOCALE

Oracle BIサーバーは、サーバーの起動中にCランタイム・ロケールを設定します。

設定の値は、NQSConfig.INIファイルのSORT_ORDER_LOCALEエントリを使用して指定されます。「Oracle BIサーバーでのロケール・パラメータの設定」を参照してください。

SORT_TYPE

実行するソートのタイプを指定します。

デフォルト値はBINARYです。バイナリ・ソートは、非バイナリ・ソートよりも高速です。

有効値はBINARYおよびDEFAULTです。DEFAULTを指定すると、非バイナリ・ソートが実行されます。これは、アクセント付き文字を含むデータの場合に優れたソート結果を返します。

例: SORT_TYPE = "BINARY";

CASE_SENSITIVE_CHARACTER_COMPARISON

Oracle BIサーバーが比較演算の実行時に大文字と小文字を区別するかどうかを指定します。

有効値はONおよびOFFです。OFFに設定すると、大/小文字の区別は無視されます。ONに設定すると、大/小文字の区別が比較に考慮されます。デフォルトでは、このパラメータはONに設定されています。バイナリ・ソートの場合、大/小文字の区別はサーバーとリレーショナル・データベースで同様に設定する必要があります。

このパラメータがOracle BIサーバーでの大/小文字の設定にどのように関連しているかの詳細は、「プレゼンテーション・サービスに対する拡張構成の変更」を参照してください。

この設定は、キャッシングと集計を目的としたOracle BIサーバーの内部比較にのみ適用されます。大/小文字の区別はデータベース操作の機能であり、データベース・レベルで設定されます。CASE_SENSITIVE_CHARACTER_COMPARISONパラメータにより、Oracle BIサーバーはバックエンド・データベースの機能を一致させることができます。影響を受ける演算子は次のとおりです。

- Order By

- Group By

- Distinct

- Join

- 比較(<、>、=、<=、>=、<>)

たとえば、次の3つの用語について考えてみます。

- ACME

- DELTA

- acme

CASE_SENSITIVE_CHARACTER_COMPARISONがONの場合のORDER BYでは、上の例に示されている順序で行が表示されます。大/小文字を区別しない場合のORDER BYでは、ACMEとacmeがリスト内で隣に表示されます。

用語の大/小文字が区別される場合に重複の削除(DISTINCT)を実行すると、結果は3行になります。用語の大/小文字が区別されない場合、DISTINCTの結果は2行になります。

CASE_SENSITIVE_CHARACTER_COMPARISONは、バックエンド・データベースでの大/小文字の処理方法と一致するように設定します。たとえば、バックエンド・データベースで大/小文字が区別されない場合、Oracle BIサーバーを大/小文字を区別しないように構成します。Oracle BIサーバーとバックエンド・データベースで大/小文字の区別が同じでない場合、いくつかの微細な問題が生じる可能性があります。

集計に適用されるCASE_SENSITIVE_CHARACTER_COMPARISONの例では、大/小文字が区別されるデータベースには次のタプル(または行)があります。

Region  Units
WEST     1
west     1
West     1

CASE_SENSITIVE_CHARACTER_COMPARISONがONに設定されている場合、データは上の表に示されているものと同じ結果でクライアントに戻されます。

CASE_SENSITIVE_CHARACTER_COMPARISONがOFFに設定されている場合も、データは上の表に示されているものと同じ結果でクライアントに戻されます。Oracle BIサーバーでは文字比較が行われていないため、変化はありません。

ただし、機能表でSUM_SUPPORTEDがOFFに設定されている場合、Oracle BIサーバーでは強制的に文字比較が実行されます。この場合、問合せの結果は次のようになります。

Region  Units
WEST     3

このような結果になる理由は、Oracle BIサーバーでは大/小文字を区別する文字比較がオフになっているため、3つのタプルが同じ値として扱われ、集計されるからです。この場合、WEST = West = westです。ただし、「リージョン」列でフィルタしても、リージョンWEST、Westおよびwestは表示されます。CASE_SENSITIVE_CHARACTER_COMPARISONは、バックエンド・データベースでのフィルタリングには影響を与えません。集計の例で示されているロジックは、キャッシングにも適用されます。

NQSConfig.INIファイルでCASE_SENSITIVE_CHARACTER_COMPARISONが設定されているため、このパラメータはリポジトリ内のすべてのバックエンド・データベースに適用されます。このため、このパラメータはリポジトリの主要バックエンド・データベースの大/小文字の区別と一致するように設定します。

例: CASE_SENSITIVE_CHARACTER_COMPARISON = ON;

NULL_VALUES_SORT_FIRST

NULL値を他の値より前にソートするか(ON)、後にソートするか(OFF)を指定します。

有効値はONおよびOFFのみです。NULL_VALUES_SORT_FIRSTの値は、基礎となるデータベースに適合している必要があります。基礎となるデータベースが複数存在し、NULL値のソート方法が異なる場合、この値は、問合せで最も頻繁に使用されるデータベースに対応するように設定します。

例: NULL_VALUES_SORT_FIRST = OFF;

DATE_TIME_DISPLAY_FORMAT

Oracle BIサーバーに対する日付/タイムスタンプの入力および出力の書式を指定します。デフォルト値はyyyy/mm/dd hh:mi:ssです。

例: DATE_TIME_DISPLAY_FORMAT = "yyyy/mm/dd hh:mi:ss";

日時表示書式の使用方法

DATE_TIME_DISPLAY_FORMAT、DATE_DISPLAY_FORMATおよびTIME_DISPLAY_FORMATで指定されたプロパティ値はそれぞれ、TIMESTAMP、DATEおよびTIMEの表現からVARCHARやCHARなどの文字データ型へ、またはその逆に変換する際、BIサーバーで使用されるデフォルト書式を決定します。

DATE_TIME_DISPLAY_FORMAT、DATE_DISPLAY_FORMATおよびTIME_DISPLAY_FORMATは、CAST_SUPPORTEDがデータベースで有効ではない場合に、CAST(<chardata> as TIMESTAMP)、CAST(<chardata> as DATE)、CAST(<datetimeexpr> AS VARCHAR(20))、CAST(<dateexpr> AS CHAR(10))などの日付または時間の変換表現がどのように動作するかを決定します。

CAST_SUPPORTED機能がデータベースで有効である場合、日時書式はDATE_TIME_DISPLAY_FORMAT、DATE_DISPLAY_FORMATおよびTIME_DISPLAY_FORMATの各プロパティではなく、データベースによって決定されます。

これらのプロパティは、nqserver.logまたはnqquery.logに書き込まれるタイムスタンプの書式に作用しません。ログ・ファイルに書き込まれるタイムスタンプの書式は、Oracle Fusion Middlewareの基準に応じて決定され、Fusion Middleware Controlなどの多くのツールでログ・ファイルを解析できる必要があるため変更できません。このようなツールは、ログ・ファイルのタイムスタンプは固定書式であるという事実に依拠しています。

詳細は、DATE_DISPLAY_FORMATおよびTIME_DISPLAY_FORMATを参照してください。

DATE_DISPLAY_FORMAT

Oracle BIサーバーに対する日付の入力および出力の書式を指定します。デフォルト値はyyyy/mm/ddです。

注意:

年を2桁(yy)または4桁(yyyy)で指定します。セパレータには、y、mまたはdを除く任意の文字を使用できます。

例: DATE_DISPLAY_FORMAT = "yyyy/mm/dd";

「日時表示書式の使用方法」を参照してください。

TIME_DISPLAY_FORMAT

時間を表示および入力する方法を構成できます。

Oracle BIサーバーに対する時間の入力および出力の書式を指定します。デフォルト値はhh:mi:ssです。

例: TIME_DISPLAY_FORMAT = "hh:mi:ss";

「日時表示書式の使用方法」を参照してください。

WORK_DIRECTORY_PATHS

一時領域用の1つ以上のディレクトリを指定します。

指定する各ディレクトリは、既存の書込み可能なパス名である必要があり、パス名は二重引用符( " )で囲む必要があります。マップされたディレクトリのみを指定します。

完全修飾パスまたは相対パスを指定できます。""/"(UNIX)または"<drive>:"(Windows)で始まらないパスを指定すると、Oracle BIサーバーでは、ローカルの書込み可能ディレクトリに対する相対パスであると見なされます。たとえば、パス"temp"を指定すると、Oracle BIサーバーでは、ランタイムに次のものが使用されます。

BI_DOMAIN/servers/obisn/tmp/obis_temp

複数のディレクトリは、カンマ区切りリストとして指定します。有効値は、相対パス、または既存の書込み可能なディレクトリの完全修飾パスです。UNCパス名およびマップされたネットワーク・ドライブは、サービスが修飾ユーザー・アカウントで実行する場合にのみ許可されます。

最適なパフォーマンスを維持するために、一時ディレクトリは高いパフォーマンスのストレージ・デバイス上に存在する必要があります。複数のディレクトリを指定する場合、それらは異なる物理ドライブ上に存在する必要があります。

構文: WORK_DIRECTORY_PATHS = "path_1" [, "path_2"{, "path_n"}];

例1: WORK_DIRECTORY_PATHS = "temp" ;

例2: WORK_DIRECTORY_PATHS = "D:\temp", "F:\temp";

注意:
各ドライブに複数のディレクトリを指定しても、ファイルI/Oは同じI/Oコントローラを介して行われるため、パフォーマンスは向上しません。一般に、各ディスク・ドライブに対して1つのディレクトリのみを指定します。異なる複数のドライブ上に複数のディレクトリを指定することは、Oracle BIサーバーの全体的なI/Oスループットを改善します。これは、内部的に、処理ファイルは特定のディスク・ドライブ間でI/O負荷を分散するラウンドロビン・アルゴリズムを使用して割り当てられるためです。

WORK_FILE_COMPRESSION_LEVEL

Oracle BIサーバーの内部一時ファイル・チューニング用にこのパラメータを使用します。

このパラメータは圧縮ライブラリを使用して、一時作業ファイルを圧縮します。

たとえば、WORK_FILE_COMPRESSION_LEVEL = 2;などです

ENABLE_COLUMNAR_STORAGE_FOR_WORK_FILE

Oracle BIサーバーの内部一時ファイル・チューニング用にこのパラメータを使用します。

このパラメータは、集計演算子用に作成された一時ファイルに適用されます。

たとえば、ENABLE_COLUMNAR_STORAGE_FOR_WORK_FILE = YES;などです

WORK_DIRECTORY_SIZE_GLOBAL_LIMIT

Oracle BIサーバーの内部一時ファイル・チューニング用にこのパラメータを使用します。

このパラメータはディレクトリ・サイズ制限を指定し、MAX_WORK_FILE_SIZE_PERCENTとともに動作し、一時ファイルがグローバル作業ディレクトリ・サイズ制限の指定された割合を超えないようにします。

たとえば、WORK_DIRECTORY_SIZE_GLOBAL_LIMIT = 100 GB;などです

MAX_WORK_FILE_SIZE_PERCENT

Oracle BIサーバーの内部一時ファイル・チューニング用にこのパラメータを使用します。

このパラメータはWORK_DIRECTORY_SIZE_GLOBAL_LIMITとともに動作し、一時ファイルを拡張できる最大サイズを決定します。

たとえば、MAX_WORK_FILE_SIZE_PERCENT = 5;を設定します

VIRTUAL_TABLE_PAGE_SIZE

ソート、結合、和結合、データベース・フェッチなどのいくつかの操作は、Oracle BIサーバーに対して使用可能なメモリー・リソースより多くのメモリー・リソースを必要とする場合があります。

この状況を管理するために、サーバーでは、これらの操作の処理にバッファリング・スキームを提供する仮想表管理メカニズムが使用されます。データ量がVIRTUAL_TABLE_PAGE_SIZEを超えると、残りのデータは一時ファイルにバッファされ、処理の進行に応じて仮想表に入れられます。このメカニズムでは動的メモリー・サイズがサポートされ、問合せの処理時にすべての行を動的に取得できます。

VIRTUAL_TABLE_PAGE_SIZEは、Oracle BIサーバーの内部処理用のメモリー・ページ・サイズを指定します。値が大きくなるほど、I/Oが減少しますが、特にマルチユーザー環境でメモリー使用量が増加します。

VIRTUAL_TABLE_PAGE_SIZEが増加すると、I/O処理は減少します。複雑な問合せでは20 - 30の仮想表を使用する可能性がありますが、単純な問合せでは仮想表を必要としない場合さえあります。デフォルト・サイズの128KBは、Windows NTの仮想ページングのサイズが64KBであることを考慮すると妥当なサイズです。このパラメータは、同時ユーザー数と平均的な問合せの複雑さに応じて調整できます。一般に、256KBより大きいサイズに設定しても、スループットは相応には増加しません。これは、Windows NTシステム・バッファのサイズが64KBに制限されており、I/Oはシステム・バッファを使用して行われるためです。128KBはUNIXシステムでも妥当な値です。

例: VIRTUAL_TABLE_PAGE_SIZE = 128 KB;

USE_LONG_MONTH_NAMES

月名がJANUARY、FEBRUARYなどの完全名として戻されるか、JAN、FEBなどの3文字の略語として戻されるかを指定します。

有効値はYESおよびNOです。月名を完全名として戻すにはYESを指定し、月名を3文字の略語として戻すにはNOを指定します。デフォルト値はNOです。

例: USE_LONG_MONTH_NAMES = NO;

MEMORY_COMPACT_PERIOD_IN_SECONDS

コールからコールの内部メモリー圧縮ルーチンまでの間、Oracle BIサーバーが待機する長さを秒で指定します。

Oracle BIサーバーのメモリー・マネージャは、メモリー圧縮ルーチンがバックグラウンド・スレッドでコールされるまで、空メモリーをシステムに戻しません。このパラメータ値を小さい値に設定すると、Oracle BIサーバーは未使用のメモリーをシステムに戻します。このとき、CPUの追加オーバーヘッドが多少発生します。デフォルトは3600秒です。

例: MEMORY_COMPACT_PERIOD_IN_SECONDS = 3600;

USE_LONG_DAY_NAMES

日名が MONDAY 、 TUESDAY などの完全名として戻されるか、 MON 、 TUE などの3文字の略語として戻されるかを指定します。

有効値はYESおよびNOです。日名を完全名として戻すにはYESを指定し、日名を3文字の略語として戻すにはNOを指定します。デフォルト値はNOです。

例: USE_LONG_DAY_NAMES = NO;

USE_UPPERCASE_MONTH_NAMES

月名を大文字と小文字の混合で返すか、大文字で返すかを指定します。

有効値はYESおよびNOです。YESを指定すると月名が大文字で返され、NOを指定すると月名が大文字と小文字の混合で返されます。デフォルト値はNOです。

例: USE_UPPERCASE_MONTH_NAMES = NO;

USE_UPPERCASE_DAY_NAMES

曜日を大文字と小文字の混合で返すか、大文字で返すかを指定します。

有効値はYESおよびNOです。YESを指定すると曜日が大文字で返され、NOを指定すると曜日が大文字と小文字の混合で返されます。デフォルト値はNOです。

例: USE_UPPERCASE_DAY_NAMES = NO;

UPPERCASE_USERNAME_FOR_INITBLOCK

初期化ブロックで特殊構文:USERを使用して、ユーザー名をパススルーできます。

このパラメータがYESに設定されている場合、:USERを使用して初期化ブロックをパススルーしたユーザー名は、すべて大文字に変更されます。それ以外の場合は、ユーザー名で大/小文字の区別が維持されます。

例: UPPERCASE_USERNAME_FOR_INITBLOCK = NO;

Securityセクションのパラメータ

セキュリティのパラメータは、Oracle BIサーバーのセキュリティ機能のデフォルト値を指定します。

『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』を参照してください。

DEFAULT_PRIVILEGES

AuthenticatedUserアプリケーション・ロールに付与されるOracle BIリポジトリ・オブジェクトのデフォルトの権限を指定します。これは、任意の新規リポジトリ・オブジェクトに関連付けられるデフォルトのアプリケーション・ロールです。

実際この設定は、他に明示的なセキュリティ設定を持たない新しいオブジェクトに対して、リポジトリのプレゼンテーション・レイヤーでのオブジェクト・セキュリティのデフォルト・レベルを指定します。

AuthenticatedUserアプリケーション・ロールは「任意の認証済ユーザー」を意味します。このロールは、Oracle BIリポジトリ内部のものです。

有効値はNONEおよびREADです。デフォルト値はREADです。NONEは、管理ツールの「権限」ダイアログの「アクセス権なし」設定に相当します。

例: DEFAULT_PRIVILEGES = READ;

PROJECT_INACCESSIBLE_COLUMN_AS_NULL

権限のないユーザーへのセキュリティ・センシティブな列の表示方法を制御します。このパラメータがYESに設定されている場合、問合せの元の列の式がNULL式によって置換され、保護されている列は分析時に権限のないユーザーに対して非表示になります。

このパラメータがNOに設定されている場合、ユーザーが表示権限を持っていない保護された列を含むレポートを実行しようとすると、未解決の列のエラーが発生します。

デフォルト値はYESです。

例: PROJECT_INACCESSIBLE_COLUMN_AS_NULL = YES;

IGNORE_LDAP_PWD_EXPIRY_WARNING

LDAPサーバーによってパスワードの期限切れ警告が発行された場合でもユーザーがログインできるかどうかを決定します。

有効値はYESおよびNOです。このパラメータを非コメント化し、LDAPサーバーによってパスワードの期限切れ警告が発行された場合にユーザーがログインできるようにするにはYESを指定し、警告が発行された場合にユーザーのログインを拒否するにはNOを指定します。デフォルト値はNOです。

ユーザーのパスワードがLDAPサーバーで実際に期限切れになった後は、このパラメータの値にかかわらず、ユーザーはログインできません。

例: IGNORE_LDAP_PWD_EXPIRY_WARNING = NO;

MAX_AUTHENTICATION_TIME

ユーザーのログイン試行がタイムアウトするまでに、初期化ブロックを実行するためにOracle BIサーバーに割り当てられる秒数を指定します。タイムアウトが発生すると、Oracle BIサーバーのユーザーは再ログインを要求されます。

この設定は、すべての初期化ブロックに対する累積実行時間に適用されます。この値を10分(600秒)に設定し、Oracle BIサーバーが実行する必要がある初期化ブロックが10個あるとします。5個目の初期化ブロックの実行後に10分のログイン最大値を超えた場合、Oracle BIサーバーは残り5個の初期化ブロックを実行できず、ログイン試行を拒否します。

例: MAX_AUTHENTICATION_TIME = 600;

INIT_BLOCK_LOG_TIME_THRESHOLD

初期化ブロック実行のしきい値(秒)を指定します。この値を超えると、Oracle BIサーバーは実行時間をログに記録します。これにより、初期化ブロックの設計上の潜在的な問題について警告を出すことができます。

例: INIT_BLOCK_LOG_TIME_THRESHOLD = 60;

NUM_INIT_BLOCK_THREADS_PER_USER

Oracle BIサーバーが各ユーザーに割り当てる初期化ブロック・スレッドの数を指定します。

デフォルトは1スレッドです。

例: NUM_INIT_BLOCK_THREADS_PER_USER = 1;

SSL

このパラメータ、およびこの項で説明するその他のパラメータは、Oracle Business Intelligenceコンポーネント間のSecure Sockets Layer(SSL)通信に関連しています。

SSLのデフォルト設定はNOです。

Oracle Business Intelligenceコンポーネント間のSSLの構成の詳細は、『Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』のOracle Business Intelligenceコンポーネント間のSSLの構成方法に関する項を参照してください。

SSL_CERTIFICATE_FILE

証明書ファイルのパスを指定します。

Oracle BIサーバーやOracle BIスケジューラなど、SSLサーバーとして機能するコンポーネントの場合、これはサーバー証明書ファイル名です。Oracle Business Intelligence ODBCクライアント・データソースなどのクライアント・コンポーネントの場合、これはクライアント証明書ファイル名です。

例(サーバー): SSL_CERTIFICATE_FILE = "servercert.pem";

例(クライアント): SSL_CERTIFICATE_FILE = "client-cert.pem";

SSL_PRIVATE_KEY_FILE

秘密鍵ファイルを指定します。

サーバー・コンポーネントの場合、これはサーバー秘密鍵ファイル名です。クライアント・コンポーネントの場合、これはクライアント秘密鍵ファイル名です。

例(サーバー): SSL_PRIVATE_KEY_FILE = "serverkey.pem";

例(クライアント): SSL_PRIVATE_KEY_FILE = "client-key.pem";

SSL_PK_PASSPHRASE_FILE

秘密鍵パス・フレーズ・ファイル名を指定します。

例: SSL_PK_PASSPHRASE_FILE = serverpwd.txt;

SSL_PK_PASSPHRASE_PROGRAM

秘密鍵パス・フレーズ・プログラム実行可能ファイル名を指定します。

例: SSL_PK_PASSPHRASE_PROGRAM = sitepwd.exe;

SSL_VERIFY_PEER

このパラメータは現在非推奨になっています。

SSL_VERIFY_CLIENTSパラメータおよびSSL_VERIFY_SERVERSパラメータは、SSL_VERIFY_PEERパラメータによって以前制御されていた同等の機能の置換えです。『Oracle Business Intelligenceアップグレード・ガイド』を参照してください。

SSL_VERIFY_SERVERS

クライアントとして動作するとき(つまり、Oracle BIサーバーがBIセキュリティ・サービスをコールしているとき)にサーバー証明書を確認するかどうかを指定します。

デフォルト値はYESです。

例: SSL_VERIFY_SERVERS = YES;

SSL_VERIFY_CLIENTS

サーバーとして動作するとき(つまり、Oracle BIサーバーがプレゼンテーション・サービスなどのクライアントからのコールを受信したとき)にクライアント証明書を確認するかどうかを指定します。

デフォルト値は、NOです。

例: SSL_VERIFY_CLIENTS = NO;

SSL_CA_CERTIFICATE_DIR

ピアの検証がYESに設定されている場合にサーバーまたはクライアント証明書の検証に使用される、信頼性のあるCA証明書のパスを指定します。

クライアント認証が必要な場合にのみ有効になります。

例: SSL_CA_CERTIFICATE_DIR = "CACertDir";

SSL_CA_CERTIFICATE_FILE

ピアの検証がYESに設定されている場合にサーバーまたはクライアント証明書の検証に使用される、信頼性のあるCA証明書の名前を指定します。

クライアント認証が必要な場合にのみ有効になります。

例: SSL_CA_CERTIFICATE_FILE = "CACertFile";

SSL_TRUSTED_PEER_DNS

識別名(DN)による接続が許可されている個々の名前付きクライアントを指定します。

DNは、証明書の公開鍵に一致する秘密鍵を持っているエンティティを識別します。

例: SSL_TRUSTED_PEER_DNS = "";

SSL_INTERNAL_CA_CERTIFICATE_FILE

内部のCA証明書ファイル名を指定します。

例: SSL_INTERNAL_CA_CERTIFICATE_FILE = "InternalCACertFile";

SSL_INTERNAL_TRUSTED_PEER_DNS

内部の信頼できるピアDNS名を指定します。

例: SSL_INTERNAL_TRUSTED_PEER_DNS = "";

SSL_WEBSERVER_CA_CERTIFICATE_FILE

WebサーバーのCA証明書ファイル名を指定します。

例: SSL_WEBSERVER_CA_CERTIFICATE_FILE = "WebServerCACertFile";

SSL_WEBSERVER_TRUSTED_PEER_DNS

Webサーバーの信頼できるピアDNS名を指定します。

例: SSL_WEBSERVER_TRUSTED_PEER_DNS = "";

SSL_CERT_VERIFICATION_DEPTH

証明連鎖の深さです。深さ1は、証明書が信頼性できるCAによって署名される必要があることを意味します。

深さ2は、証明書があるCAによって検証された別のCAによって署名されたことを意味します。デフォルト値は9です。

例: SSL_CERT_VERIFICATION_DEPTH = 9;

SSL_CIPHER_LIST

サーバーによって使用される、許可された暗号スイートのリスト。

デフォルトは空の文字列で、ALLに相当します。

このパラメータは、デフォルトの選択以外の暗号スイートを使用する場合にのみ設定する必要があります。

例: SSL_CIPHER_LIST = "EXP-RC2-CBC-MD5";

Serverセクションのパラメータ

Serverセクションのパラメータは、Oracle BIサーバーのデフォルトと制限を定義します。

READ_ONLY_MODE

管理ツールがオンラインまたはオフライン・モードの場合に、Oracle BIリポジトリ・ファイルの変更を許可または禁止します。

注意:
READ_ONLY_MODEパラメータは、Fusion Middleware ControlまたはNQSConfig.INIを編集して設定できます。
Fusion Middleware Controlの「構成」ページの「パフォーマンス」タブにある「RPD更新を許可しない」オプションがREAD_ONLY_MODEパラメータに対応します。RPD更新を禁止するためのFusion Middleware Controlの使用を参照してください。

デフォルトはNOで、リポジトリの編集が可能です。

このパラメータがYESに設定されている場合、管理ツールを使用してリポジトリファイルを変更できなくなります。管理ツールでリポジトリを開くと、リポジトリが読取り専用であるというメッセージがユーザーに通知されます。このパラメータがNOに設定されている場合は、管理ツールを使用してリポジトリに変更を加えることができます。

READ_ONLY_MODEがNOに設定されている場合でも、管理ツールでリポジトリが読取り専用モードで開く場合があります。たとえば、オフライン・モードでリポジトリを開くときに、Oracle BIサーバーまたは別の管理ツール・クライアントがそのリポジトリに対してロックを保持している場合、リポジトリは読取り専用モードで開きます。オンライン・モードでは、Oracle BIサーバーの起動時にオフラインのOracle BIサーバーがリポジトリに対してロックを保持していた場合、リポジトリが読取り専用モードで開く可能性があります。

さらに、Oracle Business Intelligenceがクラスタ化されており、管理ツールがオンライン・モードでスレーブ・ノードに接続している場合も、管理ツールは読取り専用モードで開きます。これは、マスター・ノードがリポジトリに対するロックを保持しているために発生します。クラスタ化された環境での実行時にこの状況を回避するには、管理ツールによって使用されるOracle BIサーバーODBC DSNが、特定のOracle BIサーバーではなくクラスタ・コントローラをポイントするように構成されていることを確認します。

MAX_SESSION_LIMIT

サーバーによって許可される同時接続の最大数を指定します。

この数を超えると、サーバーは接続リクエストを拒否します。

制限は、65,535接続です。

例: MAX_SESSION_LIMIT = 2000;

MAX_SESSION_LIMITおよびSERVER_THREAD_RANGEパラメータについて

接続プールのサイズにより、使用可能なOracle BIサーバー接続の数と、物理問合せの処理に使用可能なスレッドの数が決定されます。1つの論理問合せから複数の物理問合せが生成される可能性があり、それぞれの物理問合せが異なる接続に割り当てられる可能性があります。

Oracle BIサーバーでは、パラメータSERVER_THREAD_RANGEを使用して指定された最大数までサーバー・スレッドが作成されます。必要に応じて、1つ以上のセッションからの問合せを処理するために、常に使用可能なすべてのスレッドが使用されます。

通常、MAX_SESSION_LIMITによって指定されるセッション数は、SERVER_THREAD_RANGEによって指定される使用可能なスレッド数よりも大きくなります。

まとめると、次のようになります。

- MAX_SESSION_LIMITは、無効な場合でもOracle BIサーバーに接続できるセッションの数を指定します。セッションおよび対応する問合せは、使用可能になったときに処理されるようにスレッドのキューに入れられます。

- 接続プールのサイズは、物理問合せを処理するスレッド数と接続数を指定します。

- SERVER_THREAD_RANGEは、論理問合せを処理するスレッドの数、つまり、Oracle BIサーバーでいつでも有効にできる問合せの数を指定します。

MAX_REQUEST_PER_SESSION_LIMIT

1セッション当たりの論理リクエストの最大数を指定します。これは、1セッション当たりの同時に存在する、開いているリクエストの数です。

制限は、1セッション当たり65,535論理リクエストです。

注意:

通常、個々のユーザーには、各セッションに対して同時に開いているリクエストは1つのみ存在します。しかし、アプリケーション・プログラムとOracle BIプレゼンテーション・サービスには、通常、同時に開いているリクエストが複数存在します。一般に、デフォルト値500はほとんどの環境において十分な値ですが、このパラメータは、アプリケーション環境や使用しているクライアント・ツールに基づいて調整してください。

例: MAX_REQUEST_PER_SESSION_LIMIT = 500;

SERVER_THREAD_RANGE

スレッドの割当て構成情報は、各サーバー・リクエストについて記録されます。

各Oracle BIサーバー・リクエストについて、SERVER_THREAD_RANGEはスレッド割当ての構成情報を指定します。範囲の下限値は、初期に割り当てられるスレッドの数を指定し、範囲の上限値は、割り当てられるスレッドの最大数を指定します。スレッド・プールは、上限または下限に達するまで、5スレッドの増分で拡大または縮小します。スレッド数がセッション数よりも少ない場合、セッションは先着順に使用可能なスレッド数を共有します。

両方の値を同じ数に設定すると、スレッド・プーリングの利点を最大限にすることができますが、それに伴うコストが生じます。下限と上限を同じ数値に設定すると、その数のスレッドが常に割り当てられ、それによってスタック領域が消費されます。

例: SERVER_THREAD_RANGE = 10-200;

詳細は、「MAX_SESSION_LIMITおよびSERVER_THREAD_RANGEパラメータについて」を参照してください。

SERVER_THREAD_STACK_SIZE

各サーバー・スレッドに割り当てられるメモリー・スタック・サイズを指定します。

値を0にすると、サーバー・スレッドごとに1MBのスタック・サイズが設定されます(64ビット・システム)。

デフォルト値は0です。この値を変更する場合は、指定する値がシステムで使用可能なメモリー・リソースに適していることを確認してください。

例: SERVER_THREAD_STACK_SIZE = 0;

DB_GATEWAY_THREAD_RANGE

SERVER_THREAD_RANGEに従って、Oracle Business Intelligence Database Gatewayスレッド・プールのスレッドの最小数および最大数を指定します。

デフォルト値は40-200です。

例: DB_GATEWAY_THREAD_RANGE = 40-200;

DB_GATEWAY_THREAD_STACK_SIZE

各Oracle Business Intelligence Database Gatewayスレッドに割り当てられるメモリー・スタック・サイズを指定します。値を0にすると、サーバー・スレッドごとに1MBのスタック・サイズが設定されます(64ビット・システム)。

デフォルト値は0です。この値を変更する場合は、指定する値がシステムで使用可能なメモリー・リソースに適していることを確認してください。

例: DB_GATEWAY_THREAD_STACK_SIZE = 0;

HTTP_CLIENT_THREAD_RANGE

HTTPクライアント・ラッパーを使用してデータの読取りおよび書込みを行う際にOracle BIサーバーが使用する、スレッド・プールの最小スレッド数および最大スレッド数を指定します。

デフォルト値は0-100です。

例: HTTP_CLIENT_THREAD_RANGE = 0-100;

HTTP_CLIENT_THREAD_STACK_SIZE

HTTP_CLIENT_THREAD_RANGEで指定された各スレッドに割り当てられるメモリー・スタック・サイズを指定します。値を0にすると、スレッドごとに1MBのスタック・サイズが設定されます(64ビット・システム)。

デフォルト値は0です。この値を変更する場合は、指定する値がシステムで使用可能なメモリー・リソースに適していることを確認してください。

例: HTTP_CLIENT_THREAD_STACK_SIZE = 0;

MAX_EXPANDED_SUBQUERY_PREDICATES

副問合せの拡張時、副問合せによって移入できる値の最大数を制御します。デフォルトは8,192値です。この制限を超えると、Oracle BIサーバーでエラーが生成されます。

Oracle BIサーバー構文は、INおよびCOMPARISONなどの各種副問合せをサポートします。場合によっては、Oracle BIサーバーで副問合せを実行し、それを値に変換する必要があります(たとえば、データベース機能表でデータベース機能IN_SUPPORTED/IN_SUBQUERY_SUPPORTEDおよびCOMPARISON_SUBQUERYがオフになっている場合など)。Oracle BIサーバーで副問合せを値リストに変換する場合は、副問合せの結果セットから生じる値の最大数の監視にMAX_EXPANDED_SUBQUERY_PREDICATESが使用されます。

MAX_ENTRIES_PER_IN_LISTと呼ばれるデータベース機能設定もあります。この値は、特定のデータソースによってサポートされるリテラル数に応じて設定されます。この制限を超えると、Oracle BIサーバーによってINリストがより小さいリストに分割され、ORで結合されます。ただし、元のINリストが長すぎる場合、そのデータソースに対するSQL文の長さ制限を超える可能性があり、データベース・エラーまたは障害が発生することがあります。MAX_EXPANDED_SUBQUERY_PREDICATESパラメータは、この状況を回避するための2つ目の制限を提供します。

例: MAX_EXPANDED_SUBQUERY_PREDICATES = 8192;

注意:
エラー[nQSError: 42029] Subquery contains too many values for the IN predicateが表示される場合、MAX_EXPANDED_SUBQUERY_PREDICATESの値を増やしてください(デフォルト値は8192です)。問合せを再試行してください。

MAX_QUERY_PLAN_CACHE_ENTRIES

キャッシュされた論理問合せ計画の数を制御します。問合せ計画キャッシュとは、最近使用された問合せの計画をキャッシュすることによって、問合せコンパイル・プロセスの速度を向上させる内部パフォーマンス機能です。

このパラメータのデフォルト値は1024です。Oracleサポート・サービスに連絡せずに、この値を大きくしないでください。

例: MAX_QUERY_PLAN_CACHE_ENTRIES = 1024;

MAX_QUERY_PLAN_CACHE_ENTRY_SIZE

単一の論理計画キャッシュ・エントリに割り当てられるヒープ・メモリーの使用量の制限を指定します。Oracle BIサーバーごとの計画キャッシュ・メモリーの総使用量は、MAX_QUERY_PLAN_CACHE_ENTRY_SIZEを二乗することで算出できます。

デフォルト値0は、1MBのデフォルト制限を示します(64ビット・プラットフォーム)。この値を変更する場合は、指定する値がシステムで使用可能なメモリー・リソースに適していることを確認してください。

例: MAX_QUERY_PLAN_CACHE_ENTRY_SIZE = 0;

MAX_DRILLDOWN_INFO_CACHE_ENTRIES

リポジトリ当たりのキャッシュされたアクション・リンク・ドリルダウン情報エントリの数を制御します。これは、最近使用された問合せのアクション・リンク情報をキャッシュすることにより、アクション・リンク情報の計算速度を向上させます。

このパラメータのデフォルト値は1024です。Oracleサポート・サービスに連絡せずに、この値を大きくしないでください。

例: MAX_DRILLDOWN_INFO_CACHE_ENTRIES = 1024;

MAX_DRILLDOWN_QUERY_CACHE_ENTRIES

リポジトリ当たりのキャッシュされたアクション・リンク問合せエントリの数を制御します。これは、最近使用された問合せのアクション・リンク・ドリルダウン結果をキャッシュすることにより、ドリルダウンの速度を向上させます。

このパラメータのデフォルト値は1024です。Oracleサポート・サービスに連絡せずに、この値を大きくしないでください。

例: MAX_DRILLDOWN_QUERY_CACHE_ENTRIES = 1024;

INIT_BLOCK_CACHE_ENTRIES

行単位の初期化でキャッシュされる初期化ブロック結果セットの数を制御します。

キャッシュ・キーは、完全にインスタンス化された初期化ブロックSQLです。

デフォルト値は20です。このパラメータはOracle Business Intelligenceのローカライズされたバージョンの内部操作に影響を与えるため、指示がないかぎり、この値は変更しないことをお薦めします。

例: INIT_BLOCK_CACHE_ENTRIES = 20;

CLIENT_MGMT_THREADS_MAX

Oracle BIサーバーのクライアント/サーバー通信を管理するために割り当てられる、管理スレッドの数を指定します。各クライアント・プロセスが1つの管理スレッドを消費します。

Oracle BIサーバーのクライアント/サーバー通信方式はTCP/IPです。

通常、デフォルト値5はクライアントとサーバーの通信には十分であるため、このパラメータの値は変更しないでください。

例: CLIENT_MGMT_THREADS_MAX = 5;

DEFAULT_JOBQUEUE_SIZE_PER_THREAD

キュー内のスレッド当たりのジョブ数を指定します。

デフォルトは100ジョブです。0に設定すると、キュー内のスレッド当たりのジョブの数は無制限です。

例: DEFAULT_JOBQUEUE_SIZE_PER_THREAD = 100;

MAX_COLUMNS_IN_SELECT

プレゼンテーション・サービスによって生成されるすべての小計式を含め、SELECT文の最大列数を指定します。この制限は、導出されたselectブロックまたはリーフselectブロックを含め、すべてのSELECT文に適用されます。

この値を0に設定しても、無制限を表しません。このパラメータで設定した制限は、管理者を含むすべてのユーザーと、すべてのサブジェクト領域に適用されます。

例: MAX_COLUMNS_IN_SELECT = 50;

MAX_LOGICAL_DIMENSION_TABLES

単一のプレゼンテーション列は、対応する論理列が複数の論理表から導出されている場合、複数の論理表を参照できます。

また、複数のプレゼンテーション表は、同じ論理表を参照できます。たとえば、1つの問合せでEmployeeCity、EmployeeRegion、EmployeeCountryなどの複数の論理表をリクエストするとします。この例では、すべての表が同じディメンションを参照するとしても、表数は3です。

非表示ディメンションの属性は、論理ディメンション表の合計数に含まれます。

この値を0に設定しても、無制限を表しません。このパラメータで設定した制限は、管理者を含むすべてのユーザーと、すべてのサブジェクト領域に適用されます。

例: MAX_LOGICAL_DIMENSION_TABLES = 30;

MAX_LOGICAL_FACT_TABLES

単一のリーフ論理リクエストに表示する論理ファクト表の最大数を指定します。

また、このパラメータはOracle BIサーバーによって追加される暗黙ファクト・メジャーに適用されます。このパラメータを0に設定し、問合せで暗黙ファクト・メジャーを起動するディメンションを2つリクエストするとします。論理ファクト表の制限を超えているため、この問合せは失敗します。

非表示ファクトの属性は、論理ファクト表の合計数に含まれます。

この値を0に設定しても、無制限を表しません。このパラメータで設定した制限は、管理者を含むすべてのユーザーと、すべてのサブジェクト領域に適用されます。

例: MAX_LOGICAL_FACT_TABLES = 5;

MAX_LOGICAL_MEASURES

一意の論理メジャー列(単一の論理リクエストの論理レイヤーに定義されている一意のディメンション集計)の最大数を指定します。

メジャーには、単一の問合せで複数回参照されるものがありますが、数えられるのは1回です。同じ物理属性と集計ルールに基づいているメジャーで、レベルベースの設定が異なるメジャーは、別個のメジャーとして数えられます。たとえば、EmployeeCountry.Revenueは、レベルをProduct-RegionディメンションのCOUNTRYに設定してSales.Revenueから導出されますが、Sales.Revenueとは別のメジャーとして数えられます。

非表示ファクトの属性は、論理メジャーの合計数に含まれます。

この値を0に設定しても、無制限を表しません。このパラメータで設定した制限は、管理者を含むすべてのユーザーと、すべてのサブジェクト領域に適用されます。

例: MAX_LOGICAL_MEASURES = 15;

MAX_SET_OPERATION_BLOCKS

受信SQL問合せに表示する論理和、論理積または論理差のブロックの最大数を指定します。set演算子がある問合せには、少なくとも2つの問合せブロックが含まれます。

各問合せには、少なくとも1つの問合せブロックが必要です。このパラメータに0と指定すると、Oracle BIサーバーは問合せを実行しません。このパラメータに1と指定すると、set演算子を使用しないために問合せブロックが1つしか含まれない問合せのみがその問合せに組み込まれます。

このパラメータで設定した制限は、管理者を含むすべてのユーザーと、すべてのサブジェクト領域に適用されます。

例: MAX_SET_OPERATION_BLOCKS = 15;

QUERY_LIMIT_WARNING_INSTEAD_OF_ERROR

論理問合せ制限を超えた場合に、エラー・メッセージを表示するかどうかを決定します。

このパラメータをOFFに設定し、論理問合せ制限を超えた場合、Oracle Business Intelligenceではエラー・メッセージが表示され、問合せの残りの部分は終了します。このパラメータをONに設定し、論理問合せ制限を超えた場合、問合せは完了しエラー・メッセージは表示されませんが、しきい値を超えたことを示す警告メッセージがnqserver.logファイルに記録されます。

例: QUERY LIMIT_WARNING_INSTEAD_OF_ERROR = OFF;

RPC_SERVICE_OR_PORT

Oracle BIサーバーがリスニングするIPアドレスとポート番号を指定します。

注意:
RPC_SERVICE_OR_PORTパラメータは、NQSConfig.INIを編集して設定できます。
ポート範囲を設定すると、RPC_SERVICE_OR_PORTパラメータがオーバーライドされます。

ip_address:portの書式でIPアドレスとポート番号を指定するか、ポート番号のみを指定できます。

IPアドレスとポート番号を指定すると、Oracle BIサーバーは指定されたIPアドレスにバインドします。

ポート番号のみを指定する場合、IPアドレスはデフォルトで0.0.0.0に設定され、Oracle BIサーバーはそのコンピュータ上のすべてのIPアドレスでリスニングします。

IPアドレスのみを指定する場合は、ポート値はデフォルトで9703になります。

Oracle Business IntelligenceのODBCウィザードを使用してOracle BIサーバー用のODBCデータソースを構成する場合、ログオン情報の入力画面の「ポート」フィールドに指定されているポート番号と、ここで指定するポート番号を必ず一致させてください。構成ファイルでポート番号を変更する場合、新しいポート番号を使用するように、影響を受けるすべてのODBCデータソースを再構成する必要があります。

例1: RPC_SERVICE_OR_PORT = 9703;

例2: RPC_SERVICE_OR_PORT = 127.0.0.1:9703;

LISTEN_ADDRESS

このパラメータは、将来のリリース用に予約されています。

LISTEN_PORT

このパラメータは、将来のリリース用に予約されています。

ENABLE_DB_HINTS

SQL文とともにOracle Databaseに渡されるオプションのヒントを有効にします。データベースのヒントについては、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドで説明されています。

デフォルト値はYESです。

例: ENABLE_DB_HINTS = YES;

PREVENT_DIVIDE_BY_ZERO

ゼロによる除算が発生した場合の動作を制御します。

YESに設定すると、NULL値が戻されます。NOに設定すると、問合せが終了し、適切なエラーがユーザーに戻されます。

例: PREVENT_DIVIDE_BY_ZERO = YES;

CLUSTER_PARTICIPANT

この構成ファイルを使用しているOracle BIサーバーがOracle BIサーバー・クラスタのメンバーであるかどうかを指定します。

注意:

CLUSTER_PARTICIPANTパラメータは、NQSConfig.INIを編集して設定できます。

すべてのOracle Business Intelligenceデプロイメントは、それが単一ノード・デプロイメントである場合でも、クラスタ・コントローラを実行するように設計されています。この設計のため、常にCLUSTER_PARTICIPANTをYESに設定してください。

有効値はYESおよびNOです。デフォルト値はYESです。

クラスタ化された環境では、通常、リポジトリ公開ディレクトリを指定して、オンライン・モードでリポジトリに対して加えられた変更を伝播させます。リポジトリ公開ディレクトリの詳細は、REPOSITORY_PUBLISHING_DIRECTORYおよびREQUIRE_PUBLISHING_DIRECTORYを参照してください。

CLUSTER_PARTICIPANTがYESに設定されている場合、このサーバーには、次の場所に有効な構成済のClusterConfig.xmlファイルがある必要があります。

BI_DOMAIN/config/fmwconfig/biconfig/core

詳細は、「高可用を実現するOracle Business Intelligenceのデプロイ」のClusterConfig.xmlファイルに関する説明を参照してください。

例: CLUSTER_PARTICIPANT = YES;

REPOSITORY_PUBLISHING_DIRECTORY

クラスタ内のすべてのOracle BIサーバーが使用するリポジトリ公開ディレクトリを指定できます。

注意:

「RPD公開ディレクトリ」オプションを設定しないかぎり、このパラメータはNQSConfig.INIに表示されません。

パラメータCLUSTER_PARTICIPANTがYESに設定されている場合、REPOSITORY_PUBLISHING_DIRECTORYは、クラスタに参加しているすべてのOracle BIサーバーによって共有されるリポジトリ公開ディレクトリの場所を指定します。このパラメータには、デフォルト値はありません。

リポジトリがオンライン・モードで更新されると、この場所に公開されます。すべてのクラスタ化されたサーバーは、リポジトリが変更されているかどうかを起動時にこの場所で調べます。これは、オンライン・モードでリポジトリが更新されないと予測する場合でも、クラスタ内のすべてのサーバーがアクセスできる有効な場所である必要があります。

共有ファイル・システムにディレクトリを格納します。ディレクトリは有効な完全修飾ディレクトリ・パス名である必要があり、パス名は二重引用符( " )で囲まれている必要があります。UNCパス名およびマップされたネットワーク・ドライブは、サービスが修飾ユーザー・アカウントで実行する場合にのみ許可されます。リポジトリ公開ディレクトリの場所として、相対パス名、または(Oracle Business Intelligenceソフトウェアのインストール・ディレクトリにある)リポジトリのサブディレクトリを指定しないでください。

オンライン・リポジトリ変更のマスター・サーバーとして指定されているOracle BIサーバー(ClusterConfig.xmlファイルでMasterServerパラメータがtrueに設定されているサーバー)は、このディレクトリに対して読取り/書込みアクセス権を持っている必要があります。クラスタのOracle BIサーバー(ClusterConfig.xmlファイルで定義されているその他のサーバー)も、このディレクトリに対して読取り/書込みアクセス権を持っている必要があります。ドライブ・マッピングにおける相違に適応するために異なる名前が指定されている場合でも、すべてのエントリが実際に同じディレクトリを参照する必要があります。

例:

REPOSITORY_PUBLISHING_DIRECTORY = "z:\OracleBI\Publish";

REPOSITORY_PUBLISHING_DIRECTORY = "\\ClusterSrv\Publish";

REQUIRE_PUBLISHING_DIRECTORY

Oracle BIサーバーのリポジトリ公開ディレクトリを指定できます。

パラメータCLUSTER_PARTICIPANTがYESに設定されている場合、REQUIRE_PUBLISHING_DIRECTORYは、このOracle BIサーバーが起動してクラスタを結合するために、(パラメータREPOSITORY_PUBLISHING_DIRECTORYで指定された)リポジトリ公開ディレクトリが使用可能である必要があることを指定します。

このパラメータは、デフォルトでコメント・アウトされています。

YESに設定すると、起動時に公開ディレクトリが使用可能でない場合、またはサーバーによるディレクトリ内のファイルの読取り中にエラーが発生した場合、nqserver.logファイルにエラー・メッセージが記録され、サーバーが停止します。

公開ディレクトリが使用可能でない場合でもOracle BIサーバーが起動してクラスタを結合できるようにするには、この値をNOに設定します。NOに設定すると、サーバーがクラスタを結合し、nqserver.logファイルに警告メッセージが記録されます。オンラインでのリポジトリ更新は、(Oracle Business Intelligenceソフトウェアのインストール・ディレクトリにある)サーバーのRepositoryディレクトリには反映されません。このため、リクエストの失敗、間違った回答、およびその他の問題が生じる可能性があります。ただし、これは、オンラインでのリポジトリ編集が頻繁に行われず、いくつかのサーバーに古いリポジトリがある場合でもクラスタを機能させることが目的である場合には有用です。

例: REQUIRE_PUBLISHING_DIRECTORY = YES;

DISCONNECTED

このパラメータは非推奨であり、使用していません。

AUTOMATIC_RESTART

障害後にOracle BIサーバーを自動的に再起動するかどうかを指定します。

自動再起動は、Oracle BIサーバー・プラットフォームにのみ適用され、クラスタ化されたOracle BIサーバー環境には適用されません。デフォルト値はYESです。

例: AUTOMATIC_RESTART = YES;

VARIABLE_VALUE_LIMIT

変数を特定の長さに切り捨てることができます。

クライアント・ツールでNQSGetSessionValues()関数をコールしたときに返されるセッション変数値の最大長を指定します。

例: VARIABLE_VALUE LIMIT= 10;

たとえば、VARIABLE_VALUE_LIMITが10に設定されており、NQSGetSessionValues()関数が値「1234567890ABCDE」の変数についてコールされたとします。この場合、値は「1234567890」に切り捨てられます。

EVALUATE_SUPPORT_LEVEL

データベース関数EVALUATE、EVALUATE_ANALYTIC、EVALUATE_AGGRおよびEVALUATE_PREDICATEをユーザーが発行できるかどうかを指定します。

EVALUATE*関数の詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドのデータベース関数に関する項を参照してください。

デフォルトでは、このパラメータは0に設定されます。つまり、EVALUATE関数ファミリに対するすべてのサポートは無効になります。oracle.bi.server.manageRepositories権限を持つユーザーがEVALUATE関数を発行できるようにするには、このパラメータを1に設定します。すべてのユーザーがEVALUATE関数を発行できるようにするには、このパラメータを2に設定します。

次の点に注意してください。

- EVALUATE_SUPPORT_LEVELパラメータにより、分析内でのデータベース関数のEVALUATEファミリの使用を制御します。分析内でこれらの関数を使用しないように、EVALUATE_SUPPORT_LEVELはデフォルト値の0の設定のままにしておくことをお薦めします。EVALUATE_SUPPORT_LEVELの値を1または2に設定すると、ユーザーは分析エディタを使用して任意のSQL式を分析に挿入できるようになります。そうすることで、データ・アクセスのセキュリティが危険にさらされることがあります。

- EVALUATE_SUPPORT_LEVELパラメータでは、メタデータ・リポジトリ内のデータベース関数のEVALUATEファミリの使用を制御しません。

例: EVALUATE_SUPPORT_LEVEL = 1;

FMW_SECURITY_SERVICE_URL

Oracle BIサーバーがOracle Fusion Middlewareセキュリティ・サービスを特定できるように、Oracle WebLogic Serverが実行している場所を指定します。

例: FMW_SECURITY_SERVICE_URL = "http://localhost:9704";

FMW_SECURITY_SERVICE_MAX_NUMBER_OF_CONNECTIONS

多すぎる接続によってOracle WebLogic Serverが過負荷にならないように、Oracle BIサーバーからOracle Fusion Middlewareセキュリティ・サービスへの接続の数を制限します。変更しないでください。

例: FMW_SECURITY_SERVICE_MAX_NUMBER_OF_CONNECTIONS = 2000;

FMW_SECURITY_SERVICE_MAX_NUMBER_OF_RETRIES

Oracle Fusion Middlewareセキュリティ・サービスへの接続の最大試行回数を指定します。

例: FMW_SECURITY_SERVICE_MAX_NUMBER_OF_RETRIES = 0;

ENABLE_NUMERIC_DATA_TYPE

Oracle DatabaseおよびTimesTenから、DOUBLE (デフォルト)またはNUMERIC(こちらのほうが高精度になります)として、10進/数値データをインポートするかどうかを指定します。

このパラメータをYESに設定すると、Oracle DatabaseおよびTimesTenデータソースに対する数値サポートが有効になります。Oracle DatabaseおよびTimesTenからOracle BIリポジトリにインポートされたデータは、10進/数値データがNUMERICに設定され、ユーザーが入力した10進/数値SQLコードはNUMERICとして処理されます。この設定を変更する前にインポートされた物理列のデータ型はそのまま維持されます。

Oracle BIサーバーにより実行される問合せでこの構成を利用するには、物理レイヤー・データベース・オブジェクトでNUMERIC_SUPPORTEDデータベース機能を有効にします。『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のデータ・ソースでサポートされるSQL機能の指定に関する項を参照してください。

他のデータベース・タイプからの10進/数値データは、このパラメータがYESに設定されていても、依然としてDOUBLEとしてマップされることに注意してください。また、NUMBERではなくDOUBLEとして宣言されているOracle DatabaseまたはTimesTen内の列は、このパラメータの設定に関係なく、DOUBLEとしてOracle Business Intelligenceにインポートされます。

次の点に注意してください。

- 数値データ型は、他の数字データ型との間で互いにキャストすることができます。

- 数値データ型のサポートは、Oracle BIサーバーのJDBCドライバを通した場合は使用できません。

- 数値データ型を有効にするとパフォーマンスのオーバーヘッドが生じることがありますが、これは数値データのほうがビット数が多いためです。

例: ENABLE_NUMERIC_DATA_TYPE = NO;

ENDECA_SERVLET_URL

このパラメータは、将来のリリース用に予約されています。

例: ENDECA_SERVLET_URL = "http://localhost:9500/EndecaIntegration/EndecaServlet"

高可用性パラメータ

高可用性セクションのパラメータは、高可用性構成でのデフォルトおよび制限の使用を定義します。

HA_DB_PING_PERIOD_MILLISECS

高可用性を実現するためにBIサーバーによって実行される、すべてのTimesTenデータベースの連続した2つのポーリング間の間隔(ミリ秒)を指定します。

このポーリングによってOracle BIサーバーは非アクティブなTimesTenスキーマを判断し、Oracle BIサーバーで問合せに使用するTimesTen集計表を選択できます。

例: HA_DB_PING_PERIOD_MILLISECS = 60000;

Dynamic Libraryセクションのパラメータ

このセクションには、ダイナミック・リンク・ライブラリ(DLL)ごとに1つのエントリ、またはWindowsシステムとUNIXシステムの両方でOracle BIサーバーへの接続に使用される共有オブジェクトのセットが含まれています。

構文: logical_name = dynamic_library;

この構文では:

- logical_name: ダイナミック・リンク・ライブラリの論理名。これらの論理名は、「接続プール」ダイアログにも表示されます。

- dynamic_library: 関連付けられている動的ライブラリの名前。これらのライブラリは、次の場所にあります。
ORACLE_HOME/bi/bifoundation/server/bin

注意:

このセクションは、Oracleサポート・サービスから指示がないかぎり、変更しないでください。

このリリースに用意されているダイナミック・リンク・ライブラリは、次のとおりです。

- ODBC200 = nqsdbgatewayodbc;

- ODBC350 = nqsdbgatewayodbc35;

- OCI8 = nqsdbgatewayoci8;

- OCI8i = nqsdbgatewayoci8i;

- OCI10g  = nqsdbgatewayoci10g;

- DB2CLI = nqsdbgatewaydb2cli;

- DB2CLI35 = nqsdbgatewaydb2cli35;

- NQSXML = nqsdbgatewayxml;

- XMLA = nqsdbgatewayxmla;

- BAPI = nqsdbgatewaysapbapi;

- ESSBASE = nqsdbgatewayessbasecapi;

- OracleADF = nqsdbgatewayoracleadf;

- OracleADF_HTTP = nqsdbgatewayoracleadf;

- OracleCEP_HTTP = nqsdbgatewayoraclecep;

- HyperionADM = nqsdbgatewayadm;

- OracleWS = nqsdbgatewayoraclews;

- hadoop = nqsdbgatewayhadoop;

- timesten = nqsdbgatewaytimesten;

- timesten35 = nqsdbgatewaytimesten35;

- JAVADS = nqsdbgatewayjava

- CSV = nqsdbgatewaycsv

Usage Trackingセクションのパラメータ

使用状況トラッキングのパラメータは、Oracle BIサーバーに送信される各論理問合せの使用状況トラッキング統計の収集に対するデフォルト値を定義します。

次の表に、使用状況トラッキング表およびスタンドアロンの使用状況トラッキング・リポジトリに追加される列の名前と説明を示します。

名前

データ型

説明

注意

SAW_DASHBOARD_PG

Varchar(150)

Oracle BIプレゼンテーション・サービス・ダッシュボード内のページ

ダッシュボード・リクエストでない場合はNullです。

PRESENTATION_NAME

Varchar(128)

Oracle BIプレゼンテーション・サービスのプレゼンテーション・カタログの名前

なし

ERROR_TEXT

Varchar(250)

バックエンド・データベースからの、キャッシュ・エントリを生成しない問合せに対するエラー・フラグと理由テキスト

SUCCESS_FLGがゼロでない場合にのみ適用可能です。複数のメッセージを連結します。アプリケーションは、列の内容を解析する必要があります。

RUNAS_USER_NAME

Varchar(128)

偽装ユーザー(問合せを実行したプロキシ・ユーザー)

リクエストが偽装ユーザーとして実行されていない場合はNullです。

使用状況トラッキングの詳細は、「使用状況トラッキングの管理」を参照してください。

ENABLE

使用状況トラッキング統計の収集を有効または無効にします。

注意:

新しい(アップグレードしたものではない)インストールの場合、[USAGE_TRACKING]セクションのENABLEパラメータをNQSConfig.INIを手動で編集して変更できます

「使用状況トラッキングの管理」を参照してください。

有効値はYESおよびNOです。デフォルト値はNOです。NOに設定すると、統計は累積されません。YESに設定すると、統計は各論理問合せに対して累積されます。

例: ENABLE = NO ;

DIRECT_INSERT

統計がデータベース表に直接挿入されるか、ローカル・ファイルに書き込まれるかを指定します。

注意:

新しい(アップグレードしたものではない)インストールの場合、DIRECT_INSERTパラメータをNQSConfig.INIを編集して変更できます。

「使用状況トラッキングの管理」を参照してください。

- DIRECT_INSERTをNOに設定すると、データはフラット・ファイルに書き込まれます。

- DIRECT_INSERTをYESに設定すると、データは表に挿入されます。

注意:

このパラメータは、使用状況トラッキング・パラメータENABLEがYESに設定されている場合にのみ機能します。

データベース表への直接挿入が推奨されるため、デフォルト値はYESです。

DIRECT_INSERTがYESまたはNOのいずれに設定されているかに応じて、いくつかの他のパラメータが有効になります。これらのパラメータについては、次の表に概要を示し、次の各項で説明します。

DIRECT_INSERT設定

使用されるパラメータ

パラメータ設定

NO

STORAGE_DIRECTORY

"full_directory_path"

NO

CHECKPOINT_INTERVAL_MINUTES

5

NO

FILE_ROLLOVER_INTERVAL_MINUTES

30

NO

CODE_PAGE

"ANSI"

YES

PHYSICAL_TABLE_NAME

"Database"."Catalog"."Schema"."Table"または"Database"."Schema"."Table"

YES

CONNECTION_POOL

"Database"."Connection_Pool"

YES

BUFFER_SIZE

10 MB

YES

BUFFER_TIME_LIMIT_SECONDS

5

YES

NUM_INSERT_THREADS

5

YES

MAX_INSERTS_PER_TRANSACTION

1

YES

JOBQUEUE_SIZE_PER_INSERT_THREADPOOL_THREAD

100

YES

THROW_INSERT_WHEN_JOBQUEUE_FULL

NO

STORAGE_DIRECTORY

使用状況トラッキング・ログ・ファイルを格納するために使用されるディレクトリのフルパスを指定します。

指定するディレクトリは、有効で書込み可能な完全修飾ディレクトリ・パス名である必要があり、パス名は二重引用符( " )で囲む必要があります。マップされたディレクトリのみを指定します。

有効値は、既存の書込み可能なディレクトリへの任意の完全修飾パス名です。

パラメータSTORAGE_DIRECTORYは、パラメータDIRECT_INSERTがNOに設定されている場合にのみ有効です。

例: STORAGE_DIRECTORY = "C:\Temp\UsageTracking";

CHECKPOINT_INTERVAL_MINUTES

使用状況トラッキング・データがディスクにフラッシュされる頻度を指定します。

この間隔を大きい値に設定すると、サーバーが異常停止した場合に失われる可能性のあるデータの量が増加します。この間隔を小さい値に設定すると、追加のオーバーヘッドが生じます。

デフォルトは5分です。

注意:

間隔を0に設定すると、Oracle BIサーバーは、ディスクへの使用状況トラッキング・データの書込みを最小の試行間隔で試行します。これはサーバーのパフォーマンスに悪影響を及ぼすため、強くお薦めしません。

例: CHECKPOINT_INTERVAL_MINUTES = 5;

FILE_ROLLOVER_INTERVAL_MINUTES

現在の使用状況トラッキング・ログ・ファイルが閉じられ、新規ファイルが作成されるまでの時間を分単位で指定します。たとえば、このエントリを60分に設定すると、1日に24の使用状況トラッキング・ログ・ファイルが作成されます。

デフォルトは30分です。

チェックポイント間隔がロールオーバー間隔に等しい、またはそれより大きい場合、ロールオーバーのみが明示的に発生します。チェックポイントは、古い使用状況トラッキング・ログ・ファイルが閉じられるときにのみ、暗黙的に発生します。

注意:

チェックポイント間隔が0に設定されている場合、Oracle BIプレゼンテーション・サービスは最小の試行間隔で、現在の使用状況トラッキング・ログ・ファイルを閉じて新規ログ・ファイルを開こうとします。これはサーバーのパフォーマンスに悪影響を及ぼし、記憶域ディレクトリに多数の使用状況トラッキング・ログ・ファイルが作成されることになります。この間隔を0に設定することは、強くお薦めしません。

例: FILE_ROLLOVER_INTERVAL_MINUTES = 240;

CODE_PAGE

多言語リポジトリの場合、これは、ディスクへの統計の書込み時に使用される出力コード・ページのタイプを指定します。

有効値には、任意の有効なコード・ページ番号(1252など)、およびその他のグローバルに認識されている出力コード・ページ・タイプが含まれます。

デフォルト値はANSIです。このタイプは、使用されているデータベース・ローダーによって決まります。たとえば、Oracle DatabaseおよびDB2によって使用されるデータベース・ローダーに対して多言語リポジトリをサポートするには、UTF8を指定します。値は二重引用符で囲みます。USC-2は、現時点ではサポートされていません。

例: CODE_PAGE = "ANSI";

PHYSICAL_TABLE_NAME

問合せ統計に対応するレコードを挿入する表を指定します。表名は、管理ツールの物理レイヤーに表示されるものと同じ完全修飾名です。

注意:

新しい(アップグレードしたものではない)インストールの場合、PHYSICAL_TABLE_NAMEパラメータをNQSConfig.INIを編集して更新できます。

「使用状況トラッキングの管理」を参照してください。

このパラメータの一般構造は、使用されているデータベースのタイプによって決まります。

- SQL Serverの場合は、次の一般構造を使用します。
PHYSICAL_TABLE_NAME = "Database"."Catalog"."Schema"."Table";

例:

PHYSICAL_TABLE_NAME = "OracleBI Usage"."Catalog"."dbo"."S_NQ_ACCT";

上の例の構造は、次のようになります。

- "Oracle BI Usage"はデータベース・コンポーネントを表します。

- "Catalog"はカタログ・コンポーネントを表します。

- "dbo"はスキーマ・コンポーネントを表します。

- "S_NQ_ACCT"は表名を表します。

- Oracle Databaseの場合は、次の一般構造を使用します。
PHYSICAL_TABLE_NAME = "Database"."Schema"."Table";

例:

PHYSICAL_TABLE_NAME = "OracleBI Usage"."DEV_BIPLATFORM"."S_NQ_ACCT";

上の例の構造は、次のようになります。

- "Oracle BI Usage"はデータベース・コンポーネントを表します。

- "DEV_BIPLATFORM"はスキーマ・コンポーネントを表します。

- "S_NQ_ACCT"は表名を表します。

CONNECTION_POOL

使用状況トラッキング表にレコードを挿入するために使用される接続プールを指定します。

これは、管理ツールの物理レイヤーに表示されるものと同じ完全修飾名です。

例: CONNECTION_POOL = "OracleBI Usage"."Connection Pool";

注意:

新しい(アップグレードしたものではない)インストールの場合、CONNECTION_POOLパラメータをNQSConfig.INIを編集して変更できます。

「使用状況トラッキングの管理」を参照してください。

INIT_BLOCK_TABLE_NAME

初期化ブロック統計に対応するレコードを挿入する表を指定します。

表名は、管理ツールの物理レイヤーに表示されるものと同じ完全修飾名です。デフォルト表、S_NQ_INITBLOCKがRCUスキーマに定義されます。

例: INIT_BLOCK_TABLE_NAME = Database"."Catalog"."Schema"."Table";

INIT_BLOCK_CONNECTION_POOL

初期化ブロックの使用状況トラッキング表にレコードを挿入するために使用される接続プールを指定します。

接続プール名は、管理ツールの物理レイヤーに表示されるものと同じ完全修飾名です。

例: INIT_BLOCK_CONNECTION_POOL = Database"."Connection_Pool";

BUFFER_SIZE

INSERT文を一時的に格納するために使用されるメモリーの量を指定します。

バッファを使用すると、挿入される統計を生成した問合せとは関係なく、INSERT文を使用状況トラッキング表に発行できます。バッファが満杯になると、挿入スレッドによってバッファ・エントリが処理されるまで後続の問合せの統計は破棄されます。

KBまたはMB単位のサイズを指定するか、接尾辞なしの数値を入力してバイトを指定できます。

例: BUFFER_SIZE = 10 MB;

BUFFER_TIME_LIMIT_SECONDS

INSERT文が使用状況トラッキング表に発行される前にバッファに残されている最大時間を指定します。この時間制限により、Oracle BIプレゼンテーション・サービスは、長期にわたる静止中であっても迅速にINSERT文を発行できます。

例: BUFFER_TIME_LIMIT_SECONDS = 5;

NUM_INSERT_THREADS

INSERT文をバッファから削除して使用状況トラッキング表に発行するスレッドの数を指定します。このスレッド数は、接続プールに割り当てられているスレッドの合計数を超えない必要があります。

例: NUM_INSERT_THREADS = 5;

MAX_INSERTS_PER_TRANSACTION

使用状況トラッキング表に挿入されるときに単一トランザクションとしてグループ化されるレコードの数を指定します。ここでサポートされている、データベースの一括挿入APIを使用します。

この数を増やすと、パフォーマンスが多少改善されますが、データベースでのデッドロックによって挿入が拒否される可能性も高くなります。

例: MAX_INSERTS_PER_TRANSACTION = 1;

JOBQUEUE_SIZE_PER_INSERT_THREADPOOL_THREAD

スレッドのジョブ・キューに置かれる挿入ジョブの最大数を指定します。

例: JOBQUEUE_SIZE_PER_INSERT_THREADPOOL_THREAD = 100;

THROW_INSERT_WHEN_JOBQUEUE_FULL

ジョブを完了または実行するためにスレッド・ジョブ・キューに空きができるまで待機するようにシステムを構成できます。

ジョブを実行しているスレッドが停止してスレッド・ジョブ・キューが空になるまで待機する(NOに設定された場合)、または新しい挿入ジョブを拒絶する(YESに設定された場合)のどちらかを指定します。

例: THROW_INSERT_WHEN_JOBQUEUE_FULL = NO;

SUMMARY_STATISTICS_LOGGING

ロギング統計を有効または無効にできます。

注意:

新しい(アップグレードしたものではない)インストールの場合、SUMMARY_STATISTICS_LOGGINGパラメータをNQSConfig.INIを編集して変更できます。

『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のSummary Advisorのロギングの有効化に関する項を参照してください。

Oracle BI Summary Advisorのロギング統計の収集を有効または無効にするには、次のようにしてください。

- Summary Advisorのロギングを有効にするには、このパラメータをYESに設定します。

- 外部結合を含む論理問合せに対してのみSummary Advisorのロギングを有効にするには、このパラメータをLOG_OUTER_JOINT_QUERIES_ONLYに設定します。完全なSummary Advisorのロギングを有効にすることによる小さいパフォーマンスへの影響が問題となる場合は、このオプションを使用することを検討してください。

- Summary Advisorのロギングを無効にするには、このパラメータをNO (デフォルト)に設定します。

Oracle BI Summary Advisorの機能は、Oracle Business IntelligenceをOracle Exalytics Machineで実行している場合にのみ使用できます。

Summary Advisor機能の詳細は、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドのOracle BI Summary Advisorを使用した集計の問合せ候補の識別に関する項を参照してください。

例: SUMMARY_STATISTICS_LOGGING = YES;

SUMMARY_ADVISOR_TABLE_NAME

ロギング統計のレコードが格納される表を指定できます。

注意:

新しい(アップグレードしたものではない)インストールの場合、SUMMARY_ADVISOR_TABLE_NAMEパラメータをNQSConfig.INIを手動で編集して変更できます。

『Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のSummary Advisorのロギングの有効化に関する項を参照してください。

Oracle BI Summary Advisorのロギング統計に対応するレコードを挿入する表を指定します。表名は、管理ツールの物理レイヤーに表示されるものと同じ完全修飾名です。

例: SUMMARY_ADVISOR_TABLE_NAME = "Orcl"."DEV_BIPLATFORM".

"S_NQ_SUMMARY_ADVISOR"

Query Optimization Flagsセクションのパラメータ

Query Optimization Flagsセクションには、1つのパラメータがあります。

それは、特定の状況においてOracle BIサーバーの動作を上書きする特殊なパラメータです。

STRONG_DATETIME_TYPE_CHECKING

このパラメータを使用して、問合せに含まれている一部の日付/時間データ型の非互換性が拒否されないように、厳密なデータ型チェックを緩めます。

たとえば、"date/time op string-literal"という書式の問合せには、技術的に日付/時間データ型の非互換性が含まれており、通常はOracle BIサーバーによって拒否されます。

有効値はONおよびOFFです。デフォルト値はONで、この場合、厳密なデータ型チェックが有効になり、日付/時間データ型の非互換性を含む問合せが拒否されます。これが推奨設定です。

厳密なデータ型チェックを緩めるには、この値をNOに設定します。この場合でも、無効な問合せまたは重大な日付/時間の非互換性を含む問合せは拒否されます。また、リレーショナル・データベースに類似した厳密なデータ型チェックが実装されている場合などには、問合せが失敗する可能性があります。

例: STRONG_DATETIME_TYPE_CHECKING = ON;

MDX Member Name Cacheセクションのパラメータ

このセクションのパラメータは、一意の名前とリポジトリ内のすべてのSAP/BWキューブのメンバーのキャプション間をマップする、キャッシュ・サブシステムに関するものです。

ENABLE

このパラメータは、機能が有効かどうかを指定します。

これはSAP/BWキューブにのみ適用されるため、デフォルト値はNOです。

DATA_STORAGE_PATH

キャッシュが存続する場所のパス。これは、単一の場所にのみ適用されます。

エントリの最後にある数は、記憶域の容量を示しています。機能が有効な場合、文字列<full directory path>は有効なパスで置換される必要があります。

例: DATA_STORAGE_PATH = "C:\OracleBI\server\Data\Temp\Cache" 500 MB;

MAX_SIZE_PER_USER

各ユーザーがキャッシュ・エントリに使用できる最大ディスク領域。

例: MAX_SIZE_PER_USER = 100 MB;

MAX_MEMBER_PER_LEVEL

ディスクに存続できる、1レベルのメンバーの最大数。

例: MAX_MEMBER_PER_LEVEL = 1000;

MAX_CACHE_SIZE

個々のキャッシュ・エントリ・サイズの最大サイズ。

例: MAX_CACHE_SIZE = 100 MB;

Aggregate Persistenceセクションのパラメータ

Oracle Business Intelligenceでは、集計表とこれに対応するOracle Business Intelligenceメタデータ・マッピングの作成とロードを自動化する、集計の永続性機能が提供されます。

このセクションのパラメータは、集計の永続性機能の構成および使用に関連します。

AGGREGATE_PREFIX

集計の永続性のドメイン・サーバー名を指定します。

接頭辞は1 - 8文字の長さで、特殊文字が含まれていない必要があります('_'は使用可能です)。

例: AGGREGATE_PREFIX = "SA_";

AGGREGATE_THREAD_POOL_SIZE

集計の永続性のために起動されるスレッドの数を指定します。

各フェーズ内で、ロードのパフォーマンスを改善するためにリレーショナル・ロードが個別のスレッドで実行されます。デフォルト値は5です。

例: AGGREGATE_THREAD_POOL_SIZE = 5;

AGGREGATE_AW_NAME

ターゲットOracle Databaseで作成されるアナリティック・ワークスペース・オブジェクトの名前を指定します。

このコンテナで、集計AWキューブとディメンションが作成されます。

例: AGGREGATE_AW_NAME = "OBI_AW";

PREAGGREGATE_AW_CUBE

集計の永続性のためにシステムによって生成されたAWキューブを完全に解決するかどうかを指定します。

デフォルト値はYESです。YESに設定すると、記憶域の領域使用量が大幅に増加します。

例: PREAGGREGATE_AW_CUBE = YES;

SUPPORT_ANALYTICAL_WORKSPACE_TARGETS

Oracleアナリティック・ワークスペースで集計の永続性をサポートするかどうか指定します。

デフォルトはNOです。

例: SUPPORT_ANALYTICAL_WORKSPACE_TARGETS = NO;

JavaHostセクションのパラメータ

このセクションのパラメータは、JavaHostプロセスが実行されているコンピュータに関する情報を提供します。

JAVAHOST_HOSTNAME_OR_IP_ADDRESSES

このパラメータは、JavaHostの接続性に関する情報を提供します。デフォルト・ポート値は9810です。

注意:

JAVAHOST_HOSTNAME_OR_IP_ADDRESSパラメータは、NQSConfig.INIを編集して更新できます。

構文: JAVAHOST_HOSTNAME_OR_IP_ADDRESS = "host_name1:port1",host_name2:port2;

例: JAVAHOST_HOSTNAME_OR_IP_ADDRESS = "MYHOST:9810";

JAVAHOST_HOSTNAME_OR_IP_ADDRESSES_OVERRIDE

Oracle Business IntelligenceがWindows以外のプラットフォームにインストールされている場合に、Hyperion Financial Managementのデータソースに接続するためにJavaHostホスト名またはIPアドレスをオーバーライドするかどうかを指定します。

Hyperion Financial Managementには、Windowsプラットフォームに対してのみクライアント・ドライバが用意されています。Oracle Business Intelligenceのメイン・インスタンスがWindows以外のプラットフォームで稼働している場合でも、Hyperion Financial Managementにアクセスするには、Windowsコンピュータ上で稼働しているOracle Business IntelligenceのJavaHostプロセスが必要です。この場合、Hyperion Financial ManagementクライアントがインストールされているWindowsコンピュータ上で稼働しているJavaHostインスタンスを示すように、JAVAHOST_HOSTNAME_OR_IP_ADDRESSES_OVERRIDEパラメータを構成する必要があります。

構文: JAVAHOST_HOSTNAME_OR_IP_ADDRESS_OVERRIDE = "host_name1:port1",host_name2:port2;

例: JAVAHOST_HOSTNAME_OR_IP_ADDRESS_OVERRIDE = "MYHOST:9810";

Datamart Automationセクションのパラメータ

このセクションのパラメータは、将来のリリース用に予約されています。

ESSBASE_SERVER

このパラメータは、将来のリリース用に予約されています。

DMA_DATABASE

このパラメータは、将来のリリース用に予約されています。

B 拡張構成リファレンス

この付録では、分析、エージェント、ダッシュボードまたはOracle BIプレゼンテーション・カタログに固有でない、高度なインストール後の構成および管理手順について説明します。これらのOracle Business Intelligenceの各コンポーネントの構成方法は、前の各章で説明されています。ほとんどの管理者は、この付録で説明されている構成設定を変更する必要はありません。

この付録の内容は次のとおりです。

- プレゼンテーション・サービスに対する拡張構成の変更

- Oracle BIプレゼンテーション・サービスに対するJavaHostサービスの使用

プレゼンテーション・サービスに対する拡張構成の変更

Oracle BIサーバーのプロセスは、ほとんどのWebサーバーのビジネス・ロジックをホストし、ビジネス・インテリジェンス・データをWebクライアントに提示するためのフレームワークとインタフェースを提供します。

- Windowsの場合、プロセスはsawserver.exeです。

- UNIXの場合、プロセスはsawserverです。

instanceconfig.xmlファイルには、Oracle BIサーバーに影響を与える構成の設定が格納されています。多くの構成の設定はFusion Middleware Controlで使用でき、構成を変更するための優先方法です。特定の設定がFusion Middleware Controlで使用できない場合、instanceconfig.xmlファイルを使用してその設定を変更できます。instanceconfig.xmlファイルを使用して、デプロイメントを様々な面からカスタマイズできます。このファイルで直接変更するのは、Oracle BIプレゼンテーション・カタログの名前などのデフォルト要素を変更する場合、またはキャッシュ関連設定などの内部デフォルト設定をオーバーライドする場合のみです。

instanceconfig.xmlファイルには、デフォルトで、Oracle BIプレゼンテーション・カタログのパスやOracle BIサーバーにアクセスするためにプレゼンテーション・サービスによって使用されるOracle Business Intelligence Serverのデータソース名など、いくつかのエントリが含まれています。

注意:

以前にWindowsレジストリを変更して構成を変更したことがある場合は、その変更をinstanceconfig.xmlに移行します。WindowsレジストリのCommonキーの下にあるエントリは有効なままです。

次の手順は、ユーザーが実行できる一般的な構成の変更に関する情報を示しています。

1. 次のinstanceconfig.xmlファイルを開いて編集します。
BI_DOMAIN/config/fmwconfig/biconfig/OBIPS

2. 次の表で説明している要素を追加する必要があるセクションを見つけます。

3. 次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
<ClientStorage>
<Enabled>true</Enabled>
<LocalStorage>true</LocalStorage>
<SessionStorage>true</SessionStorage>
</ClientStorage>
<FavoritesSyncUpIdleSeconds>300</FavoritesSyncUpIdleSeconds>
<BIClientInstallerURL32Bit>http://myhost:7777/my32bitfile< /BIClientInstallerURL32Bit>
<BIClientInstallerURL64Bit>http://myhost:7777/my64bitfile< /BIClientInstallerURL64Bit>
<Security>
<AllowRememberPassword>false</AllowRememberPassword>
<CookieDomain>value</CookieDomain>
<CookiePath>/analytics</CookiePath>
<InIFrameRenderingMode>prohibit</InIFrameRenderingMode>

<Cursors>
<NewCursorWaitSeconds>3</NewCursorWaitSeconds>
</Cursors>

<LogonExpireMinutes>180</LogonExpireMinutes>
</Security>
<ODBC>
<UnaccessedRunningTimeoutMinutes>5</UnaccessedRunningTimeoutMinutes>
</ODBC>
<UI>
<MaxSearchResultItemsToReturn>300</MaxSearchResultItemsToReturn>

<UserPickerDialogMaxAccounts>300</UserPickerDialogMaxAccounts>
</UI>
</ServerInstance>

4. 変更内容を保存し、ファイルを閉じます。

5. Oracle Business Intelligenceを再起動します。

要素

説明

デフォルト値

AllowRememberPassword

ブラウザ固有のパスワード管理ソフトウェアを使用して、ブラウザでパスワードの保存を許可するかどうかを指定します。trueに設定すると、ユーザーは以降のサインインのためにパスワードを保存するかどうかを指定するよう求められます。

false

BIClientInstallerURL64Bit

ユーザーがOracle BI EEホーム・ページからOracle BIクライアント・インストーラをダウンロードすることを選択した場合に、Oracle BIクライアント・インストーラのデフォルトのダウンロード場所をオーバーライドすることを指定します。

64-ビット・インストーラのファイル名はbiee_client_install64.exeです。

デフォルト値なし

ClientStorage

クライアントの状態をセッション間およびセッション内で保持する親要素を指定します。Enabled、LocalStorageおよびSessionStorageの各要素も参照してください。

デフォルト値なし

CookieDomain

ブラウザに送信されるCookieのドメイン情報を指定します。

デフォルト値なし

CookiePath

Cookieが適用されるドメイン・パスを指定します。

/analytics

Enabled

クライアントの状態を、セッションを横断してまたはそのセッション内で保持するかどうかを指定します。状態がブラウザ・セッションを横断して保持されることはありません。次の項目について状態が保持されます。

- 「ダッシュボード」メニュー - メニューが開いているか、または閉じているかを保持します。

- フォルダ - 「カタログ」ページおよび「開く」ダイアログでフォルダが開いているかどうかを保持します。

- 「お気に入り」メニュー - 最後に開いたアイテムの名前を格納します。

- カタログ・ページのツールバー - ツールバーの状態について各種詳細を保持します。「タイプ」、「ソート」および「詳細の表示」などのオプションの設定があります。

LocalStorageおよびSessionStorage要素も参照してください。

true

FavoritesSyncUpIdleSeconds

モバイル・アプリケーションのデータとOracle BIプレゼンテーション・カタログのお気に入りを同期するまでのアイドル時間の秒数を指定します。

300

InIFrameRenderingMode

詳細は、「Oracle BI EEのページの攻撃からの保護」を参照してください。

sameDomainOnly

LocalStorage

ブラウザのローカル・ストレージを使用して状態を保持するかどうかを指定します。ブラウザがローカル・ストレージをサポートしていない場合、状態は保持されません。

true

LogonExpireMinutes

非アクティブ・ユーザーが自動的にログオフされるまでの時間(分)を指定します。

180

MaxSearchResultItemsToReturn

プレゼンテーション・サービスでカタログを一覧表示するディレクトリに表示される項目の最大数を指定します。最小値は0です。ユーザー・インタフェースのパフォーマンスが低下する可能性があるため、この要素に高い値を設定する際は注意してください。

300

NewCursorWaitSeconds

ブラウザに検索ページを戻す前に、初期リクエストに対する結果をサーバーが待機する期間を指定します。問合せの大部分が1秒で戻されない場合、大きい値(3秒など)を設定してページ・リフレッシュを回避するのに便利です。

デフォルト値なし

UserPickerDialogMaxAccounts

プレゼンテーション・サービスでカタログを一覧表示するディレクトリ内の左ピッカーに表示される項目の最大数を指定します。たとえば、項目が300を超えるカタログ・フォルダでは、この値を300より大きくしないかぎり、すべての項目を表示できません。最小値は0です。ユーザー・インタフェースのパフォーマンスが低下する可能性があるため、この要素に高い値を設定する際は注意してください。

300

SessionStorage

ブラウザのローカル・ストレージを使用してセッションの状態を保持するかどうかを指定します。ブラウザがローカル・ストレージをサポートしていない場合、状態は保持されません。

true

UnaccessedRunningTimeoutMinutes

未アクセスの分析が取り消されるまでの経過時間を分単位で指定します。未アクセスの分析とは、この設定で指定された時間(分)の間、アクセスされていない分析です。最小値は2です。

この要素は、ユーザーが分析の編集中に、少なくとも一時的に分析の編集を中断して別の場所を参照している場合に対処します。ただし、ユーザーが分析の編集に戻る可能性があるため、この値を小さく設定しすぎないようにしてください。

この要素は、BIサーバーに対して実行されるプレゼンテーション・サービスの問合せにのみ使用します。この要素は、その他のタイプの接続には適用されません。

5

Oracle BI EEのページの攻撃からの保護

管理者は、クリックジャッキングと呼ばれるセキュリティ上の問題を認識しておく必要があります。クリックジャッキングとは、攻撃者がクリックを悪用し、JavaScriptの使用に関係なくフレーム化できるWebページに被害者のクリックを送信する技法です。

たとえば、攻撃者がOracle Business Intelligence Consoleアプリケーションに対してインライン・フレームを使用するWebサイトを開発したとします。このサイトを訪問したユーザーは、気付かないうちにインライン・フレーム上のConsoleアプリケーションのボタンをクリックしています。攻撃者は、他のOracle Business Intelligenceアプリケーションに適用される同一生成元ポリシーの原則によって阻止されないため、この脆弱性は非常に重大です。クリックジャッキングの多数の例を示す文書は、World Wide Webで見つけることができます。

攻撃者によってアプリケーションがインライン・フレームにフレーム化されないようにすることを、フレーム・バスティングと言います。フレーム・バスティングに影響する設定を行うには、instanceconfig.xmlファイルでInIFrameRenderingMode要素を使用します。この要素は、次の3つの値に設定できます。

- prohibit: Oracle BIプレゼンテーション・サービスのコンテンツがインライン・フレームにレンダリングされることを許可しません。

- sameDomainOnly: (デフォルト)包含されるページが同じドメインのサーバーによって生成されたものである場合は、そのページのインライン・フレームへのレンダリングを可能にします。デフォルトでは、同じサーバーによって生成されたページには、同じドメインが指定されます。同一生成元ポリシーに関する情報は、World Wide Webを参照してください。

- allow: Oracle BIプレゼンテーション・サービスのコンテンツがインライン・フレームにレンダリングされることを許可します。

Oracle BIプレゼンテーション・サービスに対するJavaHostサービスの使用

Javaライブラリの機能はJavaHostサービスを使用して実現できます。

JavaHostサービスは、プレゼンテーション・サービスがJavaライブラリに用意されている機能を使用して、次のコンポーネントをサポートできるようにします。

- グラフの生成

- SVGレンダラ(Apache Batik)

- Javaアクションが必要なアクション(たとえば、Webサービスの呼出しなど)

- PDFへのプリントおよびMicrosoft ExcelおよびPowerPointへのエクスポート

- 拡張レポート

- URL接続(別のコンポーネントへのHTTPリクエストの発行)

- インテグレーション・サービス・コール(Oracle BIサーバーがJavaコードの実行のために使用)

注意:
JavaHostサービスはBI Publisherのコア・ライブラリを使用して、分析の内容を、PDF、Microsoft ExcelとPowerPoint、イメージなどの様々な形式にエクスポートします。BI PublisherのライブラリはJavaHostサービス内に埋め込まれており、J2EEコンテナにデプロイされているまたは実行されているBI Publisherに依存しません。
JavaHostサービスの構成ファイルでは、BI Publisherのライブラリに関連する要素は、XMLP要素内にあります。

JavaHostサービスを構成するには、BI_DOMAIN/config/fmwconfig/biconfig/OBIJHディレクトリにある構成ファイル(config.xml)でサービスの構成要素を手動で編集します。各要素の説明は、次の表を参照してください。要素は、JavaHost要素で始まる相対パスによって識別されます。

InputStreamLimitInKBなどの共通のサブ要素は、MessageProcessor、ListenerまたはSSLローダーには適用されません。

要素

説明

Loaders

ListOfEnabledLoaders要素とLoader要素が含まれます。これらの要素は、JavaHostサービスに対してコンポーネントを指定します。Loadersセクションでこれらの要素を編集することは避けてください。

Loaders/ListOfEnabledLoaders

有効にするコンポーネント(Oracle BIスケジューラおよびBI Publisherなど)のリストを指定します。

この要素がファイルから欠落している場合、すべてのローダーが有効になります。この要素に空の値が指定されている場合は、すべてのローダーが無効になります。

各コンポーネントには対応するLoader要素があります。ここにリストされているコンポーネントの名前は、対応するLoader/Name要素に指定されている名前と一致している必要があります。

Loaders/Loader

次の要素が含まれます。これらは、特定のコンポーネントの構成情報を指定します。

- 名前

- Class

- ConfigNodePath

- ClassPath

Loaders/Loader/Name

コンポーネントの一意の名前を指定します。この名前は、ListOfEnabledLoaders要素で使用します。

Loaders/Loader/Class

コンポーネントのメイン・クラスを指定します。

Loaders/Loader/ConfigNodePath

Loaderの構成情報のXPath(JavaHost要素から始まる)を指定します。

Loaders/Loader/ClassPath

JavaHostサービスによって使用されるライブラリのJARファイルに対するパスを指定します。

InputStreamLimitInKB

JavaHostに送信されるリクエストの最大入力サイズをKB単位で指定する、各ローダーに共通のサブ要素。値ゼロは、この制限を無効にします。最大サイズを超えると、エラー・メッセージが表示されます。

デフォルト: 8192

注意: InputStreamLimitInKB値を、テストの場合のみゼロに設定します(値は無制限です)。値を高く構成すると、JavaHostに対する個別のリクエストに必要なリソースよりも多くのリソースを割り当てるまたは消費するため、JavaHostが不安定になり、クラッシュが発生します。構成をすべてのJavaHostリクエストのコンテキストに適合させる必要があります(たとえば、グラフやエクスポート操作など)。この要素は、大規模なデータセットを正常に処理する適切な値に設定してください。デフォルト値は8192 (8MB)ですが、増分で16384 (16MB)、32768 (32MB)などの値に変更してください。

RequestResponseLogDirectory

リクエストのレスポンス・ファイルのディレクトリ名を指定する、各ローダーに共通のサブ要素。

デフォルト: デフォルトの一時ディレクトリ

LogLargeRequests

大きいリクエストの処理時にレスポンス・ファイルを作成するかどうかを指定する、各ローダーに共通のサブ要素。

デフォルト: true

ReadRequestBeforeProcessing

ファイルが完全に読み取られるまでリクエストの処理を待機するかどうかを指定する、各ローダーに共通のサブ要素。

組織でOracle BI EEのエクスポート機能を使用する場合は、このサブ要素をfalseに設定することをお薦めします。falseに設定すると、データは最初にファイルに保存されるのではなく、JavaHostに徐々にストリームされて処理されるため、エクスポート・パフォーマンスが向上します。

デフォルト: true

LargeRequestThresholdInKB

リクエストにディスク領域を使用する前の最大サイズをKB単位で指定する、各ローダーに共通のサブ要素。このサイズより大きいリクエストの場合、リクエストされたデータのキャッシュには、メモリーではなくディスク領域が使用されます。この値が大きくなるほど、JavaHostサービスによって使用される可能性のあるメモリーの量も増え、リクエストの処理速度が速くなります。また、この設定によってLogLargeRequests要素のしきい値も設定されます。

デフォルト: 200

MessageProcessor

SocketTimeout要素が含まれます。

MessageProcessor/SocketTimeout

ソケットのアイドル・タイムアウト(ミリ秒単位)を指定します。この時間を経過すると、ソケットがアイドル・ソケット・プールに返されます。JavaHostはソケット・プーリング・メカニズムを使用して、単一スレッド内のすべてのアイドル・ソケット・セットで新規データを待機します。アイドル・プール内の初期メッセージは、Java NIOチャネル経由で処理されます。

デフォルト: 5000 (5秒)

Listener

次の要素が含まれます。

- PermittedClientList

- ポート

- Address

- Secure

Listener/PermittedClientList

JavaHostが受信接続を許可するIPアドレスおよびホスト名のリストを指定します。各クライアントのIPアドレスまたはホスト名は、カンマで区切ります。すべてのクライアント接続を許可するには、この要素をアスタリスク(*)に設定します。

デフォルト: *

Listener/Port

JavaHostのTCP/IPリスニング・ポートを識別します。

デフォルト: 9810

Listener/Address

JavaHostがバインドするネットワーク・インタフェースを指定します。この要素に値が指定されていない場合、JavaHostは使用可能なすべてのネットワーク・インタフェースにバインドします。

Listener/Secure

JavaHostサービスに対してSSL暗号化を有効にするかどうかを指定します。

- Yes: SSL暗号化を有効にします。

- No: SSL暗号化を無効にします。

デフォルト: No

SSLの詳細は、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドを参照してください。

Batik

InputStreamLimitInKBなどの共通のサブ要素のみが含まれています。これは、それらがラスター化されたイメージ形式へのSVGイメージの変換に関連するためです。

Scheduler

次の要素が含まれます。

- Enabled

- DefaultUserJarFilePath

- DefaultTempFilePath

- DefaultPurgingPeriod

Scheduler/Enabled

Javaジョブを実行するためにJavaHostサービスとOracle BIスケジューラの相互作用を有効にするかどうかを指定します。

- true: Oracle BIスケジューラとの相互作用を有効にします。

- false: Oracle BIスケジューラとの相互作用を無効にします。

デフォルト: false

Scheduler/DefaultUserJarFilePath

Java拡張機能ユーティリティ用のJARファイルを格納するデフォルト・ディレクトリを指定します。Jarファイルには、実行されるJavaクラスの実装が含まれています。

Oracle BIスケジューラが有効な場合、この要素は必須で、単一パスを受け入れます。

Scheduler/DefaultTempFilePath

Oracle BIスケジューラ・リクエスト用の一時ファイルを格納するデフォルト・ディレクトリを指定します。

デフォルト: システムの一時ディレクトリ

Scheduler/DefaultPurgingPeriod

Oracle BIスケジューラ・リクエストが失敗したジョブを削除するまでのデフォルト期間(秒単位)を指定します。

デフォルト: 300

XMLP

InputStreamLimitInKBおよびReadRequestBeforeProcessingなどの共通のサブ要素のみが含まれています。これは、それらがOracle BI Publisherに関連するためです。

URLConnect

SSLに関連する要素が含まれています。これらの要素は変更しないでください。

DVT

デフォルトでは、グラフ生成に関連する共通のInputStreamLimitInKBサブ要素のみが含まれています。必要に応じて、他の共通のサブ要素を追加できます。

C ユーザー・インタフェース・ラベルと構成ファイルの要素のマッピング

この付録では、Oracle Business Intelligence用のFusion Middleware Controlユーザー・インタフェース(UI)ラベルと、構成ファイル内で使用されている対応する要素名をマップします。

次の各表の情報は、完全な情報を提供する目的でここに記載されています。この情報は、ほとんどの操作には必要ありません。

注意

- 次の各表に含まれていないOracle BIサーバーの要素の詳細は、「構成ファイル設定」を参照してください。

- 構成ファイルの場所の詳細は、「構成ファイル」を参照してください。

Fusion Middleware Control UIラベル

構成要素

構成ファイル(BIサーバーの場合はNQSConfig.INI、プレゼンテーション・サービスの場合はinstanceconfig.xml)

関連情報

キャッシュ有効

ENABLE

NQSConfig.INI

問合せキャッシングを有効または無効にするためのFusion Middleware Controlの使用

最大キャッシュ・エントリ・サイズ

MAX_CACHE_ENTRY_SIZE

NQSConfig.INI

問合せキャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

最大キャッシュ・エントリ

MAX_CACHE_ENTRIES

NQSConfig.INI

問合せキャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

グローバル・キャッシュ・パス

GLOBAL_CACHE_STORAGE_PATH

NQSConfig.INI

グローバル・キャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

グローバル・キャッシュ・サイズ

GLOBAL_CACHE_STORAGE_PATH

NQSConfig.INI

グローバル・キャッシュ・パラメータを設定するためのFusion Middleware Controlの使用

RPD更新を許可しない

READ_ONLY_MODE

NQSConfig.INI

RPD更新を禁止するためのFusion Middleware Controlの使用

ユーザー・セッションの失効

ClientSessionExpireMinutes

instanceconfig.xml

ユーザー・セッションのログオフ期間を設定するためのFusion Middleware Controlの使用

表ビューのレンダリング時に処理された最大行数

ResultRowLimit

instanceconfig.xml

表をレンダリングするために処理する最大行数を設定するためのFusion Middleware Controlの使用

最大ダウンロード行数

DefaultRowsDisplayedInDownload

instanceconfig.xml

表およびピボット・テーブルのデータに対する構成オプションを設定するためのFusion Middleware Controlの使用

1ページ当たりに含める最大行数

DefaultRowsDisplayedInDelivery

instanceconfig.xml

表およびピボット・テーブルのデータに対する構成オプションを設定するためのFusion Middleware Controlの使用

診断ログの構成ファイル(logconfig.xmlなど)の詳細は、次を参照してください。

- 診断ログ構成ファイルの概要とその位置

- ログ・ファイル・メッセージのカテゴリとレベルの概要

- ログ・ファイル・ローテーション

Fusion Middleware Control UIラベル名

構成要素

構成ファイル

関連情報

ページ・タブの表示

ShowPageTabsAlways

instanceconfig.xml

Fusion Middleware Controlを使用したプレゼンテーション設定のデフォルトの変更

セクション見出しの表示

ShowSectionHeadingsDefault

instanceconfig.xml

Fusion Middleware Controlを使用したプレゼンテーション設定のデフォルトの変更

ダッシュボードのセクションを閉じられるようにする

CollapsibleSectionsDefault

instanceconfig.xml

Fusion Middleware Controlを使用したプレゼンテーション設定のデフォルトの変更

ピボット・テーブルで自動プレビューを表示

DisableAutoPreview

instanceconfig.xml

Fusion Middleware Controlを使用したプレゼンテーション設定のデフォルトの変更

Fusion Middleware Control UIラベル

構成要素

構成ファイル(BIスケジューラ)

関連情報

SMTPサーバー

SMTP_Server

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

ポート

SMTP_Port

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

送信者の表示名

From

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

送信者の電子メール・アドレス

Sender

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

ユーザー名

mail.server

oracle.bi.enterprise資格証明マップにある資格証明

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド

パスワード

前の行の「ユーザー名」を参照

該当なし

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

パスワードの確認

前の行の「ユーザー名」を参照

該当なし

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

失敗時の再試行回数

Try

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

最大受信者数

MaxRecipients

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

アドレッシング方式

UseBcc

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

メール・サーバーへの接続にSSLを使用

UseSSL

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

CA証明書ソースの指定

これは、SmtpCACertificateDirまたはSmtpCACertificateFileのいずれに入力するかを制御します。

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

CA証明書ディレクトリ

SmtpCACertificateDir

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

CA証明書ファイル

SmtpCACertificateFile

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

SSL証明書検証の深さ

SmtpCertificateVerificationDepth

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

SSL暗号リスト

SmtpCipherList

instanceconfig.xml

エージェントに影響するOracle BIスケジューラの電子メール設定のFusion Middleware Controlを使用した構成

Fusion Middleware Control UIラベル

構成要素

構成ファイル

関連情報

最大ファイル・サイズ

maxFileSizeKb

instanceconfig.xml(プレゼンテーション・サービスおよびBIスケジューラ)

logging_config.xml(JavaHost)

ccslogging.xml (Cluster Controller用)

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

ログの最長保存期間

MaximumLogAgeDay

instanceconfig.xml(プレゼンテーション・サービスおよびスケジューラ)

logging_config.xml(JavaHost)

ccslogging.xml (Cluster Controller用)

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

最大ファイル・サイズ

注意: 「問合せログ」リージョンのフィールド

MaximumFileSizeKb

logconfig.xml (プレゼンテーション・サービス用)

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

ログの最長保存期間

注意: 「問合せログ」リージョンのフィールド

MaximumLogAgeDay

logconfig.xml (プレゼンテーション・サービス用)

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

インシデント・エラー

IncidentError

instanceconfig.xml(プレゼンテーション・サービスおよびスケジューラ)

logging_config.xml(JavaHost)

ccslogging.xml (Cluster Controller用)

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

エラー

エラー

instanceconfig.xml(プレゼンテーション・サービスおよびスケジューラ)

logging_config.xml(JavaHost)

ccslogging.xml (Cluster Controller用)

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

警告

警告

instanceconfig.xml(プレゼンテーション・サービスおよびスケジューラ)

logging_config.xml(JavaHost)

ccslogging.xml (Cluster Controller用)

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

通知

通知

instanceconfig.xml(プレゼンテーション・サービスおよびスケジューラ)

logging_config.xml(JavaHost)

ccslogging.xml (Cluster Controller用)

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

トレース

トレース

instanceconfig.xml(プレゼンテーション・サービスおよびスケジューラ)

logging_config.xml(JavaHost)

ccslogging.xml (Cluster Controller用)

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

Fusion Middleware Control UIラベル

構成要素

構成ファイル

関連情報

SSOの有効化

EnabledSchemas(間接的に関連)

instanceconfig.xml

Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド

SSOプロバイダ

EnabledSchemas(間接的に関連)

instanceconfig.xml

Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド

D BI固有のWLSTコマンド・リファレンス

この付録では、BI固有のWLSTコマンドを示します。

WLSTの詳細は、「WebLogic Scripting Tool (WLST)の使用」を参照してください。

次のコマンドはBIコンポーネントを管理するためのコマンドです。すべてのコンポーネント・コマンドには、DOMAIN_HOME、マシン名およびオプションのポート指定を使用します。

コマンド

説明

createOBICCSComponent(domainHome, machine, port=None, portMonitor=None)

このコマンドは、新しいクラスタ・コンポーネントを作成します。

createOBISCHComponent(domainHome, machine, port=None, portMonitor=None,portScript=None)

このコマンドは、新しいスケジューラ・コンポーネントを作成します。

createOBIPSComponent(domainHome, machine, port=None)

このコマンドは、新しいBI Presentation Serverコンポーネントを作成します。

createOBIJHComponent(domainHome, machine, port=None)

このコマンドは、新しいJavaHostコンポーネントを作成します

listBISystemComponents(domainHome)

このコマンドは、ドメインのすべてのシステム・コンポーネントのリストを返します。

getBISystemComponents(domainHome, instanceId)

このコマンドは、指定されたinstanceIDを使用してシステム・コンポーネントの詳細を表示します。

deleteBISystemComponent(domainHome, instanceId)

このコマンドは、指定されたinstanceIDを使用してシステム・コンポーネントを削除します。

次のコマンドはドメイン・サービス・インスタンスを管理します。

コマンド

説明

listBIServiceInstances

このコマンドは、BIドメインのすべてのサービス・インスタンス・キーを示します。

getBIServiceInstance

このコマンドは、特定のサービス・インスタンス・キーのサービス・インスタンスの詳細を取得します。

scaleOutBIServiceInstance

このコマンドは、新しいコンピュータにサービス・インスタンスをスケールアウトし、サービス・インスタンスがBIドメイン内の指定されたコンピュータで使用できることを確認します。このコマンドは、拡張した場合のみ使用されます。

exportServiceInstance

このコマンドは、BARファイル形式でサービス・インスタンスを特定のエクスポート・ディレクトリにエクスポートします。

importServiceInstance

このコマンドは、カスタマイズとしてすでにエクスポートされたバー(サービス・インスタンス)を特定の環境にインポートします。

refreshServiceInstance

このコマンドは、BIドメインから継承されるサービス・インスタンスのサービス・キーの一部の側面をリフレッシュします。たとえば、新しい製品がBIドメインに追加される場合(たとえば、Calculation Managerテンプレートがドメイン作成後にデプロイされる場合)、サービス・インスタンスがリフレッシュされる際にその製品の権限セットがそのサービス・インスタンスにのみ使用できます。

refreshDomainServiceInstances

このコマンドは、ドメインのすべてのサービス・インスタンスをリフレッシュします。各サービス・インスタンスのrefreshServiceInstanceのコールと同等です。

resetServiceInstance

このコマンドは、特定のサービス・インスタンスを空の状態にリセットします。空のBARファイルのインポートと同等です。

sync_midtier_dbコマンドは、中間層データベースの接続の詳細を同期します。

コマンド

説明

sync_midtier_db.sh|cmd

このコマンドは、中間層データベースの接続詳細を同期し、接続詳細(資格証明を含む)の変更時にBIコンポーネントが中間層データベースにアクセスできることを確認します。

コマンドの位置:

DOMAIN_HOME/bitools/bin/sync_midtier_db.sh|cmd

サポートされている中間層データベース・タイプは、DB2、SQLServer、MSSQLおよびOracleです

UNIXの場合、これをマスター・ホストで実行する必要があります。

Windowsの場合、これを各ホストで実行する必要があります。

サポートされている中間層データソースはRCUによって作成される必要があり、管理が次のコンポーネントIDに制限されます。

BIPLATFORM — 検証は行われません。同期する前にWeblogic管理コンソールまたはWLSTでデータソース接続プールを更新した後に接続を検証する必要があります。

中間層データベース接続詳細を同期するには:

1. 次の同期スクリプトを実行します。

DOMAIN_HOME/bitools/bin/sync_midtier_db.sh|cmd

2. スクリプトには、更新されたデータソースが表示されます。

3. 管理対象サーバーおよびBIシステム・コンポーネントを再起動します。

たとえば、DOMAIN_HOME/bitools/bin/で、次を入力します。

./start.sh

Oracle BI EEマシンをクローニングおよび削除するコマンド:

- cloneBIMachine(domainHome, listenAddress,baseMachine=None, baseServer='bi_server1', machineName=None)

- deleteBIMachine(domainHome, machine)

Oracleの法律上の注意点

コピーライト

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

Pre-General Availability (一般提供前)版のドキュメントについて

このドキュメントがPre-General Availability (一般提供前)版の場合:

このドキュメントはPre-General Availability (一般提供前)版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のPre-General Availability (一般提供前)版のドキュメントについて

このドキュメントが非公開のPre-General Availability (一般提供前)版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のPre-General Availability Trial Agreement (Pre-GAトライアル契約)のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle Partner Network Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティ

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。