Solução de problemas de consultas lentas

Adicione uma restrição do tipo de nó para que a consulta resolva para um Índice de propriedades do Lucene existente.

• Consulta não otimizada

   property=jcr:content/contentType
   property.value=article-page
  

• Consulta otimizada

   type=cq:Page
   property=jcr:content/contentType
   property.value=article-page
  

Consultas sem uma força de restrição de tipo de nó AEM assumir a variável nt:base nodetype, que cada nó no AEM é um subtipo de, resultando efetivamente em nenhuma restrição de tipo de nó.

Configuração type=cq:Page restringe esta consulta somente cq:Page e resolve a consulta para AEM cqPageLucene, limitando os resultados a um subconjunto de nós (somente cq:Page nós) em AEM.

Ajuste a restrição do tipo de nó da consulta para que ela seja resolvida para um Índice de propriedades Lucene existente.

• Consulta não otimizada

  type=nt:hierarchyNode
  property=jcr:content/contentType
  property.value=article-page
  

• Consulta otimizada

  type=cq:Page
  property=jcr:content/contentType
  property.value=article-page
  

nt:hierarchyNode é o tipo de nó principal de cq:Pagee assumindo jcr:content/contentType=article-page é aplicado somente a cq:Page nós via nosso aplicativo personalizado, esta consulta retornará somente cq:Page nós onde jcr:content/contentType=article-page. No entanto, essa é uma restrição subideal, pois:

• Outro nó herda de nt:hierarchyNode (por exemplo, dam:Asset) adicionar desnecessariamente ao conjunto de resultados potenciais.
• Não existe um índice fornecido AEM para nt:hierarchyNode, no entanto, como há um índice fornecido para cq:Page.

Configuração type=cq:Page restringe esta consulta somente cq:Page e resolve a consulta para AEM cqPageLucene, limitando os resultados a um subconjunto de nós (somente nós cq:Page) em AEM.

Ou ajuste as restrições de propriedade para que a consulta resolva para um Índice de propriedades existente.

• Consulta não otimizada

    property=jcr:content/contentType
    property.value=article-page
  

• Consulta otimizada

  property=jcr:content/sling:resourceType
  property.value=my-site/components/structure/article-page
  

Alterar a restrição de propriedade de jcr:content/contentType (um valor personalizado) para a propriedade conhecida sling:resourceType permite que a query resolva para o índice de propriedade slingResourceType que indexa todo o conteúdo por sling:resourceType.

Os índices de propriedade (em vez de Índices de propriedades do Lucene) são melhor usados quando a consulta não é discernível por tipo de nó e uma única restrição de propriedade domina o conjunto de resultados.

Adicione a restrição de caminho mais estrita possível ao query. Por exemplo, preferir /content/my-site/us/en over /content/my-siteou /content/dam over /.

• Consulta não otimizada

  type=cq:Page
  path=/content
  property=jcr:content/contentType
  property.value=article-page
  

• Consulta otimizada

  type=cq:Page
  path=/content/my-site/us/en
  property=jcr:content/contentType
  property.value=article-page
  

Escopo da restrição de caminho de path=/contentpara path=/content/my-site/us/en permite que os índices reduzam o número de entradas de índice que precisam ser inspecionadas. Quando a query puder restringir muito bem o caminho, além de apenas /content ou /content/dam, assegure-se de que o índice tenha evaluatePathRestrictions=true.

Observe usando evaluatePathRestrictions aumenta o tamanho do índice.

Sempre que possível, evite funções/operações de query como: LIKE e fn:XXXX dado que os seus custos são proporcionais ao número de resultados baseados em restrições.

• Consulta não otimizada

  type=cq:Page
  property=jcr:content/contentType
  property.operation=like
  property.value=%article%
  

• Consulta otimizada

  type=cq:Page
  fulltext=article
  fulltext.relPath=jcr:content/contentType
  

A condição LIKE é lenta para avaliar, pois nenhum índice pode ser usado se o texto começar com um curinga ("%…'). A condição jcr:contains permite usar um índice de texto completo e, portanto, é preferível. Isso requer que o Índice de propriedades do Lucene resolvido tenha indexRule para jcr:content/contentType com analayzed=true.

Uso de funções de consulta como fn:lowercase(..) pode ser mais difícil de otimizar, pois não há equivalentes mais rápidos (fora das configurações mais complexas e discretas do analisador de índice). É melhor identificar outras restrições de escopo para melhorar o desempenho geral da consulta, exigindo que as funções operem no menor conjunto possível de resultados potenciais.

Esse ajuste é específico do Query Builder e não se aplica a JCR-SQL2 ou XPath.

Use guessTotal do construtor de consultas quando o conjunto completo de resultados for não ​ imediatamente necessário.

• Consulta não otimizada

  type=cq:Page
  path=/content
  

• Consulta otimizada

  type=cq:Page
  path=/content
  p.guessTotal=100
  

Para casos em que a execução da consulta é rápida, mas o número de resultados é grande, p guessTotal O é uma otimização crítica para consultas do Query Builder.

p.guessTotal=100 instrui o Query Builder a coletar apenas os primeiros 100 resultados e definir um sinalizador booleano indicando se existem pelo menos mais um resultado (mas não quantos mais, já que a contagem desse número resultaria em lentidão). Essa otimização se sobressai para paginação ou casos de uso de carregamento infinito, onde apenas um subconjunto de resultados é exibido de forma incremental.

Se a consulta ideal for resolvida para um Índice de propriedades, não há mais nada para fazer, pois os Índices de propriedades são minimamente ajustáveis.

Caso contrário, a consulta deve ser resolvida para um Índice de propriedades do Lucene. Se nenhum índice puder ser resolvido, vá para Criação de um novo Índice.

Conforme necessário, converta a consulta para XPath ou JCR-SQL2.

• Query Builder

  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
  

• XPath gerado da consulta do Query Builder

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

Forneça o XPath (ou JCR-SQL2) para Gerador de definição de índice Oak para gerar a definição otimizada do Índice de propriedades do Lucene.

Definição de índice de propriedade do Lucene gerada

- 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"

Mescle manualmente a definição gerada no Índice de propriedades do Lucene existente de forma aditiva. Tenha cuidado para não remover configurações existentes, pois elas podem ser usadas para atender a outros queries.

1. Localize o Índice de propriedades do Lucene existente que abrange cq:Page (usando o Gerenciador de índices). Nesse caso, /oak:index/cqPageLucene.
2. Identifique o delta de configuração entre a definição de índice otimizada (Etapa 4) e o índice existente (https://experienceleague.adobe.com/oak:index/cqPageLucene?lang=pt-BR) e adicione as configurações ausentes do Índice otimizado à definição de índice existente.
3. De acordo com AEM Práticas recomendadas de reindexação, uma atualização ou reindexação está em ordem, com base em se o conteúdo existente será afetado por essa alteração de configuração de índice.

Verifique se a consulta não resolve um Índice de propriedades do Lucene existente. Se isso acontecer, consulte a seção acima sobre ajuste e índice existente.

Conforme necessário, converta a consulta para XPath ou JCR-SQL2.

• Query Builder

  type=myApp:Author
  property=firstName
  property.value=ira
  

• XPath gerado da consulta do Query Builder

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

Forneça o XPath (ou JCR-SQL2) para Gerador de definição de índice Oak para gerar a definição otimizada do Índice de propriedades do Lucene.

Definição de índice de propriedade do Lucene gerada

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

Implante a definição do Índice de propriedades do Lucene gerado.

Adicione a definição XML fornecida pelo Gerador de Definição de Índice Oak para o novo índice ao projeto AEM que gerencia as definições de índice Oak (lembre-se de tratar as definições de índice Oak como código, já que o código depende delas).

Implante e teste o novo índice seguindo o ciclo de vida normal de desenvolvimento de software AEM e verifique se a consulta resolve o índice e se a consulta é executada.

Após a implantação inicial desse índice, o AEM preencherá o índice com os dados necessários.