整合性のチェックの使用

機械翻訳について

整合性のチェックの使用

このトピックでは、整合性チェックおよび詳細チェック機能を使用して、セマンティック・モデルでエラーおよび警告をチェックする方法について説明します。

トピック:

整合性のチェックについて

整合性のチェック機能を使用して、セマンティック・モデル・オブジェクトまたはセマンティック・モデル全体を検証します。整合性のチェックは、実行時に問合せ生成が失敗する原因となる問題を特定し、修正するのに役立ちます。

整合性のチェックでは、次のタイプのメッセージが示されます:

「エラー」 - これらのメッセージには、修正する必要があるエラーが示されます。メッセージ内の情報を使用して不整合を修正し、「整合性のチェック」を再度実行して、エラーを修正したことを確認します。
警告 - これらのメッセージは、修正が必要になる可能性のある状況を示しています。たとえば、論理階層レベルの欠落した表示キーに関する警告メッセージなどです。他のメッセージとしては、整合性のない値や、デフォルトと一致しない機能表の変更の警告などがあります。

エラーおよび警告メッセージの例については、「一般的な整合性チェック・メッセージ」を参照してください。

整合性チェックの結果はタブに表示され、レポートにリストされているオブジェクトについて理解、ナビゲートおよび修正するために使用できる情報が含まれています。各エラーまたは警告は、名前とオブジェクト・タイプ(論理表や初期化ブロックなど)で識別されます。

整合性チェックの結果では、名前、エラー・メッセージ番号などでリスト内のオブジェクトを検索できます。また、操作するすべてのセマンティック・モデルについて、リストから特定の警告を非表示にすることもできます。「整合性チェック結果での警告の非表示」を参照してください。

consistency_checker_hide_warn.pngの説明は以下のとおりです

図consistency_checker_hide_warn.pngの説明

整合性チェックに合格しても、セマンティック・モデルが正しく作成されていることは保証されませんが、多くの一般的な問題が除去されます。

整合性チェックでは、接続を使用しているメタデータの外部にあるオブジェクトの妥当性はチェックされません。メタデータの整合性のみをチェックし、メタデータ外部にある物理オブジェクトへのマッピングはチェックしません。接続が機能していない場合やデータベースでオブジェクトが削除されていた場合、整合性チェックでは、これらのエラーは報告されません。

参照表を使用して、多言語スキーマでローカライズされたフィールド名を保存している場合、その参照表に対しては整合性チェックのルールが緩和されます。

Oracle Analyticsのアップグレード後にセマンティック・モデルの整合性をチェックすると、以前の整合性チェックには含まれていなかったエラーが表示される場合があります。

セマンティック・モデルの整合性チェックのタイプ

実行できる整合性チェックには、整合性のチェックと詳細チェックの2つがあります。

整合性のチェック

整合性のチェックでは、個々のセマンティック・オブジェクトおよび他のオブジェクトとの関係を調べ、特定の種類のエラーおよび不整合を検出します。個々のオブジェクト、選択したオブジェクトのグループまたはセマンティック・モデル全体に対して整合性のチェックを実行できます。詳細チェックを実行する前に、整合性のチェックを実行してすべてのエラーを解決します。

整合性のチェックの実行例を次に示します:

論理ソースが構成されていない論理表を検索します。
物理ソースにマップされていない論理列を検索します。
未定義の論理結合条件を確認します。
ビジネス・モデルで参照されている物理表が、ビジネス・モデルで参照されている他の表に結合されていないかどうかを判別します。
各ビジネス・モデルに対応するサブジェクト領域があるかどうかを確認します。

セマンティック・モデルの開発中には、オブジェクトおよびモデル全体に対して整合性のチェックを実行し、エラーを検出および修正することをお薦めします。セマンティック・モデルの整合性のチェックを参照してください。

詳細チェック

セマンティック・モデルをデプロイする前に、詳細チェックを実行します。

セマンティック・モデルを正常にデプロイするには、詳細チェックに合格する必要があります。ただし、移行の問題をトラブルシューティングするために、セマンティック・モデルが詳細チェックに合格する必要はありません。整合性のチェックのみに合格したセマンティック・モデルを.rpdファイルに変換できますが、問合せ生成を妨げる問題が含まれている可能性があることに注意してください。

詳細チェックでは、次の処理が実行されます:

整合性のチェックを実行して、モデル全体をチェックします。セマンティック・モデラーで詳細チェックを実行するには、整合性チェックをエラーなしにする必要があります。

詳細チェックで整合性のチェックが実行され、エラーが見つかった場合は、整合性のチェックのエラーのみが表示されます。整合性のチェックのすべてのエラーが解決されるまで、詳細チェックのエラーは検出も表示もされません。
セマンティック・モデルをSMMLから.rpdファイルに変換し、.rpdに対して詳細チェックを実行します。モデルに整合性のチェックのエラーが含まれている場合、詳細チェックではSMMLからa.rpdファイルへの変換ができず、詳細チェックを実行できません。
問合せ生成のナビゲーション・スペース・エラーがあるシナリオを検索します。

一般的な整合性チェック・メッセージ

このトピックは、整合性チェックの最も一般的な警告およびエラーのいくつを理解および修正するために役立ちます。

このトピックでは、整合性のチェックのメッセージの部分的なリストを示します。可能性のあるすべての警告およびエラーについて説明しているわけではありません。

エラーまたは警告の例	エラーまたは警告	詳細
[14031] 論理表FACT_TABLE_NAMEのソースの索引フィルタは、複数のディメンションを参照します。	エラー	論理表に、複数のディメンションを参照するWHERE句フィルタを含む論理表ソースがあることを示します。複数のディメンションを含むWHERE句は無効です。
[38126] 'Logical Table' '"Technology - WFA"."Fact WFA WO "'の名前の先頭または末尾にスペースがあります。	エラー	オブジェクト名の先頭または末尾にスペースがあります。オブジェクト名の先頭にスペースがあると、問合せまたはレポートで問題が発生する場合があります。
[38012] 論理列DIM_Start_Date.YEAR_QUARTER_NBRには物理データ型のマッピングがなく、派生列でもありません。 [38001] 論理列DIM_Start_Date.YEAR_QUARTER_NBRに物理データ・ソースのマッピングが含まれていません。	エラー	論理列がどの論理表ソースにもマップされていないことを示します。これらのマッピングは無効であり、問合せは失敗します。どちらの検証ルールも、同じ問題に関連しています。
[39062] レポート問合せに使用されている接続プール'"My_DB". "My_CP"'が初期化ブロック'Authorization'で使用されています。これは問合せのパフォーマンスに影響する場合があります。	警告	同じ接続プールが問合せと初期化ブロックの両方に使用されていることを示しています。この構成はお薦めしません。この問題を修正するには、初期化ブロックに専用の接続プールを作成します。そうしないと、問合せのパフォーマンスが低下したり、認証の初期化ブロックを実行できない場合に、ユーザー・ログインの応答が停止する可能性があります。
[39028] データベース'MyDB'の機能がデフォルトと一致しません。この結果、問合せ問題が発生する可能性があります。	警告	一部のデータベース機能のデフォルトがOracle Analyticsのこのリリースで変更されたことを示します。機能セットに特定のカスタマイズがなければ、データベース機能を新しいデフォルトにリセットすることをお薦めします。
[39003] 列DIM_Offer_End_Date.CREATE_DTの機能依存結合が見つかりません。	警告	特定の列が無効な論理表ソースにのみマップされていることを示します。この警告では、デフォルトの動作を使用するかどうかを決定するよう求められます。
[39059] 論理ディメンション表MY_DIMのレベルDailyに、上位レベルのファクト・ソースMY_FACT_SUM.MTHLY_SUMと結合するソースMY_DIM_DAILYがあります	警告	ファクト論理表ソースにこのディメンションで設定された集計グレインがありますが、このディメンションの論理表ソースに接続する結合が見つからなかったか、無効な結合が見つかりました。これは、結合が存在しないか、存在しているが高レベルのファクト・ソースと低レベル次元ソースを接続しているため、潜在的に不正であることを意味します。このような結合は、実行すると問合せ結果でダブル・カウントが発生する可能性があるため、潜在的に不正です。たとえば、「Select year, yearlySales」という問合せについて考えます。 monthTable表とyearlySales表との間にyearIdでの結合が存在していても、この結合により結果が12の倍数(各年の月数)に増加するため、これは使用できません。アップグレード後に39059警告が発生したら、結合が仕様どおりに機能しているか、および結果が不正にダブル・カウントされていないかどうかを確認します。結合が仕様どおりであれば、39059警告は無視してください。
[39055] ファクト表"HR"."FACT - HC Budget"は論理ディメンション"HR"."DIM - HR EmployeeDim"の表と結合していません。これにより、プロジェクトの抽出時に問題が発生する可能性があります。	警告	特定のファクトとディメンション・ソースの間に物理結合があるが、ファクト表とディメンション表の間に対応する論理結合がないことを示します。
[39057] 論理表ソース""HR"."Dim - Schedule"."SCH_DEFN""には、列マッピングまたは式で使用されていない物理表がマップされています。	警告	特定の論理表ソースにマッピングで使用されていない表が含まれていることを示します。この状況でエラーが発生することはありません。

セマンティック・モデルの整合性のチェック

整合性のチェックを実行して、セマンティック・モデルのすべてのオブジェクトとオブジェクト間の関係を検証します。整合性のチェックでは、実行時問合せの生成が失敗する可能性のある構文またはセマンティックのエラーおよび警告のリストが表示されます。

セマンティック・モデルの開発中には、整合性をチェックしてエラーを検出および修正することをお薦めします。また、整合性のチェックを実行してエラーを修正してから、詳細チェックを実行してモデルをデプロイすることをお薦めします。

警告のあるモデルはデプロイできますが、エラーのあるモデルはできません。エラーを含むセマンティック・モデルは、エクスポートできます。

整合性のチェックの詳細は、「整合性のチェックについて」を参照してください。

特定のセマンティック・モデル・オブジェクトで整合性のチェックを実行できます。たとえば、データベース、ビジネス・モデル、サブジェクト領域または表などです。「1つ以上のセマンティック・モデル・オブジェクトの整合性のチェック」を参照してください。

ホーム・ページで、「ナビゲータ」をクリックし、「セマンティック・モデル」をクリックします。
「セマンティック・モデル」ページで、セマンティック・モデルをクリックして開きます。
セマンティック・モデルを更新した場合は、「保存」をクリックして保存してから、整合性のチェックを実行します。
ツールバーで、実行するチェックを選択します:
- 「整合性のチェック」をクリックして、エラーのリストを確認し、生成します。
- 「整合性のチェック」の横にある下矢印をクリックし、「警告を含める」を選択してエラーと警告のリストを確認し、生成します。
「グローバル」タブで、オブジェクトのリンクをクリックして検索し、開きます。
オブジェクトを修正し、「保存」をクリックしてセマンティック・モデルを保存します。
「グローバル」タブをクリックし、「チェック」をクリックして「整合性チェック」を再実行し、結果をリフレッシュします。

1つ以上のセマンティック・モデル・オブジェクトの整合性のチェック

整合性のチェックを使用して、特定のセマンティック・モデル・オブジェクトまたは選択したオブジェクトを検証します。整合性のチェックでは、実行時問合せが失敗する可能性のある構文またはセマンティックのエラーおよび警告のリストが表示されます。

整合性のチェックの詳細は、「整合性のチェックについて」を参照してください。

セマンティック・モデル全体に対する整合性のチェックの実行の詳細は、「セマンティック・モデルの整合性のチェック」を参照してください。

ホーム・ページで、「ナビゲータ」をクリックし、「セマンティック・モデル」をクリックします。
「セマンティック・モデル」ページで、セマンティック・モデルをクリックして開きます。
セマンティック・モデルを更新した場合は、「保存」をクリックして保存してから、整合性のチェックを実行します。
チェックするオブジェクトを含むセマンティック・モデル・レイヤーをクリックし、参照するか「検索」を使用して、整合性チェックを実行するオブジェクトを検索します。
1つのオブジェクトをチェックするには、そのオブジェクトを右クリックして「整合性のチェック」を選択します。
複数のオブジェクトをチェックするには、[Ctrl]キーを押したまま、チェックするオブジェクトをクリックし、右クリックして「整合性のチェック」を選択します

「整合性のチェック」タブが表示され、エラーおよび警告のリストが表示されます。
「整合性のチェック」タブで、オブジェクトのリンクをクリックし、そのオブジェクトを見つけて開きます。
問題を修正し、「保存」をクリックしてセマンティック・モデルを保存します。
「整合性のチェック」タブをクリックし、「チェック」をクリックして整合性チェックを再実行し、「整合性のチェック」タブをリフレッシュします。

整合性チェック結果での警告の非表示

チェック整合性の結果リストで、非表示にする警告を選択できます。警告を非表示にすると、結果リスト内の警告の量を制限できるため、修正する必要がある警告を見つけてフォーカスできます。

非表示にする警告を指定すると、セマンティック・モデラーは「整合性のチェック」および「拡張チェック」の結果で非表示にします。非表示に選択した警告は、セマンティック・モデラー開発環境で作業するすべてのセマンティック・モデルに対して隠されます。

非表示の警告のリストを表示して、整合性のチェック結果に表示するように選択できます。「チェック整合性での非表示の警告の管理」を参照してください。

ホーム・ページで、「ナビゲータ」をクリックし、「セマンティック・モデル」をクリックします。
「セマンティック・モデル」ページで、セマンティック・モデルをクリックして開きます。
整合性チェックまたは拡張チェックの実行:
- ツールバーで、「整合性のチェック」の横にある下矢印をクリックし、「警告を含める」を選択します。
- ツールバーで、「整合性のチェック」の横にある下矢印をクリックし、「拡張チェック」を選択します。
一貫性チェック結果リストで、非表示にする警告を見つけて、その「すべての警告を非表示」アイコンをクリックします。

チェック整合性での非表示の警告の管理

「整合性のチェック」および「拡張チェック」の結果に表示する警告を選択できます。

図hidden_warnings_dialog.pngの説明

表示するように選択した警告は、セマンティック・モデラー開発環境で操作するすべてのセマンティック・モデルに表示されます。

ホーム・ページで、「ナビゲータ」をクリックし、「セマンティック・モデル」をクリックします。
「セマンティック・モデル」ページで、セマンティック・モデルをクリックして開きます。
整合性チェックまたは拡張チェックの実行:
- ツールバーで、「整合性のチェック」の横にある下矢印をクリックし、「警告を含める」を選択します。
- ツールバーで、「整合性のチェック」の横にある下矢印をクリックし、「拡張チェック」を選択します。
整合性チェックの結果タブで、「非表示の警告」をクリックして非表示の警告のリストを表示します。
整合性チェックの結果に表示する警告を選択します。「OK」をクリックします。

セマンティック・モデルのデプロイ前の拡張整合性チェックの実行

詳細チェックを実行して、セマンティック・モデルのデプロイおよび正常な問合せ生成の準備ができていることを確認します。

Oracle Analyticsでは、バックグラウンドで詳細チェックが実行されます。

セマンティック・モデラーが拡張チェックを実行し、拡張チェック・エラーを表示する前に、整合性チェッカ・エラーを修正する必要があります。

拡張チェックを実行すると、最初にモデル全体で整合性チェックが実行されます。詳細チェックで一貫性エラーが見つかった場合は、タブに表示され、詳細チェックを再実行する前にエラーを解決する必要があります。

拡張チェックが正常に実行されると、セマンティク・モデルがSMMLから.rpdファイルに変換され、.rpdファイルで問合せ生成ナビゲーション領域エラーをチェックします。

「拡張チェック」が完了すると、構文とセマンティックの警告およびエラーのリストが「拡張チェック」タブに表示されます。

ホーム・ページで、「ナビゲータ」をクリックし、「セマンティック・モデル」をクリックします。
「セマンティック・モデル」ページで、セマンティック・モデルをクリックして開きます。
必要に応じてセマンティック・モデルを更新し、「保存」をクリックしてセマンティック・モデルを保存してから、詳細チェックを実行します。
ツールバーで、「整合性のチェック」の横にある下矢印をクリックし、「拡張チェック」を選択します。
Oracle Analyticsフッターに移動し、拡張チェックのステータスを表示します。フッターに「整合性エラーが見つかりました」と表示された場合は、それをクリックして「結果の表示」を選択し、「高度な整合性チェック」タブを表示してエラーのリストを表示します。
「詳細チェック」タブで、オブジェクトのリンクをクリックし、そのオブジェクトを見つけて開きます。
オブジェクトを修正し、「保存」をクリックしてセマンティック・モデルを保存します。
ツールバーで、「整合性のチェック」の横にある下矢印をクリックし、「拡張チェック」を選択して「詳細チェック」を再実行します。

詳細チェック履歴の検索および表示

自分または他のユーザーがセマンティック・モデルで実行した前の5回の詳細チェックの結果を検索および表示できます。

以前の詳細チェック・レコードの情報を参照して、モデルのエラーおよび警告の理解とトラブルシューティングに役立てることができます。

詳細チェック・レコードが別の言語で表示される理由を参照してください。

ホーム・ページで、「ナビゲータ」をクリックし、「セマンティック・モデル」をクリックします。
「セマンティック・モデル」ページで、セマンティック・モデルをクリックして開きます。
ツールバーで、「整合性のチェック」の横にある下矢印をクリックします。
「詳細チェック履歴」にマウス・ポインタを重ねて、表示する詳細チェック履歴レコードをクリックします。

詳細チェック・レコードが別の言語で表示される理由

拡張整合性チェックを実行した場合、Oracle Analyticsにログインしたときに選択した言語によって、エラーおよび警告メッセージを含むレコードの出力および格納に使用される言語が決まります。

たとえば、ログインしたときにドイツ語を選択して拡張整合性チェックを実行した場合、Oracle Analyticsはレコードをドイツ語で生成して保存します。

ユーザーがログインして拡張整合性チェック・レコードを開くと、レコードの生成に使用された言語でレコードが表示されます。たとえば、レコードがドイツ語で生成され、別のユーザーがログイン時に英語を選択した場合、レコードはドイツ語で表示されます。

この問題を回避するには、レコードを開くユーザーが拡張整合性チェックを再実行する必要があります。次に、ログイン時にユーザーが選択した言語を使用して、レコードが生成および格納されます。

詳細チェック警告メッセージの表示または非表示

詳細チェックを実行すると、Oracle Analyticsによってデフォルトで、詳細チェックに関する情報を含むメッセージが表示されます。このメッセージは、インスタンス内で非表示にすることも、メッセージを非表示にした後で再度表示することもできます。

「詳細チェック」ダイアログで「警告メッセージを再度表示しません。」フィールドを選択すると、「詳細チェック警告メッセージを表示します。」ユーザー・プリファレンスがオフになります。

ホーム・ページで、「ナビゲータ」をクリックし、「セマンティック・モデル」をクリックします。
「セマンティック・モデル」ページで、セマンティック・モデルをクリックして開きます。
「ページ・メニュー」をクリックし、「プリファレンス」をクリックします。
「ユーザー・プリファレンス」ダイアログ・ボックスで、「一貫性チェック」までスクロールし、「詳細チェック警告メッセージを表示します。」チェック・ボックスの選択を解除してメッセージをオフにするか、チェック・ボックスを選択してメッセージをオンにします。
「適用」をクリックします。

CSVファイルへの整合性チェック結果のエクスポート

整合性のチェックまたは詳細チェックを実行した後、結果をCSVファイルにエクスポートできます。

整合性チェックの結果をエクスポートすると、「整合性のチェック」タブに表示される結果のみでなく、すべての結果がエクスポートされます。たとえば、セマンティック・モデルに対してエラーと警告の両方について整合性のチェックを実行し、「整合性のチェック」タブで「エラー」をクリックしてエラー・メッセージのみを表示している場合、「CSVにエクスポート」をクリックすると、Oracle Analyticsによってすべてのエラーおよび警告を含むCSVファイルが生成されます。

整合性のチェックについてを参照してください。

ホーム・ページで、「ナビゲータ」をクリックし、「セマンティック・モデル」をクリックします。
「セマンティック・モデル」ページで、セマンティック・モデルをクリックして開きます。
セマンティック・モデルを更新した場合は、「保存」をクリックして保存してから、整合性のチェックまたは詳細チェックを実行します。
モデルまたはモデル・オブジェクトに対して整合性のチェックを実行するか、またはモデルに対して詳細チェックを実行します:
「整合性のチェック」タブまたは「詳細チェック」タブで、「CSVにエクスポート」をクリックします