Oracle® Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド 12c (12.2.1.2.0) E82973-02 |
|
前へ |
次へ |
Oracle Database Metadata GeneratorとDB2 Cube Views Generatorは、Oracle BIサーバーからSQLアクセス・アドバイザまたはIBM DB2データベースへのメタデータのインポートに必要なファイルを作成します。
ここでは、2つのジェネレータに共通する次の項目について説明します。
Oracle Database Metadata GeneratorおよびDB2 Cube Views Generatorは、コマンドラインから起動されるか、バッチ・ファイルに埋め込まれています。
コマンドラインの実行可能ファイルは、sametaexport
と呼ばれます。
sametaexport
ユーティリティは、WindowsシステムとUNIXシステムの両方で使用できます。ただし、sametaexport
は、RPD形式のバイナリ・リポジトリでのみ使用できます。
sametaexport
ユーティリティの場所は、次のとおりです。
ORACLE_HOME/bi/bifoundation/server/bin
sametaexport -r "PathAndRepositoryFileName" [-p repository_password]
-f "InputFileNameAndPath" [options]
この表は、コマンドライン実行可能ファイルのパラメータを示しています。
パラメータ | 説明 | 追加情報 |
---|---|---|
-r |
リポジトリ・ファイル名とフルパス |
ファイル・パスが長い形式の場合または空白が含まれる場合のみ、ファイル名とパスに引用符が必要です。ファイルが現行ディレクトリにない場合は、フルパスを使用します。 |
-p |
リポジトリ・パスワード |
特定のリポジトリのパスワード。 パスワード引数はオプションです。パスワード引数を指定しない場合は、コマンド実行時にパスワードを入力するように求められます。セキュリティ侵害のリスクを最小限にとどめるために、パスワード引数をコマンドラインやスクリプトで指定しないことをお薦めします。パスワード引数のサポートは下位互換性の保持を目的としており、将来のリリースでは削除される予定です。スクリプト上の理由から、標準入力によってパスワードを指定できます。 |
-f |
入力ファイル名とフルパス |
ファイル・パスが長い形式の場合または空白が含まれる場合のみ、ファイル名とパスに引用符が必要です。ファイルが現行ディレクトリにない場合は、フルパスを使用します。入力ファイルは、コマンドラインに必要な情報のすべてを入力しないで済むように、また国際文字を入力できるように指定します。「メタデータ入力ファイルについて」を参照してください。 |
入力ファイルまたはコマンドラインで追加パラメータを組み込むことによって、Oracle Database Metadata GeneratorまたはDB2 Cube Views Generatorの様々なデフォルトを変更できます。入力ファイルで指定したパラメータは、コマンドラインで指定したパラメータより優先されます。これらのパラメータの組込みは、デフォルト値を変更する必要がある場合のみに限定してください。
この表は、これらのオプション・パラメータを示しています。
パラメータ定義 | 追加情報 | 入力ファイルの使用例 | コマンドラインの使用例 |
---|---|---|---|
RPDのスキーマ名の使用 |
|
USE_SCHEMA_NAME_FROM_RPD = NO |
-schemafrom rpd NO |
デフォルト・スキーマ名 |
|
DEFAULT_SCHEMA_NAME = ORACLE |
-defaultschema ORACLE |
Oracleスキーマ名 |
Oracle Database Metadata Generatorからのメタデータはこのスキーマで作成されます。デフォルト値は |
ORA_DIM_SCHEMA_NAME = ORACLE |
-orclschema ORACLE |
ロギング有効 |
メタデータ・エクスポート・プロセスのログを保持するかどうかを指定します。有効値は |
LOGGING = DEBUG |
-logging DEBUG |
ログ・ファイル名 |
ログ・ファイルへのパス。無効なパスを指定すると、エラーが発生します。 このパラメータを指定しない場合は、デフォルトのログ・ファイルのパスが使用されます。デフォルトのパスは次のとおりです。 ORACLE_INSTANCE\diagnostics\logs\ OracleBIServerComponent\ coreapplication_obisn\ OraDimExp.log |
|
|
パラメータ定義 | 追加情報 | 入力ファイルの使用例 | コマンドラインの使用例 |
---|---|---|---|
個別カウントのサポート |
|
DISTINCT_COUNT_SUPPORTED = YES |
-distinct YES |
統計関数のサポート |
|
STATISTICAL_FUNCTIONS_SUPPORTED = YES |
-stat YES |
スキーマ名の使用 |
|
USE_SCHEMA_NAME = NO |
-useschema NO |
RPDのスキーマ名の使用 |
|
USE_SCHEMA_NAME_FROM_RPD = NO |
-schemafromrpd NO |
デフォルト・スキーマ名 |
|
DEFAULT_SCHEMA_NAME = ORACLE |
-defaultschema ORACLE |
キューブ・ビュー・スキーマ名 |
Cube Viewsメタデータが作成されるスキーマの名前。デフォルト値は |
CUBE_VIEWS_SCHEMA_NAME = ORACLE |
-cubeschema ORACLE |
ログ・ファイル名 |
ログ・ファイルへのパス。無効なパスを指定すると、エラーが発生します。 このパラメータを指定しない場合は、デフォルトのログ・ファイルのパスが使用されます。デフォルトのパスは次のとおりです。 ORACLE_INSTANCE\diagnostics\logs\ OracleBIServerComponent\ coreapplication_obisn\ CubeViews.log |
LOG_FILE_NAME = C:\bea_default\instances\instance1\diagnostics\logs\generator\logfile.log |
-logfile C:\bea_default\instances\instance1\diagnostics\logs\generator\logfile.log |
失敗のログ記録 |
|
LOG_FAILURES = NO |
-logfail NO |
成功のログ記録 |
|
LOG_SUCCESS = YES |
-logsuccess YES |
この表は、メタデータ入力ファイルのパラメータを示しています。
入力ファイルは、次の表に示すパラメータが記載されたテキスト・ファイルです。
入力ファイル名 | 説明 |
---|---|
BUSINESS_MODEL |
エクスポート対象のメタデータが格納されたOracle BIリポジトリの論理レイヤーにあるビジネス・モデル名。リポジトリでビジネス・モデルが見つからない場合はエラー・メッセージが表示されます。 入力ファイルではビジネス・モデル名を1つだけ指定できます。複数のビジネス・モデルのメタデータを生成するには、入力ファイルを個別に作成して、Oracle Database Metadata GeneratorまたはDB2 Cube Views Generatorを別途実行します。 |
PHYSICAL_DATABASE |
エクスポート対象のメタデータが格納されたOracle BIリポジトリの物理レイヤーにあるデータベースの名前。ビジネス・モデルが複数のデータベースから導出されている場合は、ここで指定されたデータベース以外のすべてのデータベースのメタデータが排除されます。リポジトリで物理データベースが見つからない場合は、エラー・メッセージが表示されます。 |
RUN_AS_USER |
データベース・ユーザーのユーザー名です。メタデータ・エクスポート時にはこのユーザーの表示モードを複製する必要があります。このパラメータは空白にできません。このユーザーはリポジトリ内のユーザー・リファレンスに存在している必要があります。 |
OUTPUT_FOLDER |
SQLファイルが格納されているフォルダの完全パスとファイル名を指定します。Oracle Database Metadata Generatorの実行時にこのフォルダが存在しない場合は、このプロセスで作成されます。「出力ファイルについて」を参照してください。 |
次のテキストはメタデータ入力ファイルのサンプルを示しています。
BUSINESS_MODEL = "1 - Sample App" PHYSICAL_DATABASE = "1 - Sample App Data" RUN_AS_USER = "Administrator" OUTPUT_FOLDER = "C:\OracleBI"
ジェネレータごとに、異なるタイプの出力ファイルが作成されます。
次のリストは、出力ファイルを示しています。
Oracle Database Metadata Generatorは、UTF-8でエンコードされ、指定された出力フォルダに格納されるSQLファイルを作成します。ファイル名は、入力ファイルで指定したmy_business_model.sqlなどのビジネス・モデルの名前をベースにします。
DB2 Cube Views Generatorは、指定された出力フォルダに次のファイルを生成します。
XMLファイル(UTF8でエンコード)。指定されたビジネス・モデルに対してXMLファイルが1つ作成されます。このファイルにはキューブに変換されたオブジェクトが格納されます。リポジトリ内のオブジェクトがIBM Cube Viewsメタデータの類似オブジェクトにマッピングされます。変換されないオブジェクトのリストについては、「IBM DB2データベースの変換ルール」を参照してください。
XMLファイルの名前は、ビジネス・モデル名から空白を抜いてXML拡張子を付けたものになります(例: SalesResults.xml
)。
別名生成DLLが格納されたSQLファイル。ビジネス・モデルで参照される物理レイヤー・データベースに別名が存在する場合にのみ、指定したビジネス・モデルにSQLファイルが作成されます。別名ファイルには、DB2データベースで別名を作成するSQLコマンドが格納されます。SQLファイルの名前は、ビジネス・モデル名から空白を抜いてSQL拡張子を付けたものになります(例: SalesResults‐alias.sql
)。
エラー・メッセージは、ジェネレータがタスクの一部またはすべてを完了できなかったことを示します。
ジェネレータの起動後に次のエラー・メッセージが表示されることがあります。
ログ・ファイル :
log_file_name
。
入力ファイルまたはコマンドラインで指定したログ・ファイルのパスに誤りがある、ユーザーに当該のフォルダに対する書込み権限がない、ディスクの空き容量が不足しているなどの可能性があります。
run_as_user
user_name
は無効です。
ユーザー名が正しくありません。
リポジトリ
repository_name.rpd
は無効であるか、破損しています。
リポジトリ名が正しくない、指定のパスに存在しない、ユーザーに読取り権限がないなどの可能性があります。
物理データベース
database_name
は無効です。
物理データベース名が、リポジトリの有効な物理データベース・オブジェクトと一致していません。
ビジネス・モデル
model_name
は無効です。
ビジネス・モデル名が、リポジトリの有効なビジネス・モデル・オブジェクトと一致していません。
指定した認証情報は無効です。
コマンドラインで指定したリポジトリ・パスワードが正しくありません。
パス: "
path_name
"は無効です。
パスまたはファイル名が正しくないか、現在のユーザーに読取りアクセス権がありません。
ジェネレータは、出力ファイルを作成するときにOracle BIリポジトリのメタデータ・オブジェクトのOracle DatabaseまたはIBM DB2データベースの類似オブジェクトへのマッピングも行います。
ここでは、SQLまたはXML形式に翻訳(変換)できないOracle Business Intelligenceメタデータの識別に使用されるルールについて説明します。Oracle Business Intelligenceで使用可能なメタデータ構成の中に、Oracle DatabaseおよびIBM Cube Viewsではサポートされないものがあるために、このようなルールが必要になります。
SQLまたはXMLファイルのディメンション・メタデータは、論理ファクト表のソース・レベルで生成されます。論理ファクト表のソースに無効な論理ディメンション表ソースが存在する場合、その論理ディメンション表ソースは無効化されます。論理ファクト表ソースが無効の場合は、マッピングされているすべての論理ディメンション表ソースも無効化されます。無効なOracle Business Intelligenceリポジトリ・メタデータ要素は、SQLまたはXMLファイルのキューブに変換されません。
ルール違反が発生した場合、ジェネレータではログ・ファイルにエラー・メッセージとルールに違反したメタデータが書き込まれます。
Oracle BIメタデータをオブジェクトに変換するためのルールについて学習します。
Oracle Business IntelligenceメタデータからOracle Databaseのオブジェクトへの変換ルールは次のとおりです。
論理表の式を含む属性はエクスポートできません。
復合結合を使用して結合された表は考慮されません。
不透明なビューである表は考慮されません。
特定のレベルのキーの構成部分として使用される列を別のレベルのキーの構成部分として使用することはできません。
Oracle Databaseでは、列を複数のレベルのキーとして使用することが禁じられています。この禁止により、Oracle Database Metadata Generatorでは、2つの結合のいずれかを削除する必要があります。通常は最初に検出された結合が削除されます。このため、その他の結合が失われ、エクスポートされないことになります。
Oracle BIリポジトリ・メタデータ要素の検証に使用するルールおよびその他の情報について学習します。
次の表は、Oracle BIリポジトリ・メタデータ要素の検証に使用されるルール、ルール違反の発生時にログ・ファイルに書き込まれるエラー・メッセージ、ルール違反の原因に関する説明を示しています。エラー・メッセージは、特定のOracle Business Intelligenceメタデータ・オブジェクトがXMLファイルにエクスポートされなかった原因の判定に有益です。
ルール | メッセージ | 説明 |
---|---|---|
ComplexJoinFactsRule |
[ファクト論理表ソース]複合物理結合はサポートされていません。 %qnには、物理表%qnおよび%qnの間に複合結合%qnがあります。 |
物理ファクト表が復合結合を介して接続されている場合、その結合はサポートされません。復合結合は外部キー関係がない2つの表間の結合と定義されます。 |
ComplexJoinDimsRule |
[ディメンション論理表ソース]複合物理結合はサポートされていません。 %qnには、物理表%qnおよび%qnの間に複合結合%qnがあります。 |
ディメンション物理表が複合結合を介して接続されている場合、その結合はサポートされません。 |
ComplexJoinFactDimRule |
[ファクト論理表ソース->ディメンション論理表ソース]複合物理結合はサポートされていません。 %qnには、物理表%qnおよび%qnの間に複合結合%qnがあります。 |
ディメンション物理表とファクト物理表が複合結合を介して接続されている場合、その結合はサポートされず、ディメンション表が無効化されます。 |
OpaqueViewFactRule |
[ファクト論理表ソース]物理SQL Select文はサポートされていません。 %qnはSQL Select文%qnを使用しています。 |
SQL SELECT文によって物理ファクト表が生成されている場合、その表を含む論理ファクト表ソースは無効化されます。この論理ファクト表ソースに接続されている論理ディメンション表ソースもすべて無効化されます。この構成は副問合せ処理を許容するものです。 |
OpaqueViewDimRule |
[ディメンション論理表ソース]物理SQL Select文はサポートされていません。 %qnはSQL Select文%qnを使用しています。 |
SQL SELECT文によって物理ディメンション表が生成されている場合、その表を含む論理ディメンション表ソースは無効化されます。 |
OuterJoinFactRule |
[ファクト論理表ソース]物理外部結合はサポートされていません。 %qnには、物理表%qnおよび%qnの間に外部結合%qnがあります。 |
論理ファクト表ソースに外部結合のマッピングがある場合、その論理ファクト表ソースが無効化され、このソースにマッピングされた論理ディメンション表ソースもすべて無効化されます。 |
OuterJoinDimRule |
[ディメンション論理表ソース]物理外部結合はサポートされていません。 %qnには、物理表%qnおよび%qnの間に外部結合%qnがあります。 |
論理ディメンション表ソースに外部結合のマッピングがある場合、その論理ディメンション表ソースは無効化されます。 |
WhereClauseFactRule |
[ファクト論理表ソース] WHERE句はサポートされていません。 %qnにwhere条件%sがあります。 |
ファクト表ソースでロードするデータのフィルタに |
WhereClauseDimRule |
[ディメンション論理表ソース] WHERE句はサポートされていません。 %qnにwhere条件%sがあります。 |
ディメンション表ソースでロードするデータのフィルタに |
TwoJoinFactDimRule |
[ファクト論理表ソース->ディメンション論理表ソース]ソース間の複数の結合はサポートされていません。 %qnおよび%qnには少なくとも次の結合があります : %qn、%qn |
同じディメンション・ソースからの2つのディメンション表に、同一の物理ファクト表がマッピングされている場合(ファクト表が表ソース内で最も詳細度の高い表に排他的にマッピングされていない場合)、そのディメンション表ソースは無効化されます。 |
HiddenManyManyRule |
[ファクト論理表ソース->ディメンション論理表ソース](物理または論理?)ファクトおよびディメンション間の結合が最も詳細な表にありません。 %qnおよび%qn間の%qnが最も詳細な表%qnにありません{結合名,ファクト表,ディメンション表) |
これは、TwoJoinFactDimRuleに関連します。ファクト表がディメンション表に結合され、その表が表ソース内で最も詳細な表ではない場合、そのディメンション表ソースは無効化されます。 |
ComplexMeasureRule |
[列]複合集計ルールはサポートされていません。 %qnに使用されている集計ルール%sはサポートされていません。 |
サポートされる集計は通常、 |
CountDistMeasureRule |
[列] COUNT-DISTINCT集計ルールはサポートされていません。 %qnに使用されている集計ルール%sはサポートされていません。 |
|
InvalidColumnLevelRule |
[レベル]プライマリ・レベル・キーを構成する一部の列が無効です。 %qnに主キーの一部として%qnが含まれていますが、%qnが既に無効になっています。 |
このレベルのレベル・キーの1つ以上の列が無効になっています。 |
VariableBasedColumnRule |
[論理表ソース -> 列]列で式に変数が使用されています。 列%qnでそのマッピングに変数が使用されています。 |
論理列でリポジトリと式に含まれるセッション変数が使用されています。 |
OneFactToManyDimRule |
[ファクト論理表ソース->ディメンション論理表ソース](論理またはファクト?)およびディメンションの最も詳細な表間に固有の結合パスが必要です。 %qnおよび%qn(どちらも物理表名)の間に結合パスが見つかりません。 少なくとも、次の結合パスが見つかりました: (%qn->%qn....), (%qn->%qn....) |
TwoJoinFactDimRuleおよびHiddenManyManyRuleの場合と同様です。 |
ManyMDTinFactRule |
[ファクト論理表ソース]ファクト論理表ソースには固有の最も詳細な表が必要です。 %qnには少なくとも次の最も詳細な表が含まれています : %qn,%qn. |
ファクトに複数の最も詳細な表が存在しています。 |
NoMeasureFactRule |
[ファクト論理表ソース]ファクト論理表ソースにメジャーがありません。 %qnに配布可能なメジャーがありません。 |
すべてのメジャーが無効化されているため、ファクト表にメジャーがありません。 |
NoInActiveFactRule |
[ファクト論理表ソース]ファクト論理表ソースが有効になっていません。 |
ファクト・ソースが有効ではありません。 |
NoInActiveDimRule |
[ディメンション論理表ソース]ディメンション論理表ソースが有効になっていません。 |
ディメンション・ソースが有効ではありません。 |
NoAttributeInFactRule |
[ファクト論理表ソース->列]ファクトで属性が見つかりました。 ファクト・ソース%qnの%qnには集計ルールがありません。 |
ファクト・ソースに属性がありません。 |
NoMeasureInDimRule |
[ディメンション論理表ソース -> 列]ディメンション内にメジャーが見つかりました。 ディメンション・ソース%qnの%qnに集計ルールがあります。 |
ディメンション・ソースにメジャーがありません。 |
VisibleColumnsAttrRule |
[列] -> run_as_userにはこの論理列を参照できません。 %qnは参照ルールにより、run_as_user %qnからアクセスできません。 |
このユーザーにはこの列を参照する権限がありません。 |
VisibleColumnsMeasRule |
[列] -> run_as_userにはこの論理列を参照できません。 %qnは参照ルールにより、run_as_user %qnからアクセスできません。 |
このユーザーにはこの列を参照する権限がありません。 |
MultiplePrimaryKeysDimRule |
[ディメンション論理表ソース]結合にディメンション論理表ソースの代替キーが使用されています。 %qnの%qnおよび%qn間の%qnに代替キー%qnが使用されています。 |
ディメンション物理表に組み込むことができる主キーは1つのみです。別の一意のキーを使用して別のディメンション物理表に結合されている結合は無効です。 IBM Cube Viewsでは、外部結合に使用される一意のキーが受け入れられず、常に主キーが要求されます。 |
MultiplePrimaryKeysFactRule |
[ディメンション論理表ソース]結合にディメンション論理表ソースの代替キーが使用されています。 %qnの%qnおよび%qn間の%qnに代替キー%qnが使用されています。 |
ファクト物理表に組み込むことができる主キーは1つのみです。別の一意のキーを使用して別のファクト物理表に結合されている結合は無効です。 IBM Cube Viewsでは、外部結合に使用される一意のキーが受け入れられず、常に主キーが要求されます。 |
MultiplePrimaryKeysFactDimRule |
[ファクト論理表ソース->ディメンション論理表ソース]結合で論理表ソース間に代替キーが使用されています。 ソース%qnおよび%qnの%qnと%qnの間で%qnに代替キー%qnが使用されています。 |
ファクト物理表に組み込むことができる主キーは1つのみです。別の一意のキーを使用してディメンション物理表に結合されている結合は無効です。 IBM Cube Viewsでは、外部結合に使用される一意のキーが受け入れられず、常に主キーが要求されます。 |
NotDB2ExpressionAttrRule |
[ディメンション論理表ソース -> 列]列にサポートされていない式が含まれています。 %qnにサポートされていない式%sが含まれています。 |
IBM Cube Viewsでサポートされない式が属性に含まれています。 これには、日時関数(例: |
NotDB2ExpressionMeasRule |
[ファクト論理表ソース -> 列]列にサポートされていない式が含まれています。 %qnにサポートされていない式%sが含まれています。 |
IBM Cube Viewsでサポートされない式がメジャーに含まれています。 これには、日時関数を使用するメタデータ式が含まれています。例: |
NoAttributeDimRule |
[ディメンション論理表ソース]ディメンション論理表ソース内にrun_as_userから参照できる属性がありません。 %qnのいずれの属性も参照可能でないため、ユーザー%qnは問合せを実行できません。 |
ディメンションに属性がありません。 |