1.7.4.3 Parsers

Parsers

  除了主查询解析器外,还有一些其他的查询解析器可以使用或者和主查询解析器连合使用.这部分描述了其他查询解析器的细节,并且给出了一些例子:

  大多数的解析器都可以使用局部查询参数的方式来表达(Local Parameters in query).

1.1 Block Join Query Parsers

  有两种查询解析器支持block joins,这些查询解析器允许索引搜索关系内容.可以使用在你想索引子文档到父文档的地方.比如,一个博客包含父文档和作为其他评论的子文档.或者产品(products)作为父文档,大小(size),颜色(colors),其他种类(variations)作为子文档.在性能方面,索引索引文档之间的关系比在查询时尝试做连接更加有效,因为关系已经在索引中存储,不需要再计算.

  注意:这些解析器的功能是新的,在未来有可能发生变化.

  要使用这些解析器,文档必须索引有子文档,目前文档只能通过XML update handler来被索引成关系结构.这个XML结构允许<doc>元素中嵌套<doc>元素,也可以包含一个标志父文档的字段.

  例子,这里是两个文档,还有它们的子文档:

<add>
<doc>
<field name="id">1</field>
<field name="title">Solr adds block join support</field>
<field name="content_type">parentDocument</field>
<doc>
<field name="id">2</field>
<field name="comments">SolrCloud supports it too!</field>
</doc>
</doc>
<doc>
<field name="id">3</field>
<field name="title">Lucene and Solr 4.5 is out</field>
<field name="content_type">parentDocument</field>
<doc>
<field name="id">4</field>
<field name="comments">Lots of new features</field>
</doc>
</doc>
</add>

  在这个例子中,我们使用字段content_type来标记父字段,我们也可以使用一个boolean字段来标记,如isParent是否为true.

1.2 Block Join Children Query Parser

  这个解析器使用了一个查询,匹配了一些父文档,返回它们的子文档.它的解析语法:q={!childof=<allParents>}<someParents>.<allParents>是一个匹配父文档的过滤器,这里你可以定义一个字段和值来识别一个父文档.参数someParents确定一个匹配夫文档的查询,输出的是子文档:

  使用上面文档的例子,我们可以构造一个查询如q={!childof="content_type:parentDocument"}title:lucene  结果响应中,我们只获取到一个文档:

<result name="response" numFound="1" start="0">
<doc>
<str name="id">12344</str>
<str name="comments">Lots of new features</str>
</doc>
</result>

1.3 Block Join Parent Query Parser

  这个解析器使查询匹配子文档,返回父文档的结果.语法: q={!parentwhich=<allParents>}<someChildren>,对于参数allParents是匹配父文档的过滤器,someChildren是一个查询匹配部分或者全部子文档.

  使用上面的例子,我们可以构造一个查询:q={!parentwhich="content_type:parentDocument"}comments:SolrCloud,响应结果: 

<result name="response" numFound="1" start="0">
<doc>
<str name="id">12341</str>
<arr name="title">
<str>Solr adds block join support</str>
</arr>
<arr name="content_type">
<str>parentDocument</str>
</arr>
</doc>
</result>

1.4 Boost Query Parser

  BoostQParser继承了QParserPlugin,从输入的值中创建了一个带权重的查询.参数b是加权函数.

  例子:

    创建一个查询"foo",使用函数log(popularity)对其加权:

      {!boost b=log(popularity)}foo

    创建一个查询"foo",使用日期函数关联ReciprocalFloatFunction:

      {!boost b=recip(ms(NOW,mydatefield),3.16e-11,1,1)}foo

1.5 Collapsing Query Parser

  CollapsingQParser解析器是一个真正的快速过滤器,当结果集中有区别的组(groups)的数量比较高时,相比对solr的标准方法,它提供了要给更高性能的字段合并(collapsing).CollapsingQParser在它将结果集转向剩余的搜索组件之前,将压缩结果集为每组一个单独的文档,所以,所有的下游组件(faceting,highlighting)将使用这个压缩结果集.

  基于最高得分(scores)的合并(collapse):

    fq={!collapse field=<field_name>}

  基于数字字段最小值的合并(collapse):

    fq={!collapse field=<field_name> min=<field_name>}

  基于数字字段最大值的合并(collapse):

    fq={!collapse field=<field_name> max=<field_name>}

  基于函数的最小最大值的合并(collapse),cscore()函数可以和CollapsingQParserPlugin一起使用,返回当前文档被合并(collapse)的得分.

    fq={!collapse field=<field_name> max=sum(cscore(),field(A))}

  使用一个空策略合并(collapse):

    fq={!collapse field=<field_name> nullPolicy=<nullPolicy>}

   这里有三个空策略:

    ignore:在合并(collapse)字段中,删除带有空值的文档,这是默认的.

    expand:在合并(collapse)字段中,将每个带有空值的文档作为一个单独的组.

    collapse:合并所有的空值文档为一个单独的组.使用最高得分还活着最小/最大值.

  CollapsingQParserPlugin完全支持QueryElevationComponent.但是,没有一种方式来展开(extend)组的一页结果,还并不是solr合并(collapse)功能的完全替代品.

1.6 Field Query Parser

  字段查询解析器

  FieldQParser继承了QParserPlugin.从输入值中创建了一个字段查询.如果合适的话,使用文本分析,构造一个短语查询.参数f指的就是查询的字段.

  例子:

    {!field f=myfield}Foo Bar

  这个例子使用"foo"和"bar"创建了一个短语查询(假定字段myfield的分析器是一个以空格和小写term来分词的文本分析器),这个一般等价于Lucene的查询表达式:

myfield:"Foo Bar".

1.7 Function Query Parser

  FunctionQParser继承了QParserPlugin.从输入值中创建一个函数查询.这里只有一种方式使用函数查询,其他的参考 Function Queries.

  例子:

    {!func}log(foo)

1.8 Function Range Query Parser

  FunctionRangeQParser继承QParserPlugin.

  参数:

    l:最低界限,可选项

    u:较高界限,可选项

    incl:包含较低界限,true/false,默认为false.

    incu:包含较高界限,true/false,默认为false.

  这里可以关联为frange.如下示例:

    {!frange l=1000 u=50000}myfield

    fq={!frange l=0 u=2.2} sum(user_ranking,editor_ranking)

  更多相关信息可以参考 Ranges over Functions in Solr1.4.

1.9 Join Query Parser

  连合查询解析器

  JoinQParser继承QParserPlugin.它允许通过连接操作符来规范文档之间的关系.这和关系型数据库中join(连接)的概念是不同的,因为没有信息去真正的被连接.一个比较合适的"SQL" 比喻是"inner query".

  例子:

  找到所有包含"ipod"的产品,连接(join)它们针对制造商(manufacturer)的文档,返回制造商的列表.

  {!join from=manu_id_s to=id}ipod

  找到所有name为 "belkin"的制造商文档,连接它们针对产品的文档,并且针对price小于12美元的过滤器:

  q = {!join from=id to=manu_id_s}compName_s:Belkin

  fq = price:[* TO 12]

  更多关于连接查询的信息,参考Joins. Erick Erickson也写了一篇博客叫 solr 和joins ,主机是SearchHub.org.

1.10 Lucene Query Parser

  LuceneQParser继承 QParserPlugin.它使用操作符q.op,默认操作符是"OR" or "AND",默认字段名df.

  例子:

    {!lucene q.op=AND df=text}myfield:foo +bar -baz

  更多关于Lucene查询解析器的语法,参考Lucene javadocs

1.11 Max Score Query Parser

  最大得分查询解析

  MaxScoreQParser继承LuceneQParser.返回这个从句的最大得分.在tie=1.0 的DisjunctionMaxQuery查询中,它封装了所有的SHOULD clause(从句).任何MUST或者PROHIBITED从句通过as-is传递.没有boolean查询,如 NumericRange就不会通过LuceneQParser解析行为.

  例子:

    {!maxscore tie=0.01}C OR (D AND E)

1.12 Nested Query Parser

  嵌套查询解析

  NestedParser继承QParserPlugin.创建一个嵌套查询,具有通过本地参数重新定义类型的能力.这个解析器在这样的场合是非常有用的:在配置中指定默认值,让客户端声明关联它们.

 例子:

  {!query defType=func v=$q1}

  如果q1参数是price,查询可以是对price字段的函数查询,如果q1参数是 {!lucene}inStock:true}},那么就会从 Lucene syntax string中创建term查询,使用inStock=true匹配文档.这些参数可以定义在solrconfig.xml中的默认部分: 

<lst name="defaults"
<str name="q1">{!lucene}inStock:true</str>
</lst>

  关于嵌套查询的更多性能,参考Nested Query In Solr.

1.13 Old Lucene Query Parser

  OldLuceneQParser 继承 QParserPlugin.

  例子:

    {!lucenePlusSort} myfield:foo +bar -baz;price asc

1.14 Prefix Query Parser

  前缀查询解析

  PrefixQParser继承 QParserPlugin,对输入的值创建前缀查询.目前没有分析器(analysis)或者值转换器用来床架前缀查询,参数f指的是字段,前缀声明后面的字符串直接被当作通配符查询.

  例子:

    {!prefix f=myfield}foo

  等价于Lucene查询解析器的表达式:   myfield:foo*

1.15 Raw Query Parser

  未加工的查询解析

  RawQParser继承 QParserPlugin,不用任何分析器或者转换器,来创建一个term查询.使用环境:debugging,或者从terms组件中返回原始的terms.只有一个参数f,来定义搜索字段.

  例子:

    {!raw f=myfield}Foo Bar

  构造的query查询是: TermQuery(Term("myfield","Foo Bar"))

1.16 Simple Query Parser

  简单查询解析器
  基于Lucene的SimpleQueryParser.这个查询解析器允许用户输入它们想要输入的查询,然后它将很好的解释这个查询,并返回结果.

  q.operator:开启解析的指定操作,默认的所有的操作都是开启的,这可以按照需要关闭指定的操作,给这个参数传递一个空的字符串就可以关闭指定的操作.

操作符 描述 例子
+ 指定AND token1+token2
| 指定OR token1|token2
- 指定NOT -token3
" 创建一个短语 "term1 term2"
* 指定一个前缀查询 term*

~N

在一个term的末尾,指定一个模糊查询 term~1
~N 在短语末尾,指定一个邻近(near)查询. "term1 term2"~5
( ) 指定查询优先级 token1 + (token2 |token3)

  q.op:定义默认使用的操作符,一般情况下,默认的是OR,也可以使用AND来替换掉.

  qf:查询字段列表

  df:如果没有在schem.xml中定义的话定义默认查询字段.如果已经定义,覆盖这个默认字段.

任何语法错误都可以被忽略,这个查询解析器将会尽它所能的解释query.

1.17 Spatial Filter Query Parser

  SpatialFilterQParser继承 QParserPlugin,创建一个空间过滤器,这个字段必须实现SpatialQueryable.所有单位均为公里.

参数 描述
sfield 过滤器字段,必填
pt 参考点,必须匹配字段的尺寸.必填
d 距离,单位km,必填

目前所用的距离量度取决于所述的FieldType,LatLonType默认使用haversine(半矢量).PointType默认使用Euclidean(2-norm).

  例子:

{!geofilt sfield=<location_field> pt=<lat,lon> d=<distance>}

  这是一些配置值的例子: 

fq={!geofilt sfield=store pt=10.312,-20.556 d=3.5}
fq={!geofilt sfield=store}&pt=10.312,-20&d=3.5
fq={!geofilt}&sfield=store&pt=10.312,-20&d=3.5

如果和LatLonType一起使用geofilt,它能够生成的分数等于从点到字段的计算距离.使其作为一个主查询的组件和对查询加权非常有用.

1.18  Surround Query Parser

  围绕查询解析器

  SurroundQParser继承QParserPlugin.这个解析器提供了围绕查询语法的支持,它提供了邻近(proximity)搜索功能.这里边有两个操作:w创建了一个有序的跨度(距离),n创建了一个无序的跨度(距离).这两个操作都是一个数字值来声明两个term之间的距离.默认为1,最大是99.注意:查询字符串不能用任何方式分词.

  例子:

    {!surround} 3w(foo, bar)

  这个例子将会查找文档中的terms"foo"和"bar"之间距离不会超过3个term.

  这个查询解析器也可以接受布尔操作如(AND,OR,NOT或者是大写或者是小写),通配符,短语搜索的引号和加权.w和n操作也可以用大写或者小写表示.

  更多关于这个解析器的操作参考:http://wiki.apache.org/solr/SurroundQueryParser

1.19 Switch Query Parser

  SwitchQParser继承QParserPlugin.表现出来像"swithc" 或者"case" 状态.

  在这个结果中每个查询结构都是XXX:  

{!switch case.foo=XXX case.bar=zzz case.yak=qqq}foo
{!switch case.foo=qqq case.bar=XXX case.yak=zzz} bar // extra whitespace is trimmed
{!switch case.foo=qqq case.bar=zzz default=XXX}asdf // fallback to the default
{!switch case=XXX case.bar=zzz case.yak=qqq} // blank input uses 'case'

  这个QParsePlugin的部分使用方法就是在SearchHandler的配置中指定appends的fq参数.使用下面的例子,客户端可以选择指定参数in_stock 和shipping来覆盖默认的过滤器行为.但是限制具体的合法值的集合.(shipping=any|free, in_stock=yes|no|all) 

<requestHandler name="/select" class="solr.SearchHandler">
<lst name="defaults">
<str name="in_stock">yes</str>
<str name="shipping">any</str>
</lst>
<lst name="appends">
<str name="fq">{!switch case.all='*:*'
case.yes='inStock:true'
case.no='inStock:false'
v=$in_stock}</str>
<str name="fq">{!switch case.any='*:*'
case.free='shipping_cost:0.0'
v=$shipping}</str>
</lst>
</requestHandler>

1.20 Term Query Parser

  TermQParser继承QParserPlugin,从输入值中创建一个单独的term查询,相当于readableToIndexed().这是用于通过分面和terms组件从外部可读的terms中生成过滤器查询是很有用的.只有一个字段参数f.

  例子:

    {!term f=weight}1.5

  对于文本字段,没有分析器做处理,因为原始的term已经从分面(facet)和terms组件中返回了.要对文本字段使用分析,参考上面的Field Query Parser.

  

  

上一篇:Eclipse下Tomcat设置


下一篇:/etc/security/limits.conf 文件说明