느린 쿼리 문제 해결 troubleshooting-slow-queries

인덱스 없는 쿼리

• not ​을(를) 수행하는 쿼리는 색인으로 확인되고 JCR 콘텐츠를 통과하여 결과를 수집합니다.

쿼리 제한(또는 범위 지정)이 잘못됨

• 인덱스로 확인되지만 결과를 수집하려면 모든 인덱스 항목을 트래버스해야 하는 쿼리

큰 결과 집합 쿼리

• 많은 결과를 반환하는 쿼리

이 조정은 Query Builder에만 적용되며 JCR-SQL2 또는 XPath에는 적용되지 않습니다.

전체 결과 집합이 바로 필요한 경우 Query Builder guessTotal을 사용합니다​ not.

• 최적화되지 않은 쿼리

  code language-js
  type=cq:Page path=/content

• 최적화된 쿼리

  code language-js
  type=cq:Page path=/content p.guessTotal=100

쿼리 실행은 빠르지만 결과 수가 많은 경우 guessTotal은(는) Query Builder 쿼리에 대한 중요한 최적화입니다.

p.guessTotal=100은(는) Query Builder에 처음 100개의 결과만 수집하도록 지시합니다. 또한 하나 이상의 결과가 있는지(하지만 이 숫자를 카운트하면 속도가 느려지므로 더 많은 결과는 아님) 나타내는 부울 플래그를 설정합니다. 이 최적화는 결과 하위 집합만 점진적으로 표시되는 페이지 매김 또는 무한 로드 사용 사례에 적합합니다.

최적 쿼리가 속성 인덱스로 확인되는 경우 속성 인덱스가 최소한으로 조정할 수 있으므로 수행할 작업이 없습니다.

그렇지 않으면 쿼리가 Lucene 속성 인덱스로 확인되어야 합니다. 해결할 수 있는 색인이 없는 경우 색인 작성으로 이동합니다.

필요에 따라 쿼리를 XPath 또는 JCR-SQL2로 변환합니다.

• 쿼리 빌더 쿼리

  code language-js
  query type=cq:Page path=/content/my-site/us/en property=jcr:content/contentType property.value=article-page orderby=@jcr:content/publishDate orderby.sort=desc

• Query Builder 쿼리에서 생성된 XPath

  code language-js
  /jcr:root/content/my-site/us/en//element(*, cq:Page)[jcr:content/@contentType = 'article-page'] order by jcr:content/@publishDate descending

최적화된 Lucene 속성 인덱스 정의를 생성할 수 있도록 XPath(또는 JCR-SQL2)를 https://oakutils.appspot.com/generate/index의 Oak 인덱스 정의 생성기에 제공하십시오.

생성된 Lucene 속성 인덱스 정의

- evaluatePathRestrictions = true
- compatVersion = 2
- type = "lucene"
- async = "async"
- jcr:primaryType = oak:QueryIndexDefinition
    + indexRules
    + cq:Page
        + properties
        + contentType
            - name = "jcr:content/contentType"
            - propertyIndex = true
        + publishDate
            - ordered = true
            - name = "jcr:content/publishDate"

생성된 정의를 추가 방식으로 기존 Lucene 속성 인덱스에 수동으로 병합합니다. 기존 구성은 다른 쿼리를 충족하는 데 사용될 수 있으므로 제거하지 않도록 주의하십시오.

1. cq:Page를 포함하는 기존 Lucene 속성 인덱스(인덱스 관리자 사용)를 찾습니다. 이 경우 /oak:index/cqPageLucene입니다.
2. 최적화된 인덱스 정의(#4단계)와 기존 인덱스(https://experienceleague.adobe.com/oak:index/cqPageLucene?lang=ko) 간의 구성 델타를 식별하고, 최적화된 인덱스에서 누락된 구성을 기존 인덱스 정의에 추가합니다.
3. AEM의 리인덱싱 모범 사례에 따라, 기존 컨텐츠가 이 인덱스 구성 변경의 영향을 받을 수 있는지 여부를 기준으로 새로 고침 또는 리인덱싱이 순서대로 수행됩니다.

쿼리가 기존 Lucene 속성 인덱스로 확인되지 않는지 확인합니다. 이 경우 조정 및 기존 색인에 대한 위의 섹션을 참조하십시오.

필요에 따라 쿼리를 XPath 또는 JCR-SQL2로 변환합니다.

• 쿼리 빌더 쿼리

  code language-js
  type=myApp:Author property=firstName property.value=ira

• Query Builder 쿼리에서 생성된 XPath

  code language-js
  //element(*, myApp:Page)[@firstName = 'ira']

최적화된 Lucene 속성 인덱스 정의를 생성할 수 있도록 XPath(또는 JCR-SQL2)를 https://oakutils.appspot.com/generate/index의 Oak 인덱스 정의 생성기에 제공하십시오.

생성된 Lucene 속성 인덱스 정의

- compatVersion = 2
- type = "lucene"
- async = "async"
- jcr:primaryType = oak:QueryIndexDefinition
    + indexRules
    + myApp:AuthorModel
        + properties
        + firstName
            - name = "firstName"
            - propertyIndex = true

생성된 Lucene 속성 인덱스 정의를 배포합니다.

새 색인에 대해 Oak 색인 정의 생성기에서 제공하는 XML 정의를 Oak 색인 정의를 관리하는 AEM 프로젝트에 추가합니다(코드에 따라 Oak 색인 정의가 다르므로 색인 정의를 코드로 취급해야 함).

일반적인 AEM 소프트웨어 개발 라이프사이클에 따라 새 인덱스를 배포하고 테스트하고 쿼리가 인덱스로 확인되며 쿼리가 수행되는지 확인합니다.

이 색인의 초기 배포 시 AEM은 필요한 데이터로 색인을 채웁니다.