简单搜索实施指南

“简单搜索”实施是​Adobe Summit实验室AEM Search Demystified​中的材料。 本页包含本实验的材料。 有关实验室的指导教程，请查看本页演示部分的实验室工作簿。

演示材料

• 实验室工作簿
• 演示文稿

书签

工具

• 索引管理器
• 说明查询
• CRXDE Lite > /oak:index/cqPageLucene
• CRX包管理器
• QueryBuilder Debugger
• Oak索引定义生成器

章

以下章节链接假定AEM作者 在 以下位置安装了初始包http://localhost:4502

• 第1章
• 第二章
• 第三章
• 第四章
• 第五章
• 第六章
• 第七章
• 第八章
• 第9章

包

初始包

• 标记
• 简单搜索应用程序包

章节包

• 第1章解决方案
• 第2章解决方案
• 第3章解决方案
• 第4章解决方案
• 第五章设置
• 第5章解决方案
• 第6章解决方案
• 第9章解决方案

参考资料

• Github存储库
• Sling 模型
• Sling模型导出程序
• QueryBuilder API
• AEM Chrome插件 (文档页面)

更正和后续行动

实验室讨论的更正和澄清以及与会者对后续问题的回答。

1. 如何停止重新索引？

   可通过AEM Web控制台> JMX提供的IndexStats MBean停止重新索引

   • http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats
     • 执行abortAndPause()以中止重新索引。 这将锁定索引以进一步重新编入索引，直到调用resume()。
     • 执行resume()将重新启动索引过程。
   • 文档：https://jackrabbit.apache.org/oak/docs/query/indexing.html#async-index-mbean

2. oak索引如何支持多个租户？

   Oak支持将索引贯穿内容树，并且这些索引将仅在该子树中进行索引。 例如，可以创建​/content/site-a/oak:index/cqPageLucene​以仅在​/content/site-a下索引内容。

   等效的方法是在​/oak:index​下的索引上使用​includePaths​和​queryPaths​属性。 例如：

   • /oak:index/siteAcqPageLucene@includePaths=/content/site-a
   • /oak:index/siteAcqPageLucene@queryPaths=/content/site-a

   此方法的考虑事项包括：

   • 查询必须指定一个与索引的查询路径范围相等的路径限制，或者该路径限制是该索引的子体。
   • 范围更广的索引（例如/oak:index/cqPageLucene）也将对数据进行索引，从而导致重复摄取和磁盘使用成本。
   • 可能需要重复的配置管理(例如 在多个租户索引中添加相同的indexRules（如果它们必须满足相同的查询集）
   • 在AEM发布层中，这种方法最适用于自定义站点搜索，与在AEM作者中一样，对于不同租户（例如，通过OmniSearch），通常在内容树的上方执行查询 — 不同的索引定义可能只导致基于路径限制的不同行为。

3. 所有可用分析程序的列表位于何处？

   Oak公开了一组lucene提供的分析器配置元素，以供在AEM中使用。

   • Apache Oak分析程序文档
     • 令牌器
     • 过滤器
     • CharFilters

4. 如何在同一查询中搜索页面和资产？

   AEM 6.3中的新增功能是在同一提供的查询中查询多个节点类型。 以下QueryBuilder查询。 请注意，每个“子查询”都可以解析为其自己的索引，因此在此示例中，cq:Page子查询解析为/oak:index/cqPageLucene,dam:Asset子查询解析为/oak:index/damAssetLucene。

   group.p.or=true
   group.1_group.type=cq:Page
   # add all page restrictions to this group
   group.2_group.type=dam:Asset
   # add all asset restrictions to this group
   

   生成以下查询和查询计划：

   QUERY:(//element(*, cq:Page) | //element(*, dam:Asset))
   
   PLAN: [cq:Page] as [a] /* lucene:cqPageLucene(/oak:index/cqPageLucene) *:* */ union [dam:Asset] as [a] /* lucene:damAssetLucene(/oak:index/damAssetLucene) *:* */
   

   通过QueryBuilder Debugger和AEM Chrome插件浏览查询和结果。

5. 如何在同一查询中跨多个路径进行搜索？

   AEM 6.3中的新增功能是在同一查询中跨多个路径进行查询。 以下QueryBuilder查询。 请注意，每个“子查询”都可以解析为其自己的索引。

   group.p.or=true
   group.1_group.type=cq:Page
   group.1_group.path=/content/docs/en/6-2
   # add all page restrictions to this group
   group.2_group.type=cq:Page
   group.2_group.path=/content/docs/en/6-3
   # add all asset restrictions to this group
   

   生成以下查询和查询计划

   QUERY: (/jcr:root/content/docs/en/_x0036_-2//element(*, cq:Page) | /jcr:root/content/docs/en/_x0036_-3//element(*, cq:Page))
   
   PLAN: [cq:Page] as [a] /* traverse "/content/docs/en/6-2//*" where isdescendantnode([a], [/content/docs/en/6-2]) */ union [cq:Page] as [a] /* traverse "/content/docs/en/6-3//*" where isdescendantnode([a], [/content/docs/en/6-3]) */
   

   通过QueryBuilder Debugger和AEM Chrome插件浏览查询和结果。