AEM as a Cloud Service의 쿼리에 대해 SIM 관리 색인이 선택되지 않았습니다.
Adobe Experience Manager as a Cloud Service에서 쿼리가 이전 색인을 계속 사용하는 동안 SIM(간소화된 색인 관리) 정의를 성공적으로 배포할 수 있습니다. 쿼리 플래너는 쿼리 제한 사항, 인덱싱된 속성 및 예상 비용을 기반으로 적격한 인덱스를 평가합니다. 이 문제를 해결하려면 배포 및 쿼리 계획을 확인하고 includedPaths, queryPaths 및 인덱스 규칙을 쿼리 요구 사항에 맞추고, Cloud Manager을 통해 변경 사항을 배포하고, 인덱싱이 완료된 후 쿼리를 확인합니다.
설명 description
환경
간소화된 색인 관리를 통한 Adobe Experience Manager as a Cloud Service
문제/증상
간소화된 색인 관리 정의를 배포하면 의도한 SIM 관리 색인 대신 이전 색인을 사용하여 쿼리가 계속됩니다.
- 쿼리는
cqPageContent과(와) 같은 의도한 색인 대신cqPageLucene과(와) 같은 이전 색인을 계속 사용합니다. - SIM 관리 인덱스가 저장소에 표시되지만 쿼리 성능 도구 이(가) 관련 쿼리에 대해 해당 인덱스를 선택하지 않습니다.
- 색인 정의에
includedPaths및queryPaths이(가) 포함되어 있지만 쿼리에서 여전히 이전 색인을 사용합니다. - 필수 쿼리 속성은 SIM 관리 색인 규칙에 포함되지 않습니다.
- 로그에 특정 오류 메시지가 표시되지 않습니다.
원인
쿼리 플래너는 예상 비용이 가장 낮은 적격 색인을 선택합니다. SIM 관리 색인이 쿼리 경로 또는 필수 속성을 포함하지 않거나 예상 비용이 이전 색인보다 높은 경우 쿼리는 이전 색인을 계속 사용합니다.
해결 방법 resolution
색인 선택 문제를 해결하려면 다음 단계를 수행합니다.
-
쿼리 성능 도구에서 영향을 받는 쿼리를 실행하고 쿼리 설명 출력을 검토하십시오.
- 쿼리에서 사용하는 인덱스를 확인합니다.
- 의도한 SIM 관리 인덱스가 쿼리 플랜에 의해 고려되는지 확인합니다.
- 색인 정의를 업데이트한 후 비교할 쿼리 계획 및 예상 비용을 기록합니다.
-
SIM 정의가 올바르게 배포되었는지 확인합니다.
- SIM 정의가 프로젝트 코드베이스에 포함되어 있는지 확인합니다.
- Cloud Manager 파이프라인이 성공적으로 완료되었는지 확인합니다.
- 저장소 브라우저을(를) 사용하여
/oak:index/<sim-index-name>과(와) 같은 생성된 인덱스 정의가 필요한 구성과 함께 존재하는지 확인하십시오.
-
색인 정의에서 경로 구성을 검토합니다.
includedPaths이(가) 인덱스에 포함해야 하는 콘텐츠를 포함하는지 확인하십시오.queryPaths이(가) 쿼리에 사용된 경로 제한을 적용하는지 확인하십시오.- 색인이 동일한 콘텐츠 범위에 대한 쿼리를 포함하고 제공해야 하는 경우
includedPaths및queryPaths에 대해 일치하는 값을 사용하십시오. - 참고:
includedPaths은(는) 인덱싱된 콘텐츠 범위를 제어하는 반면queryPaths은(는) 인덱스가 일치하는 경로 제한이 있는 쿼리에 적합한지 여부에 영향을 줍니다.
-
쿼리에 필요한 색인 규칙 및 속성을 검토합니다.
- 쿼리에서 사용하는 각 속성이 적절한 색인 규칙에서 색인화되었는지 확인합니다.
- 쿼리에서
jcr:content/cq:lastModified,excludeSearch및hideFromExternalUser과(와) 같은 속성을 사용하는 경우 해당 속성을 확인하십시오. - 필수 속성이 누락된 경우 적절한 인덱스 규칙을 SIM 정의에 추가하고 Cloud Manager 파이프라인을 통해 다시 배포합니다.
-
표준 Cloud Manager파이프라인을 통해 업데이트된 색인 정의를 배포합니다.
- 업데이트된 색인 정의를 프로젝트 코드베이스의 일부로 패키지화합니다.
- 파이프라인을 실행하고 인덱스 빌드 또는 리인덱싱 프로세스가 완료될 수 있도록 합니다.
- 쿼리의 유효성을 다시 검사하기 전에 Cloud Manager 빌드 페이지에서 색인화 상태를 확인하십시오.
-
인덱싱이 완료된 후 쿼리 동작의 유효성을 검사합니다.
- 쿼리 성능 도구에서 영향을 받는 쿼리를 다시 실행하십시오.
- 쿼리 설명 출력에서 의도한 SIM 관리 인덱스가 선택되었는지 확인합니다.
- 대표적인 영향력이 큰 쿼리 세트를 테스트합니다.
- 특히 제목, 설명 및 컨텐츠와 같은 부스트된 필드가 있는 쿼리의 경우 마이그레이션 전후의 결과 및 순위를 비교합니다.
- 쿼리 성능 도구를 사용하여 성능 회귀를 확인합니다.
-
새 SIM 관리 색인의 유효성을 검사한 후 프로젝트 코드베이스에서 오래된 색인 정의를 제거합니다.
- 저장소에서 인덱스 노드를 수동으로 삭제하지 마십시오.
- 참고: AEM as a Cloud Service에서 새 버전을 준비하는 동안 이전 색인과 새 색인 버전이 연속 배포 중에 일시적으로 공존할 수 있습니다.
참고:
- 페이지, DAM 및 감사 인덱스에 SIM을 사용하는 것이 좋습니다. 기존 색인이 요구 사항을 충족하고 계속 지원되는 경우에는 마이그레이션이 필수가 아닙니다.
- 사용자 지정 쿼리 경로가 없는 색인(예:
Audit Event또는 사용자 지정Email Index)의 경우 해당 쿼리를 SIM으로 마이그레이션하려는 경우에만 마이그레이션 구성에 포함하십시오. - 지속적인 지원 및 향후 호환성이 필요한 경우 사용자 정의 인덱스를 SIM으로 마이그레이션합니다.