セマンティック・モデル拡張での一般的なエラーの解決

エラーを解決しないと、パイプラインが無効になり、更新のリリースが停止され、オファリングの更新がブロックされ、操作性とサポートが失われる可能性があります。一般的なエラーを解決するには、この解決策のリストを使用します。これらのソリューションをフォローした後も引き続き問題が発生する場合は、包括的な支援のためのサービス・リクエストを作成します。

エラー: 列が拡張から欠落しているか、マップされた拡張列が使用できません

説明: データ拡張の1つが、対応するセマンティック・モデル拡張と同期されなくなりました。これは、データ拡張のSMEオプション機能(「機能を有効化」ページの「一般に使用可能な機能」タブの下)が有効になっているために発生する可能性があります。最適なパフォーマンスと安定性を実現するために、Oracleでは、データ拡張によってシステム・セマンティック・モデル拡張が自動的に生成されるのではなく、ユーザー拡張を使用してセマンティック・モデルを手動で構成することをお薦めします。この推奨事項の理由は、基礎となるデータ拡張への変更であり、セマンティック・モデルで参照されたままであるため、セマンティック・モデル拡張が非同期になり失敗するからです。推奨される方法は、データ拡張およびセマンティック・モデル拡張プロセスを分離することです。このプロセスは、複雑なモデリングに対して柔軟性を高め、エラーを防止します。今後は、データ拡張を作成するときに、常にデータセット・タイプを使用し、独自のユーザー・セマンティック・モデル拡張を定義します。システム・セマンティック・モデル拡張を作成する(ディメンション、ファクトまたは拡張エンティティ・タイプの)新しいデータ拡張を作成しないでください。可能な場合は、既存のすべてのデータ拡張をデータセットおよびユーザー・セマンティック・モデル拡張に変換します。

解決のヒント(非本番インスタンスでこのエラーが表示された場合):

データ拡張キャッシュをリセットします。Reset the Cacheを参照してください。
Oracle Fusion Data Intelligenceのコンソールから、「データ構成」、「データ拡張」の順にナビゲートします。問題のあるデータ拡張を見つけて編集します。後続のステップに進み、選択した属性を確認します。ソースで使用できなくなった属性の選択を解除します。「次へ」を使用して構成をナビゲートし、「終了」をクリックして変更を保存およびスケジュールします。
データ拡張プロセスの完了後、データ拡張ターゲット表を参照するセマンティック・モデル拡張をリフレッシュおよび更新して、非アクティブ化された列を削除してください。
参照されていないオブジェクトをすべて削除するには、次のようにサブジェクト領域と論理スターをクリーンアップします。
1. サンドボックスを作成します。
2. サブジェクト領域を編集して、削除された列を参照する要素を削除します。
3. 論理スターを編集して、関連するすべての列、導出フィールドおよびディメンションを削除します。論理スターからディメンションが欠落している場合は、ディメンションを再追加してから削除します。
4. 変更をサンドボックスに適用して、変更を確認します。
5. サンドボックスをメインにマージします。
6. 更新されたモデルを公開します。
7. モデルを再検証して、エラーがないことを確認します。

解決策のヒント(本番インスタンスでこのエラーが表示されている場合):

特定の拡張列が本番インスタンスに存在しない場合、通常、原因は次の2つのシナリオのいずれかになります。

拡張がデプロイされませんでした: このシナリオでは、予想される拡張を含むデータ構成バンドルを実行する必要があります。
拡張が意図的に削除された: 拡張が削除された場合は、まず下位環境のセマンティック・モデルを更新して、その参照を削除する必要があります。参照を削除した後、セマンティック・モデル・バンドルを本番インスタンスに再デプロイします。

エラー: カスタム列の先頭または末尾に空白文字があります

説明: 属性、導出列または物理列の表示名は、スペースで開始または終了します。

解決のヒント: このエラーは、選択されていない属性の表示名に先頭または末尾のスペースが含まれている場合に発生します。これを解決するには:

論理スターを編集し、表示名の先頭または末尾に余分なスペースがあるすべての列に対して「属性の追加」を選択します。
「表示名」で、新しく選択した列の先頭または末尾の空白を削除します。フィールドの外側をクリックして変更を保存します。
次のステップに進み、変更を保存します。
サンドボックスで変更を適用します。
サンドボックスをメイン・サンドボックスにマージします。
更新されたモデルを公開します。
モデルを再検証して、エラーがないことを確認します。

ノート:

論理スターでさらに選択した列は、明示的に追加しないかぎり、ユーザー対応サブジェクト領域には自動的に表示されません。

エラー: サブジェクト領域属性に先頭または末尾の空白文字があります。可能な空白については、サブジェクト領域名/説明/フォルダ/列を確認してください

説明: サブジェクト領域名、説明、フォルダまたは列名の表示名は、スペースで開始または終了します。

解決策のヒント: サブジェクト領域を編集してから、問題のあるカスタマイズを編集し、サブジェクト領域名、説明、フォルダおよび列名のすべての先頭および末尾のスペースを見つけて削除します。

エラー: ステップはエラー状態です

説明: セマンティック・モデルのコンパイル中に、このステップでエラーが発生しました。

解決のヒント: 失敗したステップを編集し、調査し、エラーを特定して解決します。

拡張のソースにアクセスできなくなったため、カスタマイズ・ステップはエラー状態になる可能性があります。これは、カスタマイズを編集するときに、正しいオブジェクト名ではなく「選択」を示すオブジェクト・ドロップダウンによって示されます。

見つからないデータベース・オブジェクトは、次の理由で発生する可能性があります。

インスタンスに、データ拡張、付加フレックスフィールド(DFF)、構成可能な勘定科目分析などの参照データ・アプリケーションがありません。
データベース・オブジェクトはAutonomous AI Lakehouseに移行されませんでした。
GRANT SELECT ON "OAX_USER"."TABLE_VIEW" TO "OAX$OAC"などの必要な権限は適用されなかったか、削除されました。
オブジェクト名に、カッコなどのサポートされていない特殊文字が含まれています。

エラー: ブランチの最後のステップに整合性チェック・エラーがあります。

説明: セマンティック・モデルのコンパイル中にエラーが発生しました。

解決のヒント: エラーは最終ステップで失敗することを示しますが、根本原因は前の段階にある可能性があります。最後に失敗したステップを編集し、調査してエラーを特定し、解決します。

エラー: ワークブック内の「最大行数制限を超えました」または「問合せの実行に失敗しました: 最大行数制限を超えました」

説明: これらのエラーは、セマンティック・モデルが公開された後にワークブックに表示されます。

解決のヒント: この問題は、256文字を超える拡張属性列サイズに関連している可能性があります。これを解決するには、列サイズを256文字以下にするように列定義を変更します。

たとえば、ALTER TABLE TABLE_NAME MODIFY (COLUMN_NAME VARCHAR2(256));

A セマンティク・モデル拡張における一般的なエラーの解決