A 의미 모델 확장에서 공통 오류 해결

패치 업그레이드 실패를 방지하려면 감지된 의미 모델 오류를 적시에 해결해야 합니다.

오류를 해결하지 않으면 파이프라인이 사용 안함으로 설정되고, 릴리스 업데이트가 중단되고, 업데이트 오퍼링이 차단되고, 유용성 및 지원이 손실될 수 있습니다. 이 해결 방법 목록을 사용하여 일반적인 오류를 해결합니다. 이러한 솔루션을 수행한 후에도 문제가 계속 발생하면 포괄적인 지원을 위한 서비스 요청을 작성하십시오.

오류: 보강 또는 매핑된 보강 열에서 열이 누락되었습니다.

설명: 데이터 보강 중 하나가 더 이상 해당 의미 모델 확장과 동기화되지 않습니다. 이는 대부분 데이터 보강을 위한 SME 옵션 기능(기능 사용 페이지의 일반적으로 사용 가능한 기능 탭 아래)이 사용으로 설정되었기 때문일 수 있습니다. 최적의 성능과 안정성을 위해 Oracle은 데이터 보강이 자동으로 시스템 의미 모델 확장을 생성하는 대신 사용자 확장을 사용하여 의미 모델을 수동으로 구성할 것을 권장합니다. 이 권장 사항의 이유는 의미 모델에서 계속 참조되는 기본 데이터 보강에 대한 변경 사항으로 인해 의미 모델 확장이 동기화되지 않고 실패하기 때문입니다. 권장되는 방법은 복잡한 모델링에 유연성을 더하고 오류를 방지하는 Data Augmentation 및 Semantic Model Extension 프로세스를 분리하는 것입니다. 앞으로 데이터 보강을 생성할 때는 항상 데이터 집합 유형을 사용하고 고유의 사용자 의미 모델 확장을 정의합니다. 시스템 의미 모델 확장을 생성하는 차원, 팩트 또는 개체 확장 유형의 새 데이터 보강을 생성하지 마십시오. 가능한 경우 모든 기존 데이터 보강을 데이터 세트 및 사용자 의미 모델 확장으로 변환합니다.

해결 팁(비운용 인스턴스에서 이 오류가 표시되는 경우):
  1. 데이터 보강 캐시를 재설정합니다. Reset the Cache를 참조하십시오.
  2. Oracle Fusion Data Intelligence의 콘솔에서 데이터 구성, 데이터 보강 순으로 이동합니다. 문제가 있는 데이터 보강을 찾아서 편집합니다. 선택한 속성을 검토하려면 후속 단계로 이동합니다. 소스에서 더 이상 사용할 수 없는 속성의 선택을 해제합니다. 다음을 사용하여 구성을 탐색한 다음 완료를 눌러 변경사항을 저장하고 일정을 잡습니다.
  3. 데이터 보강 프로세스가 완료되면 데이터 보강 대상 테이블을 참조하는 의미 모델 확장을 새로 고치고 업데이트하여 비활성화된 열을 제거해야 합니다.
    참조되지 않은 모든 객체를 제거하려면 다음과 같이 주제 영역 및 논리적 별을 정리합니다.
    1. 샌드박스를 생성합니다.
    2. 삭제된 열을 참조하는 요소를 제거하려면 주제 영역을 편집합니다.
    3. 연관된 모든 열, 파생된 필드 및 차원을 삭제하도록 논리적 스타를 편집합니다. 논리적 스타에서 차원이 누락된 경우 다시 추가한 다음 삭제하십시오.
    4. 샌드박스의 변경사항을 적용하여 변경사항을 확인합니다.
    5. 샌드박스를 메인으로 병합합니다.
    6. 업데이트된 모델을 게시합니다.
    7. 모델을 재검증하여 오류가 없는지 확인합니다.

해결 팁(운용 인스턴스에서 이 오류가 표시되는 경우):

특정 보강 열이 운용 인스턴스에 없는 경우 원인은 일반적으로 다음 두 가지 시나리오 중 하나입니다.
  1. 보강이 배포되지 않았습니다. 이 시나리오에서는 예상 보강이 포함된 데이터 구성 번들을 실행해야 합니다.
  2. 증강이 의도적으로 제거되었습니다. 증강이 삭제된 경우 먼저 하위 환경에서 의미 모델을 업데이트하여 해당 참조를 제거해야 합니다. 참조를 제거한 후 의미 모델 번들을 운용 인스턴스에 재배치합니다.

오류: 사용자정의 열에 선행 또는 후행 공백 문자가 있습니다.

설명: 속성, 파생된 열 또는 물리적 열의 표시 이름은 공백으로 시작하거나 끝납니다.

해결 팁: 이 오류는 선택하지 않은 속성의 표시 이름에 선행 또는 후행 공백이 포함되어 있을 때 발생합니다. 이 문제를 해결하려면 다음을 수행합니다.
  1. 논리적 스타를 편집하고 표시 이름의 시작 또는 끝에 여분의 공백이 있는 모든 열에 대해 속성 추가를 선택합니다.
  2. 표시 이름의 새로 선택된 열에서 선행 또는 후행 공백을 제거합니다. 필드 외부를 클릭하여 변경 사항을 저장합니다.
  3. 다음 단계를 진행하고 수정 사항을 저장합니다.
  4. 샌드박스에서 변경 사항을 적용합니다.
  5. 샌드박스를 기본 샌드박스에 병합합니다.
  6. 업데이트된 모델을 게시합니다.
  7. 모델을 재검증하여 오류가 없는지 확인합니다.

참고:

논리 스타에서 선택된 추가 열은 명시적으로 추가하지 않는 한 사용자 관련 주제 영역에 자동으로 나타나지 않습니다.

오류: 주제 영역 속성에 선행 또는 후행 공백 문자가 있습니다. 주제 영역 이름/설명/폴더/열에서 가능한 공백을 확인하십시오.

설명: 주제 영역 이름, 설명, 폴더 또는 열 이름의 표시 이름은 공백으로 시작하거나 끝납니다.

해결 방법 팁: 주제 영역을 편집한 다음 문제가 있는 사용자정의를 편집하고 주제 영역 이름, 설명, 폴더 및 열 이름에 대한 모든 선행 및 후행 공백을 찾아서 제거합니다.

오류: 단계가 오류 상태입니다.

설명: 의미 모델 컴파일 중 이 단계에서 오류가 발생했습니다.

해결 팁: 실패한 단계를 편집하고, 오류를 조사 및 식별하고, 해결합니다.

확장의 소스에 더 이상 액세스할 수 없으므로 사용자정의 단계가 오류 상태일 수 있습니다. 이는 사용자정의를 편집할 때 올바른 객체 이름 대신 "선택"이 표시되는 객체 드롭다운으로 표시됩니다.

데이터베이스 객체를 찾을 수 없는 이유는 다음과 같습니다.
  • 인스턴스에 데이터 보강, 보조 가변필드(DFF) 및 구성 가능한 계정 분석을 비롯한 참조된 데이터 애플리케이션이 누락되었습니다.
  • 데이터베이스 객체는 Autonomous AI Lakehouse로 마이그레이션된 적이 없습니다.
  • "OAX_USER"."TABLE_VIEW" TO "OAX$OAC"에 대한 GRANT SELECT ON "OAX_USER"와 같은 필요한 권한이 적용되지 않거나 제거되었습니다.
  • 객체 이름에 괄호와 같이 지원되지 않는 특수 문자가 포함되어 있습니다.

오류: 분기의 마지막 단계에 일관성 검사 오류가 있습니다.

설명: 의미 모델 컴파일 중 오류가 발생했습니다.

해결 팁: 오류는 최종 단계의 실패를 나타내지만 근본 원인은 이전 단계에 있을 수 있습니다. 마지막으로 실패한 단계를 편집하고 오류를 조사 및 식별하고 해결합니다.

오류: 워크북 내 "최대 행 제한 초과" 또는 "질의 실행 실패: 최대 행 제한 초과"

설명: 이러한 오류는 의미 모델이 게시된 후에 워크북에 나타납니다.

해결 팁: 이 문제는 256자를 초과하는 확장 속성 열 크기와 관련이 있을 수 있습니다. 이 문제를 해결하려면 열 크기를 256자 이하로 설정하도록 열 정의를 수정합니다.

예: ALTER TABLE TABLE_NAME MODIFY (COLUMN_NAME VARCHAR2(256));