在 Marklogic 中使用 XQuery 无法理解 CTS 查询

Question

我正在尝试使用cts:search()了解cts:element-query 、 cts:element-value-query和cts:element-word-query之间的区别。

当有人可以使用所有三个实现相同的事情时，他们为什么要创建这么多？

我确定我在这里遗漏了一些需要理解的东西。 我有以下数据：

<CATALOG>
  <CD>
    <TITLE>Empire Burlesque</TITLE>
    <ARTIST>Bob Dylan</ARTIST>
    <COUNTRY>USA</COUNTRY>
    <COMPANY>Columbia</COMPANY>
    <PRICE>10.90</PRICE>
    <YEAR>1985</YEAR>
  </CD>
  <CD>
    <TITLE>Hide your heart</TITLE>
    <ARTIST>Bonnie Tyler</ARTIST>
    <COUNTRY>USA</COUNTRY>
    <COMPANY>CBS Records</COMPANY>
    <PRICE>9.90</PRICE>
    <YEAR>1988</YEAR>
  </CD>
  <CD>
    <TITLE>Greatest Hits</TITLE>
    <ARTIST>Dolly Parton</ARTIST>
    <COUNTRY>EU</COUNTRY>
    <COMPANY>RCA</COMPANY>
    <PRICE>9.90</PRICE>
    <YEAR>1982</YEAR>
  </CD>
</CATALOG>

我想过滤国家的数据说“欧盟”。 我可以使用下面列出的任何查询来实现相同的目标。

•  cts:search(//CD,cts:element-query(xs:QName("COUNTRY"),"EU"))

•  cts:search(//CD,cts:element-value-query(xs:QName("COUNTRY"),"EU"))

•  cts:search(//CD,cts:element-word-query(xs:QName("COUNTRY"),"EU"))

那么区别是什么呢？ 什么时候用什么？ 有人可以帮我理解吗？

我的理解是使用cts:search和cts:element-query 。 如果我也可以使用其他查询获得相同的结果，我正在研究其他查询。 （我已经浏览了我仍然不明白的文档）。 有人可以给我一个简单的解释吗？

Answer 1

这三个 cts:element-* 查询函数具有一些重叠的功能，并且可以获得相同的结果，但有一些关键差异会影响查询的可能性以及查询对您的系统的效率。

• cts:element-query()是一个容器查询。 它匹配第一个参数中指定的元素。 第二个参数的查询应用于匹配的元素及其所有后代。 因此，如果有更复杂的结构， cts:word-query将匹配 COUNTRY 或任何后代元素的文本。

  使用xdmp:plan()查看查询计划，

   xdmp:plan(cts:search(//CD,cts:element-query(xs:QName("COUNTRY"),"EU")))

  您可以看到该计划具有应用不受约束的单词查询的条件：

   <qry:term-query weight="1"> <qry:key>17785254954065741518</qry:key> <qry:annotation>word("EU")</qry:annotation> </qry:term-query>

• cts:element-value-query()仅匹配文本内容与第二个参数中的短语匹配的简单元素（即仅包含文本且没有子元素的元素）。

  该查询的xdmp:plan() ：

   xdmp:plan( cts:search(//CD,cts:element-value-query(xs:QName("COUNTRY"),"EU")) )

  表明有一个值专门应用于COUNTRY元素：

   <qry:term-query weight="1"> <qry:key>9358511946618902997</qry:key> <qry:annotation>element(COUNTRY,value("EU"))</qry:annotation> </qry:term-query>

• cts:element-word-query()类似于 cts:element-value-query，除了它只搜索指定元素的直接文本节点子节点以及管理界面中定义的子元素的任何文本节点子节点element-word-query-throughs 或 phrase-throughs 。 它不会搜索指定元素的任何其他子元素。

  该查询的xdmp:plan() ：

   xdmp:plan( cts:search(//CD,cts:element-word-query(xs:QName("COUNTRY"),"EU")) )

  表明有一个词查询专门应用于COUNTRY元素：

   <qry:term-query weight="1"> <qry:key>6958980695756965065</qry:key> <qry:annotation>element(COUNTRY,word("EU"))</qry:annotation> </qry:term-query>

  如果您有混合内容和特定元素的已知词汇表，并且希望在搜索时能够“看穿”，那么cts:element-word-query最有帮助。 一个示例是 MS Word 或 XHTML 标记，其中包含用于应用样式和格式的元素包装文本，例如<p>内的<b> 、 <i>和<u> > 并且您想要搜索给定段落中的单词并搜索b 、 i和u子元素。

对于这个特定实例，要在特定元素中搜索值，您应该使用：

cts:search(//CD,cts:element-value-query(xs:QName("COUNTRY"),"EU")) 

这是告诉 MarkLogic 您要在COUNTRY元素（而不是它的任何子元素或后代）中搜索值“EU”的最具体和最有效的方法。